mo_restart Module Reference

reading and writing states, fluxes and configuration for restart of mHM. More...

Functions/Subroutines
subroutine, public	write_restart_files (outfile)
	write restart files for each domain
subroutine, public	read_restart_states (idomain, domainid, infile)
	reads fluxes and state variables from file

Detailed Description

reading and writing states, fluxes and configuration for restart of mHM.

routines are seperated for reading and writing variables for:

• states and fluxes, and
• configuration.

Reading of L11 configuration is also seperated from the rest, since it is only required when routing is activated.

Authors

Stephan Thober

Date

Jul 2013

Copyright

Copyright 2005-2024, the mHM Developers, Luis Samaniego, Sabine Attinger: All rights reserved. mHM is released under the LGPLv3+ license

The UFZ(CHS) mesoscale hydrologic model mHM is free software. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the free Software Foundation either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You received a copy of the GNU Lesser General Public License along with the UFZ CHS mesoscale hydrologic model mHM. It can be found in the files COPYING and COPYING.LESSER provided with this software. The complete GNU license text can also be found at http://www.gnu.org/licenses/.

Function/Subroutine Documentation

read_restart_states()

subroutine, public mo_restart::read_restart_states	(	integer(i4), intent(in)	idomain,
		integer(i4), intent(in)	domainid,
		character(256), intent(in)	infile
	)

reads fluxes and state variables from file

read fluxes and state variables from given restart directory and initialises all state variables that are initialized in the subroutine initialise, contained in module mo_startup.

Changelog

• Stephan Thober Aug 2015
  • moved read of routing states to mRM
• David Schaefer Nov 2015
  • mo_netcdf
• Stephan Thober Nov 2016
  • moved processMatrix to common variables
• Robert Schweppe Jun 2018
  • refactoring and reformatting
• Sebastian Müller Mar 2023
  • compatibility layer for 2D/3D data
  • move reading of nLAI to mo_startup (needed beforehand)

Authors

Stephan Thober

Date

Apr 2013

Parameters

[in]	idomain	number of domain
[in]	domainid	ID of domain
[in]	infile	Input Path including trailing slash

Definition at line 292 of file mo_restart.f90.

References mo_mpr_global_variables::l1_aeroresist, mo_global_variables::l1_aetcanopy, mo_global_variables::l1_aetsealed, mo_global_variables::l1_aetsoil, mo_mpr_global_variables::l1_alpha, mo_global_variables::l1_baseflow, mo_mpr_global_variables::l1_bulkdens, mo_mpr_global_variables::l1_cosmicl3, mo_mpr_global_variables::l1_degday, mo_mpr_global_variables::l1_degdayinc, mo_mpr_global_variables::l1_degdaymax, mo_mpr_global_variables::l1_degdaynopre, mo_mpr_global_variables::l1_fasp, mo_global_variables::l1_fastrunoff, mo_mpr_global_variables::l1_froots, mo_mpr_global_variables::l1_fsealed, mo_mpr_global_variables::l1_harsamcoeff, mo_global_variables::l1_infilsoil, mo_global_variables::l1_inter, mo_mpr_global_variables::l1_jarvis_thresh_c1, mo_mpr_global_variables::l1_karstloss, mo_mpr_global_variables::l1_kbaseflow, mo_mpr_global_variables::l1_kfastflow, mo_mpr_global_variables::l1_kperco, mo_mpr_global_variables::l1_kslowflow, mo_mpr_global_variables::l1_latticewater, mo_mpr_global_variables::l1_maxinter, mo_global_variables::l1_melt, mo_mpr_global_variables::l1_no_count, mo_global_variables::l1_percol, mo_mpr_global_variables::l1_petlaicorfactor, mo_global_variables::l1_preeffect, mo_mpr_global_variables::l1_prietayalpha, mo_global_variables::l1_rain, mo_global_variables::l1_runoffseal, mo_global_variables::l1_satstw, mo_mpr_global_variables::l1_sealedthresh, mo_global_variables::l1_sealstw, mo_global_variables::l1_slowrunoff, mo_global_variables::l1_snow, mo_global_variables::l1_snowpack, mo_global_variables::l1_soilmoist, mo_mpr_global_variables::l1_soilmoistexp, mo_mpr_global_variables::l1_soilmoistfc, mo_mpr_global_variables::l1_soilmoistsat, mo_mpr_global_variables::l1_surfresist, mo_mpr_global_variables::l1_tempthresh, mo_global_variables::l1_throughfall, mo_global_variables::l1_total_runoff, mo_global_variables::l1_unsatstw, mo_mpr_global_variables::l1_unsatthresh, mo_mpr_global_variables::l1_wiltingpoint, mo_common_variables::lc_year_end, mo_common_variables::lc_year_start, mo_common_variables::level1, mo_mpr_global_variables::nlai, mo_common_variables::nlcoverscene, mo_mpr_global_variables::nsoilhorizons_mhm, and mo_common_variables::processmatrix.

Referenced by mo_mhm_interface_run::mhm_interface_run_prepare().

Here is the caller graph for this function:

write_restart_files()

subroutine, public mo_restart::write_restart_files

(

character(256), dimension(:), intent(in)

outfile

)

write restart files for each domain

write restart files for each domain. For each domain three restart files are written. These are xxx_states.nc, xxx_L11_config.nc, and xxx_config.nc (xxx being the three digit domain index). If a variable is added here, it should also be added in the read restart routines below.

Changelog

• Stephan Thober Aug 2015
  • moved write of routing states to mRM
• David Schaefer Nov 2015
  • mo_netcdf
• Stephan Thober Nov 2016
  • moved processMatrix to common variables
• Zink M. Demirel C. Mar 2017
  • Added Jarvis soil water stress function at SM process(3)
• Robert Schweppe Feb 2018
  • Removed all L0 references
• Robert Schweppe Jun 2018
  • refactoring and reformatting
• Stephan Thober Dec 2022
  • added grid info for level0

Authors

Stephan Thober

Date

Jun 2014

Definition at line 53 of file mo_restart.f90.

References mo_common_variables::domainmeta, mo_mpr_global_variables::horizondepth_mhm, mo_global_variables::l1_aetcanopy, mo_global_variables::l1_aetsealed, mo_global_variables::l1_aetsoil, mo_global_variables::l1_baseflow, mo_global_variables::l1_fastrunoff, mo_global_variables::l1_infilsoil, mo_global_variables::l1_inter, mo_global_variables::l1_melt, mo_global_variables::l1_percol, mo_global_variables::l1_preeffect, mo_global_variables::l1_rain, mo_global_variables::l1_runoffseal, mo_global_variables::l1_satstw, mo_global_variables::l1_sealstw, mo_global_variables::l1_slowrunoff, mo_global_variables::l1_snow, mo_global_variables::l1_snowpack, mo_global_variables::l1_soilmoist, mo_global_variables::l1_throughfall, mo_global_variables::l1_total_runoff, mo_global_variables::l1_unsatstw, mo_mpr_global_variables::laiboundaries, mo_common_constants::laivarname, mo_common_constants::landcoverperiodsvarname, mo_common_variables::lc_year_end, mo_common_variables::lc_year_start, mo_common_variables::level0, mo_common_variables::level1, mo_mpr_global_variables::nlai, mo_common_variables::nlcoverscene, mo_common_constants::nodata_dp, mo_mpr_global_variables::nsoilhorizons_mhm, mo_common_constants::soilhorizonsvarname, mo_mpr_restart::write_eff_params(), and mo_common_restart::write_grid_info().

Referenced by mo_mhm_interface::mhm_interface_finalize().

Here is the call graph for this function:

Here is the caller graph for this function: