Warning
The modules documented before are compiled C extensions and are subject to change. It is recommended that users use the standard modules detailed in the previous sections over directly using these modules.
Go Fast! (TM) - TBW, TBN, DRX, and DR Spectrometer readers written in C
Function to read in a DR spectrometer header structure and data and return a drspec.Frame instance.
Note
This function normalizes the spectra by the number of relevant fills. For products that are a function of more than one primary input, i.e., XY* or I, the minimum fill of X and Y are used for normalization.
Function to read in a single DRX frame (header+data) and store the contents as a Frame object. This function serves as a replacement for the pure python reader lsl.reader.drx.readFrame.
In order to use this reader in place of lsl.reader.drx.readFrame change:
>>> import lsl.reader.tbn as drx
>>> fh = open('some-drx-file.dat', 'rb')
>>> frame = drx.readFrame(fh)
to:
>>> import lsl.reader.drx as drx
>>> from lsl.reader._gofast import ReadDRX, syncError, eofError
>>> fh = open('some-drx-file.dat', 'rb')
>>> frame = readDRX(fh, tbn.Frame())
In addition, the exceptions checked for in the try...except blocks wrapping the frame reader need to be changed to ‘IOError’ since syncError and eofError are are sub-classes of IOError.
Changed in version 0.4.0: The Go Fast! readers are the default readers used by the lsl.reader.drx module.
Function to read in a single TBN frame (header+data) and store the contents as a Frame object. This function serves as a replacement for the pure python reader lsl.reader.tbn.readFrame.
In order to use this reader in place of lsl.reader.tbn.readFrame change:
>>> import lsl.reader.tbn as tbn
>>> fh = open('some-tbn-file.dat', 'rb')
>>> frame = tbn.readFrame(fh)
to:
>>> import lsl.reader.tbn as tbn
>>> from lsl.reader._gofast import ReadTBN, syncError, eofError
>>> fh = open('some-tbn-file.dat', 'rb')
>> frame = readTBN(fh, tbn.Frame())
In addition, the exceptions checked for in the try...except blocks wrapping the frame reader need to be changed to ‘IOError’ since syncError and eofError are are sub-classes of IOError.
Changed in version 0.4.0: The Go Fast! readers are the default readers used by the lsl.reader.tbn module.
Function to read in a single TBW frame (header+data) and store the contents as a Frame object. This function serves as a replacement for the pure python reader lsl.reader.tbw.readFrame.
In order to use this reader in place of lsl.reader.tbw.readFrame change:
>>> import lsl.reader.tbw as tbw
>>> fh = open('some-tbw-file.dat', 'rb')
>>> frame = tbw.readFrame(fh)
to:
>>> import lsl.reader.tbw as tbw
>>> from lsl.reader._gofast import ReadTBW, syncError, eofError
>>> fh = open('some-tbw-file.dat', 'rb')
>>> frame = readTBW(fh, tbw.Frame())
In addition, the exceptions checked for in the try...except blocks wrapping the frame reader need to be changed to ‘IOError’ since syncError and eofError are are sub-classes of IOError.
Changed in version 0.4.0: The Go Fast! readers are the default readers used by the lsl.reader.tbw module.
Exception raised when a reader encounters the end-of-file while reading.
Exception raised when a reader encounters an error with one or more of the four sync. words.
Extension to take timeseries data and convert it to the frequency domain.
See the inidividual functions for more details.
Perform a series of Fourier transforms on complex-valued data to get the PSD.
Perform a series of Fourier transforms with windows on complex-valued data to get the PSD.
Perform a series of Fourier transforms on real-valued data to get the PSD.
Perform a series of Fourier transforms with windows on real-valued data to get the PSD.
Perform a series of filter bank transforms on complex-valued data to get the PSD.
Perform a series of filter bank transforms with windows on complex-valued data to get the PSD.
Perform a series of filter bank transforms on real-valued data to get the PSD.
Perform a series of filter bank transforms with windows on real-valued data to get the PSD.
Extension to take X and Y timeseries data and create the four Stokes parameters.
Also included is an X-Engine for use with the lsl.correlator._core module to perform cross-correlations for the stokes parameters.
See the inidividual functions for more details.
Perform a series of Fourier transforms on real-valued data to get the PSD for the four Stokes parameters: I, Q, U, and V.
Perform a series of Fourier transforms with windows on real-valued data to get the PSD for the four Stokes parameters: I, Q, U, and V.
Perform a series of Fourier transforms on complex-valued data to get the PSD for the four Stokes parameters: I, Q, U, and V.
Perform a series of Fourier transforms with windows on complex-valued data to get the PSD for the four Stokes parameters: I, Q, U, and V.
C-based F and X engines for the LWA software FX correlator. These function are meant to provide an alternative to the lsl.correlator.fx.correlate function and provide a much-needed speed boost to cross-correlation.
See the inidividual functions for more details.
Perform a series of overlapped Fourier transforms on complex-valued data using OpenMP.
Perform a series of overlapped Fourier transforms on complex-valued data using OpenMP and allow for windowing of the data.
Perform a series of overlapped Fourier transforms on real-valued data using OpenMP.
Perform a series of overlapped Fourier transforms on real-valued data using OpenMP and windows.
Perform all XMACs for a data stream out of the F engine using OpenMP.
Changed in version 0.5: The second signal is not longer input as a conjugated array. Rather the conjucation is performed as part of the cross-correlation.
Perform all XMACs for a data stream out of the F engine using OpenMP that creates the four Stokes parameters: I, Q, U, and V.
channel) array of cross-correlated and averaged visibility data.