PROGRAM full_error and others

DART project logo

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

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

Overview

A collection of standalone programs for simulating various properties of ensembles. The program of most interest here is full_error.f90 which generates the auxiliary information needed when using sampling error correction in the filter.

To enable the sampling error correction algorithm in the filter, set the namelist item &assim_tools_nml :: sampling_error_correction to true, and copy the corresponding ensemble size file into the run directory. A set of precomputed files for various ensemble sizes can be found in the system_simulation/full_error_precomputed_tables directory. To generate a file for a different ensemble size, build the executables in the work directory, set the ens_size namelist item in the input.nml namelist file, and run full_error. It generates a large number of samples and may take between 10-40 minutes to run, depending on the ensemble size and the speed of your processor.

Talk to Jeff Anderson about the other programs in this directory.

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

&full_error_nml
  ens_size = 80, 
  output_filename = 'final_full',
/ 


Item Type Description
ens_size integer Number of ensemble members to compute sampling error for. This computation is independent of any of the model details; it only depends on the count of ensemble members.
output_filename character(len=128) Basename for the output file written by this program. The program will append .N to the name, where N is the ensemble size, creating filenames of the form "base.8", "base.32", etc. The base name should be "final_full" to match the code in the filter program which reads this file.

[top]

MODULES USED

types_mod
utilities_mod
random_seq_mod
[top]

FILES

The full_error program creates files which should be called final_full.N to match the filenames expected by the filter program.

[top]

REFERENCES


[top]

ERROR CODES and CONDITIONS

RoutineMessageComment
full_error cannot handle task counts > 99999 Ensemble size must be less than 100,000.
full_error empty bin The sample size must be large enough for all bins to have counts

KNOWN BUGS

none

[top]

FUTURE PLANS

none at this time.

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