Automatic relocator.
screloc is an automatic relocator that receives origins from realtime locators such as scautoloc and relocates them with a configurable locator. screloc can be conveniently used to test different locators and velocity models or to relocate events with updated velocity models. Check the Example applications for screloc.
screloc processes any incoming automatic origin but does not yet listen to event information nor does it skip origins for that a more recent one exists.
To run screloc along with all processing modules add it to the list of clients in the seiscomp configuration frontend.
seiscomp enable screloc
seiscomp start screloc
Descriptions of parameters for screloc:
seiscomp exec screloc -h
Test the performance of screloc and learn from debug output:
seiscomp exec screloc --debug
The following example configuration shows a setup of screloc for NonLinLoc:
plugins = ${plugins}, locnll
# Define the locator algorithm to use
reloc.locator = NonLinLoc
########################################################
################ NonLinLoc configuration################
########################################################
NLLROOT = ${HOME}/nll/data
NonLinLoc.outputPath = ${NLLROOT}/output/
# Define the default control file if no profile specific
# control file is defined.
NonLinLoc.controlFile = ${NLLROOT}/NLL.default.conf
# Set the default pick error in seconds passed to NonLinLoc
# if no SC3 pick uncertainty is available.
NonLinLoc.defaultPickError = 0.1
# Define the available NonLinLoc location profiles. The order
# implicitly defines the priority for overlapping regions
#NonLinLoc.profiles = swiss_3d, swiss_1d, global
NonLinLoc.profiles = swiss_3d, global
# The earthModelID is copied to earthModelID attribute of the
# resulting origin
NonLinLoc.profile.swiss_1d.earthModelID = "swiss regional 1D"
# Specify the velocity model table path as used by NonLinLoc
NonLinLoc.profile.swiss_1d.tablePath = ${NLLROOT}/time_1d_regio/regio
# Specify the region valid for this profile
NonLinLoc.profile.swiss_1d.region = 41.2, 3.8, 50.1, 16.8
# The NonLinLoc default control file to use for this profile
NonLinLoc.profile.swiss_1d.controlFile = ${NLLROOT}/NLL.swiss_1d.conf
# Configure the swiss_3d profile
NonLinLoc.profile.swiss_3d.earthModelID = "swiss regional 3D"
NonLinLoc.profile.swiss_3d.tablePath = ${NLLROOT}/time_3d/ch
NonLinLoc.profile.swiss_3d.region = 45.15, 5.7, 48.3, 11.0
NonLinLoc.profile.swiss_3d.controlFile = ${NLLROOT}/NLL.swiss_3d.conf
# And the global profile
NonLinLoc.profile.global.earthModelID = iaspei91
NonLinLoc.profile.global.tablePath = ${NLLROOT}/iasp91/iasp91
NonLinLoc.profile.global.controlFile = ${NLLROOT}/NLL.global.conf
Run screloc to with a specific velocity model given in a profile by NonLinLoc. Use a specific userID and authorID for uniquely recognizing the relocation. Changing the priority in scevent before running the example, e.g. to TIME_AUTOMTIC, sets the latest origin (which will be created by screloc) to preferred.
# set specific velocity profile defined for NonLinLoc
profile=<your_profile>
# set userID
userID="<your_user>"
# set authorID
authorID="<screloc>"
for i in `scevtls -d mysql://sysop:sysop@localhost/seiscomp3 --begin '2015-01-01 00:00:00' --end '2015-02-01 00:00:00'`; do
orgID=`echo "select preferredOriginID from Event,PublicObject where Event._oid=PublicObject._oid and PublicObject.publicID='$i'" |\
mysql -u sysop -p sysop -D seiscomp3 -h localhost -N`
screloc -O $orgID -d localhost --locator NonLinLoc --profile $profile -u $userID --debug --author=$authorID
done
screloc inherits global options.
Type: string
Defines the locator to be used such as NonLinLoc.
Type: string
The locator profile to use.
Type: boolean
Ignores origins with status REJECTED. Default is false.
Type: boolean
Triggers processing also on origins with status PRELIMINARY. Default is false.
show help message.
show version information
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, eg scautopick -> scautopick2.
Load given plugins.
Run as daemon. This means the application will fork itself and doesn't need to be started with &.
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).
Sets 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.
Sets 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.
Verbosity level [0..4]. 0:quiet, 1:error, 2:warning, 3:info, 4:debug
Increase verbosity level (may be repeated, eg. -vv)
Quiet mode: no logging output
Limits the logging to a certain component. This option can be given more than once.
Use syslog logging back end. The output usually goes to /var/lib/messages.
Path to lock file.
Send log output to stdout.
Debug mode: --verbosity=4 --console=1
Use alternative log file.
Overrides configuration parameter connection.username.
Overrides configuration parameter connection.server.
Overrides configuration parameter connection.timeout.
Overrides configuration parameter connection.primaryGroup.
A group to subscribe to. This option can be given more than once.
Overrides configuration parameter connection.encoding.
Sets sending of a start- and a stop message.
List all supported database drivers.
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".
The configmodule to use.
Load the inventory from the given database or file, format: [service://]location
Do not use the database at all
reprocess the origin and send a message unless test mode is activated
the locator type to use
use current picks weight
set origin evaluation mode: "AUTOMATIC" or "MANUAL"
Defines an event parameters XML file to be read and processed. This implies offline mode and only processes all origins contained in that file. Each relocated origin is appended to the list of origins unless --replace is given.
Used in combination with --ep. If given then each origin for that an output has been generated is replaced by the result of relocation. In other words: two LocSAT origins in, two NonLinLoc origins out. All other objects are passed through.