What |
nameofinstance.xml |
---|---|
Required |
no |
Description |
Determine mass balance for a specified polygon |
schema location |
Introduction
The mass-balances module determines the inflow, outflow and storage change within a give polygon from available flow fields. The various parts of the mass balance are computed separately and result in a scalar timeseries:
- To compute the horizontal inflow and outflow, you need to have timeseries of the flow in x- and y-direction defined on a rectangular grid.
- To compute the vertical flow, you need to have timeseries of the flow coming in through the lower face of the grid cells and the flow coming in through the upper face.
- To compute the storage change, you need either the storage change per grid cell or the water table per grid cell. In the first case, the computation consists of summing the values over all grid cells within the given polygon, in the second case, the change over time must be computed as well.
The polygon for which the mass balance is determined is defined via the location set of the output timeseries: the locations defined in that set are taken as the vertices of the polygon. Grid cells are considered to be inside the polygon if their centre is.
In the sections below the different elements of the configuration are described
– TODO: screendumps of the schema parts –
Horizontal flux
The input for determining the horizontal flux consists of:
- The flow velocity in the x-direction
- The flow velocity in the y-direction
The timeseries must be defined on the same rectangular grid for the same times.
The output consists of a timeseries of the nett in- and outflow, where the flow rate through the side faces is computed as the flow velocity times the length of the side times a thickness of 1 m. The result is a flow rate in m3/s (assuming the flow velocity is given in m/s and the grid size in m).
Vertical flux
The input for determining the vertical flux consists of:
- The flow velocity at the lower face of each grid cell
- The flow velocity at the upper face of each grid cell
The timeseries must be defined on the same rectangular grid for the same times.
The output consists of a timeseries of the nett in- and outflow, where the flow rate through the faces faces is computed as the flow velocity times the length and width of the grid cell. The result is a flow rate in m3/s (assuming the flow velocity is given in m/s and the grid size in m). Effects of porosity are not taken into account.
description
An optional description
exportTypeStandard
This type specifies which reader should be used to read the file. The type must be one from the enumeration. Presently (2007/02) only bfg and pi are included in this list.
exportType
This type specifies which reader should be used to read the file. It may be any string as long as this type is supported by the TimeSeriesExport module. The list of supported types is given below.
folder
Folder (directory) in which to store the exported files.
exportFileName
This elements describes how to construct the filename(s) of the exported file(s).
If only the name element is given a fixed name is used for each export. The prefix and suffix elements describe how to create a filename prefix and/or suffix. The temporaryPrefix is used to generate a prefix for the temporary file as it is being written. After that the fine is renamed.
validate
Optional element. Only applicable if the data are exported to the xml-file. This option activates the validation of the exported file against a XML schema.
idmapId
Id of IdMap to be used for parameterId and locationId mapping
unitConversionsId
Id of UnitConversions to be used for unit mapping
flagConversionsId
Id of flagConversions to be used for flag mapping
exportMissingValue/exportMissingValueString
Missing value definition for this time series. Either a string or a number. Defaults to NaN if not defined.
omitMissingValues
If set to true records with missing values are not exported
exportTimeZone
TimeZone in which to export the data. Can either be a string (timeZoneName) or an offset (timeZoneOffset).