{"id":22458232,"url":"https://github.com/beyondsimulations/metro-inflow-optimization","last_synced_at":"2026-01-06T15:41:25.031Z","repository":{"id":256908951,"uuid":"745475637","full_name":"beyondsimulations/Metro-Inflow-Optimization","owner":"beyondsimulations","description":"This is the code to a paper that balances passenger flows into urban rail transport systems under peak demands.","archived":false,"fork":false,"pushed_at":"2024-10-03T08:33:06.000Z","size":408342,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-23T22:52:57.990Z","etag":null,"topics":["decision-support","overcrowding","passenger-flow","urban-rail-transit"],"latest_commit_sha":null,"homepage":"","language":"Julia","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/beyondsimulations.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-01-19T12:18:20.000Z","updated_at":"2024-10-03T08:33:09.000Z","dependencies_parsed_at":"2024-09-18T18:16:05.993Z","dependency_job_id":null,"html_url":"https://github.com/beyondsimulations/Metro-Inflow-Optimization","commit_stats":null,"previous_names":["beyondsimulations/metro-inflow-optimization"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beyondsimulations%2FMetro-Inflow-Optimization","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beyondsimulations%2FMetro-Inflow-Optimization/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beyondsimulations%2FMetro-Inflow-Optimization/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beyondsimulations%2FMetro-Inflow-Optimization/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/beyondsimulations","download_url":"https://codeload.github.com/beyondsimulations/Metro-Inflow-Optimization/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245858561,"owners_count":20684054,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["decision-support","overcrowding","passenger-flow","urban-rail-transit"],"created_at":"2024-12-06T08:11:35.305Z","updated_at":"2026-01-06T15:41:25.026Z","avatar_url":"https://github.com/beyondsimulations.png","language":"Julia","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Metro Inflow Optimization\n\nThis repository contains the code for optimizing passenger inflow into metro systems to prevent overcrowding. It supports multiple regions through a TOML-based configuration system.\n\n## Supported Regions\n\n| Region | Interval | Data Period | Data Availability |\n|--------|----------|-------------|-------------------|\n| Doha Metro | 15 min | Nov 27-30, 2022 | Not included (confidential) |\n| Shanghai Metro | 10 min | May-Aug 2017 | Publicly available |\n\n**Note**: Doha Metro data cannot be provided due to confidentiality agreements. The framework supports Doha but users must supply their own data.\n\n## Quick Start\n\n### Prerequisites\n\n- Julia 1.9+\n- Required packages (see `metroflow/Project.toml`)\n\n### Running the Framework\n\n```bash\n# Doha (default)\njulia metro_framework_parallel.jl 15 '2022-11-29T05:00:00' '2022-11-30T04:59:00'\n\n# Shanghai\njulia metro_framework_parallel.jl --config config/shanghai.toml 10 '2017-05-15T05:00:00' '2017-05-16T04:59:00'\n```\n\n## Directory Structure\n\n```\n├── config/                      # Region configuration files\n│   ├── doha.toml\n│   └── shanghai.toml\n├── data_public/\n│   └── Shanghai/                # Shanghai Metro data\n│       ├── README.md            # Detailed preprocessing docs\n│       ├── stationInfo.csv      # Station data (included, with fixes)\n│       ├── station_lines_2017.csv\n│       ├── stations_shanghai.csv    # Generated\n│       ├── metroarcs_shanghai.csv   # Generated\n│       └── OD_*.csv                 # Generated\n├── functions/                   # Core Julia modules\n│   ├── config.jl                # Configuration loading\n│   ├── metro_functions.jl       # Data loading utilities\n│   ├── metro_model.jl           # Optimization models\n│   ├── metro_heuristic.jl       # Heuristic algorithms\n│   └── metro_simulation.jl      # Simulation logic\n├── results/                     # Output directory\n├── metroflow/                   # Julia project environment\n└── metro_framework_parallel.jl  # Parallel framework (recommended)\n```\n\n## Shanghai Data Setup\n\nThe Shanghai data requires preprocessing. Station data files are included with corrections; OD flow files must be downloaded separately.\n\n### 1. Download OD Data\n\nDownload from the [original dataset](https://www.nature.com/articles/s41597-025-05416-8):\n- `metroData_ODFlow.csv` (11 GB)\n- `metroData_InOutFlow.csv` (217 MB)\n\nPlace in `data_public/Shanghai/`.\n\n### 2. Build Network\n\n```bash\ncd data_public/Shanghai\njulia --project=../../metroflow build_metroarcs.jl\n```\n\nThis generates:\n- `stations_shanghai.csv` - Expanded network nodes\n- `metroarcs_shanghai.csv` - Network arcs with capacities\n\n### 3. Visualize Network (optional)\n\n```bash\njulia --project=../../metroflow plot_network.jl\n```\n\nOpens an interactive HTML plot for data verification.\n\n### 4. Transform OD Data\n\n```bash\njulia --project=../../metroflow transform_od.jl 2017-05-15 2017-05-21\n```\n\nSee `data_public/Shanghai/README.md` for detailed documentation.\n\n## Configuration Parameters\n\nEdit config files in `config/` or pass via command line:\n\n| Parameter | Description |\n|-----------|-------------|\n| `set_safety` | Safety factor limiting arc capacity |\n| `set_max_enter` | Maximum passengers allowed to enter |\n| `set_min_enter` | Minimum passengers allowed to enter |\n| `set_scaling` | Demand scaling factor |\n| `minutes_in_period` | Optimization period length (must be multiple of interval) |\n\n## Output\n\nResults are saved with region prefix:\n- `results/logfile_{region}_*.csv` - Aggregated summary\n- `results/queues/sim_queues_{region}_*.csv` - Queue data\n- `results/arcs/sim_arcs_{region}_*.csv` - Arc utilization\n\n## License\n\nThis project is licensed under the MIT License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbeyondsimulations%2Fmetro-inflow-optimization","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbeyondsimulations%2Fmetro-inflow-optimization","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbeyondsimulations%2Fmetro-inflow-optimization/lists"}