> For the complete documentation index, see [llms.txt](https://docs.metacity.cc/metacity/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.metacity.cc/metacity/archives/amos/matsim/matsim-input/osm.md).

# OSM

How to preprocess OSM before creating a MATSim network, additional info about OSM

## Data Reference

<http://download.geofabrik.de/osm-data-in-gis-formats-free.pdf>

## [Planet OSM](https://planet.openstreetmap.org)

Chapter 17, <http://ci.matsim.org:8080/job/MATSim-Book/ws/partOne-latest.pdf>

1. Download Czech Republic (.osm): <https://download.geofabrik.de/europe/czech-republic.html>
2. Use [osmium-tool](https://osmcode.org/osmium-tool/) to extract Prague: <https://osmcode.org/osmium-tool/manual.html#the-osmium-command>
   1. Polygons describing Prague (.geojson) - 57 districts: <https://www.geoportalpraha.cz/en/data/opendata/E9E20135-18B3-4163-B516-45613956B856>
   2. Join the districts into one polygon: `./dissolve-polygon.py MAP_MESTSKECASTI_P.json prague-polygon.json`
   3. Run: `osmium extract -p prague-polygon.json czech-republic-latest.osm.pbf -o prague.osm.pbf`
   4. Optionally convert to osm: `osmium cat prague.osm.pbf -o prague.osm`
3. *Optional: Create a multimodal network (roads, pt, rails, ...)*\
   \_\_<https://github.com/matsim-org/pt2matsim/wiki/Creating-a-multimodal-network-(Osm2MultimodalNetwork)>

## [OpenStreetMaps](https://www.openstreetmap.org)

***Allows to export only a small area!***

1. Export OSM data (map.osm)
2. Compress using some tool to .osm.pbf (e. g. osmium-tool): <https://osmcode.org/osmium-tool/>
3. Use SupersonicOsmNetworkReader to change data to MATSim XML ([OsmNetworkReader](https://www.matsim.org/apidocs/core/12.0/org/matsim/core/utils/io/OsmNetworkReader.html) is deprecated)
4. Run NetworkSimplifier from MATSim - improves simulation performance, introduces artifacts
5. Run NetworkCleaner from MATSim

## Cycle Data in OSM

Refer to: <https://2018.stateofthemap.org/slides/A35-Using_OpenStreetMap_to_model_bicycle_traffic_in_an_agent-based_transport_simulation.pdf>

Bikes in MATSim: <https://github.com/matsim-org/pt2matsim/issues/137>

* Main road with a bicycle lane
  * `highway=?` and `cycleway=lane`
* Bicycle lane on the sidewalk
  * `highway=?` and `cycleway=track`
* A bicycle track away from roads
  * `highway=cycleway`

## OSM Tags in MATSim OsmNetworkReader

To process the OSM file into a MATSim network correctly, the following tags must be used:

{% embed url="<https://github.com/matsim-org/matsim-libs/blob/master/contribs/osm/src/main/java/org/matsim/contrib/osm/networkReader/OsmTags.java>" %}