top of page

USA

UK

USA

AUS

FP_710x1440 2.png

Save Time and Effort by Creating Your Own Script

  • Alastair Sheppard
  • May 18, 2023
  • 2 min read

Updated: Feb 20

Daisy Lambert, Graduate Hydraulic Modeller at Jacobs



Introduction


As a Graduate Hydraulic Modeller with intermediate Python skills, I had the exciting opportunity to work with the Flood Modeller API. This experience has been both a fun challenge and a valuable learning journey, allowing me to enhance my Python skills and expand my modelling knowledge. In this article, I share my journey of creating a script to convert models from ESTRY (TUFLOW) to Flood Modeller 1D.


Unlocking the Power of the Flood Modeller API


For those unfamiliar, the Flood Modeller API serves as a bridge between flood modelling software and the Python programming language. By writing your own scripts, you can integrate custom tools and workflows, significantly boosting your productivity and delivering innovative solutions to your clients through task automation.


If you’ve ever built a model, you know how repetitive certain tasks can be. Converting a model from one format to another is essentially a model-building task. When I set out to convert a model, I first listed the tasks I needed to complete:


  • Create the river cross sections

  • Name the unit

  • Add the cross-section profile data

  • Add the roughness values

  • Add the distance to next values

  • Geospatially locate each unit

  • Arrange the network in the correct order


The first five tasks are extremely tedious and must be repeated for every cross section, increasing the risk of manual input errors. Automating these tasks can save hours of effort! This motivated me to build a conversion tool using the Flood Modeller Python API. By writing a script to automate these tasks, I was able to streamline the process significantly.


Efficiency at Its Best


In just a few seconds, the script converts all the river sections and correctly inputs the associated data. In my example, which contains 48 cross sections, assuming each river unit takes 3 minutes to build, we saved nearly 2.5 hours of effort before considering time for checking or breaks


Join the Open Source Revolution


One of the most exciting aspects of the Flood Modeller API is that it is open source, meaning anyone can develop their own tools. You can request these to be merged into the main Flood Modeller API or keep them for internal use only.


Additionally, if there’s a tool or component of the API you’d like to see developed but don’t have the ability to create yourself, we encourage you to submit your ideas via the Flood Modeller GitHub page. It could be developed for future releases!



Daisy Lambert


Daisy is a Graduate Hydraulic Modeller at Jacobs. She has experience working on a range of schemes, including reservoir flood studies, surface water flood risk assessments and various integrated 1D-2D modelling projects. I also support the development of the Flood Modeller API, including a number of conversion tools.


bottom of page