Input File Formats

Trace formats

SourceSpec can read all the trace formats supported by ObsPy.

Two very common choices are:

• miniSEED

• SAC

The SAC format can carry additional information in its header, like event location and origin time, phase picks, instrument sensitivity.

Input trace files can be provided –through the -t option– as a list of files, as a directory containing the files, or as a TAR(GZ) or ZIP archive containing the files.

Event formats

SourceSpec can read event information (event ID, location, origin time) in the following formats:

• SourceSpec Event File: this file can contain additional event information, such as magnitude, moment tensor or focal mechanism

• QuakeML: this file can contain additional event information, such as magnitude, moment tensor or focal mechanism. If phase picks are available, they will be read as well

• HYPO71

• HYPOINVERSE-2000: if phase picks are available, they will be read as well

Event information can also be stored in the SAC file header (header fields: EVLA, EVLO, EVDP, O, KEVNM).

Note

Any depth value provided in the event file or in the SAC header can be overridden using the command line option --depth.

Phase pick formats

Phase picks for P and S waves can be read from one of the following formats:

• QuakeML

• HYPO71

• HYPOINVERSE-2000

Phase picks can also be stored in the SAC file header, using the header fields A and T0 through T9. A pick label can be specified (header fields KA and KT0 through KT9) to identify the pick; the pick label can be a standard 4-characters SAC label (e.g., "IPU0", " S 1") or a label starting with "P" or "S" (lowercase or uppercase, e.g., "P", "pP", "Pg", "S", "Sn"). Picks with labels that cannot be parsed by SourceSpec will be ignored. If no label is specified, then SourceSpec will assume that A is the P-pick and T0 is the S-pick.

Station metadata formats

Station metadata (coordinates, instrumental response) can be provided in one of the following formats:

• StationXML

• Dataless SEED

• SEED RESP

• SAC polezero (PAZ)

Note that SEED RESP and PAZ formats do not contain station coordinates, which should therefore be in the trace header (traces in SAC format).

The station metadata file name or file directory is provided in the configuration file through the parameter station_metadata.

Alternatively, instrument sensitivity can be provided in the SAC header or as a constant in the configuration file. In both cases, use the configuration parameter sensitivity.