Full Equations (FEQ) Model for the Solution of the Full, Dynamic Equations of Motion for One-Dimensional Unsteady Flow in Open Channels and Through Control Structures
Purpose: The nodes where output to a designated file is desired are specified with this block. This block is required even if no special output is needed. No nodes are specified in this case, but a null block is still required in the input. The maximum number of special outputs in the special-output file allowed in FEQ is specified in the parameter MNSOUT in the INCLUDE file ARSIZE.PRM (appendix 3). The maximum number of gates for output of special values to the special-output file allowed in FEQ is specified in the parameter MNGATE in the INCLUDE file ARSIZE.PRM (appendix 3). These parameters may be changed as needed and FEQ recompiled.
Heading: One line of user-selected information. The suggested string is SPECIAL OUTPUT LOCATIONS.
LINE 1Variable: UNIT, OUTNAM
Format: 5X, I5, A32
Example: UNIT=00009SPOUT
Explanation:
UNIT is the Fortran unit number (see appendix 3) of the file used for storing the special output.LINE 2OUTNAM is the name for the file used for storing the special output. If OUTNAM is nonblank, then a file will be opened with the name given by the contents of OUTNAM (most microcomputers). On IBM mainframes, the name given in OUTNAM will be the ddname for the DD statement defining the data set. If the OUTNAM is blank, then an implicit open will be done in an IBM mainframe if the proper DD statement defining the unit number given by UNIT is present. In some microcomputer systems, the user will be prompted for the file name in this case, whereas program execution will be aborted on other microcomputer systems.
Variable: HEAD
Format: A80
Example: BRAN NODE IDENTIFICATION
Explanation: This is a user-supplied heading for subsequent information.
LINE 3 (one for each node at which special output is desired)
Variables: BRA, NODE, HEAD1, HEAD2
Format: I5, A5, 1X, 2A7
Example: 1 100 NOD 100
Explanation:
The output node locations are specified on this line.Two lines are output for each time point in the simulation. The year, month, and day followed by the water-surface elevations at the requested output locations are listed in the first line. The hour of the day (in fractional form) and then the flows at the requested locations are listed in the second line.BRA is the branch number. If BRA=0, then the node column contains an exterior node label. The table is terminated if the branch number is given as negative.
NODE is the node number. If the node number is negative, the diffuse inflows to either the reservoir or the computational element specified by the node with the elevation values set to zero will be output. Diffuse inflows for reservoirs not having tributary area should not be requested.
Output of the gate opening (in feet) for the sluice gates at Stratton Dam on the Fox River at McHenry, Ill., and the flow type (FO, free orifice; SO, submerged orifice; FW, free weir; SW, submerged weir) is requested by placing the string "MCHN " right justified under the NODE heading. The branch number is zero. If code 5, type 8 is not present in the Network Matrix Control Input, the values output are undefined.
Output of the gate opening and flow type for the underflow gates supported by code 5, type 9 is requested by placing the user-selected four-character string for the gate under the NODE heading. The flow types are the same as for the gates at the Stratton Dam on the Fox River at McHenry, Ill.
HEAD1 and HEAD2: Up to 14 characters of identification information can be given for each output location. This identification is broken into the two strings HEAD1 and HEAD2, each seven characters long, and serves as a two-line heading for each column of hydraulic data in the special-output file. These headings are repeated every PAGESP lines, where PAGESP is input as PAGE in the Run Control Block (section 13.1). The number of lines per page including the two heading lines is specified with PAGESP. Thus, if at least one heading is to be visible while the user is reviewing the special output on a computer screen, then PAGESP should be set to 22. If only one heading at the top of the file is desired, then PAGESP should be set to a number larger than the maximum number of lines expected in the special-output file. Then, only three extra lines will appear in the special-output file: The first line will give the value of PAGESP, and the following two lines will give the identification information. PAGESP is output to the special-output file so that the special-output file can be read by other computer programs modified to read the number of lines per page and then skip over the headings as they read the file. This is a simple modification and should be made on all programs applied to read the special-output file. When DIFFUS=YES, the headings are given at the beginning of each period simulated even though PAGESP lines have not been used.
This table must always be present even if no output is needed. The headings must be given and the input terminated as usual, resulting in a null table (that is, a table with no values).