1703 lines
63 KiB
XML
1703 lines
63 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<seiscomp>
|
|
<module name="global" category="System">
|
|
<description>Global parameters for all trunk applications.</description>
|
|
<configuration>
|
|
<parameter name="agencyID" type="string" default="GFZ">
|
|
<description>
|
|
Agency ID used to set creationInfo.agencyID in
|
|
data model objects. Should not contain spaces.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="datacenterID" type="string">
|
|
<description>
|
|
Datacenter ID which is primarily used by Arclink and
|
|
its tools. Should not contain spaces.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="organization" type="string" default="Unset">
|
|
<description>
|
|
Organization name used mainly by ArcLink and SeedLink.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="author" type="string" default="@appname@@@@hostname@">
|
|
<description>
|
|
Author name used to set creationInfo.author in data model
|
|
objects. @appname@ is replaced by the name of the
|
|
respective executable, @hostname@ by the name of the computer
|
|
on which it runs.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="plugins" type="list:string">
|
|
<description>
|
|
List of plugins loaded at startup. Separate multiple names by
|
|
comma. Add ${plugins} to consider all previously read values.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="cityXML" type="file" values="*.xml" options="read">
|
|
<description>
|
|
Path to the cities XML file. If undefined, the data is read
|
|
from "@CONFIGDIR@/cities.xml" or
|
|
"@DATADIR@/cities.xml".
|
|
SeisComP ships with "@DATADIR@/cities.xml".
|
|
</description>
|
|
</parameter>
|
|
<parameter name="loadCities" type="boolean">
|
|
<description>
|
|
Load cities from file configured by the "cityXML"
|
|
parameter. GUI and map applications enable loading of cities
|
|
by default considering the parameter
|
|
"scheme.map.showCities".
|
|
</description>
|
|
</parameter>
|
|
<parameter name="loadRegions" type="boolean">
|
|
<description>
|
|
Load custom FEP (Flinn-Engdahl polygon) regions from
|
|
"@CONFIGDIR@/fep/" or @DATADIR@/fep/".
|
|
GUI and map applications and scevent enable FEP regions by
|
|
default. Explicitly uncheck the option to disregard by these
|
|
applications.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="publicIDPattern" type="string" default="@classname@/@time/%Y%m%d%H%M%S.%f@.@id@">
|
|
<description>
|
|
Define a custom pattern for generation of public object IDs.
|
|
The following variables are resolved:
|
|
@classname@ (class name of object),
|
|
@id@ (public object count),
|
|
@globalid@ (general object count),
|
|
@time@ (current time, use '/' to supply custom format e.g.
|
|
@time/%FT%T.%fZ@
|
|
</description>
|
|
</parameter>
|
|
<parameter name="configModule" type="string" default="trunk">
|
|
<description>
|
|
Name of the configuration module.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="database" type="string">
|
|
<description>
|
|
Define the database connection. If no database is configured
|
|
(which is the default) and a messaging connection is available,
|
|
the application will receive the parameters after the connection
|
|
is established. Override these values only if you know what you
|
|
are doing.
|
|
|
|
The format is: service://user:pwd@host/database.
|
|
"service" is the name of the database driver which
|
|
can be queried with "--db-driver-list".
|
|
IMPORTANT: This parameter replaces former
|
|
"database.type" and "database.parameters"
|
|
which have been removed.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="recordstream" type="string">
|
|
<description>
|
|
SeisComP applications access waveform data through the RecordStream
|
|
interface. Read the SeisComP documentation for a list of
|
|
supported services and their configuration.
|
|
|
|
This parameter configures RecordStream source URL.
|
|
|
|
Format: [service://]location[#type]
|
|
|
|
"service": The name of the RecordStream implementation.
|
|
If not given, "file://" is implied.
|
|
|
|
IMPORTANT: This parameter replaces former RecordStream
|
|
configurations in "recordstream.service" and
|
|
"recordstream.source" which have been removed.
|
|
</description>
|
|
</parameter>
|
|
<group name="logging">
|
|
<description>
|
|
Control the logging of SeisComP applications. The log information
|
|
are written to log files per modules as
|
|
"@CONFIGDIR@/log/[module].log".
|
|
</description>
|
|
<parameter name="level" type="int" default="2" values="1,2,3,4">
|
|
<description>
|
|
Set the logging level between 1 and 4 where 1=ERROR,
|
|
2=WARNING, 3=INFO and 4=DEBUG.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="syslog" type="boolean" default="false">
|
|
<description>
|
|
Enable logging to syslog if supported by the host system.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="components" type="list:string">
|
|
<description>
|
|
Limit the logging to the specified list of components.
|
|
Example: 'Application, Server'.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="component" type="boolean">
|
|
<description>
|
|
For each log entry print the component right after the
|
|
log level. By default, the component output is enabled
|
|
for file output but disabled for console output.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="context" type="boolean" default="false">
|
|
<description>
|
|
For each log entry print the source file name and line
|
|
number.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="utc" type="boolean">
|
|
<description>
|
|
Use UTC instead of local time in logging timestamps.
|
|
</description>
|
|
</parameter>
|
|
<group name="file">
|
|
<parameter name="rotator" type="boolean" default="true">
|
|
<description>
|
|
Enable rotation of log files.
|
|
</description>
|
|
</parameter>
|
|
<group name="rotator">
|
|
<parameter name="timeSpan" type="int" unit="s"
|
|
default="86400">
|
|
<description>
|
|
Time span after which a log file is rotated.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="archiveSize" type="int" default="7">
|
|
<description>
|
|
The maximum number of historic log files to keep.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="maxFileSize" type="int" default="104857600" unit="byte">
|
|
<description>
|
|
The maximum size of a log file in byte. The default
|
|
value is 100 megabyte. If a log file exceeds that
|
|
size, then it is rotated. To disable the size limit
|
|
give 0 or a negative value.
|
|
</description>
|
|
</parameter>
|
|
</group>
|
|
</group>
|
|
<group name="objects">
|
|
<parameter name="timeSpan" type="int" unit="s" default="60">
|
|
<description>
|
|
Time span for counting input/output of objects.
|
|
</description>
|
|
</parameter>
|
|
</group>
|
|
<group name="syslog">
|
|
<parameter name="facility" type="string" default="local0">
|
|
<description>
|
|
Define the syslog facility to be used according to the
|
|
defined facility names in syslog.h. The default is local0.
|
|
If the given name is invalid or not available,
|
|
initializing logging will fail and the application quits.
|
|
</description>
|
|
</parameter>
|
|
</group>
|
|
</group>
|
|
<group name="connection">
|
|
<parameter name="server" type="host-with-port" default="localhost">
|
|
<description>
|
|
Define the URL of the messaging server to connect to.
|
|
URL format is [scheme://]host[:port][/queue].
|
|
Default scheme: scmp, default port: 18180,
|
|
default queue: production.
|
|
Examples:
|
|
|
|
All default: localhost
|
|
|
|
Specific host: scmp://10.0.1.4:18180/production
|
|
|
|
Specific host and SSL encryption:
|
|
scmps://10.0.1.4:18180/production
|
|
</description>
|
|
</parameter>
|
|
<parameter name="username" type="string">
|
|
<description>
|
|
Define the username to be used. The length is maybe limited
|
|
by the messaging system used. By default, the module name
|
|
(name of the executable) is used but sometimes it exceeds
|
|
the 10 character limit and access is denied. To prevent
|
|
errors set a different username. An empty username will
|
|
let the system to generate one.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="certificate" type="string">
|
|
<description>
|
|
Define the OpenSSL client certificate to be used. Path to
|
|
OpenSSL certificate in PKCS 12 format or the prefix "data:"
|
|
followed by the Base64 encoded certificate data.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="timeout" type="int" unit="s" default="3">
|
|
<description>
|
|
The connection timeout in seconds. 3 seconds are normally
|
|
more than enough. If a client needs to connect to a
|
|
remote system with a slow connection, a larger timeout
|
|
might be needed.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="primaryGroup" type="string">
|
|
<description>
|
|
Define the primary group of a module. This is the name
|
|
of the group where a module sends its messages to if the
|
|
target group is not explicitly given in the send call.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="contentType" type="string" default="binary">
|
|
<description>
|
|
Define the message encoding for sending. Allowed values
|
|
are "binary", "json" or "xml".
|
|
XML has more overhead in processing but is more robust when
|
|
schema versions between client and server are different.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="subscriptions" type="list:string">
|
|
<description>
|
|
Define a list of message groups to subscribe to. The
|
|
default is usually given by the application and does not
|
|
need to be changed.
|
|
</description>
|
|
</parameter>
|
|
</group>
|
|
<group name="database">
|
|
<description>
|
|
Define the database connection. If no database is configured
|
|
(which is the default) and a messaging connection is available,
|
|
the application will receive the parameters after the connection
|
|
is established. Override these values only if you know what you
|
|
are doing.
|
|
</description>
|
|
<parameter name="inventory" type="file" options="read" values="*.xml">
|
|
<description>
|
|
Load the inventory database from a given XML file if set.
|
|
This overrides the inventory definitions loaded from the
|
|
database backend.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="config" type="file" options="read" values="*.xml">
|
|
<description>
|
|
Load the configuration database from a given XML file if set.
|
|
This overrides the configuration definitions loaded from the
|
|
database backend.
|
|
</description>
|
|
</parameter>
|
|
</group>
|
|
<group name="processing">
|
|
<description>
|
|
Filter the objects for processing according to parameter values.
|
|
</description>
|
|
<group name="whitelist">
|
|
<parameter name="agencies" type="list:string">
|
|
<description>
|
|
Define a whitelist of agency IDs corresponding to
|
|
"agencyID" that are allowed for
|
|
processing. Objects from all other agencies will be
|
|
ignored. Separate items by comma.
|
|
</description>
|
|
</parameter>
|
|
</group>
|
|
<group name="blacklist">
|
|
<parameter name="agencies" type="list:string">
|
|
<description>
|
|
Define a blacklist of agency IDs corresponding to
|
|
"agencyID" that are not allowed for
|
|
processing. Separate items by comma.
|
|
</description>
|
|
</parameter>
|
|
</group>
|
|
</group>
|
|
<group name="inventory">
|
|
<description>
|
|
Filter the considered inventory according to parameter values.
|
|
</description>
|
|
<group name="whitelist">
|
|
<parameter name="nettype" type="list:string">
|
|
<description>
|
|
List of network types to include when loading the
|
|
inventory. All other types will be ignored. Separate
|
|
items by comma.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="statype" type="list:string">
|
|
<description>
|
|
List of station types to include when loading the
|
|
inventory. All other types will be ignored. Separate
|
|
items by comma.
|
|
</description>
|
|
</parameter>
|
|
</group>
|
|
<group name="blacklist">
|
|
<parameter name="nettype" type="list:string">
|
|
<description>
|
|
List of network types to exclude when loading the
|
|
inventory. Separate items by comma.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="statype" type="list:string">
|
|
<description>
|
|
List of station types to exclude when loading the
|
|
inventory. Separate items by comma.
|
|
</description>
|
|
</parameter>
|
|
</group>
|
|
</group>
|
|
<group name="scripts">
|
|
<parameter name="crashHandler" type="file" options="read">
|
|
<description>
|
|
Path to crash handler script.
|
|
</description>
|
|
</parameter>
|
|
</group>
|
|
<group name="core">
|
|
<parameter name="plugins" type="list:string" default="dbmysql">
|
|
<description>
|
|
Define a list of core modules loaded at startup.
|
|
</description>
|
|
</parameter>
|
|
</group>
|
|
<group name="client">
|
|
<parameter name="startStopMessage" type="boolean" default="false">
|
|
<description>
|
|
Enable sending of an application start- and stop message to
|
|
the STATUS_GROUP.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="autoShutdown" type="boolean" default="false">
|
|
<description>
|
|
Enable automatic application shutdown triggered by a status
|
|
message.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="shutdownMasterModule" type="string">
|
|
<description>
|
|
Trigger shutdown if the module name of the received messages
|
|
match.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="shutdownMasterUsername" type="string">
|
|
<description>
|
|
Trigger shutdown if the user name of the received messages
|
|
match.
|
|
</description>
|
|
</parameter>
|
|
</group>
|
|
<group name="commands">
|
|
<description>
|
|
Control the handling of command messages.
|
|
</description>
|
|
<parameter name="target" type="string">
|
|
<description>
|
|
A regular expression of all clients that should handle
|
|
a command message usually send to the GUI messaging group.
|
|
Currently this flag is only used by GUI applications to
|
|
set an artificial origin and to tell other clients to
|
|
show this origin. To let all connected clients handle the
|
|
command, ".*$" can be used.
|
|
</description>
|
|
</parameter>
|
|
</group>
|
|
<group name="ttt">
|
|
<description>
|
|
Configure interfaces to travel-time tables (travel-time
|
|
interfaces). Built-in interfaces are LOCSAT, libtau and
|
|
homogeneous. For each loaded interface the supported tables must
|
|
be provided.
|
|
</description>
|
|
<struct type="ttt profile">
|
|
<parameter name="tables" type="list:string">
|
|
<description>
|
|
The list of supported table (model) names per interface.
|
|
</description>
|
|
</parameter>
|
|
</struct>
|
|
</group>
|
|
<group name="amplitudes">
|
|
<description>
|
|
Parameters for amplitude measurements.
|
|
</description>
|
|
<parameter name="aliases" type="list:string">
|
|
<description>
|
|
Definition of amplitude aliases for deriving new amplitude
|
|
types from an existing amplitude. Separate
|
|
multiple entries by comma.
|
|
|
|
Format:
|
|
|
|
NewType:OriginalAmplitudeType
|
|
|
|
Examples for deriving an amplitude of new type ABC from MLv:
|
|
|
|
ABC:MLv
|
|
|
|
Alias amplitudes can be configured like any other amplitude
|
|
and used for any alias magnitude.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="iaspei" type="boolean" default="false">
|
|
<description>
|
|
Compute ML peak-to-trough and mb amplitudes according to
|
|
IASPEI recommendations.
|
|
|
|
For Ms(BB) amplitudes check that the dominant period of the
|
|
signal is within the valid range (3, 60). The period range
|
|
may be set in a Ms(BB) amplitude profile in global bindings.
|
|
</description>
|
|
</parameter>
|
|
<group name="ttt">
|
|
<description>
|
|
Travel time table specific parameters to be used for the
|
|
computation of travel times referred to in signal and
|
|
noise time window specifications,
|
|
e.g. "signalBegin". This can be overridden per
|
|
station in its bindings.
|
|
</description>
|
|
<parameter name="interface" type="string" default="LOCSAT" values="libtau,LOCSAT,homogeneous">
|
|
<description>
|
|
The name of the travel-time interface to use. The list
|
|
can be extended by plugins.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="model" type="string" default="iasp91">
|
|
<description>
|
|
The name of the travel-time interface (velocity) model
|
|
to use.
|
|
</description>
|
|
</parameter>
|
|
</group>
|
|
<group name="WoodAnderson">
|
|
<description>
|
|
Parameters of the Wood-Anderson seismometer response used
|
|
for instrument simulation. The default values are according
|
|
to Uhrhammer and Collins (1990) and were part of the
|
|
IASPEI Magnitude Working Group recommendations of 2011
|
|
September 9.
|
|
</description>
|
|
<parameter name="gain" type="double" default="2080">
|
|
<description>
|
|
The gain of the Wood-Anderson response.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="T0" type="double" default="0.8" unit="s">
|
|
<description>
|
|
The eigenperiod of the Wood-Anderson seismometer.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="h" type="double" default="0.7">
|
|
<description>
|
|
The damping constant of the Wood-Anderson seismometer.
|
|
</description>
|
|
</parameter>
|
|
</group>
|
|
<struct type="GlobalAmplitudeProfile" title="Amplitude-type profile" aliases="config:amplitudes.aliases">
|
|
<parameter name="regionalize" type="boolean" default="true">
|
|
<description>
|
|
Control if the amplitude calculation should be
|
|
regionalized or not. The regions and their configuration
|
|
are taken from the corresponding magnitude profiles. If
|
|
regionalization is activate, then e.g. modules without
|
|
origin information will not be able to compute an
|
|
amplitude as the origin is required to determine the
|
|
effective settings.
|
|
|
|
If amplitudes for this particular type shall be computed
|
|
regardless of any defined regions, set this parameter to
|
|
false.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="considerUnusedArrivals" type="boolean" default="false">
|
|
<description>
|
|
If enabled, then also stations with unused (disabled)
|
|
arrivals are considered for amplitude and implicitly
|
|
magnitude computations, e.g. by scamp, scmag and scolv.
|
|
</description>
|
|
</parameter>
|
|
</struct>
|
|
</group>
|
|
<group name="magnitudes">
|
|
<description>
|
|
Parameters for computing magnitudes.
|
|
Add magnitude regionalization and mapping to Mw by magnitude-type profiles.
|
|
One profile corresponds to one magnitude type.
|
|
</description>
|
|
<parameter name="aliases" type="list:string">
|
|
<description>
|
|
Definition of magnitude aliases for deriving new magnitude
|
|
types from existing magnitude and amplitude types. Separate
|
|
multiple entries by comma.
|
|
|
|
Format:
|
|
|
|
NewType:OriginalMagnitudeType[:OriginalAmplitudeType]
|
|
|
|
OriginalAmplitudeType is optional. The default amplitude
|
|
type applies if OriginalAmplitudeType is undefined.
|
|
|
|
Examples for deriving magnitude of new type ABC from MLv:
|
|
|
|
ABC:MLv:MLv
|
|
|
|
ABC:MLv
|
|
|
|
Alias magnitudes can be configured like any other magnitude
|
|
and used together with any original or alias amplitudes.
|
|
</description>
|
|
</parameter>
|
|
<struct type="GlobalMagnitudeProfile" title="Magnitude-type profile for regionalization and Mw mapping" aliases="config:magnitudes.aliases">
|
|
<description>
|
|
Regionalization of magnitude configurations overriding global
|
|
bindings. For parameters which are not set, the values
|
|
defined in bindings apply.
|
|
</description>
|
|
<parameter name="MwMapping" type="list:string">
|
|
<description>
|
|
Mw magnitude mapping table for estimating Mw from network
|
|
magnitude M. Mw values are given at some M.
|
|
|
|
Format: "M0:Mw0, M1:Mw1, ...".
|
|
|
|
Between two values of M, Mw values will be linearly
|
|
interpolated but not extrapolated.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="regionFile" type="file" options="read">
|
|
<description>
|
|
Path to a geofeature file, e.g. in BNA or GeoJSON format,
|
|
with one or more polygons defining geographic regions.
|
|
Each region allows further magnitude parametrization.
|
|
The order of polygons/regions matters. The list is
|
|
tested from front to back and the first hit wins.
|
|
Magnitude-region profiles refer to the polygons by the
|
|
name of the profile. The special name "world"
|
|
must not be present in the geofeature file.
|
|
</description>
|
|
</parameter>
|
|
<group name="region">
|
|
<description>
|
|
Add magnitude region profiles for regions defined by
|
|
polygons in the geofeature file of regionFile. Profile
|
|
names must match one polygon name. Otherwise, the
|
|
profile is not considered. The special name
|
|
"world" corresponds to the region of the
|
|
entire planet as a fallback.
|
|
</description>
|
|
<struct type="GlobalMagnitudeRegionProfile" title="Magnitude region profile">
|
|
<parameter name="enable" type="boolean" default="false">
|
|
<description>
|
|
Enable the region or not.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="minDist" type="string" unit="deg">
|
|
<description>
|
|
The minimum distance required to compute a
|
|
magnitude. This settings has no effect with e.g.
|
|
scautopick as there is no information about the
|
|
source of the event to compute the distance.
|
|
The default value depends on magnitude type.
|
|
|
|
Although the default unit is 'deg', values can be
|
|
given in any SI distance unit such km, m or cm
|
|
by simply appending the unit to the value.
|
|
|
|
Example:
|
|
|
|
minDist = 500km
|
|
</description>
|
|
</parameter>
|
|
<parameter name="maxDist" type="string" unit="deg">
|
|
<description>
|
|
The maximum distance allowed to compute a magnitude.
|
|
This settings has no effect with e.g. scautopick
|
|
as there is no information about the source of
|
|
the event to compute the distance. The default
|
|
value depends on magnitude type.
|
|
|
|
Although the default unit is 'deg', values can be
|
|
given in any SI distance unit such km, m or cm
|
|
by simply appending the unit to the value.
|
|
|
|
Example:
|
|
|
|
maxDist = 500km
|
|
</description>
|
|
</parameter>
|
|
<parameter name="minDepth" type="string" unit="km">
|
|
<description>
|
|
The minimum depth required to compute a magnitude.
|
|
This settings has no effect with e.g. scautopick
|
|
as there is no information about the source of
|
|
the event to retrieve the depth. The default
|
|
value depends on magnitude type.
|
|
|
|
Although the default unit is 'km', values can be
|
|
given in any SI distance unit such km, m or cm
|
|
by simply appending the unit to the value.
|
|
|
|
Example:
|
|
|
|
minDepth = 500km
|
|
</description>
|
|
</parameter>
|
|
<parameter name="maxDepth" type="string" unit="km">
|
|
<description>
|
|
The maximum depth allowed to compute a magnitude.
|
|
This settings has no effect with e.g. scautopick
|
|
as there is no information about the source of
|
|
the event to retrieve the depth. The default
|
|
value depends on magnitude type.
|
|
|
|
Although the default unit is 'km', values can be
|
|
given in any SI distance unit such km, m or cm
|
|
by simply appending the unit to the value.
|
|
|
|
Example:
|
|
|
|
maxDepth = 500km
|
|
</description>
|
|
</parameter>
|
|
<parameter name="check" type="string" default="source">
|
|
<description>
|
|
Define how the region check is performed to accept
|
|
a source receiver pair for further processing.
|
|
Allowed values are:
|
|
|
|
source: Only the source/origin must be within
|
|
the region.
|
|
|
|
source-receiver: Both source/origin and
|
|
receiver/station must be within the region.
|
|
|
|
raypath: The entire path between source/origin
|
|
and receiver/station must be withing the region.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="multiplier" type="double">
|
|
<description>
|
|
Linear part of the default station correction
|
|
for this region.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="offset" type="double">
|
|
<description>
|
|
Constant part of the default station correction
|
|
for this region.
|
|
</description>
|
|
</parameter>
|
|
</struct>
|
|
</group>
|
|
</struct>
|
|
</group>
|
|
</configuration>
|
|
<setup>
|
|
<group name="meta">
|
|
<input name="agencyID" type="string" default="">
|
|
<text>Agency ID</text>
|
|
<description>Agency ID</description>
|
|
</input>
|
|
<input name="datacenterID" type="string" default="">
|
|
<text>Datacenter ID</text>
|
|
<description>Datacenter ID</description>
|
|
</input>
|
|
<input name="organization" type="string" default="">
|
|
<text>Organization string</text>
|
|
<description>
|
|
This is used mainly by SeedLink and Arclink to
|
|
identify the server organization. Also, the ArcLink full
|
|
SEED volumes will have this organization value set.
|
|
</description>
|
|
</input>
|
|
</group>
|
|
</setup>
|
|
<command-line>
|
|
<group name="Generic" publicID="generic">
|
|
<option flag="h" long-flag="help" publicID="generic#help">
|
|
<description>Show help message.</description>
|
|
</option>
|
|
|
|
<option flag="V" long-flag="version" publicID="generic#version">
|
|
<description>Show version information.</description>
|
|
</option>
|
|
|
|
<option flag="" long-flag="config-file" argument="arg" publicID="generic#config-file">
|
|
<description>
|
|
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. Example:
|
|
scautopick -> scautopick2.
|
|
</description>
|
|
</option>
|
|
|
|
<option flag="" long-flag="plugins" argument="arg" publicID="generic#plugins">
|
|
<description>Load given plugins.</description>
|
|
</option>
|
|
|
|
<option flag="D" long-flag="daemon" publicID="generic#daemon">
|
|
<description>
|
|
Run as daemon. This means the application will fork itself
|
|
and doesn't need to be started with &.
|
|
</description>
|
|
</option>
|
|
|
|
<option flag="" long-flag="auto-shutdown" argument="arg" publicID="generic#auto-shutdown">
|
|
<description>
|
|
Enable/disable self-shutdown because a master module shutdown.
|
|
This only works when messaging is enabled and the master
|
|
module sends a shutdown message (enabled with --start-stop-msg
|
|
for the master module).
|
|
</description>
|
|
</option>
|
|
|
|
<option flag="" long-flag="shutdown-master-module" argument="arg" publicID="generic#shutdown-master-module">
|
|
<description>
|
|
Set the name of the master-module used for auto-shutdown.
|
|
This is the application name of the module actually
|
|
started. If symlinks are used, then it is the name of
|
|
the symlinked application.
|
|
</description>
|
|
</option>
|
|
|
|
<option flag="" long-flag="shutdown-master-username" argument="arg" publicID="generic#shutdown-master-username">
|
|
<description>
|
|
Set the name of the master-username of the messaging
|
|
used for auto-shutdown. If "shutdown-master-module" is
|
|
given as well, this parameter is ignored.
|
|
</description>
|
|
</option>
|
|
</group>
|
|
|
|
<group name="Verbose" publicID="verbose">
|
|
<option flag="" long-flag="verbosity" argument="arg" publicID="verbosity#verbosity">
|
|
<description>
|
|
Verbosity level [0..4]. 0:quiet, 1:error, 2:warning, 3:info,
|
|
4:debug.
|
|
</description>
|
|
</option>
|
|
|
|
<option flag="v" long-flag="v" argument="" publicID="verbosity#v">
|
|
<description>
|
|
Increase verbosity level (may be repeated, eg. -vv).
|
|
</description>
|
|
</option>
|
|
|
|
<option flag="q" long-flag="quiet" argument="" publicID="verbosity#quiet">
|
|
<description>
|
|
Quiet mode: no logging output.
|
|
</description>
|
|
</option>
|
|
|
|
<option flag="" long-flag="print-component" argument="arg" publicID="verbosity#print-component">
|
|
<description>
|
|
For each log entry print the component right after the
|
|
log level. By default the component output is enabled
|
|
for file output but disabled for console output.
|
|
</description>
|
|
</option>
|
|
|
|
<option flag="" long-flag="print-context" argument="arg" publicID="verbosity#context">
|
|
<description>
|
|
For each log entry print the source file name and line
|
|
number.
|
|
</description>
|
|
</option>
|
|
|
|
<option flag="" long-flag="component" argument="arg" publicID="verbosity#component">
|
|
<description>
|
|
Limit the logging to a certain component. This option can
|
|
be given more than once.
|
|
</description>
|
|
</option>
|
|
|
|
<option flag="s" long-flag="syslog" argument="" publicID="verbosity#syslog">
|
|
<description>
|
|
Use syslog logging backend. The output usually goes to
|
|
/var/lib/messages.
|
|
</description>
|
|
</option>
|
|
|
|
<option flag="l" long-flag="lockfile" argument="arg" publicID="verbosity#lockfile">
|
|
<description>
|
|
Path to lock file.
|
|
</description>
|
|
</option>
|
|
|
|
<option flag="" long-flag="console" argument="arg" publicID="verbosity#console">
|
|
<description>
|
|
Send log output to stdout.
|
|
</description>
|
|
</option>
|
|
|
|
<option flag="" long-flag="debug" argument="" publicID="verbosity#debug">
|
|
<description>
|
|
Execute in debug mode.
|
|
Equivalent to --verbosity=4 --console=1 .
|
|
</description>
|
|
</option>
|
|
|
|
<option flag="" long-flag="trace" argument="" publicID="verbosity#trace">
|
|
<description>
|
|
Execute in trace mode.
|
|
Equivalent to --verbosity=4 --console=1 --print-component=1
|
|
--print-context=1 .
|
|
</description>
|
|
</option>
|
|
|
|
<option flag="" long-flag="log-file" argument="arg" publicID="verbosity#log-file">
|
|
<description>
|
|
Use alternative log file.
|
|
</description>
|
|
</option>
|
|
</group>
|
|
|
|
<group name="Messaging" publicID="messaging">
|
|
<option flag="u" long-flag="user" argument="arg" publicID="messaging#user" param-ref="connection.username"/>
|
|
<option flag="H" long-flag="host" argument="arg" publicID="messaging#host" param-ref="connection.server"/>
|
|
<option flag="t" long-flag="timeout" argument="arg" publicID="messaging#timeout" param-ref="connection.timeout"/>
|
|
<option flag="g" long-flag="primary-group" argument="arg" publicID="messaging#primary-group" param-ref="connection.primaryGroup"/>
|
|
<option flag="S" long-flag="subscribe-group" argument="arg" publicID="messaging#subscribe-group">
|
|
<description>
|
|
A group to subscribe to.
|
|
This option can be given more than once.
|
|
</description>
|
|
</option>
|
|
<option flag="" long-flag="content-type" argument="arg" default="binary" publicID="messaging#content-type" param-ref="connection.contentType"/>
|
|
|
|
<option flag="" long-flag="start-stop-msg" argument="arg" default="0" publicID="messaging#start-stop-msg">
|
|
<description>
|
|
Set sending of a start and a stop message.
|
|
</description>
|
|
</option>
|
|
</group>
|
|
|
|
<group name="Database" publicID="database">
|
|
<option flag="" long-flag="db-driver-list" argument="" publicID="database#db-driver-list">
|
|
<description>
|
|
List all supported database drivers.
|
|
</description>
|
|
</option>
|
|
|
|
<option flag="d" long-flag="database" argument="arg" publicID="database#database">
|
|
<description>
|
|
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".
|
|
</description>
|
|
</option>
|
|
|
|
<option flag="" long-flag="config-module" argument="arg" publicID="database#config-module">
|
|
<description>
|
|
The config module to use.
|
|
</description>
|
|
</option>
|
|
|
|
<option flag="" long-flag="inventory-db" argument="arg" publicID="database#inventory-db">
|
|
<description>
|
|
Load the inventory from the given database or file, format:
|
|
[service://]location .
|
|
</description>
|
|
</option>
|
|
|
|
<option flag="" long-flag="config-db" argument="arg" publicID="database#config-db">
|
|
<description>
|
|
Load the configuration from the given database or file,
|
|
format: [service://]location .
|
|
</description>
|
|
</option>
|
|
</group>
|
|
|
|
<group name="Records" publicID="records">
|
|
<option flag="" long-flag="record-driver-list" argument="" default="" publicID="records#record-driver-list">
|
|
<description>
|
|
List all supported record stream drivers.
|
|
</description>
|
|
</option>
|
|
|
|
<option flag="I" long-flag="record-url" argument="arg" default="" publicID="records#record-url">
|
|
<description>
|
|
The RecordStream source URL. Format:
|
|
[service://]location[#type].
|
|
"service" is the name of the RecordStream driver
|
|
which can be queried with "--record-driver-list".
|
|
If "service" is not given, "file://" is
|
|
used and simply the name of a miniSEED file can be given.
|
|
</description>
|
|
</option>
|
|
|
|
<option flag="" long-flag="record-file" argument="arg" default="" publicID="records#record-file">
|
|
<description>Specify a file as record source.</description>
|
|
</option>
|
|
|
|
<option flag="" long-flag="record-type" argument="arg" default="" publicID="records#record-type">
|
|
<description>
|
|
Specify a type for the records being read.
|
|
</description>
|
|
</option>
|
|
</group>
|
|
|
|
<group name="Cities" publicID="cities">
|
|
<option long-flag="city-xml" argument="arg" default="" publicID="cities#city-xml" type="file" options="read" values="*.xml">
|
|
<description>
|
|
The path to the cities XML file. This overrides the default
|
|
paths. Compare with the global parameter "citiesXML".
|
|
</description>
|
|
</option>
|
|
</group>
|
|
|
|
<group name="User interface" publicID="gui">
|
|
<option flag="F" long-flag="full-screen" argument="" default="" publicID="gui#full-screen">
|
|
<description>
|
|
Start the application filling the entire screen.
|
|
This only works with GUI applications.
|
|
</description>
|
|
</option>
|
|
|
|
<option flag="N" long-flag="non-interactive" argument="" default="" publicID="gui#non-interactive">
|
|
<description>
|
|
Use non-interactive presentation mode. This only works with
|
|
GUI applications.
|
|
</description>
|
|
</option>
|
|
</group>
|
|
</command-line>
|
|
</module>
|
|
|
|
<binding name="general" module="global">
|
|
<description>
|
|
Configure global parameters of a station for modules.
|
|
</description>
|
|
<configuration>
|
|
<parameter name="detecLocid" type="string">
|
|
<description>
|
|
The sensor location code of the preferred stream used e.g.
|
|
by scautopick and scrttv.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="detecStream" type="string">
|
|
<description>
|
|
The channel code of the preferred stream used by
|
|
e.g. scautopick and scrttv. If no component code is given,
|
|
the vertical component will be fetched from inventory
|
|
considering the channel orientation (azimuth, dip).
|
|
If that approach fails, 'Z' will be appended and used as
|
|
fallback. Do not use regular expressions!
|
|
</description>
|
|
</parameter>
|
|
<group name="amplitudes">
|
|
<description>
|
|
Define general parameters for amplitudes of a certain type.
|
|
Create amplitude type profiles to define the time windows,
|
|
minimum signal-to-noise ratio, amplitude thresholds and
|
|
restitution for measuring amplitudes of a certain type.
|
|
|
|
Standard amplitude types supported in SeisComP: Md,Mjma,ML,MLc,MLh,MLr,MLv,MN,mb,mB,Mwp,Ms_20,Ms(BB).
|
|
</description>
|
|
<parameter name="saturationThreshold" type="string" default="false" unit="counts; %">
|
|
<description>
|
|
Define the saturation threshold for the optional saturation
|
|
check.
|
|
By default, the saturation check is disabled but giving a
|
|
value above 0 will enable it. Waveforms with raw amplitudes
|
|
above the threshold will then be considered saturated and
|
|
not used for amplitude calculations.
|
|
|
|
This value can either be an absolute value of counts such
|
|
as "100000" counts or a relative value
|
|
(optionally in percent) with respect to the number of
|
|
effective bits, e.g., "0.8@23" or "80%@23".
|
|
The first and the second version represent 0.8 * 2**23 and
|
|
80/100 * 2**23, respectively, which is the same.
|
|
|
|
The boolean value "false" explicitly disables
|
|
the check.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="enable" type="boolean" default="true">
|
|
<description>
|
|
Define if amplitude calculation is enabled. If disabled,
|
|
this station will be skipped for amplitudes and magnitudes.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="enableResponses" type="boolean" default="false">
|
|
<description>
|
|
Activate deconvolution for this station. If no responses are
|
|
configured, an error is raised and the data is not processed.
|
|
This flag will be overridden by the type specific flag
|
|
(see GlobalAmplitudeProfile).
|
|
</description>
|
|
</parameter>
|
|
<group name="resp">
|
|
<description>
|
|
Several parameters if usage of full responses is enabled.
|
|
The parameters of this group will be overridden by type
|
|
specific settings if given (see GlobalAmplitudeProfile).
|
|
</description>
|
|
<parameter name="taper" default="5" unit="s" type="double">
|
|
<description>
|
|
Define the length of the taper at either side of the
|
|
waveform. The length will be added to the data
|
|
request: start - taper and end + taper.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="minFreq" default="0.00833333" unit="Hz" type="double">
|
|
<description>
|
|
The minimum frequency of the considered spectrum.
|
|
|
|
After data is converted into the frequency domain that
|
|
minimum frequency defines the end of the left-side cosine
|
|
taper applied to the spectrum. The taper applies from
|
|
0 Hz to {minFreq} Hz. A value of 0 or lower disables
|
|
that taper.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="maxFreq" default="0" unit="Hz" type="double">
|
|
<description>
|
|
The maximum frequency of the considered spectrum.
|
|
|
|
After data are converted in to the frequency domain that
|
|
maximum frequency defines the start of the right-side
|
|
cosine taper applied to the spectrum. The taper applies from
|
|
{maxFreq} Hz to {fNyquist} Hz.
|
|
A value of 0 or lower disables that taper.
|
|
</description>
|
|
</parameter>
|
|
</group>
|
|
<group name="ttt">
|
|
<description>
|
|
Travel time table specific parameters to be used for the
|
|
computation of travel times referred to in signal and
|
|
noise time window specifications,
|
|
e.g. "signalBegin".
|
|
</description>
|
|
<parameter name="interface" type="string" default="LOCSAT" values="libtau,LOCSAT,homogeneous">
|
|
<description>
|
|
The name of the travel-time interface to use. The list
|
|
can be extended by plugins.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="model" type="string" default="iasp91">
|
|
<description>
|
|
The name of the travel-time interface (velocity) model
|
|
to use.
|
|
</description>
|
|
</parameter>
|
|
</group>
|
|
<group name="WoodAnderson">
|
|
<description>
|
|
Parameters of the Wood-Anderson seismometer response used
|
|
for instrument simulation. The default values are according
|
|
to Uhrhammer and Collins (1990) and were part of the
|
|
IASPEI Magnitude Working Group recommendations of 2011
|
|
September 9.
|
|
</description>
|
|
<parameter name="gain" type="double" default="2080">
|
|
<description>
|
|
The gain of the Wood-Anderson response.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="T0" type="double" default="0.8" unit="s">
|
|
<description>
|
|
The eigenperiod of the Wood-Anderson seismometer.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="h" type="double" default="0.7">
|
|
<description>
|
|
The damping constant of the Wood-Anderson seismometer.
|
|
</description>
|
|
</parameter>
|
|
</group>
|
|
<struct type="GlobalBindingsAmplitudeProfile" title="Amplitude type profile: Use name of amplitude type" aliases="config:amplitudes.aliases">
|
|
<description>
|
|
An amplitude profile configures global parameters for a
|
|
particular amplitude type. The available amplitude types
|
|
are not fixed and can be extended by plugins. The name of
|
|
the type must match the one defined in the corresponding
|
|
AmplitudeProcessor.
|
|
</description>
|
|
<parameter name="saturationThreshold" type="string" default="false" unit="counts; %">
|
|
<description>
|
|
Define the saturation threshold for the optional saturation
|
|
check.
|
|
By default, the saturation check is disabled but giving a
|
|
value above 0 will enable it. Waveforms with raw amplitudes
|
|
above the threshold will then be considered saturated and
|
|
not used for amplitude calculations.
|
|
|
|
This value can either be an absolute value of counts such
|
|
as "100000" counts or a relative value
|
|
(optionally in percent) with respect to the number of
|
|
effective bits, e.g., "0.8@23" or "80%@23".
|
|
The first and the second version represent 0.8 * 2**23 and
|
|
80/100 * 2**23, respectively, which is the same.
|
|
|
|
The boolean value "false" explicitly disables
|
|
the check.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="enable" type="boolean" default="true">
|
|
<description>
|
|
Define if amplitude calculation of certain type is enabled.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="enableResponses" type="boolean" default="false">
|
|
<description>
|
|
Activate deconvolution for this amplitude type. If not
|
|
set, the global flag "amplitudes.enableResponses"
|
|
will be used instead.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="minSNR" type="double" default="3">
|
|
<description>
|
|
Define the minimum SNR to be reached to compute the
|
|
amplitudes. This value is amplitude type specific and
|
|
has no global default value.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="minPeriod" type="double" unit="s">
|
|
<description>
|
|
Define the minimum period of the measured amplitude. If
|
|
the period is below this value, the amplitude will not be emitted.
|
|
This value is specific to amplitude type and has no global
|
|
default value. A value lower or equal than 0 will disable
|
|
this check.
|
|
|
|
Caution: If a value is set but the amplitude does not
|
|
provide the period, no amplitude is sent.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="maxPeriod" type="double" unit="s">
|
|
<description>
|
|
Define the maximum period of the measured amplitude. If
|
|
the period is above this value, the amplitude will not be emitted.
|
|
This value is specific to amplitude type and has no global
|
|
default value. A value lower or equal than 0 will disable
|
|
this check.
|
|
|
|
Caution: If a value is set but the amplitude does not
|
|
provide the period, no amplitude is sent.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="noiseBegin" type="string" unit="time grammar" default="-35">
|
|
<description>
|
|
Override the default time (relative to the trigger
|
|
time) of the begin of the noise window used to compute
|
|
the noise offset and noise amplitude. Each amplitude
|
|
processor sets its own noise time window and this option
|
|
should only be changed if you know what you are doing.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="noiseEnd" type="string" unit="time grammar" default="-5">
|
|
<description>
|
|
Override the default time (relative to the trigger
|
|
time) of the end of the noise window used to compute
|
|
the noise offset and noise amplitude. Each amplitude
|
|
processor sets its own noise time window and this option
|
|
should only be changed if you know what you are doing.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="signalBegin" type="string" unit="time grammar" default="-5">
|
|
<description>
|
|
Override the default time (relative to the trigger
|
|
time) of the begin of the signal window used to compute
|
|
the final amplitude. Each amplitude processor sets its
|
|
own signal time window and this option should only be
|
|
changed if you know what you are doing.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="signalEnd" type="string" unit="time grammar" default="30">
|
|
<description>
|
|
Override the default time (relative to the trigger
|
|
time) of the end of the signal window used to compute
|
|
the final amplitude. Each amplitude processor sets its
|
|
own signal time window and this option should only be
|
|
changed if you know what you are doing.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="minDist" type="string" unit="deg" default="0">
|
|
<description>
|
|
The minimum distance required to compute an amplitude.
|
|
This settings has no effect with e.g. scautopick as there
|
|
is no information about the source of the event to compute
|
|
the distance. The default value depends on
|
|
amplitude type.
|
|
|
|
Although the default unit is 'deg', values can be
|
|
given in any SI distance unit such km, m or cm
|
|
by simply appending the unit to the value.
|
|
|
|
Example:
|
|
|
|
minDist = 500km
|
|
</description>
|
|
</parameter>
|
|
<parameter name="maxDist" type="string" unit="deg" default="180">
|
|
<description>
|
|
The maximum distance allowed to compute an amplitude.
|
|
This settings has no effect with e.g. scautopick as there
|
|
is no information about the source of the event to compute
|
|
the distance. The default value depends on
|
|
amplitude type.
|
|
|
|
Although the default unit is 'deg', values can be
|
|
given in any SI distance unit such km, m or cm
|
|
by simply appending the unit to the value.
|
|
|
|
Example:
|
|
|
|
maxDist = 500km
|
|
</description>
|
|
</parameter>
|
|
<parameter name="minDepth" type="string" unit="km" default="-1000000">
|
|
<description>
|
|
The minimum depth required to compute an amplitude.
|
|
This settings has no effect with e.g. scautopick as there
|
|
is no information about the source of the event to
|
|
retrieve the depth. The default value depends on
|
|
amplitude type.
|
|
|
|
Although the default unit is 'km', values can be
|
|
given in any SI distance unit such km, m or cm
|
|
by simply appending the unit to the value.
|
|
|
|
Example:
|
|
|
|
minDepth = 500km
|
|
</description>
|
|
</parameter>
|
|
<parameter name="maxDepth" type="string" unit="km" default="1000000">
|
|
<description>
|
|
The maximum depth allowed to compute an amplitude.
|
|
This settings has no effect with e.g. scautopick as there
|
|
is no information about the source of the event to
|
|
retrieve the depth. The default value depends on
|
|
amplitude type.
|
|
|
|
Although the default unit is 'km', values can be
|
|
given in any SI distance unit such km, m or cm
|
|
by simply appending the unit to the value.
|
|
|
|
Example:
|
|
|
|
maxDepth = 500km
|
|
</description>
|
|
</parameter>
|
|
<group name="resp">
|
|
<description>
|
|
Several parameters if usage of full responses is enabled.
|
|
</description>
|
|
<parameter name="taper" default="5" unit="s" type="double">
|
|
<description>
|
|
Define the length of the taper at either side of the
|
|
waveform. The length will be added to the data
|
|
request: start - taper and end + taper.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="minFreq" default="0.00833333" unit="Hz" type="double">
|
|
<description>
|
|
After data are converted in to the frequency domain
|
|
that minimum frequency defines the end of the left-side
|
|
cosine taper for the frequency spectrum. The taper
|
|
applies from 0 Hz to {minFreq} Hz.
|
|
A value of 0 or lower disables that taper.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="maxFreq" default="0" unit="Hz" type="double">
|
|
<description>
|
|
After data are converted in to the frequency domain
|
|
that maximum frequency defines the start of the right-side
|
|
cosine taper for the frequency spectrum. The taper
|
|
applies from {maxFreq} Hz to {fNyquist} Hz.
|
|
A value of 0 or lower disables that taper.
|
|
</description>
|
|
</parameter>
|
|
</group>
|
|
</struct>
|
|
</group>
|
|
<group name="magnitudes">
|
|
<description>
|
|
Define the calibration parameters and constraints for computing
|
|
magnitudes from measured amplitudes including static corrections.
|
|
The parameters are independent of amplitude-type profiles.
|
|
|
|
Standard magnitude types supported in SeisComP: Md,Mjma,ML,MLc,MLh,MLr,MLv,MN,mb,mB,Mwp,Ms_20,Ms(BB).
|
|
</description>
|
|
<struct type="GlobalBindingsMagnitudeProfile" title="Magnitude type profile: Use name of magnitude type" aliases="config:magnitudes.aliases">
|
|
<description>
|
|
A magnitude profile configures global parameters for a
|
|
particular magnitude type. The available magnitude types
|
|
are not fixed and can be extended by plugins. The name of
|
|
the type must match the one defined in the corresponding
|
|
MagnitudeProcessor.
|
|
</description>
|
|
<parameter name="multiplier" type="list:string" default="1">
|
|
<description>
|
|
Part of the magnitude station correction. The final
|
|
magnitude value is multiplier*M+offset. This value
|
|
can be regionalized with name-value pairs.
|
|
The name is the name of the region. Without
|
|
a name the value is the default without regionalization.
|
|
Example: "1.0, regionA: 0.9, regionB: 1.1".
|
|
</description>
|
|
</parameter>
|
|
<parameter name="offset" type="list:string" default="0">
|
|
<description>
|
|
Part of the magnitude station correction. The final
|
|
magnitude value is multiplier*M+offset. This value
|
|
can be regionalized with name-value pairs.
|
|
The name is the name of the region. Without
|
|
a name the value is the default without regionalization.
|
|
Example: "0.0, regionA: -0.1, regionB: 0.2".
|
|
</description>
|
|
</parameter>
|
|
<parameter name="minDist" type="string" unit="deg">
|
|
<description>
|
|
The minimum distance in degree required to compute a
|
|
magnitude. This settings has no effect with e.g.
|
|
scautopick as there is no information about the
|
|
source of the event to compute the distance.
|
|
The default value depends on magnitude type.
|
|
|
|
Although the default unit is 'deg', values can be
|
|
given in any SI distance unit such km, m or cm
|
|
by simply appending the unit to the value.
|
|
|
|
Example:
|
|
|
|
minDist = 500km
|
|
</description>
|
|
</parameter>
|
|
<parameter name="maxDist" type="string" unit="deg">
|
|
<description>
|
|
The maximum distance in degree allowed to compute a magnitude.
|
|
This settings has no effect with e.g. scautopick
|
|
as there is no information about the source of
|
|
the event to compute the distance. The default
|
|
value depends on magnitude type.
|
|
|
|
Although the default unit is 'deg', values can be
|
|
given in any SI distance unit such km, m or cm
|
|
by simply appending the unit to the value.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="minDepth" type="string" unit="km">
|
|
<description>
|
|
The minimum depth required to compute a magnitude.
|
|
This settings has no effect with e.g. scautopick
|
|
as there is no information about the source of
|
|
the event to retrieve the depth. The default
|
|
value depends on magnitude type.
|
|
|
|
Although the default unit is 'km', values can be
|
|
given in any SI distance unit such km, m or cm
|
|
by simply appending the unit to the value.
|
|
|
|
Example:
|
|
|
|
minDepth = 500km
|
|
</description>
|
|
</parameter>
|
|
<parameter name="maxDepth" type="string" unit="km">
|
|
<description>
|
|
The maximum depth allowed to compute a magnitude.
|
|
This settings has no effect with e.g. scautopick
|
|
as there is no information about the source of
|
|
the event to retrieve the depth. The default
|
|
value depends on magnitude type.
|
|
|
|
Although the default unit is 'km', values can be
|
|
given in any SI distance unit such km, m or cm
|
|
by simply appending the unit to the value.
|
|
|
|
Example:
|
|
|
|
maxDepth = 500km
|
|
</description>
|
|
</parameter>
|
|
<parameter name="minSNR" type="double">
|
|
<description>
|
|
The minimum SNR required for a magnitude to pass
|
|
the QC check. The station magnitude will be computed
|
|
anyway but if the SNR is below this threshold it will
|
|
be associated with weight zero and will not contribute
|
|
to the network magnitude. If this value is set then it
|
|
overrides the regionalized setting.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="minPeriod" type="double" unit="s">
|
|
<description>
|
|
The minimum period required for a magnitude to pass
|
|
the QC check. The station magnitude will be computed
|
|
anyway but if the period is below this threshold it will
|
|
be associated with weight zero and will not contribute
|
|
to the network magnitude. If this value is set, then it
|
|
overrides the regionalized setting.
|
|
|
|
Caution: If a value is set but the amplitude does not
|
|
provide the period, no magnitude is computed.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="maxPeriod" type="double" unit="s">
|
|
<description>
|
|
The maximum period allowed for a magnitude to pass
|
|
the QC check. The station magnitude will be computed
|
|
anyway but if the period is above this threshold it will
|
|
be associated with weight zero and will not contribute
|
|
to the network magnitude. If this value is set, then it
|
|
overrides the regionalized setting.
|
|
|
|
Caution: If a value is set but the amplitude does not
|
|
provide the period, no magnitude is computed.
|
|
</description>
|
|
</parameter>
|
|
</struct>
|
|
</group>
|
|
<group name="picker">
|
|
<description>
|
|
Parameters controlling the second-stage picker for re-picking P
|
|
phases after an initial detection.
|
|
</description>
|
|
<group name="AIC">
|
|
<description>
|
|
AIC picker is an implementation using the simple non-AR
|
|
algorithm of Maeda (1985),
|
|
see paper of Zhang et al. (2003) in BSSA. The picker
|
|
interface name to be used in configuration files, e.g. of
|
|
scautopick, is "AIC".
|
|
</description>
|
|
<parameter name="noiseBegin" type="double" default="0" unit="s">
|
|
<description>
|
|
Override the relative data acquisition time (relative to
|
|
the triggering pick). This adds a margin to the actual
|
|
processing and is useful to initialize the filter (Example:
|
|
bandpass). The data is not used at all until signalBegin
|
|
is reached. The data time window start is the minimum of
|
|
noiseBegin and signalBegin.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="signalBegin" type="double" default="-30" unit="s">
|
|
<description>
|
|
Override the default time (relative to the trigger
|
|
time) of the begin of the signal window used to pick.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="signalEnd" type="double" default="10" unit="s">
|
|
<description>
|
|
Override the default time (relative to the trigger
|
|
time) of the begin of the signal window used to pick.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="filter" type="string" >
|
|
<description>
|
|
Override the default filter which is "raw". The typical
|
|
filter grammar can be used.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="minSNR" type="double" default="3">
|
|
<description>
|
|
Mininum SNR as returned from AIC for accepting picks.
|
|
</description>
|
|
</parameter>
|
|
</group>
|
|
<group name="BK">
|
|
<description>
|
|
Bkpicker is an implementation of the Baer/Kradolfer picker
|
|
adapted to SeisComP. It was created by converting Manfred
|
|
Baers from FORTRAN to C++ and inserting it as a replacement
|
|
for the picker algorithm. The picker interface name to be
|
|
used in configuration files, e.g. of scautopick,is
|
|
"BK".
|
|
</description>
|
|
<parameter name="noiseBegin" type="double" default="0" unit="s">
|
|
<description>
|
|
Override the relative data acquisition time (relative to
|
|
the triggering pick). This adds a margin to the actual
|
|
processing and is useful to initialize the filter (Example:
|
|
bandpass). The data is not used at all until signalBegin
|
|
is reached. The data time window start is the minimum of
|
|
noiseBegin and signalBegin.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="signalBegin" type="double" default="-20" unit="s">
|
|
<description>
|
|
Override the default time (relative to the trigger
|
|
time) of the begin of the signal window used to pick.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="signalEnd" type="double" default="80" unit="s">
|
|
<description>
|
|
Override the default time (relative to the trigger
|
|
time) of the begin of the signal window used to pick.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="filterType" type="string" default="BP">
|
|
<description>
|
|
BP (bandpass) is currently the only option.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="filterPoles" type="int" default="2">
|
|
<description>Number of poles.</description>
|
|
</parameter>
|
|
<parameter name="f1" type="double" default="5" unit="Hz">
|
|
<description>
|
|
Bandpass lower cutoff freq. in Hz.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="f2" type="double" default="20" unit="Hz">
|
|
<description>
|
|
Bandpass upper cutoff freq. in Hz.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="thrshl1" type="double" default="10">
|
|
<description>
|
|
Threshold to trigger for pick (c.f. paper), default 10
|
|
</description>
|
|
</parameter>
|
|
<parameter name="thrshl2" type="double" default="20">
|
|
<description>
|
|
Threshold for updating sigma (c.f. paper), default 20
|
|
</description>
|
|
</parameter>
|
|
</group>
|
|
</group>
|
|
<group name="spicker">
|
|
<description>
|
|
Parameters controlling the secondary picker. Example: for picking S
|
|
phases.
|
|
</description>
|
|
<group name="L2">
|
|
<description>
|
|
L2 is an algorithm to pick S-phases based on existing
|
|
P-phases. It works by creating the L2 norm of the two filtered
|
|
horizontal components and then running the `detecFilter` on
|
|
the L2 trace to find the S pick. Finally AIC is applied
|
|
around the detected pick time to refine the detection.
|
|
The picker name to be used in configuration files is
|
|
"S-L2".
|
|
</description>
|
|
<parameter name="noiseBegin" type="double" default="-10" unit="s">
|
|
<description>
|
|
Override the relative data processing start time
|
|
(relative to the triggering pick). This adds a margin to
|
|
the actual processing and is useful to initialize the
|
|
filter (Example: bandpass). The data is not used at all
|
|
until signalBegin is reached. The data time window start
|
|
is the minimum of noiseBegin and signalBegin.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="signalBegin" type="double" default="0" unit="s">
|
|
<description>
|
|
Override the relative start time (relative to the
|
|
triggering pick) of the begin of the signal processing.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="signalEnd" type="double" default="60" unit="s">
|
|
<description>
|
|
Override the relative end time (relative to the triggering
|
|
pick) of the end of the signal window used to pick.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="filter" type="string" default="BW(4,0.3,1.0)">
|
|
<description>
|
|
Configure the filter used to process the horizontal
|
|
components traces before computing the L2-norm.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="detecFilter" type="string" default="STALTA(1,10)">
|
|
<description>
|
|
Configure the detector filter applied on the filtered
|
|
L2 trace.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="threshold" type="double" default="3">
|
|
<description>
|
|
The detector threshold that triggers the AIC picker.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="timeCorr" type="double" default="0" unit="s">
|
|
<description>
|
|
The time correction added to the detection
|
|
time before AIC time window is computed.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="marginAIC" type="double" default="5" unit="s">
|
|
<description>
|
|
The AIC time window around the detection used to pick.
|
|
If 0, AIC is not used.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="minSNR" type="double" default="15">
|
|
<description>
|
|
Minimum SNR as returned from AIC for accepting picks.
|
|
</description>
|
|
</parameter>
|
|
</group>
|
|
<group name="V">
|
|
<description>
|
|
This S-picker works similarly to L2 but it only uses the
|
|
vertical component to pick S-phases. The picker name to be
|
|
used in configuration files is "S-V".
|
|
</description>
|
|
<parameter name="noiseBegin" type="double" default="-10" unit="s">
|
|
<description>
|
|
Override the relative data processing start time
|
|
(relative to the triggering pick). This adds a margin to
|
|
the actual processing and is useful to initialize the
|
|
filter (Example: bandpass). The data is not used at all
|
|
until signalBegin is reached. The data time window start
|
|
is the minimum of noiseBegin and signalBegin.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="signalBegin" type="double" default="0" unit="s">
|
|
<description>
|
|
Override the relative start time (relative to the
|
|
triggering pick) of the begin of the signal processing.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="signalEnd" type="double" default="60" unit="s">
|
|
<description>
|
|
Override the relative end time (relative to the triggering
|
|
pick) of the end of the signal window used to pick.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="filter" type="string" default="BW(4,0.3,1.0)">
|
|
<description>
|
|
Configure the filter used to process the raw vertical
|
|
component data.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="detecFilter" type="string" default="STALTA(1,10)">
|
|
<description>
|
|
Configure the detector filter applied on filtered data.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="threshold" type="double" default="3">
|
|
<description>
|
|
The detector threshold that triggers the AIC picker.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="timeCorr" type="double" default="0" unit="s">
|
|
<description>
|
|
The time correction added to the detection time
|
|
before AIC time window is computed.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="marginAIC" type="double" default="5" unit="s">
|
|
<description>
|
|
The AIC time window around the detection used to pick.
|
|
If 0, AIC is not used.
|
|
</description>
|
|
</parameter>
|
|
<parameter name="minSNR" type="double" default="15">
|
|
<description>
|
|
Define the mininum SNR as returned from AIC.
|
|
</description>
|
|
</parameter>
|
|
</group>
|
|
|
|
</group>
|
|
</configuration>
|
|
</binding>
|
|
</seiscomp>
|