UTL-OBS
Structure of Blocks
FOR EACH SIMULATION
BEGIN OPTIONS
[DIGITS <digits>]
[PRINT_INPUT]
END OPTIONS
BEGIN CONTINUOUS FILEOUT <obs_output_file_name> [BINARY]
<obsname> <obstype> <id> [<id2>]
<obsname> <obstype> <id> [<id2>]
...
END CONTINUOUS
Explanation of Variables
Block: OPTIONS
digits
Keyword and an integer digits specifier used for conversion of simulated values to text on output. If not specified, the default is the maximum number of digits stored in the program (as written with the G0 Fortran specifier). When simulated values are written to a comma-separated value text file specified in a CONTINUOUS block below, the digits specifier controls the number of significant digits with which simulated values are written to the output file. The digits specifier has no effect on the number of significant digits with which the simulation time is written for continuous observations. If DIGITS is specified as zero, then observations are written with the default setting, which is the maximum number of digits.PRINT_INPUT
keyword to indicate that the list of observation information will be written to the listing file immediately after it is read.
Block: CONTINUOUS
FILEOUT
keyword to specify that an output filename is expected next.obs_output_file_name
Name of a file to which simulated values corresponding to observations in the block are to be written. The file name can be an absolute or relative path name. A unique output file must be specified for each CONTINUOUS block. If the “BINARY” option is used, output is written in binary form. By convention, text output files have the extension “csv” (for “Comma-Separated Values”) and binary output files have the extension “bsv” (for “Binary Simulated Values”).BINARY
an optional keyword used to indicate that the output file should be written in binary (unformatted) form.obsname
string of 1 to 40 nonblank characters used to identify the observation. The identifier need not be unique; however, identification and post-processing of observations in the output files are facilitated if each observation is given a unique name.obstype
a string of characters used to identify the observation type.id
Text identifying cell where observation is located. For packages other than NPF, if boundary names are defined in the corresponding package input file, ID can be a boundary name. Otherwise ID is a cellid. If the model discretization is type DIS, cellid is three integers (layer, row, column). If the discretization is DISV, cellid is two integers (layer, cell number). If the discretization is DISU, cellid is one integer (node number).id2
Text identifying cell adjacent to cell identified by ID. The form of ID2 is as described for ID. ID2 is used for intercell-flow observations of a GWF model, for three observation types of the LAK Package, for two observation types of the MAW Package, and one observation type of the UZF Package.
Example Observation Input File
Example 1
BEGIN OPTIONS
DIGITS 10
PRINT_INPUT
END OPTIONS
BEGIN CONTINUOUS FILEOUT my_model.swf.stage.csv
# obsname obstype ID
S1 STAGE 1
S2 STAGE 2
END CONTINUOUS
BEGIN CONTINUOUS FILEOUT my_model.swf.flow.csv
# obsname obstype ID ID2
c1c2 FLOW-JA-FACE 1 2
END CONTINUOUS
Example Observation Input File
Example 2
BEGIN OPTIONS
DIGITS 10
PRINT_INPUT
END OPTIONS
BEGIN CONTINUOUS FILEOUT my_model.gwf.head.csv
# obsname obstype ID
L1 HEAD 1 51 51 # heads at lay 1 row 51 col 51
L2 HEAD 2 51 51 # heads at lay 2 row 51 col 51
END CONTINUOUS
BEGIN CONTINUOUS FILEOUT my_model.gwf.ddn.csv
# obsname obstype ID
L1ddn DRAWDOWN 1 51 51 # heads at lay 1 row 51 col 51
L2ddn DRAWDOWN 2 51 51 # heads at lay 2 row 51 col 51
END CONTINUOUS
BEGIN CONTINUOUS FILEOUT my_model.gwf.flow.csv
# obsname obstype ID ID1
L1rfflow FLOW-JA-FACE 1 51 51 1 51 52
L2rfflow FLOW-JA-FACE 2 51 51 2 51 52
L1-L2flow FLOW-JA-FACE 1 51 51 2 51 51
END CONTINUOUS
Example Observation Input File
Example 3
BEGIN OPTIONS
DIGITS 10
PRINT_INPUT
END OPTIONS
BEGIN CONTINUOUS FILEOUT my_model.gwe.temperature.csv
# obsname obstype ID
L1 TEMPERATURE 1 51 51 # temps at lay 1 row 51 col 51
L2 TEMPERATURE 2 51 51 # temps at lay 2 row 51 col 51
END CONTINUOUS
BEGIN CONTINUOUS FILEOUT my_model.gwe.eflow.csv
# obsname obstype ID ID2
L1rfflow FLOW-JA-FACE 1 51 51 1 51 52
L2rfflow FLOW-JA-FACE 2 51 51 2 51 52
L1-L2flow FLOW-JA-FACE 1 51 51 2 51 51
END CONTINUOUS
Example Observation Input File
Example 4
BEGIN OPTIONS
DIGITS 10
PRINT_INPUT
END OPTIONS
BEGIN CONTINUOUS FILEOUT my_model.gwt.conc.csv
# obsname obstype ID
L1 CONCENTRATION 1 51 51 # concs at lay 1 row 51 col 51
L2 CONCENTRATION 2 51 51 # concs at lay 2 row 51 col 51
END CONTINUOUS
BEGIN CONTINUOUS FILEOUT my_model.gwt.mflow.csv
# obsname obstype ID ID1
L1rfflow FLOW-JA-FACE 1 51 51 1 51 52
L2rfflow FLOW-JA-FACE 2 51 51 2 51 52
L1-L2flow FLOW-JA-FACE 1 51 51 2 51 51
END CONTINUOUS
Example Observation Input File
Example 5
BEGIN OPTIONS
DIGITS 10
PRINT_INPUT
END OPTIONS
BEGIN CONTINUOUS FILEOUT my_model.swf.stage.csv
# obsname obstype ID
S1 STAGE 1 2
S2 STAGE 2 2
END CONTINUOUS
BEGIN CONTINUOUS FILEOUT my_model.swf.flow.csv
# obsname obstype ID ID2
c1c2 FLOW-JA-FACE 1 1 1 2
END CONTINUOUS
Example Observation Input File
Example 6
BEGIN OPTIONS
DIGITS 10
PRINT_INPUT
END OPTIONS
BEGIN CONTINUOUS FILEOUT my_model.gwt.conc.csv
# obsname obstype ID
L1 CONCENTRATION 1 51 51 # concs at lay 1 row 51 col 51
L2 CONCENTRATION 2 51 51 # concs at lay 2 row 51 col 51
END CONTINUOUS
BEGIN CONTINUOUS FILEOUT my_model.gwt.mflow.csv
# obsname obstype ID ID1
L1rfflow FLOW-JA-FACE 1 51 51 1 51 52
L2rfflow FLOW-JA-FACE 2 51 51 2 51 52
L1-L2flow FLOW-JA-FACE 1 51 51 2 51 51
END CONTINUOUS