obspy.io.sh.evt._read_evt

_read_evt(filename, inventory=None, id_map=None, id_default='.{}..{}', encoding='utf-8')[source]

Read a SeismicHandler EVT file and returns an ObsPy Catalog object.

Warning

This function should NOT be called directly, it registers via the ObsPy read_events() function, call this instead.

Parameters:
  • filename (str) File or file-like object in text mode.
  • inventory (Inventory) Inventory used to retrieve network code, location code and channel code of stations (SEED id).
  • id_map (dict) If channel information was not found in inventory, it will be looked up in this dictionary (example: id_map={‘MOX’: ‘GR.{}..HH{}’). The values must contain three dots and two {} which are substituted by station code and component.
  • id_default (str) Default SEED id expression. The value must contain three dots and two {} which are substituted by station code and component.
  • encoding (str) encoding used (default: utf-8)
Return type:

Catalog

Returns:

An ObsPy Catalog object.

Note

The following fields are supported by this function: [‘applied filter’, ‘component’, ‘depth (km)’, ‘distance (deg)’, ‘error ellipse major’, ‘error ellipse minor’, ‘error ellipse strike’, ‘error in depth (km)’, ‘error in latitude (km)’, ‘error in longitude (km)’, ‘error in origin time’, ‘event id’, ‘event type’, ‘latitude’, ‘longitude’, ‘magnitude (M?)’, ‘mean magnitude (M?)’, ‘no. of stations used’, ‘onset time’, ‘onset type’, ‘origin time’, ‘phase flags’, ‘phase name’, ‘pick type’, ‘sign’, ‘source region’, ‘station code’, ‘theo. azimuth (deg)’, ‘weight’].

Compare with http://www.seismic-handler.org/wiki/ShmDocFileEvt