Here you see a list of scripts that can be used for preprocessing all the metro
systems in the world from OpenStreetMap. subways
package 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
scripts/process_subways.py
with appropriate set of command line arguments to build metro structures and receive a validation log. - Run
tools/v2h/validation_to_html.py
on that log to create readable HTML tables.
There is a scripts/process_subways.sh
script 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 scripts/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
-
Configure python environment, e.g.
python3 -m venv scripts/.venv source scripts/.venv/bin/activate pip install scripts/requirements.txt
-
Execute
python3 scripts/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 tools/v2h/validation_to_html.py validation.log html
Expose a directory with static contents via a web-server and put into it:
- HTML files from the directory specified in the 2nd parameter of
scripts/v2h/validation_to_html.py
- To vitalize "Y" (YAML), "J" (GeoJSON) and "M" (Map) links beside each city name:
- The contents of
render
directory from the repository cities.txt
file generated with--dump-city-list
parameter ofscripts/process_subways.py
- YAML files created due to -d option of
scripts/process_subways.py
- GeoJSON files created due to -j option of
scripts/process_subways.py
- The contents of
Summary information about all metro networks that are monitored is gathered in the Google Spreadsheet.
Regular updates of validation results are available at this website. You can find more info about this validator instance in OSM Wiki.
To quickly add stop_area
relations for the entire city, use the tools/stop_areas/make_stop_areas.py
script.
Give it a bounding box or a .json
file download from Overpass API.
It would produce a 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.