2025/share/man/man1/scmvx.1

.\" 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 "SCMVX" "1" "Oct 29, 2025" "7.0.0" "SeisComP"
.SH NAME
scmvx \- SeisComP Documentation
.sp
\fBMap view showing maps with stations and events. Issues related to
configuration of stations are indicated.\fP
.SH DESCRIPTION
.sp
scmvx visualizes the current information of earthquakes or earthquakes loaded
database as well as current station information including:
.INDENT 0.0
.IP \(bu 2
trigger status,
.IP \(bu 2
ground motion,
.IP \(bu 2
station quality,
.IP \(bu 2
station configuration issues.
.UNINDENT
.sp
All stations and events are visualized in a map. The map can be customized by
global \fBscheme.map\fP parameters and additional layers can be added as
outlined in the \fI\%GUI documenation\fP\&. scmvx provides multiple
\fI\%tabs\fP:
.INDENT 0.0
.IP \(bu 2
\fI\%Network\fP: Maps showing events and network
information including station configuration issues.
.IP \(bu 2
\fI\%Ground motion\fP: Map with events and stations. The
color of stations symbols represents recent ground motion calculated by scmvx
in a configurable time window.
.IP \(bu 2
\fI\%Quality control\fP: Map with events and stations. The
color of stations symbols represents recent waveform quality control
parameters calculated by \fI\%scqc\fP\&.
.IP \(bu 2
\fI\%Events\fP: Event list updated in real time and
allowing to filter events and to load historic events from database.
.UNINDENT
.SH TABS
.sp
Section is upcoming.
.SS Network
.sp
Section is upcoming.
.SS Ground motion
.sp
Section is upcoming.
.SS Quality control
.sp
Section is upcoming.
.SS Events
.sp
Events are shown as they arrive in real time and may be interactively loaded
from database.
During startup events from within a period of time are loaded and shown
according the configuration of \fI\%readEventsNotOlderThan\fP\&.
More events are added in real time as they arrive.
Historic events can be loaded from database for time spans and other filter
criteria.
The loaded events can sorted interactively by clicking on the table header.
Events out of scope can be hidden based on region, event type of agency ID.
In contrast to other event lists, e.g. in \fI\%scolv\fP or \fI\%scesv\fP, this
event list only gives access to parameter of the preferred but no other origins
of events.
.INDENT 0.0
.INDENT 2.5
[image]
Events tab.UNINDENT
.UNINDENT
.SS Hotkeys
.TS
center;
|l|l|.
_
T{
Hotkey
T}	T{
Description
T}
_
T{
C
T}	T{
Center map around latest event upon event update
T}
_
T{
G
T}	T{
Show map base layer in gray scale
T}
_
T{
N
T}	T{
Reset view to default
T}
_
T{
\fBF1\fP
T}	T{
Open SeisComP documentation in default browser
T}
_
T{
\fBShift + F1\fP
T}	T{
Open scmvx documentation in default browser
T}
_
T{
\fBF2\fP
T}	T{
Open dialog for connecting to database and messaging
T}
_
T{
\fBF6\fP
T}	T{
Toggle latest event information on map
T}
_
T{
\fBF7\fP
T}	T{
Toggle legend
T}
_
T{
\fBF8\fP
T}	T{
Toggle station issues in Network tab
T}
_
T{
\fBF9\fP
T}	T{
Toggle station annotation
T}
_
T{
\fBF10\fP
T}	T{
Switch to event list (Events tab)
T}
_
T{
\fBF11\fP
T}	T{
Toggle full screen mode
T}
_
T{
\fBCTRL + F\fP
T}	T{
Search station
T}
_
T{
\fBCTRL + O\fP
T}	T{
Open event parameter XML file
T}
_
T{
\fBCTRL + Q\fP
T}	T{
Quit scmvx
T}
_
T{
\fBShift + Arrows\fP
T}	T{
Move focus of map
T}
_
T{
\fB+\fP
T}	T{
Zoom in in map
T}
_
T{
\fB\-\fP
T}	T{
Zoom out in map
T}
_
T{
Mouse wheel
T}	T{
Zoom in or out in map
T}
_
T{
Mouse double click
T}	T{
Center map
T}
_
T{
Right mouse button
T}	T{
Open context menu
T}
_
.TE
.SH USE CASES
.SS Get station information, detail issues
.INDENT 0.0
.IP 1. 3
Navigate to the Network tab
.IP 2. 3
Position the mouse above a triangle representing a station. The selected
station is highlighted. Zoom in if events are overlapping.
.IP 3. 3
Click your left mouse button for opening the station info widget.
Data and potential configuration issues are shown.
.UNINDENT
.SS Search for and show an event
.INDENT 0.0
.IP 1. 3
Navigate to the Events tab load events from database in a relevant time range.
You may narrow down the database search through the filter button. After
events are loaded the list may be limited by hiding irrelevant events and you
may change the sorting of the event table by clicking on the header.
.IP 2. 3
Identify the event and double\-click on the event line to load the parameters.
You will immediately switch to a map centered around the selected event.
.UNINDENT
.SS Get event information
.INDENT 0.0
.IP 1. 3
Position the mouse above a circle representing the location of an event.
Zoom in if events are overlapping.
.IP 2. 3
Click the left mouse button for opening the event object inspector.
.UNINDENT
.SS Set preliminary origin
.sp
\fIUpcoming feature, not yet supported\fP
.INDENT 0.0
.IP 1. 3
Position the mouse in the map
.IP 2. 3
Press the middle mouse button
.IP 3. 3
Set date & time and latitude, longitude & depth
.IP 4. 3
Press \(dqCreate\(dq to open the origin in another GUI, e.g., scolv which must
be running already.
.UNINDENT
.SS Search station/network
.INDENT 0.0
.IP 1. 3
Press \fBCTRL + F\fP to open the search window.
.IP 2. 3
Type any string from a station and/or network name in the input field or just
select a station from the list.
.IP 3. 3
Double click in a station in the list to center the map at this location.
.UNINDENT
.SH COMMAND-LINE EXAMPLES
.INDENT 0.0
.IP \(bu 2
Real\-time view of events and stations on a local server
.INDENT 2.0
.INDENT 3.5
.sp
.nf
.ft C
scmvx \-H localhost \-I slink://localhost \-\-debug
.ft P
.fi
.UNINDENT
.UNINDENT
.IP \(bu 2
Offline view of event parameters given in an XML file. Inventory is read from
database.
.INDENT 2.0
.INDENT 3.5
.sp
.nf
.ft C
scmvx \-d localhost \-i events.xml \-\-debug
.ft P
.fi
.UNINDENT
.UNINDENT
.UNINDENT
.SH MODULE CONFIGURATION
.nf
\fBetc/defaults/global.cfg\fP
\fBetc/defaults/scmvx.cfg\fP
\fBetc/global.cfg\fP
\fBetc/scmvx.cfg\fP
\fB~/.seiscomp/global.cfg\fP
\fB~/.seiscomp/scmvx.cfg\fP
.fi
.sp
.sp
scmvx inherits \fI\%global options\fP\&.
.INDENT 0.0
.TP
.B displaymode
Type: \fIstring\fP
.sp
Values: \fBgroundmotion,qualitycontrol\fP
.sp
Set one of the available display modes used during startup:
groundmotion or qualitycontrol. When empty, the Network tab is
shown.
.UNINDENT
.INDENT 0.0
.TP
.B readEventsNotOlderThan
Default: \fB86400\fP
.sp
Type: \fIdouble\fP
.sp
Unit: \fIs\fP
.sp
Sets the time span before current time to read events initially
from database.
.UNINDENT
.INDENT 0.0
.TP
.B centerOrigins
Default: \fBfalse\fP
.sp
Type: \fIboolean\fP
.sp
If a new origin/event is set/selected, this option defines if
the map is centered or not at the origin location.
.UNINDENT
.INDENT 0.0
.TP
.B annotations
Default: \fBfalse\fP
.sp
Type: \fIboolean\fP
.sp
Enables/disabled drawing of station annotations at startup.
.UNINDENT
.INDENT 0.0
.TP
.B annotationsWithChannels
Default: \fBtrue\fP
.sp
Type: \fIboolean\fP
.sp
Enable/disable drawing of station annotations with
location/channel codes as NET.STA.LOC.CHA.
.UNINDENT
.INDENT 0.0
.TP
.B showUnboundStations
Default: \fBtrue\fP
.sp
Type: \fIboolean\fP
.sp
Enable/disable drawing of stations which are not bound with global bindings.
.UNINDENT
.INDENT 0.0
.TP
.B mapLegendPosition
Default: \fBtopleft\fP
.sp
Type: \fIstring\fP
.sp
Values: \fBtopleft,topright,bottomright,bottomleft\fP
.sp
The legend location for station symbols (network, QC, ground motion).
.UNINDENT
.INDENT 0.0
.TP
.B eventLegendPosition
Default: \fBbottomleft\fP
.sp
Type: \fIstring\fP
.sp
Values: \fBtopleft,topright,bottomright,bottomleft\fP
.sp
The legend location for event symbols.
.UNINDENT
.INDENT 0.0
.TP
.B stations.amplitudeTimeSpan
Default: \fB10\fP
.sp
Type: \fIdouble\fP
.sp
Unit: \fIs\fP
.sp
\fINo description available\fP
.UNINDENT
.INDENT 0.0
.TP
.B stations.groundMotionRecordLifeSpan
Default: \fB600\fP
.sp
Type: \fIdouble\fP
.sp
Unit: \fIs\fP
.sp
Time to keep waveform data in memory
.UNINDENT
.INDENT 0.0
.TP
.B stations.triggerTimeout
Default: \fB60\fP
.sp
Type: \fIdouble\fP
.sp
Unit: \fIs\fP
.sp
\fINo description available\fP
.UNINDENT
.INDENT 0.0
.TP
.B stations.groundMotionFilter
Default: \fBITAPER(60)>>BW_HP(4,0.5)\fP
.sp
Type: \fIstring\fP
.sp
Sets the filter applied to determine ground motion.
.UNINDENT
.sp
\fBNOTE:\fP
.INDENT 0.0
.INDENT 3.5
\fBdisplay.*\fP
\fIThe initial rectangular region for the map. The eventual region\fP
\fIis also scaled to the dimension of the opened map widget.\fP
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B display.latmin
Default: \fB\-90.0\fP
.sp
Type: \fIdouble\fP
.sp
Unit: \fIdeg\fP
.sp
Range: \fB\-90:90\fP
.sp
Minimum latitude in degrees.
.UNINDENT
.INDENT 0.0
.TP
.B display.lonmin
Default: \fB\-180.0\fP
.sp
Type: \fIdouble\fP
.sp
Unit: \fIdeg\fP
.sp
Range: \fB\-360:360\fP
.sp
Minimum longitude in degrees.
.UNINDENT
.INDENT 0.0
.TP
.B display.latmax
Default: \fB90.0\fP
.sp
Type: \fIdouble\fP
.sp
Unit: \fIdeg\fP
.sp
Range: \fB\-90:90\fP
.sp
Maximum latitude in degrees.
.UNINDENT
.INDENT 0.0
.TP
.B display.lonmax
Default: \fB180.0\fP
.sp
Type: \fIdouble\fP
.sp
Unit: \fIdeg\fP
.sp
Range: \fB\-360:360\fP
.sp
Maximum longitude in degrees.
.UNINDENT
.SH COMMAND-LINE OPTIONS
.sp
\fBscmvx [options]\fP
.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 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 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\&.
.sp
Default: \fBbinary\fP
.UNINDENT
.INDENT 0.0
.TP
.B \-\-start\-stop\-msg arg
Default: \fB0\fP
.sp
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 and simply the name of a miniSEED file can be given.
.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 Cities
.INDENT 0.0
.TP
.B \-\-city\-xml arg
Type: \fIfile\fP
.sp
Values: \fB*.xml\fP
.sp
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
.SS MapviewX
.INDENT 0.0
.TP
.B \-\-display\-mode arg
Overrides configuration parameter \fI\%displaymode\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-i, \-\-input\-file file
Load events in given XML file during startup and switch to
offline mode.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-offline
Do not connect to a messaging server and do not subscribe
channel data.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-with\-legend
Show the map legends.
.UNINDENT
.SH AUTHOR
gempa GmbH, GFZ Potsdam
.SH COPYRIGHT
gempa GmbH, GFZ Potsdam
.\" Generated by docutils manpage writer.
.