DART project logo

DART Documentation Main Index
version information for this file:
$Id: gitm_to_dart.html 6667 2013-12-10 23:54:28Z nancy $

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

PROGRAM gitm_to_dart

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.

gitm_to_dart is the program that reads GITM restart files (i.e. b?????.rst) and creates 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 gitm_to_dart:

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 

[top]

NAMELIST

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.

&gitm_to_dart_nml
   gitm_to_dart_output_file = 'dart_ics',
   /

&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',
   ...
Contents Type Description
gitm_to_dart_output_file    character(len=128)   The name of the DART file containing the model state derived from the GITM restart files.

The full description of the model_nml namelist is documented in the gitm model_mod, but the most important variable for gitm_to_dart is repeated here.

Contents Type Description
gitm_restart_dirname   character(len=256)   The name of the directory containing the GITM restart files and runtime control information.
gitm_state_variables  character(len=32),  
dimension(2,80)
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

[top]

MODULES USED

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/gitm_to_dart.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

[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: Tim Hoar
Revision: $Revision: 6667 $
Source: $URL: https://svn-dares-dart.cgd.ucar.edu/DART/releases/Lanai/models/gitm/gitm_to_dart.html $
Change Date: $Date: 2013-12-10 16:54:28 -0700 (Tue, 10 Dec 2013) $
Change history: try "svn log" or "svn diff"