autolambda¶
Automatic array processing
Description¶
Module Configuration¶
etc/defaults/global.cfg
etc/defaults/autolambda.cfg
etc/global.cfg
etc/autolambda.cfg
~/.seiscomp/global.cfg
~/.seiscomp/autolambda.cfg
autolambda 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
Note
connection.* Additional parameters for connecting to the messaging system.
-
connection.locationGroup
¶ Type: string
Location message group where origins will be sent e.g. from backprojection. Picks are sent to the group defined by the global parameter “connection.primaryGroup”. Default is
LOCATION
.
Note
bindings.* Bindings for array processing
-
bindings.slownessgrid
¶ Type: list:string
Slowness grid bindings for an array. A binding consists of an array profile name, a base profile and a slowness grid profile. Each binding is a triplet separated by a semicolon. Example: “PSA;f1-8;default,4A;f2-10;default”
Note the difference of a comma and a semicolon.
-
bindings.backprojection
¶ Type: list:string
Backprojection bindings for an array. A binding consists of an array profile name, a base profile and a backprojection profile. Each binding is a triplet separated by a semicolon. Example: “PSA;f1-8;default,4A;f2-10;default”
Note the difference of a comma and a semicolon.
-
bindings.pmcc
¶ Type: list:string
PMCC bindings for an array. A binding consists of an array profile name, a base profile and a PMCC profile. Each binding is a triplet separated by a semicolon. Example: “PSA;f1-8;default,4A;f2-10;default”
Note the difference of a comma and a semicolon.
Note
arrays.* Configure one ore more array profiles.
Note
arrays.$name.*
Define the array.
$name is a placeholder for the name to be used and needs to be added to arrays
to become active.
arrays = a,b
arrays.a.value1 = ...
arrays.b.value1 = ...
# c is not active because it has not been added
# to the list of arrays
arrays.c.value1 = ...
-
arrays.$name.channels
¶ Type: list:string
Defines a list of channels to use. E.g.
CX.PB01..HHZ, CX.PB02..HHZ, CX.PB03..HHZ
or
CX.PB01.:00.HHZ, CX.PB02.10:20:30.HHZ, CX.PB03..HHZ, CX.PB04..
The latter gives preference to the first occurrence of listed parameters separated by “:”. Here the list contains location codes. Wildcards are not supported. If the channel codes is omitted, the vertical channel occurring first in the inventory is selected.
Note
pmcc.* PMCC specific parameters.
-
pmcc.dumpFamilies
¶ Type: boolean
If enabled then each PMCC detection family is exported as SeisComP event parameters XML. The path is configured in pmcc.exportPath. The filename of the family is generated as Family_<time>_Origin.PMCC.<time>.xml. Default is
false
.
-
pmcc.exportPath
¶ Type: path
The PMCC family export path. Default is
@LOGDIR@/lambda/families
.
Note
profiles.* Processing profiles
Note
profiles.base.* Base processing parameters such as filters and time windows.
Note
profiles.base.$name.* $name is a placeholder for the name to be used.
-
profiles.base.$name.phaseHint
¶ Type: string
The phaseHint of the created pick. Default is
P
.
-
profiles.base.$name.targetSampleRate
¶ Type: double
Unit: sps
The common sample rate for all array elements. Channels that do not match this sample rate will be resampled. Default is
200
.
-
profiles.base.$name.maximumChannelDelay
¶ Type: double
Unit: s
The maximum channel delay allowed before a particular channel is reset and processing is continued with all remaining channels. This value is always with respect to the latest sample of each channel in the array. Default is
60
.
-
profiles.base.$name.minimumFrequency
¶ Type: double
Unit: Hz
The lower corner frequency of the filter. If lower or equal to zero then it is disabled and the resulting filter is a lo-pass filter. If both frequencies are disabled then filtering will be disabled. Default is
0
.
-
profiles.base.$name.maximumFrequency
¶ Type: double
Unit: Hz
The upper corner frequency of the filter. If lower or equal to zero then it is disabled and the resulting filter is a hi-pass filter. If both frequencies are disabled then filtering will be disabled. Default is
0
.
-
profiles.base.$name.frequencySteps
¶ Type: int
The number of frequencies to be generated between minimumFrequency and maximumFrequency. This feature is currently not supported and this parameter will be ignored. Default is
1
.
-
profiles.base.$name.timeWindow
¶ Type: double
Unit: s
The processing time window. Default is
2
.
-
profiles.base.$name.timeStep
¶ Type: double
Unit: s
The processing time step. After a time window has been processed, the window is shifted by this value. Default is
1
.
-
profiles.base.$name.noiseWindow
¶ Type: double
Unit: s
The noise window added before the detection, e.g. to calculate the SNR. Default is
4
.
-
profiles.base.$name.semblanceTriggerOn
¶ Type: double
The value that must be exceeded to activate triggering. Default is
0.7
.
-
profiles.base.$name.semblanceTriggerOff
¶ Type: double
Once the semblance trigger is activated, the maximum semblance is collected until the value drops below this value. The maximum between on and off is used to find the pick on the beam. Default is
0.7
.
-
profiles.base.$name.minimumSNR
¶ Type: double
Minimum SNR to declare a pick on a beam trace. Default is
10
.
-
profiles.base.$name.deadMargin
¶ Type: double
Unit: %
Margin in percent of the data time window currently processed. This time window covers noise and signal (noiseWindow + timeWindow). If the pick falls inside this margin (left or right side) then it is discarded. Default is
10
.
-
profiles.base.$name.stripBadChannels
¶ Type: boolean
Remove channels with low quality. Read the documenatation on waveform quality control for details. Default is
false
.
-
profiles.base.$name.method
¶ Type: string
The beam forming method. Valid methods are:
“beam packing”
or
“FK”.
Reminder: The value should enclosed with double quotes if it contains white spaces. Default is
"beam packing"
.
-
profiles.base.$name.grid.extent
¶ Type: string
Unit: nodes
Number of grid nodes of the processing grid in either direction. Default is
50x50
.
Note
profiles.slownessgrid.* Processing parameters for the slowness grid to detect events within a specific slowness range.
Note
profiles.slownessgrid.$name.* $name is a placeholder for the name to be used.
-
profiles.slownessgrid.$name.grid.unit
¶ Type: string
Defines the units of the grid ranges. The following units are allowed: “s/deg”, “s/km” and “k”. Default is
s/deg
.
-
profiles.slownessgrid.$name.grid.rect
¶ Type: string
Defines the rectangular grid ranges in either direction. The suported formats are:
“wxh[+-]x[+-]y” with
w / h: width / height
x / y: horizontal / vertical offset
or
“[+-]x1[+-]y1[+-]x2[+-]y2”.
defining explicitely the upper and the lower values in horizontal and vertical direction, respectively. Default is
100x100-50-50
.
Note
profiles.backprojection.* Processing parameters for the backprojection to detect events in a geographic search region.
Note
profiles.backprojection.$name.* $name is a placeholder for the name to be used.
-
profiles.backprojection.$name.rect
¶ Type: string
Defines the rectangular geographical search region. The suported formats are:
“hxw[+-]lat[+-]lon” with
h / w: height / width
lat / lon: latitude / longitude offset
or
“[+-]lat1[+-]lon1[+-]lat2[+-]lon2”.
defining explicitely the lower (lat1/lon1) and the upper (lat2/lon2) latitude and longitude values of the region.
-
profiles.backprojection.$name.depth
¶ Type: double
Unit: km
Defines the depth of the grid layer to be processed. This is in particular important when computing travel times to each grid node. Default is
10
.
Note
profiles.backprojection.$name.ttt.* Travel time table specific settings.
-
profiles.backprojection.$name.ttt.type
¶ Type: string
Defines the travel time table interface type such as “LOCSAT” or “libtau”.
-
profiles.backprojection.$name.ttt.model
¶ Type: string
Defines the travel time table to be used with respect to the configured type.
Note
profiles.pmcc.* PMCC processing parameters
Note
profiles.pmcc.$name.* $name is a placeholder for the name to be used.
-
profiles.pmcc.$name.consistencyThreshold
¶ Type: float
The consistency threshold for a subarray to be able to grow:
consistency <= consistencyThreshold.
-
profiles.pmcc.$name.minimumChannels
¶ Type: int
Pixel: The minimum number of channels in a subarray to form a pixel
-
profiles.pmcc.$name.minimumSemblance
¶ Type: int
Pixel: The minimum semblance of channels to be reached in a subarray to form a pixel
-
profiles.pmcc.$name.minimumPixels
¶ Type: int
Families: The minimum number of pixels to form a family.
-
profiles.pmcc.$name.timeDifference
¶ Type: float
Unit: s
Families: Difference in time between 2 pixels to be considerd for forming a family.
-
profiles.pmcc.$name.backazimuthDifference
¶ Type: float
Unit: deg
Families: Difference in backazimuth between 2 pixels to be considerd for forming a family.
-
profiles.pmcc.$name.slownessDifference
¶ Type: float
Unit: s/deg
Families: Difference in slowness between 2 pixels to be considerd for forming a family.
Command-Line Options¶
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. Example: 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 &.
-
--auto-shutdown
arg
¶ 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).
-
--shutdown-master-module
arg
¶ 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.
-
--shutdown-master-username
arg
¶ 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.
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.
-
--start-stop-msg
arg
¶ Set sending of a start and a stop message.
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
¶ 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 .
-
--log-file
arg
¶ Use alternative log file.
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 .
Records¶
-
--record-driver-list
¶
List all supported record stream drivers.
-
-I
,
--record-url
arg
¶ 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.
-
--record-file
arg
¶ Specify a file as record source.
-
--record-type
arg
¶ Specify a type for the records being read.