Setup and configuration

Catalyst is configured in three places:

  • the module configuration catalyst.cfg, for settings that belong to the installation (database, messaging, plugins, file paths, limits),

  • processing profiles, for the processing settings of the GUI, typically one per network or region,

  • the GUI itself, where every processing setting can be changed at runtime.

The module configuration is read from @DEFAULTCONFIGDIR@/catalyst.cfg, @SYSTEMCONFIGDIR@/catalyst.cfg and @CONFIGDIR@/catalyst.cfg, in this order, as for every SeisComP module. Use scconfig or edit the files directly. All parameters are listed in the module reference.

Starting Catalyst

catalyst is a SeisComP GUI application and accepts the usual command-line options. Typical calls:

  • Work on files only, without database or messaging:

    catalyst
    

    Open an XML file with File → Open….

  • Load from the database:

    catalyst -d mysql://sysop:sysop@localhost/seiscomp
    
  • Load from the database and send results to the messaging system:

    catalyst -H localhost -d mysql://sysop:sysop@localhost/seiscomp
    

Without a messaging connection, File → Send Selection to Messaging and Review in scolv are not available.

Plugins

The origin score uses the OriginMultiFeature score processor of scevent, which is provided by the scoremf plugin. Load it and configure its parameters in catalyst.cfg:

plugins = ${plugins}, scoremf

# Which score processor to use and whose score.* configuration to read.
score.processor = OriginMultiFeature
score.configModule = scevent

score.processor and score.configModule are optional and default to the values shown. With score.configModule = scevent the score uses the same score.mf.* parameters as scevent, so Catalyst and the real-time system rank origins the same way.

If the plugin cannot be loaded, the score shows N/A. Calculate score retries and reports the reason.

Processing limits

# Minimum number of phases a located origin needs (default 5).
# Values below 4 are raised to 4.
minPhases = 5

# Upper limit on the number of origins nucleation may create, as a guard
# against runaway output. 0 = no limit.
maxOrigins = 5000

maxOrigins is not shown in the GUI on purpose.

Over-detecting stations

Picks from stations that produce many more picks than the others are weak evidence. They are used by the Clean Q metric and the isolated-pick filter. Stations are treated as over-detecting either because they are listed explicitly, or, without a list, because they have more than factor times the median number of picks per station in the loaded data.

# Explicit list: NET.STA or a plain station code.
qc.overdetection.stations = IS.HRAUN, KRA

# Automatic detection when no list is given. 0 or less switches it off.
qc.overdetection.factor = 3.0

3D view

# Reference cities shown in the 3D view. A "cities" key in the processing
# profile overrides this list.
cities = Reykjavik, Akureyri

# SeisComP cities XML used to look up their coordinates.
# Default: @DATADIR@/cities.xml
citiesFile = @DATADIR@/cities.xml

# Folder with the GEBCO elevation tiles used for topography.
demPath = /home/data/elevation

# Total number of points used to draw fault surfaces (default 500000).
faultPointBudget = 500000

Travel-time models

The TTT model list offers the tables configured for the chosen travel-time interface:

ttt.LOCSAT.tables = iasp91, sil
ttt.libtau.tables = iasp91, ak135

For LOCSAT, the profiles of the LOCSAT locator are used if ttt.LOCSAT.tables is not set.

Processing profiles

Profiles are declared in catalyst.cfg as well. See processing profiles.

profiles = iceland, ukraine
defaultProfile = iceland
profile.iceland.configFile = @SYSTEMCONFIGDIR@/iceland.profile
profile.ukraine.configFile = @SYSTEMCONFIGDIR@/ukraine.profile

Window layout

The panel layout is saved when catalyst closes and restored at the next start. View → Home (reset layout) returns to the default layout, and View → Panels shows or hides individual panels.