Non-Visual Objects
9594In addition to physical objects that can be displayed visually on a map, GeoSWMM utilizes several classes of non-visual data objects to describe additional characteristics and processes within a study area.
- Climatology Data
- Hydrology Data
- Hydraulic Data
- Water Quality Data
- Tabular Data
Climatology
The Climatology object in GeoSWMM describes the following climate-related variables used for computing runoff and snowmelt:
- Temperature
- Evaporation
- Wind Speed
- Snowmelt
- Areal Depletion
- Climate Adjustments
Temperature
Air temperature data are used when simulating snowfall and snowmelt processes during runoff calculations. They can also be used to compute daily evaporation rates. If these processes are not being simulated then temperature data are not required. Air temperature data can be supplied to GeoSWMM from one of the following sources:
- A user-defined time series of point values (values at intermediate times are interpolated)
- An external climate file containing daily minimum and maximum values (GeoSWMM fits a sinusoidal curve through these values depending on the day of the year)
For user-defined time series, temperatures are in degrees F for US units and degrees C for metric units. The external climate file can also be used to directly supply evaporation and wind speed as well.
Evaporation
Evaporation can occur for standing water on subcatchment surfaces, for subsurface water in groundwater aquifers, and for water held in storage units. Evaporation rates can be stated as:
- A single constant value
- A set of monthly average values
- A user-defined time series of daily values
- Values computed from the daily temperatures contained in an external climate file
- Daily values read directly from an external climate file.
If rates are read directly from a climate file, then a set of monthly pan coefficients should also be supplied to convert the pan evaporation data to free water-surface values. An option is also available to allow evaporation only during periods with no precipitation.
Wind Speed
Wind speed is an optional climatic variable that is only used for snowmelt calculations. GeoSWMM can use either a set of monthly average speeds or wind speed data contained in the same climate file used for daily minimum/maximum temperatures.
Snowmelt
Snowmelt parameters are climatic variables that apply across the entire study area when simulating snowfall and snowmelt. They include:
- The air temperature at which precipitation falls as snow
- Heat exchange properties of the snow surface
- Study area elevation, latitude, and longitude correction
Areal Depletion
Areal depletion refers to the tendency of accumulated snow to melt non-uniformly over the surface of a subcatchment. As the melting process proceeds, the area covered by snow gets reduced. This behavior is described by an Areal Depletion Curve that plots the fraction of total area that remains snow covered against the ratio of the actual snow depth to the depth at which there is 100% snow cover. A typical ADC for a natural area is shown in Figure 3.3. Two such curves can be supplied to GeoSWMM, one for impervious areas and another for pervious areas.
.jpg&w=1280&q=75&dpl=dpl_Ge9WaDuhQu2YZhR1EvBCgV86S4Dj)
Adjustments
Adjustments are optional modifications applied to the temperature, evaporation rate, and rainfall intensity that GeoSWMM would otherwise use at each time step of a simulation. Separate sets of adjustments that vary periodically by month of the year can be assigned to these variables. They provide a simple way to examine the effects of future climate change without having to modify the original climatic time series.
In a similar manner, a set of monthly adjustments can be applied to the hydraulic conductivity used in computing rainfall infiltration on pervious land surfaces and exfiltration from storage nodes and conduits. These can reflect the increase of hydraulic conductivity with increasing temperature or the effect that seasonal changes in land surface conditions, such as frozen ground, can have on infiltration capacity.
Hydrology
Aside from rain gages and subcatchments, the following hydrology-related objects are used by GeoSWMM:
- Aquifers
- Snow Packs
- Unit Hydrographs
- LID Controls
Aquifers
Aquifers are sub-surface groundwater areas used to model the vertical movement of water infiltrating from the subcatchments that lie above them. They also permit the infiltration of groundwater into the drainage system, or exfiltration of surface water from the drainage system, depending on the hydraulic gradient that exists. The same aquifer object can be shared by several subcatchments. Aquifers are only required in models that need to explicitly account for the exchange of groundwater with the drainage system or to establish baseflow and recession curves in natural channels and non-urban systems.
Aquifers are represented using two zones – an un-saturated zone and a saturated zone. Their behavior is characterized using such parameters as soil porosity, hydraulic conductivity, evapotranspiration depth, bottom elevation, and loss rate to deep groundwater. In addition, the initial water table elevation and initial moisture content of the unsaturated zone must be supplied.
Aquifers are connected to subcatchments and to drainage system nodes as defined in a subcatchment's Groundwater Flow property. This property also contains parameters that govern the rate of groundwater flow between the aquifer's saturated zone and the drainage system node.
Snow Packs
Snow Pack objects contain parameters that characterize the buildup, removal, and melting of snow over three types of sub-areas within a subcatchment:
- The Plowable snow pack area consists of a user-defined fraction of the total impervious area. It is meant to represent such areas as streets and parking lots where plowing and snow removal can be done
- The Impervious snow pack area covers the remaining impervious area of a subcatchment
- The Pervious snow pack area encompasses the entire pervious area of a subcatchment
Each of these three areas is characterized by the following parameters:
- Minimum and maximum snow melt coefficients
- Minimum air temperature for snow melt to occur
- Snow depth above which 100% areal coverage occurs
- Initial snow depth
- Initial and maximum free water content in the pack99989796959493929190
In addition, a set of snow removal parameters can be assigned to the Plowable area. These parameters consist of the depth at which snow removal begins and the fractions of snow moved onto various other areas.
Subcatchments are assigned to a snow pack object through their Snow Pack property. A single snow pack object can be applied to any number of subcatchments. Assigning a snow pack to a subcatchment simply establishes the melt parameters and initial snow conditions for that subcatchment. Internally, GeoSWMM creates a "physical" snow pack for each subcatchment, which tracks snow accumulation and melting for that particular subcatchment based on its snow pack parameters, its amount of pervious and impervious area, and the precipitation history it sees.
Unit Hydrographs
Unit Hydrographs (UHs) estimate rainfall-dependent infiltration/inflow (RDII) into a sewer system. A UH set contains up to three such hydrographs, one for a short-term response, one for an intermediate-term response, and one for a long-term response. A UH group can have up to 12 UH sets, one for each month of the year. Each UH group is considered as a separate object by GeoSWMM, and is assigned its own unique name along with the name of the rain gage that supplies rainfall data to it.
Each unit hydrograph, as shown in Figure 3.4, is defined by three parameters:
- R: the fraction of rainfall volume that enters the sewer system
- T: the time from the onset of rainfall to the peak of the UH in hours
- K: the ratio of time to recession of the UH to the time to peak
.png&w=1024&q=75&dpl=dpl_Ge9WaDuhQu2YZhR1EvBCgV86S4Dj)
Each unit hydrograph can also have a set of Initial Abstraction (IA) parameters associated with it. These determine how much rainfall is lost to interception and depression storage before any excess rainfall is generated and transformed into RDII flow by the hydrograph. The IA parameters consist of:
- A maximum possible depth of IA (inches or mm)
- A recovery rate (inches/day or mm/day) at which stored IA is depleted during dry periods
- An initial depth of stored IA (inches or mm)89
To generate RDII into a drainage system node, the node must identify (through its Inflows property) the UH group and the area of the surrounding sewer shed that contributes RDII flow.
- An alternative to using unit hydrographs to define RDII flow is to create an external RDII interface file, which contains RDII time series data.
- Unit hydrographs could also be used to replace GeoSWMM’s main rainfall-runoff process that uses Subcatchment objects, provided that properly calibrated UHs are utilized. In this case what GeoSWMM calls RDII inflow to a node would actually represent overland runoff.
LID Controls
LID Controls are low impact development practices designed to capture surface runoff and provide some combination of detention, infiltration, and evapotranspiration to it. They are considered as properties of a given subcatchment, similar to how Aquifers and Snow Packs are treated. GeoSWMM can explicitly model five different generic types of LID controls:

Bio-retention Cells are depressions that contain vegetation growing in an engineered soil mixture placed above a gravel drainage bed. They provide storage, infiltration and evaporation of both direct rainfall and runoff surrounding areas.

Rain Gardens are a type of bio-retention cell consisting of just the engineered soil layer with no gravel bed below it.

Green Roofs are another variation of a bio-retention cell that have a soil layer laying atop a special drainage mat material that material that conveys excess percolated rainfall off of the roof.

Infiltration Trenches are narrow ditches filled with gravel that intercept runoff from upslope impervious areas. They provide storage volume and additional time for captured runoff to infiltrate the native soil below.

Continuous Permeable Pavement systems are excavated areas filled with gravel and paved over with a porous concrete or asphalt mix. Block Paver systems consist of impervious paver blocks placed on a sand pea gravel bed with a gravel storage layer below.

Rain Barrels (or Cisterns) are containers that collect roof runoff during storm events and can either release or re-use the rainwater during dry periods

Rooftop Disconnection has downspouts discharge to pervious landscaped areas and lawns instead of directly into storm drains. It can also model roofs with directly connected drains that overflow onto pervious areas.

Vegetative Swales are channels or depressed areas with sloping sides covered with grass and other vegetation. They slow down the conveyance of collected runoff and allow it more times to infiltrate the native soil beneath it.
Bio-retention cells, infiltration trenches, and permeable pavement systems can contain optional drain systems in their gravel storage beds to convey excess captured runoff off of the site and prevent the unit from flooding. They can also have an impermeable floor or liner that prevents any infiltration into the native soil from occurring. Infiltration trenches and porous pavement systems can also be subjected to a decrease in hydraulic conductivity over time due to clogging.
Although some LID practices can also provide significant pollutant reduction benefits, at this time GeoSWMM only models the reduction in runoff mass load resulting from the reduction in runoff mass load resulting from the reduction in runoff flow volume. The following topics will provide a detail illustration on the using LID controls:
LID Representation
LID controls are represented by a combination of vertical layers whose properties are defined on a per-unit-area basis. This allows LIDs of the same design but differing areal coverage to easily be placed within different subcatchments in a study area.
During a simulation GeoSWMM performs a moisture balance that keeps track of how much water moves between and is stored within each LID layer. As an example, the layers used to model a bio-retention cell and the flow pathways between them are shown below:
.png&w=640&q=75&dpl=dpl_Ge9WaDuhQu2YZhR1EvBCgV86S4Dj)
The following table indicates which combination of layers applies to each type of LID (x means required, o means optional):
Table 3.3 : Types of LID and Layer combinations
LID Type | Surface | Pavement | Soil | Storage | Drain | Drainage Mat |
|---|---|---|---|---|---|---|
Bio-retention Cell | x |
| x | x | o |
|
Rain Garden | x |
| x |
|
|
|
Green Roof | x |
| x |
|
| x |
Infiltration Trench | x |
|
| x | o |
|
Permeable Pavement | x | x | o | x | o |
|
Rain Barrel | x |
|
| x | x |
|
Rooftop Disconnection | x |
|
|
| x |
|
Vegetative Swale | x |
|
|
|
|
|
When a user adds a specific type of LID control object to a GeoSWMM project the LID Control Editor is used to set the design properties of each relevant layer (such as thickness, void volume, hydraulic conductivity, drain characteristics, etc.). These LID objects can then be placed within selected subcatchments at any desired sizing (or areal coverage) by editing the subcatchment’s LID Controls property.
LID Utilization
Utilizing LID controls within a GeoSWMM project is a two phase process that:
- Creates a set of scale-independent LID controls that can be deployed throughout the study area,
- Assigns any desired mix and sizing of these controls to selected subcatchments.
Bear in mind that when LIDs are added to a subcatchment, the subcatchment’s Area property is the total area of the subcatchment (both non-LID and LID portions) while the Percent Imperviousness and Width parameters apply only to the non-LID portion of the subcatchment.
To implement the first phase, one selects the Hydrology | LID Controls category from the GeoSWMM object panel to add, edit or delete individual LID control objects. The LID Control Editor is used to edit the properties of the various component layers that comprise each LID control object.
For the second phase, for each subcatchment that will utilize LIDs, one selects the LID Controls property in the subcatchment’s Property Editor to launch the LID Group Editor. This editor is used to add or delete individual LID controls from the subcatchment. For each control added the LID Usage Editor is used to specify the size of the control and what fraction of the subcatchment’s impervious area it captures.99989796
LID Placement
There are two different approaches for placing LID controls within a subcatchment:
- Place one or more controls in an existing subcatchment that will displace an equal amount of non-LID area from the subcatchment
- Create a new subcatchment devoted entirely to just a single LID practice
The first approach allows a mix of LIDs to be placed into a subcatchment, each treating a different portion of the runoff generated from the non-LID fraction of the subcatchment. Note that under this option the subcatchment's LIDs act in parallel -- it is not possible to make them act in series (i.e., have the outflow from one LID control become the inflow to another LID). Also, after LID placement the subcatchment's Percent Impervious and Width properties may require adjustment to compensate for the amount of original subcatchment area that has now been replaced by LIDs (Fig 53). For example, suppose that a subcatchment which is 40% impervious has 75% of that area converted to a porous pavement LID. After the LID is added the subcatchment's percent imperviousness should be changed to the percent of impervious area remaining divided by the percent of non-LID area remaining. This works out to (1 - 0.75)*40 / (100 - 0.75*40) or 14.3 %.
.png&w=768&q=75&dpl=dpl_Ge9WaDuhQu2YZhR1EvBCgV86S4Dj)
Under this first approach the runoff available for capture by the subcatchment’s LIDs is the runoff generated form its impervious area. If the option to re-route some fraction of this runoff to the pervious area is exercised, then only the remaining impervious runoff (if any) will be available for LID treatment. Also note that Green Roofs and Roof Disconnection only treat the precipitation that falls directly on them and do not capture rinoff from other impervious areas in their subcatchment.
The second approach allows LID controls to be strung along in series and also allows runoff from several different upstream subcatchments to be routed onto the LID subcatchment. If these sungle-LID subcatchments are carved out of existing subcatchments, then once again some adjustment of the Percent Impervious, Width and also the Area properties of the latter may be necessary. In addition, whenever an LID occupies the entire subcatchment the values assigned to the subcatchment’s standard surface properties (such as imperviousness, slope, roughness, etc.) are overridden by those that pertain to the LID unit.
Normally both surface and drain outflows from LID units are routed to the same outlet location assigned to the parent subcatchment. However, one can choose to return all LID outflow to the pervious area of the parent subcatchment and/or route the drain outflow to a separate designated outlet. (When both of these options are chosen, only the surface outflow is returned to the pervious sub-area.)
LID Results
The performance of the LID controls placed in a subcatchment is reflected in the overall runoff, infiltration, and evaporation rates computed for the subcatchment as normally reported by GeoSWMM. GeoSWMM’s Summary Report also contains a section entitled LID Performance Summary that provides an overall water balance for each LID control placed in each subcatchment. The components of this water balance include total inflow, infiltration, evaporation, surface runoff, drain flow and initial and final stored volumes, all expressed as inches (or mm) over the LID’s area.
Optionally, the entire time series of flux rates and moisture levels for a selected LID control in a given subcatchment can be written to a tab delimited text file for easy viewing and graphing in a spreadsheet program.
Hydraulics
In addition to the nodes and links which characterize the physical aspects of a drainage system in a GeoSWMM model, the following data objects can be used to augment the hydraulic description of the system:
- Transects
- Inflows
- Controls
Transects
Transects refer to the geometric data that describe how bottom elevation varies with horizontal distance over the cross section of a natural channel or irregular-shaped conduit. Figure 3.7 displays an example transect for a natural channel.

Each transect must be given a unique name. Conduits refer to that name to represent their shape. A special Transect Editor is available for editing the station-elevation data of transect. GeoSWMM internally converts these data into tables of area, top width, and hydraulic radius versus channel depth. In addition, as shown in the diagram above, each transect can have a left and right overbank section whose Manning's roughness can be different from that of the main channel. This feature can provide more realistic estimates of channel conveyance under high flow conditions.
External Inflows
In addition to inflows originating from subcatchment runoff and groundwater, drainage system nodes can receive three other types of external inflows:
- Direct Inflows - These are user-defined time series of inflows added directly into a node. They can be used to perform flow and water quality routing in the absence of any runoff computations (as in a study area where no subcatchments are defined).
- Dry Weather Inflows - These are continuous inflows that typically reflect the contribution from sanitary sewage in sewer systems or base flows in pipes and stream channels. They are represented by an average inflow rate that can be periodically adjusted on a monthly, daily, and hourly basis by applying Time Pattern multipliers to this average value.
- Rainfall-Dependent Infiltration/Inflow (RDII) - These are Stormwater flows that enter sanitary or combined sewers due to "inflow" from direct connections of downspouts, sump pumps, foundation drains, etc. as well as "infiltration" of subsurface water through cracked pipes, leaky joints, poor manhole connections, etc. RDII can be computed for a given rainfall record based on set of triangular unit hydrographs (UH) that determine a short-term, intermediate-term, and long-term inflow response for each time period of rainfall. Any number of UH sets can be supplied for different sewer shed areas and different months of the year. RDII flows can also be specified in an external RDII interface file.
Direct, Dry Weather, and RDII inflows are properties associated with each type of drainage system node (junctions, outfalls, flow dividers, and storage units) and can be specified when nodes are edited. It is also possible to make the outflows generated from an upstream drainage system be the inflows to a downstream system by using interface files.
Control Rules
Control Rules determine how pumps and regulators in the drainage system will be adjusted over the course of a simulation. The use of control rules is explained in the following topics:
- Example Rules
- Rule Format
- Condition Clauses
- Action Clauses
- Modulated Controls
The following are some example control rules:
Simple time-based pump control
RULE R1
IF SIMULATION TIME > 8
THEN PUMP 12 STATUS = ON
ELSE PUMP 12 STATUS = OFF
Multiple-condition orifice gate control
RULE R2A
IF NODE 23 DEPTH > 12
AND LINK 165 FLOW > 100
THEN ORIFICE R55 SETTING = 0.5
RULE R2B
IF NODE 23 DEPTH > 12
AND LINK 165 FLOW> 200
THEN ORIFICE R55 SETTING = 1.0
RULE R2C
IF NODE 23 DEPTH <= 12
OR LINK 165 FLOW <= 100
THEN ORIFICE R55 SETTING = 0
Pump station operation
RULE R3A
IF NODE N1 DEPTH > 5
THEN PUMP N1A STATUS = ON
RULE R3B
IF NODE N1 DEPTH > 7
THEN PUMP N1B STATUS = ON
RULE R3C
IF NODE N1 DEPTH <= 3
THEN PUMP N1A STATUS = OFF
AND PUMP N1B STATUS = OFF
Modulated weir height control
RULE R4
IF NODE N2 DEPTH >= 0
THEN WEIR W25 SETTING = CURVE C25
Water Quality
Water quality related data are supplied to a GeoSWMM model using the following types of objects:
- Pollutants
- Land Uses
- Treatment
Pollutants
GeoSWMM can simulate the generation, inflow and transport of any number of user-defined pollutants. Required information for each pollutant includes:
- Pollutant name
- Concentration units (i.e., milligrams/liter, micrograms/liter, or counts/liter)
- Concentration in rainfall
- Concentration in groundwater
- Concentration in direct infiltration/inflow
- Concentration in dry weather flow
- First-order decay coefficient.
Co-pollutants can also be defined in GeoSWMM. For example, pollutant X can have a co-pollutant Y, meaning that the runoff concentration of X will have some fixed fraction of the runoff concentration of Y added to it.
Pollutant buildup and washoff from the subcatchment areas are determined by the land uses assigned to those areas. Input loadings of pollutants to the drainage system can also originate from external time series inflows as well as from dry weather inflows.
Land Uses
Land Uses are categories of development activities or land surface characteristics assigned to subcatchments. Examples of land use activities are residential, commercial, industrial, and undeveloped. Land surface characteristics might include rooftops, lawns, paved roads, undisturbed soils, etc. Land uses are used solely to account for spatial variation in pollutant buildup and washoff rates within subcatchments.
The GeoSWMM user has many options for defining land uses and assigning them to subcatchment areas. One approach is to assign a mix of land uses for each subcatchment, which results in all land uses within the subcatchment having the same pervious and impervious characteristics. Another approach is to create subcatchments that have a single land use classification along with a distinct set of pervious and impervious characteristics that reflects the classification.
The following processes can be defined for each land use category:
- Pollutant buildup
- Pollutant washoff
- Street cleaning
Pollutant Buildup
Pollutant buildup that accumulates within a land use category is described (or “normalized”) by either a mass per unit of subcatchment area or per unit of curb length. Mass is expressed in pounds for US units and kilograms for metric units. The amount of buildup is a function of the number of preceding dry weather days and can be computed using one of the following functions:
- Power Function: Pollutant buildup (B) accumulates proportionally to time (t) raised to some power, until a maximum limit is achieved,
...(3.8) |
|---|
Here = maximum buildup possible (mass per unit of area or curb length), = buildup rate constant, and = time exponent.
- Exponential Function: Buildup follows an exponential growth curve that approaches a maximum limit asymptotically,
...(3.9) |
|---|
Here = maximum buildup possible (mass per unit of area or curb length) and = buildup rate constant (1/days).
- Saturation Function: Buildup begins at a linear rate that continuously declines with time until a saturation value is reached,
...(3.10) |
|---|
Here = maximum buildup possible (mass per unit area or curb length) and = half-saturation constant (days to reach half of the maximum buildup).
- External Time Series: This option allows one to use a Time Series to describe the rate of buildup per day as a function of time. The values placed in the time series would have units of mass per unit area (or curb length) per day. One can also provide a maximum possible buildup (mass per unit area or curb length) with this option and a scaling factor that multiplies the time series values.
Pollutant Washoff
Pollutant washoff from a given land use category occurs during wet weather periods and can be described in one of the following ways:
- Exponential Washoff: The washoff load (W) in units of mass per hour is proportional to the product of runoff raised to some power and to the amount of buildup remaining,
...(3.11) |
|---|
Here = washoff coefficient, = washoff exponent, = runoff rate per unit area (inches/hour or mm/hour), and = pollutant buildup in mass units. The buildup here is the total mass (not per area or curb length) and both buildup and washoff mass units are the same as used to express the pollutant's concentration (milligrams, micrograms, or counts).
- Rating Curve Washoff: The rate of washoff W in mass per second is proportional to the runoff rate raised to some power,
...(3.12) |
|---|
Here = washoff coefficient, = washoff exponent, and = runoff rate in user-defined flow units.
- Event Mean Concentration: This is a special case of Rating Curve Wash-off where the exponent is 1.0 and the coefficient C1 represents the washoff pollutant concentration in mass per liter (Note: the conversion between user-defined flow units used for runoff and liters is handled internally by GeoSWMM).
Note that in each case, buildup is continuously depleted as washoff proceeds, and washoff ceases when there is no more buildup available.
Washoff loads for a given pollutant and land use category can be reduced by a fixed percentage by specifying a BMP Removal Efficiency that reflects the effectiveness of any BMP controls associated with the land use. It is also possible to use the Event Mean Concentration option by itself, without having to model any pollutant buildup at all.
Street Sweeping
Street sweeping can be used on each land use category to periodically reduce the accumulated buildup of specific pollutants. The parameters that describe street sweeping include:
- Days between sweeping
- Days since the last sweeping at the start of the simulation
- The fraction of buildup of all pollutants that is available for removal by sweeping
- The fraction of available buildup for each pollutant removed by sweeping
Note that these parameters can be different for each land use, and the last parameter can vary also with pollutant.
Treatment
Removal of pollutants from the flow streams entering any drainage system node is modeled by assigning a set of treatment functions to the node. A treatment function can be any well-formed mathematical expression involving:
- The pollutant concentration of the mixture of all flow streams entering the node (use the pollutant name to represent a concentration)
- The removals of other pollutants (user_ prefixed to the pollutant name to represent removal)
- Any of the following process variables:
- FLOW for flow rate into node (in user-defined flow units)
- DEPTH for water depth above node invert (ft or m)
- AREA for node surface area (ft2 or m2)
- DT for routing time step (sec)
- HRT for hydraulic residence time (hours)
- Any of the following math functions (which are case sensitive) can be used in a treatment expression:
- abs(x) for absolute value of x
- sgn(x) which is +1 for x >=0 or -1 otherwise
- step(x) which is 0 for x <=0 and 1 otherwise
- sqrt(x) for the square root of x
- log(x) for logarithm base e of x
- log10(x) for logarithm base 10 of x
- exp(x) for e raised to the x power
- the standard trig functions (sin, cos, tan, and cot)
- the inverse trig function (asin, acos, atan, and acot)
- the hyperbolic trig functions (sinh, cosh, tanh, and coth) along with the standard operators +, -, *, /, ^ (for exponentiation) and any level of nested parentheses.
The result of the treatment function can be either a concentration (denoted by the letter C) or a fractional removal (denoted by R). For example, a first-order decay expression for BOD exiting from a storage node might be expressed as:
...(3.13) |
|---|
Or, the removal of some trace pollutant that is proportional to the removal of total suspended solids (TSS) could be expressed as:
...(3.14) |
|---|
Care must be taken to avoid circular references when specifying treatment functions. For example, the above expression would not be computable if it were used to compute fractional removal of TSS.
Tabular Data
GeoSWMM utilizes several forms of tabular data to describe the properties of its various objects. These include:
- Curve
- Time Series
- Time Patterns
Curve objects are used to describe a functional relationship between two quantities. The following types of curves are available in GeoSWMM:
- Storage - describes how the surface area of a Storage Unit node varies with water depth
- Shape - describes how the width of a customized cross-sectional shape varies with height for a Conduit link.
- Diversion - relates diverted outflow to total inflow for a Flow Divider node
- Tidal - describes how the stage at an Outfall node changes by hour of the day
- Pump - relates flow through a Pump link to the depth or volume at the upstream node or to the head delivered by the pump
- Rating - relates flow through an Outlet link to the head difference across the outlet
- Control - determines how the control setting of a pump or flow regulator varies as a function of some control variable (such as water level at a particular node) as specified in a Modulated Control rule.
Each curve must be given a unique name and can be assigned any number of data points.
Time Series objects are used to describe how certain object properties vary with time. Time series can be used to describe:
- temperature data
- evaporation data
- rainfall data
- water stage at outfall nodes
- external inflow hydrographs at drainage system nodes
- external inflow pollutes graphs at drainage system nodes
- control settings for pumps and flow regulators
Each time series must be given a unique name and can be assigned any number of time-value data pairs. Time can be specified either as hours from the start of a simulation or as an absolute date and time-of-day. Time series data can either be entered directly into the program or be accessed from a user-supplied Time Series file.
- For rainfall time series, it is only necessary to enter periods with non-zero rainfall amounts. GeoSWMM interprets the rainfall value as a constant value lasting over the recording interval specified for the rain gage that utilizes the time series. For all other types of time series, GeoSWMM uses interpolation to estimate values at times that fall in between the recorded values.
- For times that fall outside the range of the time series, GeoSWMM will use a value of 0 for rainfall and external inflow time series, and either the first or last series value for temperature, evaporation, and water stage time series.
Time Patterns allow external Dry Weather Flow (DWF) to vary in a periodic fashion. They consist of a set of adjustment factors applied as multipliers to a baseline DWF flow rate or pollutant concentration. The different types of time patterns include:
- Monthly: one multiplier for each month of the year
- Daily: one multiplier for each day of the week
- Hourly: one multiplier for each hour from 12 AM to 11 PM
- Weekend: hourly multipliers for weekend days
Each Time Pattern must have a unique name and there is no limit on the number of patterns that can be created. Each dry weather inflow (either flow or quality) can have up to four patterns associated with it, one for each type listed above.