PUBLIC COMPONENTS / NAMELIST / FILES / REFERENCES / ERRORS / BUGS / PLANS / PRIVATE COMPONENTS

PROGRAM perfect_model_obs

Contact: Jeff Anderson
Reviewers:  
Revision: $Revision: 1.5 $
Release Name: $Name: iceland $
Change Date: $Date: 2005/02/22 16:34:07 $
Change history: see CVS log

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.

Optional namelist interface &assim_model_nml may be read from file input.nml.




OTHER MODULES USED

types_mod
utilities_mod
time_manager_mod
obs_sequence_mod
obs_def_mod
obs_model_mod
assim_model_mod
random_seq_mod
ensemble_manager_mod



NAMELIST

We adhere to the F90 standard of starting a namelist with an ampersand '&' and terminating with a slash '/'.

namelist / perfect_model_obs_nml /  &
      async, adv_ens_command, obs_seq_in_file_name, &
      obs_seq_out_file_name, start_from_restart, output_restart, &
      restart_in_file_name, restart_out_file_name, init_time_days, init_time_seconds, &
      output_interval

Discussion

This namelist is read in a file called input.nml

Contents Type Description
async integer Controls whether models are advanced via a subroutine call or by writing initial condition files for ensemble members to disk and having shellscripts advance the model.
0 = advance by subroutine. Default.
1 = shell advance using shell script piped to filter
2 = advance by F90 calls to shell to advance model, command to be executed is found in adv_ens_command
3 = advance by using an already running server process from filter_server.csh.
adv_ens_command character(len=129) Character string containing command to be executed in order to advance the model. Default is './advance_ens.csh'.
obs_sequence_in_file_name character(len=129) File name that contains an observation sequence definition file for input. Default is 'obs_seq.in'.
obs_sequence_out_file_name character(len=129) File name for output observation sequence file. Default is 'obs_seq.out'.
start_from_restart logical Should initial ensemble states come from (a) restart file(s). Default is .false.
output_restart logical Should (a) restart file(s) be written out for all ensemble members? Default is .false.
restart_in_file_name character(len=129) File name (root) for a file(s) containing restart state for all ensemble members. Multiple files have extensions ".####", where #### is a 4 digit number representing the ensemble member. Default is 'filter_ics'.
restart_out_file_name character(len = 129) File name (root) for output restart file(s). See restart_in_file_name for multiple file information. Default is 'filter_restart'.
init_time_days integer Initial time of model (time is in days and seconds; see time_manager). If init_time_days and init_time_seconds are less than 0, the initial time comes from the time in the restart file. Default value is 0.
init_time_seconds integer Initial time of model in seconds. Default is 0.
output_interval integer The frequency with which output diagnostics are written. Default value is 1.




FILES




REFERENCES


ERROR CODES and CONDITIONS

RoutineMessageComment
perfect_model_obs Input obs_sequence file should not have any copies of data associated with it Perfect_model_obs just requires an observation definition, not any values.



KNOWN BUGS




FUTURE PLANS

Discussion