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_high_accuracy_origin`	Write high accuracy hypocenter line E.g.: 1996 6 3 2006 35.511 46.78711 153.72245 33.011 1.923
`_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.