Infrastructure Modules
======================

The Modules directory contains fundamental infrastructure components.

For complete API reference, see the Doxygen-generated HTML documentation in ``doxygen-docs/html/``.

Module Components
-----------------

Templates
~~~~~~~~~

Base template classes defining interfaces:

* ``event_template.h`` - Event processing
* ``particle_template.h`` - Particle representation
* ``graph_template.h`` - Graph construction
* ``model_template.h`` - Neural network models
* ``metric_template.h`` - Performance metrics
* ``selection_template.h`` - Event selection

Container
~~~~~~~~~

Data container utilities for efficient storage.

**Location**: ``src/AnalysisG/modules/container/``

DataLoader
~~~~~~~~~~

Data loading and batching infrastructure.

**Location**: ``src/AnalysisG/modules/dataloader/``

Features:
* ROOT file reading
* Batch preparation
* Multi-threaded pipeline
* Caching and prefetching

IO Module
~~~~~~~~~

Input/output operations.

**Location**: ``src/AnalysisG/modules/io/``

Graph Module
~~~~~~~~~~~~

Graph utilities and operations.

**Location**: ``src/AnalysisG/modules/graph/``

Meta Module
~~~~~~~~~~~

Metadata management and tracking.

**Location**: ``src/AnalysisG/modules/meta/``

Structs Module
~~~~~~~~~~~~~~

Common data structures.

**Location**: ``src/AnalysisG/modules/structs/``

Key structures:
* ``property.h`` - Property system
* ``element.h`` - Element definitions
* ``event.h`` - Event structures

Tools Module
~~~~~~~~~~~~

Utility functions and tools.

**Location**: ``src/AnalysisG/modules/tools/``

Neutrino Solver
~~~~~~~~~~~~~~~

Neutrino reconstruction algorithms.

**Location**: ``src/AnalysisG/modules/nusol/``

Submodules:

* **nusol** - Neutrino solutions
* **conuix** - Constrained solutions
* **ellipse** - Elliptic constraint methods
* **multisol** - Multi-solution handling

Features:
* Analytic reconstruction
* Kinematic constraints
* Multiple solution handling
* CUDA acceleration

Optimizer
~~~~~~~~~

Training optimization utilities.

**Location**: ``src/AnalysisG/modules/optimizer/``

Loss Functions
~~~~~~~~~~~~~~

Loss function implementations.

**Location**: ``src/AnalysisG/modules/lossfx/``

Plotting
~~~~~~~~

Visualization and plotting utilities.

**Location**: ``src/AnalysisG/modules/plotting/``

ROC Analysis
~~~~~~~~~~~~

ROC curve analysis tools.

**Location**: ``src/AnalysisG/modules/roc/``

Analysis
~~~~~~~~

Analysis tools and utilities.

**Location**: ``src/AnalysisG/modules/analysis/``

Notification
~~~~~~~~~~~~

Notification and messaging system.

**Location**: ``src/AnalysisG/modules/notification/``

Sample Tracer
~~~~~~~~~~~~~

Sample tracking and management.

**Location**: ``src/AnalysisG/modules/sampletracer/``

Type Casting
~~~~~~~~~~~~

Type conversion utilities.

**Location**: ``src/AnalysisG/modules/typecasting/``

Particle
~~~~~~~~

Particle utilities and operations.

**Location**: ``src/AnalysisG/modules/particle/``

Selection
~~~~~~~~~

Event selection infrastructure.

**Location**: ``src/AnalysisG/modules/selection/``

Model Infrastructure
~~~~~~~~~~~~~~~~~~~~

Model management and checkpointing.

**Location**: ``src/AnalysisG/modules/model/``

Metric Infrastructure
~~~~~~~~~~~~~~~~~~~~~

Metrics collection system.

**Location**: ``src/AnalysisG/modules/metric/``

Design Principles
-----------------

Infrastructure modules follow:

* **Modularity**: Independent, reusable components
* **Performance**: Optimized C++ implementations
* **Flexibility**: Extensible interfaces
* **Integration**: Seamless component interaction