geowarettt

GSS plugin for Geoware TTT (Tsunami Travel Times) computation

Description

The GSS simulation plugin simgeowarettt estimates predicted tsunami travel times given an event represented by a point source (epicenter lat/lon). Its output in TOAST comprises arrival lines and times in Map view as well as T1 time (exceedance of detection threshold) in Arrivals and Forecast Zones view.

The plugin requires the commercial TTT (Tsunami Travel Times) software package developed and distributed by Geoware as backend. A file with the bathymetry has to be provided and configured.

The computation comprises several steps.

  1. First, a binary is executed which ingests the bathymetry file and produces an arrival grid (output file: result.b).

  2. Then an other binary is executed which extracts arrival times from the grid for the locations of the forecast points and the points of interest, that is buoys and tide gauges (output files: cfp.summary.txt and poi.summary.txt).

  3. Next a contouring algorithm creates arrival contours which are used for visualization by the TOAST client (output file: contours.txt).

  4. Finally, an optional external script can be configured to further process the generated output on the file system. It can be used for instance to create images or contour lines using external software like GMT (Generic mapping tools) or to copy files to other locations on the file system.

See below for more details.

Simulation guidance

The simgeowarettt plugin supports the so-called simulation guidance of TOAST: The simulation which is compatible with the current incident hypocenter is labeled Yes in the Guidance columnn in simulation details view. It is also marked with a pin in simulation icons view. Whenever the inicident source is changed or new simulations are triggered, the guidance is updated. Guidance updates are reported in the incident log.

The context menu on the simulations has the entry: Set active according guidance. Note however, that only simulations which are already present are activated, and no new simulations are triggered.

Configuration

In order to be loaded by the GSS, the simgeowarettt plugin needs to be added either in the global module configuration (global.cfg) or in the global section of the gss module (gss.cfg).

plugins = ${plugins},simgeowarettt

The configuration of simgeowarettt can be done using scconfig Modules ‣ gempa ‣ geowarettt or by editing the configuration file geowarettt.cfg.

Area of interest

The area of interest defines for which area manual and automatic simulations are returned by the simulation backend. No simulations are generated for events outside of this area. It is defined in a bna text file.

geowareTTT.areaOfInterest = @DATADIR@/simgeowarettt/rtsp.bna

Note

To show the area of interest in map view, copy or link the bna file to either of two locations:

  • $SEISCOMP_ROOT/share/bna

  • ~/.seiscomp/bna

Bathymetry

geowareTTT.bathymetry points to the bathymetry file in GMT i2(2 Byte integer) format.

Engine

geowareTTT.binaryTTT points to the Geoware ttt executable file which is used as engine for the simulation. This program computes the arrival grid in GMT format.

geowareTTT.binaryTTTPick points to the Geoware ttt_pick32 execuable which extracts the travel times for specific locations from the computed arrival grid.

Forecast points

Forecast point profiles can be registered as follows:

# Registration of a forecast point profile.
geowareTTT.forecastPoints = rtsp

For each entry of the list (comma-separated), there has to be a forecast point profile. The profile sets the filename of the forecast point file in DBF format.

# Absolute filename of the forecast point file in dBase format
geowareTTT.forecastPoints.rtsp.filename = @DATADIR@/toast/forecastzones/rtsp/6.0/cfp/CFP_Version_6p0.dbf

Post processing

The plugin supports to call a post processing script after a simulation has been computed. The script must be executable and can be configured as follows:

# Absolute filename of an executable script file that is run after a simulation
# has been completed. The script is executed in the working directory
# of the simulation.
geowarettt.postProcessingScript = @DATADIR@/simgeowarettt/scripts/script.sh

Use earthquake parameters

The plugin only uses latitude and longitude as input for the computation, and thus earthquake magnitude and depth are by default not associated with a simulation. In some uses cases, the user might want to have the association made. Set geowareTTT.useEqParams to true to do so. Note that in this case, for every different magnitude or depth a new simulation can be created.

Output

The Geoware TTT simulation plugin produces tsunami arrival times for given locations and an arrival time grid. The arrival time grid is in GMT binary format(4 byte float values).

The output directory is usually located at: ~/.seiscomp/toast/geowarettt/output. A typical simulation directory looks like this:

`-- 83
   `-- 004006S
       `-- 100102E
           `-- 83004006S100102E6543c67e7e4a0474c85e96bf11829851ee2ba6
               |-- cmd.txt
               |-- cfp.summary.txt
               |-- cfp.xy
               |-- contours.txt
               |-- maxTime.txt
               |-- poi.summary.txt
               |-- poi.xy
               |-- result.b
               |-- source.json

The first level corresponds to magnitude, the second to latitude, the third to longitude and then follows the unique simulation ID. The different file types contain the following information:

cmd.txt

contains the executed ttt commands

cfp.summary.txt

coastal forecast point arrival times file

cfp.xy

coastal forecast point file used as input for ttt_pick32

contours.txt

contains the contour lines

maxTime.txt

contains the maximum available simulation time

poi.summary.txt

POI arrival times file

poi.xy

POI file used as input for ttt_pick32

result.b

is the arrival time grid file

source.json

contains earthquake parameters, e.g., location and magnitude

Module Configuration

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

geowarettt inherits global options.

Note

Modules/plugins may require a license file. The default path to license files is @DATADIR@/licenses/ which can be overridden by global configuration of the parameter gempa.licensePath. Example:

gempa.licensePath = @CONFIGDIR@/licenses
geowarettt.areaOfInterest

Type: string

Absolute filename of the area of interest file in BNA format. If the earthquake parameters are outside of the recommended range, TOAST displays a warning in the manual simulation dialog.

geowarettt.bathymetry

Default: @DATADIR@/simgeowarettt/ttt_topo_10m.i2

Type: string

Path to Geoware TTT bathymetry file in GMT i2 format(2 byte integer).

geowarettt.binaryTTT

Default: @DATADIR@/simgeowarettt/ttt32

Type: string

Geoware TTT executable.

geowarettt.binaryTTTPick

Default: @DATADIR@/simgeowarettt/ttt_pick32

Type: string

Geoware TTT pick executable.

geowarettt.forecastPoints

Type: list:string

Registration of forecast points.

geowarettt.output

Default: @CONFIGDIR@/toast/simgeowarettt/output

Type: string

Base directory of Geoware TTT outputs.

geowarettt.postProcessingScript

Type: string

Absolute filename of an executable script file that is run after a simulation has been completed.

geowarettt.region

Default: -80,0,80,360

Unit: degree

Type: string

Limit tsunami travel time computation to a specific rectangular region. The formal definition is: lat_min,lon_min,lat_max,lon_max. Longitude has to be entered as positive number between 0 and 360.

geowarettt.useEqParams

Default: false

Type: boolean

Add earthquake magnitude and depth to the simulation meta data. These parameters have no effect on the computation, as Geoware TTT only uses latitude and longitude as input. But for some use cases it might be useful to have this information associated with the simulation. If true, for every different magnitude or depth a new simulation can be created. If false, different magnitude or depth will all result in the same simulation.

Note

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

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

Type: string

Absolute filename of the forecast point file in dBase format.