PROGRAM cam_to_dart

DART project logo

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

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

Overview

cam_to_dart is the program that reads a CAM restart file (usually caminput.nc) and creates a single DART output/restart file (e.g. perfect_ics, filter_ics, ... ). If you have multiple input files, you will need to rename the output files as you create them.

The list of variables extracted from the CAM netCDF file and conveyed to DART is controlled by the set of input.nml &model_nml:state_names_* variables. The date and datesec variables in the CAM netcdf file are used to specify the valid time of the state vector. The time may be changed with the restart_file_tool if desired.

Some CAM restart files are from climatological runs and have a valid time that predates the use of the Gregorian calendar. In such instances, the year component of the original date is changed to be a valid Gregorian year (by adding 1601). A warning is issued to the screen and to the logfile. Please use the restart_file_tool to change this time.

Conditions required for successful execution of cam_to_dart:

Since this program is called repeatedly for every ensemble member, we have found it convenient to link the CAM restart files to the default input filename (caminput.nc). The default DART output filename is dart_ics - this may be moved or linked as necessary.

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

&cam_to_dart_nml
   cam_to_dart_input_file  = 'caminput.nc',
   cam_to_dart_output_file = 'dart_ics', 
   /


Item Type Description
cam_to_dart_input_file character(len=128) The name of the DART file containing the CAM state.
cam_to_dart_output_file character(len=128) The name of the DART file containing the model state derived from the CAM restart file.


[top]

MODULES USED

assim_model_mod.f90
types_mod.f90
threed_sphere/location_mod.f90
model_mod.f90
null_mpi_utilities_mod.f90
obs_kind_mod.f90
random_nr_mod.f90
random_seq_mod.f90
time_manager_mod.f90
utilities_mod.f90
[top]

FILES Read

FILES Written

[top]

REFERENCES

none

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