Tutorials

This page collects the executable notebooks in one place. Use it as the main entry point once you want to run code rather than read background material.

Choosing a path

First working example

Run the quickstart notebook before diving into the longer workflows.

jaxvacua quickstart

End-to-end package tour

Follow the overview notebook to see geometry input, model construction, sampling, refinement, and analysis in one narrative.

JAXVacua: overview

Vacuum finding

Start here for Newton refinement, ISD-biased sampling, and bounded flux searches.

Finding flux vacua

Geometry and limits

Use these notebooks when you need moduli-space limits, coni-LCS expansions, or one-modulus model data.

Moduli-space limits and custom prepotentials

Advanced checks

Use these notebooks for performance comparisons and literature dataset validation after the core workflows are familiar.

Advanced and Case Studies

Tutorial catalogue

Quickstart and reference

Notebook	Use it for
jaxvacua quickstart	Minimal setup and first run through the package.
Notebook glossary	Common notation used across the tutorials, including \(W_0\), \(z_{\rm cf}\), \(g_s\), PFV, AFV, ISD, and AISD.

Basics

Notebook	Use it for
Warm-up: string vacua and automatic differentiation in JAX	A gentle JAX and automatic-differentiation warm-up in the string-vacua setting.
JAXVacua: overview	The main end-to-end orientation notebook for the package.
CYTools interface	Moving from CYTools objects to JAXVacua model data.
Sampling module	Moduli, axio-dilaton, flux, and initial-guess sampling.

Vacuum finding

Notebook	Use it for
Finding flux vacua	Newton refinement and the main SUSY flux-vacuum workflow.
Flux vacua ensembles via ISD sampling	The principle behind ISD-completed flux seeds.
Sampling flux vacua	Practical ISD sampling and ensemble generation.
Flux bounding: enumeration and stochastic sampling	Systematic bounded-flux searches and stochastic variants.

Geometry and limits

Notebook	Use it for
Moduli-space limits and custom prepotentials	Large-complex-structure limits, custom period input, and validity checks.
coni-LCS limit and PFV pipeline	Conifold/LCS expansions and perturbatively flat vacuum pipelines.
One-modulus Calabi-Yau models	Hypergeometric one-modulus examples and closed-form prepotentials.

Analysis and pipelines

Notebook	Use it for
Freezer	Reduced EFTs with heavy fields solved away.
Visualisation cookbook	Plotting and inspecting vacuum data.
Hessian analysis	Mass spectra, Hessians, and stability diagnostics.
Landscape statistics	Distribution-level analysis of vacuum ensembles.

Advanced and case studies

Notebook	Use it for
Sampling benchmarks and performance	Runtime, memory, solver, and sampler comparisons with expensive cells disabled by default.
Flux-bounding case studies	Local Dataset B and mirror-octic literature checks with full scans left opt-in.
Hulek–Verrill attractor demo	A compact custom-period example connecting attractor points and flux-vacuum notation.

External workflow tutorials

The database, vacua-vault, and cluster-parallelisation tutorials have moved to the StringForge umbrella package, which hosts the shared catalogue I/O and storage layer. See the StringForge database and infrastructure tutorials.