Attention!
MITgcm_ocean
works with versions of DART before Manhattan (9.x.x) and has yet to be updated. If you are interested in
using MITgcm_ocean
with more recent versions of DART, contact DAReS staff to assess the feasibility of an update.
Until that time, you should consider this documentation as out-of-date.
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.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 namedS.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
, anddata.DART
mv some_DART_ics_input_file assim_model_state_ic
./trans_sv_pv
cp data.cal.DART data.cal
cp data.DART 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 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. |
- 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]
- none