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:
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/sdkfor execution,@kalika/corefor expression and derivation representation,@kalika/formal-verificationfor proof status. - Unit-aware physics result:
@kalika/utilsfor quantity construction and conversion, then@kalika/typesettingfor report output. - Publication export:
@kalika/notebooksselects cells,@kalika/typesettingturns 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/algebrawhen the answer must stay exact over rationals, rings, groups, or modules. - Use
@kalika/analysiswhen the object is a function, series, contour, Hilbert-space vector, operator, transform, or asymptotic expansion. - Use
@kalika/combinatoricsbefore symbolic regression when you need sequence data, enumeration, or graph structure. - Use
@kalika/category-theorywhen 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-theoryfor invariants and L-functions,@kalika/databasefor LMFDB import,@kalika/typesettingfor formulas. - Persistent topology:
@kalika/topologyfor filtrations and diagrams,@kalika/rendererfor visualization. - Gauge representation work:
@kalika/lie-theoryfor representation and anomaly checks,@kalika/quantum-field-theoryfor 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:
- Build the Hamiltonian or exact potential with
@kalika/quantum-mechanics. - Use
@kalika/analysisor@kalika/information-theoryfor norms, entropies, channels, and diagnostics. - Move to
@kalika/tensor-networkswhen 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-theoryfor model and amplitudes,@kalika/hep-phenomenologyfor spectra/constraints, and@kalika/databasefor 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-relativityfor metric/curvature/causal structure,@kalika/rendererfor Penrose or spacetime diagrams. - Cosmological observable:
@kalika/cosmologyfor background and perturbation quantities,@kalika/typesettingfor publication equations. - Gravitational-wave event:
@kalika/gravitational-wavesfor source and detector modeling,@kalika/databasefor 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-theoryplus@kalika/number-theoryfor modular data and arithmetic checks. - Spin-network study:
@kalika/quantum-gravityplus@kalika/topologyfor 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-mechanicsfor general ensembles and RG. - Use
@kalika/condensed-matterwhen the system is a material, lattice model, band structure, superconducting phase, or quantum Hall state. - Use
@kalika/probabilityfor 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/citationsfor bibliographic records and@kalika/knowledge-graphfor concepts, theorems, and semantic relationships. - Use
@kalika/rendereras the boundary from computed objects to visual artifacts. - Use
@kalika/hpc-orchestratorwhen 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/sdkor a domain package computes,@kalika/corerecords derivations,@kalika/formal-verificationchecks proof obligations. - Explore and conjecture: domain package generates data,
@kalika/research-agentsformulates conjectures,@kalika/formal-verificationor@kalika/research-agentsproof tooling attacks them. - Theory to observable:
@kalika/quantum-field-theorybuilds the model,@kalika/hep-phenomenologycomputes constraints,@kalika/databaseimports experimental references. - Equation discovery:
@kalika/symbolic-regressionproposes laws,@kalika/neural-physicssupplies surrogate models or PDE training data, and@kalika/formal-verificationchecks 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:
- Add the package and entry symbols to
domain-map.json. - Add or update the matching section in this guide.
- Run
pnpm kalika:domain-guide:check. - Regenerate API reference if public APIs changed with
pnpm kalika:api-reference.