User Guide
==========

This guide walks you through using BAM Engine, from understanding the underlying
economic model to writing your own extensions and validating results against the
reference literature.

Whether you're new to agent-based modeling or an experienced researcher, the guide
is organized in progressive order: start with the conceptual foundations, learn the
core API, then move to advanced customization and validation workflows.

.. toctree::
   :maxdepth: 2
   :caption: Understanding the Model

   overview
   bam_model

.. toctree::
   :maxdepth: 2
   :caption: Using BAM Engine

   running_simulations
   configuration
   data_collection
   operations

.. toctree::
   :maxdepth: 2
   :caption: Extending the Framework

   custom_roles
   custom_events
   custom_relationships
   pipelines

.. toctree::
   :maxdepth: 2
   :caption: Model Extensions

   extensions

.. toctree::
   :maxdepth: 2
   :caption: Validation & Calibration

   validation
   calibration

.. toctree::
   :maxdepth: 2
   :caption: Reference & Tips

   implementation_decisions
   best_practices