EGU21-6731, updated on 04 Mar 2021
EGU General Assembly 2021
© Author(s) 2021. This work is distributed under
the Creative Commons Attribution 4.0 License.

Dynamic Coupling of SWAT+ with System Dynamics Models using Tinamït and a Socket Based Protocol

Joel Z. Harms, Julien J. Malard, and Jan F. Adamowski
Joel Z. Harms et al.
  • McGill University, Department of Bioresource Engineering, Canada (

Effective and sustainable decision making in water resources management often requires modelling techniques that are able to account for the inherent complexity of coupled human-water systems. One approach that is used to model coupled human-water systems is to couple physically based models and system dynamics models. However, in many cases, this type of model coupling is labour-intensive and time-consuming, which can hinder its routine use in modeling and decision making.

Tinamït, a Python package, is an application programming interface (API) that provides definitions of functions and objects that simplify, in this case, coupled model building. Tinamït supports automatic SD model wrapping and coupling to specialized physically-based models, which makes it particularly useful for coupled human-water systems modelling. In this research, a connection between SWAT+ (a FORTRAN-based hydrological model) and the Tinamït API is established through model wrapping. This wrapping approach takes advantage of both the agility of sockets and the wide applicability of JavaScript Object Notation (JSON) to transmit data between FORTRAN and Python routines at runtime. Any model that runs in SWAT+ can now be automatically coupled to SD models through the Tinamït API, without the need for extensive programming, therefore facilitating wider application of coupled modelling techniques for integrated policy development and decision making in the field of coupled human-water systems.

How to cite: Harms, J. Z., Malard, J. J., and Adamowski, J. F.: Dynamic Coupling of SWAT+ with System Dynamics Models using Tinamït and a Socket Based Protocol, EGU General Assembly 2021, online, 19–30 Apr 2021, EGU21-6731,, 2021.

Display materials

Display link Display file

Comments on the display material

to access the discussion