OTLMOW-Converter
OTLMOW Project
This project aims to implement the Flemish data standard OTL (https://wegenenverkeer.data.vlaanderen.be/) in Python. It is split into different packages to reduce compatibility issues
- otlmow_model
- otlmow_modelbuilder
- otlmow_converter (you are currently looking at this package)
- otlmow_template
- otlmow_postenmapping
- otlmow_davie
- otlmow_visuals
- otlmow_gui
Functionality
The core functionality of this library is creating instances of otlmow_model classes by converting or creating them. The instances can then be manipulated and finally exported to a different format. When exporting to a file, a DAVIE compliant format can be chosen so that the data can be imported in the DAVIE application.
Supported formats and objects
Using this library, you can convert between the following objects and formats
- otlmow class objects
- class objects can simply be instantiated in code or created using the helpers in the otlmow-model library
- files
- chose one of the many supported file formats to read from or write data to
- some file formats are DAVIE compliant, meaning they can be imported in the DAVIE application
- dictionaries
- class objects have a simple dictionary representation and are more efficient to work with in memory
- some attribute values can be dictionaries themselves
- because of cardinality, dictionary values can be a list of values or a list of dictionaries
- with rdf as true, the dictionary uses the RDF representation with full URIs as keys (and some of the values)
- dotnotation dictionaries
- these are similar to dictionaries, but they use dotnotation to access values
- as a result these are never nested and lists are converted to a string per convention
- pandas dataframes
- the popular pandas library is supported for reading and writing data, but it is not DAVIE compliant
- it uses the dotnotation convention
Converter class
The main class in this library is the OtlmowConverter class. This class is a facade class and has a couple of methods to convert between the different types of objects. The main methods are:
- to_objects: converts to instantiated otlmow class objects
- to_file: converts to a file
- to_dicts: converts to an iterable of dictionaries
- to_dotnotation_dicts: converts to an iterable of to_dotnotation dictionaries
- to_dataframe: converts to a pandas dataframe (or a dictionary holding multiple dataframes)
These methods can use any of the supported formats as input (subject). The methods determine the format of the subject and convert it to the desired format.
There are also from_A_to_B methods (i.e. from_dicts_to_objects) where either A or B are otlmow class objects. These methods are more efficient as they do not need to determine the format of the subject.
Installation and requirements
I recommend working with uv. Install this first:
pip install uv
Then install this package by using the uv pip install command:
uv pip install otlmow-converter
If you are a developer, use this command to install the dependencies, including those needed to run the test suite.
uv pip install -r pyproject.toml --extra test
Code examples and usage
See the Readme notebook
Supported file formats
The following file formats are supported in OtlmowConverter
| File format | Read | Write | DAVIE compliant |
|---|---|---|---|
| CSV | Yes | Yes | Yes |
| Excel | Yes | Yes | Yes |
| JSON | Yes | Yes | Yes |
| GeoJSON | Yes | Yes | Yes |
| JSON-LD | Yes | Yes | No |
| Pandas Dataframe | Yes | Yes | No |
| TTL | No | Yes | No |
1 maintainer
Release files for otlmow-converter 1.26
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| otlmow_converter-1.26.tar.gz | 79.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| otlmow_converter-1.26-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 166.3 kB
Release files / otlmow_converter-1.26.tar.gz
| Download URL | otlmow_converter-1.26.tar.gz |
|---|---|
| Size | 79.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1305c8b2449e35a79e977c6a56f9c41ec87a14a38751fb862a64e8892cffa272
|
|
BLAKE2b-256 checksum How to use checksums |
8d3e912d09952e2676fbc3e0cf5b6d7110421df94cba2aa2d314693826f1ce9b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 25, 2026.
Transparency logRelease files / otlmow_converter-1.26-py3-none-any.whl
| Download URL | otlmow_converter-1.26-py3-none-any.whl |
|---|---|
| Size | 86.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3bda17433ea63eefaa93ad4ceb657eb353e57ec5492cd732bd0a988f5d7dcc66
|
|
BLAKE2b-256 checksum How to use checksums |
a6e8d2d02a9aded183e999ef5a9d399f44165cfaf1fe84f307fc7aca4e3927df
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 25, 2026.
Transparency log
