DART Documentation Main Index
The Global Ionosphere Thermosphere Model (GITM) is a 3-dimensional spherical
code that models the Earth's thermosphere and ionosphere system using a
stretched grid in latitude and altitude. For a fuller description of using
GITM within DART, please see the
DART GITM model documentation.
dart_to_gitm is the program that updates the GITM restart files (i.e. b?????.rst) with the information from a DART output/restart file (e.g. perfect_ics, filter_ics, ... ).
The list of variables used to create the DART state vector are specified in the input.nml file.
Conditions required for successful execution of dart_to_gitm:
The individual model instances are run in unique directories. This is also where the converter routines gitm_to_dart and dart_to_gitm are run. This makes it easy to use a single 'static' name for the input and output filenames. advance_model.csh is responsibile for linking the appropriate files to these static filenames.
The simplest way to test the converter is to compile GITM and run a single model state forward using work/clean.sh. To build GITM ... download GITM and unpack the code into DART/models/gitm/GITM2 and follow these instructions:
cd models/gitm/GITM2 ./Config.pl -install -compiler=ifortmpif90 -earth make cd ../work ./clean.sh 1 1 0 150.0 170.0 1.0
And then manually run dart_to_gitm on the result.
We adhere to the F90 standard of starting a namelist with an ampersand '&' and terminating with a slash '/' for all our namelist input. Character strings that contain a '/' must be enclosed in quotes to prevent them from prematurely terminating the namelist.
&dart_to_gitm_nml dart_to_gitm_output_file = 'dart_restart', advance_time_present = .false. / &model_nml gitm_restart_dirname = 'advance_temp_e1/UA/restartOUT', assimilation_period_days = 0, assimilation_period_seconds = 1800, model_perturbation_amplitude = 0.2, output_state_vector = .false., calendar = 'Gregorian', debug = 0, gitm_state_variables = 'Temperature', 'KIND_TEMPERATURE', 'eTemperature', 'KIND_TEMPERATURE_ELECTRON', 'ITemperature', 'KIND_TEMPERATURE_ION', 'iO_3P_NDensityS', 'KIND_DENSITY_NEUTRAL_O3P', ...
|dart_to_gitm_output_file||character(len=128)||The name of the DART file containing the model state derived from the GITM restart files.|
|advance_time_present||logical||If you are manually 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 in the DART file header and DART_GITM_time_control.txt) is created with the settings appropriate to advance GITM to the time requested by DART.|
The full description of the model_nml namelist is documented in the gitm model_mod, but the most important variable for dart_to_gitm is repeated here.
|gitm_restart_dirname||character(len=256)||The name of the directory containing the GITM restart files and runtime control information.|
|The list of variable names in the gitm restart file to use to create the DART state vector and their corresponding DART kind. The default list is specified in model_mod.nml|
obs_def/obs_def_upper_atm_mod.f90 assim_model/assim_model_mod.f90 common/types_mod.f90 location/threed_sphere/location_mod.f90 models/gitm/GITM2/src/ModConstants.f90 models/gitm/GITM2/src/ModEarth.f90 models/gitm/GITM2/src/ModKind.f90 models/gitm/GITM2/src/ModSize.f90 models/gitm/GITM2/src/ModTime.f90 models/gitm/GITM2/src/time_routines.f90 models/gitm/dart_gitm_mod.f90 models/gitm/dart_to_gitm.f90 models/gitm/model_mod.f90 mpi_utilities/null_mpi_utilities_mod.f90 obs_kind/obs_kind_mod.f90 random_seq/random_seq_mod.f90 time_manager/time_manager_mod.f90 utilities/utilities_mod.f90
none - all error messages come from modules that have their own documentation.
DART software - Copyright 2004 - 2013 UCAR.
This open source software is provided by UCAR, "as is",
|Revision:||$Revision: 6654 $|
|Source:||$URL: https://svn-dares-dart.cgd.ucar.edu/DART/releases/classic/models/gitm/dart_to_gitm.html $|
|Change Date:||$Date: 2013-12-06 14:45:26 -0700 (Fri, 06 Dec 2013) $|
|Change history:||try "svn log" or "svn diff"|