obspy.io.nordic.core

Nordic file format support for ObsPy

copyright:

The ObsPy Development Team (devs@obspy.org)

license:

GNU Lesser General Public License, Version 3 (https://www.gnu.org/copyleft/lesser.html)

Note

Pick time-residuals are handled in event.origins[0].arrivals, with the arrival.pick_id linking the arrival (which contain calculated information) with the pick.resource_id (where the pick contains only physical measured information).

note:

Station-magnitude residuals (only for New Nordic files) are handled in
obspy.core.event.magnitude.StationMagnitude.mag_errors.uncertainty.

note:

When you read a Nordic file into Obspy and then write to Nordic format, the
following information is not retained:
 - amplitude-picks have no distance or azimuth to source
 - some event (sub-)types may change if no equivalent event type exists in
   Obspy

Changed in version 1.2.3: * The pick-weight from the Nordic file (0-4, 9) is now read into pick.extra.nordic_pick_weight (was arrival.time_weight) while the finalweight (0-100 %) is read into arrival.time_weight (or backazmiuth_weight, respectively). * Empty network codes are now read as None instead of β€œNA” * Magnitudes are no longer automatically sorted by size.

Changed in version 1.2.0: The number of stations used to calculate the origin was previously incorrectly stored in a comment. From version 1.2.0 this is now stored in origin.quality.used_station_count

Public Functions

blanksfile

Generate an empty s-file with a populated header for a given waveform.

check_nordic_format_version

Check whether the type 4 line is for the old or the new Nordic format.

nordpick

Format picks in an Event to nordic.

read_nordic

Read a catalog of events from a Nordic formatted select file.

read_spectral_info

Read spectral info from an sfile.

readheader

Read header information from a seisan nordic format S-file.

readwavename

Extract the waveform filename from the s-file.

write_select

Function to write a catalog to a select file in nordic format.

Private Functions

Warning

Private functions are mainly for internal/developer use and their API might change without notice.

_extract_event

Helper to extract event info from a list of line strings.

_is_sfile

Basic test of whether the file is nordic format or not.

_read_comments

Read comment lines from s-file

_read_focal_mechanisms

Read focal mechanism info from s-file

_read_highaccuracy

Read high accuracy origin line.

_read_mags

Read the magnitude info from a Nordic header line.

_read_moment_tensors

Read moment tensors from s-file

_read_origin

Read one origin (type 1) line.

_read_picks

Internal pick reader.

_read_picks_nordic_new

Reads the type 4 line of the old Nordic format.

_read_picks_nordic_old

Reads the type 4 line of the old Nordic format.

_read_spectral_info

Internal spectral reader.

_read_uncertainty

Read hyp uncertainty line.

_readheader

Internal header reader.

_readwavename

Internal wave-name reader.

_write_comment

Write comment to s-file

_write_focal_mechanism_line

Get the line for a focal-mechanism

_write_header_line

Write one Seisan header line for origin.

_write_hyp_error_line

Generate hypocentral error line.

_write_moment_tensor_line

Generate the two lines required for moment tensor solutions in Nordic.

_write_nordic

Write an Event to a nordic formatted s-file.