Pump Properties

Properties

AccelerationTime Acceleration time
ConstantFlow Set the constant flow rate
CurrentStartLevel Current start level of pump. Initially the same as StartLevel, but may be changed during the simulation by various control strategies.
CurrentStopLevel Current stop level of pump. Initially the same as StopLevel, but may be changed during the simulation by various control strategies.
dDischargedDownStreamWaterLevel Calculated Discharge derivative with DownStreamWaterLevel. Downstream is relative to the direction of chainage. The value is calculated by SetWaterLevels. Unit: [m^2/s]
(Inherited from Structure)
dDischargedUpStreamWaterLevel Calculated Discharge derivative with UpStreamWaterLevel. Upstream is relative to the direction of chainage. The value is calculated by SetWaterLevels. Unit: [m^2/s]
(Inherited from Structure)
DecelerationTime Deceleration time
Discharge Calculated Discharge. The value is calculated by SetWaterLevels. Unit: [m^3/s]
(Inherited from Structure)
DischargeControlActive Must be set to true to activate (external) control of discharge (through a PID control or similar).

Can not be combined with StartStopLevelControlActive

DownstreamWaterLevel Downstream water level.Downstream refers to the direction of chainage. The water level is set by use of SetWaterLevels Unit: [m]
(Inherited from Structure)
EnableCheckFlowDirectionOscillations Flag indicating whether to use special check and damping for structure discharge oscillating around zero.
(Inherited from Structure)
ExtensionData Property used by (de)serializer, when it can not find proper target for a data field. Support of forward compatible data contracts.
(Inherited from Structure)
FlowArea Flow area through structure. Used by most (but not all) structures.
(Inherited from Structure)
FlowFactor The discharge (and discharge derivatives) are scaled by the flow factor.
(Inherited from Structure)
HQRelation QH relation for QdeltaH and QH pumps, (dH, Q) or (H, Q) pairs. The XYTable ensures that dH (or H) is always increasing.

For QdeltaH, a positive dH is the height that water must be RAISED across the pump.

When DischargeControlActive is set (e.g. PID controlled pump) this HQ relation is the maximum pump capacity. Set to null if no maximum capacity.

HQRelationMinimumCapacity QH relation for QH and QdeltaH pumps Minimum discharge allowed for a discharge controlled pump (e.g. PID). Set to null to disable.
ID Structure ID
(Inherited from Structure)
IDInUserUnit Used to get a consistent description of the structure. The ID comes in user units. Used e.g. when reporting errors, warnings and hints.
(Inherited from Structure)
Implicit Flag to control if the structure is implicit or explicit. If the structure is explicit (Implicit == false) then the derivatives of the dicharge are always zero. Default value: true
(Inherited from Structure)
InterpolateMaxDischargeBetweenHQRelations Flag specifying to derive maximum discharge by linearly interpolating between maximum discharge of QH relation for QdeltaH and QH pumps, (dH, Q) or (H, Q) pairs. The XYTable ensures that dH (or H) is always increasing.

For QdeltaH, a positive dH is the height that water must be RAISED across the pump.

When DischargeControlActive is set (e.g. PID controlled pump) this HQ relation is the maximum pump capacity. Set to null if no maximum capacity.

and maximum discharge of QH relation for QH and QdeltaH pumps Minimum discharge allowed for a discharge controlled pump (e.g. PID). Set to null to disable. .
InvertLevelDownstream Invert level down stream
(Overrides StructureInvertLevelDownstream)
InvertLevelUpstream Invert level up stream
(Overrides StructureInvertLevelUpstream)
IsActive Return true if the pump is pumping
IsSideStructure A side structure is connected to a reservoir downstream (chainage direction).
Obsolete
IsVariableSpeed True if the pump supports variable speed operation (must be true for PID controlled pumps). Default value: false
Length Length of the structure. Unit: [m] Default value: 0m
(Inherited from Structure)
Location Location property.
(Inherited from Structure)
MaxStartLevel Maximum start level used if an external control is active. If an external control is active, then MinStopLevel and MaxStartLevel must be set.
MinStopLevel Minimum stop level used if an external control is active. If an external control is active, then MinStopLevel and MaxStartLevel must be set.
MinTimeOff Minimum time the pump should stay off if it stops pumping. This is only applicable when StartStopLevelControlActive. Default value is 0 seconds.
MinTimeOn Minimum time the pump should stay on if it starts pumping. This is only applicable when StartStopLevelControlActive. Default value is 0 seconds.
NumberOfStarts Number of times the pump was started
Offset Offset on water level
OffsetMinDischarge Offset to use when looking up the minimum discharge for the pump. Only used when a PID control is attached to the pump.
OutletLevel Set the level of the outlet for the pump.

For side structures (StructureType == SideStructure) this is also used as a reservoir level, i.e. a level outside the model. If flow direction is upstream (all negative Q in HQRelation), then the downstream level is equal to this reservoir level. If Q is positive, then OutletLevel is used as the downstream end.

Default value is MinValue, effectively disabling the use of the OutletLevel

PumpType Type of pump
ReservoirLevel Same as OutletLevel
RunTimeDiagnostics The getter is used to get a list of errors.
(Inherited from Structure)
SideStructureBank Bank side that side-structure is located on

If side structure contains reservoir, and has the Coordinate set, this is not used (and should be set to Undefined).


(Inherited from Structure)
SideStructureReservoir Reservoir at end of side structure. Null if not side structure, or no reservoir is defined
(Inherited from Structure)
SmoothingFactor Exponential smoothing factor for structure discharge. The smoothing factor is the weight of the previous discharge on the new discharge: q = (1 - SmoothingFactor) * qStructure + SmoothingFactor * qPrevious
(Inherited from Structure)
StartLevel The water level at which the pump is activated.
StartStopLevelControlActive Must be set to true to activate external control of start and stop levels (through a PID control or similar).

If pump is controlled through ControlModule, this will set this automatically (during Prepare)

Can not be combined with DischargeControlActive

State State of pump
StopLevel The water level at which the pump is de-activated
StructureType Type of structure
(Inherited from Structure)
TopoID String used to identified cross sections
(Inherited from Structure)
TotalTimeActive Total time the pump was active
Type Structure type, unique for each structure.
(Overrides StructureType)
UpstreamWaterLevel Upstream water level. Upstream refers to the direction of chainage. The water level is set by use of SetWaterLevels Unit: [m]
(Inherited from Structure)
UseMaximumDischarge If true, then the maximum alloved discharge is taken from the MaxPumpDischargeUpstream/MaxPumpDischargeDownstream and that value is use to directly set the maximum discharge. Default false.
UseSuppressionFactor If true, then suppresion factors from the PumpSuppressionFactorUpstream and PumpSuppressionFactorDownstream delegates are used to limit the available discharge of the pump. Default false.
WaterLevelDifferenceMinimal Water level difference below which it is assumed that structure has no flow.
(Inherited from Structure)

See Also