<ol><li><ol><li><ol><li><a href="#scolvPotsdambeta2011.109">scolv (Potsdam beta 2011.109)</a><ol><li><a href="#Applicationstartup">Application startup</a></li><li> <a href="#Summarywidget">Summary widget</a></li><li> <a href="#Locationreviewpage">Location review page</a><ol><li><a href="#Mapradius">Map radius</a></li><li> <a href="#Displayedunitsandprecision">Displayed units and precision</a></li><li> <a href="#Plotwidget">Plot widget</a></li><li> <a href="#Arrivaltable">Arrival table</a></li><li> <a href="#Additionaloptionsforcommit">Additional options for 'commit'</a></li></ol></li><li> <a href="#Waveformreviewpagepicker">Waveform review page (picker)</a></li><li> <a href="#Magnitudereviewpage">Magnitude review page</a><ol><li><a href="#Showrawdata">Show raw data</a></li><li> <a href="#Processingsettings">Processing settings</a></li><li> <a href="#Secondaryfilters">Secondary filters</a></li><li> <a href="#Calculateamplitudes">Calculate amplitudes</a></li><li> <a href="#Pickamplitudes">Pick amplitudes</a></li><li> <a href="#Addstationsinrange">Add stations in range</a></li><li> <a href="#Removebadstations">Remove bad stations</a></li><li> <a href="#Confirmtheamplitudes">Confirm the amplitudes</a></li></ol></li><li> <a href="#Eventreviewpage">Event review page</a></li><li> <a href="#Eventlist">Event list</a></li><li> <a href="#Settings">Settings</a><ol><li><a href="#Global">Global</a></li><li> <a href="#Picker">Picker</a></li><li> <a href="#Amplitude">Amplitude</a></li></ol></li></ol></li></ol></li></ol></li></ol>

scolv (Potsdam beta 2011.109)

With funding of ETH Zurich and GNS New Zealand the OriginLocatorView received a lot of updates and new features. This page documents the changes of the new version compared to the old version.

IMPORTANT: Due to the new features the configuration variable filters has been renamed to picker.filters. If custom filter definitions are used, make sure to rename the variable filters to picker.filters in scolv.cfg.

Application startup

If scolv is started it opened by default an empty location review page. Optionally a user could open a summary widget on the left side manually via the menu. Both things can be configured now to be part of the startup process.

To avoid an empty location review page after startup, scolv can now be configured to load events of a certain time span in advance and select the most recent event. A new configuration option has been added to scolv.cfg:

# Events of last number of days to load in advance. Real
# numbers are allowed, e.g. 1.5
loadEventDB = 1

To open the event summary widget on the left side by default, add to scolv.cfg:

olv.showSummary = true

An example is shown in the figure below.

Summary widget

The summary widget contains now 2 tabs: Preferred and Current. Preferred reflect the current official (database) state of the event while Current shows the current solution (location and magnitudes).

Location review page

The location review page (tab Location) shows as usual the map, the arrival plot and in the lower part the arrival table.

Map radius

The radius in degrees around an origin loaded can be configured. If it is not configured a default scale is selected that depends on the maximum distance of the arrivals.

# Set the default map radius to 2deg which are ~220km
olv.map.origin.defaultRadius = 0.5
Displayed units and precision

Local network users prefer the distance unit in km while others prefer degree. scolv can now be configured to show either the one or the other.

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

Furthermore the precision of various values can be configured:

# Precision of depth values.
scheme.precision.depth = 0
# Precision of lat/lon values.
scheme.precision.location = 2
# Precision of pick times (fractions of seconds).
scheme.precision.pickTime = 1
Plot widget

The plot widget can be configured to show dashed grid lines. The new default is on. The configuration file received a new option to configure this behaviour:

olv.drawGridLines = true

A new plot (tab MoveOut) has been added which plots distance vs. reduced travel time. The used reduction velocity is by default 6 km/s but can be configured in the settings dialog or via configuration file:

# Reduction velocity used for MoveOut plot
olv.Pvel = 6.0

Furthermore a plot filter can be defined. Filtering means that arrivals that match the filter are not plotted. They are filtered out visually. To enable a filter click the link "not active" right below the plot tabs. A setup dialog pops up where the filter can be defined. Currently only a filter by azimuth around epicenter can be applied.

Select the center azimuth and the extent to either side. If Ok is pressed all arrivals that fall outside the defined azimuthal area are hidden from the plot and the line below the tabs turns into "Filter is active". Clicking on the link again and select the "None" filter will show all arrivals in the plot again.

Arrival table

In order to support the removal of arrivals from a solution or to rename phases the arrival table has been extended. The selection of multiple rows is now possible. Furthermore a context menu was added which pops up when the right mousebutton is pressed on a row. The context menu offers to:

If arrivals are deleted, they are removed physically from this solution in contrast to deactivate an arrival where only the weight is set to zero.

The arrival table has got additional columns to display. The following columns are available:

To define what columns are visible by default, a new configuration variable is available:

# Defines a list of initially visible columns of the arrival table
olv.arrivalTable.visibleColumns = Used, Status, Phase, Net, Sta, Loc/Cha, Res, Dis, Az, Time, +/-

The user can interactively select what columns are be visible or hidden from a context menu which pops up after a right click on the table header.

Additional options for 'commit'

Committing a solution means to send the location (including optional magnitudes) to the processing system and let it decide what origin becomes preferred. To optimize the workflow

  1. select an event
  2. review solution
  3. commit solution
  4. change to event tab
  5. set this solution preferred
  6. set event type
  7. change to events tab
  8. goto 1.

to

  1. select an event
  2. review solution
  3. commit solution
  4. change to events tab
  5. goto 1.

an additional commit mode was added.

After pressing and holding the Commit button down for a certain amount of time, a menu pops up which allows to select With additional options. Selecting this entry brings up another window where the different options can be set.

It allows to fix the origin to be comittet as preferred origin and to set the event type in one go. If "Return to event list after commit" is ticked the event list is activated after pressing OK to select another event quickly.

The default event type that is set if an origin is committed and the event has not yet a type set can be configured with:

olv.defaultEventType = earthquake

Waveform review page (picker)

The manual picker received a lot of new features. This version allows to:

Phases can now be configured in groups, e.g. regional and teleseismic. Below an example configuration:

# Define two phase groups: regional and teleseismic
picker.phases.groups = regional, teleseismic
# Define all phases of group "regional"
picker.phases.groups.regional = Pn, P, Pg, PmP, P1, Sg, S, Sn, SmS
# Define all phases of group "teleseismic"
picker.phases.groups.teleseismic = pP, PKP, PKP

# Define a list of favourite phase for quick access
picker.phases.favourites = Pn, P, Pg, PmP, P1, Pg, Sg, S, Sn, SmS

This configuration results in the following menu in the picker:

Shortcuts are assigned to the first 9 favourite phases. All other defined phases can only be activated from within the Picking menu.

To set the uncertainty of a pick a list of predefined uncertainties can be defined. Additionally uncertainties can be defined freely whereas choosing among a predefined set of uncertainties is a lot faster.

If the mouse hovers a pick a dashed rectangle is drawn around this pick. Then the pick is active and the right mouse button can be pressed to open the context menu where the polarity and uncertainty can be defined. The following snapshot shows the available uncertainties.

They can be configured in scolv.cfg with:

# Define available pick uncertainty profiles. Single values
# are symmetric uncertainties whereas tuples are asymmetric
# uncertainties: (left,right).

# Define an uncertainty set for local events
picker.uncertainties.local = 0.05, 0.1, 0.2, 0.3, "(0.1,0.2)"
# Define an uncertainty set for teleseimis events
picker.uncertainties.teleseismic = 0.5, 1, 2, 3, "(1,2)"
# Define the list of uncertainty sets that are active in scolv.
# This first set in the list is used by default. The other sets
# can be activated in the settings dialog (scolv: F3)
picker.uncertainties.preferred = local, teleseismic

If an uncertainty is selected the active pick is copied into a manual pick and the uncertainty is displayed as semi-transparent bars to the left and to the right.

Furthermore the pick polarity can be defined.

Either positive, negative, undecidable or unset. If set it is displayed as an arrow.

To rotate the waveform components into ZNE or ZRT system a new drop down list was added in the toolbar. Selecting either ZNE or ZRT implies that all missing components are requested.

When waveforms are requested the corresponding widget background are changed according to the current state:

If a station trace displays all 3 components and amplitudes are scaled up, they were clipped to their window area in previous versions. Now the default mode is to draw them unclipped into the station trace widget. Clipping can be toggled by either pressing C or in the menu View -> Zoomtrace -> Clip components to viewport.

The difference is shown in the following two images:

Clipping on
Clipping off

Magnitude review page

The magnitude review page has been extended to allow also the review of waveforms. The picture below shows the new layout of this page:

The button Recalculate and its options moved to the left side and on the right side a new button Waveforms has been added following the layout of the Location review page.

Note: The recalculation and waveform review of magnitudes is only allowed for magnitudes that have been calculated locally (Location.relocate -> Location.computeMagnitudes).

The default average method can be configured with

olv.defaultMagnitudeAggregation = median

The button Waveforms brings up the new amplitude waveform review page. The waveform review magnitude type is the same as the currently active tab.

The initial view loads all traces of all arrivals within the defined distance for that magnitude type. The zoom trace shows all components required for this particular amplitude type and the lower part shows all stations and only the currently active component. All traces are aligned on trigger time (blue P marker). If a station has got an amplitude it shows up as a red (automatic determined amplitude) or green (manually determined amplitude) marker. This display is similar to the manual picker.

The toolbar contains two lines of settings. The first line is similar to the picker, the second line is amplitude picker specific.

Second toolbar line: filter selection, filter toggle, min snr editor, amplitude measurement type selector, amplitude combiner selector, (re)calculate amplitudes, apply amplitudes.

A station trace is divided into three areas:

The example above shows nicely how different data time windows are used for amplitude determination depending on the distance. This depends on the amplitude type and its implementation.

Things that can be done:

Show raw data

By default the processed waveforms are displayed. To look at the raw waveforms change the filter drop down box to Raw.

Processing settings

A basic amplitude processor uses two basic settings: Minimum signal/noise ratio (SNR) and data time windows. The default minimum snr is defined by the implementation of the amplitude algorithm. This default snr is shown in the toolbar right from Min SNR:. In some situations an operator might want to increase or decrease the minimum snr for some reason. This can be done by modifying the value in the corresponding spin box.

In the time scale of the zoom widget and the overview are three black triangles visible. Those triangles can be used to adjust the data time windows of either the zoom trace (upper part) or all traces (lower part) by dragging the handle with the left mouse button.

Some amplitude processors allow the modification of the type of amplitude measurement (e.g. absolute maximum or peak-to-peak) and/or the amplitude combiner procedure. This procedure is mostly used when a final amplitude from two components is computed, e.g. ML on the horizontals. The combiner procedure defines how the amplitudes of each horizontal are combined to a single amplitude, e.g. by taking the maximum of both or the average.

If the amplitude processor allows any of these options the corresponding drop down boxes are enabled in the toolbar and can be used to change the defaults.

Note: Amplitudes are not recalculated if any changes to the settings are made. Recalculation has to be activated manually (see below).

Secondary filters

Another option is to filter the data additionally to the internal filter of the amplitude processor. Be warned that wrongly applied filters screw up the results. The available filters can be defined in the settings dialog of scolv or in the configuration file similar to the manual picker filters:

# Define a list of available filters for amplitude picking.
# The format is "name1;filter-definition1", "name2;filter-definition2"
amplitudePicker.filters = "4 pole HP @2s;BW_HP(4,0.5)"

The new filter selection is applied immediately to the waveforms while the amplitudes are not recalculated (see next section).

Calculate amplitudes

To calculate the amplitudes of all traces with the current settings press the green check in the toolbar. It will process all traces and recalculate the amplitudes within the shown time windows. If an error occurs it will show up as a small message box in the station trace itself. If a new amplitude is available its state is set to manual and the marker is updated to reflect the new position of the amplitude. If the mouse hovers an amplitude marker a tooltip pops up after a certain amount of time and shows information about the amplitude as in the next picture.

Pick amplitudes

In addition to the default picking of all stations it is also possible to define the time window of the amplitude of a station manually. To do so, activate picking by pressing 1 or in the main menu: Amplitudes->Pick amplitudes.

There are two modes of picking:

  1. create a time window by pressing with left mouse button at start time and releasing at the end time
  2. double click at a time and use a time window of [t-0.5sec;t+0.5sec]
Add stations in range

Unpicked or unassociated stations can be added the same way as in the manual picker. The new stations will not have an amplitude and need either manual picking or global amplitude recalculation.

Remove bad stations

Stations can be disabled by either double clicking on the trace label in the overview or by deactivating an amplitude similar to deactivating a pick.

Confirm the amplitudes

The red button in the toolbar confirms all amplitudes and transfers them to the magnitude review page. Only activated amplitudes are transfered. Disabled stations or disabled amplitudes are ignored. At this stage all magnitudes are calculated and the network magnitude is calculated according to the available settings: Mean, Median or Trimmed mean.

Event review page

The event review page was extended to show also all associated origins of an event in a map (lower left part). The filled circle represents the currently selected origin in the upper table.

Furthermore new event types were added: no locatable and outside of network interest.

Event list

The event list contains a checkbox Show other/fake events. If checked all events with type not existing or other are shown. If unchecked they are hidden. It is now possible to configure the event types used for this filter as well as the label text of the checkbox.

eventlist.hideEvents.types = "not existing", "other", "outside of network interest"
eventlist.hideEvents.label = "Show hidden events"

Additionally the event list can be configured with predefined regions that are used to filter the result set.

# Define a list of available regions
eventlist.regions = A,B

eventlist.region.A.name = "Lower left"
# latmin,lonmin, latmax, lonmax
eventlist.region.A.rect = -90,-180,0,0

eventlist.region.B.name = "Upper right"
eventlist.region.B.rect = 0,0,90,180

# Set default state of "Hide events outside region" to true
# and use the first region in the list.
eventlist.hideRegions.default = true

Settings

The settings dialog has been extended as well. It can be opened from within the main window by pressing F3 or via menu Settings->Configure originLocatorView.

Global

Reduction velocity

Sets the reduction velocity used for plot "MoveOut".

Compute magnitudes after relocate

Automatically computes magnitudes after each relocation. This has the same effect as pressing "Compute magnitudes" manually.

Compute magnitudes silently

Automatically closes the compute magnitudes dialog if the computation is finished and no error occured.

Data source

Defines the waveform data source for both, pick review and amplitude review

Default distance for "add station"

The default value to add stations (traces) that have not been picked or associated is 15 degree. A lower value can be defined, e.g. if mainly local events are analyzed.

Hide station traces without data

If new stations are added during pick review or amplitude review and if no data is available for some of those stations, they will be hidden and not shown. Once data arrives the trace becomes visible.

Picker

Show cross hair cursor

Enables the cross hair cursor which shows the currently selected uncertainty ranges.

Uncertainties

Select the current uncertainty set to be used (see scolv.cfg: picker.uncertainties.preferred).

Remove automatic station picks

If checked all automatic picks of a station with manual picks are removed once the manual review is confirmed.

Remove all automatic picks

If checked all automatic picks are removed once the manual review is confirmed.

Amplitude

Waveform time window pre offset

Sets an offset before the used amplitude time window that is used when collecting data.

Waveform time window post offset

Sets an offset after the used amplitude time window that is used when collecting data.

The greater the offset the more the amplitude time window can be extended or shifted.

Attachments