How nxthingbutv0id/marscolonysimulation works
This Rust project simulates a Mars colony to study sustainability and how colonist role mixes affect outcomes. The principal workflow is to configure a scenario and population, run a tick-based simulation of colonists, tasks, machines, resources, and environmental events, then summarize results and write CSV output. The graph reflects the sampled implementation and SOURCE INDEX references; the README does not describe the command-line interface, so its initiating path is left unspecified.
Main entry points: colony.rs Colony lifecycle · machine.rs Machine operations · simulation.rs Simulation runner · resources.rs Resource pools
Components 17
Experiments
- Program entry
src/main.rs - Scenario setup
src/experiment/scenario.rs - Role populations
src/experiment/population.rs - Simulation runner
src/experiment/simulation.rs - Random generator
src/experiment/random.rs - Run results
src/experiment/run_results.rs - CSV output
src/experiment/csv_writer.rs
Colony Simulation
- Colony lifecycle
src/model/colony/colony.rs
Agents and Tasks
- Colonist decisions
src/model/agent/colonists.rs - Colony tasks
src/model/colony/tasks.rs
Environment and Machines
- Environmental events
src/model/colony/environment.rs - Machine operations
src/model/machines/machine.rs - Greenhouse
src/model/machines/greenhouse.rs - Solar array
src/model/machines/solar_array.rs - Failure distributions
src/model/machines/probability.rs
State and Time
- Resource pools
src/model/colony/resources.rs - Simulation clock
src/model/time.rs
Connections 29
- Scenario setup → Role populations: builds roles
src/experiment/scenario.rs - Role populations → Random generator: uses randomness
src/experiment/population.rs - Scenario setup → Resource pools: configures resources
src/experiment/scenario.rs - Simulation runner → Scenario setup: accepts scenario
src/experiment/simulation.rs - Simulation runner → Colony lifecycle: advances colony
src/experiment/simulation.rs - Simulation runner → Environmental events: updates events
src/experiment/simulation.rs - Simulation runner → Random generator: seeds randomness
src/experiment/simulation.rs - Simulation runner → Simulation clock: advances clock
src/experiment/simulation.rs - Simulation runner → Run results: produces summary
src/experiment/simulation.rs - CSV output → Run results: writes results
src/experiment/csv_writer.rs - CSV output → Resource pools: reads resource totals
src/experiment/csv_writer.rs - Colony lifecycle → Colonist decisions: collects actions
src/model/colony/colony.rs - Colony lifecycle → Colony tasks: manages tasks
src/model/colony/colony.rs - Colony lifecycle → Environmental events: checks conditions
src/model/colony/colony.rs - Colony lifecycle → Machine operations: runs machines
src/model/colony/colony.rs - Colony lifecycle → Resource pools: updates stores
src/model/colony/colony.rs - Colony lifecycle → Simulation clock: uses simulation time
src/model/colony/colony.rs - Colonist decisions → Colony tasks: selects task work
src/model/agent/colonists.rs - Colonist decisions → Machine operations: selects machine work
src/model/agent/colonists.rs - Machine operations → Resource pools: computes resource flow
src/model/machines/machine.rs - Machine operations → Environmental events: uses conditions
src/model/machines/machine.rs - Machine operations → Failure distributions: checks failures
src/model/machines/machine.rs - Greenhouse → Resource pools: uses resource pool
src/model/machines/greenhouse.rs - Greenhouse → Environmental events: uses conditions
src/model/machines/greenhouse.rs - Greenhouse → Machine operations: implements machine
src/model/machines/greenhouse.rs - Solar array → Resource pools: produces electricity
src/model/machines/solar_array.rs - Solar array → Environmental events: applies storm effect
src/model/machines/solar_array.rs - Solar array → Machine operations: implements machine
src/model/machines/solar_array.rs - Failure distributions → Random generator: samples distributions
src/model/machines/probability.rs