-
Notifications
You must be signed in to change notification settings - Fork 0
Home
ODKConvert is a project that aims to simplify the process of processing data collected using OpenDataKit into OpenStreetMap format. It consists of several utility programs that automate different parts of the data flow. These include creating satellite imagery basemaps and data extracts from OpenStreetMap so they can be used with ODK Collect. It is maintained by the Humanitarian OpenStreetMap Team (HOT) and designed to work with ODK Collect, an Android app for data collection, and ODK Central, a web-based platform for managing and visualizing data.
This program converts the data collected from ODK Collect into the proper OpenStreetMap tagging schema. The conversion is controlled by a YAML file, which makes it easy to modify for other projects. The output is an OSM XML formatted file for JOSM. However, it is important to note that no converted data should ever be uploaded to OSM without first validating the conversion in JOSM. To do high-quality conversion from ODK to OSM, it's best to use the XLSForm library as template, as everything is designed to work together.
ODKConvert includes the following utilities:
-
make_data_extract.py: extracts OpenStreetMap data within a given boundary and category (e.g., buildings, amenities) using Overpass Turbo or a Postgres database. -
CSVDump.py: converts a CSV file downloaded from ODK Central to OSM XML format. -
odk2csv.py: converts an ODK XML instance file to the same CSV format used by ODK Central. -
ODKDump.py: extracts data from an ODK Collect instance XML file and converts it to OSM XML format. -
ODKForm.py: parses an ODK XML form file and extracts its fields and data types. -
ODKInstance.py: parses an ODK Collect instance XML file and extracts its fields and data values.
ODKConvert also includes support modules, such as convert.py for processing YAML config files and osmfile.py for writing OSM XML output files.
To install ODKConvert, you can either install it directly from the main branch using the command:
pip install git+https://github.com/hotosm/odkconvert.git
Or install the latest version from PyPI using: pip install ODKConvert
Note: installation requires GDAL >3.4 installed on your system.
Each utility has its own command-line interface, with various options and arguments. You can find detailed instructions on how to use each utility by running it with the -h or --help option.
For example, to extract OSM data within a boundary polygon from Overpass Turbo, run:
./make_data_extract.py --overpass --boundary mycounty.geojson
This will create a GeoJSON file with the extracted data.
To convert a CSV file from ODK Central to OSM XML format, run:
./CSVDump.py -i data.csv
This will generate two output files - one OSM XML of public data, and the other a GeoJson file with all the data.
ODKConvert is an open-source project, and contributions are always welcome! If you want to contribute, please read the Contribution Guidelines and Code of Conduct first.
ODKConvert is released under the AGPLv3.