### UTL-OBS #### Structure of Blocks _FOR EACH SIMULATION_ ``` BEGIN OPTIONS [DIGITS ] [PRINT_INPUT] END OPTIONS ``` ``` BEGIN CONTINUOUS FILEOUT [BINARY] [] [] ... 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 ```