Skip to content

Latest commit

 

History

History
108 lines (96 loc) · 3.69 KB

Pick.md

File metadata and controls

108 lines (96 loc) · 3.69 KB
Raw

Pick Format Specification

Description

Pick is a format designed to encode the basic information of an unassociated waveform arrival time pick. Pick uses the JSON standard.

Usage

Pick is intended for use in seismic data messaging between seismic applications and organizations.

Output

    {
      "Type"      : "Pick",
      "ID"        : String,
      "Site"      :
      {
         "Station"   : String,
         "Channel"   : String,
         "Network"   : String,
         "Location"  : String
      },
      "Time"      : ISO8601,
      "Source"    :
      {
         "AgencyID"  : String,
         "Author"    : String
      },
      "Phase"     : String,
      "Polarity"  : ("up" | "down"),
      "Onset"     : ("impulsive" | "emergent" | "questionable"),
      "Picker"    : ("manual" | "raypicker" | "filterpicker" | "earthworm" | "other"),
      "Filter"    : [ {
        "Type"     : String,
        "HighPass" : Number,
        "LowPass"  : Number,
        "Units"    : String
        }, ...]
      "Amplitude" :
      {
         "Amplitude" : Number,
         "Period"    : Number,
         "SNR"       : Number
      },
      "Beam" :
      {
        "BackAzimuth"      : Number,
        "BackAzimuthError" : Number,
        "Slowness"         : Number,
        "SlownessError"    : Number,
        "PowerRatio"       : Number,
        "PowerRatioError"  : Number,
      },
      "AssociationInfo" :
      {
         "Phase"    : String,
         "Distance" : Number,
         "Azimuth"  : Number,
         "Residual" : Number,
         "Sigma"    : Number
      },
      "ClassificationInfo" :
      {
        "Phase"                : String,
        "PhaseProbability"     : Number,
        "Distance"             : Number,
        "DistanceProbability"  : Number,
        "Azimuth"              : Number,
        "AzimuthProbability"   : Number,
        "Magnitude"            : Number,
        "MagnitudeType"        : String,
        "MagnitudeProbability" : Number,
        "Depth"                : Number,
        "DepthProbability"     : Number,
        "ClassifyingAlgorithm" : String
      }
    }

Glossary

Required Values:

These are the values required to define a pick.

  • Type - A string that identifies this message as a pick.
  • ID - A string containing an unique identifier for this pick.
  • Site - An object containing the station the pick was made at, see Site.
  • Source - An object containing the source of the pick, see Source.
  • Time - A string containing the UTC arrival time of the phase that was picked, in the ISO8601 format YYYY-MM-DDTHH:MM:SS.SSSZ.

Optional Values:

The following are supplementary values that may or may not be provided by various picking algorithms.

  • Phase - A string that identifies the seismic phase that was picked.
  • Polarity - A string containing the phase polarity; "up" or "down".
  • Onset - A string containing the phase onset; "impulsive", "emergent", or "questionable" .
  • Picker - A string describing the type of picker; "manual", "raypicker", "filterpicker", "earthworm", or "other".
  • Filter - An array of objects containing the filter frequencies when the pick was made, see Filter.
  • Amplitude - An object containing the amplitude associated with the pick, see Amplitude.
  • Beam - An object containing the waveform beam information associated with the pick, see Beam.
  • AssociationInfo - An object containing the association information if this pick is used as data in a Detection, see Associated.
  • ClassificationInfo - An object containing the classification information of this pick, see Classification.