GUPPIFileReader¶
-
class
baseband.guppi.base.
GUPPIFileReader
(fh_raw)[source] [edit on github]¶ Bases:
baseband.vlbi_base.base.VLBIFileReaderBase
Simple reader for GUPPI files.
Wraps a binary filehandle, providing methods to help interpret the data, such as
read_frame
andget_frame_rate
. By default, frame payloads are mapped rather than fully read into physical memory.- Parameters
- fh_rawfilehandle
Filehandle of the raw binary data file.
Attributes Summary
info
()Methods Summary
close
(self)get_frame_rate
(self)Determine the number of frames per second.
read_frame
(self[, memmap, verify])Read the frame header and read or map the corresponding payload.
read_header
(self)Read a single header from the file.
temporary_offset
(self)Context manager for temporarily seeking to another file position.
Attributes Documentation
-
info
¶
Methods Documentation
-
close
(self) [edit on github]¶
-
get_frame_rate
(self)[source] [edit on github]¶ Determine the number of frames per second.
The routine uses the sample rate and number of samples per frame (excluding overlap) from the first header in the file.
- Returns
- frame_rate
Quantity
Frames per second.
- frame_rate
-
read_frame
(self, memmap=True, verify=True)[source] [edit on github]¶ Read the frame header and read or map the corresponding payload.
- Parameters
- Returns
- frame
GUPPIFrame
With
.header
and.payload
properties. The.data
property returns all data encoded in the frame. Since this may be too large to fit in memory, it may be better to access the parts of interest by slicing the frame.
- frame
-
read_header
(self)[source] [edit on github]¶ Read a single header from the file.
- Returns
- header
GUPPIHeader
- header
-
temporary_offset
(self) [edit on github]¶ Context manager for temporarily seeking to another file position.
To be used as part of a
with
statement:with fh_raw.temporary_offset() [as fh_raw]: with-block
On exiting the
with-block
, the file pointer is moved back to its original position.