1554 lines
37 KiB
Groff
1554 lines
37 KiB
Groff
.\" Man page generated from reStructuredText.
|
|
.
|
|
.
|
|
.nr rst2man-indent-level 0
|
|
.
|
|
.de1 rstReportMargin
|
|
\\$1 \\n[an-margin]
|
|
level \\n[rst2man-indent-level]
|
|
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
-
|
|
\\n[rst2man-indent0]
|
|
\\n[rst2man-indent1]
|
|
\\n[rst2man-indent2]
|
|
..
|
|
.de1 INDENT
|
|
.\" .rstReportMargin pre:
|
|
. RS \\$1
|
|
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
|
|
. nr rst2man-indent-level +1
|
|
.\" .rstReportMargin post:
|
|
..
|
|
.de UNINDENT
|
|
. RE
|
|
.\" indent \\n[an-margin]
|
|
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
.nr rst2man-indent-level -1
|
|
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
|
..
|
|
.TH "SCWFPARAM" "1" "Oct 14, 2025" "6.9.1" "SeisComP"
|
|
.SH NAME
|
|
scwfparam \- SeisComP Documentation
|
|
.sp
|
|
\fBWaveform parametrization module.\fP
|
|
.SH DESCRIPTION
|
|
.sp
|
|
scwfparam is a SeisComP module that computes
|
|
.INDENT 0.0
|
|
.IP \(bu 2
|
|
peak ground acceleration (PGA)
|
|
.IP \(bu 2
|
|
peak ground velocity (PGV)
|
|
.IP \(bu 2
|
|
relative displacement elastic response spectrum (DRS)
|
|
.IP \(bu 2
|
|
pseudo absolute acceleration elastic response spectrum (PSA)
|
|
.UNINDENT
|
|
.sp
|
|
in real\-time or offline. It includes a process scheduler and handles
|
|
reprocessing of data in a smart way. It supports ShakeMap XML output as
|
|
documented in the
|
|
\fI\%ShakeMap manual\fP each
|
|
time a new set of data is available.
|
|
.SH SCHEDULING
|
|
.sp
|
|
When the module is not started in offline mode, the processing of events is
|
|
scheduled following the configured rules. Parameters that influence the
|
|
scheduling are:
|
|
.INDENT 0.0
|
|
.IP \(bu 2
|
|
\fI\%wfparam.cron.wakeupInterval\fP
|
|
.IP \(bu 2
|
|
\fI\%wfparam.cron.updateDelay\fP
|
|
.IP \(bu 2
|
|
\fI\%wfparam.cron.delayTimes\fP
|
|
.UNINDENT
|
|
.sp
|
|
The wake\-up interval specifies when the scheduler is called to check if a
|
|
process is about to be started or stopped. The default is 10 seconds.
|
|
.sp
|
|
The scheduler checks then all scheduled jobs, adds a job to the processing queue
|
|
if the next run time is not in the future and removes all scheduled jobs with
|
|
timestamps in the past. The process queue contains all jobs that are about to
|
|
be executed. Because waveform acquisition is a time\- and memory\-costly operation
|
|
only one process can run at a time. Once a process finished, the next process in
|
|
the queue is executed (if any). When a process is started, it fetches the latest
|
|
event parameters (origin time, magnitude, location).
|
|
.sp
|
|
To add processes to the scheduler, the module distinguishes two cases:
|
|
.INDENT 0.0
|
|
.IP 1. 3
|
|
Process creation (new event or updated event seen the first time)
|
|
.IP 2. 3
|
|
Process update (event updates after an process has been created)
|
|
.UNINDENT
|
|
.SS Process creation
|
|
.sp
|
|
When a new event or an event update is received which does not have an
|
|
associated process yet, a new process is created. The event
|
|
time (Origin[Event.preferredOriginID].time) is used to build the default
|
|
schedule according to \fI\%wfparam.cron.delayTimes\fP\&.
|
|
.INDENT 0.0
|
|
.INDENT 3.5
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
for each time in wfparam.cron.delayTimes:
|
|
add_cron_job(process, Origin[Event.preferredOriginID].time + time)
|
|
.ft P
|
|
.fi
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.SS Process update
|
|
.sp
|
|
If a process for an event already exists, the next run time is the current time
|
|
plus wfparam.cron.updateDelay. Before adding this job to the scheduler the
|
|
application checks if the next scheduled runtime is at least
|
|
\fI\%wfparam.cron.updateDelay\fP seconds after the new run time. If not, a
|
|
new job is not addded to the scheduler. Pseudo code to illustrate the strategy
|
|
is given below.
|
|
.INDENT 0.0
|
|
.INDENT 3.5
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
event_updated(event):
|
|
p = process_for_event(event)
|
|
# The schedule for process p could be {T1,T2,T3,T4}
|
|
now = get_current_time()
|
|
next_run = now + wfparam.cron.updateDelay
|
|
# Process currently suspended?
|
|
if isEmpty(p.schedule):
|
|
p.schedule.add(next_run)
|
|
elif (p.schedule[0] \- next_run) > wfparam.cron.updateDelay:
|
|
p.schedule.prepend(next_run)
|
|
else:
|
|
# Do nothing, ignore the event update
|
|
pass
|
|
.ft P
|
|
.fi
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.SH PROCESSING
|
|
.sp
|
|
The processing can be divided into the following steps:
|
|
.INDENT 0.0
|
|
.IP \(bu 2
|
|
Collect all stations within the configured maximum distance
|
|
(\fI\%wfparam.maximumEpicentralDistance\fP or
|
|
\fI\%wfparam.magnitudeDistanceTable\fP)
|
|
.IP \(bu 2
|
|
Remove already processed channels
|
|
.IP \(bu 2
|
|
Find the velocity and acceleration stream with the highest sampling frequency
|
|
.INDENT 2.0
|
|
.IP \(bu 2
|
|
The sensor unit is used to distinguish between velocity and acceleration
|
|
streams (M/S, M/S**2)
|
|
.UNINDENT
|
|
.IP \(bu 2
|
|
Use all allowed components (\fI\%wfparam.streams.whitelist\fP,
|
|
\fI\%wfparam.streams.blacklist\fP) of each stream
|
|
.IP \(bu 2
|
|
Compute expected P arrival time if no pick is available
|
|
.IP \(bu 2
|
|
Start waveform acquisition
|
|
.IP \(bu 2
|
|
If the configured time window for one stream is complete, do (optional steps
|
|
are written italic)
|
|
.INDENT 2.0
|
|
.IP \(bu 2
|
|
Check saturation depending on \fI\%wfparam.saturationThreshold\fP
|
|
.IP \(bu 2
|
|
Search maximum raw value (in counts)
|
|
.IP \(bu 2
|
|
Apply gain
|
|
.IP \(bu 2
|
|
Check STA/LTA threshold 5 seconds around P
|
|
.IP \(bu 2
|
|
\fIIf velocity, differentiate data to acceleration\fP
|
|
.IP \(bu 2
|
|
\fICompute pre\-event cut\-off if enabled\fP
|
|
.IP \(bu 2
|
|
Compute offset of pre\-event time window
|
|
.IP \(bu 2
|
|
\fICompute signal duration and check for aftershocks\fP
|
|
.IP \(bu 2
|
|
\fIDeconvolution using spectral division of FFT spectrum and transfer function\fP
|
|
.IP \(bu 2
|
|
\fIApply optional sensitivity correction filter (lo\-, hi\- or bandpass)\fP
|
|
.IP \(bu 2
|
|
\fIApply optional lo\-pass, hi\-pass or band\-pass filter\fP
|
|
.IP \(bu 2
|
|
Compute PGA/PGV
|
|
.IP \(bu 2
|
|
Calculate response spectra
|
|
.UNINDENT
|
|
.IP \(bu 2
|
|
If acquisition finished
|
|
.INDENT 2.0
|
|
.IP \(bu 2
|
|
Collect all values (also recently processed values)
|
|
.INDENT 2.0
|
|
.IP \(bu 2
|
|
Results from velocity streams are always preferred over acceleration
|
|
streams if both are available (eg. co\-located stations)
|
|
.UNINDENT
|
|
.IP \(bu 2
|
|
Generate ShakeMap event and station XML
|
|
.INDENT 2.0
|
|
.IP \(bu 2
|
|
Unless \fI\%wfparam.output.shakeMap.maximumOfHorizontals\fP is set
|
|
to true all processed streams are included in XML
|
|
.UNINDENT
|
|
.IP \(bu 2
|
|
Call ShakeMap script and pass eventID and event ID path
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.sp
|
|
The channel is considered to be processed if the last step succeeded.
|
|
.SH WAVEFORM ARCHIVAL
|
|
.sp
|
|
If \fI\%wfparam.output.waveforms.enable\fP is set to true all processed
|
|
waveforms are stored in the configured output directory
|
|
\fI\%wfparam.output.waveforms.path\fP\&. The naming convention of a channel
|
|
miniSEED file is:
|
|
.sp
|
|
[EventDateTime]_[net]_[sta]_[loc][cha]_[filter][order]_[freqs].mseed
|
|
.sp
|
|
If \fI\%wfparam.output.waveforms.withEventDirectory\fP is set to true, an
|
|
event directory with the eventID is created additionally where the channel
|
|
files are stored under.
|
|
.sp
|
|
Either:
|
|
.INDENT 0.0
|
|
.INDENT 3.5
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
/path/to/waveforms/file1.mseed
|
|
/path/to/waveforms/file2.mseed
|
|
\&...
|
|
.ft P
|
|
.fi
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.sp
|
|
or
|
|
.INDENT 0.0
|
|
.INDENT 3.5
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
/path/to/waveforms/eventid/file1.mseed
|
|
/path/to/waveforms/eventid/file2.mseed
|
|
\&...
|
|
.ft P
|
|
.fi
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.sp
|
|
The miniSEED file contains uncompressed float 4096 byte records.
|
|
.sp
|
|
Example:
|
|
.TS
|
|
center;
|
|
|l|l|.
|
|
_
|
|
T{
|
|
Event time
|
|
T} T{
|
|
2011\-11\-21 08:30:00 Network: CH
|
|
T}
|
|
_
|
|
T{
|
|
Station
|
|
T} T{
|
|
SNIB
|
|
T}
|
|
_
|
|
T{
|
|
Location
|
|
T} T{
|
|
_ _
|
|
T}
|
|
_
|
|
T{
|
|
Channel
|
|
T} T{
|
|
HGZ
|
|
T}
|
|
_
|
|
T{
|
|
Filter
|
|
T} T{
|
|
hi\-pass
|
|
T}
|
|
_
|
|
T{
|
|
Order
|
|
T} T{
|
|
2
|
|
T}
|
|
_
|
|
T{
|
|
Corner frequencies
|
|
T} T{
|
|
0.025
|
|
T}
|
|
_
|
|
T{
|
|
Filename
|
|
T} T{
|
|
\fB20111121083000_CH_SNIB_HGZ_HP2_0.025.mseed\fP
|
|
T}
|
|
_
|
|
.TE
|
|
.SH DATABASE
|
|
.sp
|
|
scwfparam can make use of the database schema extension for strong motion
|
|
parameters.
|
|
.sp
|
|
In order to prepare the database the extension schema must be applied. The
|
|
database schema is installed in \fBshare/db/wfparam/*.sql\fP\&. Login into the
|
|
database backend and source the .sql file corresponding to the used database
|
|
backend.
|
|
.sp
|
|
In order to enable \fI\%scmaster\fP to handle messages containing objects for
|
|
strong motion parameters load the dmsm (data model strong motion) plugin as
|
|
follows in scmaster.cfg:
|
|
.INDENT 0.0
|
|
.INDENT 3.5
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
plugins = ${plugins}, dmsm
|
|
.ft P
|
|
.fi
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.sp
|
|
\fI\%scmaster\fP must be restarted to activate the plugin.
|
|
.sp
|
|
To activate scwfparam to send messages with strong motion objects, set
|
|
.INDENT 0.0
|
|
.INDENT 3.5
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
wfparam.output.messaging = true
|
|
.ft P
|
|
.fi
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.sp
|
|
in scwfparam.cfg.
|
|
.SH SHAKEMAPS
|
|
.sp
|
|
The ShakeMap XML is generated according the documentation of version 3.5 if
|
|
\fI\%wfparam.output.shakeMap.enable\fP is set to true.
|
|
.sp
|
|
Below an example is given of an event XML and a station XML. The data was
|
|
generated from a playback and does \fBnot\fP describe a \fBreal event\fP\&.
|
|
.SS Event XML
|
|
.INDENT 0.0
|
|
.INDENT 3.5
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
<?xml version=\(dq1.0\(dq encoding=\(dqUTF\-8\(dq standalone=\(dqyes\(dq?>
|
|
<!DOCTYPE earthquake SYSTEM \(dqearthquake.dtd\(dq>
|
|
<earthquake id=\(dqgfz2011oasp\(dq lat=\(dq38.916\(dq lon=\(dq40.0711\(dq
|
|
depth=\(dq10.3249\(dq mag=\(dq5.80361\(dq year=\(dq2011\(dq
|
|
month=\(dq7\(dq day=\(dq19\(dq hour=\(dq14\(dq minute=\(dq54\(dq
|
|
second=\(dq21\(dq timezone=\(dqGMT\(dq
|
|
locstring=\(dqtst2011oasp / 38.916 / 40.0711\(dq
|
|
/>
|
|
.ft P
|
|
.fi
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.SS Station XML
|
|
.INDENT 0.0
|
|
.INDENT 3.5
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
<?xml version=\(dq1.0\(dq encoding=\(dqUTF\-8\(dq standalone=\(dqyes\(dq?>
|
|
<!DOCTYPE earthquake SYSTEM \(dqstationlist.dtd\(dq>
|
|
<stationlist created=\(dq\(dq xmlns=\(dqch.ethz.sed.shakemap.usgs.xml\(dq>
|
|
<station code=\(dqJMB\(dq name=\(dqJMB\(dq lat=\(dq42.467\(dq lon=\(dq26.583\(dq>
|
|
<comp name=\(dqBHZ\(dq>
|
|
<acc value=\(dq0.0175823522\(dq flag=\(dq0\(dq/>
|
|
<vel value=\(dq0.0265134476\(dq flag=\(dq0\(dq/>
|
|
<psa03 value=\(dq0.0177551343\(dq flag=\(dq0\(dq/>
|
|
<psa10 value=\(dq0.0179450342\(dq flag=\(dq0\(dq/>
|
|
<psa30 value=\(dq0.0507100318\(dq flag=\(dq0\(dq/>
|
|
</comp>
|
|
</station>
|
|
<station code=\(dqBUD\(dq name=\(dqBUD\(dq insttype=\(dqSTS\-2/N\(dq
|
|
lat=\(dq47.4836\(dq lon=\(dq19.0239\(dq>
|
|
<comp name=\(dqBHZ\(dq>
|
|
<acc value=\(dq0.0018418704\(dq flag=\(dq0\(dq/>
|
|
<vel value=\(dq0.0012123935\(dq flag=\(dq0\(dq/>
|
|
<psa03 value=\(dq0.0019287320\(dq flag=\(dq0\(dq/>
|
|
<psa10 value=\(dq0.0033152716\(dq flag=\(dq0\(dq/>
|
|
<psa30 value=\(dq0.0027636448\(dq flag=\(dq0\(dq/>
|
|
</comp>
|
|
</station>
|
|
<station code=\(dqANTO\(dq name=\(dqANTO\(dq lat=\(dq39.868\(dq lon=\(dq32.7934\(dq>
|
|
<comp name=\(dqBHZ\(dq>
|
|
<acc value=\(dq0.0322238962\(dq flag=\(dq0\(dq/>
|
|
<vel value=\(dq0.0250842840\(dq flag=\(dq0\(dq/>
|
|
<psa03 value=\(dq0.0326696355\(dq flag=\(dq0\(dq/>
|
|
<psa10 value=\(dq0.0621788884\(dq flag=\(dq0\(dq/>
|
|
<psa30 value=\(dq0.0903777107\(dq flag=\(dq0\(dq/>
|
|
</comp>
|
|
</station>
|
|
<station code=\(dqGNI\(dq name=\(dqGNI\(dq lat=\(dq40.148\(dq lon=\(dq44.741\(dq>
|
|
<comp name=\(dqBHZ\(dq>
|
|
<acc value=\(dq0.0760558909\(dq flag=\(dq0\(dq/>
|
|
<vel value=\(dq0.0273735691\(dq flag=\(dq0\(dq/>
|
|
<psa03 value=\(dq0.0818660133\(dq flag=\(dq0\(dq/>
|
|
<psa10 value=\(dq0.1230812588\(dq flag=\(dq0\(dq/>
|
|
<psa30 value=\(dq0.1682284546\(dq flag=\(dq0\(dq/>
|
|
</comp>
|
|
</station>
|
|
</stationlist>
|
|
.ft P
|
|
.fi
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.SH EXAMPLES
|
|
.INDENT 0.0
|
|
.IP 1. 3
|
|
Running scwfparam offline with a multiplexed miniseed volume, an event xml
|
|
and an inventory xml file. A hi\-pass filter of 0.1hz (10secs) is used.
|
|
Processing starts immediately and the application finishes when processing
|
|
is done. The scheduler is disabled in offline mode.
|
|
.INDENT 3.0
|
|
.INDENT 3.5
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
scwfparam \-\-offline \-I vallorcine.mseed \e
|
|
\-\-inventory\-db vallorcine_inv.xml \e
|
|
\-\-ep vallorcine.xml \-E \(dqVallorcine.2005.09.08\(dq \e
|
|
\-\-lo\-filter 0.1 \-\-hi\-filter 0
|
|
.ft P
|
|
.fi
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.IP 2. 3
|
|
Running for a given event with scheduling enabled. Only the given event will
|
|
be processed.
|
|
.INDENT 3.0
|
|
.INDENT 3.5
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
scwfparam \-I arclink://localhost:18001 \-E gfz2011oeej \e
|
|
\-d mysql://sysop:sysop@localhost/seiscomp
|
|
.ft P
|
|
.fi
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.IP 3. 3
|
|
For running in real\-time it is enough to add the module to the client list
|
|
of the trunk package in seiscomp config.
|
|
.IP 4. 3
|
|
Running with remote Arclink server
|
|
.sp
|
|
To use a remote Arclink server it is
|
|
enough to configure the record stream with \-I:
|
|
.INDENT 3.0
|
|
.INDENT 3.5
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
scwfparam \-\-offline \-I vallorcine.mseed \e
|
|
\-\-inventory\-db vallorcine_inv.xml \e
|
|
\-\-ep vallorcine.xml \-E \(dqVallorcine.2005.09.08\(dq \e
|
|
\-I \(dqarclink://arclink.ethz.ch:18002\(dq
|
|
.ft P
|
|
.fi
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.sp
|
|
Note that the default acquisition timeout of 30 seconds might not be enough
|
|
to get all the requested data. If necessary, increase the value with
|
|
parameter \fI\%wfparam.acquisition.initialTimeout\fP\&. This can also be
|
|
reached on command line:
|
|
.INDENT 3.0
|
|
.INDENT 3.5
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
scwfparam \-\-offline \-I vallorcine.mseed \e
|
|
\-\-inventory\-db vallorcine_inv.xml \e
|
|
\-\-ep vallorcine.xml \-E \(dqVallorcine.2005.09.08\(dq \e
|
|
\-I \(dqarclink://arclink.ethz.ch:18002\(dq \e
|
|
\-\-wfparam.acquisition.initialTimeout=300
|
|
.ft P
|
|
.fi
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.IP 5. 3
|
|
Running with remote Seedlink server
|
|
.sp
|
|
To use a remote Seedlink server it is enough to configure the record stream with \-I:
|
|
.INDENT 3.0
|
|
.INDENT 3.5
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
scwfparam \-\-offline \-I vallorcine.mseed \e
|
|
\-\-inventory\-db vallorcine_inv.xml \e
|
|
\-\-ep vallorcine.xml \-E \(dqVallorcine.2005.09.08\(dq \e
|
|
\-I \(dqslink://geofon.gfz\-potsdam.de:18000\(dq
|
|
.ft P
|
|
.fi
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.SH MODULE CONFIGURATION
|
|
.nf
|
|
\fBetc/defaults/global.cfg\fP
|
|
\fBetc/defaults/scwfparam.cfg\fP
|
|
\fBetc/global.cfg\fP
|
|
\fBetc/scwfparam.cfg\fP
|
|
\fB~/.seiscomp/global.cfg\fP
|
|
\fB~/.seiscomp/scwfparam.cfg\fP
|
|
.fi
|
|
.sp
|
|
.sp
|
|
scwfparam inherits \fI\%global options\fP\&.
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.logfile
|
|
Default: \fB@LOGDIR@/scwfparam\-processing\-info.log\fP
|
|
.sp
|
|
Type: \fIpath\fP
|
|
.sp
|
|
The path to the processing info logfile.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.totalTimeWindowLength
|
|
Default: \fB360\fP
|
|
.sp
|
|
Type: \fIint\fP
|
|
.sp
|
|
Unit: \fIs\fP
|
|
.sp
|
|
Default value of total time window length in seconds if
|
|
wfparam.magnitudeTimeWindowTable is not specified. This times window
|
|
includes wfparam.preEventWindowLength.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.magnitudeTimeWindowTable
|
|
Type: \fIlist:string\fP
|
|
.sp
|
|
Magnitude dependent time window table. The format is
|
|
\(dqmag1:secs1, mag2:secs2, mag3:secs3\(dq. If a magnitude falls
|
|
between two configured magnitudes the time window of the lower
|
|
magnitude is used then. No interpolation is performed. Magnitude
|
|
outside the configured range are clipped to the lowest/highest value.
|
|
Example: \(dq3:100, 4:200, 5:300\(dq
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.preEventWindowLength
|
|
Default: \fB60\fP
|
|
.sp
|
|
Type: \fIint\fP
|
|
.sp
|
|
Unit: \fIs\fP
|
|
.sp
|
|
The pre event time window length in seconds.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.maximumEpicentralDistance
|
|
Default: \fB400\fP
|
|
.sp
|
|
Type: \fIint\fP
|
|
.sp
|
|
Unit: \fIkm\fP
|
|
.sp
|
|
The maximum epicentral distance in km of a station being considered
|
|
for processing. This value is used if wfparam.magnitudeDistanceTable
|
|
is not specified.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.magnitudeDistanceTable
|
|
Type: \fIlist:string\fP
|
|
.sp
|
|
Analogue to wfparam.magnitudeTimeWindowTable but instead giving a
|
|
time window, the distance in km is specified.
|
|
Example: \(dq3:400, 4:450, 5:500\(dq
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.saturationThreshold
|
|
Default: \fB80\fP
|
|
.sp
|
|
Type: \fIdouble\fP
|
|
.sp
|
|
Unit: \fI%\fP
|
|
.sp
|
|
Relative saturation threshold in percent. If the absolute raw amplitude
|
|
exceeds X% of 2**23 counts the station will be excluded from
|
|
processing. This assumes a 24bit datalogger.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.STAlength
|
|
Default: \fB1\fP
|
|
.sp
|
|
Type: \fIdouble\fP
|
|
.sp
|
|
Unit: \fIs\fP
|
|
.sp
|
|
Specifies the STA length in seconds of the applied STA/LTA check.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.LTAlength
|
|
Default: \fB60\fP
|
|
.sp
|
|
Type: \fIdouble\fP
|
|
.sp
|
|
Unit: \fIs\fP
|
|
.sp
|
|
Specifies the LTA length in seconds of the applied STA/LTA check.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.STALTAratio
|
|
Default: \fB3\fP
|
|
.sp
|
|
Type: \fIdouble\fP
|
|
.sp
|
|
Specifies the minimum STALTA ratio to be reached to further process
|
|
a station.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.STALTAmargin
|
|
Default: \fB5\fP
|
|
.sp
|
|
Type: \fIdouble\fP
|
|
.sp
|
|
Unit: \fIs\fP
|
|
.sp
|
|
Specifies the number of seconds around P to be used to check the STA/LTA ratio.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.durationScale
|
|
Default: \fB1.5\fP
|
|
.sp
|
|
Type: \fIdouble\fP
|
|
.sp
|
|
Defines the factor applied to the signigicant duration to define the
|
|
processing spetra time window. If that value is <= 0 the totalTimeWindowLength
|
|
is used.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.dampings
|
|
Default: \fB5\fP
|
|
.sp
|
|
Type: \fIlist:double\fP
|
|
.sp
|
|
Unit: \fI%\fP
|
|
.sp
|
|
Specifies a list of damping values (in percent) for computation of
|
|
the relative displacement elastic response spectrum.
|
|
Example: \(dq5,10,15\(dq
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.naturalPeriods
|
|
Default: \fB100\fP
|
|
.sp
|
|
Type: \fIint\fP
|
|
.sp
|
|
Specifies the number of natural periods for computation of the
|
|
relative displacement elastic response spectrum between Tmin and Tmax.
|
|
If \(dqfixed\(dq is given then a fixed list of periods is used. If
|
|
\(dqcustom\(dq is defined then a custom list of periods
|
|
will be used. This list must be configured with \(dqcustomPeriods\(dq.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.customPeriods
|
|
Type: \fIlist:double\fP
|
|
.sp
|
|
Unit: \fIs\fP
|
|
.sp
|
|
A list of periods to be used for computation of the
|
|
relative displacement elastic response spectrum. This list
|
|
will only be in effect if \(dqnaturalPeriods = custom\(dq.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.Tmin
|
|
Default: \fB0\fP
|
|
.sp
|
|
Type: \fIdouble\fP
|
|
.sp
|
|
Unit: \fIs\fP
|
|
.sp
|
|
Specifies the minimum period (Tmin) in seconds for computation of the
|
|
relative displacement elastic response spectrum.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.Tmax
|
|
Default: \fB5\fP
|
|
.sp
|
|
Type: \fIdouble\fP
|
|
.sp
|
|
Unit: \fIs\fP
|
|
.sp
|
|
Specifies the maximum period (Tmax) in seconds for computation of the
|
|
relative displacement elastic response spectrum.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.clipTmax
|
|
Default: \fBtrue\fP
|
|
.sp
|
|
Type: \fIboolean\fP
|
|
.sp
|
|
Should the maximum period (Tmax) clipped against the
|
|
configured filter lower corner frequency, the maximum of
|
|
pd.loFreq or filter.loFreq.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.afterShockRemoval
|
|
Default: \fBtrue\fP
|
|
.sp
|
|
Type: \fIboolean\fP
|
|
.sp
|
|
Enables/disables aftershock removal (Figini, 2006; Paolucci et al., 2008)
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.eventCutOff
|
|
Default: \fBtrue\fP
|
|
.sp
|
|
Type: \fIboolean\fP
|
|
.sp
|
|
Enables/disables pre\-event cut\-off. A hardcoded sta/lta algorithm
|
|
(with sta=0.1s, lta=2s, sta/lta threshold=1.2) is run on the time
|
|
window defined by (expected_P_arrival_time \- 15 s). The pre\-event
|
|
window is hence defined as
|
|
[t(sta/lta =1.2) \- 15.5s, t(sta/lta =1.2) \- 0.5s].
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.magnitudeFilterTable
|
|
Default: \fB0:0.2;0.8fNyquist,3:0.1;0.8fNyquist,5:0.05;0.8fNyquist,7:0.025;0.8fNyquist\fP
|
|
.sp
|
|
Type: \fIlist:string\fP
|
|
.sp
|
|
Magnitude dependent filter table. The format is
|
|
\(dqmag1:fmin1;fmax1, mag2:fmin2;fmax2, mag3:fmin3;fmax3\(dq.
|
|
If a magnitude falls between two configured magnitudes the filter of
|
|
the lower magnitude is then used. No interpolation takes place.
|
|
Magnitude outside the configured range are clipped to the
|
|
lowest/highest value.
|
|
Frequency values are given as simple positive doubles (Hz is assumed)
|
|
or with suffix \(dqfNyquist\(dq which is then multiplied by the
|
|
Nyquist frequency of the data to get the final corner frequency.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.deconvolution
|
|
Default: \fBtrue\fP
|
|
.sp
|
|
Type: \fIboolean\fP
|
|
.sp
|
|
Enables/disables deconvolution. If a channel does not provide full
|
|
response information it is not used for processing.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.magnitudeTolerance
|
|
Default: \fB0.5\fP
|
|
.sp
|
|
Type: \fIdouble\fP
|
|
.sp
|
|
Defines the magnitude tolerance to completely reprocess an event with
|
|
respect to the last state.
|
|
.UNINDENT
|
|
.sp
|
|
\fBNOTE:\fP
|
|
.INDENT 0.0
|
|
.INDENT 3.5
|
|
\fBwfparam.streams.*\fP
|
|
\fIDefines the white\- and blacklist of data streams to be used. The\fP
|
|
\fIrules to decide if a stream is used or not are the following:\fP
|
|
**
|
|
\fI1. if whitelist is not empty and the stream is not on the whitelist,\fP
|
|
\fIdon\(aqt use it, ok otherwise\fP
|
|
**
|
|
\fI2. if blacklist is not empty and the stream is on the blacklist,\fP
|
|
\fIdon\(aqt use it, ok otherwise\fP
|
|
**
|
|
\fIBoth checks are made and combined with AND. Either whitelist or\fP
|
|
\fIblacklist contains a list of patterns (wildcard allowed as * and ?),\fP
|
|
\fIeg GE.\fP\&.*.*, \fI, GE.MORC.\fP\&.BH? Each stream id (NET.STA.LOC.CHA) will*
|
|
\fIbe checked against the defined patterns.\fP
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.streams.whitelist
|
|
Type: \fIlist:string\fP
|
|
.sp
|
|
The stream whitelist
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.streams.blacklist
|
|
Type: \fIlist:string\fP
|
|
.sp
|
|
The stream blacklist
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.naturalPeriods.log
|
|
Default: \fBfalse\fP
|
|
.sp
|
|
Type: \fIboolean\fP
|
|
.sp
|
|
Defines if a linear spacing or logarithmic spacing between Tmin and
|
|
Tmax is used. The default is a linear spacing. The logarithmic
|
|
spacing will fail if either Tmin or Tmax is 0.
|
|
.UNINDENT
|
|
.sp
|
|
\fBNOTE:\fP
|
|
.INDENT 0.0
|
|
.INDENT 3.5
|
|
\fBwfparam.filter.*\fP
|
|
\fIParameters of the 1st stage filter.\fP
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.filter.order
|
|
Default: \fB4\fP
|
|
.sp
|
|
Type: \fIint\fP
|
|
.sp
|
|
Specifies the order of the 1st stage filter.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.filter.loFreq
|
|
Default: \fB0.025\fP
|
|
.sp
|
|
Type: \fIdouble\fP
|
|
.sp
|
|
Specifies the frequency of the 1st stage hi\-pass filter. If this
|
|
parameter is equal to 0 the hi\-pass filter is not used.
|
|
If suffix \(dqfNyquist\(dq is used then the value is multiplied
|
|
by the Nyquist frequency of the data to get the final corner
|
|
frequency of the filter.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.filter.hiFreq
|
|
Default: \fB40\fP
|
|
.sp
|
|
Type: \fIdouble\fP
|
|
.sp
|
|
Specifies the frequency of the 1st stage lo\-pass filter. If this
|
|
parameter is equal to 0 the lo\-pass filter is not used.
|
|
If suffix \(dqfNyquist\(dq is used then the value is multiplied
|
|
by the Nyquist frequency of the data to get the final corner
|
|
frequency of the filter.
|
|
.UNINDENT
|
|
.sp
|
|
\fBNOTE:\fP
|
|
.INDENT 0.0
|
|
.INDENT 3.5
|
|
\fBwfparam.pd.*\fP
|
|
\fIParameters of the post\-deconvolution filter applied in the\fP
|
|
\fIfrequency domain.\fP
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.pd.order
|
|
Default: \fB4\fP
|
|
.sp
|
|
Type: \fIint\fP
|
|
.sp
|
|
Specifies the order of the 2nd stage filter.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.pd.loFreq
|
|
Default: \fB0\fP
|
|
.sp
|
|
Type: \fIdouble\fP
|
|
.sp
|
|
Specifies the frequency of the 2nd stage hi\-pass filter. If this
|
|
parameter is equal to 0 the hi\-pass filter is not used.
|
|
If suffix \(dqfNyquist\(dq is used then the value is multiplied
|
|
by the Nyquist frequency of the data to get the final corner
|
|
frequency of the filter.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.pd.hiFreq
|
|
Default: \fB0\fP
|
|
.sp
|
|
Type: \fIdouble\fP
|
|
.sp
|
|
Specifies the frequency of the 2nd stage lo\-pass filter. If this
|
|
parameter is equal to 0 the lo\-pass filter is not used.
|
|
If suffix \(dqfNyquist\(dq is used then the value is multiplied
|
|
by the Nyquist frequency of the data to get the final corner
|
|
frequency of the filter.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.filtering.noncausal
|
|
Default: \fBfalse\fP
|
|
.sp
|
|
Type: \fIboolean\fP
|
|
.sp
|
|
Enables non\-causal filtering in the frequency domain.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.filtering.taperLength
|
|
Default: \fB\-1\fP
|
|
.sp
|
|
Type: \fIdouble\fP
|
|
.sp
|
|
Unit: \fIs\fP
|
|
.sp
|
|
Defines the cosine taper length in seconds if non\-causal filters
|
|
are activated applied on either side of the waveform. If a
|
|
negative length is given 10 percent of the pre\-event window length
|
|
is used on either side of the waveform.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.filtering.padLength
|
|
Default: \fB\-1\fP
|
|
.sp
|
|
Type: \fIdouble\fP
|
|
.sp
|
|
Unit: \fIs\fP
|
|
.sp
|
|
The length of the zero padding window in seconds applied on either
|
|
side of the waveform if non\-causal filters are activated. If
|
|
negative, it is computed following Boore (2005) as
|
|
1.5*order/corner_freq and applied half at the beginning and half at
|
|
the end of the waveform.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.cron.wakeupInterval
|
|
Default: \fB10\fP
|
|
.sp
|
|
Type: \fIint\fP
|
|
.sp
|
|
Unit: \fIs\fP
|
|
.sp
|
|
Specifies the interval in seconds to check/start scheduled operations.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.cron.eventMaxIdleTime
|
|
Default: \fB3600\fP
|
|
.sp
|
|
Type: \fIint\fP
|
|
.sp
|
|
Unit: \fIs\fP
|
|
.sp
|
|
Specifies the maximum allowed idle time of a process before removed.
|
|
The idle time is calculated if no further processing is scheduled
|
|
and computes as: [now]\-lastRun.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.cron.logging
|
|
Default: \fBtrue\fP
|
|
.sp
|
|
Type: \fIboolean\fP
|
|
.sp
|
|
Enables/disables updating of a cron log file. This file will be
|
|
created at ~/.seiscomp/log/[appname].sched
|
|
and contains information about the scheduled events and the
|
|
processing queue. The file is updated each n seconds,
|
|
where n = wfparam.cron.wakeupInterval.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.cron.updateDelay
|
|
Default: \fB60\fP
|
|
.sp
|
|
Type: \fIint\fP
|
|
.sp
|
|
Specifies the delay in seconds to delay processing if a new
|
|
authoritative origin arrives for an event.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.cron.delayTimes
|
|
Type: \fIlist:int\fP
|
|
.sp
|
|
Specifies a list of delay times in seconds relative to event time
|
|
to trigger the processing. When the first origin of an event arrives
|
|
this list is used to construct the crontab for this event.
|
|
Example: \(dq60, 120, 300, 3600\(dq
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.acquisition.initialTimeout
|
|
Default: \fB30\fP
|
|
.sp
|
|
Type: \fIint\fP
|
|
.sp
|
|
Unit: \fIs\fP
|
|
.sp
|
|
Specifies the initial acquisition timeout. If the acquisition
|
|
source (e.g. Arclink) does not respond within this threshold with
|
|
waveforms, the request is discarded.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.acquisition.runningTimeout
|
|
Default: \fB2\fP
|
|
.sp
|
|
Type: \fIint\fP
|
|
.sp
|
|
Unit: \fIs\fP
|
|
.sp
|
|
Specifies the acquisition timeout when waveforms are being
|
|
transfered. If no new waveforms arrive within this threshold, the
|
|
request is aborted. This is important if a Seedlink connection is
|
|
configured which can block the application for a very long time if
|
|
at least one requested channel has no data. Seedlink does not
|
|
finished the request until all data has been sent. When data will
|
|
arrive for a particular channel is not known.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.output.messaging
|
|
Default: \fBfalse\fP
|
|
.sp
|
|
Type: \fIboolean\fP
|
|
.sp
|
|
Enables messaging output which creates objects of the
|
|
StrongMotionParameters data model extension (defined by SED) and
|
|
sends them to scmaster. In order to save the objects to the database,
|
|
scmaster needs to load the dmsm plugin and the corresponding database
|
|
schema must be applied.
|
|
The default message group is AMPLITUDE. To change this group redefine
|
|
connection.primaryGroup.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.output.shortEventID
|
|
Default: \fBfalse\fP
|
|
.sp
|
|
Type: \fIboolean\fP
|
|
.sp
|
|
Uses short event ids when an event output directory needs to be
|
|
created. The default pattern is [eventtime]_[mag]_[lat]_[lon]_[updatetime].
|
|
The short format just contains the first part, namely [eventtime] in
|
|
the format YEARmmddHHMMSS.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.output.waveforms.enable
|
|
Default: \fBfalse\fP
|
|
.sp
|
|
Type: \fIboolean\fP
|
|
.sp
|
|
Enables/disables the output of processed waveforms.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.output.waveforms.path
|
|
Default: \fB@LOGDIR@/shakemaps/waveforms\fP
|
|
.sp
|
|
Type: \fIstring\fP
|
|
.sp
|
|
Specifies the waveform output path. This parameter is only used if
|
|
wfparam.output.waveforms.enable is true.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.output.waveforms.withEventDirectory
|
|
Default: \fBfalse\fP
|
|
.sp
|
|
Type: \fIboolean\fP
|
|
.sp
|
|
Enables/disables the creation of an event directory (named with
|
|
eventID) when storing the processed waveforms. This parameter is
|
|
only used if wfparam.output.waveforms.enable is true.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.output.spectra.enable
|
|
Default: \fBfalse\fP
|
|
.sp
|
|
Type: \fIboolean\fP
|
|
.sp
|
|
Enables/disables the output of spectra (psa, drs). The output
|
|
format is a simple ASCII file where the first column is the
|
|
period and the second column the corresponding value.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.output.spectra.path
|
|
Default: \fB@LOGDIR@/shakemaps/spectra\fP
|
|
.sp
|
|
Type: \fIstring\fP
|
|
.sp
|
|
Specifies the spectra output path. This parameter is only used if
|
|
wfparam.output.spectra.enable is true.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.output.spectra.withEventDirectory
|
|
Default: \fBfalse\fP
|
|
.sp
|
|
Type: \fIboolean\fP
|
|
.sp
|
|
Enables/disables the creation of an event directory (named with
|
|
eventID) when storing the spectra. This parameter is only used if
|
|
wfparam.output.spectra.enable is true.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.output.shakeMap.enable
|
|
Default: \fBtrue\fP
|
|
.sp
|
|
Type: \fIboolean\fP
|
|
.sp
|
|
Enables/disables ShakeMap XML output.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.output.shakeMap.pgm
|
|
Default: \fBpga, pgv, psa03, psa10, psa30\fP
|
|
.sp
|
|
Type: \fIlist:string\fP
|
|
.sp
|
|
Define a list of pg values to be forwarded to
|
|
ShakeMap in version 4 or later.
|
|
The period xx in psa must be in the list of
|
|
naturalPeriods and must not exceed 9.9s.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.output.shakeMap.path
|
|
Default: \fB@LOGDIR@/shakemaps\fP
|
|
.sp
|
|
Type: \fIstring\fP
|
|
.sp
|
|
Specifies the ShakeMap XML output path. This is only used if
|
|
wfparam.output.shakeMap.enable is set to true.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.output.shakeMap.script
|
|
Type: \fIstring\fP
|
|
.sp
|
|
Specifies the path to a script that is called whenever a new
|
|
ShakeMap XML is available. The script is called with 3 parameters:
|
|
EventID, modified ShakeMap eventID, path to event directory (where
|
|
input/event.xml and input/event_dat.xml lives).
|
|
The event files are not deleted by the application. The ownership
|
|
goes to the called script.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.output.shakeMap.synchronous
|
|
Default: \fBtrue\fP
|
|
.sp
|
|
Type: \fIboolean\fP
|
|
.sp
|
|
Enables/disables synchronous or asynchronous script calls. If
|
|
enabled, be careful to not spend too much time in the script.
|
|
The application is blocked while the script is running.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.output.shakeMap.maximumOfHorizontals
|
|
Default: \fBfalse\fP
|
|
.sp
|
|
Type: \fIboolean\fP
|
|
.sp
|
|
If enabled the maximum PGV, PGA, PSA03, PSA10 and PSA30 of both
|
|
horizontal components is used in the final output. Otherwise each
|
|
component is saved.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.output.shakeMap.SC3EventID
|
|
Default: \fBfalse\fP
|
|
.sp
|
|
Type: \fIboolean\fP
|
|
.sp
|
|
Uses the SeisComP event publicID as id attribute of the
|
|
earthquake tag, a generated ShakeMapID otherwise.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.output.shakeMap.regionName
|
|
Default: \fBfalse\fP
|
|
.sp
|
|
Type: \fIboolean\fP
|
|
.sp
|
|
Uses the event region name (if available) for the locstring
|
|
attribute, the publicID, lat, lon otherwise.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.output.shakeMap.encoding
|
|
Default: \fBUTF\-8\fP
|
|
.sp
|
|
Type: \fIstring\fP
|
|
.sp
|
|
The XML encoding string written to the Shakemap XML file.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B wfparam.output.shakeMap.version
|
|
Default: \fB3\fP
|
|
.sp
|
|
Type: \fIint\fP
|
|
.sp
|
|
The target version of the Shakemap input files.
|
|
.UNINDENT
|
|
.SH BINDINGS PARAMETERS
|
|
.INDENT 0.0
|
|
.TP
|
|
.B commtype
|
|
Default: \fBDIG\fP
|
|
.sp
|
|
Type: \fIstring\fP
|
|
.sp
|
|
Defines the communication type of the station which is forwarded
|
|
without modification to the Shakemap input file in version 4 or
|
|
greater. Reference:
|
|
\fI\%https://usgs.github.io/shakemap/manual4_0/sg_input_formats.html\fP\&.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B amplitudes.PGAV.saturationThreshold
|
|
Type: \fIstring\fP
|
|
.sp
|
|
Defines the saturation threshold for the optional saturation check.
|
|
By default the saturation check is configured for all stations
|
|
as module parameter. This parameters overrides the threshold
|
|
per station.
|
|
.sp
|
|
This value can either be an absolute value such as \(dq100000\(dq
|
|
or a relative value (optionally in percent) with respect to
|
|
the number of effective bits, e.g. \(dq0.8@23\(dq or
|
|
\(dq80%@23\(dq. The first version uses 1**23 * 0.8
|
|
whereas the latter uses 1**23 * 80/100.
|
|
.sp
|
|
The special value \(dqfalse\(dq explicitly disables
|
|
the check.
|
|
.UNINDENT
|
|
.SH COMMAND-LINE OPTIONS
|
|
.SS Generic
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-h, \-\-help
|
|
Show help message.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-V, \-\-version
|
|
Show version information.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-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.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-plugins arg
|
|
Load given plugins.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-D, \-\-daemon
|
|
Run as daemon. This means the application will fork itself
|
|
and doesn\(aqt need to be started with &.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-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).
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-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.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-shutdown\-master\-username arg
|
|
Set the name of the master\-username of the messaging
|
|
used for auto\-shutdown. If \(dqshutdown\-master\-module\(dq is
|
|
given as well, this parameter is ignored.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-x, \-\-expiry hours
|
|
Time span in hours after which objects expire
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-E, \-\-event\-id arg
|
|
EventID to calculate amplitudes for
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-ep arg
|
|
EventParameters (XML) to load
|
|
.UNINDENT
|
|
.SS Verbosity
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-verbosity arg
|
|
Verbosity level [0..4]. 0:quiet, 1:error, 2:warning, 3:info,
|
|
4:debug.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-v, \-\-v
|
|
Increase verbosity level (may be repeated, eg. \-vv).
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-q, \-\-quiet
|
|
Quiet mode: no logging output.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-component arg
|
|
Limit the logging to a certain component. This option can
|
|
be given more than once.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-s, \-\-syslog
|
|
Use syslog logging backend. The output usually goes to
|
|
/var/lib/messages.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-l, \-\-lockfile arg
|
|
Path to lock file.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-console arg
|
|
Send log output to stdout.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-debug
|
|
Execute in debug mode.
|
|
Equivalent to \-\-verbosity=4 \-\-console=1 .
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-log\-file arg
|
|
Use alternative log file.
|
|
.UNINDENT
|
|
.SS Messaging
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-u, \-\-user arg
|
|
Overrides configuration parameter \fI\%connection.username\fP\&.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-H, \-\-host arg
|
|
Overrides configuration parameter \fI\%connection.server\fP\&.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-t, \-\-timeout arg
|
|
Overrides configuration parameter \fI\%connection.timeout\fP\&.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-g, \-\-primary\-group arg
|
|
Overrides configuration parameter \fI\%connection.primaryGroup\fP\&.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-S, \-\-subscribe\-group arg
|
|
A group to subscribe to.
|
|
This option can be given more than once.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-content\-type arg
|
|
Overrides configuration parameter \fI\%connection.contentType\fP\&.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-start\-stop\-msg arg
|
|
Set sending of a start and a stop message.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-test
|
|
Test mode, no messages are sent
|
|
.UNINDENT
|
|
.SS Database
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-db\-driver\-list
|
|
List all supported database drivers.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-d, \-\-database arg
|
|
The database connection string, format:
|
|
\fI\%service://user:pwd@host/database\fP\&.
|
|
\(dqservice\(dq is the name of the database driver which
|
|
can be queried with \(dq\-\-db\-driver\-list\(dq.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-config\-module arg
|
|
The config module to use.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-inventory\-db arg
|
|
Load the inventory from the given database or file, format:
|
|
[\fI\%service://]location\fP .
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-db\-disable
|
|
Do not use the database at all
|
|
.UNINDENT
|
|
.SS Records
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-record\-driver\-list
|
|
List all supported record stream drivers.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-I, \-\-record\-url arg
|
|
The recordstream source URL, format:
|
|
[\fI\%service://\fP]location[#type].
|
|
\(dqservice\(dq is the name of the recordstream driver
|
|
which can be queried with \(dq\-\-record\-driver\-list\(dq.
|
|
If \(dqservice\(dq is not given, \(dq\fI\%file://\fP\(dq is
|
|
used.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-record\-file arg
|
|
Specify a file as record source.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-record\-type arg
|
|
Specify a type for the records being read.
|
|
.UNINDENT
|
|
.SS Mode
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-order arg
|
|
Filter order
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-lo\-filter freq
|
|
High\-pass filter frequency
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-hi\-filter freq
|
|
Low\-pass filter frequency
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-sc\-order arg
|
|
Sensitivity correction filter order
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-sc\-lo\-filter freq
|
|
Sensitivity correction high\-pass filter frequency
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-sc\-hi\-filter freq
|
|
Sensitivity correction low\-pass filter frequency
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-offline
|
|
Do not connect to the messaging and and disable the database in combination with \-\-inventory\-db and \-\-ep
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-force
|
|
Force event processing even if a journal entry exists that processing has completed
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-force\-shakemap
|
|
Force ShakeMap script to be run even if no station has contributed data
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-dump\-config
|
|
Dump the configuration and exit
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-dump\-records
|
|
Dumps all received records (binary) to [eventd].recs
|
|
.UNINDENT
|
|
.SH AUTHOR
|
|
gempa GmbH, GFZ Potsdam
|
|
.SH COPYRIGHT
|
|
gempa GmbH, GFZ Potsdam
|
|
.\" Generated by docutils manpage writer.
|
|
.
|