https://github.com/mapsme/subways

Subway Preprocessor and Validator
https://github.com/mapsme/subways

Last synced: about 2 months ago
JSON representation

Subway Preprocessor and Validator

• Host: GitHub
• URL: https://github.com/mapsme/subways
• Owner: mapsme
• License: apache-2.0
• Created: 2017-10-04T12:59:31.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2020-10-13T08:21:57.000Z (about 4 years ago)
• Last Synced: 2024-08-08T23:22:26.250Z (5 months ago)
• Language: Python
• Size: 294 KB
• Stars: 28
• Watchers: 12
• Forks: 11
• Open Issues: 9
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Subway Preprocessor

Here you see a list of scripts that can be used for preprocessing all the metro

systems in the world from OpenStreetMap. `subway_structure.py` produces

a list of disjunct systems that can be used for routing and for displaying

of metro maps.

## How To Validate

* Choose transport data source:

  1. Download or update a planet file in o5m format (using `osmconvert` and `osmupdate`).

     Run `osmfilter` to extract a portion of data for all subways. Or

  2. If you don't specify `--xml` or `--source` option to the `process_subways.py` script

     it tries to fetch data over [Overpass API](https://wiki.openstreetmap.org/wiki/Overpass_API). **Not suitable for whole planet or large countries.**

* Run `process_subways.py` with appropriate set of command line arguments

  to build metro structures and receive a validation log.

* Run `validation_to_html.py` on that log to create readable HTML tables.

## Validation Script

There is a `process_subways.sh` in the `scripts` directory. The author uses it for

updating both the planet and a city he's working on. Here is an example of a script

for updating the London Underground network:

```bash

PLANET_PATH=$HOME/osm/planet

export OSMCTOOLS="$PLANET_PATH"

export PLANET="$PLANET_PATH/london.o5m"

export HTML_DIR=tmp_html

export BBOX=-0.681152,51.286758,0.334015,51.740636

export CITY="London"

export DUMP=london.yaml

scripts/process_subways.sh

```

The bounding box can be found in the

[Google Spreadsheet](https://docs.google.com/spreadsheets/d/1-UHDzfBwHdeyFxgC5cE_MaNQotF3-Y0r1nW9IwpIEj8/edit?usp=sharing).

This can be simplified by using the `build_city.sh` script, which fetches the bbox from the web:

    scripts/build_city.sh london.o5m London

Daily updates of validation results are available at [this website](http://osm-subway.maps.me).

## Adding Stop Areas To OSM

To quickly add `stop_area` relations for the entire city, use the `make_stop_areas.py` script

from the `stop_area` directory. Give it a bounding box or a `.json` file download from Overpass API.

It would produce an JOSM XML file that you should manually check in JOSM. After that

just upload it.

## Author and License

All scripts were written by Ilya Zverev for MAPS.ME. Published under Apache Licence 2.0.