PROGRAM dart_to_pop

DART project logo

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

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

Overview

dart_to_pop is the program that updates a POP netCDF-format restart file (usually pop.r.nc) with the state information contained in a DART output/restart file (e.g. perfect_ics, filter_ics, ... ). Only the CURRENT values in the POP restart file will be updated: specifically - SALT_CUR, TEMP_CUR, UVEL_CUR, VVEL_CUR, and PSURF_CUR. It is necessary to perform a forward euler timestep since the '_OLD' variables are untouched by DART. The DART model time is compared to the time in the POP restart file. If they are not identical, the program issues an error message and aborts.

From the user perspective, most of the time dart_to_pop will be used on DART files that have a header containing one time stamp followed by the model state.

The dart_to_pop_nml namelist allows dart_to_pop to read the assim_model_state_ic files that have two timestamps in the header. These files are temporarily generated when DART is used to advance the model. One timestamp is the 'advance_to' time, the other is the 'valid_time' of the model state. In this case, a namelist for POP (called pop_in.DART) is written that contains the &time_manager_nml settings appropriate to advance POP to the time requested by DART. The repository version of the advance_model.csh script has a section to ensure the proper DART namelist settings for this case.

Conditions required for successful execution of dart_to_pop:

Since this program is called repeatedly for every ensemble member, we have found it convenient to link the DART input file to the default input filename (dart_restart). The same thing goes true for the POP output filename pop.r.nc.

[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.

&dart_to_pop_nml
   dart_to_pop_input_file = 'dart_restart',
   advance_time_present   = .false.  
/


Item Type Description
dart_to_pop_input_file character(len=128) The name of the DART file containing the model state to insert into the POP restart file.
advance_time_present logical If you are converting a DART initial conditions or restart file this should be .false.; these files have a single timestamp describing the valid time of the model state. If .true., TWO timestamps are expected to be the DART file header. In this case, a namelist for POP (called pop_in.DART) is created that contains the &time_manager_nml settings appropriate to advance POP to the time requested by DART.


[top]

MODULES USED

assim_model_mod
dart_pop_mod
location_mod
model_mod
null_mpi_utilities_mod
obs_kind_mod
random_nr_mod
random_seq_mod
time_manager_mod
types_mod
utilities_mod
[top]

FILES Read

FILES Written

[top]

REFERENCES


[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/classic/models/POP/dart_to_pop.html $
Change Date: $Date: 2013-08-07 14:45:16 -0600 (Wed, 07 Aug 2013) $
Change history:  try "svn log" or "svn diff"