Configuration
=============

ideasim is configured via JSON files. Export the default configuration to see
all available parameters::

    ideasim default-config -o config.json

Top-Level Structure
-------------------

The configuration file has the following top-level fields:

- **ideologies**: List of ideology definitions, each with fitness parameters,
  latent sympathy coefficients, and mutation matrices.
- **environment**: Environmental conditions over time (GDP growth, inequality,
  media freedom, social media penetration, conflict intensity).
- **simulation**: Simulation parameters (time span, step size, random seed,
  event rates).

Ideology Parameters
-------------------

Each ideology entry defines:

- ``name``: Human-readable name.
- ``env_response``: Weight vector controlling how the ideology responds to
  environmental conditions.
- ``latent_conversion``: Rate of latent-to-manifest conversion.
- ``latent_generation``: Rate at which adherents generate latent sympathizers.
- ``latent_decay``: Natural decay of latent sympathy.
- ``martyrdom_coeff``: How efficiently suppression creates sympathy.

See the API reference for the full ``Ideology`` dataclass specification.