Tutorials
=========

Long-form, narrative walkthroughs. Each one builds up a topic step by
step with the public API and checks the numbers it produces against
known closed-form or published results. For short, single-topic scripts,
see the :doc:`example gallery </examples/index>`.

Start with :doc:`units_and_conventions`: it explains the natural unit
system each subpackage computes in, and how to convert results to SI.

.. toctree::
   :maxdepth: 1
   :caption: Getting started

   units_and_conventions

.. toctree::
   :maxdepth: 1
   :caption: Mechanics & Dynamics

   measuring_chaos
   black_holes_in_geometrized_units
   polytropic_stellar_models
   nbody_orbits_and_galactic_rotation_curves
   relativistic_two_body_decay
   nuclear_decay_chains_and_scattering

.. toctree::
   :maxdepth: 1
   :caption: Waves & Fields

   plasma_particles_to_kinetics
   fdtd_waveguide_simulation
   bec_vortex_lattice_creation
   laser_cavity_stability
   wigner_function_squeezed_states

.. toctree::
   :maxdepth: 1
   :caption: Quantum & Statistical

   random_matrix_universality
   graphene_and_haldane
   ssh_topological_edge_states
   semiclassical_wavepacket_propagation
   gutzwiller_periodic_orbit_spectrum
   statphys_deep_dives

.. toctree::
   :maxdepth: 1
   :caption: Fluids

   fluid_flow_regimes