.. Theory Guide documentation master file, created by
   sphinx-quickstart on Fri Nov 15 13:48:19 2024.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

Loci-Stream: Parallel Scalable Compressible Pressure-Based Solver Theory Guide
==============================================================================

This guide develops the governing equations, finite-volume discretization, and
pressure-based algorithms used by *Loci-Stream*. The chapters progress from the
continuous conservation laws to the assembled algebraic systems and then to the
physical closures and specialized formulations used with those systems.

.. container:: theory-part-grid

   .. container:: theory-part-card

      **Foundations**

      Establishes the governing equations, the segregated solution process, and
      the finite-volume assembly shared by the methods that follow.

      Start with :doc:`chapter_1/chapter_1`.

   .. container:: theory-part-card

      **Pressure-Based Method**

      Develops momentum-weighted interpolation, the pressure-correction equation,
      the major pressure--velocity algorithms, and the PIMPLE corrector sequence.

      Start with :doc:`chapter_4/chapter_4`.

   .. container:: theory-part-card

      **Numerics and Physical Models**

      Covers high-resolution spatial schemes, temporal integration, turbulence
      closures, hybrid RANS--LES methods, finite-rate chemistry, and
      compressible flamelet modeling.

      Start with :doc:`chapter_5/chapter_5`.

   .. container:: theory-part-card

      **Specialized Formulations**

      Collects the multi-material algebraic-VOF framework and extensions for
      rotating frames, porous media, real-fluid closure, double-flux treatment,
      moving meshes, and open boundaries.

      Start with :doc:`chapter_13/chapter_13`.

   .. container:: theory-part-card

      **Reference Appendices**

      Preserves supporting derivations, pressure-correction variants, linearization
      details, and concise framework references used by the main chapters.

      Start with :doc:`appendices/appendix_classical_cartesian_pressure_correction`.

.. toctree::
   :maxdepth: 2
   :numbered:
   :hidden:

   notation
   chapter_1/chapter_1
   chapter_2/chapter_2
   chapter_3/chapter_3
   chapter_4/chapter_4
   chapter_pressure_correction/chapter_pressure_correction
   chapter_pressure_velocity_algorithms/chapter_pressure_velocity_algorithms
   chapter_pimple/chapter_pimple
   chapter_5/chapter_5
   chapter_6/chapter_6
   chapter_7/chapter_7
   chapter_9/chapter_9
   chapter_10/chapter_10
   chapter_flamelet/chapter_flamelet
   chapter_13/chapter_13
   appendices/appendix_implemented_governing_equations
   appendices/appendix_non_inertial_reference_frame
   appendices/appendix_porous_media
   appendices/appendix_additive_volume_eos
   appendices/appendix_double_flux
   appendices/appendix_geometric_conservation_law
   appendices/appendix_nonreflecting_boundary_conditions
   appendices/appendix_classical_cartesian_pressure_correction
   appendices/appendix_pressure_correction_equation_forms
   appendices/appendix_density_pressure_linearization
   appendices/appendix_continuity_provisional_velocity
   appendices/appendix_loci_framework
   appendices/appendix_loci_face_orientation
   appendices/appendix_coding_guide



Indices and tables
==================

* :ref:`genindex`
* :ref:`search`