Click or drag to resize

BridgeBase Class

BridgeBase structures, supporting the following type of tables:
  • Q = f(Hups, Hdws)
The arguments (RowHeader) and (ColumnHeader) will always contain water levels, while the output (Table) will be discharge values.
Inheritance Hierarchy

Namespace:  DHI.Mike1D.StructureModule
Assembly:  DHI.Mike1D.StructureModule (in DHI.Mike1D.StructureModule.dll) Version: 19.0.0.0 (11.1.1.1111)
Syntax
public abstract class BridgeBase : BridgeTabulated, 
	IBridgeStructure, IStructure, IDoubleProxy, IQuantityProxy, ILinearZeroVariation, 
	IStructureCollectionSetup

The BridgeBase type exposes the following members.

Constructors
  NameDescription
Protected methodBridgeBase
Constructor method for the BridgeBase structure
Public methodBridgeBase(String)
Constructor method for the BridgeBase structure
Protected methodBridgeBase(BridgeType)
Constructor method for the BridgeBase structure
Top
Properties
  NameDescription
Public propertyAlpha
Public propertyBackRat
Back water ratio table
Public propertyBaseCoef
Public propertyBeta
Public propertyBottomlevel
Public propertyBridgeGeometry
BridgeGeometry
Public propertyBridgeOverflow
Overflow
Public propertyBridgeSubmergence
Submergence
Public propertyBridgeTableFilePath
Holds the filename and path of the bridge table file
(Inherited from BridgeTabulated.)
Public propertyColumnHeader
Holds the header for the columns, the upstream water levels. Type : Water level Unit: [meter] Default: 0.0
(Inherited from BridgeTabulated.)
Public propertyConvTubeNumber
Number of tubes for conveyance tube analyses.
Public propertyCulvertID
Public propertydDischargedDownStreamWaterLevel
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.)
Public propertydDischargedUpStreamWaterLevel
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.)
Public propertyDelhs
Linear flow variation. For water level differences less than delhs use a linear Q variation between h1-h2=delhs and h1-h2=0. This is to avoid stability problems for small water level differences where dQdh goes to infinity. Unit: [m] Default: 0.01
(Inherited from BridgeTabulated.)
Public propertyDischarge
Calculated Discharge. The value is calculated by SetWaterLevels. Unit: [m^3/s]
(Inherited from Structure.)
Public propertyDisCoefType
Public propertyDownstreamWaterLevel
Downstream water level.Downstream refers to the direction of chainage. The water level is set by use of SetWaterLevels Unit: [m]
(Inherited from Structure.)
Public propertyDykes1
Public propertyDykes2
Public propertyEccentricity
Public propertyEnchroachmentRegenerate
Boolean telling if Enchroachment regenerate
Public propertyEntrance
Public propertyExtensionData
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.)
Public propertyFlowArea
Flow area through structure. Used by most (but not all) structures.
(Inherited from Structure.)
Public propertyFlowFactor
The discharge (and discharge derivatives) are scaled by the flow factor.
(Inherited from Structure.)
Public propertyFroude
Public propertyGridSizeDownStream
Slotsize of table downstream
Public propertyGridSizeUpStream
Slotsize of table upstream
Public propertyID
Structure ID
(Inherited from Structure.)
Public propertyIDInUserUnit
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.)
Public propertyImplicit
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.)
Public propertyinvert
Public propertyInvertLevelDownstream (Overrides BridgeTabulatedInvertLevelDownstream.)
Public propertyInvertLevelUpstream (Overrides BridgeTabulatedInvertLevelUpstream.)
Public propertyIsAsymmetric
Boolean telling whether to use IsAsymmetric
Public propertyIsMultiWayOpen
Boolean telling whether to use IsMultiWayOpen
Public propertyLength
Length of the structure. Unit: [m] Default value: 0m
(Inherited from Structure.)
Public propertyLocation
Location property.
(Inherited from Structure.)
Public propertyMaximumWaterDepthAboveXSFactor
Public propertyMethod
Enum BridgeType defining the Bridge method used
Public propertyNumberOfCols
Number of columns in the table
(Inherited from BridgeTabulated.)
Public propertyNumberOfRows
Number of rows in the table
(Inherited from BridgeTabulated.)
Public propertyPiers
Public propertyRoad1
Public propertyRoad2
Public propertyRowHeader
Holds the header for the rows, the downstream water levels. Type : Water level Unit: [meter] Default: 0.0
(Inherited from BridgeTabulated.)
Public propertyRunTimeDiagnostics
The getter is used to get a list of errors.
(Inherited from Structure.)
Public propertySideStructureBank
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.)
Public propertySideStructureReservoir
Reservoir at end of side structure. Null if not side structure, or no reservoir is defined
(Inherited from Structure.)
Public propertySkew
Public propertySmoothBridgeSurface
Public propertySmoothBridgeSurfaceIterations
Public propertyStructureType
Type of structure
(Inherited from Structure.)
Public propertySubFac
Public propertySubmerged
Public propertyTable
Holds the discharge table Type : Discharge Unit: [m3/s]
(Inherited from BridgeTabulated.)
Public propertyTableIteration
Variable defining maximum number of iterations for precalculating tables.
Public propertyTablesGenerated
Boolean telling if the tables are generated
Public propertyTableSmooth
Holds the smoothed table Type : Water level or discharge depending on the chosen calculation mode Unit: [m3/s] or [meter] Default: 0.0
Public propertyTableType
Table input filetype 0 - DFS2 1 - ASCII Default: 0
(Inherited from BridgeTabulated.)
Public propertyTheta
Public propertyToplevel
Public propertyTopoID
String used to identified cross sections
(Inherited from Structure.)
Public propertyType
Structure type, unique for each type structure.
(Inherited from BridgeTabulated.)
Public propertyUpstreamWaterLevel
Upstream water level. Upstream refers to the direction of chainage. The water level is set by use of SetWaterLevels Unit: [m]
(Inherited from Structure.)
Public propertyUseAlpha
The velocity distribution coefficient for bridge calculations is set to unity per default. The coefficient may be calculated based on conveyance distribution. Default value: false
Public propertyUseEccentricity
Boolean telling whether to use Eccentricity
Public propertyUseFHWAReachLength
The reach length for the FHWA method is determined based on an equal conveyance tube analysis. if the reach length should only be based on the physical distance from the adjacent cross section to the bridge the variable 'USE_FHWA_REACH_LENGTH' may be used.
Public propertyUseOverflow
Boolean telling whether to use overflow
Public propertyUsePiers
Boolean telling whether to use Piers
Public propertyUsePiersPiles
Boolean telling wheter to use Piers Piles
Public propertyUsePreProcessedBridgeTable
Online or offline bridge equations. (calculate on the fly or read from table) Default: true
Public propertyUseSkewness
Boolean telling whether to use Skewness
Public propertyUseSpurDykes
Boolean telling whether to use SpurDykes
Public propertyUseSubmergence
Boolean telling whether to use submergence
Public propertyWaterLevelDatum
Datum to be applied to all water levels specified in the table. Type: water level Unit: [meter] Default: 0.0
(Inherited from BridgeTabulated.)
Public propertyWeirID
Top
Methods
  NameDescription
Public methodAccepts
List of data types that is accepted, i.e., that you can get a ValueSetter for.
(Inherited from Structure.)
Public methodAllocateTable
Allocate table of certain sizes
(Overrides BridgeTabulatedAllocateTable(Int32, Int32).)
Protected methodApplyFlowFactor
Applies flow factor to discharge and it's derivatives
(Inherited from Structure.)
Public methodCalcBridgeTable
Public methodCheckBridgeCombinations
Check bridge combinations
Public methodControlSetFlowFactor
Set flow factor to specified value
(Inherited from Structure.)
Public methodDescription
Return a string that describes this structure. Includes structure type and ID
(Inherited from Structure.)
Public methodDetermineBridgeFlow
Public methodDispose
Frees the licenses held.
(Inherited from Structure.)
Public methodEquals
Determines whether the specified object is equal to the current object.
(Inherited from Object.)
Protected methodExplicitStructureSupport
DEBUG: This method is called from Validate() if _implitcit == false to check if the structure supports being Explicit. Once all structures support explicit operation this method can be deleted.
(Inherited from Structure.)
Protected methodFinalize
Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.
(Inherited from Object.)
Public methodGenerateBridgeTable
Public methodGetControlAction
Get control action for the specified id. It always returns one of the ActionControl delegates. It will return null if controlActionId is not valid.

Base implementation for IControllable

(Inherited from Structure.)
Public methodGetCurrentValue
Get the current value of the control for the specified id.

Base implementation for IControllable

(Inherited from Structure.)
Public methodGetHashCode
Serves as the default hash function.
(Inherited from Object.)
Public methodGetType
Gets the Type of the current instance.
(Inherited from Object.)
Public methodInitialize(IDiagnostics)
Set up structure and set runtime diagnostics object
(Inherited from Structure.)
Public methodInitialize(ICrossSection, ICrossSection, Boolean, IDiagnostics) (Overrides StructureInitialize(ICrossSection, ICrossSection, Boolean, IDiagnostics).)
Protected methodLookUp2DTable
Protected methodMemberwiseClone
Creates a shallow copy of the current Object.
(Inherited from Object.)
Public methodOffers
A list of quantities available from this structure
(Inherited from Structure.)
Public methodPrepare(HDParameterData, IDiagnostics) (Overrides StructurePrepare(HDParameterData, IDiagnostics).)
Public methodPrepare(DateTime, HDParameterData, IDiagnostics)
Set up structure and set runtime diagnostics object
(Inherited from Structure.)
Public methodReadBridgeTable
Read bridge table from file
(Inherited from BridgeTabulated.)
Public methodReadBridgeTableASCII
Read bridge table from file
(Inherited from BridgeTabulated.)
Public methodReadBridgeTableDFS2
Read bridge table from file
(Inherited from BridgeTabulated.)
Public methodResetControlledState
Reset internal state (if any) used by controlling class. Called after a controlling class has performed a control sequence, and simulation is restarted.

Base implementation for IControllable

(Inherited from Structure.)
Public methodSetControlStrategyId
Set control strategy ID manually.

Base implementation for IControllable

(Inherited from Structure.)
Protected methodSetInputWaterLevels (Inherited from Structure.)
Public methodSetInvertLevel
Set up invert level
Public methodSetup
Public methodSetWaterLevels
Sets up- and down- stream water level and forces the calculation of the discharge and its derivatives.
(Inherited from BridgeTabulated.)
Protected methodSetZeroFlow
Sets the conditions for zero flow
(Inherited from Structure.)
Public methodToString
Returns a string that represents the current object.
(Inherited from Object.)
Public methodUpdatedWaterLevels
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 Structure.)
Public methodValidate
Validation of data for a BridgeBase structure.
(Overrides StructureValidate.)
Public methodValueGetter
Get value setter for the specified data quantity
(Overrides StructureValueGetter(Int32).)
Public methodValueSetter
Get value setter for the specified data type
(Inherited from Structure.)
Top
Fields
  NameDescription
Protected field_accepts
List of quantities that are accepted
(Inherited from Structure.)
Protected field_columnHeader (Inherited from BridgeTabulated.)
Protected field_controlStategyId
If the structure is being controlled, then _controlStategyId contains the ID of the active control strategy
(Inherited from Structure.)
Protected field_downstreamWaterLevel
Downstream water level, as set by SetWaterLevels(Double, Double) Unit: [m]
(Inherited from Structure.)
Protected field_dqdhDownstream
The derivative of flow through the structure with downstream water level. The flow is calculated in the derived classes when the SetWaterLevels method is called. Unit: [m2/sec]
(Inherited from Structure.)
Protected field_dqdhUpstream
The derivative of flow through the structure with upstream water level. The flow is calculated in the derived classes when the SetWaterLevels method is called. Unit: [m2/sec]
(Inherited from Structure.)
Protected field_flowArea
Flow area through structure. Used by most (but not all) structures.
(Inherited from Structure.)
Protected field_flowDir
FlowDir is used to determine which parameters to use for the flow calculations. Derived by the SetWaterLevels(Double, Double).
(Inherited from Structure.)
Public field_gridSizeDownStream
Public field_gridSizeUpStream
Protected field_id
Identification name of the structure
(Inherited from Structure.)
Protected field_implicit
If _implicit == false, then the derivatives are always zero. Default value: true.
(Inherited from Structure.)
Protected field_location
Location in the network
(Inherited from Structure.)
Protected field_offers
List of quantities that are offered
(Inherited from Structure.)
Protected field_q
Flow through the structure. The flow is calculated in the derived classes when the SetWaterLevels method is called. Unit: [m3/sec]
(Inherited from Structure.)
Protected field_rowHeader (Inherited from BridgeTabulated.)
Protected field_runTimeDiagnostics
Diagnostics are written into this Diagnostics during calculations. Set during Initialize(IDiagnostics)
(Inherited from Structure.)
Protected field_table (Inherited from BridgeTabulated.)
Protected field_topoID
Identification used to find referenced cross sections
(Inherited from Structure.)
Protected field_upstreamWaterLevel
Upstream water level, as set by SetWaterLevels(Double, Double) Unit: [m]
(Inherited from Structure.)
Protected field_waterLevelDatum (Inherited from BridgeTabulated.)
Top
Extension Methods
  NameDescription
Public Extension MethodGetter

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.)
Public Extension MethodGetters
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.)
Public Extension MethodGettersFraction
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.)
Public Extension MethodGetterUnboxed

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.)
Public Extension MethodInitialize(CrossSectionData, Boolean, IDiagnostics)Overloaded.
Helper function for some unit tests. Do not use.
(Defined by StructureExtensions.)
Public Extension MethodInitialize(BoundaryData, CrossSectionData, Boolean, IDiagnostics)Overloaded.
Helper function for some unit tests. Do not use.
(Defined by StructureExtensions.)
Public Extension MethodIsSideStructure
Returns true if the structure is a side structure
(Defined by StructureExtensions.)
Public Extension MethodSetter

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.)
Top
See Also
Inheritance Hierarchy