SMS:ADH Time Series

From XMS Wiki
Jump to navigationJump to search

ADH includes several model specific time series (curve) groups to organize model curves by type. The curves of these groups can be viewed and edited in the Time Series editor and include time series attributes specific to ADH. The following table describes the groups:

ADH Curve Groups
Name Description Specification Use Restrictions
Depth Time offset with depth measurement (L) Flow or pressure boundary condition (DB OVH or DB LDH card)
Discharge Time offset with flow rate (L³/T) Flow boundary condition (NB DIS card)
Draft Time offset with draft measurement (L) Pressure boundary condition (DB LID card)
Elevation Time offset with elevation value (L) Pressure boundary condition (DB LDE card)
Flow (per unit length) Time offset with unit flow rate (L²/T) Flow boundary condition (NB OVL card in conjunction with an ADH edge string)
Meteorologic Time offset with unit flow rate (L/T) Flow boundary condition (NB OVL card in conjunction with an ADH material string)
Time Step Size Time offset with time step size (T) Simulation condition (TC IDT card) Unavailable in steady state
Transport Time offset with concentration measurement (PP) Transport boundary condition (NB TRN or DB TRN card) Unavailable in steady state
Velocity Time offset with velocity components (L/T) (three columns) Flow boundary condition (DB OVH or DB OVL card)
Water Surface Elevation Time offset with elevation value (L) Flow boundary condition (NB OTW card)
(Units: T = time, L = length, PP = unitless parts per)

Curves with similar value types (i.e. pressure boundary conditions) have been separated into individual groups to avoid the unintentional application.

Specifying and Selecting Time Series Data

In the ADH menu, selecting the Time Series Data... option will open the Time Series editor with the above mentioned available curve groups. This is provided to quickly view or specify all simulation time series data from one window. However, specifying a time series data in the editor accessed from this menu item does not associate the time series with a boundary or simulation condition. Various windows of the ADH interface (i.e. Boundary Condition tab of the Material Properties window) include a curve button which opens the Time Series editor with only the condition's curve group available. Association of the selected curve with a condition occurs when the editor's OK button is selected. These buttons will display the name and plot of the selected time series, unless in a spreadsheet (i.e. Transport Constituents tab of the Boundary Condition Assignment window).

Steady State Simulation

If setting up a steady state simulation, the Time Series editor is still used to specify and associate time series. There is no restriction on the time series data in the interface (the number of rows is not limited), however SMS will write a steady state series consisting only of the first condition value(s) listed. The written series is created using the simulation start and end times (zero offset and the simulation length from the Time tab in Model Control, respectively) with the same condition value(s). To avoid confusion, it is suggested that only one row should be specified in the editor (with a zero time offset) for all steady state series. SMS will validate that a time series selected to be associated with a boundary condition is appropriate steady state data.

Boundary Condition File

When saving the ADH boundary condition file (*.bc), only the time series that are actually used by the simulation (associated with conditions) are written out. These are converted to the units expected by ADH (i.e. mph to ft/s) as necessary and written as XY1 cards with XYT cards if curve fit tolerance is specified (apart of time series attributes). Unused curves can be saved by exporting them from the Time Series editor. A written series that is not defined for the full simulation duration is automatically appended with the simulation end time and the last specified condition value(s). A time series in the file can appear different than as specified in the Time Series editor because of unit conversions and validation.

After reading a XY1 card from a file, SMS will assign the data to a curve group based on the type of card(s) that references it in the file. If multiple types of cards reference the same time series, then the data will be assigned to multiple curve group as separate and unique time series.

Related Topics