Skip to main content

Extends the functionality of Flood Modeller to python users

Project description

FM Logo

PyPI Latest Release License: GPL v3 example workflow Downloads Code style: black

Flood Modeller Python API

This python package is designed to be used in conjunction with your installation of Flood Modeller to provide users with a set of tools to extend the capabilities of Flood Modeller and build into automated workflows.

API Overview

Installation

You can install the floodmodeller_api package from PyPI with the following command:

pip install floodmodeller-api

Python 3.6 or greater is required, but we would recommend using a more recent version (3.9+).

Once you have installed floodmodeller_api to your python environment, you can import the package with:

import floodmodeller_api  # imports the full package
from floodmodeller_api import DAT, ZZN, IEF, IED  # imports individual classes (recommended)

How to use

The best place to start is to go directly to the Flood Modeller Python API Documentation

The Flood Modeller Python API is designed for users already familiar with both Flood Modeller and Python. The API is built up using distinct python classes for each of the key Flood Modeller file formats as well as key themes. The purpose of the API is not to provide ready-to-use tools for specific tasks, as there is an extensive set of tools already provided within Flood Modeller, many of which can be called from both within and outside of the Flood Modeller software. Instead, this API provides the building blocks for users to build their own custom workflows and tools which can integrate seamlessly with Flood Modeller.

Show and Tell

In the spirit of open source, we encourage you to share any interesting scripts or tools you have developed using the Flood Modeller Python API. To do this, please get involved in the discussions section here. This is also a great place to explore different ways that people have used the API.


A simple example of running a model and fetching the results...

gif demo

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

floodmodeller_api-0.4.1.tar.gz (3.0 MB view hashes)

Uploaded Source

Built Distribution

floodmodeller_api-0.4.1-py3-none-any.whl (3.4 MB view hashes)

Uploaded Python 3

Supported by

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