get_picks¶

Science¶

get_picks returns the phases the automatic pipeline associated with an event, each with a stable pick_id for later reference. Times are the picker's onset estimates; probability is the picker's confidence that a onset is present, not a probability that the phase name or the association is right.

residual_s is the catalogue solution's NonLinLoc residual for that pick, or null when the pick was not used in that location. Counts summarise P, S and distinct stations. Fewer than six phases, or no S at all, are warned.

Picks the pipeline never made are not here. A delivering station without a row is a negative-evidence question for get_station_status and guided_repick, not a missing field on this tool.

Contract¶

Generated from the live registry (ToolSpec). Field names, types and defaults come from the input and payload models; they are not hand-typed.


Group	`catalog`
Class	1
Tool version	`1.0.0`
Highest declared tier	F
Timeout	5 s
Budget key	`none`
`readOnlyHint`	true
`idempotentHint`	true

Input¶

Field	Type	Required	Notes
`event_id`	integer	yes

Payload¶

Field	Type	Required
`event_id`	integer	yes
`picks`	array[object]	yes
`picks[].pick_id`	integer	yes
`picks[].station_id`	string	yes
`picks[].location`	string	yes
`picks[].channel`	string	yes
`picks[].phase`	string	yes
`picks[].time_utc`	string	yes
`picks[].probability`	number \| null	yes
`picks[].residual_s`	number \| null	yes
`counts`	object	yes
`counts.p`	integer	yes
`counts.s`	integer	yes
`counts.stations`	integer	yes

Example request¶

{
  "event_id": 1001
}

Example payload¶

{
  "event_id": 1001,
  "picks": [
    {
      "pick_id": 20001,
      "station_id": "XX.STA1",
      "location": "",
      "channel": "HHZ",
      "phase": "P",
      "time_utc": "2024-06-15T08:12:10.730Z",
      "probability": 0.81,
      "residual_s": -0.12
    }
  ],
  "counts": {
    "p": 6,
    "s": 3,
    "stations": 6
  }
}

What this tool does not tell you¶

What this tool does not tell you: pick probability is the picker's confidence in a pick, not evidence that the phase identity or the association is right. Picks the pipeline never made are not here — use get_station_status and guided_repick for those stations.

Warnings named for this tool¶

Code	When
`few_phases`	fewer than 6 phases
`no_s_phases`	no S phase is present