toast

Software for tsunami simulation and verification.

Configuration

etc/defaults/global.cfg
etc/defaults/toast.cfg
etc/global.cfg
etc/toast.cfg
~/.seiscomp/global.cfg
~/.seiscomp/toast.cfg

toast inherits global options.

forecastZones

Type: list:string

Registration of forecast zones.

incidentMinimumMagnitude

Type: double

Minimum magnitude to take events received from messaging into account. If the magnitude of an event is below the value TOAST creates no incident. Default is 0.0.

isoInterval

Type: int

Unit: min

Interval for arrival lines (has to be provided by simulation backend). TOAST displays the arrival lines as follows: full hour: solid line, half hour: dashed line, otherwise: dotted line. Default is 30.

liveTabs

Type: list:string

Registration of live tabs.

runupPercentiles

Type: list:string

Registration of runup percentiles. The first element of the list defines the initial sort order. Default is median.

output

Type: string

Directory path where the scenario repository is kept. Note, this directory does not contain any simulation specific data files. Default is ~/.seiscomp/toast/output.

processAutoMT

Type: boolean

Enables/disables the usage of automatically generated moment tensors for event processing. By default only manual confirmed moment tensors will be taken into account. Default is false.

sourceRegions

Type: list:string

Usually more than one grid file is avaibable for the same earthquake location and the automatic system does not know which one to choose. Use this option to define which bathymetry grid should used for automatic processing(Strg + N).

Registration of source regions. Each entry maps one or more regions to a bathymetry file. The entries are evaluated in FIFO order. If none of the entries matches the algorithm tries to select a fallback grid.

alwaysShowAdditionalOptions

Type: boolean

Always show “Execute with additional options” dialog before running templates. If “false”, then only after long click and selection. Default is false.

confirmationRequired

Type: boolean

Show “Additional confirmation required” dialog before running templates, or more precisely: before executing ClearSilver functions “save” and “addScript” in the templates. Default is true.

startRegion

Type: list:double

Shows the rectangular region on the central map at the start of TOAST. Define the rectangle with a list of 4 values: latmin, lonmin, latmax, lonmax.

Note

filter.incidents.$name.* $name is a placeholder for the name to be used.

filter.incidents.$name.magnitude

Type: float

Minimum magnitude. Default is 0.0.

filter.incidents.$name.depth

Type: float

Unit: km

Maxmimum depth. Default is 6500.

filter.incidents.$name.timeSpan

Type: int

Unit: s

Show incidents not older than “timeSpan” seconds. Default is -1.

filter.incidents.$name.simulationCount

Type: boolean

If set to true only incidents with simulations will be shown, if set to false vice versa. Default is false.

filter.incidents.$name.observationCount

Type: boolean

If set to true only incidents with picks will be shown, if set to false vice versa. Default is false.

Note

filter.simulations.$name.* $name is a placeholder for the name to be used.

filter.simulations.$name.simulation

Type: list:string

Show only simulations of these simulation backends.

filter.simulations.$name.sortColumn

Type: string

Sort table by this column. Default is Residual.

filter.simulations.$name.descendingOrder

Type: boolean

Sort table descending (true) or ascending (false). Default is true.

filter.simulations.$name.maxNumberOfSims

Type: int

Limit the number of shown simulations. Default is -1.

filter.simulations.$name.calculationDuration

Type: int

Unit: min

Show simulations with a calculation duration of at least that time. Default is -1.

filter.simulations.$name.trigger

Type: string

Show simulations with that trigger type. Three possible options: show only manually triggered simulations (manual), only automatically triggered simulations (automatic) or simulations of both types (all). Default is all.

Note

forecastZones.$name.* $name is a placeholder for the name to be used and needs to be added to forecastZones to become active.

forecastZones = a,b
forecastZones.a.value1 = ...
forecastZones.b.value1 = ...
# c is not active because it has not been added
# to the list of forecastZones
forecastZones.c.value1 = ...
forecastZones.$name.filename

Type: string

Absolute filename without file extension

forecastZones.$name.whitelist.country

Type: list:string

List of countries to include when loading forecast zones.

forecastZones.$name.whitelist.exBoxID

Type: list:int

List of ExBoxIDs to include when loading forecast zones.

forecastZones.$name.blacklist.country

Type: list:string

List of countries to exclude when loading forecast zones.

forecastZones.$name.blacklist.exBoxID

Type: list:int

List of ExBoxIDs to exclude when loading forecast zones.

gnss.arrowHeadLength

Type: int

Unit: px

Length of the arrow head. Default is 12.

gnss.arrowHeadWidth

Type: int

Unit: px

Width of the arrow head. Default is 8.

gnss.arrowLineWidth

Type: int

Unit: px

Width of the arrow line. Default is 2.

gnss.maxVisibleLength

Type: int

Unit: px

Length of the largest visible displacement arrow if screenDependingScaling is ‘true’. Default is 300.

gnss.maxVisibleLengthVertical

Type: int

Unit: px

Length of the largest visible vertical displacement arrow if screenDependingScaling is ‘true’. Default is 200.

gnss.minThreshold

Type: int

Unit: mm

Only arrows with a length larger than minThreshold are visible. Default is 0.

gnss.scale

Type: int

Scaling factor for the arrows if screenDependingScaling is ‘false’. Default is 20.

gnss.scaleVertical

Type: int

Vertical scaling factor for the arrows if screenDependingScaling is ‘false’. Default is 20.

gnss.screenDependingScaling

Type: boolean

If ‘true’, then the largest visible arrow is scaled to maxVisibleLength. If ‘false’, then the length of the arrows is fix with respect to the map and changes with zoom level. Default is true.

gnss.verticalScalingEnabled

Type: boolean

If ‘true’, then the scaling of the vertical displacement arrows is independent of the scaling of the horizontal arrows. Default is false.

Note

liveTab.$name.* $name is a placeholder for the name to be used and needs to be added to liveTabs to become active.

liveTabs = a,b
liveTab.a.value1 = ...
liveTab.b.value1 = ...
# c is not active because it has not been added
# to the list of liveTabs
liveTab.c.value1 = ...
liveTab.$name.title

Type: string

Title of the tab

liveTab.$name.templ

Type: list:string

List of registered templates associated with this live tab. The sort order in the view follows the order here.

liveTab.$name.buttonText

Type: string

Text of the disseminate button Default is Disseminate.

matching.magnitude.variance

Type: double

Maximum magnitude variance. The matching options control whether a new simulation (scenario) is actually generated. It is not generated if a simulation already exists for which magnitude, depth, location and fault plane all are within the configured variance with respect to the new simulation. Default is 0.1.

matching.depth.variance

Type: double

Unit: km

Maximum depth variance. For more information see the config option matching.magnitude.variance. Default is 30.0.

matching.location.variance

Type: double

Unit: degree

Maximum location variance. For more information see the config option matching.magnitude.variance. Default is 0.1.

matching.faultPlane.variance

Type: double

Unit: 0, 1

Maximum fault plane orientation residual in the range [0, 1]. If set to 0, only identical fault planes are considered to match, if set to 1, fault planes are always considered to match. The residual is computed by mapping the rotation angle between fault planes from [0°, 90°] to [0, 1] using a sigmoid (angles larger than 90° are mapped to 1). For more information see the config option matching.magnitude.variance. Default is 0.15.

patches.width

Type: int

Unit: km

The patch width option is not used at this time. Default is 50.

patches.depthMode

Type: int

Mode of the automatic depth correction. The following modes are available: 0 = Off, 1 = Adjust the depth to avoid negative z-top, 2 = Abort the patch generation in case of negative z-top Default is 1.

patches.maxFootWallDist

Type: double

Unit: degree

Maximum distance between foot wall and epicenter in degree. Default is 0.5.

patches.maxHangingWallDist

Type: double

Unit: degree

Maximum distance between hanging wall and epicenter in degree. Default is 3.0.

patches.maxDip

Type: double

Unit: degree

Maximum dip in degree. Default is 80.0.

patches.maxRakeVariance

Type: double

Unit: degree

Maximum variance of the rake from 90 degree. Default is 20.0.

picker.amplitudes

Type: list:string

Predefined amplitudes. Default is OTM.

picker.bufferSize

Type: int

Unit: s

Total sea level buffer Default is 86400.

picker.detecPhase

Type: string

Phase for automatic picking. Default is OTA.

picker.filters

Type: list:string

Predefined sea level filters. Default is @Tsunami;CUTOFF(1)>>ITAPER(15000)>>BW(4,0.0002,0.002);.

picker.leadTime

Type: int

Unit: s

Time of sea level data before the current time. Default is 48200.

picker.phases

Type: list:string

Predefined phases. Default is OTA.

picker.slots

Type: list:string

Registration of slots

picker.stream.codes

Type: list:string

White list of stream code patterns. Use to filter the available streams. Default is *.*.*.*.

Note

picker.slot.$name.* $name is a placeholder for the name to be used and needs to be added to picker.slots to become active.

picker.slots = a,b
picker.slot.a.value1 = ...
picker.slot.b.value1 = ...
# c is not active because it has not been added
# to the list of picker.slots
picker.slot.c.value1 = ...
picker.slot.$name.alias

Type: string

Alternative text.

picker.slot.$name.filter

Type: string

User-defined filter.

picker.slot.$name.pen

Type: string

User-defined pen. A pen is defined by a color, a width and a style. Pen styles are: 1 - A plain line, 2 - Dashes separated by a few pixels, 3 - Dots separated by a few, 4 - Alternate dots and dashes and 5 - One dash, two dots, one dash, two dots.

picker.slot.$name.predefined

Type: boolean

Received data from acquisition are not taken into account. Default is false.

picker.slot.$name.visible

Type: boolean

Show/hide slot initially. Default is true.

picker.spectrogram.fixedMaximum

Type: double

The corresponding maximum value mapped to value 1 of spectrogram.gradient.

picker.spectrogram.fixedMinimum

Type: double

If spectrograms are painted with a fixed gradient this value defines the minimum value which is mapped to gradient value 0 of spectrogram.gradient.

picker.spectrogram.gradient

Type: list:string

Default spectrogram gradient. Value 0 is always mapped to a minimum value and 1 is mapped to a maximum (either a fixed range or the extrema of each single trace).

residuals.source.weight

Type: double

Weight of source residual for overall residual calculation. Default is 1.0.

residuals.source.gradient

Type: list:string

Gradient of source residual.

residuals.source.weights.magnitude

Type: double

Weight of magnitude for source residual calculation. Default is 1.0.

residuals.source.weights.depth

Type: double

Weight of depth for source residual calculation. Default is 1.0.

residuals.source.weights.distance

Type: double

Weight of distance to origin for source residual calculation. Default is 1.0.

residuals.momentTensor.weight

Type: double

Weight of moment tensor residual for overall residual calculation. Default is 1.0.

residuals.momentTensor.gradient

Type: list:string

Gradient of moment tensor residual.

residuals.expectedPlane.weight

Type: double

Weight of expected plane residual for overall residual calculation. Default is 1.0.

residuals.expectedPlane.gradient

Type: list:string

Gradient of expected plane residual.

residuals.tideGauge.weight

Type: double

Weight of tide gauge residual for overall residual calculation. Default is 1.0.

residuals.tideGauge.gradient

Type: list:string

Gradient of tide gauge residual.

residuals.gnss.weight

Type: double

Weight of GNSS residual for overall residual calculation. Default is 1.0.

residuals.gnss.gradient

Type: list:string

Gradient of GNSS residual.

residuals.radar.weight

Type: double

Weight of radar residual for overall residual calculation. Default is 1.0.

residuals.radar.gradient

Type: list:string

Gradient of radar residual.

rttv.acquireStreams

Type: boolean

Enables/Disables real time acquisition Default is false.

rttv.bufferSize

Type: int

Unit: s

Total sea level buffer Default is 86400.

rttv.leadTime

Type: int

Unit: s

Time of sea level data before the current time. Default is 48200.

rttv.seaLevel.filters

Type: list:string

Predefined sea level filters in the traces perspective. Default is @Tsunami;CUTOFF(1)>>ITAPER(15000)>>BW(4,0.0002,0.002);.

rttv.stream.codes

Type: list:string

White list of stream code patterns. Use to filter the available streams. Default is *.*.*.*.

rttv.stream.filter

Type: string

Set rttv stream filter.

rttv.spectrogram.fixedMaximum

Type: double

The corresponding maximum value mapped to value 1 of spectrogram.gradient.

rttv.spectrogram.fixedMinimum

Type: double

If spectrograms are painted with a fixed gradient this value defines the minimum value which is mapped to gradient value 0 of spectrogram.gradient.

rttv.spectrogram.gradient

Type: list:string

Default spectrogram gradient. Value 0 is always mapped to a minimum value and 1 is mapped to a maximum (either a fixed range or the extrema of each single trace).

Note

runupPercentiles.$name.* $name is a placeholder for the name to be used and needs to be added to runupPercentiles to become active.

runupPercentiles = a,b
runupPercentiles.a.value1 = ...
runupPercentiles.b.value1 = ...
# c is not active because it has not been added
# to the list of runupPercentiles
runupPercentiles.c.value1 = ...
runupPercentiles.$name.text

Type: string

Menu item text Default is Median.

runupPercentiles.$name.value

Type: int

Value of the runup percentile. Default is 50.

scheme.precision.traceValues

Type: int

Decimal places of the trace values Default is 2.

scheme.colors.records.eta

Type: color

Color of the ETA marker Default is FF0000.

scheme.colors.records.etm

Type: color

Color of the ETM marker Default is 0000FF.

scheme.colors.records.ot

Type: color

Color of the origin time bar Default is FF0000.

Note

sourceRegion.$name.* $name is a placeholder for the name to be used and needs to be added to sourceRegions to become active.

sourceRegions = a,b
sourceRegion.a.value1 = ...
sourceRegion.b.value1 = ...
# c is not active because it has not been added
# to the list of sourceRegions
sourceRegion.c.value1 = ...
sourceRegion.$name.aoi

Type: string

Path to BNA file.

sourceRegion.$name.name

Type: string

Name of the bathymetry file without the extension

symbol.shape

Type: list:string

Default symbol for unknown POI types. Default is ignore.

symbol.types

Type: list:string

Registration of POI types, no default configuration here. The names must match with the POI types in the acquisition and processing configuration. For instance symbol.types = buoy, tg

Note

symbol.$name.* $name is a placeholder for the name to be used and needs to be added to symbol.types to become active.

symbol.types = a,b
symbol.a.value1 = ...
symbol.b.value1 = ...
# c is not active because it has not been added
# to the list of symbol.types
symbol.c.value1 = ...
symbol.$name.shape

Type: list:string

Shape configuration for a symbol type. A shape is defined by a type, a size, a color and a border color separated by commas. Available shape types are circle, triangle, square and image. In case of an image the second parameter specifies the path including the filename. Parameters can be omitted from right to left. A sample configuration may look like: symbol.tg.shape = image, @DATADIR@/toast/icons/tg.png, ffffff

templates.types

Type: list:string

Registration of templates

Note

template.$name.* $name is a placeholder for the name to be used and needs to be added to templates.types to become active.

templates.types = a,b
template.a.value1 = ...
template.b.value1 = ...
# c is not active because it has not been added
# to the list of templates.types
template.c.value1 = ...
template.$name.aoi

Type: string

Path to a BNA file which defines one or more regions. When more than one region matches, the first one is used.

template.$name.maxMagnitude

Type: double

Upper bound of the magnitude range.

template.$name.minMagnitude

Type: double

Lower bound of the magnitude range.

template.$name.name

Type: string

Name of the template used in the GUI e.g. for the menu item

template.$name.fileName

Type: string

Path to the template including the file name.

template.$name.prerequisites.scenario

Type: boolean

Show hint if no scenario is selected Default is false.

trigger.maximumAge

Type: int

Unit: s

Maximum age of events in seconds to start a similation automatically. If the value is negative the age of an event is ignored. Default is 1800.

trigger.minimumMagnitude

Type: double

Minimum magnitude to start a similation automatically. Default is 6.0.

trigger.origin.mode

Type: string

Evalution mode of origins to trigger simulations for. Supported modes are manual and automatic. If no mode is specified no filter will be applied.

tsunami.database.type

Type: string

Defines the tsunami database backend to be used. The name corresponds to the defined name in the database plugin. Examples are: mysql, postgresql or sqlite3. Default is mysql.

tsunami.database.parameters

Type: string

The tsunami database connection parameters. This value depends on the used database backend. E.g. sqlite3 expects the path to the database file whereas MYSQL or PostgreSQL expect an URI in the format user:pwd@host/database?param1=val1&param2=val2. Default is sysop:sysop@localhost/tsunami.

tsunami.database.loadLastDays

Type: int

Unit: days

Load incidents of the last n days from database. Default is 1.

Bindings

maxGapTolerance

Type: double

Maximum gap in seconds between two records to apply linear interpolation Default is 3600.0.

spectrogram

Type: string

Min, max, periods and ranges of the spectrogramview e.g. periods_log(1000,10000,5,10)

Command Line

Generic

-h, --help

show help message.

-V, --version

show version information

--plugins arg

Load given plugins.

Database

--db-driver-list

List all supported database drivers.

-d, --database arg

The database connection string, format: service://user:pwd@host/database. “service” is the name of the database driver which can be queried with “–db-driver-list”.

--config-module arg

The configmodule to use.

--inventory-db arg

Load the inventory from the given database or file, format: [service://]location

--config-db arg

Load the configuration from the given database or file, format: [service://]location

Messaging

-u, --user arg

Overrides configuration parameter connection.username.

-H, --host arg

Overrides configuration parameter connection.server.

-g, --primary-group arg

Overrides configuration parameter connection.primaryGroup.

-S, --subscribe-group arg

A group to subscribe to. This option can be given more than once.

--start-stop-msg arg

Sets sending of a start- and a stop message.

Verbosity

--verbosity arg

Verbosity level [0..4]. 0:quiet, 1:error, 2:warning, 3:info, 4:debug

-v, --v

Increase verbosity level (may be repeated, eg. -vv)

-q, --quiet

Quiet mode: no logging output

--component arg

Limits the logging to a certain component. This option can be given more than once.

-s, --syslog

Use syslog logging back end. The output usually goes to /var/lib/messages.

-l, --lockfile arg

Path to lock file.

--console arg

Send log output to stdout.

--debug

Debug mode: –verbosity=4 –console=1

--log-file arg

Use alternative log file.