DART project logo

DART Documentation Main Index
version information for this file:
$Id: noah_to_dart.html 7959 2015-05-06 22:18:27Z thoar $

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

PROGRAM noah_to_dart

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',   'KIND_SOIL_TEMPERATURE',
                                    'SOIL_M',   'KIND_SOIL_MOISTURE',
                                    'SOIL_W',   'KIND_SOIL_LIQUID_WATER',
                                    'SKINTEMP', 'KIND_SKIN_TEMPERATURE',
                                    'SNODEP',   'KIND_SNOW_THICKNESS',
                                    'WEASD',    'KIND_SNOW_WATER',
                                    'CANWAT',   'KIND_CANOPY_WATER',
                                    'QFX',      'KIND_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',   'KIND_SOIL_TEMPERATURE',
                            'SOIL_M',   'KIND_SOIL_MOISTURE',
                            'SOIL_W',   'KIND_SOIL_LIQUID_WATER',
                            'SKINTEMP', 'KIND_SKIN_TEMPERATURE',
                            'SNODEP',   'KIND_SNOW_THICKNESS',
                            'WEASD',    'KIND_SNOW_WATER',
                            'CANWAT',   'KIND_CANOPY_WATER',
                            'QFX',      'KIND_LATENT_HEAT_FLUX',
                            'HFX',      'KIND_SENSIBLE_HEAT_FLUX',
                            'GRDFLX',   'KIND_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 2004 - 2013 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: 7959 $
Source: $URL: https://svn-dares-dart.cgd.ucar.edu/DART/releases/classic/models/noah/noah_to_dart.html $
Change Date: $Date: 2015-05-06 16:18:27 -0600 (Wed, 06 May 2015) $
Change history: try "svn log" or "svn diff"