obspy.io.sh.core._read_asc

_read_asc(filename, headonly=False, skip=0, delta=None, length=None, **kwargs)[source]

Reads a Seismic Handler ASCII file and returns an ObsPy Stream object.

Warning

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

Parameters:

  • filename (str) – ASCII file to be read.

  • headonly (bool, optional) – If set to True, read only the head. This is most useful for scanning available data in huge (temporary) data sets.

  • skip (int, optional) – Number of lines to be skipped from top of file. If defined only one trace is read from file.

  • delta (float, optional) – If skip is used, delta defines sample offset in seconds.

  • length (int, optional) – If skip is used, length defines the number of values to be read.

Return type:

Stream

Returns:

A ObsPy Stream object.

Example

>>> from obspy import read
>>> st = read("/path/to/QFILE-TEST-ASC.ASC")
>>> st  
<obspy.core.stream.Stream object at 0x...>
>>> print(st)  
3 Trace(s) in Stream:
.TEST..BHN | 2009-10-01T12:46:01.000000Z - ... | 20.0 Hz, 801 samples
.TEST..BHE | 2009-10-01T12:46:01.000000Z - ... | 20.0 Hz, 801 samples
.WET..HHZ  | 2010-01-01T01:01:05.999000Z - ... | 100.0 Hz, 4001 samples