obspy.io.mseed3.core._read_mseed3

_read_mseed3(mseed3_file, starttime=None, endtime=None, matchsid=None, merge=True, verbose=None, **kwargs)[source]

Reads a mseed3 file and returns a Stream object.

Warning

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

Parameters:

  • mseed3_file – Filename or open file like object that contains the binary mseed3 data. Any object that provides a read() method will be considered to be a file like object.

  • starttime (UTCDateTime) – Only read data records after or at the start time.

  • endtime (UTCDateTime) – Only read data records before or at the end time.

  • matchsid (str) – Only read data with matching FDSN Source Id (can be regular expression, e.g. “BW_UH2.*” or “.*_._._Z”). Defaults to None .

Example

>>> from obspy import read
>>> st = read("/path/to/casee_two.ms3")
>>> print(st)  
1 Trace(s) in Stream:
CO.CASEE.00.HHZ | 2023-06-17T04:53:50.008392Z ... | 100.0 Hz, 550 samples

>>> from obspy import UTCDateTime
>>> st = read("/path/to/casee_two.ms3",
...           starttime=UTCDateTime("2010-06-20T00:00:01"),
...           matchsid="_._H_Z")
>>> print(st)  
1 Trace(s) in Stream:
CO.CASEE.00.HHZ | 2023-06-17T04:53:50.008392Z ... | 100.0 Hz, 550 samples