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¶

Default: LOCATION

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".

Note

bindings.* Bindings for array processing. A method is activated by adding a configuration. Empty configuration deactivates the method.

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

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¶

Default: false

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.

pmcc.exportPath¶

Default: @LOGDIR@/lambda/families

Type: directory

The PMCC family export directory.

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¶

Default: P

Type: string

The phaseHint of the created pick.

profiles.base.$name.targetSampleRate¶

Default: 200

Unit: sps

Type: double

The common sample rate for all array elements. Channels that do not match this sample rate will be resampled.

profiles.base.$name.maximumChannelDelay¶

Default: 60

Unit: s

Type: double

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.

profiles.base.$name.minimumFrequency¶

Default: 0

Unit: Hz

Type: double

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.

profiles.base.$name.maximumFrequency¶

Default: 0

Unit: Hz

Type: double

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.

profiles.base.$name.frequencySteps¶

Default: 1

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.

profiles.base.$name.timeWindow¶

Default: 2

Unit: s

Type: double

The processing time window.

profiles.base.$name.timeStep¶

Default: 1

Unit: s

Type: double

The processing time step. After a time window has been processed, the window is shifted by this value.

profiles.base.$name.noiseWindow¶

Default: 4

Unit: s

Type: double

The noise window added before the detection, e.g. to calculate the SNR.

profiles.base.$name.semblanceTriggerOn¶

Default: 0.7

Type: double

The value that must be exceeded to activate triggering.

profiles.base.$name.semblanceTriggerOff¶

Default: 0.7

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.

profiles.base.$name.minimumSNR¶

Default: 10

Type: double

Minimum SNR to declare a pick on a beam trace.

profiles.base.$name.deadMargin¶

Default: 10

Unit: %

Type: double

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.

profiles.base.$name.stripBadChannels¶

Default: false

Type: boolean

Remove channels with low quality. Read the documentation on waveform quality control for details.

profiles.base.$name.method¶

Default: "beam packing"

Type: string

Values: beam packing,FK

The beam forming method. Valid methods are:

"beam packing"

"FK".

Reminder: The value should enclosed with double quotes if it contains white spaces.

profiles.base.$name.grid.extent¶

Default: 50x50

Unit: nodes

Type: string

Number of grid nodes of the processing grid in either direction.

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¶

Default: s/deg

Type: string

Values: s/deg,s/km,k

Defines the units of the grid ranges. The following units are allowed: "s/deg", "s/km" and "k".

profiles.slownessgrid.$name.grid.rect¶

Default: 100x100-50-50

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

"[+-]x1[+-]y1[+-]x2[+-]y2".

defining explicitly the upper and the lower values in horizontal and vertical direction, respectively.

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

"[+-]lat1[+-]lon1[+-]lat2[+-]lon2".

defining explicitly the lower (lat1/lon1) and the upper (lat2/lon2) latitude and longitude values of the region.

profiles.backprojection.$name.depth¶

Default: 10

Unit: km

Type: double

Defines the depth of the grid layer to be processed. This is in particular important when computing travel times to each grid node.

Note

profiles.backprojection.$name.ttt.* Travel time table specific settings.

profiles.backprojection.$name.ttt.type¶

Type: string

Values: LOCSAT,libtau,homogeneous

Defines the travel time table interface type such as "LOCSAT", "libtau" or "homogeneous".

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: float

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¶

Unit: s

Type: float

Families: Difference in time between 2 pixels to be considered for forming a family.

profiles.pmcc.$name.backazimuthDifference¶

Unit: deg

Type: float

Families: Difference in backazimuth between 2 pixels to be considered for forming a family.

profiles.pmcc.$name.slownessDifference¶

Unit: s/deg

Type: float

Families: Difference in slowness between 2 pixels to be considered for forming a family.

profiles.pmcc.$name.maxThreads¶

Default: 1

Type: integer

Defines the maximum number of threads to use when computing multiple frequency bands. This value is effectively limited to the number of configured frequency bands.

Command-Line Options¶

autolambda [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¶

Default: 0

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.

Mode¶

--ref-time arg¶

Type: time

The reference time.

--ep¶: Set offline mode, do not send messages and output results as XML to stdout.

autolambda¶

Description¶

Module Configuration¶

Command-Line Options¶

Generic¶

Messaging¶

Verbosity¶

Database¶

Records¶

Mode¶

Table of Contents

Previous topic

Next topic

This Page