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

PROGRAM trans_pv_sv

$Id: trans_pv_sv.html 6340 2013-07-31 14:15:20Z nancy $

trans_pv_sv is responsible for converting the ocean model 'snapshot' files to a DART 'initial conditions' file. In order to do that, the valid time for the snapshot files must be calculated from several pieces of information: the filename contains a timestep index, the data&PARM03 namelist contains information about the amount of time per timestep, and the data.cal&CAL_NML namelist contains the start time. Additionally, the grid characteristics must be read from data&PARM04. Consequently, the files data, and data.cal as well as the general input.nml are needed in addition to the snapshot files.

This program has a number of options that are driven from namelists and one piece of input read from STDIN: the integer representing the timestep index of the snapshot file set.

Usage

The output filename is hardwired to that expected by filter. This example creates an output file named assim_model_state_ud from the following files in the local directory:

S.0000000096.data
T.0000000096.data
U.0000000096.data
V.0000000096.data
Eta.0000000096.data

./trans_pv_sv < 96


MODULES USED

types_mod
utilities_mod
model_mod
assim_model_mod
time_manager_mod

NAMELIST

This program has no namelist of its own, but some of the underlying modules require namelists. To avoid duplication and, possibly, some inconsistency in the documentation, only a list of the required namelists is provided here, with a hyperlink to the full documentation for each namelist.

NamelistPrimary Purpose
utilities_nml set the termination level and file name for the run-time log
assim_model_mod_nml write DART restart files in binary or ASCII
model_nml write netCDF files with prognostic variables
CAL_NML determine start time of the ocean model
PARM03 the amount of time per model timestep for deciphering snapshot filenames
PARM04 ocean model grid parameters

FILES


REFERENCES


ERROR CODES and CONDITIONS

The most common problem is trying to read the Fortran direct-access big-endian snapshot files on a little-endian architecture. This can manifest itself in very misleading ways. Make sure you have the right compiler settings to be able to read these files. There is no one error message that indicates the read was unsuccessful.

The read takes place in model_mod:read_snapshot().

RoutineMessageComment
trans_sv_pv unable to read timestep from stdin. look at the example in the 'Usage' section.

KNOWN BUGS

There are no known bugs.


FUTURE PLANS

None at this time. Feel free to suggest improvements.


PRIVATE COMPONENTS

N/A


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: 6340 $
Source: $URL: https://svn-dares-dart.cgd.ucar.edu/DART/releases/classic/models/MITgcm_ocean/trans_pv_sv.html $
Change Date: $Date: 2013-07-31 08:15:20 -0600 (Wed, 31 Jul 2013) $
Change history:  try "svn log" or "svn diff"