DART project logo

DART Documentation Main Index
version information for this file:
$Id: ncommas_to_dart.html 6382 2013-08-07 20:45:16Z nancy $

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

PROGRAM ncommas_to_dart

ncommas_to_dart is the program that reads a ncommas restart file (usually ncommas_restart.nc) and creates a DART state vector file (e.g. perfect_ics, filter_ics, ... ).

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

Conditions required for successful execution of ncommas_to_dart:

Since this program is called repeatedly for every ensemble member, we have found it convenient to link the ncommas restart files to the default input filename (ncommas_restart.nc). The default DART state vector filename is dart_ics - this may be moved or linked as necessary.

[top]

NAMELIST

This namelist is read from the file input.nml. Namelists start with an ampersand '&' and terminate with a slash '/'. Character strings that contain a '/' must be enclosed in quotes to prevent them from prematurely terminating the namelist.

&model_nml
   ncommas_restart_filename     = 'ncommas_restart.nc';
   assimilation_period_days     = 1,
   assimilation_period_seconds  = 0,
   model_perturbation_amplitude = 0.2,
   output_state_vector          = .true.,
   calendar                     = 'Gregorian',
   debug                        = 0
/

&ncommas_to_dart_nml
   ncommas_to_dart_output_file = 'dart_ics'  
/


ncommas_to_dart_nml and model_nml are always read from a file called input.nml. The full description of the model_nml namelist is documented in the NCOMMAS model_mod.

Item Type Description
ncommas_to_dart_output_file character(len=128) The name of the DART file which contains the updated model state info that should be written into the NCOMMAS file.


ncommas_vars_nml is always read from a file called ncommas_vars.nml.

Item Type Description
ncommas_state_variables character(len=NF90_MAX_NAME) ::
dimension(160)
The list of variable names in the NCOMMAS restart file to use to create the DART state vector and their corresponding DART kind.

&ncommas_vars_nml
   ncommas_state_variables = 'U',   'KIND_U_WIND_COMPONENT',
                             'V',   'KIND_V_WIND_COMPONENT',
                             'W',   'KIND_VERTICAL_VELOCITY',
                             'TH',  'KIND_POTENTIAL_TEMPERATURE',
                             'DBZ', 'KIND_RADAR_REFLECTIVITY',
                             'WZ',  'KIND_VERTICAL_VORTICITY',
                             'PI',  'KIND_EXNER_FUNCTION',
                             'QV',  'KIND_VAPOR_MIXING_RATIO',
                             'QC',  'KIND_CLOUDWATER_MIXING_RATIO',
                             'QR',  'KIND_RAINWATER_MIXING_RATIO',
                             'QI',  'KIND_ICE_MIXING_RATIO',
                             'QS',  'KIND_SNOW_MIXING_RATIO',
                             'QH',  'KIND_GRAUPEL_MIXING_RATIO'
  /

[top]

MODULES USED

assim_model_mod
location_mod
model_mod
null_mpi_utilities_mod
obs_kind_mod
random_nr_mod
random_seq_mod
time_manager_mod
types_mod
utilities_mod
[top]

FILES Read

FILES Written

[top]

REFERENCES

none

[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: DART core group
Revision: $Revision: 6382 $
Source: $URL: https://svn-dares-dart.cgd.ucar.edu/DART/releases/Lanai/models/NCOMMAS/ncommas_to_dart.html $
Change Date: $Date: 2013-08-07 14:45:16 -0600 (Wed, 07 Aug 2013) $
Change history:  try "svn log" or "svn diff"