SeisComP3

Table Of Contents

Previous topic

scbev

Next topic

Messaging

This Page

scwev

SeisComp World Earthquake View

Description

scwev is an interactive tool for displaying events issued by USGS (United States Geological Survey) through RSS (Rich Site Summary) feeds.

Map tab

Main tab of the application, it displays events from RSS data in an interactive folding list, amalgamates those events with events from the local database and plots both on the map.

../_images/mainwindow3.png

Map tab.

Events tab

Displays events from the local database.

../_images/mainwindow_evtlist.png

Events tab.

Those events can be sorted to match user's preferences. A filtering menu is available by clicking on the tick down left.

../_images/eventlist_filters.png

Global filters.

../_images/eventlist_filters1.png

Event type filters available in application configuration dialog. Those specific events will be highlighted in the list.

Event type filters are pre-configurable in the application configuration file.

# Display events which type is set to  'Fake'
wev.eventList.showNotExistingOrigins = false
# Display events which type is set to 'Not locatable'
wev.eventList.showNotLocatableOrigin = false
# Display events without type
wev.eventList.showOriginsWithNoType = false
# Display events which type is set to 'Outside of network interests'
wev.eventList.showOutOfNetworkInterestsOrigins = true

RSS feed

scwev reads and supports ATOM feeds.

<feed xmlns="http://www.w3.org/2005/Atom" xmlns:georss="http://www.georss.org/georss">
   <updated>2014-04-14T13:02:57Z</updated>
   <title>USGS M 2.5+ Earthquakes</title>
   <subtitle>
      Real-time, worldwide earthquake list for the past day
   </subtitle>
   <link rel="self" href="http://earthquake.usgs.gov/earthquakes/catalogs/1day-M2.5.xml"/>
   <link href="http://earthquake.usgs.gov/earthquakes/"/>
   <author>
      <name>U.S. Geological Survey</name>
   </author>
   <id>http://earthquake.usgs.gov/</id>
   <icon>/favicon.ico</icon>
   <entry>
      <id>urn:earthquake-usgs-gov:announcement-deprecated</id>
      <title>Data Feed Deprecated</title>
      <updated>2014-04-14T13:02:57Z</updated>
      <link rel="alternate" type="text/html" href="http://earthquake.usgs.gov/earthquakes/catalogs/"/>
   </entry>
</feed>

Although this application has been tested with feeds from USGS, feeds from other agencies should work aswell, as long as they are ATOM feeds.

# USGS live feed
wev.rss.feed.USGS = "http://earthquake.usgs.gov/earthquakes/feed/v1.0/summary/"

Note

Feeds wich URL contains 'usgs' only need the root address, the rest of the link will be auto-generated.

If the feed's URL doesn't contain 'usgs', the link should be full.

Interactions

The map and the events lists are connected all together, the user may highlight on the map an event from any of the lists by double click, and vice-versa, a click on the event from the map selects the corresponding entry in the appropriate list.

../_images/event_pin.png

Event marker.

Events from the local database are dynamically displayable by using the associated check box.

../_images/eventlist_evtselect.png

Event selection.

When displaying USGS's ATOM feed, the user can interactively change its properties.

../_images/usgs_choices.png

Select event by magnitude and choose time preference.

scwev can recycle and refresh events periodically.

# Enable auto-refresh
wev.refresh.enable = true

# Refresh delay (in seconds)
wev.refresh.delay = 1800

Those parameters can be modified in the application configuration menu, but they will only be valid throughout this instance.

It is possible to import events from USGS's feed in local inventory. This option is configurable in application configuration menu. The user may choose to create the event by using its original ID, otherwise, a new local ID will be used.

../_images/save_event.png

Commit menu allows the creation of a new event in local database.

Units and decimals

scwev can be configured to display information according to user's preferences.

# If true, show distances in km. Use degree otherwise.
scheme.unit.distanceInKM = true

The same goes for the number of decimals:

# Default precision
scheme.precision.general = 2

# Precision of depth values.
scheme.precision.depth = 0

# Precision of lat/lon values.
scheme.precision.location = 2

# Distances
scheme.precision.distance = 2

# R.M.S
scheme.precision.rms = 1

# Azimuth
scheme.precision.azimuth = 0

# Precision of pick times (fractions of seconds).
scheme.precision.pickTime = 1

Map

The displayed map(s) are based upon normalized tiles (256x256 pixels). The user may choose to use simultaniously several tile designs, therfore it is possible to specify more than one tile design.

# Tile design names
map.names = "ESRI - Ocean Basemap", "Google - Hybrid Sat/Terrain",\
            "OpenStreetMap - Terrain"

# Tile design paths (ordered)
map.paths = @DATADIR@/maps/esri/Ocean_Basemap/,\
            @DATADIR@/maps/gmap-hybrid/,\
            @DATADIR@/maps/opencyclemap/

Tiles

Tiles are organized in different zoom levels, columns and lines, the user should specify the way they are stored.

# OpenStreetMap's default tile pattern is "%1/%2/%3", the tile
# engine is configured to use less sub-folders...
# map.tilePattern = "%1/osm_%1_%2_%3"
# - %1 = zoom level (0-*)
# - %2 = column (0- 2^zoom-1)
# - %3 = line (0- 2^zoom-1 in Mercator projection)
# Each parameter can be used more than once.
# @note It is not mandatory to specify the extension of the file, the
#       algorithm will try and fetch PNG and JPG files
map.tilePattern = "%1/%2/%3"

More information about tiles OpenStreetMap slippy map

Objects

Objects are organized by canvas in wich several layers and decorators are registered. Tiles are part of the background canvas whereas objects like epicenters, stations, etc, are called drawables and painted by the foreground canvas. Decorators may overpaint the foreground canvas.

Keyboard shortcuts

The following table describes available shortcuts and their actions.

Shortcuts Description
F1 Displays the online help index
Shift+F1 Displays this application online help
F2 Displays the connection configuration dialog connections (bdd / master)
Ctrl+I Displays the inventory (stations)
Ctrl+M Focuses on map tab
Ctrl+E Focuses on events tab
F3 Displays the application configuration dialog
F9 Displays the application log
F11 Toggles the application in fullscreen
Ctrl+Q Exits the application

Application execution

scwev can be launched by using the standard command.

seiscomp exec scwev

Configuration

etc/defaults/global.cfg
etc/defaults/scwev.cfg
etc/global.cfg
etc/scwev.cfg
~/.seiscomp3/global.cfg
~/.seiscomp3/scwev.cfg

scwev inherits global options.

loadEventDB

Type: int

Number of days of events to pre-load when application is started. Default is 30.

map.names

Type: list:string

Defines a list of tilemap's names.

map.paths

Type: list:path

Defines the paths binded with the maps tiles. Tiles folders/files have to be sensitive to this formulation: maps_directory/%zoom%/osm_%zoom%_%column%_%tile%.png. Several tiles maps can be added regarding right association of paths and names.

map.defaultLatitude

Type: double

Sets the default map latitude in decimal degrees.

map.defaultLongitude

Type: double

Sets the default map longitude in decimal degrees.

scheme.styleSheet

Type: file

Defines the stylesheet (CSS) to use for GUI customization.

scheme.precision.depth

Type: int

Defines the number of decimals that should be visible for depth values. Default is 2.

scheme.precision.distance

Type: int

Defines the number of decimals that should be visible for distance values. Default is 2.

scheme.precision.location

Type: int

Defines the number of decimals that should be visible for location values. Default is 2.

scheme.precision.rms

Type: int

Defines the number of decimals that should be visible for R.M.S. values. Default is 2.

scheme.precision.azimuth

Type: int

Defines the number of decimals that should be visible for azimuth values. Default is 0.

scheme.precision.pickTime

Type: int

Defines the number of decimals that should be visible for pickTime values. Default is 1.

scheme.unit.distanceinKM

Type: boolean

Defines the unit in which distance are displayed. Default is true.

scheme.fonts.base

Type: string

Defines the base font family to use. Default is Arial.

scheme.fonts.normal

Type: double

Defines the base font family size to use. Default is 10.

wev.inventoryVisible

Type: boolean

Defines if the event's inventory should be visible on the map. Default is false.

wev.useOwnWebViewer

Type: boolean

Defines if DYFI, Pager or Shakemap links should be opened within the application or by using the user's web browser. Default is true.

wev.locators

Type: list:string

Defines a list of locators that will be available as filters.

wev.refresh.enable

Type: boolean

Defines if the user wants the widget to refresh its data periodically. Default is true.

wev.refresh.delay

Type: int

Defines the refresh delay in seconds. Default is 60.

wev.import.earthModelID

Type: string

Sets the ModelID used to locate earthquakes. Default is USGS Seismic.

wev.import.methodID

Type: string

Sets the MethodID used to locate earthquakes. Default is USGS Locator.

wev.import.author

Type: string

Sets the Author of the earthquakes localization. Default is USGS.

wev.import.agency

Type: string

Sets the Agency of the earthquakes localization. Default is USGS.

wev.rss.feedPeriod

Type: string

Defines the period of events to request data from. The user may choose between "Past Hour", "Past Day", "Past 7 Days","Past 30 Days" Default is Past 7 Days.

wev.rss.feedType

Type: string

Defines the type of feed to request data from. The user may choose between "Significant","M4.5+","M2.5+","M1.0+","All". Default is USGS.

wev.rss.feed.USGS

Type: string

Defines the URL for the USGS's RSS ATOM feed. NOTE: only the root of the ATOM feed is to be specified, the application will generate the end of the URL... Default is http://earthquake.usgs.gov/earthquakes/feed/v1.0/summary/.

wev.rss.feed.custom

Type: string

Defines the URL for a custom ATOM feed.

Note

wev.locator.$name.* Defines a list of profiles belonging to a locator. $name is a placeholder for the name to be used and needs to be added to bev.locator.@LOCATOR.profiles to become active.

bev.locator.@LOCATOR.profiles = a,b
wev.locator.a = ...
wev.locator.b = ...
# c is not active because it has not been added
# to the list of bev.locator.@LOCATOR.profiles
wev.locator.c = ...
wev.eventList.useSeparateThread

Type: boolean

Sets whether or not objects (events) should be fetched by using another thread than the GUI's one. Default is true.

wev.eventList.useCacheEngine

Type: boolean

Sets whether or not objects (events) should be fetched and stored inside a cache. Default is true.

wev.eventList.showNotExistingOrigins

Type: boolean

Sets whether or not origins flagged with "NOT EXISTING" have type to be seen in the list. Default is false.

wev.eventList.showNotLocatableOrigin

Type: boolean

Sets whether or not origins flagged with "NOT LOCATABLE" type have to be seen in the list. Default is false.

wev.eventList.showOriginsWithNoType

Type: boolean

Sets whether or not origins without a type have to be seen in the list. Default is false.

wev.eventList.showOutOfNetworkInterestsOrigins

Type: boolean

Sets whether or not origins flagged with "OUTSIDE OF NETWORK INTEREST" type have to be seen in the list. Default is true.

Command-line

Generic

-h, --help

show help message.

-V, --version

show version information

--config-file arg

Use alternative configuration file. When this option is used the loading of all stages is disabled. Only the given configuration file is parsed and used. To use another name for the configuration create a symbolic link of the application or copy it, eg scautopick -> scautopick2.

--plugins arg

Load given plugins.

-D, --daemon

Run as daemon. This means the application will fork itself and doesn't need to be started with &.

--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).

--shutdown-master-module arg

Sets 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.

--shutdown-master-username arg

Sets the name of the master-username of the messaging used for auto-shutdown. If "shutdown-master-module" is given as well this parameter is ignored.

Verbosity

--verbosity arg

Verbosity level [0..4]. 0:quiet, 1:error, 2:warning, 3:info, 4:debug

-v, --v

Increase verbosity level (may be repeated, eg. -vv)

-q, --quiet

Quiet mode: no logging output

--component arg

Limits the logging to a certain component. This option can be given more than once.

-s, --syslog

Use syslog logging back end. The output usually goes to /var/lib/messages.

-l, --lockfile arg

Path to lock file.

--console arg

Send log output to stdout.

--debug

Debug mode: --verbosity=4 --console=1

--log-file arg

Use alternative log file.

Messaging

-u, --user arg

Overrides configuration parameter connection.username.

-H, --host arg

Overrides configuration parameter connection.server.

-t, --timeout arg

Overrides configuration parameter connection.timeout.

-g, --primary-group arg

Overrides configuration parameter connection.primaryGroup.

-S, --subscribe-group arg

A group to subscribe to. This option can be given more than once.

--encoding arg

Overrides configuration parameter connection.encoding.

--start-stop-msg arg

Sets sending of a start- and a stop message.

Database

--db-driver-list

List all supported database drivers.

-d, --database arg

The database connection string, format: service://user:pwd@host/database. "service" is the name of the database driver which can be queried with "--db-driver-list".

--config-module arg

The configmodule to use.

--inventory-db arg

Load the inventory from the given database or file, format: [service://]location

--db-disable

Do not use the database at all

User interface

--fullscreen arg

Starts the application in fullscreen mode

--stylesheet arg

Customize the user interface by using style from the given stylesheet.