PROGRAM model_to_dart for MPAS OCN

DART project logo

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

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

Overview

model_to_dart is the program that reads an MPAS OCN analysis file (nominally named mpas_restart.nc) and creates a DART state vector file (e.g. perfect_ics, filter_ics, ... ). The MPAS analysis files have a Time UNLIMITED Dimension, which indicates there may (at some point) be more than one timestep in the file. The DART routines are currently designed to use the LAST timestep. If the Time dimension of length 3, we use the third timestep. A warning message is issued and indicates exactly the time being used.

input.nml&mpas_vars_nml defines the list of MPAS variables used to build the DART state vector. This namelist is more fully described in the MPAS model_mod.html documentation. For example:

&mpas_vars_nml
   mpas_state_variables = 'temperature',  'KIND_TEMPERATURE',
                          'salinity',     'KIND_SALINITY',
                          'rho',          'KIND_DENSITY',
                          'u',            'KIND_EDGE_NORMAL_SPEED',
                          'h',            'KIND_SEA_SURFACE_HEIGHT'
                          'tracer1',      'KIND_TRACER_CONCENTRATION'
   /

Conditions required for successful execution of model_to_dart are:

Since this program is called repeatedly for every ensemble member, we have found it convenient to link the MPAS OCN analysis files to a static input filename (e.g. mpas_analysis.nc). The default DART 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_to_dart_nml
   model_to_dart_output_file = 'dart_ics'
   /

&model_nml
   model_analysis_filename  = 'mpas_analysis.nc'
   /

(partial namelist)

&mpas_vars_nml
   mpas_state_variables = '',
   mpas_state_bounds = '',
   /


The model_to_dart namelist includes:

Item Type Description
model_to_dart_output_file character(len=128) The name of the DART file containing the model state derived from the MPAS analysis file.

Two more namelists need to be mentioned. The model_nml namelist specifies the MPAS analysis file to be used as the source. The mpas_vars_nml namelist specifies the MPAS variables that will comprise the DART state vector.

For example:

&mpas_vars_nml
   mpas_state_variables = 'temperature',  'KIND_TEMPERATURE',
                          'salinity',     'KIND_SALINITY',
                          'rho',          'KIND_DENSITY',
                          'u',            'KIND_EDGE_NORMAL_SPEED',
                          'h',            'KIND_SEA_SURFACE_HEIGHT'
                          'tracer1',      'KIND_TRACER_CONCENTRATION'
   /

[top]

MODULES USED

assim_model_mod.f90
types_mod.f90
location_mod.f90
model_to_dart.f90
model_mod.f90
null_mpi_utilities_mod.f90
obs_kind_mod.f90
random_nr_mod.f90
random_seq_mod.f90
time_manager_mod.f90
utilities_mod.f90
[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/mpas_ocn/model_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"