Hadros

Hadros is a C++23 library for validated single-hadron catalogs and the construction of one-, two-, and pair-spectator three-hadron channel spaces. It is shared infrastructure for spectrum fitting and amplitude reconstruction.

Contents

• 1. Overview and Quick Start
  • 1.1. Package at a Glance
  • 1.2. Build and Test
  • 1.3. Minimal Library Example
  • 1.4. Scientific Inputs and Generated Outputs
  • 1.5. First Run
  • 1.6. Reading the Manual
• 2. New User Workflow
  • 2.1. The Data Flow
  • 2.2. Build the Package
  • 2.3. Annotated Templates
  • 2.4. Sigma Two-Body Example
  • 2.5. Roper Two- and Three-Body Example
  • 2.6. Channel Selection and Validation
  • 2.7. Consume a Basis from C++
  • 2.8. Common Mistakes
• 3. Hadron Catalogs and Quantum Numbers
  • 3.1. The Hadron Class
  • 3.2. Doubled Quantum Numbers
  • 3.3. Hadron XML Fields
  • 3.4. Basis, Metadata, and Units
  • 3.5. Charge Conjugation
  • 3.6. Using Catalogs from C++
• 4. Multi-Hadron States
  • 4.1. Compositions and Thresholds
  • 4.2. Flavor-First Target Discovery
  • 4.3. One-Hadron States
  • 4.4. Two-Hadron States
  • 4.5. Three-Hadron States
  • 4.6. Target Sectors
  • 4.7. Higher-Multiplicity Thresholds
• 5. Channel Spaces
  • 5.1. One-Hadron Channels
  • 5.2. Two-Hadron Channels
  • 5.3. Pair-Spectator Channels
  • 5.4. G-Parity Projection
  • 5.5. Channel Bases
  • 5.6. Construction and Lookup
  • 5.7. Stable Channel Identity
  • 5.8. Generation and Validation
  • 5.9. Current Boundary
• 6. XML and Command Reference
  • 6.1. Canonical XML Policy
  • 6.2. Hadron Catalog Schema
  • 6.3. Flavor-Sector Search Schema
  • 6.4. Strict Shape Validation
  • 6.5. Target Schema
  • 6.6. Channel Schema
  • 6.7. Catalog Commands
  • 6.8. Target Commands
  • 6.9. Threshold and Channel Reports
  • 6.10. Channel Database Validation
  • 6.11. Recommended File Discipline
• 7. Validation, Errors, and Reproducibility
  • 7.1. Validation Layers
  • 7.2. Single-Hadron Invariants
  • 7.3. Target-Sector Invariants
  • 7.4. Channel-Basis Invariants
  • 7.5. Exceptions in the C++ API
  • 7.6. Command-Line Failure Behavior
  • 7.7. Reviewing Scientific Inputs
  • 7.8. Limits of Validation
• 8. Building and Integration
  • 8.1. Requirements
  • 8.2. Source Tree
  • 8.3. Recommended Local Build
  • 8.4. Custom Build Directory
  • 8.5. Choosing a Compiler
  • 8.6. Manual CMake Build
  • 8.7. Compiled Teaching Examples
  • 8.8. Building Documentation Manually
  • 8.9. Installing Hadros
  • 8.10. Using an Installed Package
  • 8.11. Using Hadros as Source
  • 8.12. CMake Options
  • 8.13. Version Compatibility
• 9. API Reference
  • hadros
• 10. License