PROGRAM trans_sv_pv

trans_sv_pv is responsible for converting a DART ‘initial conditions’ file to a set of model ‘snapshot’ files and appropriate namelist files: data.cal and data. This is easier than the reverse process because the DART initial conditions file have a header that contains the valid time for the accompanying state. This same header also has the ‘advance-to’ time. trans_sv_pv uses this information to write out appropriate &CAL_NML and &PARM03 namelists in data.cal.DART and data.DART, respectively. The rest of the information in data is preserved, so it is possible to simply replace data with the new data.DART.
The input filename is hardwired to that expected by filter and the output filenames are able to be renamed into those defined by the data&PARM05 namelist specifying the filenames to use to cold-start the ocean model. The output filename is comprised of 4 parts: the variable name, the startDate_1 component (YYYYMMDD), the startDate_2 component (HHMMSS), and the extension (.data for the data and .meta for the metadata). The startDate_1 and startDate_2 pieces are identical in format to that used by identically named variables in the data.cal&CAL_NML namelist.

Usage

There must be several input files in the current working directory; most of these are required by the model_mod interface. The input filename is hardwired to assim_model_state_ic. Assuming the time tag in the input file is set to 06Z 23 July 1996, this example creates output files named
S.19960723.060000.[data,meta]
T.19960723.060000.[data,meta]
U.19960723.060000.[data,meta]
V.19960723.060000.[data,meta]
Eta.19960723.060000.[data,meta]
data.cal.DART, and
data.DART

mv some_DART_ics_input_file assim_model_state_ic ./trans_sv_pv cp data.cal.DART data.cal cp data.DART data


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 be read, even if the values are not used. To avoid duplication and, possibly, some inconsistency in the documentation; only a list of the required namelists is provided - 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

CAL_NML

must be read, values are not used. The data.cal.DART file has an updated namelist to be used for the model advance.

PARM03

must be read, values are not used, The data.DART is an ‘identical’ version of data with the exception of the PARM03 namelist. The parameters endTime, dumpFreq, and taveFreq reflect the amount of time needed to advance the model. The parameter startTime is set to 0.0, which is required to force the model to read the startup files specified by PARM05

PARM04

ocean model grid parameters, read - never changed.

Files

  • input namelist files: data, data.cal, input.nml

  • output namelist files: data.cal.DART, data.DART

  • input data file: assim_model_state_ic

  • output data files: [S,T,U,V,Eta].YYYYMMDD.HHMMSS.[data,meta]

References

  • none