$Id$
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.
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
types_mod utilities_mod model_mod assim_model_mod time_manager_mod
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.
Namelist | Primary 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 |
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().
Routine | Message | Comment |
---|---|---|
trans_sv_pv | unable to read timestep from stdin. | look at the example in the 'Usage' section. |
There are no known bugs.
None at this time. Feel free to suggest improvements.
N/A
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$ |
Source: | $URL$ |
Change Date: | $Date$ |
Change history: | try "svn log" or "svn diff" |