assembly-economics/simulations/README.md
tegwick 56649466ac ASSEMBLY-WP-0009-T03: sentiment and legitimacy loop in GADM-0.4 (opt-in); legitimacy.py; AdoptionBand § 3; BR-005
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Assistant: claude-code
Assistant-Model: opus
Assistant-Process: 14913@bnt-lap001
Assistant-Session: add7ef69-b901-4756-9a67-34cf1125d96f
2026-10-13 14:17:21 +02:00

25 lines
1.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Simulations
Runnable implementations of the models in `models/`. Each simulation names the
model version it implements.
| Directory | Model | Entry points |
|-----------|-------|--------------|
| `gadm02/` | GADM-0.2 (`models/GADM-0.2.md`) | `run_scenarios.py`, `sensitivity.py`, `gsa.py`, `test_gadm02.py` |
| `gadm02/gadm03.py` | GADM-0.3: power channels, wealth, attention (`models/GADM-0.3.md`) | `power_channels.py`, `wealth.py`, `organism_grid.py`, `test_gadm03.py` |
| `gadm02/gadm03c.py` | GADM-0.3 with life-cycle cohorts (`models/GADM-0.3.md` § 5) | `life_cycle.py`, `test_gadm03c.py` |
| `gadm02/gadm04.py` | GADM-0.4: durable capability, grounded dO, equilibrium start, cohort agency (`models/GADM-0.4.md`) | `life_cycle.py --model gadm04`, `robustness.py`, `agency.py`, `grounded_readings.py`, `test_gadm04.py` |
| `gadm02/grounding.py` | evidence-grounded parameter sets and adoption band B1–B4 (`models/ParameterGrounding.md`, `models/AdoptionBand.md`) | `variant("slow" \| "central" \| "fast" \| "aggressive")`, `band_probe.py`, `legitimacy.py` |
Python 3.10+, standard library only. Use `python3 -B` after quick edits: a stale
bytecode cache can mask same-size changes made within the same second.
```bash
python3 -m unittest discover -s simulations/gadm02 # tests
cd simulations/gadm02 && python3 run_scenarios.py # → results/summary.md + CSVs
cd simulations/gadm02 && python3 sensitivity.py # → results/sensitivity.md
cd simulations/gadm02 && python3 -B gsa.py --jobs 8 # → results/gsa.md (--model gadm04 → gsa_gadm04.md; --quick)
```
Results under `results/` are committed so that model documents can cite them.
Regenerate them after any change to the model or the scenarios.