Documentation Map

Table of Contents

• 1. Simulation Lifecycle
  • 1.1 Design and Setup
  • 1.2 Run and Monitor
  • 1.3 Debug and Validate
• 2. Configuration and Artifacts
  • 2.1 YAML Contracts and Ingestion
  • 2.2 Runtime and Artifacts
• 3. Numerical Methods and Models
• 4. Runtime and Source Architecture
• 5. Operations and Quality
• 6. Repository and Documentation Navigation
• 7. Generated Reference Views

This is the primary structural entry point for PICurv documentation. Use this page instead of the raw generated page dump.

1. Simulation Lifecycle

1.1 Design and Setup

• Installation Guide
• Tutorial: Your First Simulation (Flat Channel)
• Tutorial: Using a File-Based Grid (Bent Channel)
• Configuration Reference: Case YAML
• Configuration Reference: Solver YAML
• Configuration Reference: Monitor YAML
• Configuration Reference: Postprocessor YAML
• Boundary Conditions Guide
• Particle Initialization and Restart Guide

1.2 Run and Monitor

• The Conductor Script: pic.flow
• Anatomy of a Simulation
• Cluster Run Guide (Slurm)
• Sweep and Study Guide
• Tutorial: A Guide to Visualizing Your Results

1.3 Debug and Validate

• Common Fatal Errors and Fixes
• Testing, Smoke, and Quality Gates Guide
• Capabilities Summary

2. Configuration and Artifacts

2.1 YAML Contracts and Ingestion

• Configuration Contract (YAML -> Generated Artifacts -> Runtime)
• Developer Ingestion Map
• Configuration Extension Playbook
• Workflow Extensibility Guide

2.2 Runtime and Artifacts

• Initial Condition Modes
• Particle Model and Coupling Overview
• Particle Initialization and Restart Guide

3. Numerical Methods and Models

• Methods and Models Overview
• CurvIB Method Overview
• Fractional-Step (Projection) Method
• Dual-Time Picard RK4 Momentum Solver
• Pressure-Poisson, GMRES, and Multigrid
• Walking Search for Particle Location
• Trilinear Interpolation and Particle-Grid Projection
• IEM Mixing and Statistical Averaging
• Momentum Solver Implementations
• Analytical Solution Modes

4. Runtime and Source Architecture

• Code Architecture
• Grid, Cell, and Variable Architecture Guide
• C Runtime Execution Map
• API Documentation Status

5. Operations and Quality

• Cluster Run Guide (Slurm)
• Sweep and Study Guide
• Common Fatal Errors and Fixes
• Testing, Smoke, and Quality Gates Guide
• Maintenance Backlog and Low-Priority Fixes

6. Repository and Documentation Navigation

• Repository Navigation and Directory Guides
• Changelog

7. Generated Reference Views

This section is for maintainers who need code-symbol navigation views instead of prose guides.

• File List by type (headers/sources/scripts): files_structured.html
• Data Structures by solver module: annotated_structured.html
• Raw Doxygen indices (unstructured): files.html, annotated.html, globals.html