Eve library

Kalika Domain Guide

Guide

Revision 1

On this page

This guide answers "which Kalika tool do I use for X?" across the math, physics, data, notebook, and research-agent libraries. Use it with the generated API reference for symbol-level details and the tutorial notebooks for runnable onboarding workflows.

The companion domain-map.json is the machine-checkable source for package pointers in this guide. Validate it with:

bash
pnpm kalika:domain-guide:check

For implementation sequencing, use the Kalika build-order graph. It documents phase dependencies, the critical path, and the packages that are intentionally buildable before their historical parent phases.

Which Tool Do I Use?#

Need Start With Then Add
Run local CAS, matrix, tensor, or numeric jobs @kalika/sdk @kalika/core for expression trees and derivation provenance
Simplify, rewrite, serialize, or prove expression transformations @kalika/core @kalika/formal-verification for Lean/SMT/ATP checks
Exact matrix algebra, finite groups, and spectral invariants @kalika/algebra @kalika/analysis for numerical/asymptotic follow-up
Fourier, complex analysis, Hilbert-space, and asymptotic calculations @kalika/analysis @kalika/renderer for plots and visual diagnostics
Primes, factorization, elliptic curves, modular forms, and L-functions @kalika/number-theory @kalika/database for LMFDB/OEIS-backed data
CW/simplicial complexes, homology, homotopy, knots, and persistence @kalika/topology @kalika/renderer for diagrams
Lie algebras, Weyl groups, Casimirs, and gauge anomaly checks @kalika/lie-theory @kalika/quantum-field-theory for gauge models
Schrodinger solvers, spectra, scattering, and spin/angular momentum @kalika/quantum-mechanics @kalika/analysis for Hilbert-space utilities
Entanglement, density matrices, channels, and open-system evolution @kalika/information-theory @kalika/quantum-mechanics for Hamiltonians
MPS/DMRG/PEPS/MERA and gauge-invariant tensor blocks @kalika/tensor-networks @kalika/condensed-matter for model Hamiltonians
Gauge models, Feynman rules, loop integrals, RGE, and QFT benchmarks @kalika/quantum-field-theory @kalika/renderer for Feynman diagrams
PDG data, BSM spectra, flavor, dark matter, and precision observables @kalika/hep-phenomenology @kalika/database for HEPData import
Lattice gauge actions, HMC, and lattice measurements @kalika/lattice @kalika/numerical for validation harnesses
ADM/BSSN, curvature tensors, exact GR solutions, and geodesics @kalika/general-relativity @kalika/renderer for Penrose/spacetime diagrams
Cosmological background, inflation, CMB, dark energy, and structure @kalika/cosmology @kalika/general-relativity for relativistic corrections
Waveforms, detector response, compact binaries, and SXS comparisons @kalika/gravitational-waves @kalika/database for SXS catalog import
Calabi-Yau, dualities, CFT, string amplitudes, and Virasoro algebra @kalika/string-theory @kalika/number-theory for modular data
LQG, spin networks, CDT, and asymptotic safety @kalika/quantum-gravity @kalika/topology for combinatorial structures
Ensembles, partition functions, exact lattice models, and RG @kalika/statistical-mechanics @kalika/condensed-matter for material models
Tight-binding, Hubbard, BCS, quantum Hall, and topological bands @kalika/condensed-matter @kalika/tensor-networks for many-body solvers
Distributions, Markov chains, stochastic processes, random matrices @kalika/probability @kalika/numerical for sampling checks
Notebook documents, cell execution, Jupyter interop, and exports @kalika/notebooks @kalika/typesetting for paper output
Citations, DOI metadata, and citation graphs @kalika/citations @kalika/knowledge-graph for concept links
Knowledge graphs, theorem dependencies, semantic concept linking @kalika/knowledge-graph @kalika/research-agents for literature workflows
Plots, diagrams, tensor networks, circuits, lattices, and manifolds @kalika/renderer Domain library outputs as input data
Caches, job scheduling, checkpoints, distributed compute, cost tracking @kalika/hpc-orchestrator @kalika/database for persisted records
Literature-informed computation, conjectures, proof search, and agents @kalika/research-agents @kalika/formal-verification for proof closure
Equation discovery, AI-Feynman benchmarks, and symbolic regression @kalika/symbolic-regression @kalika/research-agents for conjecture loops
PINNs, DeepONet, Fourier neural operators, AD, ONNX, and WGPU plans @kalika/neural-physics @kalika/numerical for validation data

Foundation, CAS, SDK, Units, and Typesetting#

Use this layer when the task is about expression representation, local compute, serialization, units, provenance, or publication output.

Package Use For Start Here
@kalika/core Expression ASTs, assumptions, serialization, rewrite rules, e-graphs, derivation chains, and provenance-aware results. ExprInterner, createRewriteRule, parseExprPattern, runEqualitySaturation, serializeExprToLatex
@kalika/sdk Server-free symbolic operations, numeric evaluation, matrix/tensor calls, physics constants, and batch jobs. createKalikaSdk, KalikaSdk, evaluateNumericExpression
@kalika/utils Dimensional analysis, physical constants, unit conversion, and dimension-safe quantities. PHYSICAL_CONSTANTS, createPhysicalQuantity, convertPhysicalQuantity
@kalika/numerical Arbitrary precision arithmetic, Mellin-Barnes integration, Monte Carlo validation, ODE/PDE validation, and benchmark harnesses. evaluateSpecialFunction, meijerG, createMonteCarloIntegrationValidationSuite, createOdeBenchmarkSuite
@kalika/numerical-engine Rust-backed low-level numerical kernels consumed by higher-level Kalika wrappers. Use through TypeScript wrappers unless you are extending native kernels.
@kalika/typesetting LaTeX, equation, derivation, and paper rendering for notebook-to-publication workflows. typesetDerivation, draftPaperFromNotebook, renderLatexEquation

Primary workflows:

  • CAS cell: @kalika/sdk for execution, @kalika/core for expression and derivation representation, @kalika/formal-verification for proof status.
  • Unit-aware physics result: @kalika/utils for quantity construction and conversion, then @kalika/typesetting for report output.
  • Publication export: @kalika/notebooks selects cells, @kalika/typesetting turns derivations/equations into LaTeX.

Algebra, Analysis, Combinatorics, and Category Theory#

Use this group for exact algebraic manipulation, analytic transforms, series and asymptotic analysis, discrete enumeration, and structural category-theory models.

Package Use For Start Here
@kalika/algebra Exact rational matrices, decompositions, finite groups, Galois computations, modules, rings, and spectral invariants. RationalField, rationalMatrix, determinant, reducedRowEchelonForm, characteristicPolynomial, createSymmetricGroup
@kalika/analysis Fourier methods, complex analysis, Hilbert spaces, integral transforms, operator theory, series tests, and asymptotics. complex, fft, inverseFft, ratioTest, taylorAsymptoticExpansion, createHilbertSpace
@kalika/combinatorics Binomial coefficients, integer partitions, Catalan numbers, graph algorithms, species, and tableaux. binomial, integerPartitions, catalanNumber, createGraph
@kalika/category-theory Categories, functors, natural transformations, universal constructions, abelian categories, monoidal categories, and topos tools. createCategory, object, morphism, productObject, yonedaLemma, createTopos

Decision points:

  • Use @kalika/algebra when the answer must stay exact over rationals, rings, groups, or modules.
  • Use @kalika/analysis when the object is a function, series, contour, Hilbert-space vector, operator, transform, or asymptotic expansion.
  • Use @kalika/combinatorics before symbolic regression when you need sequence data, enumeration, or graph structure.
  • Use @kalika/category-theory when universal properties, functoriality, or internal logic are the real object being modeled.

Number Theory, Topology, and Lie Theory#

Use this group for arithmetic structures, topological invariants, and Lie algebra data that feeds gauge theory, geometry, and representation workflows.

Package Use For Start Here
@kalika/number-theory Primality, factorization, arithmetic functions, elliptic curves, modular forms, L-functions, number fields, and local fields. isPrime, factorInteger, divisorSigma, shortWeierstrassCurve, ellipticEulerFactor, functionalEquation
@kalika/topology Simplicial and CW complexes, cellular homology, cohomology, homotopy, knot invariants, and persistent homology. sphereCWComplex, cellularHomology, fundamentalGroup, vietorisRipsFiltration, persistenceDiagram
@kalika/lie-theory Lie algebra classification, root systems, Weyl groups, representations, Casimirs, and gauge anomaly checks. classifyLieAlgebra, cartanMatrix, weylGroup, quadraticCasimir, gaugeAnomalyCheck

Common combinations:

  • Elliptic curve study: @kalika/number-theory for invariants and L-functions, @kalika/database for LMFDB import, @kalika/typesetting for formulas.
  • Persistent topology: @kalika/topology for filtrations and diagrams, @kalika/renderer for visualization.
  • Gauge representation work: @kalika/lie-theory for representation and anomaly checks, @kalika/quantum-field-theory for model assembly.

Quantum Mechanics, Quantum Information, and Tensor Networks#

Use this group for finite and continuum quantum systems, state diagnostics, open-system evolution, and many-body tensor-network solvers.

Package Use For Start Here
@kalika/quantum-mechanics Stationary and time-dependent Schrodinger solvers, exact potentials, angular momentum, spin algebra, scattering, and perturbation theory. harmonicOscillatorSolution, hydrogenAtomSolution, crankNicolsonStep, propagateSplitOperatorFft, coulombScattering
@kalika/information-theory Quantum information, density matrices, entanglement diagnostics, channels, and Lindblad evolution. basisState, densityMatrixFromState, vonNeumannEntropy, reducedDensityMatrix, lindbladEulerStep
@kalika/tensor-networks Tensor networks, MPS/MPO, DMRG, PEPS, MERA, XXZ benchmarks, and gauge-invariant tensor constructions. productMps, spinHalfXxzHamiltonian, dmrgGroundState, optimizeFinitePepsEnergy, gaugeInvariantTensor

Recommended flow:

  1. Build the Hamiltonian or exact potential with @kalika/quantum-mechanics.
  2. Use @kalika/analysis or @kalika/information-theory for norms, entropies, channels, and diagnostics.
  3. Move to @kalika/tensor-networks when Hilbert-space dimension is the limiting factor.

Quantum Field Theory, HEP Phenomenology, and Lattice Gauge Theory#

Use this group for gauge models, Feynman rules, loop integral reduction, collider/phenomenology workflows, and lattice gauge computations.

Package Use For Start Here
@kalika/quantum-field-theory Gauge theory declarations, field definitions, Feynman rules, Passarino-Veltman integrals, IBP reduction, RGE running, cross sections, and QFT benchmarks. createGaugeTheoryModel, defineDiracSpinor, u1Group, suGroup, scalarB0, createQftBenchmarkSuite
@kalika/hep-phenomenology PDG particle data, MSSM/BSM spectrum generation, flavor physics, dark matter relic density, and electroweak precision observables. createPdgDatabase, generateMssmSpectrum, flavorObservables, thermalRelicDensity, predictElectroweak
@kalika/lattice Hypercubic lattices, gauge fields, Wilson plaquette actions, HMC trajectories, fermions, and lattice measurements. createHypercubicLattice, coldGaugeField, wilsonPlaquetteAction, hmcTrajectory, rectangularWilsonLoop

Workflow choices:

  • Analytic perturbation theory: start in @kalika/quantum-field-theory, then render diagrams with @kalika/renderer.
  • Phenomenology pipeline: use @kalika/quantum-field-theory for model and amplitudes, @kalika/hep-phenomenology for spectra/constraints, and @kalika/database for HEPData/PDG-backed comparisons.
  • Nonperturbative lattice study: use @kalika/lattice, then validate observables with @kalika/numerical.

General Relativity, Cosmology, and Gravitational Waves#

Use this group for curvature, exact spacetimes, numerical-relativity systems, cosmological observables, and waveform/data-analysis workflows.

Package Use For Start Here
@kalika/general-relativity ADM and BSSN formalisms, curvature tensors, exact solutions, perturbations, geodesics, Penrose-Carter diagrams, and GR benchmarks. admSystem, bssnSystem, schwarzschildPenroseDiagram, createGrCurvatureBenchmarkSuite, integrateGeodesicRkf45
@kalika/cosmology Friedmann evolution, inflation predictions, CMB power spectra, dark energy models, and structure formation. PLANCK_2018_COSMOLOGY, solveFriedmann, starobinskyPredictions, linearGrowthFactor, acousticAngularScale
@kalika/gravitational-waves Compact-binary source modeling, waveform catalogs, detector response, data analysis, and numerical-relativity surrogate access. compactBinaryChirpMass, lalSuiteWaveformCatalog, detectorPsd, matchedFilter, selectSxsSimulation

Recommended flow:

  • Exact solution: @kalika/general-relativity for metric/curvature/causal structure, @kalika/renderer for Penrose or spacetime diagrams.
  • Cosmological observable: @kalika/cosmology for background and perturbation quantities, @kalika/typesetting for publication equations.
  • Gravitational-wave event: @kalika/gravitational-waves for source and detector modeling, @kalika/database for SXS catalog comparisons.

String Theory and Quantum Gravity#

Use this group for compactification geometry, dualities, CFT/amplitude tools, and quantum-gravity approaches.

Package Use For Start Here
@kalika/string-theory AdS/CFT data, Calabi-Yau geometry, mirror symmetry, flux compactifications, string dualities, spinor-helicity, Virasoro algebra, and color-kinematics duality. sl2z, transformAxioDilaton, electromagneticDualityRotation, virasoroBracket, gaugeAmplitudeFromCubicGraphs
@kalika/quantum-gravity Loop quantum gravity spectra, spin networks, causal dynamical triangulations, and asymptotic-safety fixed points. areaSpectrum, SpinNetworkNode, validateSpinNetwork, findEinsteinHilbertFixedPoint, classifyCdtPhase

Useful pairings:

  • Compactification: @kalika/string-theory plus @kalika/number-theory for modular data and arithmetic checks.
  • Spin-network study: @kalika/quantum-gravity plus @kalika/topology for combinatorial/topological structure.

Statistical Mechanics, Condensed Matter, and Probability#

Use this group for ensembles, phases, random systems, many-body models, critical phenomena, and stochastic diagnostics.

Package Use For Start Here
@kalika/statistical-mechanics Canonical/grand-canonical ensembles, thermodynamic potentials, exact lattice results, mean-field theory, and renormalization group catalogues. canonicalPartitionFunction, grandCanonicalPartitionFunction, oneDimensionalIsingPartitionFunction, wilsonFisherBetaFunctions, renormalizationGroupCatalog
@kalika/condensed-matter Tight-binding models, Hubbard models, BCS superconductivity, quantum Hall physics, and topological band invariants. squareLatticeModel, exactDiagonalizeHubbard, solveBcsGapEquation, hallConductance, chernNumber
@kalika/probability Probability distributions, Markov chains, stochastic processes, and random-matrix ensembles. normalDistribution, createMarkovChain, brownianMotion, gaussianEnsemble

Selection guide:

  • Use @kalika/statistical-mechanics for general ensembles and RG.
  • Use @kalika/condensed-matter when the system is a material, lattice model, band structure, superconducting phase, or quantum Hall state.
  • Use @kalika/probability for stochastic models, random matrices, and distribution-level checks around simulations.

Data, Notebooks, Knowledge, Citations, Rendering, and HPC#

Use this group for persistence, import/export, collaboration, visualization, knowledge management, and large-compute orchestration.

Package Use For Start Here
@kalika/database PostgreSQL schema, migrations, computation cache, vector search, and external data importers for LMFDB, HEPData, SXS, OEIS, KnotInfo, and Kreuzer-Skarke. kalikaSchema, computationCache, KalikaLmfdbImporter, KalikaHepDataImporter, OeisClient
@kalika/notebooks Notebook document model, serialization, cell execution, provenance, collaboration, Jupyter interop, sharing, reproducibility, and exports. createNotebookDocument, serializeNotebookToJson, executeNotebookCell, createNotebookVersionState, generateNotebookDependencyLockfile
@kalika/renderer Plots, vector fields, Feynman diagrams, Penrose diagrams, quantum circuits, tensor networks, lattice visualizations, and 3D manifolds. renderFeynmanDiagram, plotFunctions, renderPenroseCarterDiagram, renderTensorNetworkDiagram, renderLatticeVisualization
@kalika/citations Citation records, BibTeX/RIS/CSL import/export, DOI metadata resolution, and citation graph visualizations. CitationManager, InMemoryCitationDatabase, importCitations, exportCitations, buildCitationGraph
@kalika/knowledge-graph Ontology, concept linking, theorem dependency graphs, persistence snapshots, and graph queries. createKnowledgeGraphSnapshot, createTheoremDependencyGraph, suggestConceptLinks, postgresConceptDescendantsQuery
@kalika/hpc-orchestrator Computation caches, distributed decomposition, job scheduling, checkpointing, resource monitoring, and remote submission scripts. ComputationCache, HpcJobScheduler, ResourceMonitor, decomposeDomain2D, renderRemoteSubmissionScript

Architecture notes:

  • Store durable records in @kalika/database; keep notebook document behavior in @kalika/notebooks.
  • Use @kalika/citations for bibliographic records and @kalika/knowledge-graph for concepts, theorems, and semantic relationships.
  • Use @kalika/renderer as the boundary from computed objects to visual artifacts.
  • Use @kalika/hpc-orchestrator when a computation needs caching, checkpointing, scheduling, or remote execution.

Research Agents, Symbolic Regression, Neural Physics, and Verification#

Use this group for autonomous research workflows, theorem/proof workflows, data-driven discovery, and neural scientific models.

Package Use For Start Here
@kalika/research-agents Computation, literature, exploration, conjecture, proof, and orchestration agents with arXiv/INSPIRE/OEIS/OpenAlex/Semantic Scholar integration. ResearchAgentBase, ComputationAgent, formulateConjectures, buildOeisGuidedConjectureSeeds, createConjectureGenerationBenchmarkSuite
@kalika/symbolic-regression AI-Feynman benchmarks, genetic programming, transformer and LLM-guided symbolic regression, equation discovery, separability detection, and symmetry detection. createAiFeynmanBenchmarkSuite, fitSymbolicRegression, discoverSindyDynamics, detectSeparability, detectSymmetries
@kalika/neural-physics DeepONet, Fourier neural operators, PINNs, separable PINNs, dense training infrastructure, AD, ONNX export, and WGPU inference plans. createDeepONet, createFourierNeuralOperator1D, createPinnNetwork, createSeparablePinn, trainDenseNetwork
@kalika/formal-verification Kalika-to-Lean and Lean-to-Kalika translation, proof candidates, Lean process management, numerical spot checks, SMT/ATP translation, and decision procedures. translateKalikaStatementToLean, translateKalikaExprToLeanTheorem, buildVerificationCandidates, numericalSpotCheck, translateExprToSmtLib

Workflow patterns:

  • Compute and verify: @kalika/sdk or a domain package computes, @kalika/core records derivations, @kalika/formal-verification checks proof obligations.
  • Explore and conjecture: domain package generates data, @kalika/research-agents formulates conjectures, @kalika/formal-verification or @kalika/research-agents proof tooling attacks them.
  • Theory to observable: @kalika/quantum-field-theory builds the model, @kalika/hep-phenomenology computes constraints, @kalika/database imports experimental references.
  • Equation discovery: @kalika/symbolic-regression proposes laws, @kalika/neural-physics supplies surrogate models or PDE training data, and @kalika/formal-verification checks symbolic claims where possible.

Cross-Domain Recipes#

Workflow Libraries
Compute and formally verify an integral @kalika/sdk, @kalika/core, @kalika/formal-verification, @kalika/typesetting
Build a publishable physics notebook @kalika/notebooks, one or more domain packages, @kalika/renderer, @kalika/citations, @kalika/typesetting
Compare a QFT prediction with data @kalika/quantum-field-theory, @kalika/hep-phenomenology, @kalika/database, @kalika/citations
Analyze a gravitational-wave event @kalika/gravitational-waves, @kalika/general-relativity, @kalika/database, @kalika/renderer
Search for number-theory conjectures @kalika/number-theory, @kalika/combinatorics, @kalika/research-agents, @kalika/formal-verification
Study a strongly correlated lattice model @kalika/condensed-matter, @kalika/tensor-networks, @kalika/statistical-mechanics, @kalika/renderer
Run a large parameter scan Domain package, @kalika/hpc-orchestrator, @kalika/database, @kalika/notebooks

Maintenance#

When adding a new Kalika library or a major public domain capability:

  1. Add the package and entry symbols to domain-map.json.
  2. Add or update the matching section in this guide.
  3. Run pnpm kalika:domain-guide:check.
  4. Regenerate API reference if public APIs changed with pnpm kalika:api-reference.