Change Log

All notable changes to sceval will be documented in this file.

2021-02-14

Added

  • The new configuration parameter minPhaseConfirm allows confirmation of origins reaching or exceeding a number of arrivals
  • The new command-line option --force forces evaluation of origins without testing the original status, mode or author. Use the option for testing the configuration and for forcing evaluation.

2021-01-19

Added

  • The new command-line option -O allows filtering of origins by their ID in XML playbacks.
  • Added more details and examples to command-line help.

2020-09-02

Important

  • The new configuration parameter output.ignoreStatus defines origin evaluation states for which origins are not evaluated. By default no origin which has already an evaluation status is evaluated. This parameter potentially changes the behviour of sceval if processed origins have a non-empty evaluation status. To restore the previous behaviour, set output.ignoreStatus = "".

2020-07-27

Added

  • The new maxRMS parameter allows to reject origins with large RMS residual. The parameter may be important if locator modules do not check the origin RMS or if the check is very tolerant.
  • Re-design documentation.

Fixed

  • According to documentation reject origins with depth < minDepth and depth > maxDepth instead of <= minDepth and >= minDepth, respectively.

2020-03-06

Changed

  • Provide Python3 support for sceval-tune

2020-02-26

Changed

  • Improved documentation.

2020-02-21

Changed

  • So far only origins which belong to events were evaluated in XML playback mode. Now we evaluate all origins of the event parameter set.
  • Before we checked at start if a station has a valid epoch in the inventory for the current time. Some customers noticed that historical data could not be processed when the inventory did not contain such an epoch. Now we just check if the station is part of the inventory.

Fixed

  • Use the configuration parameter distanceProfilesMinPhase correctly.
  • Do not apply minPhase if the number of used phases >= distanceProfilesMinPhase However, when distanceProfilesMinPhase = 0, minPhase is considered.

2019-11-09

Changed

  • Return the origin status and stop evaluations or origins whenever modified.
  • Use -1 as default for gapMinPhase which disables extended Gap criterium.
  • Every method adds the comment “scevalMethod” to identify the method which set the status
  • Executing extended GAP evaluation after station-distance evaluation allows to confirm origins rejected before by station-distance evaluation.
  • Do not set the maxGap comment by default if GAP = 360. The change will not comment single-stations observations, e.g. from arrays. Events may be located by single arrays with beam picks (arrival times, backazimuth, slowness). Solutions from single arrays have GAP = 360 degree. With this change, the sceval plugin will not set the event type, e.g. to “not locatable” even if the event was observed only at a single array unless specifically configured by maxGap = 360.

2019-11-01

Changed

  • Changed the option name playback to sloppy.

Added

  • New option noQC to allow running sceval without waveform QC parameters, e.g. in playbacks
  • New option mismatchScore.use to disable calculating the mismatchScore without setting the origin status. Useful for testing and tuning.

2019-10-29

Fixed

  • When stations are unavailable during startup, the scqc does not deliver values. Therefore, all stations are inactive for evaluation during startup of sceval and are only activated by incoming waveform QC parameters which must be in range. This may delay the full functioning of sceval by some seconds.

Added

  • Added the option qc.useDatabase allowing to read waveform QC parameters from the database. Doing so may slow down sceval during startup.
  • Added availability to the default waveform QC parameters, qc.parameters, to be tested.
  • Added parameter playback to facilitate sceval working on data even is QC parameters are missing due to short waveform time windows during playback.
  • If a station is inactive due to out-of-range QC parameters, is immediately activated when it provides an arrival to the evaluated origin.

2019-09-25

Fixed

  • Update origins and comments creation/modification time if the evaluation status or text was updated

2019-06-11

Added

  • The evsceval plugin for scevent does not set the event type if the event has manual origins or if the configuration parameter “rejected” is < 0.

2019-04-05

Added

  • sceval now fully supports XML playbacks using the –ep option. Before, only the preferred origin of an event was evaluated. Now, all origins are evaluated. This allows to use sceval in XML-based offline playback on origins before involving scevent.

2019-01-09

Changed

  • Plugin evsceval: setting the event type may overwrite the event type set by other modules. Therefore, the operation is disabled by default configuration.

2018-11-12

Added

  • sceval-tune script checks the existance of the profile input file, provides more descriptive error output and considers events in a default time window if unset.

2018-09-18

Added

  • Check the depth of an origin and reject events shallower than minDepth or deeper than maxDepth.

2018-07-19

Fixed

  • Removed connection.username and connection.server from default configuration to allow for sceval alias modules to be executed in parallel with default configuration

2018-05-07

Fixed

  • Segmentation fault in offline mode

2018-04-27

Added

  • evsceval plugin for with multi-agency test for scevent: The contribution of several agencies to an event may be used as a criterion to set the status of origins contributed by one or more agencies. Setting the status is only available if the original origin status is neither final, confirmed or rejected. The description XML files have beeni uniquely renamed. To avoid duplicates, remove from seiscomp3/etc/description/ the files evalcomment.xml and evsceval.xml. Only keep scevent_evsceval.xml.

2018-03-02

Fixed

  • Wrong unit in minGapPhase option description

2018-02-14

Fixed

  • Accept status from previous methods if station-distance test yields undefined

2017-11-30

Added

  • DistanceProfilesMinPhase requiring a minimum number of phases for station-distance statistics, over-rules the minPhase parameter
  • Descriptive output for tuning mode

2017-11-30

Fixed

  • SetupName considers the module for which a station has a binding profile
  • Fix database query

2017-09-18

Changed

  • Set origin comment: scevalMethod
  • Calculate mismatchScore even if origin was rejected or confirmed before by other medthod, but do not use the mismatchScore

2017-08-21

Fixed

  • Rounding error in distance comparison

2017-06-26

Added

  • Added support of alias module names in sceval-tune

2017-06-05

Changed

  • Consider used phases for min phase test

2017-03-24

Changed

  • Evsceval plugin change default value of reject to 50 %

2017-03-09

Fixed

  • Message group handling

2017-03-03

Fixed

  • Evsceval plugin for scevent setting event type and certainty

2017-03-02

Added

  • Evsceval plugin for scevent setting event type and certainty

2017-02-17

Fixed

  • Gap criterion: add maxGap comment but do not reject origin

Added

  • Event IDs to plots in tuning mode

2016-09-12

Added

  • sceval-tuning mode: add support for distance profiles

2016-08-03

Added

  • Add sceval-tuning mode with python script and documentation

2016-06-16

Added

  • Add minimum station criterion
  • Add extended gap criterion

2016-04-20

Changed

  • Remove minDist

2016-03-15

Added

  • Fixed streamMask in desciption

2016-03-11

Added

  • Add GAP criterion
  • Support empty distance profiles
  • Ignore already rejected origins
  • Add documentation for QC

2016-02-11

Changed

  • The evaluation status of already rejected origins will no longer be changed

2015-10-22

Fixed

  • High CPU usage in case of manual origins

2016-02-25

Added

  • Add gap criterion to check the largest azimuthal gap of an origin

2016-03-11

Added

  • Allow empty distance profiles
  • Reject origins that are rejected once even when confirmed by another evaluation method