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.