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. Stream 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