QTiling#

class gwpy.signal.qtransform.QTiling(
duration: float,
sampling: float,
qrange: tuple[float, float] = (4, 64),
frange: tuple[float, float] = (0, inf),
mismatch: float = 0.2,
)[source]#

Bases: QObject

Iterable constructor of QPlane objects.

For a given Q-range, each of the resulting QPlane objects can be iterated over.

Parameters:
durationfloat

The duration of the data to be Q-transformed.

qrangetuple of float

(low, high) pair of Q extrema.

frangetuple of float

(low, high) pair of frequency extrema.

samplingfloat

Sampling rate (in Hertz) of data to be Q-transformed.

mismatchfloat

Maximum fractional mismatch between neighbouring tiles.

Attributes Summary

qs

Array of Q values for this QTiling.

whitening_duration

The recommended data duration required for whitening.

Methods Summary

transform(fseries, **kwargs)

Compute the time-frequency plane at fixed Q with the most significant tile.

Attributes Documentation

qs[source]#

Array of Q values for this QTiling.

whitening_duration[source]#

The recommended data duration required for whitening.

Methods Documentation

transform(fseries: FrequencySeries, **kwargs) tuple[QGram, float][source]#

Compute the time-frequency plane at fixed Q with the most significant tile.

Parameters:
fseriesFrequencySeries

The complex FFT of a time-series data set.

kwargs

Other keyword arguments to pass to QPlane.transform.

Returns:
outQGram

Signal energies over the time-frequency plane containing the most significant tile.

farfloat

Crudely estimated false alarm rate (FAR) for the detected signal.

See also

QPlane.transform

Compute the Q-transform over a single time-frequency plane.