LowMachReact-Hex Documentation

Welcome to the technical documentation for LowMachReact-Hex, a Fortran 2008 / C++ MPI finite-volume solver for projection and low-Mach reacting flows on unstructured hexahedral grids.

Technical Documentation Sections

• Installation & Execution Guide Build requirements, compiler settings, and execution steps for Cantera and GPU-native PelePhysics/AMReX backends.
• Input Configuration Reference Full namelist parameter documentation for mesh, time controls, solver tolerances, boundary patches, and restarts.
• Mathematical Formulation & Numerics Governing low-Mach equations, finite-volume discretization, high-order MUSCL schemes, and C1 continuous cubic temperature clipping.
• Code Architecture & Module Topology Directory structure, module compilation dependencies, and standard C-binding mappings.
• Chemistry Backends & C++ Bridges Dynamic transport caching for Cantera, and static CVODE implicit reactors for PelePhysics.
• Radiative Heat Transfer Models Spherical Harmonics (P1) diffusion and Discrete Ordinates Method (DOM) angular sweeps.
• Performance Scaling & Load Balancing Parallel chemistry load balancing via global replication, scaling benchmarks, and the GPU offloading roadmap.
• Output Architecture & Post-Processing Partitioned VTU/PVTU outputs, real-time PVD timeline collection builders, and ParaView data-extraction steps.
• Developer Guide & Testing Standards Precision rules, module scope declarations, and restart species-mismatch sub-selection rules.
• Solver Deployment & Active Feature Status Granular grid listing feature deployments, target file implementations, and physical/diagnostics validation status.