Options
All
  • Public
  • Public/Protected
  • All
Menu

A simulation scenario.

author

"Travis Redpath"

Hierarchy

  • Scenario

Index

Constructors

constructor

Properties

Private _endTime

_endTime: DateTime

The scenario end time (required).

Private _id

_id: string

The name of the scenario. The name must be unique amongst the scenarios.

Private _startTime

_startTime: DateTime

The scenario start time (required). Must be formatted as 'YYYY-MM-DDThh:mm:ss'.

assetFiles

assetFiles: AssetReference[] = new Array<AssetReference>()

A list of assets used by this scenario. Assets will be used to end simulations early when a firefront reaches the shape.

burningConditions

burningConditions: BurningConditions[] = new Array<BurningConditions>()

A set of burning conditions.

comments

comments: string = ""

User comments about the scenario (optional).

displayInterval

displayInterval: Duration

The scenarios display interval (required).

fbpOptions

fbpOptions: FBPOptions

The FBP option values.

fgmOptions

fgmOptions: FGMOptions

The FGM option values.

fmcOptions

fmcOptions: FMCOptions

The FMC option values.

fwiOptions

fwiOptions: FWIOptions

The FWI option values.

gustingOptions

gustingOptions: GustingOptions | null = null

Options for enabling wind gusts if available in the weather stream.

ignitionInfo

ignitionInfo: IgnitionReference[] = new Array<IgnitionReference>()

A list of ignitions used by this scenario.

Protected isCopy

isCopy: boolean = false

layerInfo

layerInfo: LayerInfo[] = new Array<LayerInfo>()

A list of grids used by the scenario. The list contains an index value that defines the order of the layers.

Protected scenToCopy

scenToCopy: string = ""

The name of the scenario that will be copied.

stationStreams

stationStreams: StationStream[] = new Array<StationStream>()

stopModellingOptions

stopModellingOptions: StopModellingOptions | null = null

Conditions that will be used to end the simulation early.

vectorInfo

vectorInfo: string[] = new Array<string>()

A list of vectors used by this scenario.

vectorTargetFile

vectorTargetFile: TargetReference | null = null

A target used by this scenario to modify the vector behaviour.

windTargetFile

windTargetFile: TargetReference | null = null

A target used by this scenario to modify the wind direction.

Static Private Readonly PARAM_ASSET_REF

PARAM_ASSET_REF: "asset_ref" = "asset_ref"

Static Private Readonly PARAM_BURNINGCONDITION

PARAM_BURNINGCONDITION: "burningcondition" = "burningcondition"

Static Private Readonly PARAM_COMMENTS

PARAM_COMMENTS: "comments" = "comments"

Static Private Readonly PARAM_DISPLAY_INTERVAL

PARAM_DISPLAY_INTERVAL: "displayinterval" = "displayinterval"

Static Private Readonly PARAM_ENDTIME

PARAM_ENDTIME: "endtime" = "endtime"

Static Private Readonly PARAM_IGNITION_REF

PARAM_IGNITION_REF: "ignitionref" = "ignitionref"

Static Private Readonly PARAM_LAYER_INFO

PARAM_LAYER_INFO: "layerinfo" = "layerinfo"

Static Private Readonly PARAM_PRIMARY_STREAM

PARAM_PRIMARY_STREAM: "primarystream" = "primarystream"

Static Private Readonly PARAM_SCENARIONAME

PARAM_SCENARIONAME: "scenarioname" = "scenarioname"

Static Private Readonly PARAM_SCENARIO_BEGIN

PARAM_SCENARIO_BEGIN: "scenariostart" = "scenariostart"

Static Private Readonly PARAM_SCENARIO_END

PARAM_SCENARIO_END: "scenarioend" = "scenarioend"

Static Private Readonly PARAM_SCENARIO_TO_COPY

PARAM_SCENARIO_TO_COPY: "scenariotocopy" = "scenariotocopy"

Static Private Readonly PARAM_STARTTIME

PARAM_STARTTIME: "starttime" = "starttime"

Static Private Readonly PARAM_STREAM_REF

PARAM_STREAM_REF: "streamref" = "streamref"

Static Private Readonly PARAM_VECTOR_REF

PARAM_VECTOR_REF: "vectorref" = "vectorref"

Static Private Readonly PARAM_VECTOR_TARGET_REF

PARAM_VECTOR_TARGET_REF: "vector_target_ref" = "vector_target_ref"

Static Private Readonly PARAM_WIND_TARGET_REF

PARAM_WIND_TARGET_REF: "wind_target_ref" = "wind_target_ref"

Static Protected counter

counter: number = 0

Accessors

endTime

  • get endTime(): string
  • set endTime(value: string): void
  • Get the scenario end time as an ISO8601 string.

    deprecated

    Returns string

  • Set the scenario end time using a string. Cannot be null or empty. Must be formatted in ISO8601.

    throws

    If SocketMsg.inlineThrowOnError is set a RangeError will be thrown if value is not valid.

    deprecated

    Parameters

    • value: string

    Returns void

id

  • get id(): string
  • set id(value: string): void
  • Get the name of the scenario.

    throws

    If SocketMsg.inlineThrowOnError is set a RangeError will be thrown if value is not valid.

    Returns string

  • Set the name of the scenario. Must be unique amongst the scenario collection. Cannot be null or empty.

    throws

    If SocketMsg.inlineThrowOnError is set a RangeError will be thrown if value is not valid.

    Parameters

    • value: string

    Returns void

lEndTime

  • get lEndTime(): DateTime
  • set lEndTime(value: DateTime): void

lStartTime

  • get lStartTime(): DateTime
  • set lStartTime(value: DateTime): void

startTime

  • get startTime(): string
  • set startTime(value: string): void
  • Get the scenario start time as an ISO8601 string.

    deprecated

    Returns string

  • Set the scenario start time using a string. Cannot be null or empty. Must be formatted in ISO8601.

    throws

    If SocketMsg.inlineThrowOnError is set a RangeError will be thrown if value is not valid.

    deprecated

    Parameters

    • value: string

    Returns void

Methods

addAssetFile

  • Add an asset file to the scenario. Must already be added to the WISE object.

    Parameters

    • file: AssetFile

      The asset file to add to the scenario.

    Returns AssetReference

addBurningCondition

  • addBurningCondition(date: string | DateTime, startTime: number, endTime: number, fwiGreater: number, wsGreater: number, rhLess: number, isiGreater: number): BurningConditions
  • Parameters

    • date: string | DateTime

      The date that the condition is valid on. Must be formatted as 'YYYY-MM-DD'.

    • startTime: number

      The starting hour. Must be between 0 and 23 inclusive.

    • endTime: number

      The ending hour. Must be between 1 and 24 inclusive.

    • fwiGreater: number

      The minimum FWI value that will allow burning.

    • wsGreater: number

      The minimum wind speed that will allow burning.

    • rhLess: number

      The maximum relative humidity that will allow burning (as a percent [0-100]).

    • isiGreater: number

      The minimum ISI that will allow burning.

    Returns BurningConditions

addFuelBreakReference

  • Add a fuel breack to the scenario.

    Parameters

    • brck: FuelBreak

      The fuel break to add to the scenario.

    Returns FuelBreak

addFuelPatchReference

  • Add a fuel patch to the scenario.

    Parameters

    • patch: FuelPatch

      The fuel patch to add to the scenario.

    • index: number

      The layers index in the scenario.

    Returns LayerInfo

    LayerInfo The reference that was just added.

addGridFileReference

  • Add a grid file to the scenario.

    Parameters

    • grid: GridFile

      The grid file to add to the scenario.

    • index: number

      The layers index in the scenario.

    Returns LayerInfo

    LayerInfo The reference that was just added.

addIgnitionReference

  • Add an ignition to the scenario.

    Parameters

    • ignition: Ignition

      The ignition to add to the scenario.

    Returns IgnitionReference

addPrimaryWeatherStreamReference

  • Add the primary weather stream to the scenario.

    Parameters

    • stream: WeatherStream

      The weather stream to set as the scenario's primary stream.

    Returns StationStream

addWeatherGridReference

  • Add a weather grid to the scenario.

    Parameters

    • wthr: WeatherGrid

      The weather grid to add to the scenario.

    • index: number

      The layers index in the scenario.

    Returns LayerInfo

    LayerInfo The reference that was just added.

addWeatherPatchReference

  • Add a weather patch to the scenario.

    Parameters

    • patch: WeatherPatch

      The weather patch to add to the scenario.

    • index: number

      The layers index in the scenario.

    Returns LayerInfo

    LayerInfo The reference that was just added.

addWeatherStreamReference

  • Add a weather stream to the scenario.

    Parameters

    • stream: WeatherStream

      The weather stream to add to the scenario.

    Returns StationStream

checkValid

  • Find all errors that may exist in the scenario.

    Returns Array<ValidationError>

    A list of errors that were found.

clearFbpOptions

  • clearFbpOptions(): void
  • Clear the FBP options.

    Returns void

clearFgmOptions

  • clearFgmOptions(): void
  • Clears the FGM options.

    Returns void

clearFmcOptions

  • clearFmcOptions(): void
  • Clears the FMC options.

    Returns void

clearFwiOptions

  • clearFwiOptions(): void
  • Clear the FWI options.

    Returns void

clearProbabilisticValues

  • clearProbabilisticValues(): void
  • Clears the nudge to ignitions to perform probabilistic analyses on ignition location and start time.

    Returns void

clearVectorTargetFile

  • clearVectorTargetFile(): boolean
  • Remove the vector target file from the scenario.

    Returns boolean

clearWindTargetFile

  • clearWindTargetFile(): boolean
  • Remove the wind target file from the scenario.

    Returns boolean

getId

  • getId(): string
  • Returns string

isValid

  • isValid(): boolean
  • Checks to see if all required values have been set.

    Returns boolean

makeCopy

  • Parameters

    Returns void

removeAssetFile

  • Remove an asset file from the scenario.

    Parameters

    Returns boolean

removeBurningCondition

  • Remove a BurningConditions object from the burning conditions.

    Parameters

    Returns boolean

    A boolean indicating if the object was found and removed

removeFuelBreakReference

  • removeFuelBreakReference(brck: FuelBreak): boolean
  • Remove a FuelBreak object from the vector info.

    Parameters

    • brck: FuelBreak

      The FuelBreak object to remove

    Returns boolean

    A boolean indicating if the object was found and removed

removeIgnitionReference

  • removeIgnitionReference(ignition: Ignition): boolean
  • Remove a Ignition object from the ignition info.

    Parameters

    • ignition: Ignition

      The Ignition object to remove

    Returns boolean

    A boolean indicating if the object was found and removed

removeLayerInfo

  • Remove a layer from the layer info.

    Parameters

    Returns boolean

    A boolean indicating if the object was found and removed

removePrimaryWeatherStreamReference

  • removePrimaryWeatherStreamReference(stream: WeatherStream): boolean
  • Remove the primary WeatherStream object from the stream and station info.

    Parameters

    Returns boolean

    A boolean indicating if the object was found and removed

removeWeatherStreamReference

  • Remove a WeatherStream object from the stream and station info.

    Parameters

    Returns boolean

    A boolean indicating if the object was found and removed

setFbpOptions

  • setFbpOptions(terrainEffect: boolean, windEffect: boolean): void
  • Set the FBP options.

    Parameters

    • terrainEffect: boolean

      Use terrain effect.

    • windEffect: boolean

      Use wind effect.

    Returns void

setFgmOptions

  • setFgmOptions(maxAccTS: Duration, distRes: number, perimRes: number, minimumSpreadingRos: number, stopAtGridEnd: boolean, breaching: boolean, dynamicSpatialThreshold: boolean, spotting: boolean, purgeNonDisplayable: boolean, growthPercentileApplied: boolean, growthPercentile: number): void
  • Set the FGM options.

    Parameters

    • maxAccTS: Duration

      The maximum time step during acceleration.

    • distRes: number

      The distance resolution.

    • perimRes: number

      The perimeter resolution.

    • minimumSpreadingRos: number

      Minimum Spreading ROS.

    • stopAtGridEnd: boolean

      Whether to stop the fire spread when the simulated fire reaches the boundary of the grid data.

    • breaching: boolean

      Whether breaching is turned on or off.

    • dynamicSpatialThreshold: boolean

      Whether using the dynamic spatial threshold algorithm is turned on or off.

    • spotting: boolean

      Whether the spotting model should be activated.

    • purgeNonDisplayable: boolean

      Whether internal/hidden time steps are retained.

    • growthPercentileApplied: boolean

      Whether the growth percentile value is applied.

    • growthPercentile: number

      Growth percentile, to apply to specific fuel types.

    Returns void

setFmcOptions

  • setFmcOptions(perOverrideVal: number, nodataElev: number, terrain: boolean, accurateLocation: boolean): void
  • Set the FMC options.

    Parameters

    • perOverrideVal: number

      The value for the FMC (%) override. Use -1 for no override.

    • nodataElev: number

      The elevation where NODATA or no grid exists.

    • terrain: boolean
    • accurateLocation: boolean

      No longer used, left for compatibility.

    Returns void

setFwiOptions

  • setFwiOptions(fwiSpacInterp: boolean, fwiFromSpacWeather: boolean, historyOnEffectedFWI: boolean, burningConditionsOn: boolean, fwiTemporalInterp: boolean): void
  • Set the FWI options.

    Parameters

    • fwiSpacInterp: boolean

      Apply spatial interpolation to FWI values.

    • fwiFromSpacWeather: boolean

      Calculate FWI values from temporally interpolated weather.

    • historyOnEffectedFWI: boolean

      Apply history to FWI values affected by patches, grids, etc..

    • burningConditionsOn: boolean

      Use burning conditions.

    • fwiTemporalInterp: boolean

      Apply spatial interpolation to FWI values.

    Returns void

setName

  • setName(name: string): void
  • Set the name of the scenario. This name must be unique within the simulation. The name will get a default value when the scenario is constructed but can be overriden with this method.

    Parameters

    • name: string

    Returns void

setProbabilisticValues

  • setProbabilisticValues(dx: number, dy: number, dt: Duration): void
  • How much to nudge ignitions to perform probabilistic analyses on ignition location and start time. Primarily used when ignition information is not 100% reliable.

    Parameters

    • dx: number

      How much to nudge ignitions to perform probabilistic analyses on ignition location.

    • dy: number

      How much to nudge ignitions to perform probabilistic analyses on ignition location.

    • dt: Duration

      How much to nudge ignitions to perform probabilistic analyses on ignition location and start time.

    Returns void

setVectorTargetFile

  • Add a target file to the scenario for vector direction. Must already be added to the WISE object.

    Parameters

    • file: TargetFile

      The target file to add to the scenario.

    Returns TargetReference

setWindTargetFile

  • Add a target file to the scenario for wind direction. Must already be added to the WISE object.

    Parameters

    • file: TargetFile

      The target file to add to the scenario.

    Returns TargetReference

stream

  • stream(builder: Socket): void
  • Streams the scenario to a socket.

    Parameters

    • builder: Socket

    Returns void