gaps¶

Gempa application server for the web

Description¶

GAPS provides a collection of Web-based client tools running in a Web browser anywhere on PCs, tablets or smartphones to interface with a SeisComP installation that operates the GAPS server. Through GAPS, operators gain insight into a remote SeisComP data acquisition and processing system and can interact with it. In full-screen mode, the modules are excellent for demonstrating the performance of the SeisComP server system in a show room.

Overview¶

When connecting to a GAPS server, the start page is shown. From there the start page the individual Web modules can be started. The start page is configurable. Customized logo images can be shown by setting the parameter apps.logoPath.

GAPS start page (full-screen mode, example from gempa’s demo website [3]).

Access of password-secured users with specific privileges can be granted. In this way authorized users can process data and commit the results to the SeisComP server system as if they were directly connected to a SeisComP system.

GAPS consists of 2 packages that should be installed for full functionality:

GAPS server (server application)
GAPS webapps (client applications)

GAPS uses maps stored as tiles [12]. High resolution maps can be imported from OpenStreetMap [4], created by the user or purchased from gempa GmbH [2]. Contact info@gempa.de by email for the details.

System requirements¶

In order to have GAPS functioning, the following modules must be configured and started:

sc2ql [11]
quakelink [5]

GAPS server¶

Installing the GAPS server creates the data directory @DATADIR@/gaps/ which includes the template files for creating the websites. This data directory will be overwritten with every new installation. For manually customizing the websites copy the data directory to another location referred to by mediaDirectory and make the desired changes in the new directory.

New installations might provide new features. Therefore, overwriting the files and directories in mediaDirectory with the newly installed data directory may be required. Make sure to safe the manual changes before and apply them thereafter again.

Webapps: client modules¶

The GAPS client modules include:

EQView (scesv [7] equivalent): earthquake locations and seismograms for configurable regions and magnitudes.
StationView (scmv [8] equivalent): quality of seismograms and peak ground motion at configured stations along with recent seismicity.
TraceView (scrttv [10] equivalent): viewing raw or filtered seismograms with phase picks for stations selectable on a maps.
OriginLocatorView (scolv [9] equivalent): interactive picking and relocating of earthquakes, commits to the SeisComP server system.

The modules can be configured individually (see section setup).

Common map properties¶

Common to the client modules are some map functions:

Zoom in / out: +/- or use mouse wheel
Pan left / right or up / down: arrow left / right or arrow up / down
Show the coordinates of the current cursor position: shift + cursor (only in EQView, StationView, OriginLocatorView)

EQView¶

EQView provides remote access to maps and the list of detected and located events as well as to a preview of the seismograms. The colors of the event circles and the size represent depth and magnitude, respectively.

Maps with user-specific regions and event profiles can be defined as widgets. These maps can be selected and viewed by clicking on the widget shown along with the currently selected map. The regions of these maps and of the events therein can be customized based on coordinates, magnitude and event time.

The widget “Latest Event” show the details for the latest event within the currently active map widget. When clicking on that widget more event details and waveforms are shown. Showing the picks of P and S phases can be activated by configuration. In addition, the map is zoom around the event. The zoom level depends on the event magnitude.

EQView - event map (full-screen mode). Map panels (right) show configured areas which can be selected and enlarged. Circles show event locations. The colors indicate source depth, size indicates magnitudes. Corresponding values are given in the legend (lower left). The overview map (upper left) shows the position of the central map.

EQView - event list (full-screen mode). Seismograms (left panel) are shown for a selected event.

StationView¶

StationView provides information on the state of sensor stations based on a mapview and text boxes. The information include quality control parameters, e.g. delay, latency, gaps, spikes and offset as well as current ground motion and PGD, PGV and PGA on 0.3 Hz high-pass filtered seismograms for the past 10 seconds and 5 minutes (in brackets). Clicking on a particular station shows the parameters in a inset figure.

The maps allow zooming in and out. They may be centered around the most recent event. For dense networks, stations are clustered and only the number is given at the center of the region. The region shown initially on the map can be customized.

StationView (full-screen mode) showing the location of stations (triangles) with measured ground motion (color), active triggers (bold red circle around station), recent earthquakes (circles) within the configured area and information for one selected station (left panel).

TraceView¶

The TracveView allows viewing of real-time data collected on the SeisComP GAPS server along with picks made on these data. The stations for which the seismograms are shown can be selected from the map of stations based on the region. The region shown initially on the map can be customized.

For showing the traces: 1. mark “Select stations” in the settings panel to the right, 2. select a region by drawing a rectangle on the map using the left mouse bottom, 3. click on “Show traces” in the settings panel to the right.

TraceView (full-screen mode) showing the stations (triangles) for which traces can be viewed as well as active detections (bold red triangles). The stations selected for showing traces are marked in yellow.

For adjusting seismogram filtering and zooming within in the trace window, select the parameters in the “Settings” panel. The panel can be accessed by moving the mouse arrow to the right edge of the TraceView window. The filter settings can be customized (see setup). Use the left mouse button to shift the seismograms in time.

Return to the map window by clicking on “Show map” in the “Settings” panel.

TraceView (full-screen mode) showing the traces for selected stations filtered in the configured frequency band.

OriginLocatorView¶

Use the OriginLocatorView for viewing and relocating of events. Users with granted permissions (see setup) working from allowed computers (see setup) can view the data and send back the results from data processing.

For example, everyone from any computer worldwide may have permission to view the data but only authorized staff may be permitted to commit the processing results such as picks and locations to the server SeisComP system.

Detailed help on the OriginLocatorView can be accessed through “Help” button on the upper right on all OriginLocatorView windows.

Individual events can be accessed by clicking on that particular event in the event list or in the event map. Access the event list and map by clicking on the list and map symbol on the upper right of the “Events” tab.

OriginLocatorView showing the list of events. The help module can be accessed through “Help” bottom on the upper right.

OriginLocatorView showing the map of events. The help module can be accessed through “Help” bottom on the upper right.

The “Locator” tab is accessed by clicking on an event in the event list or map. In the “Locator” tab the event can be relocated choosing the configured locator and locator profile. Phase picks can be selected or unselected. Clicking on “Picker” opens the picker window where existing picks of P and S phases can be reviewed and new picks can be made.

OriginLocatorView: Location tab.

The picks can be made in the picker window. The pick window can be accessed by clinking on the “Picker” button in the “Location” tab. In the picker window arrivals of P and S phases can be picked. Results are committed the the server by clicking on “OK”. For zooming and shifting the data in time, use the mouse wheel and the left mouse button on the time axis of the traces.

OriginLocatorView: picker window.

The time window parameters controlling the amount of requested data can be changed in the Setup tab. The shorter the time window the faster the data will be loaded and processed. The new parameters will be valid during the browser session. To keep the time window parameters adjust the GAPS module configuration.

OriginLocatorView: setup window.

Setup¶

The user-friendly graphical tool scconfig [6] can be used to configure GAPS. A subset of control parameters is described in this section but a complete list can be found in Configuration. More detailed help for all parameters can be found the configuration of the GAPS module in scconfig [6] (mouse-over the respective parameter).

In order to bind a station to GAPS, e.g. showing its symbol in the station view, create a GAPS binding for that station with parameter enable set to true. Stations that have not been bound to GAPS will be removed from the inventory and therefore not shown.

Access control parameters¶

The access control parameters define the privileges of users to connect to the GAPS server via the Webapps. Examples are given below.

scconfig: window for setting the access control parameters.

bind¶

Control of remote client access. Provide IP and port to bind the http server to. Use 0.0.0.0 to bind to all interfaces. Either the port or the IP address may be omitted, e.g. “0.0.0.0” or “:1234”. Leave empty to run without providing a http server.

Access only from the localhost of the server using port 8080 (default):

bind = 127.0.0.1:8080

Access only from all remote IP addresses using port 8080:

bind = 0.0.0.0:8080

sbind¶

Control of remote client access using https. See bind for the details. Port “:-1” rejects the usage of https.

users¶

Re-locating events and committing the results in the OringLocatorView is protected by username and password. Different roles can be assigned to the users.

The users allowed for remote client access and the encrypted password are provided in the users file:

users = @CONFIGDIR@/gaps/users

The users file contains the user details (name:encrpyted-password). Add one line per user e.g. for user sysop:

sysop:encrpyted-password

Create the encrypted password (encrypt-password). For encrypting the password it is recommended to apply a strong algorithm such as sha-256 or sha-512. The password encryption tool may depend on the Linux flavour.

When mkpasswd is available the command

user=sysop pw=`mkpasswd -m sha-512` && echo $user:$pw;

generates a line for e.g. user “sysop”.

Alternatively use, e.g. on CentOS:

python -c 'import crypt,getpass; print(getpass.getpass("Name: ")+":"+crypt.crypt(getpass.getpass(),crypt.mksalt(crypt.METHOD_SHA512)))'

userProperties¶

Different user properties can be assigned to the users. Currently, two properties, “staff” and “guest”, are interpreted by GAPS:

staff: Provides full access in the OriginLocatorView to relocating events and committing the results to the SeisComP system.
guest: Provides limited access in the OriginLocatorView. Only relocating events is allowed but committing the results is prohibited.

The properties are provided in a file, e.g.:

userProperties = @CONFIGDIR@/gaps/access

Each line contains the user name and a list of properties in format “username:prop1,prop2,prop3”. Those properties are used to grant access to specific functionalities in GAPS such as sending processing results back.

Example of the file @CONFIGDIR@/gaps/access for users sysop, user1 and user2 (one line per user):

sysop:staff
user1:staff
user2:guest

mediaDirectory¶

Location of media and web template files, e.g.:

@DATADIR@/gaps/apps

quakelink¶

QuakeLink request URI. Used as a default for all web applications. e.g.:

quakelink = http://your_server:18080/events/query

quakelinkProxy¶

The QuakeLink proxy connection initiated by GAPS to convert and forward single events from QuakeLink to the the browser, e.g.:

quakelinkProxy = ql://your_server:18010

The paramters quakelink and quakelinkProxy need to point to the same server address. Compare with the settings in sc2ql [11].

tileDB¶

MBTiles tile database if gaps should serve tiles itself. Leave empty if mapURI is configured with a remote tile server.

tileDB = @DATADIR@/gaps/zoom12.mbtiles

SSL¶

Variables are set if SSL is used.

Maps¶

The location of maps stored as tiles [12] as well as the zoom levels can be configured. Maps from OpenStreetMap [4] or generated by the user can be included. High resolution maps can also be purchased from gempa GmbH [2]. Contact gempa.de for the details.

Set the parameter apps.logoPath to show customized logo images.

scconfig: window for setting the map parameters.

apps.mapURI¶

Full URI for tiles. The tile server URL for all applications. Provide start values for zoom level {z}, latitude {y} and longitude {x}, e.g.:

locally stored maps:

apps.mapURI = "../tiles/{z}/{y}/{x}"

a remote server

apps.mapURI = "http://example.com:8080/tiles/{z}/{x}/{y}"

or OpenStreetMap server

apps.mapURI = "http://tile.openstreetmap.org/{z}/{x}/{y}.png"

Note

OpenStreetMap and probably other tile server expect the tile indexes as z, x, y whereas the built-in gaps tile server expects z, y, x.

apps.mapMaxLevel¶

Maximum zoom number for which the tiles source has available. The tiles on all zoom levels higher than apps.mapMaxLevel will be loaded at apps.mapMaxLevel level and auto-scaled.

apps.mapMaxZoom¶

Maximum allowed zoom level in the interactive map. The default value is 10. Set to higher value for increased zooming if provided by the maps server.

apps.mapRegion¶

For StationView and TraceView the region of the initially shown maps can be configured:

# The minimum latitude of the region.
apps.mapRegion.minimumLatitude = -90

# The minimum longitude of the region.
apps.mapRegion.minimumLongitude = -225

# The maximum latitude of the region.
apps.mapRegion.maximumLatitude = 90

# The maximum longitude of the region.
apps.mapRegion.maximumLongitude = 225

EQView¶

Widgets in the EQView can be configured allowing specific focusing on source regions and earthquakes therein with that exceed a given magnitude threshold.

scconfig: window for setting the EQView widget control parameters.

Set the parameter apps.logoPath to show customized logo images.

eqview.widgets¶

Controls which of the defined widgets profiles are shown, e.g.:

apps.eqview.widgets = world, europe, chile, indonesia

widget¶

Properties of all widgets profiles defined in eqview.widgets.

Add one profile block per profile.

Example for widget profile europe, where all event with magnitudes greater than 2 are shown for Europe.

# The widget title as it appears in the widgets titlebar.
apps.eqview.widget.europe.title = Europe

# The minimum latitude of the region.
apps.eqview.widget.europe.minimumLatitude = 20

# The minimum longitude of the region.
apps.eqview.widget.europe.minimumLongitude = -20

# The maximum latitude of the region.
apps.eqview.widget.europe.maximumLatitude = 60

# The maximum longitude of the region.
apps.eqview.widget.europe.maximumLongitude = 40.0

# The time span to be shown in hours.
apps.eqview.widget.europe.timeSpan = 120

# The minimum magnitude to be shown.
apps.eqview.widget.europe.minimumMagnitude = 2.0

StationView¶

Provide gaps_mapregion to customize the region shown initially on the map. Set the parameter apps.logoPath to show customized logo images.

TraceView¶

Filters used in TraceView can be configured. See the section Filter grammar [1] for details on the possible filters in SeisComP.

_images/gaps_gempa_scconfig_olv_trace.png

scconfig: window for setting the control parameters for OriginLocatorView and TraceView.

filters¶

List of filters that are available in TraceView in the from “description;filter_chain”,”…”,…

apps.traceview.filters = "0.7Hz - 2Hz;RMHP(10)>>BW_HLP(4,0.7,2.0)","4Hz - 8Hz;RMHP(10)>>BW_HLP(4,4,8)"

OriginLocatorView¶

Configurable:

The number of days before present for which events are initially shown in the event list
Filters available before picking
Seismic phases for which the theoretical arrival times are shown on the traces.

See the figure and filters in Trace View for details.

References¶

[1]	Filters in SeisComP: https://docs.gempa.de/seiscomp/4/current/base/filter-grammar.html

[2]	(1, 2) gempa GmbH: https://gempa.de

[3]	gempa’s demo website: https://demo.gempa.de

[4]	(1, 2) OpenStreetMap: http://www.openstreetmap.org

[5]	QuakeLink: https://docs.gempa.de/quakelink/current/

[6]	(1, 2) scconfig: https://docs.gempa.de/seiscomp/4/current/apps/scconfig.html

[7]	scesv: https://docs.gempa.de/seiscomp/4/current/apps/scesv.html

[8]	scmv: https://docs.gempa.de/seiscomp/4/current/apps/scmv.html

[9]	scolv: https://docs.gempa.de/seiscomp/4/current/apps/scolv.html

[10]	scrttv: https://docs.gempa.de/seiscomp/4/current/apps/scrttv.html

[11]	(1, 2) sc2ql: https://docs.gempa.de/quakelink/current/apps/sc2ql.html

[12]	(1, 2) Tiles: http://wiki.openstreetmap.org/wiki/Tiles

Configuration¶

etc/defaults/global.cfg
etc/defaults/gaps.cfg
etc/global.cfg
etc/gaps.cfg
~/.seiscomp3/global.cfg
~/.seiscomp3/gaps.cfg

gaps inherits global options.

authbind¶

Type: boolean

Allow bind sockets to privileged ports. Default is false.

bind¶

Type: host-with-port

IP and port to bind the http server to. Use 0.0.0.0 to bind to all interfaces. Either the port or the IP address may be omitted, e.g. “0.0.0.0” or “:1234”. If set to an empty string the application will run without providing a http server. Default is 127.0.0.1:8080.

sbind¶

Type: host-with-port

IP and port to bind the https server to. Use 0.0.0.0 to bind to all interfaces. Either the port or the IP address may be omitted, e.g. “0.0.0.0” or “:1234”. If set to an empty string the application will run without providing a https server. Default is 127.0.0.1:-1.

users¶

Type: file

Defines the users file for access control. The user file contains one line per user where each line is of format “username:encrypted_pwd”. The encrypt a password mkpasswd can be used. It is recommended to apply a strong algorithm such as sha-256 or sha-512. The command “user=sysop pw=`mkpasswd -m sha-512` && echo $user:$pw” would generate a line for e.g. user “sysop”. Default is @CONFIGDIR@/gaps/users.

userProperties¶

Type: file

Defines the file used to read user properties. Each line contains the user name and a list of properties in format “username:prop1,prop2,prop3”. Those properties are used to grant access to certain functionalities in gaps such as sending processing results back. There is currently only one property which is interpreted by gaps: “staff”. Default is @CONFIGDIR@/gaps/access.

accessLog¶

Type: boolean

Enables HTTP access logging to @LOGDIR@/gaps-http-access. Logfiles are created for 24h and kept for 7 days using log rotation. Default is false.

indexTemplate¶

Type: string

Path to the template that generated index.html. Default is @DATADIR@/gaps/index.cs.

mediaDirectory¶

Type: string

Path to media files (index.html, .css, .js, .png, …) served by GAPS. Default is @DATADIR@/gaps/apps.

bufferSize¶

Type: int

Unit: b

Minimum buffer size in bytes per acquisition threads. Default is 65536.

maximumThreads¶

Type: int

Maximum number of acquisition threads. This corresponds to the maximum number of parallel acquisition requests from clients. Default is 10.

requestTimeout¶

Type: int

Unit: s

Thread request timeout. If data of a thread has not been requested for more than n seconds the thread will be closed and finished. Default is 10.

forceHTTP¶

Type: boolean

Disables usage of Websockets protocol. Useful, if traffic is tunneled through a Webserver that cannot handle Websockets. Default is false.

quakelink¶

Type: string

The QuakeLink event request URI. This is used as a default for all web applications. Default is http://localhost:18080/events/query.

quakelinkProxy¶

Type: string

The QuakeLink proxy connection initiated by GAPS to convert and forward single events from QuakeLink to the the browser. Required since Quakelink delivers only XML format but JSON format is needed. Default is ql://localhost:18010.

tileDB¶

Type: path

Configured the MBTiles tile database if gaps should serve tiles itself. If mapURI is configured with a remote tile server, this is not required.

SSL.certificate¶

Type: string

Path to SSL certificate file

SSL.key¶

Type: string

Path to SSL private key file

map.location¶

Type: path

Alternative configuration parameter for @tileDB. Default is @DATADIR@/gaps/zoom12.mbtiles.

map.geoFeaturePath¶

Type: path

Alternative path to geo features displayed on the map. The default paths are ~/.seiscomp/bna and $SEISCOMP_ROOT/share/bna. To consider a BNA file for map display the corresponding configuration file (either map.cfg or gaps.cfg) in the respective bna directory or sub-directory must contain “apps.gaps=true”.

Note

apps.* Configuration of available web applications.

apps.mapURI¶

Type: string

Full URL for tiles, e.g.”http://example.com:8080/tiles/{z}/{y}/{x}”. The tile server URL for all applications. Default is ../tiles/{z}/{y}/{x}.

apps.mapMaxLevel¶

Type: int

Maximum zoom number for which the tiles source has available. The tiles on all zoom levels higher than mapMaxLevel will be loaded from mapMaxLevel level and auto-scaled. Default is 10.

apps.mapMaxZoom¶

Type: int

Maximum allowed zoom level in the interactive map. Default is 14.

apps.serverAPI¶

Type: string

Path of the server API for all applications. This parameter can be overridden in each application. Default is ../.

apps.serverWSAPI¶

Type: string

Path of the server websocket API for all applications. If not explicitely configured then the serverAPI path will be used.

apps.logoPath¶

Type: string

Relative path to a logo (brand) image shown in web applications such as eqview and mapview/stationview. Give path relative to SEISCOMP_ROOT/share/gaps/apps. The image is scaled to the field dimension 157px x 38px preserving the aspect ratio. Default is share/images/gempa_logo.svg.

apps.colorEventsByAge¶

Type: boolean

Whether to derive event symol colors from event depth or from event age with respect to current time. Default is false.

apps.colorEventsUpdateInterval¶

Type: int

Unit: s

If event symbol colors are derived from the event age then the age must be recomputed at a certain interval. This number defines the interval in seconds to update the event colors. The lower the interval the more often the colors must be updated which can decrease performance. Default is 60.

Note

apps.mapRegion.* Configures the initial region to be shown e.g. in traceview and station view.

apps.mapRegion.minimumLatitude¶

Type: double

Unit: deg

The minimum latitude of the region. Default is -90.

apps.mapRegion.minimumLongitude¶

Type: double

Unit: deg

The minimum longitude of the region. Default is -225.

apps.mapRegion.maximumLatitude¶

Type: double

Unit: deg

The maximum latitude of the region. Default is 90.

apps.mapRegion.maximumLongitude¶

Type: double

Unit: deg

The maximum longitude of the region. Default is 225.

apps.eqview.showRegionBounds¶

Type: boolean

Shows the selected widgets region rect in the central map. Default is false.

apps.eqview.showWaveSpreading¶

Type: boolean

Shows the spreading of P/S wave in the center-widget. Default is false.

apps.eqview.useUTC¶

Type: boolean

Show UTC time in the frontend. Default is false.

apps.eqview.externalData¶

Type: boolean

If enabled then all waveforms of an event will be requested even if stations are not part of the local inventory. If disabled then only stations are allowed that are configured locally with bindings. Default is true.

apps.eqview.nearestCityMinPopulation¶

Type: int

The minimum population of a city to be taken into account as nearest city to an event. Default is 100000.

apps.eqview.nearestCityMaxDistance¶

Type: double

Unit: deg

The maximum distance of the nearest city from an event. Default is 20.

apps.eqview.showLatestMainEvent¶

Type: boolean

Whether to show the latest event in the top left corner of the widget which is currently active as main widget. Default is true.

apps.eqview.showLatestOverallEvent¶

Type: boolean

Whether to show the latest overall event of all widgets. It will be shown in the top right corner above the widgets. Default is false.

apps.eqview.overallTimeSpan¶

Type: integer

Unit: hours

The time span for which the latest overall event will be selected. Default is false.

apps.eqview.widgets¶

Type: string

Defines the available widgets. The first widget listed is taken as primary widget. Default is world.

Note

apps.eqview.referencePlace.* Defines a reference place / city which is used to compute the distance and azimuth from the event shown in the event details.

apps.eqview.referencePlace.name¶

Type: string

The name of the place.

apps.eqview.referencePlace.lat¶

Type: double

Unit: deg

The latitude of the reference place.

apps.eqview.referencePlace.lon¶

Type: double

Unit: deg

The longitude of the reference place.

Note

apps.eqview.widget.* The configured widgets.

Note

apps.eqview.widget.$name.* $name is a placeholder for the name to be used.

apps.eqview.widget.$name.title¶

Type: string

The widget title as it appears in the widgets titlebar.

apps.eqview.widget.$name.minimumLatitude¶

Type: double

Unit: deg

The minimum latitude of the region.

apps.eqview.widget.$name.minimumLongitude¶

Type: double

Unit: deg

The minimum longitude of the region.

apps.eqview.widget.$name.maximumLatitude¶

Type: double

Unit: deg

The maximum latitude of the region.

apps.eqview.widget.$name.maximumLongitude¶

Type: double

Unit: deg

The maximum longitude of the region.

apps.eqview.widget.$name.timeSpan¶

Type: integer

Unit: hours

The time span to be shown in hours.

apps.eqview.widget.$name.minimumMagnitude¶

Type: double

The minimum magnitude to be shown.

apps.eqview.widget.$name.status¶

Type: list:string

Event status code list that is accepted. Each item is a character (A,M,…) that maps to the type code in the QuakeLink summary format. To exclude types, a minus can be prepended to each code, e.g. “-X”. That would accept all solutions except rejected. An empty list accepts everything.

apps.eqview.widget.$name.tracePreOffset¶

Type: double

Unit: min

The pre-offset of the traces with respect to the onset. Default is 2.0.

apps.eqview.widget.$name.tracePostOffset¶

Type: double

Unit: min

The post-offset of the traces with respect to the onset. Default is 5.0.

apps.eqview.widget.$name.alignOnPredicatedArrivals¶

Type: boolean

Configures whether traces are aligned on first picked onset or on theoretical arrivals. Default is false.

apps.eqview.widget.$name.showPicks¶

Type: boolean

Configures if picks are shown in the waveforms. Default is false.

apps.eqview.widget.$name.visualFeedback¶

Type: boolean

Whether to give visual feedback if a new event has been set as latest in the widget. If enabled then the widget shakes for a short time when the latest event updates. Default is false.

apps.eqview.widget.$name.audioFilePath¶

Type: path

Path to an audio file played when adding a new event to the widget. The audio file is played when the event is the most recent one. For older events the audio alert is not played. Give path relative to $SEISCOMP_ROOT/share/gaps/apps, e.g. share/audio/alert.mp3. Preferred format: mp3.

apps.traceview.filters¶

Type: list:string

The list of filters available in traceview, format per item is “name;filter-string”. Default is "0.7Hz - 2Hz;RMHP(10)>>BW_HLP(4,0.7,2.0)","1Hz - 3Hz;RMHP(10)>>BW_HLP(4,1,3)","2Hz - 4Hz;RMHP(10)>>BW_HLP(4,2,4)","4Hz - 8Hz;RMHP(10)>>BW_HLP(4,4,8)".

apps.traceview.forceHTTP¶

Type: boolean

Forces to use HTTP protocol instead of Websockets for trace transport. This can be important when tunneling GAPS through Apache where Websockets are not well supported. Default is false.

apps.traceview.timeSpan¶

Type: double

Unit: s

Timespan for trace display. The default is 10min. Default is 600.

apps.mapview.mode¶

Type: string

Defines the default mapview mode that is used to color the station symbols. Valid values are “delay”, “latency” and “groundmotion”. Default is delay.

apps.mapview.cluster¶

Type: boolean

Defines whether the station symbols should be clustered by default or not. Default is true.

apps.mapview.customStationLink¶

Type: string

Defines an additional link that is rendered on the station detail page. It supports two placeholders: ${net} and ${sta} which are replaced during runtime.

apps.mapview.customStationLinkName¶

Type: string

The name as displayed on the station panel for the custom station link.

apps.mapview.fetchGeoIP¶

Type: boolean

If enabled then the map will be centered around the clients geo location (fetched via web service from www.geoplugin.net). Default is false.

apps.scolv.loadEventDB¶

Type: double

Unit: days

Number of days to preload if scolv is started. Default is 1.

apps.scolv.useUTC¶

Type: boolean

Show UTC time in the frontend. Default is true.

apps.scolv.distInKM¶

Type: boolean

Show distances in km instead of degree. Default is false.

apps.scolv.ttt¶

Type: list:string

The list of active travel time table interfaces. Default is libtau, LOCSAT.

apps.scolv.picker.filters¶

Type: list:string

List of filters available in the picker. If @ is prepended to the name of the filter it will be selected as default filter. The format of each entry is “name;definition”, e.g. “BP 0.7 - 2 Hz 3rd order;BW(3,0.7,2)”

apps.scolv.picker.phases¶

Type: list:string

List of phases enabled for picking. Default is P,Pn,Pg,pP,S,Sg,sP.

apps.scolv.picker.preOffset¶

Type: double

Unit: s

Begin of time window before origin time to load waveforms when the picker is opened. Default is 300.

apps.scolv.picker.postOffset¶

Type: double

Unit: s

End of time window after origin time to load waveforms when the picker is opened. Default is 600.

apps.scolv.picker.preAlign¶

Type: double

Unit: s

The default time window shown before the trace alignment. Alignment is set interactively by origin time or P- or S-phase arrival. Default is 30.

apps.scolv.picker.postAlign¶

Type: double

Unit: s

The default time window shown after the trace alignment. Alignment is set interactively by origin time or P- or S-phase arrival. Default is 90.

Note

apps.scolv.ttt.* Travel time table related configuration. Travel time tables can be added via plugins. Built-in interfaces are libtau and LOCSAT. For each activated interface a list of supported models must be provided.

Note

apps.scolv.ttt.$name.* $name is a placeholder for the name to be used.

apps.scolv.ttt.$name.models¶

Type: list:string

The list of supported model names per interface.

Bindings¶

Configuration¶

enable¶

Type: boolean

Enables/disables usage of station with webapps. Default is true.

Command-line¶

Generic¶

-h, --help¶: show help message.

-V, --version¶: show version information

--config-file arg¶: Use alternative configuration file. When this option is used the loading of all stages is disabled. Only the given configuration file is parsed and used. To use another name for the configuration create a symbolic link of the application or copy it, eg scautopick -> scautopick2.

--plugins arg¶: Load given plugins.

-D, --daemon¶: Run as daemon. This means the application will fork itself and doesn’t need to be started with &.

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.

Messaging¶

-u, --user arg¶: Overrides configuration parameter connection.username.

-H, --host arg¶: Overrides configuration parameter connection.server.

-t, --timeout arg¶: Overrides configuration parameter connection.timeout.

-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.

--encoding arg¶: Overrides configuration parameter connection.encoding.

--start-stop-msg arg¶: Sets sending of a start- and a stop message.

Mode¶

--offline¶: Do not connect to a messaging server. The database connection must be provided explicitely.