PROGRAM noah_to_dart

DART project logo

DART Documentation Main Index
version information for this file:
$Id: noah_to_dart.html 11403 2017-03-27 23:26:22Z hendric@ucar.edu $

NAMELIST / MODULES / FILES / REFERENCES / ERRORS / PLANS / TERMS OF USE

noah_to_dart is the program that reads a NOAH restart file (usually linked to restart.nc) and creates a DART output/restart file (e.g. perfect_ics, filter_ics, ... ).

The list of variables used to create the DART state vector are specified in the input.nml file.

Conditions required for successful execution of noah_to_dart:

The individual model instances are run in unique directories. This is also where the converter routines noah_to_dart and dart_to_noah are run. This makes it easy to use a single 'static' name for the input and output filenames so we do not have to dynamically modify input.nml or namelist.hrldas. advance_model.csh is responsibile for linking the appropriate files to these static filenames.

[top]

NAMELIST

We adhere to the F90 standard of starting a namelist with an ampersand '&' and terminating with a slash '/' for all our namelist input. Character strings that contain a '/' must be enclosed in quotes to prevent them from prematurely terminating the namelist.

&noah_to_dart_nml
   noah_to_dart_output_file = 'dart_ics',
   /

&model_nml
     noah_netcdf_filename         = 'restart.nc',
     noah_state_variables         = 'SOIL_T',   'QTY_SOIL_TEMPERATURE',
                                    'SOIL_M',   'QTY_SOIL_MOISTURE',
                                    'SOIL_W',   'QTY_SOIL_LIQUID_WATER',
                                    'SKINTEMP', 'QTY_SKIN_TEMPERATURE',
                                    'SNODEP',   'QTY_SNOW_THICKNESS',
                                    'WEASD',    'QTY_SNOW_WATER',
                                    'CANWAT',   'QTY_CANOPY_WATER',
                                    'QFX',      'QTY_LATENT_HEAT_FLUX',
  /
Contents Type Description
noah_to_dart_output_file character(len=128) The name of the DART file containing the model state derived from the NOAH restart file. [default: 'dart_ics']

The full description of the model_nml namelist is documented in the noah model_mod, but the most important variables for noah_to_dart are repeated here.

Contents Type Description
noah_netcdf_filename character(len=128) The name of the NOAH RESTART file to use to create the DART state vector. For convenience, the advance_model.csh script usually links the most recent restart file to a static name. [default: 'restart.nc']
noah_state_variables character(len=32)::
dimension(2,40)
The list of variable names in the NOAH restart file to use to create the DART state vector and their corresponding DART kind. [default: see example below]

Example


&noah_to_dart_nml
   noah_to_dart_output_file = 'dart_ics'
  /

&model_nml
     noah_netcdf_file     = 'restart.nc',
     noah_state_variables = 'SOIL_T',   'QTY_SOIL_TEMPERATURE',
                            'SOIL_M',   'QTY_SOIL_MOISTURE',
                            'SOIL_W',   'QTY_SOIL_LIQUID_WATER',
                            'SKINTEMP', 'QTY_SKIN_TEMPERATURE',
                            'SNODEP',   'QTY_SNOW_THICKNESS',
                            'WEASD',    'QTY_SNOW_WATER',
                            'CANWAT',   'QTY_CANOPY_WATER',
                            'QFX',      'QTY_LATENT_HEAT_FLUX',
                            'HFX',      'QTY_SENSIBLE_HEAT_FLUX',
                            'GRDFLX',   'QTY_GROUND_HEAT_FLUX'
  /

[top]

MODULES USED

assim_model_mod
location_mod
model_mod
null_mpi_utilities_mod
obs_kind_mod
random_seq_mod
time_manager_mod
types_mod
utilities_mod

[top]

FILES Read

FILES Written

[top]

REFERENCES

[top]

ERROR CODES and CONDITIONS

none - all error messages come from modules that have their own documentation.

KNOWN BUGS

none

[top]

FUTURE PLANS

None.

[top]

Terms of Use

DART software - Copyright UCAR. This open source software is provided by UCAR, "as is", without charge, subject to all terms of use at http://www.image.ucar.edu/DAReS/DART/DART_download

Contact: Tim Hoar
Revision: $Revision: 11403 $
Source: $URL: https://svn-dares-dart.cgd.ucar.edu/DART/releases/Manhattan/models/noah/noah_to_dart.html $
Change Date: $Date: 2017-03-27 17:26:22 -0600 (Mon, 27 Mar 2017) $
Change history: try "svn log" or "svn diff"