Personal tools

Difference between revisions of "Mohid Land"

From MohidWiki

Jump to: navigation, search
(Mohid Land Modules)
(MOHID Land Interfaces)
 
(45 intermediate revisions by 3 users not shown)
Line 1: Line 1:
MOHID Land is the newest core executable of the [[MOHID Water Modelling System]]. This program is designed to simulate hydrographic basin and aquifers.  
+
MOHID Land is the newest core executable of the [[MOHID Water Modelling System]]. This program is designed to simulate hydrographic basin and aquifers. Main equations are described in a simple way in: [[Equations_in_Mohid_Land | equations description]].
  
==Mohid Land Modules==
 
Some modules developed are related with specific processes which occur inside a watershed. Examples are:
 
  
*[[Module PorousMedia]] which calculates infiltration, unsaturated and saturated water movement
+
==MOHID Land's main features==
*[[Module PorousMediaProperties]] which calculates property transport and transformation in soil.
+
 
*[[Module SedimentQuality]] which calculates property transformation in soil driven by microorgansims (mineralization, nitrification, denitrification, etc.).
+
MOHID Land is a physically-based, spatially distributed, continuous, variable time step model for the water and property cycles in inland waters and main mediums and equations are presented in next image:
*[[Module PREEQC]] which calculates property transformation in soil achieving chemical equilibrium.
+
[[Image:MohidLand_Old_New.png|600px|thumb|center|Mohid Land mediums and equations]]
*[[Module Runoff]] which calculates overland runoff;
+
 
*[[Module RunoffProperties]] which calculates property transport in runoff.
+
To follow the description of MOHID Land equations and derivation go to [[Equations in Mohid Land]]
*[[Module DrainageNetwork]] which handles water and property routing and property transformation inside rivers.
 
*[[Module Vegetation]] which handles vegetation growth and agricultural practices.
 
*[[Module Basin]] which handles information between modules and computes interface forcing fluxes between atmosphere and soil (e.g. troughfall, potential evapotranspiration, etc.).
 
See below how you can see module [[Mohid_Land#Source_code | source code]].
 
  
==MOHID Land's main features==
+
===Main Processes===
 +
The main processes solved are:
 
*3D Porous Media solving Richard's Equations
 
*3D Porous Media solving Richard's Equations
 
*1D Drainage Network solving Kinematic Wave, DiffusionWave or complete St. Venant equations (dynamic wave)
 
*1D Drainage Network solving Kinematic Wave, DiffusionWave or complete St. Venant equations (dynamic wave)
Line 23: Line 18:
 
*Porous Media interaction with Runoff in [[Infiltration]] using continuity (Richard's equation with Head gradient)
 
*Porous Media interaction with Runoff in [[Infiltration]] using continuity (Richard's equation with Head gradient)
 
*Porous Media and Runoff interaction with Drainage Network using continuity (surface gradient between Runoff and Drainage Network. Richard's equation with  level gradient between Porous Media and Drainage Network)
 
*Porous Media and Runoff interaction with Drainage Network using continuity (surface gradient between Runoff and Drainage Network. Richard's equation with  level gradient between Porous Media and Drainage Network)
 +
*Drainage Network and Reservoir interaction to account river flow impact due to manmande hydraulic infraestructures
 
*Property transport in all mediums and transformation in soil and river (water quality models can be coupled)
 
*Property transport in all mediums and transformation in soil and river (water quality models can be coupled)
 
*Biological and chemical reactions in soil as mineralization, nitrification, denitrification, immobilization, chemical equilibrium, property decay, and processes in river as primary production, nutrient assimilation, property decay, etc.
 
*Biological and chemical reactions in soil as mineralization, nitrification, denitrification, immobilization, chemical equilibrium, property decay, and processes in river as primary production, nutrient assimilation, property decay, etc.
*Linkage to MOHID Water by Module Discharges
+
*Linkage to [[MOHID Water]] by [[Module Discharges]]
*Floods
 
*Basin Management
 
 
 
==Dynamical time step adaptation==
 
  
 +
===Dynamical time step adaptation===
 
MOHID Land uses an adaptive time-stepping method in its main hydrodynamic cycle. Within an iterative cycle, if the water volume — of reach or overland flow or porous media — varies more than a user defined percentage during two consecutive time steps, the model automatically decreases the time step. Thereafter the model recalculates the current solution with a smaller time step for the affected process (reach or overland flow or porous media). This process is repeated until the volume variation is less than the user defined value mentioned above. The time step dynamically increases again when the model verifies that flow is “stable”. For example within the module "Drainage Network" the time step may be reduced to very short intervals during flush events.
 
MOHID Land uses an adaptive time-stepping method in its main hydrodynamic cycle. Within an iterative cycle, if the water volume — of reach or overland flow or porous media — varies more than a user defined percentage during two consecutive time steps, the model automatically decreases the time step. Thereafter the model recalculates the current solution with a smaller time step for the affected process (reach or overland flow or porous media). This process is repeated until the volume variation is less than the user defined value mentioned above. The time step dynamically increases again when the model verifies that flow is “stable”. For example within the module "Drainage Network" the time step may be reduced to very short intervals during flush events.
 
This procedure avoids the occurrence of negative volumes and optimizes the time it takes to make a certain simulation, without compromising model stability. Time steps of the processes — computed in the different sub-models — can be chosen differently, adding more to the optimization of the computational cost.
 
This procedure avoids the occurrence of negative volumes and optimizes the time it takes to make a certain simulation, without compromising model stability. Time steps of the processes — computed in the different sub-models — can be chosen differently, adding more to the optimization of the computational cost.
  
==GIS Model Interfaces==
+
===Interpolated Rain===
You can download interfaces to prepare inputs and to analyse model results. Presently available two options:
+
You can produce spatialy interpolated rain using [[FillMatrix]] tool, using as input two or more precipitation stations.
* a completly free interface from Mohid Website (www.mohid.com).
+
 
* a beta version of a new interface can be downloaded from [http://www.actionmodulers.com/mohidstudio.html Action Modulers].
+
==MOHID Land Structure, Description and Source Code==
 +
MOHID Land model is programmed in Fortan95 using a OOP (object-oriented programming) philoshophy and code is organized in Modules (or classes) that handle specific processes in specific mediums. Also and interface Module exists to handle the exchange info between classes.
 +
 
 +
===MOHID Land Modules===
 +
Some modules developed are related with specific processes which occur inside a watershed and on a specific medium, creating thus a modular structure. For user first approach and advanced use, processes solved, equations, input data files examples are presented below for each MOHID Land module:
  
==Interpolated Rain==
+
*[[Module PorousMedia]] which calculates infiltration, unsaturated and saturated water movement
You can produce spatialy interpolated rain using [[FillMatrix]] tool, using as input two or more precipitation stations.  
+
*[[Module PorousMediaProperties]] which calculates property transport and transformation in soil.
 +
*[[Module SedimentQuality]] which calculates property transformation in soil driven by microorganisms (mineralization, nitrification, denitrification, etc.).
 +
*[[Module PREEQC]] which calculates property transformation in soil through chemical equilibrium.
 +
*[[Module Runoff]] which calculates overland runoff;
 +
*[[Module RunoffProperties]] which calculates property transport in runoff.
 +
*[[Module DrainageNetwork]] which handles water and property routing and property transformation inside rivers.
 +
*[[Module Vegetation]] which handles vegetation growth and agricultural practices.
 +
*[[Module Irrigation]] which calculates and applies water in the soil according to the limits we defined
 +
*[[Module Reservoirs]] which handles weir and reservoir behavior in changing river flow (Drainage Network interaction) and concentrations.
 +
*[[Module Basin]] which handles information between modules and computes interface forcing fluxes between atmosphere and soil (e.g. throughfall, potential evapotranspiration, etc.).
 +
MOHID Land also uses all the modules for data pre-processing, computation and post-processing that are common to MOHID Water (e.g. data file read, geometry handling, results writing in HDF and timeserie, etc.)
 +
See below how you can see module [[Mohid_Land#Source_code | source code]].
  
==Source code==
+
===MOHID Land Source Code===
You can download the latest source  
+
You can download the latest source code of the model from GitHub ([https://github.com/Mohid-Water-Modelling-System/Mohid# Mohid Land in GitHub]). Just click on the download link, no need to register. For advanced users you can download the entire solution ready to compile.  
code of the model from Codeplex ([http://mohid.codeplex.com/SourceControl/list/changesets# Mohid Land in CodePlex]). Just click on the download link, no need to register. For advanced users you can download the entire solution ready to compile.  
 
  
Other users can just browse around the code of each module to checkout equations. In the links below you can go directly to the version from 4 Feb 2011 and see code in html:
+
Other users can just browse around the code of each module to checkout equations. In the links below you can go directly to the latest version and see code in html:
* [http://mohid.codeplex.com/SourceControl/changeset/view/62235#562258 Mohid Land] Is the Main Program of Mohid Land
+
* [https://github.com/Mohid-Water-Modelling-System/Mohid/blob/master/Software/MOHIDLand/MohidLand.F90 MohidLand] is the main program of Mohid Land
* [http://mohid.codeplex.com/SourceControl/changeset/view/62235#562259 Module Basin] Is the top level of RunOff, Infiltration, River Flow and Vegetation
+
* [https://github.com/Mohid-Water-Modelling-System/Mohid/blob/master/Software/MOHIDLand/ModuleBasin.F90 ModuleBasin] is the top level of Porous Media, RunOff, Infiltration, River Flow and Vegetation
* [http://mohid.codeplex.com/SourceControl/changeset/view/62235#562257 Module Porous Media] Simulates Water Flow in variable saturated soils
+
* [https://github.com/Mohid-Water-Modelling-System/Mohid/blob/master/Software/MOHIDLand/ModulePorousMedia.F90 ModulePorousMedia] Simulates water flow in variable saturated and unsaturated porous media
* [http://mohid.codeplex.com/SourceControl/changeset/view/62235#562255 Module Porous Media Properties] Deals with all property transport in Porous Media.
+
* [https://github.com/Mohid-Water-Modelling-System/Mohid/blob/master/Software/MOHIDLand/ModulePorousMediaProperties.F90 ModulePorousMediaProperties] Deals with all property transport and transformation in Porous Media.
* [http://mohid.codeplex.com/SourceControl/changeset/view/62235#1208091 Module Sediment Quality] Zero-dimensional model for primary production, nitrogen and carbon cycle in the Porous Media (Soil and Aquifer)
+
* [https://github.com/Mohid-Water-Modelling-System/Mohid/blob/master/Software/MOHIDLand/ModuleSedimentQuality.F90 ModuleSedimentQuality] Zero-dimensional model for primary production, nitrogen and carbon cycle in the Porous Media (Soil and Aquifer)
* [http://mohid.codeplex.com/SourceControl/changeset/view/62235#780383 Module PhreeqC] Zero-dimensional model for chemistry equilibrium of solution, pure phases, gas phase, solid phase, exchangers and surfaces in Porous Media (Soil and Aquifer)
+
* [https://github.com/Mohid-Water-Modelling-System/Mohid/blob/master/Software/MOHIDBase1/ModulePhreeqC.F90 ModulePhreeqC] Zero-dimensional model for chemistry equilibrium of solution, pure phases, gas phase, solid phase, exchangers and surfaces in Porous Media (Soil and Aquifer)
* [http://mohid.codeplex.com/SourceControl/changeset/view/62235#562260 Module Run Off] Module which calculates the Surface RunOff
+
* [https://github.com/Mohid-Water-Modelling-System/Mohid/blob/master/Software/MOHIDLand/ModuleRunOff.F90 ModuleRunOff] Module which calculates the surface RunOff
* [http://mohid.codeplex.com/SourceControl/changeset/view/62235#764660 Module Run Off Properties] Deals with all property transport in Runoff  
+
* [https://github.com/Mohid-Water-Modelling-System/Mohid/blob/master/Software/ModuleRunOffProperties.F90 ModuleRunOffProperties] Deals with all property transport in Runoff  
* [http://mohid.codeplex.com/SourceControl/changeset/view/62235#562256 Module Vegetation] Module to simulate plant development
+
* [https://github.com/Mohid-Water-Modelling-System/Mohid/blob/master/Software/MOHIDLand/ModuleVegetation.F90 ModuleVegetation] Module to simulate plant development and agricultural practices
* [http://mohid.codeplex.com/SourceControl/changeset/view/62235#1208078 Module Drainage Network] Module which simulates a 1D Drainage Network System
+
* [https://github.com/Mohid-Water-Modelling-System/Mohid/blob/master/Software/MOHIDBase1/ModuleDrainageNetwork.F90 ModuleDrainageNetwork] Module which simulates a 1D Drainage Network system
* [http://mohid.codeplex.com/SourceControl/changeset/view/62235#583403 Mohid River Network] Program that alows to run river using SWAT-Mohid discharges
+
* [https://github.com/Mohid-Water-Modelling-System/Mohid/blob/master/Software/MOHIDLand/ModuleReservoirs.F90 ModuleReservoirs] Module which simulates Reservoirs interaction with Drainage Network
* [http://mohid.codeplex.com/SourceControl/changeset/view/62235#1208076 Module CEQUALW2] U.S. Army Corps of Engineers zero-dimensional model for primary production that can be run to simulate water quality in the river
+
* [https://github.com/Mohid-Water-Modelling-System/Mohid/blob/master/Software/MOHIDRiver/RiverNetwork.F90 MOHID RiverNetwork] Program that alows to run river using SWAT-Mohid discharges
* [http://mohid.codeplex.com/SourceControl/changeset/view/62235#1208095 Module Triangulation] This is one of the modules for interpolation. This is useful to obtain distributed rain in space based on point time series.
+
* [https://github.com/Mohid-Water-Modelling-System/Mohid/blob/master/Software/MOHIDBase1/ModuleCEQUALW2.F90 ModuleCEQUALW2] U.S. Army Corps of Engineers zero-dimensional model for primary production that can be run to simulate water quality in the river
 +
* [https://github.com/Mohid-Water-Modelling-System/Mohid/blob/master/Software/MOHIDBase1/ModuleTriangulation.F90 ModuleTriangulation] This is one of the modules for interpolation. This is useful to obtain distributed rain in space based on point time series.
 
* etc
 
* etc
 +
 +
==MOHID Land Interfaces==
 +
You can download interfaces to prepare inputs and to analyse model results. Presently available two options:
 +
* a completely free interface from Mohid Website (www.mohid.com).
 +
* MOHID Studio is a new interface can be downloaded from [http://www.actionmodulers.pt/products/mstudio/products-mohidstudio2015.shtml Action Modulers]. A full professional version and a free version (with some limitations) exist. The full version is available for free for academic purposes (research, master, phD, teaching) for one year.
  
 
==How To==
 
==How To==
Line 66: Line 79:
 
[[How_to_create_a_MOHID_Land_Project_Step-by-Step|Create a MOHID Land Project Step-by-Step]]
 
[[How_to_create_a_MOHID_Land_Project_Step-by-Step|Create a MOHID Land Project Step-by-Step]]
  
 +
[[Calibration/Validation in Mohid Land|Rough Guide on Hydrology Calibration in MOHID Land]]
  
 
[[Category:MOHID Land]]
 
[[Category:MOHID Land]]

Latest revision as of 11:53, 12 October 2017

MOHID Land is the newest core executable of the MOHID Water Modelling System. This program is designed to simulate hydrographic basin and aquifers. Main equations are described in a simple way in: equations description.


MOHID Land's main features

MOHID Land is a physically-based, spatially distributed, continuous, variable time step model for the water and property cycles in inland waters and main mediums and equations are presented in next image:

Mohid Land mediums and equations

To follow the description of MOHID Land equations and derivation go to Equations in Mohid Land

Main Processes

The main processes solved are:

  • 3D Porous Media solving Richard's Equations
  • 1D Drainage Network solving Kinematic Wave, DiffusionWave or complete St. Venant equations (dynamic wave)
  • 2D Overland Flow (solving Diffusion Wave)
  • Evapotranspiration using Penman Motheith and water availability in soil
  • Plant growth and agricultural practices (planting, harvest, kill, fertilization, pesticide application, etc.) including dormancy and SWAT crop database
  • Porous Media interaction with Runoff in Infiltration using continuity (Richard's equation with Head gradient)
  • Porous Media and Runoff interaction with Drainage Network using continuity (surface gradient between Runoff and Drainage Network. Richard's equation with level gradient between Porous Media and Drainage Network)
  • Drainage Network and Reservoir interaction to account river flow impact due to manmande hydraulic infraestructures
  • Property transport in all mediums and transformation in soil and river (water quality models can be coupled)
  • Biological and chemical reactions in soil as mineralization, nitrification, denitrification, immobilization, chemical equilibrium, property decay, and processes in river as primary production, nutrient assimilation, property decay, etc.
  • Linkage to MOHID Water by Module Discharges

Dynamical time step adaptation

MOHID Land uses an adaptive time-stepping method in its main hydrodynamic cycle. Within an iterative cycle, if the water volume — of reach or overland flow or porous media — varies more than a user defined percentage during two consecutive time steps, the model automatically decreases the time step. Thereafter the model recalculates the current solution with a smaller time step for the affected process (reach or overland flow or porous media). This process is repeated until the volume variation is less than the user defined value mentioned above. The time step dynamically increases again when the model verifies that flow is “stable”. For example within the module "Drainage Network" the time step may be reduced to very short intervals during flush events. This procedure avoids the occurrence of negative volumes and optimizes the time it takes to make a certain simulation, without compromising model stability. Time steps of the processes — computed in the different sub-models — can be chosen differently, adding more to the optimization of the computational cost.

Interpolated Rain

You can produce spatialy interpolated rain using FillMatrix tool, using as input two or more precipitation stations.

MOHID Land Structure, Description and Source Code

MOHID Land model is programmed in Fortan95 using a OOP (object-oriented programming) philoshophy and code is organized in Modules (or classes) that handle specific processes in specific mediums. Also and interface Module exists to handle the exchange info between classes.

MOHID Land Modules

Some modules developed are related with specific processes which occur inside a watershed and on a specific medium, creating thus a modular structure. For user first approach and advanced use, processes solved, equations, input data files examples are presented below for each MOHID Land module:

  • Module PorousMedia which calculates infiltration, unsaturated and saturated water movement
  • Module PorousMediaProperties which calculates property transport and transformation in soil.
  • Module SedimentQuality which calculates property transformation in soil driven by microorganisms (mineralization, nitrification, denitrification, etc.).
  • Module PREEQC which calculates property transformation in soil through chemical equilibrium.
  • Module Runoff which calculates overland runoff;
  • Module RunoffProperties which calculates property transport in runoff.
  • Module DrainageNetwork which handles water and property routing and property transformation inside rivers.
  • Module Vegetation which handles vegetation growth and agricultural practices.
  • Module Irrigation which calculates and applies water in the soil according to the limits we defined
  • Module Reservoirs which handles weir and reservoir behavior in changing river flow (Drainage Network interaction) and concentrations.
  • Module Basin which handles information between modules and computes interface forcing fluxes between atmosphere and soil (e.g. throughfall, potential evapotranspiration, etc.).

MOHID Land also uses all the modules for data pre-processing, computation and post-processing that are common to MOHID Water (e.g. data file read, geometry handling, results writing in HDF and timeserie, etc.) See below how you can see module source code.

MOHID Land Source Code

You can download the latest source code of the model from GitHub (Mohid Land in GitHub). Just click on the download link, no need to register. For advanced users you can download the entire solution ready to compile.

Other users can just browse around the code of each module to checkout equations. In the links below you can go directly to the latest version and see code in html:

  • MohidLand is the main program of Mohid Land
  • ModuleBasin is the top level of Porous Media, RunOff, Infiltration, River Flow and Vegetation
  • ModulePorousMedia Simulates water flow in variable saturated and unsaturated porous media
  • ModulePorousMediaProperties Deals with all property transport and transformation in Porous Media.
  • ModuleSedimentQuality Zero-dimensional model for primary production, nitrogen and carbon cycle in the Porous Media (Soil and Aquifer)
  • ModulePhreeqC Zero-dimensional model for chemistry equilibrium of solution, pure phases, gas phase, solid phase, exchangers and surfaces in Porous Media (Soil and Aquifer)
  • ModuleRunOff Module which calculates the surface RunOff
  • ModuleRunOffProperties Deals with all property transport in Runoff
  • ModuleVegetation Module to simulate plant development and agricultural practices
  • ModuleDrainageNetwork Module which simulates a 1D Drainage Network system
  • ModuleReservoirs Module which simulates Reservoirs interaction with Drainage Network
  • MOHID RiverNetwork Program that alows to run river using SWAT-Mohid discharges
  • ModuleCEQUALW2 U.S. Army Corps of Engineers zero-dimensional model for primary production that can be run to simulate water quality in the river
  • ModuleTriangulation This is one of the modules for interpolation. This is useful to obtain distributed rain in space based on point time series.
  • etc

MOHID Land Interfaces

You can download interfaces to prepare inputs and to analyse model results. Presently available two options:

  • a completely free interface from Mohid Website (www.mohid.com).
  • MOHID Studio is a new interface can be downloaded from Action Modulers. A full professional version and a free version (with some limitations) exist. The full version is available for free for academic purposes (research, master, phD, teaching) for one year.

How To

Create a MOHID Land Project Step-by-Step

Rough Guide on Hydrology Calibration in MOHID Land