public interface IEnergyLoss : IStructure,
IDoubleProxy, IQuantityProxy, ISolvesEnergyEquation, ILinearZeroVariation, IPlotableStructure| AbruptAlignmentChange | Angle in degrees describing abrupt change in river alignment Type: angle Unit: [degrees] Default: 0.0 |
| ConvectionTermReductionCoefficient |
Reduction coefficient for convection terms (kinetic energy terms) in energy equation.
This coefficient is applied when the difference between inflow kinetic energy and outflow kinetic energy
(or more precisely, velocity head difference measured in meters) becomes larger than the total head loss.
0 corresponds to no reduction (default) whereas 1 corresponds to removing the upstream and
downstream convective terms.
(Inherited from ISolvesEnergyEquation) |
| dDischargedDownStreamWaterLevel |
Calculated Discharge derivative with UpStreamWaterLevel. Upstream is relative to the direction of chainage.
Unit: [m^2/s]
(Inherited from IStructure) |
| dDischargedUpStreamWaterLevel |
Calculated Discharge derivative with DownStreamWaterLevel. Downstream is relative to the direction of chainage.
Unit: [m^2/s]
(Inherited from IStructure) |
| Delhs |
Level from where the variation is forced to be linear.
(Inherited from ILinearZeroVariation) |
| Discharge |
Calculated Discharge
Unit: [m^3/s]
(Inherited from IStructure) |
| DownstreamExternalEnergyLevel |
Flag indicating to use downstream external energy level.
For false the downstream energy level is calculated as part of the internal solution. It is more stable to set DownstreamExternalEnergyLevel to true. (Inherited from ISolvesEnergyEquation) |
| DownstreamWaterLevel |
Downstream water level.Downstream refers to the direction of chainge. The water level is set by use of
SetWaterLevels
Unit: [m]
(Inherited from IStructure) |
| FlowFactor |
The discharge (and discharge derivatives) are scaled by the flow factor.
(Inherited from IStructure) |
| FrictionFactor | Friction factor used to calculate the energy loss caused by ordinary friction. Type: Dimensional factor Unit: [s2/m6] Default: 0.001 |
| GradualAlignmentChange | Angle in degrees describing gradual change in river alignment Type: angle Unit: [degrees] Default: 0.0 |
| HorizontalOffSetFromMarker2 |
Horizontal offset of the structures compared to its limiting cross sections.
(Inherited from IPlotableStructure) |
| ID |
Name of the structure.
(Inherited from IStructure) |
| 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 IStructure) |
| Implicit |
Flag to control if the structure is implicit or explicit. If the structure is explicit
(Implicit == false) then the derivatives of the discharge are always zero.
Default value: true
(Inherited from IStructure) |
| InvertLevelDownstream |
Invert level down stream
The invert level is the level where water starts
flowing in to the structure from the downstream side.
It does not necessarily flow through the structure.
(Inherited from IStructure) |
| InvertLevelUpstream |
Invert level up stream.
The invert level is the level where water starts
flowing in to the structure from the upstream side.
It does not necessarily flow through the structure.
(Inherited from IStructure) |
| Length |
Length of the structure.
Unit: [m]
(Inherited from IStructure) |
| Location |
Location of structure.
(Inherited from IStructure) |
| MinimumHeadloss | Minimum head loss across a structure. Default value = 0.01 |
| NegContraction | Energy loss coefficient for negative flow at flow contraction losses Type: Dimensional factor Unit: [] Default: 0.0 |
| NegExpansion | Energy loss coefficient for negative flow at flow expansion losses Type: Dimensional factor Unit: [] Default: 0.0 |
| NegUserDefined | Energy loss coefficient for negative flow at user defined energy losses Type: Dimensional factor Unit: [] Default: 0.0 |
| PartOfCompositeFlow |
Part of the flow in a parallel structure that passes through this structure.
(Inherited from ISolvesEnergyEquation) |
| PosContraction | Energy loss coefficient for positive flow at flow contraction losses Type: Dimensional factor Unit: [] Default: 0.0 |
| PosExpansion | Energy loss coefficient for positive flow at flow expansion losses Type: Dimensional factor Unit: [] Default: 0.0 |
| PosUserDefined | Energy loss coefficient for positive flow at user defined energy losses Type: Dimensional factor Unit: [] Default: 0.0 |
| Roughness | Roughness for gradual change in river alignment Type: Dimensional factor Unit: [] Default: 0.0 |
| RunTimeDiagnostics |
The getter is used to get a list of errors. OBSOLETE
(Inherited from IStructure) |
| 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 IStructure) |
| SideStructureReservoir |
Reservoir at end of side structure. Null if not side structure, or no reservoir is defined
(Inherited from IStructure) |
| SolverMethod |
Solution method for solving the energy equations.
(Inherited from ISolvesEnergyEquation) |
| StructureType |
Type of structure
(Inherited from IStructure) |
| TopoID |
TopoID used when structure is searching for neighboring cross sections in the reach.
(Inherited from IStructure) |
| Type |
Structure type, unique for each type of structure.
(Inherited from IStructure) |
| UpstreamExternalEnergyLevel |
Flag indicating to use upstream external energy level.
For false the upstream energy level is calculated as part of the internal solution. It is more stable to set UpstreamExternalEnergyLevel to true. (Inherited from ISolvesEnergyEquation) |
| UpstreamWaterLevel |
Upstream water level. Upstream refers to the direction of chainage. The water level is set by use of
SetWaterLevels
Unit: [m]
(Inherited from IStructure) |
| UseAbruptChange | Flag telling if there is energy loss due to an abrupt change in river alignment Type: boolean Unit: [m] Default: false |
| UseContractionLoss | Flag telling if there is an energy loss due to a contraction Type: boolean Unit: [m] Default: false |
| UseExpansionLoss | Flag telling if there is an energy loss due to a expansion Type: boolean Unit: [m] Default: false |
| UseFrictionFromHD |
Use friction in energy equation from HD module.
(Inherited from ISolvesEnergyEquation) |
| UseGradualChange | Flag telling if there is energy loss due to a gradual change in river alignment Type: boolean Unit: [m] Default: false |
| UseUserDefined | Flag telling if there is an user defined energy loss Type: boolean Unit: [m] Default: false |
| Accepts |
List of data types that is accepted, i.e., that you can get a ValueSetter for.
(Inherited from IQuantityProxy) |
| Description |
Description of the structure.
(Inherited from IStructure) |
| Initialize |
Set up structure and set runtime diagnostics object
(Inherited from IStructure) |
| Offers |
List of data types that is offered, i.e., that you can get a ValueGetter for.
(Inherited from IQuantityProxy) |
| Prepare |
Set up structure and set runtime diagnostics object
(Inherited from IStructure) |
| SetWaterLevels(StructureParametersFromHD) |
Sets up- and down-stream water level and forces the calculation of the discharge and its derivatives.
(Inherited from ISolvesEnergyEquation) |
| SetWaterLevels(Double, Double) |
Sets up- and down- stream water level and forces the calculation of the discharge and its derivatives.
(Inherited from IStructure) |
| SetWaterLevels(Double, Double, Double, Double) |
Sets up- and down-stream water level and forces the calculation of the discharge and its derivatives.
(Inherited from ISolvesEnergyEquation) |
| UpdatedWaterLevels |
After a time step (or iteration) has finished, update the discharge to the actual value, based
on the final water levels and the discharge derivatives.
(Inherited from IStructure) |
| Validate |
Writes errors, warnings and hints into their respective member classes. The member objects are initially cleared.
(Inherited from IStructure) |
| ValueGetter |
Get value setter for the specified data quantity
(Inherited from IDoubleProxy) |
| ValueSetter |
Get value setter for the specified data type
(Inherited from IDoubleProxy) |
| Getter | From the proxy, return an FuncTResult for the specified quantity. It returns the first quantity of that type that is offered, and null if the quantity is not offered. (Defined by ProxyExtensions) |
| Getters |
Returns a set of FuncTResult for the quantity.
We can return several quantities with the same id (usually they will differ in their description).
If the quantity is not offerent, an empty list is returned.
(Defined by ProxyExtensions) |
| GettersFraction |
Returns a set of FuncT, TResult for the quantity.
We can return several quantities with the same id (usually they will differ in their description).
If the quantity is not offerent, an empty list is returned.
(Defined by ProxyExtensions) |
| GetterUnboxed | From the proxy, return an FuncTResult for the specified quantity. It returns the first quantity of that type that is offered, and null if the quantity is not offered. (Defined by ProxyExtensions) |
| Initialize |
Helper function for some unit tests. Do not use.
(Defined by StructureExtensions) |
| Initialize |
Helper function for some unit tests. Do not use.
(Defined by StructureExtensions) |
| IsSideStructure |
Returns true if the structure is a side structure
(Defined by StructureExtensions) |
| Setter | From the proxy, return an IDoubleGetSet for the specified quantity. It returns the first quantity of that type that is accepted, and null if the quantity is not accepted. (Defined by ProxyExtensions) |