mo_write_ascii Module Reference

Module to write ascii file output. More...

Functions/Subroutines
subroutine, public	write_configfile (dirprecipitation, dirreferenceet, dirtemperature)
	This modules writes the results of the configuration into an ASCII-file.
subroutine, public	write_optifile (best_of, best_paramset, param_names)
	Write briefly final optimization results.
subroutine, public	write_optinamelist (processmatrix, parameters, maskpara, parameters_name)
	Write final, optimized parameter set in a namelist format.

Detailed Description

Module to write ascii file output.

Module to write ascii file output. Writing model output to ASCII should be the exception. Therefore, output is written usually as NetCDF and only:

1. The configuration file of mHM,
2. the final parameter set after optimization, and
3. the simulated vs. observed daily discharge is written in ASCII file format to allow for a quick assurance of proper model runs.

   Changelog

• Modified, Juliane Mai, May 2013
  • module version and documentation
• Modified, Luis Samaniego, Nov 2013
  • improving all formats
• Modified, Luis Samaniego, Mar 2014
  • added inflow gauge information write out
• Modified, Stephan Thober, Jun 2014
  • bug fixed: in writing network properties
• Modified, Rohini Kumar, Jun 2014
  • bug fixed: writing of max and min value of discharge
• Modified, Stephan Thober, Aug 2015
  • moved write_daily_obs_sim_discharge to mRM

    Authors

    Christoph Schneider, Juliane Mai, Luis Samaniego

    Date

    May 2013

    Copyright

    Copyright 2005-2025 , 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

write_configfile()

subroutine, public mo_write_ascii::write_configfile	(	character(256), dimension(:), intent(in)	dirprecipitation,
		character(256), dimension(:), intent(in)	dirreferenceet,
		character(256), dimension(:), intent(in)	dirtemperature )

This modules writes the results of the configuration into an ASCII-file.

TODO: add description

Authors

Christoph Schneider

Date

May 2013

TODO: add description

TODO: add description

Authors

Robert Schweppe

Date

Jun 2018

Parameters

[in]	dirprecipitation	Directory where precipitation files are located
[in]	dirreferenceet	Directory where reference-ET files are located
[in]	dirtemperature	Directory where temperature files are located

Definition at line 90 of file mo_write_ascii.f90.

References mo_common_variables::dirconfigout, mo_mrm_global_variables::dirgauges, mo_common_variables::dirlcover, mo_common_variables::dirmorpho, mo_common_variables::dirout, mo_common_variables::domainmeta, mo_common_mhm_mrm_variables::evalper, mo_common_file::file_config, mo_mrm_global_variables::gauge, mo_common_variables::global_parameters, mo_common_variables::global_parameters_name, mo_common_variables::iflag_cordinate_sys, mo_mrm_global_variables::inflowgauge, mo_mrm_global_variables::l11_fromn, mo_mrm_global_variables::l11_label, mo_mrm_global_variables::l11_length, mo_mrm_global_variables::l11_netperm, mo_mrm_global_variables::l11_noutlets, mo_mrm_global_variables::l11_rorder, mo_mrm_global_variables::l11_slope, mo_mrm_global_variables::l11_ton, mo_mrm_global_variables::l1_l11_id, mo_common_variables::lc_year_end, mo_common_variables::lc_year_start, mo_common_variables::lcfilename, mo_common_mhm_mrm_variables::lcyearid, mo_common_variables::level0, mo_common_variables::level1, mo_mrm_global_variables::level11, mo_common_variables::mhmfilerestartout, mo_mrm_global_variables::ngaugeslocal, mo_mrm_global_variables::ngaugestotal, mo_mrm_global_variables::ninflowgaugestotal, mo_common_variables::nlcoverscene, mo_common_constants::nodata_dp, mo_common_variables::processmatrix, mo_common_mhm_mrm_variables::read_restart, mo_common_variables::resolutionhydrology, mo_common_mhm_mrm_variables::resolutionrouting, mo_common_mhm_mrm_variables::simper, mo_common_mhm_mrm_variables::timestep, mo_common_file::uconfig, mo_file::version, mo_common_mhm_mrm_variables::warmper, and mo_common_variables::write_restart.

Referenced by mo_mhm_interface::mhm_interface_init().

Here is the caller graph for this function:

write_optifile()

subroutine, public mo_write_ascii::write_optifile	(	real(dp), intent(in)	best_of,
		real(dp), dimension(:), intent(in)	best_paramset,
		character(len = *), dimension(:), intent(in)	param_names )

Write briefly final optimization results.

Write overall best objective function and the best optimized parameter set to a file_opti.

Parameters

[in]	real(dp) :: best_OF	best objective function value as returnedby the optimization routine
[in]	real(dp), dimension(:) :: best_paramSet	best associated global parameter setCalled only when optimize is .TRUE.
[in]	character(len = *), dimension(:) :: param_names

Authors

David Schaefer

Date

July 2013

Definition at line 431 of file mo_write_ascii.f90.

References mo_common_variables::dirconfigout, mo_common_mhm_mrm_file::file_opti, and mo_common_mhm_mrm_file::uopti.

Referenced by mo_mhm_interface::mhm_interface_run_optimization().

Here is the caller graph for this function:

write_optinamelist()

subroutine, public mo_write_ascii::write_optinamelist	(	integer(i4), dimension(nprocesses, 3), intent(in)	processmatrix,
		real(dp), dimension(:, :), intent(in)	parameters,
		logical, dimension(size(parameters, 1)), intent(in)	maskpara,
		character(len = *), dimension(size(parameters, 1)), intent(in)	parameters_name )

Write final, optimized parameter set in a namelist format.

Write final, optimized parameter set in a namelist format. Only parameters of processes which were switched on are written to the namelist. All others are discarded.

Parameters

[in]	integer(i4), dimension(nProcesses, 3) :: processMatrix	information about which process case was used
[in]	real(dp), dimension(:, :) :: parameters	(min, max, opti)
[in]	logical, dimension(size(parameters, 1)) :: maskpara	.true. if parameter was calibrated
[in]	character(len = *), dimension(size(parameters, 1)) :: parameters_name	clear names of parameters

Authors

Juliane Mai

Date

Dec 2013

Definition at line 515 of file mo_write_ascii.f90.

References mo_common_variables::dirconfigout, mo_common_mhm_mrm_file::file_opti_nml, mo_common_variables::nprocesses, mo_common_variables::processmatrix, and mo_common_mhm_mrm_file::uopti_nml.

Referenced by mo_mhm_interface::mhm_interface_run_optimization().

Here is the caller graph for this function: