catalyst

Event-parametric catalogue evaluation GUI

Description

catalyst is an interactive catalogue-building, review, relocation and quality-control tool for seismic and infrasound events.

catalyst loads picks and origins from the database or from a SeisComP XML file, nucleates events (DBSCAN, back projection, GaMMA-lite or the scautoloc grid search), associates and relocates them, applies configurable quality-control rules to separate real events from false detections, and can derive automatic-processing parameters, for example a scanloc configuration, from the hand-curated result.

Most interactive settings - clustering, association, relocation, QC rules, aggregation - are handled in the GUI and stored in named processing profiles, not in the module configuration. The parameters below configure only the application-level behaviour that is not part of a profile.

See the introduction for an overview and the typical workflow for a walk-through.

Module Configuration

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

catalyst 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
maxOrigins

Default: 1000

Type: int

Hard cap on the number of origins a single nucleation run may create. This is a runaway guard, not a tuning parameter: if a clustering bug or a pathological parameter set starts producing origins without end, this stops it. Nucleation logs a warning when the cap bites, so a truncated run is never silent.

Set to 0 to disable the cap (no limit). Not exposed in the GUI on purpose.

minPhases

Default: 5

Type: int

Minimum number of phases an origin must have to be kept by the nucleation / smart-locate pipeline. Values below 4 are clamped to 4, since fewer than four observations cannot constrain a hypocentre and origin time.

faultPointBudget

Default: 500000

Type: int

Maximum number of vertices rendered for fault meshes in the 3D view. A budget guard for large fault models: when a loaded mesh exceeds it, the geometry is decimated so the 3D scene stays interactive. Only affects display, not any computation.

demPath

Type: directory

Directory holding the digital elevation model (GeoTIFF) tiles used to draw terrain and coastlines in the 3D hypocentre view. If unset or empty, the 3D view falls back to a flat base and the terrain layer is disabled.

cities

Type: list:string

Names of reference cities to mark on the 3D hypocentre view (a plain list, e.g. Reykjavik, Grindavik, Husavik). Each name is looked up by name in the cities XML (see citiesFile) for its coordinates; names not found are skipped with a log warning. Leave empty to show none.

citiesFile

Default: @DATADIR@/cities.xml

Type: file

SeisComP cities XML used to resolve the names listed in "cities" to coordinates. Defaults to the standard @DATADIR@/cities.xml that ships with SeisComP.

profiles

Type: list:string

Names of the processing profiles offered in the "Profile" dropdown at the top of the Catalyst window. A profile captures the full set of interactive CLUSTERING and REFINE settings (nucleation method and parameters, locator, QC rules, preference lists, aggregation, database window, …). Each name listed here must have a matching profile.$name.configFile.

defaultProfile

Type: string

Name of the profile applied at start-up, so the profile the dropdown shows is the one actually in effect. Must be one of the names in "profiles"; if unset or unknown, the first configured profile is used.

Note

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

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

Type: file

Path to the .profile settings file for this profile (key = value pairs written and read by Catalyst). SeisComP path placeholders such as @SYSTEMCONFIGDIR@, @CONFIGDIR@, @DATADIR@ and @ROOTDIR@ are resolved at runtime.

Note

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

ttt.$name.tables

Type: list:string

Travel-time table models offered for this travel-time interface (the struct name is the interface name, e.g. LOCSAT or libtau). The listed models populate the model dropdown when this interface is selected; if the key is absent, Catalyst falls back to the interface’s built-in models. Separate model names by comma.

Command-Line Options

catalyst [options] [SCML file]

Generic

-h, --help

Show help message.

-V, --version

Show version information.

--config-file file

The alternative module configuration file. When this option is used, the module configuration is only read from the given file and no other configuration stage is considered. Therefore, all configuration including the definition of plugins must be contained in that file or given along with other command-line options such as --plugins.

--plugins arg

Load given plugins.

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, e.g., -vv).

-q, --quiet

Quiet mode: no logging output.

--component arg

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

-s, --syslog

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

-l, --lockfile arg

Path to lock file.

--console arg

Send log output to stdout.

--debug

Execute in debug mode. Equivalent to --verbosity=4 --console=1 .

--trace

Execute in trace mode. Equivalent to --verbosity=4 --console=1 --print-component=1 --print-context=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.

--offline

Do not connect to the messaging bus. A database given with -d is still used (e.g. for inventory); only the live bus is disabled, so send-to-scolv and review-in-scolv are unavailable. Mirrors scolv’s offline mode.

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 config module to use.

--inventory-db arg

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

Input

-i, --input arg

Type: string

SeisComP XML (SCML) file to open on start-up. The file’s picks and origins are loaded into the working set. A single positional argument (a file path with no flag) is accepted as an equivalent to -i.