PROGRAM perfect_model_obs

DART project logo

Jump to DART Documentation Main Index
version information for this file:
$Id: perfect_model_obs.html 6380 2013-08-05 23:47:11Z nancy $

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

Overview

Main program for creating synthetic observation sequences given a model for use in filter assimilations. Reads in an observation sequence file which has only observation definitions and generates synthetic observation values for an output observation sequence file. The execution of perfect_model_obs is controlled by the input observation sequence file and the model time-stepping capabilities in a manner analogous to that used by the filter program.

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

&perfect_model_obs_nml
   start_from_restart       = .false.,
   output_restart           = .false.,
   async                    = 0,
   tasks_per_model_advance  = 1,
   init_time_days           = 0,
   init_time_seconds        = 0,
   first_obs_days           = -1,
   first_obs_seconds        = -1,
   last_obs_days            = -1,
   last_obs_seconds         = -1,
   obs_window_days          = -1,
   obs_window_seconds       = -1,
   output_timestamps        = .false.,
   trace_execution          = .false.,
   output_forward_op_errors = .false.,
   print_every_nth_obs      = -1,
   silence                  = .false.,
   output_interval          = 1,
   restart_in_file_name     = "perfect_ics",
   restart_out_file_name    = "perfect_restart",
   obs_seq_in_file_name     = "obs_seq.in",
   obs_seq_out_file_name    = "obs_seq.out",
   adv_ens_command          = "./advance_model.csh"  
/


Item Type Description
start_from_restart logical .true. means read starting state data from a restart file, .false. means call model_mod routine to set initial condition data.
output_restart logical .true. means output a restart file.
async integer Controls method for advancing model:
  • 0 = subroutine call
  • 2 = shell command, single task model
  • 4 = shell command, parallel model
init_time_days integer If negative, don't use. If non-negative, override the initial data time read from restart file.
init_time_seconds integer If negative don't use. If non-negative, override the initial data time read from restart file.
first_obs_days integer If negative, don't use. If non-negative, ignore any observations before this time.
first_obs_seconds integer If negative, don't use. If non-negative, ignore any observations before this time.
last_obs_days integer If negative, don't use. If non-negative, ignore any observations after this time.
last_obs_seconds integer If negative, don't use. If non-negative, ignore any observations after this time.
output_interval integer Output state and observation diagnostics every nth assimilation time, n is output_interval.
restart_in_file_name character(len=129) File containing state restart vector.
restart_out_file_name character(len=129) File to which to write state restart state vector.
obs_seq_in_file_name character(len=129) File name from which to read an observation sequence.
obs_seq_out_file_name character(len=129) File name to which to write output observation sequence.
adv_ens_command character(len=129) Command sent to shell if async == 2 or 4.
output_forward_op_errors logical True means output errors from forward observation operators. This is the 'istatus' error return code from the model interpolate routine. An ascii text file 'forward_op_errors' will be created in the current directory. Each line will contain an observation key number, and the istatus return code.
output_timestamps logical True means output timestamps before and after the model advance and the forward observation computation phases.
trace_execution logical True means output very detailed messages about what routines are being called in the main loop. Useful if a job hangs or otherwise doesn't execute as expected.
silence logical True means output almost no runtime messages. Not recommended for general use, but can speed test programs if the execution time becomes dominated by the volume of output.
tasks_per_model_advance integer Reserved for future use.
obs_window_days integer If negative, don't use. If non-negative, reserved for future use.
obs_window_seconds integer If negative, don't use. If non-negative, reserved for future use.


[top]

MODULES USED

types_mod
utilities_mod
time_manager_mod
obs_sequence_mod
obs_def_mod
obs_model_mod
assim_model_mod
mpi_utilities_mod
random_seq_mod
ensemble_manager_mod
[top]

FILES

[top]

REFERENCES

[top]

ERROR CODES and CONDITIONS

RoutineMessageComment
perfect_main Only use one mpi process here: ### were requested Don't use mpi for this.

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: 6380 $
Source: $URL: https://svn-dares-dart.cgd.ucar.edu/DART/releases/Lanai/perfect_model_obs/perfect_model_obs.html $
Change Date: $Date: 2013-08-05 17:47:11 -0600 (Mon, 05 Aug 2013) $
Change history:  try "svn log" or "svn diff"