StructureReach Class

A structure reach is an "artificial" reach containing one structure and no volume. It the reach has a length, it is an "artificial" length.

A structure reach is used for two common scenarios: a structure in a node, and a structure between the main river and the side river (link channel).

A structure in a node is modelled by defining two nodes with a structure reach in between.

Definition

Namespace: DHI.Mike1D.NetworkDataAccess
Assembly: DHI.Mike1D.NetworkDataAccess (in DHI.Mike1D.NetworkDataAccess.dll) Version: 24.0.0.0 (11.1.1.1111)
C#
public class StructureReach : Reach, 
	IStructureReach, IReach, INetworkReach
Inheritance
Object    Reach    StructureReach
Implements
INetworkReach, IReach, IStructureReach

Constructors

StructureReachInitializes a new instance of the StructureReach class

Properties

__TopoID For backwards compatibility after fixing spelling error.
(Inherited from Reach)
Description User's descriptive information related to the link
(Inherited from Reach)
EndConnection Specifies where the reach is connected at its end point (high chainage). Must be null if not connected.
(Inherited from Reach)
IsLinkChannel A link channel is a MIKE 11 structure reach. This flag is needed because link channels do not need to have a boundary created at the downstream end.
IsPressureReach True if the reach should always be pressurized (MU special reach with slope=0 and "weir" at transition to normal reach.)
(Inherited from Reach)
IsRegulatedReach Regulate reach with a discharge structure on first q-grid point. This is used for MU setups to limit Q to a QMax(H) og QMax(dH). QMax is set by a control in the control module
(Inherited from Reach)
LocationSpan A Reach is a generalization of the link and branch concepts from sewer and river models.

Specification of connection as 'start' and 'end' does not have any impact on the computations, apart that positive flow is considered from start to end. Therefore, it is recommended to specify the start-end in the direction of predominant flows, or to set the ReverseDirection flag.

The type of the reach is specified by the cross section for that reach. It may take the form of one of the 'standard' pipes (Circular, Rectangular, O Shaped, Egg-Shaped), or any closed or open cross section shape (CRS/Natural Channels).

The LocationSpan defines the geographical position of the reach.

Typical types of reaches are the sewer link and the river branch.

A sewer link is featured by:

  • Connected in each end by specifying a node.
  • Constant cross-section geometry, and constant friction properties along the entire length.
  • It is specified as a conduit between two nodes. A link is considered as either a straight line or a drawn polyline between two nodes.
  • Usually a link connects to the adjacent nodes at their bottom levels, but it may also connect above their bottom level. This is called the invert level. The start- and the end- invert level must be specified in the first and last coordinates of the LocationSpan. Specified levels below bottom level of the connecting nodes is not valid.
  • A link is often characterised by material, which determines the Manning friction coefficient (Manning) or the Colebrook White coefficient (Equivalent roughness). The material is is as such not represented, though the friction formulation is specified in the cross section module.

A river branch is featured by:

  • Connected to other reaches by specifying a location. Nodes usually are not specified explicitly in the setup, but created on the fly when required (at all junctions).
  • Varying cross-section geometry, and varying friction properties along reach.
  • At connection points, river branches usually define cross section bottom levels that equals. However, if "free outflow" properties from a tributary branch is desired, this can be achieved by specifying a higher cross section bottom level in the tributary connection end (at least 0.5 cm difference).


(Inherited from Reach)
MaximumDx The maximal allowed distance between two points of the same type?
(Inherited from Reach)
NonReturnReach Restrict flow in the first q-grid point to be positive only. Default is false
(Inherited from Reach)
ReverseDirection Reverse the positive flow direction of the reach. Default is false
(Inherited from Reach)
StartConnection Specifies where the reach is connected at its start point (low chainage). Must be null if not connected.
(Inherited from Reach)
TopoID Id for the cross section topologi that is to be used for the Link / Branch. If TopoID is not used, set to empty string (null will be handled as the empty string).
(Inherited from Reach)

Methods

EqualsDetermines whether the specified object is equal to the current object.
(Inherited from Object)
FinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.
(Inherited from Object)
GetHashCodeServes as the default hash function.
(Inherited from Object)
GetTypeGets the Type of the current instance.
(Inherited from Object)
MemberwiseCloneCreates a shallow copy of the current Object.
(Inherited from Object)
ToString For debug purposes
(Inherited from Reach)
Validate Validate reach
(Inherited from Reach)

Fields

_endConnection End connection
(Inherited from Reach)
_locationSpan Span of reach
(Inherited from Reach)
_startConnection Start connection
(Inherited from Reach)

Extension Methods

IsStructureReach Returns true when reach is an IStructureReach
(Defined by NetworkExtensions)

See Also