GSBPayload

class baseband.gsb.payload.GSBPayload(words, sample_shape=(), bps=2, complex_data=False)

Bases: baseband.vlbi_base.payload.VLBIPayloadBase

Container for decoding and encoding GSB payloads.

Parameters:

words : ndarray

Array containg LSB unsigned words (with the right size) that encode the payload.

sample_shape : tuple, optional

Shape of the samples; e.g., (nchan,). Default: ().

bps : int, optional

Bits per elementary sample. Default: 2.

complex_data : bool, optional

Whether data are complex. Default: False.

Attributes Summary

data	Full decoded payload.
dtype	Numeric type of the decoded data array.
nbytes	Size of the payload in bytes.
ndim	Number of dimensions of the decoded data array.
shape	Shape of the decoded data array.
size	Total number of component samples in the decoded data array.

Methods Summary

fromdata(data[, header, bps])	Encode data as a payload.
fromfile(fh[, payload_nbytes, nchan, bps, …])	Read payloads from several threads.
tofile(fh)

Attributes Documentation

data

Full decoded payload.

dtype

Numeric type of the decoded data array.

nbytes

Size of the payload in bytes.

ndim

Number of dimensions of the decoded data array.

shape

Shape of the decoded data array.

size

Total number of component samples in the decoded data array.

Methods Documentation

classmethod fromdata(data, header=None, bps=2)

Encode data as a payload.

Parameters:

data : ndarray

Data to be encoded. The last dimension is taken as the number of channels.

header : header instance, optional

If given, used to infer the bps.

bps : int, optional

Bits per elementary sample, i.e., per channel and per real or imaginary component, used if header is not given. Default: 2.

classmethod fromfile(fh, payload_nbytes=None, nchan=1, bps=4, complex_data=False)

Read payloads from several threads.

Parameters:

fh : filehandle or tuple of tuple of filehandle

Handles to the sets of files from which data are read. The outer tuple holds distinct threads, while the inner ones holds parts of those threads. Typically, these are the two polarisations and the two parts of each in which phased baseband data are stored.

payload_nbytes : int

Number of bytes to read from each part.

nchan : int, optional

Number of channels. Default: 1.

bps : int, optional

Bits per elementary sample. Default: 4.

complex_data : bool, optional

Whether data are complex. Default: False.

tofile(fh)