obspy.core.event.read_events¶
-
read_events
(pathname_or_url=None, format=None, **kwargs)[source]¶ Read event files into an ObsPy Catalog object.
The
read_events()
function opens either one or multiple event files given via file name or URL using thepathname_or_url
attribute.Parameters: - pathname_or_url (str or StringIO.StringIO) – String containing a file name or a URL or a open
file-like object. Wildcards are allowed for a file name. If this
attribute is omitted, an example
Catalog
object will be returned. - format (str) – Format of the file to read (e.g.
"QUAKEML"
). See the Supported Formats section below for a list of supported formats.
Return type: Returns: An ObsPy
Catalog
object.Supported Formats
Additional ObsPy modules extend the functionality of the
read_events()
function. The following table summarizes all known file formats currently supported by ObsPy.Please refer to the Linked Function Call of each module for any extra options available at the import stage.
Format Used Module Linked Function Call CMTSOLUTION obspy.io.cmtsolution
obspy.io.cmtsolution.core._read_cmtsolution()
FNETMT obspy.io.nied
obspy.io.nied.fnetmt._read_fnetmt_catalog()
GSE2 obspy.io.gse2
obspy.io.gse2.bulletin._read_gse2()
IMS10BULLETIN obspy.io.iaspei
obspy.io.iaspei.core._read_ims10_bulletin()
MCHEDR obspy.io.pde
obspy.io.pde.mchedr._read_mchedr()
NDK obspy.io.ndk
obspy.io.ndk.core._read_ndk()
NLLOC_HYP obspy.io.nlloc
obspy.io.nlloc.core.read_nlloc_hyp()
NORDIC obspy.io.nordic
obspy.io.nordic.core.read_nordic()
QUAKEML obspy.io.quakeml
obspy.io.quakeml.core._read_quakeml()
SC3ML obspy.io.seiscomp
obspy.io.seiscomp.event._read_sc3ml()
SCARDEC obspy.io.scardec
obspy.io.scardec.core._read_scardec()
ZMAP obspy.io.zmap
obspy.io.zmap.core._read_zmap()
Next to the
read_events()
function thewrite()
method of the returnedCatalog
object can be used to export the data to the file system.- pathname_or_url (str or StringIO.StringIO) – String containing a file name or a URL or a open
file-like object. Wildcards are allowed for a file name. If this
attribute is omitted, an example