How sahana-652/ssm works
SSM is a discrete-event simulation of a fast-food drive-through, comparing one to three service windows under normal and peak arrivals. Users configure a run through either the Streamlit interface or CLI; both invoke the shared six-scenario runner, which executes the customer/queue simulation and produces KPIs and queue timelines. Results are presented as tables, CSV, and comparison plots. The sampled sources show these calls and data flows; the README gives no additional capability details.
Main entry points: main.py Command line · app.py Web interface · simulation.py DES engine · scenario_runner.py Six-scenario batch
Components 11
Run interfaces
- Web interface
app.py - Command line
main.py
Scenario experiments
- Run configuration
config.py - Six-scenario batch
scenario_runner.py
Simulation model
- DES engine
simulation.py - Customer entities
customer.py - FIFO queue tracking
queue_manager.py
Results and reporting
- KPI tracking
metrics.py - Charts
visualization.py - Scenario results CSV
outputs/scenario_results.csv
Other components
- User
Connections 16
- User → Web interface: sets parameters
app.py - User → Command line: starts run
main.py - Web interface → Run configuration: builds config
app.py - Command line → Run configuration: creates config
main.py - Web interface → Six-scenario batch: runs scenarios
app.py - Command line → Six-scenario batch: runs scenarios
main.py - Six-scenario batch → DES engine: runs replications
scenario_runner.py - DES engine → Customer entities: creates customers
simulation.py - DES engine → FIFO queue tracking: updates queue
simulation.py - DES engine → KPI tracking: records outcomes
simulation.py - Six-scenario batch → Run configuration: accepts config
scenario_runner.py - Web interface → KPI tracking: formats results
app.py - Command line → KPI tracking: formats and exports
main.py - Web interface → Charts: renders charts
app.py - Command line → Charts: generates figures
main.py - Command line → Scenario results CSV: writes CSV
main.py