sc2ql

Import SeisComP event objects into a QuakeLink server.

Description

sc2ql is an application to export SeisComP objects, e.g. event parameters, from SeisComP to a QuakeLink server in real time. sc2ql is part of the QuakeLink suite/software package.

The application is demonstrated in the examples.

Please read the command-line help for the options:

sc2ql -h

Module Configuration

etc/defaults/global.cfg

etc/defaults/sc2ql.cfg

etc/global.cfg

etc/sc2ql.cfg

~/.seiscomp/global.cfg

~/.seiscomp/sc2ql.cfg

sc2ql 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

QL.server

Default: localhost:18011

Type: string

QuakeLink server to push data to

QL.compression

Default: false

Type: boolean

Compress messages pushed to QuakeLink with gzip

QL.binary

Default: false

Type: boolean

Encode messages in SeisComP binary format instead of SCML

QL.fetchAllAmplitudes

Default: false

Type: boolean

If enabled, then all amplitudes which reference an arrival of the preferred origin are included regardless of being referenced by a magnitude. Otherwise only the amplitudes are included which are referenced by the available station magnitudes.

QL.onlyPublishedEvents

Default: false

Type: boolean

An event is only forwarded to QuakeLink if the preferred origin contains a comment with text "OriginPublished".

QL.indentation

Default: false

Type: boolean

Use indentation for SCML encoding

QL.bufferSize

Default: 128

Type: int

Buffer size in megabytes. If the QuakeLink server is not reachable buffer messages up to X mb in a ring buffer. If the server is reachable again all buffered messages will be sent first.

Command-Line Options

sc2ql [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 &.

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.

--print-component arg

For each log entry print the component right after the log level. By default the component output is enabled for file output but disabled for console 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 .

--trace

Execute in trace mode. Equivalent to --verbosity=4 --console=1 --print-component=1 --print-context=1 .

--log-file arg

Use alternative log file.

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.

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.

Sink

--test

Test output and read SCML from stdin.

--server arg

Overrides configuration parameter QL.server.

-z, --gzip arg

Overrides configuration parameter QL.compression.

--bin arg

Overrides configuration parameter QL.binary.

-p, --pretty-print arg

Overrides configuration parameter QL.indentation.

--end-buffer arg

Overrides configuration parameter QL.bufferSize.