lambda¶
Array processing GUI
Description¶
Module Configuration¶
etc/defaults/global.cfg
etc/defaults/lambda.cfg
etc/global.cfg
etc/lambda.cfg
~/.seiscomp/global.cfg
~/.seiscomp/lambda.cfg
lambda 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
-
arrays
¶ Type: list:string
Array profile names referring to the defined arrays. The actual arrays are defined in the arrays section.
-
fdsnwsUrl
¶ Type: string
URL to FDNSWS for fetching event parameters.
-
phases
¶ Type: list::string
Available phase names for picking.
-
connection.locationGroup
¶ Type: string
Location group where origins will be sent to. Default is
LOCATION
.
Note
grid.* General grid parameters applied to all grids.
-
grid.x
¶ Type: int
The number of grid nodes in X direction. Note that this value will be increased by one in the final computation. Default is
50
.
-
grid.y
¶ Type: int
The number of grid nodes in Y direction. Note that this value will be increased by one in the final computation. Default is
50
.
-
grid.gradient
¶ Type: gradient
The color gradient used to color the ATF grid. Default is
0:00000000,0.2:0000ff80,0.4:00ffff,0.6:00ff00,0.8:ffff00,1:ff0000
.
-
grid.shading
¶ Type: boolean
Set the shading of 2D color plots plot such as F-K plots. Default is
true
.
Note
atf.* Parameters for computing the array response function (ATF). Also used for data processing by different methods.
-
atf.unit
¶ Type: string
The unit of the ATF grid. Allowed values:
“s/deg” (seconds per degree),
“s/km” (seconds per kilometer)
“k” (wavenumber: 2Pi/km). Default is
s/deg
.
-
atf.minRangeX
¶ Type: double
The lower value of the X range of the ATF computation grid. This value is either in slowness or wavenumber, depending on the unit setting. The unit is given by the configuration parameter “unit”. Default is
-50
.
-
atf.minRangeY
¶ Type: double
The lower value of the Y range of the ATF computation grid. This value is either in slowness or wavenumber, depending on the unit setting. The unit is given by the configuration parameter “unit”. Default is
-50
.
-
atf.maxRangeX
¶ Type: double
The upper value of the X range of the ATF computation grid. This value is either in slowness or wavenumber, depending on the unit setting. The unit is given by the configuration parameter “unit”. Default is
50
.
-
atf.maxRangeY
¶ Type: double
The upper value of the Y range of the ATF computation grid. This value is either in slowness or wavenumber, depending on the unit setting. The unit is given by the configuration parameter “unit”. Default is
50
.
-
atf.minFrequency
¶ Type: double
Unit: Hz
The minimum frequency to compute the ATF for. Default is
1
.
-
atf.maxFrequency
¶ Type: double
Unit: Hz
The maximum frequency to compute the ATF for. Default is
1
.
-
atf.frequencySteps
¶ Type: int
The number of frequencies to be generated between minFrequency and maxFrequency. Default is
1
.
Note
proc.* Parameters for controlling the data processing. Used by different methods, e.g. slowness/wavenumber analysis or backprojection.
-
proc.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
.
-
proc.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
5
.
-
proc.timeWindow
¶ Type: double
Unit: s
The processing time window. Default is
2
.
-
proc.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
.
-
proc.noiseWindow
¶ Type: double
Unit: s
The noise window added before the detection, e.g. to calculate the SNR. Default is
0
.
-
proc.semblanceTriggerOn
¶ Type: double
The value that must be exceeded to activate triggering. Default is
0.7
.
-
proc.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
.
-
proc.deadMargin
¶ Type: double
Unit: %
Margin on the beam trace where the phase picker is inactive.
-
proc.minimumSNR
¶ Type: double
Minimum SNR to declare a pick on a beam trace.
Note
proc.plot.* Control plotting of parameters in the result parameter plot.
-
proc.plot.channelCount
¶ Type: boolean
Plot the channel count graph in the processing window. Default is
true
.
-
proc.plot.backazimuth
¶ Type: boolean
Plot the back azimuth graph in the processing window. Default is
true
.
-
proc.plot.semblance
¶ Type: boolean
Plot the semblance graph in the processing window. Default is
true
.
-
proc.plot.velocity
¶ Type: boolean
Plot the velocity graph in the processing window. Default is
true
.
-
proc.plot.detection
¶ Type: boolean
Plot the detection graph in the processing window. Default is
true
.
Note
loc.* Parameters for locating by backprojection on a location grid.
-
loc.minimumLatitude
¶ Type: double
Unit: deg
Minimum latitude of the grid.
-
loc.maximumLatitude
¶ Type: double
Unit: deg
Maximum latitude of the grid.
-
loc.minimumLongitude
¶ Type: double
Unit: deg
Minimum longitude of the grid.
-
loc.maximumLongitude
¶ Type: double
Unit: deg
Maximum longitude of the grid.
-
loc.depth
¶ Type: double
Unit: km
Source depth.
-
loc.phase
¶ Type: double
Phase hint. Used to extract the respective traveltime tables.
Note
pmcc.* Parameters controlling the PMCC analysis.
-
pmcc.consistencyThreshold
¶ Type: double
Upper limit of consistency for forming a pixel.
-
pmcc.minimumChannels
¶ Type: int
Pixel: Minimum number of contributing waveform channels for forming a pixel.
-
pmcc.minimumSemblance
¶ Type: double
Pixel: Minimum semblance of contributing channels for forming a pixel.
-
pmcc.minimumPixels
¶ Type: int
Families: Minimum number of pixels for forming a family.
-
pmcc.timeDifference
¶ Type: double
Unit: s
Families: Difference in time between 2 pixels to be considerd for forming a family.
-
pmcc.backazimuthDifference
¶ Type: double
Unit: deg
Families: Difference in backazimuth between 2 pixels to be considerd for forming a family.
-
pmcc.slownessDifference
¶ Type: double
Unit: s/deg
Families: Difference in slowness between 2 pixels to be considerd for forming a family.
-
pmcc.exportScript
¶ Type: path
A script called after exporting a PMCC family to XML. The only parameter passed to the script is the XML file.
-
pmcc.exportPath
¶ Type: path
The path used by default to export PMCC families to. If the path does not exist it will be created.
-
spectrogram.windowLength
¶ Type: double
Unit: s
The length in seconds of the data time range which for which the spectrum is computed. The data time range is centered around each processing step. Default is
2.0
.
-
spectrogram.windowOverlap
¶ Type: double
Unit: ratio
The processing time step expressed as ratio with respect to the data window length. The default values result in a time step of one second. Default is
0.5
.
-
spectrogram.taperLength
¶ Type: double
Unit: ratio
The sinus taper length expressed as ratio with respect to the data window length applied at either end of the data. The default values result in a taper length of 0.1 second. Default is
0.05
.
-
spectrogram.normalize
¶ Type: boolean
Whether to normalize the rendered spectrogram with respect to the amplitudes range per processing step or not. Default is
false
.
-
spectrogram.logScale
¶ Type: boolean
Whether to use logarithmic scale or not for the frequency range. Default is
false
.
-
spectrogram.smoothTransform
¶ Type: boolean
Whether to render the spectrogram with interpolated colors on screen between processing steps or not. Default is
false
.
-
spectrogram.lowerBound
¶ Type: int
The spectrogram colors are being generated from the logarithm to base 10 of the power spectrum of the input data converted to ground motion (log10(real*real+imag*imag)). This parameter declares the lower bound which is mapped to the first color of the color gradient unless normalization is enabled. Default is
-15
.
-
spectrogram.gradient
¶ Type: gradient
The color gradient used to color spectrogram. The color range is actually not important and will be scaled to the minimum and maximum amplitudes (normalize=true) or to the given lower and upper bound. Default is
0:00000000,0.2:0000ff,0.4:00ffff,0.6:00ff00,0.8:ffff00,1:ff0000
.
Note
arrays.* Configure one ore more arrays.
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, CX.PB03..HHZ, CX.PB04..
The latter gives preference to the first occurrence of listed parameters separated by “:”. Here the list contains location codes.
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.