Table Of Contents

Previous topic


Next topic


This Page


SeisComp World Earthquake View


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.


Map tab.

Events tab

Displays events from the local database.


Events tab.

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


Global filters.


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="" xmlns:georss="">
   <title>USGS M 2.5+ Earthquakes</title>
      Real-time, worldwide earthquake list for the past day
   <link rel="self" href=""/>
   <link href=""/>
      <name>U.S. Geological Survey</name>
      <title>Data Feed Deprecated</title>
      <link rel="alternate" type="text/html" href=""/>

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 = ""


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.


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.


Event marker.

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


Event selection.

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


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.


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


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/,\


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



scwev inherits global options.


Type: int

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


Type: list:string

Defines a list of tilemap's names.


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.


Type: double

Sets the default map latitude in decimal degrees.


Type: double

Sets the default map longitude in decimal degrees.


Type: file

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


Type: int

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


Type: int

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


Type: int

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


Type: int

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


Type: int

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


Type: int

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


Type: boolean

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


Type: string

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


Type: double

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


Type: boolean

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


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.


Type: list:string

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


Type: boolean

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


Type: int

Defines the refresh delay in seconds. Default is 60.


Type: string

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


Type: string

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

Type: string

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

Type: string

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


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.


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.


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


Type: string

Defines the URL for a custom ATOM feed.


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

Type: boolean

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


Type: boolean

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


Type: boolean

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


Type: boolean

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


Type: boolean

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


Type: boolean

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



-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 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 mode: --verbosity=4 --console=1

--log-file arg

Use alternative log file.


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



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


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.