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

1. otlmow class objects
   • class objects can simply be instantiated in code or created using the helpers in the otlmow-model library
2. 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
3. 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)
4. 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
5. 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