Skip to main content

Importer and Exporter for GWSW

Project description

A library for the GWSW-hydx exchange format

RioNED is going to release a new format for exchanging sewerage data called GWSW-hydx. This tool could be used to exchange sewerage data from and to a hydx format (*.csv).

For more information about GWSW-hydx:

For more information about the database scheme of 3Di:

Purporse of this script is to exchange information between different formats. This means that this library doesn’t improve lacking or incorrect data. For example, it doesn’t remove double manholes on the same location. This libary does provide all kinds of checks with warning and error messages.

This tool is currently in development. Therefore only nodes, weirs, orifices and pumpstations are currently supported.


We’re installed with:

$ pip install hydxlib

Running script

It’s possible to run this tool on command line or with python


$ hydxlib --import_type hydx --export_type threedi etc.


from hydxlib import run_import_export, write_logging_to_file

log_relpath = os.path.join(os.path.abspath(options.hydx_path),
run_import_export(import_type, export_type, hydx_path, threedi_db_settings)

Installation for development

We’re installed with pipenv, a handy wrapper around pip and virtualenv. Install that first with pip install pipenv. Then run on Linux:

$ PIPENV_VENV_IN_PROJECT=1 pipenv --three
$ pipenv install --dev

on Windows:

$ pipenv --three
$ pipenv install --dev

There will be a script you can run like this:

$ pipenv run run-hydxlib

It runs the main() function in hydxlib/, adjust that if necessary. The script is configured in (see entry_points).

In order to get nicely formatted python files without having to spend manual work on it, run the following command periodically:

$ pipenv run black hydxlib

Run the tests regularly. This also checks with pyflakes, black and it reports coverage. Pure luxury:

$ pipenv run pytest

The tests are also run automatically on “travis”, you’ll see it in the pull requests. There’s also coverage reporting on

Changelog of hydxlib

0.7 (2020-03-03)

  • Closing database connection
  • Updating bug in rectangular cross sections

0.6 (2019-11-22)

  • Using the final version of the hydx format.

0.5 (2019-02-12)

  • Bug fix discharge coefficient orifices in Threedi.

0.4 (2019-01-18)

  • Small fixes.

0.3 (2019-01-09)

  • Added docstrings and updated the readme.

0.2 (2019-01-09)

  • Enabled automatic uploads from

0.1 (2019-01-09)

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hydxlib-0.7.tar.gz (45.0 kB view hashes)

Uploaded source

Built Distribution

hydxlib-0.7-py3-none-any.whl (50.5 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page