BoundaryItemPeriodic Class

Periodic boundary item implementation

Definition

Namespace: DHI.Mike1D.BoundaryModule.PeriodicItem
Assembly: DHI.Mike1D.BoundaryModule (in DHI.Mike1D.BoundaryModule.dll) Version: 24.0.0.0 (11.1.1.1111)
C#
public class BoundaryItemPeriodic : AbstractBoundaryItem, 
	IBoundaryItemPeriodic, IAdvancedBoundaryItem, IBoundaryItem, IExtensibleDataObject
Inheritance
Object    AbstractBoundaryItem    BoundaryItemPeriodic
Implements
IAdvancedBoundaryItem, IBoundaryItem, IBoundaryItemPeriodic, IExtensibleDataObject

Constructors

BoundaryItemPeriodicInitializes a new instance of the BoundaryItemPeriodic class

Properties

ApplicationBegin Start datetime of the application of the item.

If user specified values are set, remember also to set the UseApplicationInterval

Remarks

If UseApplicationInterval is false, this is set automatically during prepare phase to either
  • Globally: Simulation start time
  • Locally: Item source start time (typically timeseries file start)

(Inherited from AbstractBoundaryItem)
ApplicationEnd End datetime of the application of the item

If user specified values are set, remember also to set the UseApplicationInterval


(Inherited from AbstractBoundaryItem)
AverageValue Average value of this periodic boundary item.
EumQuantity EUM quantity of boundary item.

Used for validation and in AD also for unit conversion.


(Overrides AbstractBoundaryItemEumQuantity)
ExtensionData Holds data from an extended DataContract
Id Id of periodic boundary item
IsDryWeatherFlow Boundary items can be marked as "dry weather flow" (used in MIKE URBAN). This is used in Long Term Simulation to exclude dry weather flow from the total inflow when evaluating how to start a new LTS job (if selecting a new hot start file)

This flag has no effect on the simulation, only on LTS job evaluations.


(Inherited from AbstractBoundaryItem)
PeriodicScheduler Periodic pattern that this boundary item is using.
ScaleFactor A factor by which values are scaled. Default 1.0.

Only valid for certain item types, e.g., load/inflow types, not for types like waterlevel.


(Inherited from AbstractBoundaryItem)
SoftstartDuration Duration of softstart period. Default 0
(Inherited from AbstractBoundaryItem)
SoftstartType Type of softstart. Default none

Softstart does not make sense for all boundary types, typically only for those that otherwise can be disabled/left out of the simulation.

Softstart starttime is ApplicationBegin which if not set explicitly is either
  • Globally: Simulation start time
  • Locally: Item source start time (typically timeseries file start)

(Inherited from AbstractBoundaryItem)
SoftstartValue Softstart initial value. Default 0.0
(Inherited from AbstractBoundaryItem)
UseApplicationInterval Boolean specifying whether the application of the item is limited in time

Set this flag if user specified values of ApplicationBegin and ApplicationEnd is to be used. If this flag is not set the application begin and end time will be overwritten/controlled by the Boundary Data, set in Prepare(DateTime, DateTime, IDiagnostics) or by the individual boundary item.


(Inherited from AbstractBoundaryItem)

Methods

Create BoundaryItemPeriodic factory, creates and returns a new object. This does not have a periodicPattern assigned, so it is only partly initialized.
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)
GetAccumulatedValue

Get boundary value accumulated over the specified period.

It is the callers responsibility to check if the item is applicable at the given datetime before calling GetAccumulatedValue.

If the item is only applicable over a part of the interval, it must return the accumulated value for that part of the interval.


(Overrides AbstractBoundaryItemGetAccumulatedValue(DateTime, DateTime))
GetDeleteValue returns the delete value to this boundary
(Inherited from AbstractBoundaryItem)
GetHashCodeServes as the default hash function.
(Inherited from Object)
GetNextTransitionTime Default implementation of GetNextTransitionTime(DateTime) returning the incoming datetime as the next transition time
(Inherited from AbstractBoundaryItem)
GetTypeGets the Type of the current instance.
(Inherited from Object)
GetValue Get value for this source
(Overrides AbstractBoundaryItemGetValue(DateTime))
IsApplicable(DateTime) Checks whether the item is applicable at the given datetime.
(Inherited from AbstractBoundaryItem)
IsApplicable(DateTime, DateTime) Checks whether the item is applicable at the given time interval. It returns true also if the item covers only a part of the start-end interval
(Inherited from AbstractBoundaryItem)
MemberwiseCloneCreates a shallow copy of the current Object.
(Inherited from Object)
Prepare Prepare item for simulation.
(Overrides AbstractBoundaryItemPrepare(DateTime, DateTime, IDiagnostics))
SoftstartAccumulatedWeighting Weights the accumulatedValue with the hot-start value.
(Inherited from AbstractBoundaryItem)
SoftstartFactor Calculate the strength factor of the softstart. Uses _applicationBegin as the startup Usage: a = SoftStartFactor(t); Value = (1-a)*_softstartValue + (a)*Value;
(Inherited from AbstractBoundaryItem)
ToString Custom textual representation
(Overrides ObjectToString)
Validate Validate this
(Overrides AbstractBoundaryItemValidate)

Fields

_applicationBegin See ApplicationBegin
(Inherited from AbstractBoundaryItem)
_applicationEnd See ApplicationEnd
(Inherited from AbstractBoundaryItem)
_averageValue Average value of this periodic boundary item.
_id Id of periodic boundary item
_periodicScheduler Periodic pattern that this boundary item is using.
_scaleFactor See ScaleFactor
(Inherited from AbstractBoundaryItem)
_softstartDuration See SoftstartDuration
(Inherited from AbstractBoundaryItem)
_softstartType See SoftstartType
(Inherited from AbstractBoundaryItem)
_softstartValue See SoftstartValue
(Inherited from AbstractBoundaryItem)
_useApplicationInterval See UseApplicationInterval
(Inherited from AbstractBoundaryItem)

Extension Methods

See Also