Skip to main content

*ifm_contrib* is an Open-Source Extension of the IFM, the Python API of the groundwater modellierung software [FEFLOW](https://en.wikipedia.org/wiki/FEFLOW) by [DHI](https://www.dhigroup.com).

Project description

ifm_contrib

Description

ifm_contrib is an Open-Source Extension of the IFM, the Python API of the groundwater modellierung software FEFLOW by DHI.

It extents the namespace of the classic IFM to facilitate using FEFLOW in combination with the popular Python datascience libraries pandas, geopandas and matplotlib.

The ifm_contrib namespace is a superset of the classic ifm namespace, thus scripts written for the latter will be back-wards compatible and only one library import statement is required.

Project status

The library has been developed since 2019, and reached maturity around 2021 with most features for (geo-)pandas as matplotlib integration in place.

ifm_contrib is published under the MIT license. It is free to use, share and modify. Users are encouraged to contribute their own code back to the project.

Please note that the maintainer of this project is not associated with DHI.

Development setup

  • Clone this repo

  • Inside the repo:

    python -m venv .venv
    source .venv/bin/activate
    pip install -e ".[test]"
    
  • Run unit test with pytest

If you want to create the documentation:

source .venv/bin/activate
pip install -e ".[test,doc]"
cd doc/sphinx
make html
# Open doc/sphinx/build/html/index.html in a browser

Installation

The recommended way of installing ifm_contrib is by copying or cloning the repository directly into the FEFLOW program director next to the classic IFM.

Installation via pip should be done by:

pip install https://github.com/red5alex/ifm_contrib/archive/refs/heads/master.zip

An installation of FEFLOW (version 7.2 or higher) is required.

Getting started

For a detailed introduction and installation notes, see ifm_contrib: An Introduction

Its not a pretty one, but you can find an (unregularly updated) help system including API reference here](https://red5alex.github.io/ifm_contrib/ifm_contrib.contrib_lib.html).

Troubleshooting and Contribution

If you run into issues please open an issue. Please note that the maintainer may not dedicate significant time to the project at this time but will try its best to respond.

Gallery

Visualize FEFLOW Results directly in Jupyter

Create inline plots with the look-and-feel of FEFLOWs directly within Jupyter. The plots can be exported as GeoDataFrames and saved to shape-files easily.
ifm_contrib adds light support for coordinate systems to FEFLOW.

Process FEFLOWs Time Series with Pandas

Time Series (aka Power functions) and History charts can be easily exported to pandas DataFrames. Automatic conversion to DateTime based on FEFLOWs Reference Time. In-Built Synchronization to observation point reference data.

Pandas-access to Nodal and Elemntal Data, Multi-Layer Wells, and much more

Read more in ifm_contrib: An Introduction

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

ifm_contrib-0.2.4.tar.gz (8.7 MB view details)

Uploaded Source

Built Distribution

ifm_contrib-0.2.4-py3-none-any.whl (70.6 kB view details)

Uploaded Python 3

File details

Details for the file ifm_contrib-0.2.4.tar.gz.

File metadata

  • Download URL: ifm_contrib-0.2.4.tar.gz
  • Upload date:
  • Size: 8.7 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.12.8

File hashes

Hashes for ifm_contrib-0.2.4.tar.gz
Algorithm Hash digest
SHA256 61e7d1aa50f0fbed1d25c04a7ef56144941479eff262a8ba4681ac565b278471
MD5 c0b7473414b9d6d00d964c07aded0dbe
BLAKE2b-256 a888673b4da6fe2e2dbc7ca749962f2c52ded3cb5b5efc55f75837e9e332b9ce

See more details on using hashes here.

File details

Details for the file ifm_contrib-0.2.4-py3-none-any.whl.

File metadata

  • Download URL: ifm_contrib-0.2.4-py3-none-any.whl
  • Upload date:
  • Size: 70.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.12.8

File hashes

Hashes for ifm_contrib-0.2.4-py3-none-any.whl
Algorithm Hash digest
SHA256 0b9a8c0013110b90996a7cfdbb1aacb8ac5d8164132efd5172e9fa360c4d0fea
MD5 cf613c705175f11e54f5c76329ac3f98
BLAKE2b-256 42a0ee1b748ba7000a4439211807a03427a9f9e66cf382b673c059c6365993e6

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page