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.
- Choose transport data source:
- Download or update a planet file in o5m format (using
osmconvert
andosmupdate
). Runosmfilter
to extract a portion of data for all subways. Or - If you don't specify
--xml
or--source
option to theprocess_subways.py
script it tries to fetch data over Overpass API. Not suitable for the whole planet or large countries.
- Download or update a planet file in o5m format (using
- 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.
There is a process_subways.sh
in the scripts
directory that is suitable
for validation of all or many metro networks. It relies on a bunch of
environment variables and takes advantage of previous validation runs
for effective recurring validations. See
./scripts/process_subways.sh --help
for details. Here is an example of the script usage:
export PLANET=https://ftp5.gwdg.de/pub/misc/openstreetmap/planet.openstreetmap.org/pbf/planet-latest.osm.pbf
export PLANET_METRO="$HOME/metro/planet-metro.o5m
export OSMCTOOLS="$HOME/osmctools"
export TMPDIR="$HOME/metro/tmp"
export HTML_DIR="$HOME/metro/tmp_html"
export DUMP="$HTML_DIR"
scripts/process_subways.sh
Set the PLANET_METRO variable to avoid the whole planet processing each time. Delete the file (but not the variable) to re-generate it if a new city has been added or a city's bbox has been extended.
A single city or a country with few metro networks can be validated much faster
if you allow the process_subway.py
to fetch data from Overpass API. Here are the steps:
-
Python3 interpreter required (3.11+)
-
Clone the repo
git clone https://github.com/alexey-zakharenkov/subways.git subways_validator cd subways_validator
-
Execute
python3 ./process_subways.py -c "London" \ -l validation.log -d London.yaml
here
-c
stands for "city" i.e. network name from the google spreadsheet-l
- path to validation log file-d
(optional) - path to dump network info in YAML format-i
(optional) - path to save overpass-api JSON response-j
(optional) - path to output network GeoJSON (used for rendering)
validation.log
would contain the list of errors and warnings. To convert it into pretty HTML format -
do
mkdir html python3 ./validation_to_html.py validation.log html
Summary information about all metro networks that are monitored is gathered in the Google Spreadsheet.
Regular updates of validation results are available at Organic Maps and mail.ru servers. You can find more info about this validator instance in OSM Wiki.
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.
The main scripts were originally written by Ilya Zverev for MAPS.ME and were published under Apache Licence 2.0 at https://github.com/mapsme/subways/.
This fork is maintained by Alexey Zakharenkov and is also published under Apache Licence 2.0.