GUI

The GUI configuration plugin extends the configuration of graphical user interfaces to various options to adjust the look and feel.

Description

All SeisComP graphical user interfaces are based on a common libraries. This chapter describes what configuration and styling options are available for all GUI applications. The GUI specific configuration options are additional to the standard application options. Setup the e.g. messaging connection and database is equal to the CLI (command line interface) applications.

Styling

To adjust the look-and-feel to the host desktop system and the personal taste several styling options are available. Since all GUI applications are using the Qt4 or QT5 library, the tool “qtconfig-qt4” can used to adjust the widget theme and the colors. If KDE is used as desktop system, the same style is used since KDE bases on Qt as well.

The style options supported by SeisComP (and not covered by the general Qt setup) have to be given in the applications (or global) configuration file. The parameters are configured with the scheme. parameters.

In case of map layers defined by geo feature files the parameters may also be defined by map.cfg in the directory of the geo feature file.

Configuration syntax

Beside the usual integer, float, boolean and string parameters GUI applications support also color, color gradient, pen, brush, font and symbol parameters. The syntax is explained below:

Colors

color = red | RRGGBBAA | "rgb(red,green,blue)" | "rgba(red,green,blue,alpha)"

Colors are specified either by color keyword names, in a hexadecimal notation or in a rgb(a) notation. When using the rgb(a) notation it should be quoted. Otherwise the configuration parser would tokenize the value into 3 or 4 strings due to the comma.

Color gradients

gradient = 1:FF0000, 2:00FF00, 3:0000FF

This defines a gradient from red through green to blue for the nodes 1, 2 and 3. Values out of range are clipped to the lower or upper bound.

Fonts

# The font family
font.family = "Arial"

# Point size
font.size = 12

# Bold?
# Default: false
font.bold = false

# Italic?
# Default: false
font.italic = false

# Underline?
# Default: false
font.underline = false

# Overline?
# Default: false
font.overline = false

An example to configure the SC3 base font:

scheme.fonts.base.family = "Arial"
scheme.fonts.base.size = 10

Pens

Pens are used in the vector layer configuration. Pens have three attributes: color, style and width. Color follows the described color definition, width is a double and the styles are:

nopen	solidline	dotline
dashline	dashdotline	dashdotdotline
Images from Qt 4.1 documentation: http://doc.qt.digia.com/4.1/qt.html#PenStyle-enum

Example:

# Blue dotted pen
pen.color = 0000ff
pen.style = dotline

Brushes

Brushes are also used in the vector layer configuration. Brushes are used to fill a polygon. They have two attributes: color and style. Color follows the described color definition and styles are:

Example:

# Red solid brush
brush.color = ff0000
brush.style = solid

Symbols

Symbols configured by the symbol.* parameters can be plotted on coordinate points defined by geo feature files or by symbol.icon.hotspot.x and symbol.icon.hotspot.y. The symbols can be shapes (symbol.shape) or icons from a file (symbol.icon).

Legends

Legends are plotted on maps describing map vector layers. Styles are:

Name	Description	Example
title	Title	title = Faults
orientation	Orientation: vertical, horizontal	orientation = vertical
legendArea	Position: topleft, topright, bottomleft, bottomright	legendArea = topleft

Map Layers

Additional features may be added to maps using configurable layers:

• Vector layers, e.g. points, polylines, polygons from FEP, BNA or GeoJSON files,

• Other Layers, e.g. cities, grids, events, custom layers.

Vector layers are loaded and may be visualized together with other layers. The order of the drawing is defined by map.layers.

The map layers can be explained on the maps by configurable legends and selected interactively by their configurable category.

Map with layers defined by polygons, cities and legends.

Vector layers

Deprecation warning

The old directories @DATADIR@/bna or @CONFIGDIR@/bna are still supported but superseded by @DATADIR@/spatial/vector or @CONFIGDIR@/spatial/vector. The latter directories have higher priority. If one of the old directories has been found, a warning will be logged.

SeisComP supports arbitrary polygons, polylines or points for drawing as layers on maps or for using by other modules and plugins. The polygons, polylines and points can be customized by the available attributes. Currently supported data types are:

• FEP (Flinn-Engdahl polygons):

  • used for visualization of events regions and for setting the region name of the event by scevent.

  • stored in directories: @DATADIR@/fep or @CONFIGDIR@/fep

  • file name extension: .fep

  • file format:

    longitude1 latitude1
    longitude2 latitude2
    longitude3 latitude3
    ...
    99.0 99.0 length
    L name
    

    where the coordinates, length and name are to be replaced by actual values,

  • visibility and style can be controlled by configuration and map.layers.fep.visible.

• BNA polygons:

  • used for visualization, e.g. points, polylines, polygons for faults or districts, respectively, and even symbols or images on maps. Some objects, like closed lines can be evaluated by other modules and plugins, e.g. the region check plugin for scevent.

  • stored in directories or sub-directories of: $SEISCOMP_ROOT/share/spatial/vector or ~/.seiscomp/spatial/vector

  • file name extension: .bna

  • file format:

    "name 1","rank 1",type/length
    longitude1,latitude1
    longitude2,latitude2
    longitude3,latitude3
    ...
    

    where the coordinates, name and type/length are to be replaced by actual values. For polylines (open polygons) set type/length to the negative number of points defining the line, e.g. -10. Positive numbers, e.g. 10, define closed polygons. Such polygons are automatically closed between their end points. Thus, the end points do not need to be identical.

    The BNA file format also supports multiple vertices per line and the definition of islands. Please refer to https://www.softwright.com/faq/support/boundary_file_bna_format.html for more format specifications.

    Note

    • All SeisComP map applications support the drawing of polygons and a subsequent export to the BNA format.

    • An extension of the header entries is possible. The extra entries can be used by other modules or plugins, e.g. the region check plugin. Example

      "coal","rank 1","eventType: mining explosion, minDepth: -5, maxDepth: 10",6
      

    • The name is extracted from the first part of the header.

    • The rank is extracted from the second part of the header if it has the form “rank VALUE”, e.g. rank 12.

  • visibility and style can be controlled by configuration.

• GeoJSON features:

  • used for visualization, e.g. points, polylines, polygons for faults or districts, respectively, and even symbols or images on maps.

  • stored in directories or sub-directories of: $SEISCOMP_ROOT/share/spatial/vector or ~/.seiscomp/spatial/vector

  • file name extension: .geojson

  • file format: https://geojson.org/

    Note

    Currently the geometry type GeometryCollection is not supported. The name of the feature is derived from the name property of a feature and the rank can be provided in a rank property with an integer value.

Layer configuration

Layers may be grouped into categories and form a hierarchy. The categories of the geo feature data are derived from the feature directory structure, i.e. the names of the directories below the feature directory, e.g. @DATADIR@/spatial/vector. Feature data directly located within the feature directory have no special category. The FEP data set is assigned to the fep category.

The depth of the feature directory tree is arbitrary and subfolders form sub-categories. E.g. the directory tree $SEISCOMP_ROOT/share/spatial/vector/coastline/europe/germany will generate the categories coastline, coastline.europe and coastline.europe.germany which all may be configured individually. Every undefined property is inherited from the parent category.

The layer properties can be configured either by

• Global module configuration parameters or

• Layer-specific configuration files (map.cfg).

Note

The parameters in the global configuration of modules override the configurations in map.cfg allowing a specific configuration per application.

All data set directories and sub-directories therein are scanned for an optional map.cfg configuration file defining default drawing options. Parameters found in the lowest sub-directory take priority. This allows easy distribution of data sets and drawing properties without the need to change application configuration files. The available map layer configuration parameters are described further below.

The default drawing options may be overridden in the global or application configuration file using the format prefix.category.param. If global layer properties are configured, then just use prefix.param. The prefix for layer configuration is map.layers. Due to its recursive structure the configuration options are not available through scconfig.

Examples

File and directory for plotting fault lines with specific configurations. The geo features are defined in data.bna, configurations are in map.cfg:

@DATADIR@/spatial/vector/
├── maps.cfg
├── faults/
|   ├── map.cfg
|   ├── reverse/
|   |   ├── map.cfg
|   |   ├── data.bna
|   ├── normal/
|   |   ├── map.cfg
|   |   ├── data.bna
|   ├── strike-slip/
|   |   ├── map.cfg
|   |   ├── data.bna
├── others/
|   ├── maps.cfg
|   ├── data.bna

Configuration examples for plotting the fault lines based on the example above:

• Legend control in @DATADIR@/spatial/vector/faults/map.cfg

  # title of legend for all legend entries
  title = "Faults"
  # plot the legend vertically
  orientation = vertical
  # plot the legend in the top-right corner
  legendArea = topright
  

• Polygon property control in @DATADIR@/spatical/vector/faults/strike-slip/map.cfg common to all polygons in this directory. You may generate different sub-directories with different parameters inheriting the legend and other properties. Put this file, e.g. in the strike-slip directory.

  # make the layer visible
  visible = true
  # do not draw the name of the polygon
  drawName = false
  # draw a solid line
  pen.style = solidline
  # set the pen with to 1 px
  pen.width = 1
  # set the pen line to blue
  pen.color = blue
  # label to be shown in legend
  label = "strike-slip"
  

Instead of using map.cfg, the same properties can also be set per layer category by global parameters in module configurations, e.g. for the layer strike-slip below faults (global.cfg):

map.layers.faults.title = "Faults"
map.layers.faults.orientation = vertical
map.layers.faults.legendArea = topright
map.layers.faults.strike-slip.visible = true
map.layers.faults.strike-slip.drawName = false
map.layers.faults.strike-slip.pen.style = solidline
map.layers.faults.strike-slip.pen.width = 1
map.layers.faults.strike-slip.pen.color = blue
map.layers.faults.strike-slip.label = "strike-slip"

Parameters

Available map layer configuration parameters for each category are:

visible

Type: boolean

Show/hide the layer Default is true.

title

Type: string

Title of the legend for this directory. If the title is empty then no legend will be created. A legend will show the label of its own directory and all its subdirectories.

label

Type: string

The legend label for this directory.

index

Type: int

The index of the label in the legend. All labels will be sorted by their index in ascending order.

Default is 0.

legendArea

Type: string

The area in the map where the legend will be displayed. Valid values are topleft, topright, bottomleft and bottomright.

Default is topleft.

orientation

The orientation of the legend, either vertical or horizontal.

Default is vertical.

drawName

Type: boolean

Draws the segment name in the center of the bounding box. Default is false.

rank

Type: int

Set or override the rank of the segment. The rank defines the zoom level at which drawing of the segment starts. Default is 1.

roughness

Type: int

Sets the roughness of a polyline or polygon while zooming. The roughness is somehow defined in pixels and removes successive vertices if the distance in pixel is less than roughness. The higher the value the less vertices a rendered polyline or polygon will finally have and the faster the rendering. If set to 0 then the feature is disabled. Default is 3.

symbol.size

Type: int

In case of single points, this specifies the size of the symbol in pixels.

Default is 8.

symbol.shape

Type: string

In case of single points, this specifies the shape of the symbol. Valid values are circle and square.

Default is circle.

symbol.icon

Type: string

In case of single points this specifies the path to an image used as icon to represent the map location. The image is scaled to symbol.size if it is larger than zero otherwise the origin size is being used.

symbol.icon.hotspot.x

Type: int

The X coordinate of the symbol image which is rendered at the map location longitude. This coordinate is in unscaled image space.

Default is 0.

symbol.icon.hotspot.y

Type: int

The Y coordinate of the symbol image which is rendered at the map location latitude. This coordinate is in unscaled image space starting at top.

Default is 0.

debug

Type: boolean

If enabled, the bounding box of the segment is drawn. Default is false.

pen.width

Type: double

Pen width. Default is 1.0.

pen.color

Type: color

Pen color. Default is 000000ff.

pen.style

Type: string

Line style. Supported values are: dashdotdotline, dashdotline, dashline, dotline, nopen and solidline. Default is solidline.

brush.color

Type: color

Fill color. Default is 000000ff.

brush.style

Type: string

Fill style. Supported values are: nobrush, solid, dense1, dense2, dense3, dense4, dense5, dense6, dense7, horizontal, vertical, cross, bdiag, fdiag and diagcross. Default is nobrush.

font.size

Type: int

font.family

Type: string

font.bold

Type: boolean

font.italic

Type: boolean

font.underline

Type: boolean

font.overline

Type: boolean

composition

The image composition mode. Valid values are src-in, dst-in, src-out, dst-out, src-atop, dst-atop, xor, plus, multiply, screen, overlay, darken, lighten, color-dodge, color-burn, hard-light, soft-light, difference, exclusion, src-or-dst, src-and-dst, src-xor-dst, not-src-and-not-dst, not-src-or-not-dst, not-src-xor-dst, not-src, not-src-and-dst and src-and-not-dst.

An explanation can be found at the Qt developer documentation, e.g. https://doc.qt.io/qt-5/qpainter.html#composition-modes.

Default is src-over.

Other Layers

Other layers may be displayed on maps depending on the application.

• Events layer:

  Event symbols are shown as an extra layer, e.g. in the Location tab of scolv. Activate in the global module configuration by map.layers.events.visible.

• Cities layer:

  Cities are plotted based on the XML file @DATADIR@/cities.xml. Custom XML files, e.g. for multi-language support are provided by cityXML. Properties are configured in various global module parameters scheme.map.* and scheme.colors.*.

• Grid layer:

  The latitude/longitude grid plotted on top of maps. Properties are configured in the global module parameters scheme.colors.map.grid.*.

• Custom layers:

  Additional custom layers may be added which can be loaded and displayed by specific modules or plugins. They are added by map.customLayers.

Configuration

Note

groups.* Configures the target messaging groups for various object types. These parameters should only be touched if you know what you are doing.

groups.pick

Type: string

Defines the target messaging group for manual picks, e.g. made in scolv. Default is PICK.

groups.amplitude

Type: string

Defines the target messaging group for amplitudes, e.g. computed in scolv. Default is AMPLITUDE.

groups.magnitude

Type: string

Defines the target messaging group for magnitudes. scolv does not use this group but sends magnitudes together with the origin to the origin group. Default is MAGNITUDE.

groups.location

Type: string

Defines the target messaging group for origins created in e.g. scolv. Default is LOCATION.

groups.focalMechanism

Type: string

Defines the target messaging group for focal mechanisms created in e.g. scolv. Default is FOCMECH.

groups.event

Type: string

Defines the target messaging group for events and event journal entries. Default is EVENT.

map.location

Type: string

Specified the location and the structure of the map tiles to be used. This path is composed of zero or more directives and must include at least one conversion specification which starts with is introduced by the character % followed by a conversion specifier. Valid specifiers are s (replaced by tile ID), l (tile level), c (tile column) and r (tile row). An example for using the OpenStreetMap file structure is /path/to/maps/%l/%c/%r.png. Default is @DATADIR@/maps/world%s.png.

map.format

Type: string

Projection of the map tiles. Supported formats are: rectangular and mercator. Default is rectangular.

map.cacheSize

Type: int

Unit: bytes

Cache size of the map tiles. If 0 is specified a default cache size of 32mb is used. The higher the cache size the better the performance in higher resolutions. A higher cache size causes less image loader calls but requires more client memory. Default is 0.

map.type

Type: string

Used to distinguish tile store implementations provided by plug-ins.

map.customLayers

Type: list:string

Allows to add custom layers that are included via plugins. This is a list of layer names. A plugin must implement the layer interface and register itself with the name used in this list. The order of layers is the default order. The custom layers are prepended to the maps defaults layers such as the grid and the cities.

map.layers

Type: string

Defines the order of all configured layers. This includes the standard layers (grid, cities) as well as custom layers. The name of the grid layer is “grid” and the name of the cities layer is “cities”.

Note

map.layers.events.* Configuration options for the events layer that shows all events on the map that are loaded in the event list.

map.layers.events.visible

Type: boolean

Show the events layer on maps. Currently only supported by scolv. Default is false.

Note

map.layers.fep.* Configuration for the fep layer showing the polygons of FEP (FLinn-Engdahl-Polygon) files on maps if they exist in @DATADIR@/fep or @CONFIGDIR@/fep.

map.layers.fep.visible

Type: boolean

Show the fep layer on maps. Default is true.

map.layers.cities.topPopulatedPlaces

Type: int

Maximum number of cities to be rendered. If cityPopulationWeight is less or equal than 0 then all cities are rendered ordered by population count, highest first. To show the N most populated places in the visible map region, set “scheme.map.cityPopulationWeight” to 0 and set this parameter to N. Default is -1.

map.zoom.sensitivity

Type: double

Zoom sensitivity of the map Default is 0.5.

Note

scheme.* This group defines various options for color, pen, brush, font, etc. for SeisComP graphical user interfaces. There are various conventions to define colors, fonts and gradients. ** Colors are defined in HTML convention, e.g. as rgb values, hexadecimal numbers or color keyword names defined by W3C. If rgb or rgba is used, it must be quoted because the comma is handled as list separator by the configuration. Examples: “rgb(255,0,0)”, FF00FF40, green. ** Gradients are configured as lists of tuples where each tuple is colon separated in the form value:color. Value is either int or double and color is again a color definition. Example: 0:yellow,10:red

scheme.showMenu

Type: boolean

Show menu bar. Default is true.

scheme.showStatusBar

Type: boolean

Show status bar. Default is true.

scheme.tabPosition

Type: string

Set position if tab bar. An unset value lets the application decide where to place the tab bar. This option might not be supported by all applications. Valid positions are: off, north, south, east, west

scheme.map.stationSize

Type: int

Unit: px

The station symbol size (e.g. in scmv). Default is 8.

scheme.map.originSymbolMinSize

Type: int

Unit: px

The origin symbol minimum size. The formula to compute the size of the origin symbol is: 4.9*(M-1.2). Default is 9.

scheme.map.vectorLayerAntiAlias

Type: boolean

Apply antialiasing to map layers. This improves the visual quality but decreases performance. Default is false.

scheme.map.bilinearFilter

Type: boolean

Apply bilinear filtering to maps. The bilinear filter improves the visual quality but decreases performance slightly. It is only used for static map images. Not while dragging. Default is true.

scheme.map.showGrid

Type: boolean

Display the latitude/longitude grid on maps Default is true.

scheme.map.showCities

Type: boolean

Show cities defined in “citiesXML” on maps Default is true.

scheme.map.cityPopulationWeight

Type: int

Controls at which zoom level a city will be visible. The following formula is used: screen_width (km) * weight >= population Default is 150.

scheme.map.showLayers

Type: boolean

Show custom layers on maps Default is true.

scheme.map.showLegends

Type: boolean

Show map legends initially. Some applications provide controls to toggle the visibility in addition to this option. Default is false.

scheme.map.projection

Type: string

SeisComP ships with the rectangular projection built-in. Other projections may be provided through plugins. Default is Rectangular.

scheme.map.toBGR

Type: boolean

Converts map colors from RGB color scheme to BGR. Default is false.

scheme.map.polygonRoughness

Type: int

Unit: px

Minimum screen distance to plot a polygon or polyline line segment. Default is 3.

scheme.colors.background

Type: color

A general application background color. Can be used to give each application a different background color. An unset value lets Qt decide.

scheme.colors.map.lines

Type: color

The color of lines in the map (e.g. lines connecting the origin and a station).

scheme.colors.map.outlines

Type: color

The color of station outlines in the map.

scheme.colors.map.stationAnnotations

Type: color

The color of station annotations.

scheme.colors.map.cityLabels

Type: color

The color of city labels.

scheme.colors.map.cityOutlines

Type: color

The color of city outlines.

scheme.colors.map.cityCapital

Type: color

The color of a capital.

scheme.colors.map.cityNormal

Type: color

The color of a “normal” city.

Note

scheme.colors.map.grid.* Defines the pen of the latitude/longitude grid of the map.

scheme.colors.map.grid.color

Type: color

The color of the pen. Default is FFFFFF.

scheme.colors.map.grid.style

Type: string

The style of the pen. Supported values are: NoPen, SolidLine, DashLine, DotLine, DashDotLine, DashDotDotLine. Default is DotLine.

scheme.colors.map.grid.width

Type: double

Unit: px

The width of the pen. Default is 1.

scheme.colors.records.foreground

Type: color

The general color of records/traces. Default is 808080.

scheme.colors.records.alternateForeground

Type: color

A general trace color of the alternate trace (eg scheli). Default is 808080.

scheme.colors.records.background

Type: color

The general background color of records/traces.

scheme.colors.records.alternateBackground

Type: color

A general background color of the alternate trace.

scheme.colors.records.spectrogram

Type: color

The trace color used on top of a spectrogram. Default is 000000.

scheme.colors.records.gaps

Type: color

The color of data gaps in trace views. Default is FFFF0040.

scheme.colors.records.overlaps

Type: color

The color of data overlaps in trace views. Default is FF00FF40.

scheme.colors.records.alignment

Type: color

The color of the alignment marker in trace views. Default is FF0000.

Note

scheme.colors.records.borders.* Properties of record borders

Note

scheme.colors.records.borders.standard.* Standard properties

Note

scheme.colors.records.borders.standard.pen.* Defines the pen of the border line.

scheme.colors.records.borders.standard.pen.color

Type: color

The color of the pen.

scheme.colors.records.borders.standard.pen.style

Type: string

The style of the pen. Supported values are: NoPen, SolidLine, DashLine, DotLine, DashDotLine, DashDotDotLine.

scheme.colors.records.borders.standard.pen.width

Type: double

Unit: px

The width of the pen.

Note

scheme.colors.records.borders.standard.brush.* Defines the brush of the enlcosed area.

scheme.colors.records.borders.standard.brush.color

Type: color

The color of the pen.

scheme.colors.records.borders.standard.brush.style

Type: string

The style of the pen. Supported values are, e.g.: solid, dense1, dense7, horizontal, vertical, cross, bdiag, fdiag, diagcross.

Note

scheme.colors.records.borders.signatureValid.* Properties for records with valid signatures

Note

scheme.colors.records.borders.signatureValid.pen.* Defines the pen of the border line.

scheme.colors.records.borders.signatureValid.pen.color

Type: color

The color of the pen.

scheme.colors.records.borders.signatureValid.pen.style

Type: string

The style of the pen. Supported values are: NoPen, SolidLine, DashLine, DotLine, DashDotLine, DashDotDotLine.

scheme.colors.records.borders.signatureValid.pen.width

Type: double

Unit: px

The width of the pen.

Note

scheme.colors.records.borders.signatureValid.brush.* Defines the brush of the enlcosed area.

scheme.colors.records.borders.signatureValid.brush.color

Type: color

The color of the pen.

scheme.colors.records.borders.signatureValid.brush.style

Type: string

The style of the pen. Supported values are, e.g.: solid, dense1, dense7, horizontal, vertical, cross, bdiag, fdiag, diagcross.

Note

scheme.colors.records.borders.signatureInvalid.* Properties for records with invalid signatures

Note

scheme.colors.records.borders.signatureInvalid.pen.* Defines the pen of the border line.

scheme.colors.records.borders.signatureInvalid.pen.color

Type: color

The color of the pen.

scheme.colors.records.borders.signatureInvalid.pen.style

Type: string

The style of the pen. Supported values are: NoPen, SolidLine, DashLine, DotLine, DashDotLine, DashDotDotLine.

scheme.colors.records.borders.signatureInvalid.pen.width

Type: double

Unit: px

The width of the pen.

Note

scheme.colors.records.borders.signatureInvalid.brush.* Defines the brush of the enlcosed area.

scheme.colors.records.borders.signatureInvalid.brush.color

Type: color

The color of the pen.

scheme.colors.records.borders.signatureInvalid.brush.style

Type: string

The style of the pen. Supported values are, e.g.: solid, dense1, dense7, horizontal, vertical, cross, bdiag, fdiag, diagcross.

Note

scheme.colors.records.offset.* Defines the pen of the record offset line.

scheme.colors.records.offset.color

Type: color

The color of the pen. Default is C0C0FF.

scheme.colors.records.offset.style

Type: string

The style of the pen. Supported values are: NoPen, SolidLine, DashLine, DotLine, DashDotLine, DashDotDotLine. Default is SolidLine.

scheme.colors.records.offset.width

Type: double

Unit: px

The width of the pen. Default is 0.0.

Note

scheme.colors.records.gridPen.* Defines the pen of the record grid.

scheme.colors.records.gridPen.color

Type: color

The color of the pen. Default is 00000020.

scheme.colors.records.gridPen.style

Type: string

The style of the pen. Supported values are: NoPen, SolidLine, DashLine, DotLine, DashDotLine, DashDotDotLine. Default is DashLine.

scheme.colors.records.gridPen.width

Type: double

Unit: px

The width of the pen. Default is 1.0.

Note

scheme.colors.records.subGridPen.* Defines the pen of the secondary record grid.

scheme.colors.records.subGridPen.color

Type: color

The color of the pen. Default is 00000000.

scheme.colors.records.subGridPen.style

Type: string

The style of the pen. Supported values are: NoPen, SolidLine, DashLine, DotLine, DashDotLine, DashDotDotLine. Default is DotLine.

scheme.colors.records.subGridPen.width

Type: double

Unit: px

The width of the pen. Default is 1.0.

Note

scheme.colors.records.states.* Defines the background color of records depending on their state.

scheme.colors.records.states.unrequested

Type: color

Additional data which was not requested. Default is 00000080.

scheme.colors.records.states.requested

Type: color

Requested data Background color of requested data. Default is ffff0080.

scheme.colors.records.states.inProgress

Type: color

Data currently loading. Default is 00ff0010.

scheme.colors.records.states.notAvailable

Type: color

Data which was requested but is not available. Default is ff000080.

scheme.colors.picks.manual

Type: color

The color of manual picks. Default is 00FF00.

scheme.colors.picks.automatic

Type: color

The color of automatic picks. Default is FF0000.

scheme.colors.picks.undefined

Type: color

The color of picks with undefined state. Default is A0A0A4.

scheme.colors.picks.disabled

Type: color

The color of disabled picks. Default is A0A0A4.

scheme.colors.arrivals.manual

Type: color

The color of manual arrivals (arrivals that bind manual picks, e.g. residual plot of scolv, manual picker, …) Default is 00A000.

scheme.colors.arrivals.automatic

Type: color

The color of automatic arrivals, Default is A00000.

scheme.colors.arrivals.theoretical

Type: color

The color of theoretical arrivals. Default is 0000A0.

scheme.colors.arrivals.undefined

Type: color

The color of arrivals binding picks with undefined state. Default is A00000.

scheme.colors.arrivals.disabled

Type: color

The color of disabled arrivals. Default is A0A0A4.

scheme.colors.arrivals.residuals

Type: gradient

The gradient of arrivals residuals. A gradient is defined as a list of tuples separated by colon where the first item is the value and the second is the color. Colors can be given in rgb notation or hexadecimal. When rgb is used double quotes are needed to protect the comma inside the rgb definition, e.g. -8:”rgb(0,0,100)”, -4:”rgb(0,0,255)”, -3:”rgb(100,100,255)”, …

scheme.colors.magnitudes.set

Type: color

The color of active magnitudes. Default is 00A000.

scheme.colors.magnitudes.unset

Type: color

The color of inactive magnitudes. Default is 000000.

scheme.colors.magnitudes.disabled

Type: color

The color of disabled magnitudes. Default is A0A0A4.

scheme.colors.magnitudes.residuals

Type: gradient

The gradient of magnitude residuals.

scheme.colors.stations.text

Type: color

The color of the station name. Default is ffffff.

scheme.colors.stations.associated

Type: color

The color of associated stations (e.g. in scmv). Default is 82AD58.

scheme.colors.stations.triggering

Type: color

The color of triggered stations.

scheme.colors.stations.triggered0

Type: color

No description available

scheme.colors.stations.triggered1

Type: color

No description available

scheme.colors.stations.triggered2

Type: color

No description available

scheme.colors.stations.disabled

Type: color

The color of disabled stations.

scheme.colors.stations.idle

Type: color

The color of idle stations.

Note

scheme.colors.qc.* The color of QC.delay thresholds in scmv.

scheme.colors.qc.delay0

Type: color

Default is 00ffff.

scheme.colors.qc.delay1

Type: color

Default is 00ff00.

scheme.colors.qc.delay2

Type: color

Default is fffd00.

scheme.colors.qc.delay3

Type: color

Default is ff6633.

scheme.colors.qc.delay4

Type: color

Default is ff0000.

scheme.colors.qc.delay5

Type: color

Default is cccccc.

scheme.colors.qc.delay6

Type: color

Default is 999999.

scheme.colors.qc.delay7

Type: color

Default is 666666.

scheme.colors.qc.qcWarning

Type: color

Default is ffff00.

scheme.colors.qc.qcError

Type: color

Default is ff0000.

scheme.colors.qc.qcOk

Type: color

Default is 00ff00.

scheme.colors.qc.qcNotSet

Type: color

Default is 000000.

Note

scheme.colors.gm.* The color of ground motion amplitudes in scmv.

scheme.colors.gm.gm0

Type: color

No description available

scheme.colors.gm.gm1

Type: color

No description available

scheme.colors.gm.gm2

Type: color

No description available

scheme.colors.gm.gm3

Type: color

No description available

scheme.colors.gm.gm4

Type: color

No description available

scheme.colors.gm.gm5

Type: color

No description available

scheme.colors.gm.gm6

Type: color

No description available

scheme.colors.gm.gm7

Type: color

No description available

scheme.colors.gm.gm8

Type: color

No description available

scheme.colors.gm.gm9

Type: color

No description available

scheme.colors.gm.gmNotSet

Type: color

No description available

scheme.colors.recordView.selectedTraceZoom

Type: color

The color of the selected zoom area (e.g. manual picker). Default is C0C0FFC0.

scheme.colors.legend.background

Type: color

The map legend background color.

scheme.colors.legend.border

Type: color

The map legend border color.

scheme.colors.legend.text

Type: color

The map legend text color.

scheme.colors.legend.headerText

Type: color

The map legend header color.

scheme.colors.originSymbol.classic

Type: boolean

Default is false.

scheme.colors.originSymbol.depth.gradient

Type: gradient

The depth gradient. Default is 0:FF0000,50:ffA500,100:FFFF00,250:00FF00,600:0000FF.

scheme.colors.originSymbol.depth.discrete

Type: boolean

Setting this parameter to true will not interpolate between the depth steps and the color for a depth <= input is used. Default is true.

Note

scheme.colors.originStatus.* The origin status colors (e.g. in event list).

scheme.colors.originStatus.automatic

Type: color

No description available

scheme.colors.originStatus.manual

Type: color

No description available

Note

scheme.colors.splash.* Defines colors used in the splash screen shown at application startup.

scheme.colors.splash.message

Type: color

Text color of the message string. Default is 808080.

scheme.colors.splash.version

Type: color

Text color of the version string. Default is 02589e.

scheme.marker.lineWidth

Type: int

Unit: px

The line width of the marker (e.g. picks of manual picker).

scheme.records.lineWidth

Type: int

Unit: px

The line width of the records / traces. Default is 1.

scheme.records.antiAliasing

Type: boolean

Configures antialiasing of records / traces. Antialiasing needs more two times to storage space as non antialiasing but it improves visual quality. Default is true.

scheme.records.optimize

Type: boolean

Configures optimization of trace polylines. If activated then lines on the same pixel line or same pixel row collapse into single lines. Default is true.

scheme.records.borders.drawMode

Type: string

Mode for drawing record borders as box or line on top or bottom.

Supported values: “topline”,”box”,”bottomline” Default is box.

Note

scheme.fonts.base.* The general base font of an application. This overrides the default Qt4 application font.

scheme.fonts.base.family

Type: string

Sets the family name of the font. The name is case insensitive and may include a foundry name.

scheme.fonts.base.size

Type: int

Defines the point size of the font

scheme.fonts.base.bold

Type: boolean

Default is false.

scheme.fonts.base.italic

Type: boolean

Default is false.

scheme.fonts.base.underline

Type: boolean

Default is false.

scheme.fonts.base.overline

Type: boolean

Default is false.

Note

scheme.fonts.small.* The smallest available font. If undefined the point size is 2 points smaller than the base font.

scheme.fonts.small.family

Type: string

Sets the family name of the font. The name is case insensitive and may include a foundry name.

scheme.fonts.small.size

Type: int

Defines the point size of the font

scheme.fonts.small.bold

Type: boolean

Default is false.

scheme.fonts.small.italic

Type: boolean

Default is false.

scheme.fonts.small.underline

Type: boolean

Default is false.

scheme.fonts.small.overline

Type: boolean

Default is false.

Note

scheme.fonts.normal.* The default text font. If undefined the point size is 2 points larger than the base font.

scheme.fonts.normal.family

Type: string

Sets the family name of the font. The name is case insensitive and may include a foundry name.

scheme.fonts.normal.size

Type: int

Defines the point size of the font

scheme.fonts.normal.bold

Type: boolean

Default is false.

scheme.fonts.normal.italic

Type: boolean

Default is false.

scheme.fonts.normal.underline

Type: boolean

Default is false.

scheme.fonts.normal.overline

Type: boolean

Default is false.

Note

scheme.fonts.large.* The largest text font. If undefined the point size is 6 points larger than the base font.

scheme.fonts.large.family

Type: string

Sets the family name of the font. The name is case insensitive and may include a foundry name.

scheme.fonts.large.size

Type: int

Defines the point size of the font

scheme.fonts.large.bold

Type: boolean

Default is false.

scheme.fonts.large.italic

Type: boolean

Default is false.

scheme.fonts.large.underline

Type: boolean

Default is false.

scheme.fonts.large.overline

Type: boolean

Default is false.

Note

scheme.fonts.highlight.* Font used to highlight text. If undefined it equals the normal font except for a bold font face.

scheme.fonts.highlight.family

Type: string

Sets the family name of the font. The name is case insensitive and may include a foundry name.

scheme.fonts.highlight.size

Type: int

Defines the point size of the font

scheme.fonts.highlight.bold

Type: boolean

Default is false.

scheme.fonts.highlight.italic

Type: boolean

Default is false.

scheme.fonts.highlight.underline

Type: boolean

Default is false.

scheme.fonts.highlight.overline

Type: boolean

Default is false.

Note

scheme.fonts.heading1.* The largest heading font. If undefined it uses a bold font face and a font size twice as large as the normal font.

scheme.fonts.heading1.family

Type: string

Sets the family name of the font. The name is case insensitive and may include a foundry name.

scheme.fonts.heading1.size

Type: int

Defines the point size of the font

scheme.fonts.heading1.bold

Type: boolean

Default is false.

scheme.fonts.heading1.italic

Type: boolean

Default is false.

scheme.fonts.heading1.underline

Type: boolean

Default is false.

scheme.fonts.heading1.overline

Type: boolean

Default is false.

Note

scheme.fonts.heading2.* The second largest heading font. If undefined it uses a bold font face and a font size twice as large as the base font.

scheme.fonts.heading2.family

Type: string

Sets the family name of the font. The name is case insensitive and may include a foundry name.

scheme.fonts.heading2.size

Type: int

Defines the point size of the font

scheme.fonts.heading2.bold

Type: boolean

Default is false.

scheme.fonts.heading2.italic

Type: boolean

Default is false.

scheme.fonts.heading2.underline

Type: boolean

Default is false.

scheme.fonts.heading2.overline

Type: boolean

Default is false.

Note

scheme.fonts.heading3.* The smallest heading font. If undefined it uses a bold font face and a font size 4 points larger than the base font.

scheme.fonts.heading3.family

Type: string

Sets the family name of the font. The name is case insensitive and may include a foundry name.

scheme.fonts.heading3.size

Type: int

Defines the point size of the font

scheme.fonts.heading3.bold

Type: boolean

Default is false.

scheme.fonts.heading3.italic

Type: boolean

Default is false.

scheme.fonts.heading3.underline

Type: boolean

Default is false.

scheme.fonts.heading3.overline

Type: boolean

Default is false.

Note

scheme.fonts.cityLabels.* Font used for city labels. If undefined it equals the base font.

scheme.fonts.cityLabels.family

Type: string

Sets the family name of the font. The name is case insensitive and may include a foundry name.

scheme.fonts.cityLabels.size

Type: int

Defines the point size of the font

scheme.fonts.cityLabels.bold

Type: boolean

Default is false.

scheme.fonts.cityLabels.italic

Type: boolean

Default is false.

scheme.fonts.cityLabels.underline

Type: boolean

Default is false.

scheme.fonts.cityLabels.overline

Type: boolean

Default is false.

Note

scheme.fonts.splashVersion.* Font used for version string in the splash dialog shown at application startup. If undefined it equals the base font with a bold font face and a font size of 12.

scheme.fonts.splashVersion.family

Type: string

Sets the family name of the font. The name is case insensitive and may include a foundry name.

scheme.fonts.splashVersion.size

Type: int

Defines the point size of the font

scheme.fonts.splashVersion.bold

Type: boolean

Default is false.

scheme.fonts.splashVersion.italic

Type: boolean

Default is false.

scheme.fonts.splashVersion.underline

Type: boolean

Default is false.

scheme.fonts.splashVersion.overline

Type: boolean

Default is false.

Note

scheme.fonts.splashMessage.* Font used for the message text in the splash dialog shown at application startup. If undefined it equals the base font with a font size of 12.

scheme.fonts.splashMessage.family

Type: string

Sets the family name of the font. The name is case insensitive and may include a foundry name.

scheme.fonts.splashMessage.size

Type: int

Defines the point size of the font

scheme.fonts.splashMessage.bold

Type: boolean

Default is false.

scheme.fonts.splashMessage.italic

Type: boolean

Default is false.

scheme.fonts.splashMessage.underline

Type: boolean

Default is false.

scheme.fonts.splashMessage.overline

Type: boolean

Default is false.

scheme.precision.depth

Type: int

The precision of depth values. Default is 0.

scheme.precision.distance

Type: int

The precision of distance values. Default is 1.

scheme.precision.location

Type: int

The precision of lat/lon values. Default is 2.

scheme.precision.magnitude

Type: int

The precision of magnitude values. Default is 2.

scheme.precision.pickTime

Type: int

The precision of pick times. Default is 1.

scheme.precision.traceValues

Type: int

Precision of displayed offset/amp in all trace widgets. Default is 1.

scheme.precision.rms

Type: int

Precision of RMS values. Default is 1.

scheme.precision.uncertainties

Type: int

Precision of uncertainty values, e.g. latitude errors. Default is 0.

scheme.unit.distanceInKM

Type: boolean

Display distances in km? Default is false.

scheme.dateTime.useLocalTime

Type: boolean

Display times in localtime or UTC (default). Default is false.

Note

scheme.splash.* Defines the appearance of the splash screen shown at application startup.

Note

scheme.splash.message.* Position of the message text.

scheme.splash.message.align

Type: int

Qt::Alignment bit mask. Default: AlignHCenter | AlignBottom Default is 44.

Note

scheme.splash.message.pos.* Position in screen coordinates.

scheme.splash.message.pos.x

Type: int

Unit: px

Horizontal position. Default is 200.

scheme.splash.message.pos.y

Type: int

Unit: px

Vertical position. Default is 260.

Note

scheme.splash.version.* Position of the version string

scheme.splash.version.align

Type: int

Qt::Alignment bit mask. Default: AlignRight | AlignBottom Default is 34.

Note

scheme.splash.version.pos.* Position in screen coordinates.

scheme.splash.version.pos.x

Type: int

Unit: px

Horizontal position. Default is 362.

scheme.splash.version.pos.y

Type: int

Unit: px

Vertical position. Default is 190.

Note

events.timeAgo.* Defines maximum age of events to load. The value of all parameters are aggregated.

events.timeAgo.days

Type: int

Unit: d

Age in days. Default is 1.

events.timeAgo.hours

Type: int

Unit: h

Age in hours. Default is 0.

events.timeAgo.minutes

Type: int

Unit: m

Age in minutes. Default is 0.

events.timeAgo.seconds

Type: int

Unit: s

Age in seconds. Default is 0.

Note

mode.* Configuration of special applications modes.

mode.interactive

Type: boolean

Defines if application interaction is allowed. Default is true.

mode.fullscreen

Type: boolean

Defines if the application should be launched in fullscreen mode hiding title bar, main menu and status bar. Default is false.

picker.filters

Type: list:string

Configures the default filters selectable in manual picker. The entry with a leading “@” is selected as default filter. Default is "BP 0.1 - 1 Hz  3rd order;BW(3,0.1,1)","BP 0.1 - 2 Hz  3rd order;BW(3,0.1,2)","BP 0.4 - 1 Hz  3rd order;BW(3,0.4,1)","@BP 0.7 - 2 Hz  3rd order;BW(3,0.7,2)""BP 1 - 3 Hz  3rd order;BW(3,1.0,3)","BP 2 - 4 Hz  3rd order;BW(3,2.0,4)","BP 3 - 6 Hz  3rd order;BW(3,3.0,6)","BP 4 - 8 Hz  3rd order;BW(3,4.0,8)","BP 1 - 5 Hz  3rd order;BW(3,1.0,5)","HP 3 Hz  3rd order;BW_HP(3,3)","BP 0.7 - 2 Hz + STA/LTA(1,50);RMHP(10)->ITAPER(30)->BW(3,0.7,2)->STALTA(1,50)".

eventlist.visibleColumns

Type: list:string

Configure the columns of the event list that are visible initially. The first column containing the origin time is always visible and cannot be hidden. Possible values are: Type, M, TP, Phases, Lat, Lon, Depth, DType, Stat, AzGap, FM, Origins, Agency, Author, Region, ID. Default is M, TP, Phases, RMS, Lat, Lon, Depth, Stat, Agency, Region, ID.

eventlist.regions

Type: list:string

Configured a list of regions that can be used as filter of the result set.

eventlist.customColumn

Type: string

Name of an additional custom column which displays the value of certain origin and event comments.

eventlist.customColumn.originCommentID

Type: string

ID of the origin comment to look up.

eventlist.customColumn.eventCommentID

Type: string

ID of the event comment to look up.

eventlist.customColumn.pos

Type: int

Position of the column. If the configured position is less than 0 or if it exceeds the total number of columns then the column is appended to the right. Default is -1.

eventlist.customColumn.default

Type: string

Default value to display if the specified origin or event comment id was not found.

eventlist.customColumn.colors

Type: list:string

Mapping of comment values to colors used as text color. E.g. “foo:#000,bar:red”.

Note

eventlist.region.$name.* Defines a rectangular region that can be used as a result set filter on client side. $name is a placeholder for the name to be used and needs to be added to eventlist.regions to become active.

eventlist.regions = a,b
eventlist.region.a.value1 = ...
eventlist.region.b.value1 = ...
# c is not active because it has not been added
# to the list of eventlist.regions
eventlist.region.c.value1 = ...

eventlist.region.$name.name

Type: string

Defines the name of the region that shows up in the listbox.

eventlist.region.$name.rect

Type: list:double

Defines a rectangular region with a list of 4 values: latmin, lonmin, latmax, lonmax.

eventlist.filter.agencies.label

Type: string

Defines the text of the option “Show only own events”. Use double quotes ‘”’ around the string if it contains spaces. Default is Show only own events.

eventlist.filter.agencies.whitelist

Type: list:string

Sets a list of preferred agencies. Events from preferred agencies are defined as “own” events.

eventlist.filter.agencies.type

Type: string

Sets the type of the filter. If type is “events” the agency of the preferred origin of the event is checked. If type is “origins” the agency of all origins of an event is checked and if at least one origins agency is part of the whitelist it will pass the filter. Or in other words, the event is hidden if no origin is from a preferred agency. Default is events.

eventlist.filter.agencies.enabled

Type: boolean

Sets the default state of the “Show only own events” option. Default is false.

eventlist.filter.types.label

Type: string

Defines the text of the option “Hide other/fake events”. Use double quotes ‘”’ around the string if it contains spaces. Default is Hide other/fake events.

eventlist.filter.types.blacklist

Type: list:string

List of event type to be hidden if the “Hide other/fake events” option is ticked. Use double quotes ‘”’ around the string if it contains spaces. Default is "not existing".

eventlist.filter.types.enabled

Type: boolean

Sets the default state of the “Hide other/fake events” option. Default is true.

eventlist.filter.regions.enabled

Type: boolean

Sets the default state of the “Hide events outside” option. Default is false.

Note

eventlist.filter.database.* Pre-set options to filter an event list request.

eventlist.filter.database.minlat

Type: double

Unit: deg

No description available

eventlist.filter.database.maxlat

Type: double

Unit: deg

No description available

eventlist.filter.database.minlon

Type: double

Unit: deg

No description available

eventlist.filter.database.maxlon

Type: double

Unit: deg

No description available

eventlist.filter.database.mindepth

Type: double

Unit: km

No description available

eventlist.filter.database.maxdepth

Type: double

Unit: km

No description available

eventlist.filter.database.minmag

Type: double

No description available

eventlist.filter.database.maxmag

Type: double

No description available

eventlist.scripts.columns

Type: list:string

Registration of custom event list columns.

Note

eventlist.scripts.column.* Definition of custom event list column whose values are filled by external scripts.

Note

eventlist.scripts.column.$name.* $name is a placeholder for the name to be used.

eventlist.scripts.column.$name.script

Type: path

External script to invoke for each event list entry. The object represented by the list entry is serialized to XML and passed to the script on stdin. If the return code of the script is 0 (‘success’) then the script result is read from stdout and displayed in the corresponding event list cell.

eventlist.scripts.column.$name.pos

Type: int

Position of the column. If the configured position is less than 0 or if it exceeds the total number of columns then the column is appended to the right. Default is -1.

eventlist.scripts.column.$name.label

Type: string

Column name shown in header of event list table.

eventlist.scripts.column.$name.types

Type: list:string

Object types this script should be invoked for. Supported values are ‘Event’ and ‘Origin’.

eventedit.origin.visibleColumns

Type: list:string

Configure the columns of the event edit origin table that are visible initially. Possible values are: Phases, Lat, Lon, Depth, DType, RMS, Stat, Method, Agency, Author, Region Default is Phases, Lat, Lon, Depth, DType, RMS, Stat, Method, Agency, Author, Region.

eventedit.fm.visibleColumns

Type: list:string

Configure the columns of the event edit focal mechanism tab that are visible initially. Possible values are: Depth, M, Count, Misfit, STDR, AzGap, Stat, DC, CLVD, ISO, S1, D1, R1, S2, D2, R2, Agency, Author Default is Depth, M, Count, Misfit, STDR, AzGap, Stat, DC, CLVD, ISO, S1, D1, R1, S2, D2, R2, Agency, Author.

Note

eventsummary.* Parameters controlling the event summary view used e.g. in scolv.

eventsummary.alertTimer.commentId

Type: string

Set an alert for every event comment that ID matches the specified regular expression, e.g. “alert_.*”.

eventsummary.alertTimer.commentBlacklist

Type: list:string

List of comments to ignore, e.g. “nil”.

eventsummary.alertTimer.alertGradient

Type: list:string

Unit: s:color

Discrete mapping of time values in seconds to colors used as text color in case of an active alert. E.g. “0:00FF00,900:FF0000”.

eventsummary.alertTimer.textSize

Type: int

Unit: pt

The text size of the time ago label in case of an active alert.