How iordjn/tareek works
TAREEK turns county-based configuration into a MATSim travel-demand simulation and evaluates it against traffic counts. Its main workflow is region setup, data acquisition, network construction, demand and plan generation, simulation, and validation. The graph also preserves documented configuration-wizard, transit, and freight capabilities. The README establishes the overall stages; SOURCE INDEX references support several module relationships. Unsampled implementations are represented by their exact tree paths, with relationships omitted where their caller or data flow is not evidenced.
Main entry points: run_experiment.py Experiment runner · plan_generator.py Work plans · plan_generator_nonwork.py Non-work plans · survey_manager.py Survey ingestion
Components 22
Setup and data
- Region config
config/config.py - Experiment runner
run_experiment.py - Survey ingestion
data_sources/survey_manager.py - Survey sources
data_sources/base_survey_trip.py - GTFS feeds
data_sources/gtfs_manager.py - DuckDB data store
utils/duckdb_manager.py
Travel demand
- Demand budget
models/demand_budget.py - Chains and timing
models/chains.py - Home and work locations
models/home_locs_v2.py - Activity destinations
models/poi_manager.py - Mode choice
models/mode_choice.py - Work plans
models/plan_generator.py - Non-work plans
models/plan_generator_nonwork.py - Freight demand
estimators/freight_estimator.py
MATSim simulation
- Road and transit network
matsim/network_generator.py - MATSim configuration
matsim/config_manager.py - MATSim runner
matsim/runner.py
Validation and results
- Traffic counts
matsim/counts_generator.py - Simulation evaluator
matsim/evaluator.py
Configuration interface
- Config Wizard
webapp/backend/main.py - Wizard interface
webapp/frontend/js/app.js
Other components
- Region researcher
Connections 28
- Region researcher → Region config: selects region
README.md - Region researcher → Config Wizard: configures region
README.md - Config Wizard → Region config: exports config
README.md - Region config → Experiment runner: configures run
README.md - Experiment runner → Survey ingestion: loads surveys
run_experiment.py - Survey ingestion → Survey sources: selects sources
data_sources/survey_manager.py - Survey sources → DuckDB data store: saves trips
data_sources/base_survey_trip.py - Experiment runner → Road and transit network: builds network
run_experiment.py - Road and transit network → GTFS feeds: loads transit feeds
matsim/network_generator.py - Survey ingestion → Demand budget: informs demand
models/demand_budget.py - Demand budget → Work plans: sets demand
models/plan_generator.py - Demand budget → Non-work plans: sets demand
models/plan_generator_nonwork.py - Work plans → Chains and timing: uses chains and timing
models/plan_generator.py - Work plans → Home and work locations: assigns locations
models/plan_generator.py - Work plans → Activity destinations: assigns destinations
models/plan_generator.py - Work plans → Mode choice: chooses modes
models/plan_generator.py - Non-work plans → Chains and timing: uses chains and timing
models/plan_generator_nonwork.py - Non-work plans → Activity destinations: assigns destinations
models/plan_generator_nonwork.py - Non-work plans → Mode choice: chooses modes
models/plan_generator_nonwork.py - Experiment runner → Work plans: generates plans
run_experiment.py - Experiment runner → Non-work plans: generates plans
run_experiment.py - Experiment runner → Freight demand: estimates freight
run_experiment.py - Experiment runner → MATSim configuration: prepares simulation
run_experiment.py - Experiment runner → MATSim runner: runs simulation
run_experiment.py - MATSim runner → Simulation evaluator: evaluates output
README.md - Traffic counts → Simulation evaluator: provides observations
README.md - Experiment runner → Traffic counts: compares traffic counts
run_experiment.py - Wizard interface → Config Wizard: drives wizard