Files
2025/share/man/man1/scrttv.1

1946 lines
43 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 "SCRTTV" "1" "Sep 22, 2025" "6.9.0" "SeisComP"
.SH NAME
scrttv \- SeisComP Documentation
.sp
\fBReal\-time trace view.\fP
.SH DESCRIPTION
.sp
scrttv visualizes waveform data in miniSEED format
(see \fI\%Figure below\fP) in real\-time or from archives
with a defined window length (default: 30 minutes) of defined streams/stations
(default: streams defined by global bindings). Additionally, phase picks are
visualized.
.sp
scrttv can be used for view waveforms,
\fI\%visual waveform quality control\fP or
\fI\%interactive signal detection\fP\&.
.sp
When in message mode scrttv dynamically resorts waveforms:
Normally, the trace order is given by configuration, e.g., ordering by epicentral
distance from a location given by \fI\%streams.sort.latitude\fP and
\fI\%streams.sort.longitude\fP\&.
In the event that a new SeisComP \fI\%event\fP arrives from the messaging, the
traces are sorted automatically by epicentral distance to the latest origin
received. In addition to waveforms, information about gaps or overlaps, picks
and the time of incoming origins are displayed.
.INDENT 0.0
.INDENT 2.5
[image]
scrttv overview
An example of scrttv and the dialog window to associate picks to new origins.
Tabs: Enable/Disable; Amplitude: mean and maximum;
Stream: station, network, sensor location and channel code;
Filter: filter applied traces; Status = connection status to messaging.
.UNINDENT
.UNINDENT
.sp
scrttv shows two tabs: the Enabled and the disabled tab
(see \fI\%scrttv overview\fP). Stations listed in the disabled tab
are excluded from automatic processing (e.g. phase picking). To move a station
from one tab to another just drag and drop the trace to the new tab. An alternative solution is
to double click on the trace label to disable a trace. Read the section
\fI\%Waveform Quality Control\fP for the details.
.sp
Normally, the raw data are displayed. Pressing \fBf\fP the predefined bandpass filter
of third order from 0.5 Hz to 8 Hz, \fI\%BW(3,0.5,8)\fP is applied
to the traces. Also zoom functions for the time and amplitude axis are provided.
Read the sections <scrttv\-filtering> and \fI\%Waveform Visualization\fP for
more details.
.sp
Among the configurable parameters are:
.INDENT 0.0
.IP \(bu 2
Global \fI\%bindings\fP:
.INDENT 2.0
.IP \(bu 2
default definition of traces to show (\fI\%detecStream\fP and \fI\%detecLocid\fP).
.UNINDENT
.IP \(bu 2
\fI\%Module\fP configuration:
.INDENT 2.0
.IP \(bu 2
network, stations, locations and streams to show extending or overriding the
default definition (\fI\%streams.codes\fP),
.IP \(bu 2
\fI\%data filters\fP,
.IP \(bu 2
buffer size controlling the length of loaded data (\fI\%bufferSize\fP),
.IP \(bu 2
sorting of traces upon arrival of new origins (\fI\%resortAutomatically\fP),
.IP \(bu 2
reference coordinate for sorting traces by default (\fBstreams.sort.*\fP),
.IP \(bu 2
region filters (\fBstreams.region.*\fP),
.IP \(bu 2
\fI\%grouping of streams\fP with different properties,
.IP \(bu 2
number of traces to show with fixed height (\fI\%streams.rows\fP).
.UNINDENT
.IP \(bu 2
Scheme parameters in global \fI\%module\fP configuration:
.INDENT 2.0
.IP \(bu 2
trace properties and trace background colors,
.IP \(bu 2
font and general GUI parameters.
.UNINDENT
.UNINDENT
.sp
More parameters are available on the command\-line:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
scrttv \-h
.ft P
.fi
.UNINDENT
.UNINDENT
.SH MODES OF OPERATION
.sp
scrttv can be started in message mode or in offline mode.
.INDENT 0.0
.IP \(bu 2
Message mode: scrttv is started normally and connects to the messaging,
picks, \fI\%origins\fP and inventory are read from
the database and received in real time from the messaging. Data are received
from \fI\%recordstream\fP\&.
.IP \(bu 2
Offline mode: scrttv is started without connection to the messaging,
picks and \fI\%origins\fP are not received in real
time from the messaging. However, they can be loaded from XML files using the
\fIFile\fP menu. Data are received from \fI\%recordstream\fP or from file. The
offline mode is invoked when using the option \fB\-\-offline\fP or when
passing a file name to scrttv at startup. Example:
.INDENT 2.0
.INDENT 3.5
.sp
.nf
.ft C
scrttv file.mseed
.ft P
.fi
.UNINDENT
.UNINDENT
.UNINDENT
.SH WAVEFORM VISUALIZATION
.SS Stream selection
.sp
Without further configuration scrttv displays waveforms for streams defined
in global bindings. The selection can be refined by configuring
\fI\%streams.codes\fP and overridden on the command line using
\fB\-\-channels\fP\&.
.SS Stream hiding
.sp
Streams with \fI\%data latency\fP < \fI\%maxDelay\fP are hidden but
shown again when applicable. By default \fI\%maxDelay\fP is unconfigured and
hiding streams is inactive. For listing
streams hidden from one tab press \fBh\fP\&.
.SS Time windows
.sp
The reading waveforms from RecordStream, the data is displayed for a time
window which by default ends at current time or as given by the command\-line
option \fB\-\-end\-time\fP\&. Initially, the time window takes the length defined
in \fI\%bufferSize\fP or by the option \fB\-\-buffer\-size\fP\&. When reading data
directly from file in offline mode, the time window is set
from the time limits of the waveforms.
.INDENT 0.0
.IP \(bu 2
The \fBlength of visible time windows\fP can be adjusted by
\fI\%zooming\fP\&.
.IP \(bu 2
The \fBend time of the data\fP progresses in continuously in real time (UTC)
with the time of the computer clock unless fixed (\fBF8\fP). The end time is
fixed during startup when applying \fB\-\-end\-time\fP\&.
.IP \(bu 2
For \fBprogressing or rewinding by 30 minutes\fP press \fBAlt right\fP or
\fBAlt left\fP, respectively. Data will be loaded immediately.
.IP \(bu 2
You may also \fBfreely zoom\fP into any time window. Data and picks will be loaded
when pressing \fBCtrl + r\fP
.IP \(bu 2
\fBReturn to default real\-time processing\fP by pressing \fBCtrl + Shift + r\fP
or \fBN\fP\&.
.UNINDENT
.sp
\fBHINT:\fP
.INDENT 0.0
.INDENT 3.5
Gaps and overlaps in waveforms are indicated by yellow and purple areas,
respectively. The colors are configurable.
.UNINDENT
.UNINDENT
.SS Zooming
.sp
Waveforms can be zoomed in and out interactively in amplitude and time. Use the
\fIView\fP menu or refer to the section \fI\%Hotkeys\fP for options. In
addition to the actions available from the View menu, zooming is supported by
mouse actions:
.INDENT 0.0
.IP \(bu 2
Zooming in in time: Right\-click on time axis, drag to the right. A green bar appears
which is the new time window. Dragging up or down (gray bar) disables zooming.
.IP \(bu 2
Zooming out in time: Right\-click on time axis, drag to the left. A red bar appears. The
longer the bar, the more you zoom out. Dragging up or down (gray bar)
disables zooming.
.IP \(bu 2
Zooming in time and amplitude: Mouse over a trace of interest, use
\fBCtrl + mouse wheel\fP for zooming in or out.
.IP \(bu 2
Zooming around a selected area: Press \fBz\fP and drag an area with while
pressing the left mouse button. Press \fBz\fP again for leaving the zoom
mode.
.UNINDENT
.SS Stream grouping
.sp
scrttv allows grouping of stations and even streams with different properties,
e.g. colors or color gradients.
.INDENT 0.0
.INDENT 2.5
[image]
Stations with 2 groups and different line color gradients. Ungrouped stations
are visible with default line properties. The applied filter
is shown in the lower left corner. The tooltip on top of station CX.PB19
is derived from \fI\%streams.group.$name.title\fP\&..UNINDENT
.UNINDENT
.sp
\fBConfiguration\fP
.sp
Adjust the scrttv module configuration (\fBscrttv.cfg\fP).
.INDENT 0.0
.IP 1. 3
Define the groups:
.INDENT 3.0
.IP \(bu 2
add a new group profile to \fBstreams.group\fP\&.
.IP \(bu 2
set the properties for this group profile. \fI\%Colors\fP and color
gradients are defined by hexadecimal values or by
\fI\%color keyword name\fP\&.
When choosing gradients the colors of the traces within one group will be
varied in alphabetic order of the streams.
.IP \(bu 2
set a group title in \fI\%streams.group.$name.title\fP\&.
.UNINDENT
.IP 2. 3
Register the groups in \fI\%streams.groups\fP\&.
.UNINDENT
.sp
\fBViewing groups\fP
.INDENT 0.0
.IP 1. 3
Open \fBscrttv\fP to view the data.
.IP 2. 3
Select \fISort by group\fP in the \fIInteraction\fP menu or use the hotkey \fB5\fP
to sort the traces by their groups.
.IP 3. 3
Mouse over a station belonging to a group. The tooltips shows the group title.
.IP 4. 3
For maintaining the sorting by groups adjust the \fBscrttv\fP module
configuration (\fBscrttv.cfg\fP):
.INDENT 3.0
.INDENT 3.5
.sp
.nf
.ft C
resortAutomatically = false
.ft P
.fi
.UNINDENT
.UNINDENT
.UNINDENT
.SS Phase picks and arrivals
.sp
Previous versions of scrttv (< 5.4) only displayed \fI\%picks\fP with the
colors indicating the pick evaluation mode along with the phase hint of the
pick:
.INDENT 0.0
.IP \(bu 2
red: automatic,
.IP \(bu 2
green: manual.
.UNINDENT
.sp
This hasn\(aqt really changed in later versions but additionally scrttv determines
an additional state of a pick called \fI\%arrival\fP\&. In scrttv a pick is
considered an arrival if it is associated to an valid origin. An origin is
called valid if its evaluation status is not REJECTED. When scrttv loads all
picks from the database for the currently visible time span it also checks if
each pick is associated with a valid origin and declares the arrival state if
the check yields true. The visibility of picks and arrivals can be toggled by
pressing \fBCtrl + p\fP and \fBCtrl + a\fP, respectively. \fBc\fP removes all
markers. The configuration parameter \fI\%showPicks\fP controls the default
visibility.
.sp
Picks and arrivals can be differentiated visually by their colours. When
configured in global module configuration, the same colours are being used
consistently as in any other GUI displaying both types, namely
.INDENT 0.0
.IP \(bu 2
\fI\%scheme.colors.picks.automatic\fP
.IP \(bu 2
\fI\%scheme.colors.picks.manual\fP
.IP \(bu 2
\fI\%scheme.colors.picks.undefined\fP
.IP \(bu 2
\fI\%scheme.colors.arrivals.automatic\fP
.IP \(bu 2
\fI\%scheme.colors.arrivals.manual\fP
.IP \(bu 2
\fI\%scheme.colors.arrivals.undefined\fP
.UNINDENT
.sp
That visual difference should support the operator in finding clusters of picks
and creating new location missed by the automatic system.
.sp
The next sections will only use the \fI\%pick\fP which can be used
interchangeable for pick or arrival.
.SS Record borders
.sp
The borders of records are toggled by using the hotkey \fBb\fP\&.
.INDENT 0.0
.INDENT 2.5
[image]
Record borders in box mode on top of waveforms..UNINDENT
.UNINDENT
.sp
Border properties can be adjusted and signed records can be visualized by colors
configured in the scheme parameters in \fBglobal.cfg\fP or \fBscrttv.cfg\fP:
.INDENT 0.0
.IP \(bu 2
\fI\%scheme.records.borders.drawMode\fP: Define where to draw borders, e.g. on top, bottom or as boxes.
.IP \(bu 2
\fBscheme.colors.records.borders.*\fP: Define pen and brush properties.
.UNINDENT
.SH WAVEFORM QUALITY CONTROL
.sp
Use scrttv for regular visual waveform inspection and for enabling or disabling
of stations. Disabled stations will not be used for automatic phase detections
and can be excluded from manual processing in \fI\%scolv\fP\&. They will also be
highlighted in \fI\%scmv\fP and \fI\%scqc\fP\&.
.sp
To enable or disable a station for automatic data processing in \fISeisComP\fP select
a station code with the mouse and drag the stations to the disable / enable tab
or simply double\-click on the station code in the respective tab.
.SH STREAM PROCESSING
.SS Filtering
.sp
scrttv allows filtering of waveforms. Any
\fI\%filter available in SeisComP\fP can be considered. The
filter selection dropdown menu (see \fI\%Figure above\fP)
and the hotkeys \fBg\fP or \fBd\fP can be used to toggle the list of filters.
This list of pre\-defined in \fI\%filter\fP or in \fI\%filters\fP\&. You may
switch between filtere and unfiltered data by pressing \fBf\fP\&. To show
filtered and raw data together use the hotkey \fBr\fP\&.
.sp
\fBNOTE:\fP
.INDENT 0.0
.INDENT 3.5
The list of filters defined in \fI\%filters\fP overwrites \fI\%filter\fP\&.
Activate \fI\%autoApplyFilter\fP to filter all traces at start\-up of scrttv
with the first filter defined in \fI\%filters\fP\&.
.UNINDENT
.UNINDENT
.SS Gain correction
.sp
The stream gain is applied to waveforms and amplitude values are given in the
physical units defined in the inventory of the stream by default. For showing
amplitudes in counts, deactivate the option \fIApply gain\fP in the Interaction menu.
.SH INTERACTIVE SIGNAL DETECTION
.sp
Beside visual inspection of waveforms for quality control, scrttv can also be
used for interactive signal detection in real time or for selected time windows
in the past.
.SS Artificial origins
.INDENT 0.0
.INDENT 2.5
[image]
Artificial origin..UNINDENT
.UNINDENT
.sp
In case the operator recognizes several seismic signals which shall be processed
further, e.g. in \fI\%scolv\fP, an artificial/preliminary origin can be set by
either pressing the middle mouse
button on a trace or by opening the context menu (right mouse button) on a trace
and selecting \(dqCreate artificial origin\(dq. The following pop\-up window shows the
coordinates of the selected station and the time the click was made on the
trace. The coordinates and time define the hypocenter parameters of the the new
artificial origin without adding any arrivals.
Pressing \(dqCreate\(dq sends this origin to the LOCATION group. This artificial
origin is received e.g., by \fI\%scolv\fP and enables an immediate manual analysis
of the closest traces.
.sp
In order to send artificial origins and receive them in other GUIs
\fI\%commands.target\fP of the global module configuration must be configured
in line with \fI\%connection.username\fP of the receiving GUI module.
.sp
Alternatively, picks can be selected and preliminary origins can be created
which are sent to the system as regular origin objects, see section
\fI\%Pick association\fP\&.
.SS Pick association
.sp
scrttv comes with a minimal version of a phase associator and manual locator
based on selected and associated picks (Fig. \fI\%scrttv overview\fP). The
workflow is:
.INDENT 0.0
.IP 1. 3
Visually identify phase picks which potentially belong to an event of interest,
.IP 2. 3
\fI\%Select these picks\fP for automatic association,
.IP 3. 3
\fI\%Control\fP the locator,
.IP 4. 3
\fI\%Commit\fP created origins along with all associated
picks.
.UNINDENT
.sp
Origins are committed to the messaging system as manual but preliminary location.
In contrast to the artificial origin operation which requires an immediate
intervention with, e.g. \fI\%scolv\fP, this operation allows to store all those
detected origins and work on them later because they will be stored in the
database.
.sp
\fBNOTE:\fP
.INDENT 0.0
.INDENT 3.5
More detailed waveform and event analysis can be made in \fI\%scolv\fP\&.
.UNINDENT
.UNINDENT
.SS Pick selection
.sp
In order to select picks, the pick association mode must be entered. When done,
clicking with mouse onto the data and dragging a box (rubber band) around the
picks of interest will add the picks to a \(dqcart\(dq.
\(dqcart\(dq refers to the list of selected picks which then available in the
associator/locator control widget used for locating an origin.
.sp
Simply dragging a new box will remove all previously selected picks. Further
keyboard\-mouse options are:
.INDENT 0.0
.IP \(bu 2
\fBShift + drag\fP: Add more picks to the while keeping the previous selection.
.IP \(bu 2
\fBCtrl + drag\fP: Remove selected picks from the previous selection.
.UNINDENT
.sp
If at least one pick has been selected, the associator control will open as a
dock widget for locating based on the selected picks. There, individual picks
can also be removed from the selection by clicking on the close icon of each
pick item. Selected picks are also highlighted in the traces by a color
background bar.
.sp
\fBNOTE:\fP
.INDENT 0.0
.INDENT 3.5
A dock widget is a special kind of window which can be docked to any border
of the application or even displayed floated as kind of overlay window. The
position of the dock widget will be persistent across application restarts.
.UNINDENT
.UNINDENT
.sp
At any change of the pick set, the associator will attempt a relocation
displaying the results in the details. Error message will show up at the top.
.SS Locating from picks
.sp
The associator control exposes all locators available in the system presenting them
in a dropdown list at the bottom. The locator which should be selected as default
can be controlled with \fI\%associator.defaultLocator\fP and its default
profile by \fI\%associator.defaultLocatorProfile\fP\&.
.sp
Whenever the operator changes any of the values, a new location attempt is being
made which can succeed or fail. A successful attempt will update the details,
a failed attempt will reset the details and print an error message at the top
of the window.
.sp
Each locator can be configured locally by clicking the wrench icon. This
configuration is not persistent across application restarts. It can be used
to tune and test various settings. Global locator configurations in the
configuration files are of course being considered by scrttv.
.sp
In addition to the locator and its profile a fixed depth can be set. By default
the depth is free and it is up to the locator implementation to assign a depth
to the origin. The depth dropdown list allows to set a predefined depth. The
list of depth values can be controlled with \fI\%associator.fixedDepths\fP\&.
.SS Committing a solution
.sp
Once you accept a solution you may press the button \(dqCommit\(dq be for sending it
to the messaging as a regular origin. The receiving message group is defined by
\fI\%messaging.groups.location\fP\&. The new origin is then grabbed by all
connected modules, e.g., \fI\%scevent\fP and possibly associated to an
\fI\%event\fP\&.
.sp
\fBNOTE:\fP
.INDENT 0.0
.INDENT 3.5
When considering non\-default message groups such as in multi\-pipeline systems,
\fI\%messaging.groups.location\fP should be configuring accordingly.
.UNINDENT
.UNINDENT
.sp
Alternatively, the button \(dqShow Details\(dq can be used to just send the origin to
the GUI group and let \fI\%scolv\fP or other GUIs pick it up and show it. This
will not store the origin in the database and works the same way as creating
\fI\%artificial origins\fP\&.
.SH HOTKEYS
.TS
center;
|l|l|.
_
T{
Hotkey
T} T{
Description
T}
_
T{
\fBF1\fP
T} T{
Open \fISeisComP\fP documentation
T}
_
T{
\fBShift+F1\fP
T} T{
Open scrttv documentation
T}
_
T{
\fBF2\fP
T} T{
Setup connection dialog
T}
_
T{
\fBF11\fP
T} T{
Toggle fullscreen
T}
_
T{
\fBESC\fP
T} T{
Set standard selection mode and deselect all traces
T}
_
T{
\fBc\fP
T} T{
Clear picker markers
T}
_
T{
\fBb\fP
T} T{
Toggle record borders
T}
_
T{
\fBh\fP
T} T{
List hidden streams
T}
_
T{
\fBCtrl+a\fP
T} T{
Toggle showing arrivals
T}
_
T{
\fBCtrl+p\fP
T} T{
Toggle showing picks
T}
_
T{
\fBn\fP
T} T{
Restore default display
T}
_
T{
\fBo\fP
T} T{
Align by origin time
T}
_
T{
\fBp\fP
T} T{
Enable pick selection mode
T}
_
T{
\fBAlt+left\fP
T} T{
Reverse the data time window by buffer size
T}
_
T{
\fBAlt+right\fP
T} T{
Advance the data time window by buffer size
T}
_
T{
\fBFiltering\fP
T} T{
T}
_
T{
\fBf\fP
T} T{
Toggle filtering
T}
_
T{
\fBd\fP
T} T{
Switch to previous filter in list if filtering is enabled.
T}
_
T{
\fBg\fP
T} T{
Switch to next filter in list if filtering is enabled.
T}
_
T{
\fBr\fP
T} T{
Toggle showing all records
T}
_
T{
\fBNavigation\fP
T} T{
T}
_
T{
\fBCtrl+f\fP
T} T{
Search traces
T}
_
T{
\fBup\fP
T} T{
Line up
T}
_
T{
\fBdown\fP
T} T{
Line down
T}
_
T{
\fBPgUp\fP
T} T{
Page up
T}
_
T{
\fBPgDn\fP
T} T{
Page down
T}
_
T{
\fBAlt+PgUp\fP
T} T{
To top
T}
_
T{
\fBAlt+PgDn\fP
T} T{
To bottom
T}
_
T{
\fBleft\fP
T} T{
Scroll left
T}
_
T{
\fBright\fP
T} T{
Scroll right
T}
_
T{
\fBCtrl+left\fP
T} T{
Align left
T}
_
T{
\fBCtrl+right\fP
T} T{
Align right
T}
_
T{
\fBNavigation and data\fP
T} T{
T}
_
T{
\fBAlt+left\fP
T} T{
Rewind time window by 30\(aq and load data
T}
_
T{
\fBAlt+right\fP
T} T{
Progress time window by 30\(aq and load data
T}
_
T{
\fBCtrl+r\fP
T} T{
(Re)load data in current visible time range
T}
_
T{
\fBCtrl+Shift+r\fP
T} T{
Switch to real\-time with configured buffer size
T}
_
T{
\fBSorting\fP
T} T{
T}
_
T{
\fB1\fP
T} T{
Restore configuration order of traces
T}
_
T{
\fB2\fP
T} T{
Sort traces by distance
T}
_
T{
\fB3\fP
T} T{
Sort traces by station code
T}
_
T{
\fB4\fP
T} T{
Sort traces by network\-station code
T}
_
T{
\fB5\fP
T} T{
Sort traces by group
T}
_
T{
\fBZooming\fP
T} T{
T}
_
T{
\fB<\fP
T} T{
Horizontal zoom\-in
T}
_
T{
\fB>\fP
T} T{
Horizontal zoom\-out
T}
_
T{
\fBy\fP
T} T{
Vertical zoom\-out
T}
_
T{
\fBShift+y\fP
T} T{
Vertical zoom\-in
T}
_
T{
\fBs\fP
T} T{
Toggle amplitude normalization
T}
_
T{
\fBCtrl+mouse wheel\fP
T} T{
Vertical and horizontal zooming
T}
_
T{
\fBz\fP
T} T{
Enable/disable zooming: Drag window with left mouse button
T}
_
.TE
.SH MODULE CONFIGURATION
.nf
\fBetc/defaults/global.cfg\fP
\fBetc/defaults/scrttv.cfg\fP
\fBetc/global.cfg\fP
\fBetc/scrttv.cfg\fP
\fB~/.seiscomp/global.cfg\fP
\fB~/.seiscomp/scrttv.cfg\fP
.fi
.sp
.sp
scrttv inherits \fI\%global options\fP\&.
.INDENT 0.0
.TP
.B maxDelay
Default: \fB0\fP
.sp
Type: \fIint\fP
.sp
Unit: \fIs\fP
.sp
If greater than 0, then all traces for which the data latency is
higher than this value are hidden. 0 disables the feature.
.UNINDENT
.INDENT 0.0
.TP
.B resortAutomatically
Default: \fBtrue\fP
.sp
Type: \fIboolean\fP
.sp
If enabled, then all traces are sorted by distance when a new
origin arrives.
.UNINDENT
.INDENT 0.0
.TP
.B showPicks
Default: \fBtrue\fP
.sp
Type: \fIboolean\fP
.sp
If enabled, picks are shown.
.UNINDENT
.INDENT 0.0
.TP
.B mapPicks
Default: \fBfalse\fP
.sp
Type: \fIboolean\fP
.sp
Map picks to best matching rows. This is important
if picks created on BHN should be shown but only the BHZ trace
is part of the list. Network code, station code and location code
must match anyway.
.UNINDENT
.INDENT 0.0
.TP
.B filter
Type: \fIstring\fP
.sp
Define the filter to be used when filtering is activated. This
parameter is ignored if \(dqfilters\(dq is configured.
This parameter exists mainly for backward compatibility.
.UNINDENT
.INDENT 0.0
.TP
.B filters
Default: \fB\(dqRMHP(2)>>ITAPER(5)>>BW(3,0.5,8.0)\(dq,\(dqRMHP(2)>>ITAPER(5)>>BW_HP(3, 3)\(dq\fP
.sp
Type: \fIlist:string\fP
.sp
Define a list of filters that is cycles through when pressing
\(aqG\(aq or \(aqD\(aq. Filtering is toggled with \(aqF\(aq.
This parameter supersedes \(dqfilter\(dq. If undefined,
\(dqfilter\(dq is used instead. If defined, this filter
list is used exclusively and the filter option is ignored.
.sp
Formats:
.sp
\(dqfilter grammar\(dq: filter grammar is shown in
the scrttv filter selection and applied.
.sp
\(dqname;filter grammar\(dq: name is shown in the scrttv
filter selection but filter grammar is applied.
.UNINDENT
.INDENT 0.0
.TP
.B autoApplyFilter
Default: \fBfalse\fP
.sp
Type: \fIboolean\fP
.sp
Activate the first filter of the configured filter list
after startup. This is equivalent to pressing \(aqf\(aq.
.UNINDENT
.INDENT 0.0
.TP
.B bufferSize
Default: \fB1800\fP
.sp
Type: \fIint\fP
.sp
Unit: \fIs\fP
.sp
Define the buffer size in seconds of the ring bu of each trace.
.UNINDENT
.INDENT 0.0
.TP
.B allTracesInitiallyVisible
Default: \fBfalse\fP
.sp
Type: \fIboolean\fP
.sp
If set to true, all traces will be visible on application startup
independent of data availability.
.UNINDENT
.INDENT 0.0
.TP
.B autoResetDelay
Default: \fB900\fP
.sp
Type: \fIint\fP
.sp
Unit: \fIs\fP
.sp
Time span in seconds to switch back to the last view after an origin
caused resorting. The default is 15 min.
.UNINDENT
.INDENT 0.0
.TP
.B 3c
Default: \fBfalse\fP
.sp
Type: \fIboolean\fP
.sp
If enabled, all three components (vertical, 1st and 2nd horizontal)
related to the detecStream will be shown rather than only the
component configured in global bindings. The option is ignored
when using \-\-no\-inventory.
.UNINDENT
.INDENT 0.0
.TP
.B messaging.groups.config
Default: \fBCONFIG\fP
.sp
Type: \fIstring\fP
.sp
The messaging group to which config messages (such
as station enable/disable messages) are being sent.
.UNINDENT
.INDENT 0.0
.TP
.B messaging.groups.location
Default: \fBLOCATION\fP
.sp
Type: \fIstring\fP
.sp
The messaging group to which location messages
are being sent.
.UNINDENT
.INDENT 0.0
.TP
.B streams.codes
Type: \fIlist:string\fP
.sp
The list of channel codes to be displayed. List items
may contain wildcards at any position and are separated
by comma. Wildcard support depends on RecordStream,
e.g.:
.sp
caps/sdsarchive: *.*.*.*
.sp
slink: NET.STA.*.*
.sp
The channel list is intersected with all channels
configured in inventory unless \-\-no\-inventory is used.
.sp
Examples:
.sp
default : display all streams configured by global
bindings
.sp
default, PF.BON.00.HH? : display default and all HH
streams of PF.BON.00
.UNINDENT
.INDENT 0.0
.TP
.B streams.blacklist
Type: \fIlist:string\fP
.sp
If not empty then all stream patterns are part of the blacklist.
The blacklist is only active if \(dqstreams.codes\(dq
is omitted and the default stream list according to the
bindings is to be shown. Each pattern can include wildcards
(either ? or *). The pattern is checked against the channel
id which is a concatenation of network code, station code,
location code and channel code separated with a dot,
e.g. \(dqGE.MORC..BHZ\(dq.
.UNINDENT
.INDENT 0.0
.TP
.B streams.rows
Type: \fIinteger\fP
.sp
Number of rows to show at once in one windows. If more traces
than rows are loaded, the are accessible by a scroll bar.
.UNINDENT
.INDENT 0.0
.TP
.B streams.groups
Type: \fIstring\fP
.sp
Stream group profiles to be considered which must be defined in
group section. Use comma separation for a list of groups.
.UNINDENT
.INDENT 0.0
.TP
.B streams.profiles
Type: \fIstring\fP
.sp
Stream profiles to be considered which must be defined in
profile section. Use comma separation for a list of profiles.
.UNINDENT
.sp
\fBNOTE:\fP
.INDENT 0.0
.INDENT 3.5
\fBstreams.sort.*\fP
\fIConfigure the initial stream sorting.\fP
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B streams.sort.mode
Default: \fBdistance\fP
.sp
Type: \fIstring\fP
.sp
The sort mode applied initially. Allowed values
are: config, distance, station, network, group.
.UNINDENT
.INDENT 0.0
.TP
.B streams.sort.latitude
Default: \fB0.0\fP
.sp
Type: \fIdouble\fP
.sp
Unit: \fIdeg\fP
.sp
Latitude of the initial location for sorting traces.
Only valid if mode == distance.
.UNINDENT
.INDENT 0.0
.TP
.B streams.sort.longitude
Default: \fB0.0\fP
.sp
Type: \fIdouble\fP
.sp
Unit: \fIdeg\fP
.sp
Longitude of the initial location for sorting traces.
Only valid if mode == distance.
.UNINDENT
.sp
\fBNOTE:\fP
.INDENT 0.0
.INDENT 3.5
\fBstreams.region.*\fP
\fIDefine a region used for clipping requested stations.\fP
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B streams.region.lonmin
Default: \fB\-180.0\fP
.sp
Type: \fIdouble\fP
.sp
Unit: \fIdeg\fP
.sp
Minimum longitude.
.UNINDENT
.INDENT 0.0
.TP
.B streams.region.lonmax
Default: \fB180.0\fP
.sp
Type: \fIdouble\fP
.sp
Unit: \fIdeg\fP
.sp
Maximum longitude.
.UNINDENT
.INDENT 0.0
.TP
.B streams.region.latmin
Default: \fB\-90.0\fP
.sp
Type: \fIdouble\fP
.sp
Unit: \fIdeg\fP
.sp
Minimum latitude.
.UNINDENT
.INDENT 0.0
.TP
.B streams.region.latmax
Default: \fB90.0\fP
.sp
Type: \fIdouble\fP
.sp
Unit: \fIdeg\fP
.sp
Maximum latitude.
.UNINDENT
.sp
\fBNOTE:\fP
.INDENT 0.0
.INDENT 3.5
\fBstreams.group.*\fP
\fIDefiniton of stream groups shown in scrttv with unique features.\fP
\fIRegister the profiles in \(dqgroups\(dq to apply them.\fP
.UNINDENT
.UNINDENT
.sp
\fBNOTE:\fP
.INDENT 0.0
.INDENT 3.5
\fBstreams.group.$name.*\fP
$name is a placeholder for the name to be used and needs to be added to \fI\%streams.groups\fP to become active.
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
streams.groups = a,b
streams.group.a.value1 = ...
streams.group.b.value1 = ...
# c is not active because it has not been added
# to the list of streams.groups
streams.group.c.value1 = ...
.ft P
.fi
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B streams.group.$name.members
Type: \fIlist:string\fP
.sp
List of channels codes to be displayed within
this group. List items may contain wildcards at any position
and are separated by comma.
The list is intersected with all channels configured in inventory.
.sp
Example:
.sp
CX.*..BH?,PF.BON.00.HH? : all BH streams of the CX network
and all HH streams of PF.BON.00
.UNINDENT
.INDENT 0.0
.TP
.B streams.group.$name.title
Type: \fIstring\fP
.sp
Title of the group visible as a tooltip of the traces.
.UNINDENT
.sp
\fBNOTE:\fP
.INDENT 0.0
.INDENT 3.5
\fBstreams.group.$name.pen.*\fP
\fIDefine the trace pen of the group.\fP
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B streams.group.$name.pen.color
Type: \fIcolor\fP
.sp
The color of the pen. If not given, the default
trace color is being used. The parameter is overridden
by \(dqstreams.group.$profile.gradient\(dq .
.UNINDENT
.INDENT 0.0
.TP
.B streams.group.$name.pen.gradient
Type: \fIgradient\fP
.sp
Define the color gradient used to generate the
trace color for each group member. When given, the
value in \(dqstreams.group.$profile.pen.color\(dq
is ignored. The colors are distributed equally and
given in hexadecimal representation or by or
color keyword names\&.
The stop points
can be set at any value. The final trace color
will be interpolated from the normalized gradient
where the value range is scaled to [0,1].
.sp
Format: value1:color1,value2:color2
.sp
Examples:
.sp
0:yellow,1:green
.sp
0:FFBF00,1:C70039
.UNINDENT
.INDENT 0.0
.TP
.B streams.group.$name.pen.style
Default: \fBSolidLine\fP
.sp
Type: \fIstring\fP
.sp
The style of the pen. Supported values are: NoPen,
SolidLine, DashLine, DotLine, DashDotLine,
DashDotDotLine.
.UNINDENT
.INDENT 0.0
.TP
.B streams.group.$name.pen.width
Default: \fB1.0\fP
.sp
Type: \fIdouble\fP
.sp
Unit: \fIpx\fP
.sp
The width of the pen.
.UNINDENT
.sp
\fBNOTE:\fP
.INDENT 0.0
.INDENT 3.5
\fBstreams.profile.*\fP
\fIDefiniton of profiles for streams shown with unique decorations.\fP
\fIRegister the profiles in \(dqprofiles\(dq to apply them.\fP
.UNINDENT
.UNINDENT
.sp
\fBNOTE:\fP
.INDENT 0.0
.INDENT 3.5
\fBstreams.profile.$name.*\fP
$name is a placeholder for the name to be used and needs to be added to \fI\%streams.profiles\fP to become active.
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
streams.profiles = a,b
streams.profile.a.value1 = ...
streams.profile.b.value1 = ...
# c is not active because it has not been added
# to the list of streams.profiles
streams.profile.c.value1 = ...
.ft P
.fi
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B streams.profile.$name.match
Type: \fIstring\fP
.sp
Stream applying this profile to. Use regular expressions
for defining multiple streams. Examples:
.sp
GR.BFO.00.BHZ: One stream on vertical component
.sp
GR.*.00.BHZ: All stations from GR network and their
vertical components.
.UNINDENT
.INDENT 0.0
.TP
.B streams.profile.$name.description
Type: \fIstring\fP
.sp
Text added to streams.
.UNINDENT
.INDENT 0.0
.TP
.B streams.profile.$name.minMaxMargin
Default: \fB0.0\fP
.sp
Type: \fIdouble\fP
.sp
Fraction of trace amplitude added to trace widgets.
.UNINDENT
.INDENT 0.0
.TP
.B streams.profile.$name.unit
Type: \fIstring\fP
.sp
The physical unit shown along with stream maximum and
minimum values.
.UNINDENT
.INDENT 0.0
.TP
.B streams.profile.$name.gain
Default: \fB0.0\fP
.sp
Type: \fIdouble\fP
.sp
The gain applied to scale trace amplitudes. 0 disables
showing trace amplitude value
.UNINDENT
.INDENT 0.0
.TP
.B streams.profile.$name.fixedScale
Default: \fBfalse\fP
.sp
Type: \fIboolean\fP
.UNINDENT
.sp
\fBNOTE:\fP
.INDENT 0.0
.INDENT 3.5
\fBstreams.profile.$name.minimum.*\fP
\fIProperties defining the minimum line on each trace.\fP
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B streams.profile.$name.minimum.value
Default: \fB0.0\fP
.sp
Type: \fIdouble\fP
.sp
Value at which to draw a line.
.UNINDENT
.sp
\fBNOTE:\fP
.INDENT 0.0
.INDENT 3.5
\fBstreams.profile.$name.minimum.pen.*\fP
\fILine properties.\fP
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B streams.profile.$name.minimum.pen.width
Default: \fB1\fP
.sp
Type: \fIstring\fP
.UNINDENT
.INDENT 0.0
.TP
.B streams.profile.$name.minimum.pen.style
Default: \fBsolidline\fP
.sp
Type: \fIstring\fP
.UNINDENT
.INDENT 0.0
.TP
.B streams.profile.$name.minimum.pen.color
Default: \fB000000ff\fP
.sp
Type: \fIstring\fP
.UNINDENT
.sp
\fBNOTE:\fP
.INDENT 0.0
.INDENT 3.5
\fBstreams.profile.$name.minimum.brush.*\fP
\fIProperties of the area below the minimum.\fP
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B streams.profile.$name.minimum.brush.style
Default: \fBnobrush\fP
.sp
Type: \fIstring\fP
.UNINDENT
.INDENT 0.0
.TP
.B streams.profile.$name.minimum.brush.color
Default: \fB000000ff\fP
.sp
Type: \fIstring\fP
.UNINDENT
.sp
\fBNOTE:\fP
.INDENT 0.0
.INDENT 3.5
\fBstreams.profile.$name.maximum.*\fP
\fIProperties defining the maximum line on each trace.\fP
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B streams.profile.$name.maximum.value
Default: \fB0.0\fP
.sp
Type: \fIdouble\fP
.sp
Value at which to draw a line.
.UNINDENT
.sp
\fBNOTE:\fP
.INDENT 0.0
.INDENT 3.5
\fBstreams.profile.$name.maximum.pen.*\fP
\fILine properties.\fP
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B streams.profile.$name.maximum.pen.width
Default: \fB1\fP
.sp
Type: \fIstring\fP
.UNINDENT
.INDENT 0.0
.TP
.B streams.profile.$name.maximum.pen.style
Default: \fBsolidline\fP
.sp
Type: \fIstring\fP
.UNINDENT
.INDENT 0.0
.TP
.B streams.profile.$name.maximum.pen.color
Default: \fB000000ff\fP
.sp
Type: \fIstring\fP
.UNINDENT
.sp
\fBNOTE:\fP
.INDENT 0.0
.INDENT 3.5
\fBstreams.profile.$name.maximum.brush.*\fP
\fIProperties of the area above the maximum.\fP
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B streams.profile.$name.maximum.brush.style
Default: \fBnobrush\fP
.sp
Type: \fIstring\fP
.UNINDENT
.INDENT 0.0
.TP
.B streams.profile.$name.maximum.brush.color
Default: \fB000000ff\fP
.sp
Type: \fIstring\fP
.UNINDENT
.sp
\fBNOTE:\fP
.INDENT 0.0
.INDENT 3.5
\fBassociator.*\fP
\fIDefine parameters for manually associating phases to origin and\fP
\fIfor locating the origins.\fP
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B associator.defaultLocator
Type: \fIstring\fP
.sp
The locator which is activated as default locator.
.UNINDENT
.INDENT 0.0
.TP
.B associator.defaultLocatorProfile
Type: \fIstring\fP
.sp
The locator profile which is activated as default profile for
the default locator.
.UNINDENT
.INDENT 0.0
.TP
.B associator.fixedDepths
Default: \fB0, 10, 18\fP
.sp
Type: \fIlist:double\fP
.sp
Unit: \fIkm\fP
.sp
A list of depths used to populate the locator depth selection
dropdown list.
.UNINDENT
.sp
\fBNOTE:\fP
.INDENT 0.0
.INDENT 3.5
\fBspectrogram.*\fP
\fIDefine parameters for spectrogram representation.\fP
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B spectrogram.smoothing
Default: \fBfalse\fP
.sp
Type: \fIboolean\fP
.sp
Whether to plot the spectrogram filtered bilinearily.
.UNINDENT
.INDENT 0.0
.TP
.B spectrogram.logScale
Default: \fBfalse\fP
.sp
Type: \fIboolean\fP
.sp
Whether to use logarithmic frequency scale.
.UNINDENT
.INDENT 0.0
.TP
.B spectrogram.normalization
Default: \fBfixed\fP
.sp
Type: \fIstring\fP
.sp
Which amplitude normalization mode to use: \(dqfixed\(dq,
\(dqfrequency\(dq or \(dqtime\(dq.
.UNINDENT
.INDENT 0.0
.TP
.B spectrogram.axis
Default: \fBfalse\fP
.sp
Type: \fIboolean\fP
.sp
Whether to show the frequency axis.
.UNINDENT
.INDENT 0.0
.TP
.B spectrogram.minimumAmplitude
Default: \fB\-15\fP
.sp
Type: \fIdouble\fP
.sp
Unit: \fIlog(ps)\fP
.sp
The lower bound of the static amplitude range give as logarithm of
the power spectrum (log(real**2 + imag**2)).
.UNINDENT
.INDENT 0.0
.TP
.B spectrogram.maximumAmplitude
Default: \fB\-5\fP
.sp
Type: \fIdouble\fP
.sp
Unit: \fIlog(ps)\fP
.sp
The upper bound of the static amplitude range give as logarithm of
the power spectrum (log(real**2 + imag**2)).
.UNINDENT
.INDENT 0.0
.TP
.B spectrogram.minimumFrequency
Default: \fB0\fP
.sp
Type: \fIdouble\fP
.sp
Unit: \fIHz\fP
.sp
The lower bound of the frequency to be shown.
.UNINDENT
.INDENT 0.0
.TP
.B spectrogram.maximumFrequency
Default: \fB0\fP
.sp
Type: \fIdouble\fP
.sp
Unit: \fIHz\fP
.sp
The upper bound of the frequency to be shown. Zero is a special
value and means \(dqauto\(dq and sets the maximum
frequency from the spectra.
.UNINDENT
.INDENT 0.0
.TP
.B spectrogram.timeSpan
Default: \fB20\fP
.sp
Type: \fIdouble\fP
.sp
Unit: \fIs\fP
.sp
The time span of each data slice used to compute the
frequency spectrum.
.UNINDENT
.INDENT 0.0
.TP
.B spectrogram.overlap
Default: \fB0.5\fP
.sp
Type: \fIdouble\fP
.sp
The overlap of the data time window between zero and one
(exclusive).
.UNINDENT
.SH COMMAND-LINE OPTIONS
.sp
\fBscrttv [options] [miniSEED file]\fP
.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 \-\-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
.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
.INDENT 0.0
.TP
.B \-\-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.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-trace
Execute in trace mode.
Equivalent to \-\-verbosity=4 \-\-console=1 \-\-print\-component=1
\-\-print\-context=1 .
.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
.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 Options
.INDENT 0.0
.TP
.B \-i, \-\-input\-file xml
Load picks in given XML file during startup
.UNINDENT
.SS Mode
.INDENT 0.0
.TP
.B \-\-filter arg
Overrides configuration parameter \fI\%filter\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-offline
Do not connect to a messaging server and do not use the
database.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-inventory
Do not read streams from inventory but display all streams
available from the specified record source. This option may
be combined with the streams.codes parameter to filter the
available streams.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-end\-time arg
Set the acquisition end time, e.g. \(aq2017\-09\-08 13:30:00\(aq,
default: \(aqgmt\(aq.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-buffer\-size arg
Overrides configuration parameter \fI\%bufferSize\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-max\-delay arg
Overrides configuration parameter \fI\%maxDelay\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-start\-at\-now
Subscribe to data starting at now rather than now \- bufferSize
.UNINDENT
.INDENT 0.0
.TP
.B \-\-rt
Do not ask for time window at data server. This might be
important if e.g. Seedlink does not allow time window
extraction.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-map\-picks
Overrides configuration parameter \fI\%mapPicks\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-3c
Overrides configuration parameter \fI\%3c\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-channels
Channel(s) to display. The channel code may contain wildcards
at any position but the support of wildcards depends on
RecordStream. Repeat the option for multiple
channel groups. Examples:
.sp
default : all streams configured by global bindings.
.sp
GE.*.*.HH? : all HH channels of all stations from GE network.
.UNINDENT
.SS Cities
.INDENT 0.0
.TP
.B \-\-city\-xml arg
The path to the cities XML file. This overrides the default
paths. Compare with the global parameter \(dqcitiesXML\(dq.
.UNINDENT
.SS User interface
.INDENT 0.0
.TP
.B \-F, \-\-full\-screen
Start the application filling the entire screen.
This only works with GUI applications.
.UNINDENT
.INDENT 0.0
.TP
.B \-N, \-\-non\-interactive
Use non\-interactive presentation mode. This only works with
GUI applications.
.UNINDENT
.SH AUTHOR
gempa GmbH, GFZ Potsdam
.SH COPYRIGHT
gempa GmbH, GFZ Potsdam
.\" Generated by docutils manpage writer.
.