GSTLALMatrixMixer

GSTLALMatrixMixer — Compute linear combinations of time series channels.

Synopsis

struct              GSTLALMatrixMixer;
struct              GSTLALMatrixMixerClass;
#define             GSTLAL_MATRIXMIXER_TYPE

Object Hierarchy

  GObject
   +----GstObject
         +----GstElement
               +----GstBaseTransform
                     +----GSTLALMatrixMixer

Properties

  "matrix"                   GValueArray*          : Read / Write

Description

Generates one or more time series channels as linear combinations of one or more input channels. The mixer is controlled using a matrix whose elements provide the mixing coefficients and whose size sets the number of input and output channels. The meaning of the coefficients is shown in the following diagram.

\begin{matrix} input channel \begin{matrix} 1 \to \\ 2 \to \\ ⋮ \\ m \to \end{matrix} & [\begin{matrix} A_{11} & A_{12} & \dots & A_{1n} \\ A_{21} & A_{22} & \dots & A_{2n} \\ ⋮ & ⋮ & ⋱ & ⋮ \\ A_{m1} & A_{m2} & \dots & A_{mn} \end{matrix}] \\ output channel & \begin{matrix} ↓ \\ 1 \end{matrix} \begin{matrix} ↓ \\ 2 \end{matrix} \dots \begin{matrix} ↓ \\ n \end{matrix} \end{matrix}

The matrix is provided to the element via the "matrix" property as a GValueArray of rows, each row is a GValueArray containing double-precision floats (the rows must all be the same size).

The coefficient ordering and the manner in which they map input channels to output channels is chosen so that the transformation of an input buffer into an output buffer can be performed as a single matrix-matrix multiplication, to allow optimized platform-specific implementations of that operation to be employed.

Reviewed: d2dcd2d01c83be1f647a8713fef48e4249433218 2014-08-10 K. Cannon, J. Creighton, B. Sathyaprakash.

Details

struct GSTLALMatrixMixer

struct GSTLALMatrixMixer;

struct GSTLALMatrixMixerClass

struct GSTLALMatrixMixerClass {
	GstBaseTransformClass parent_class;
};

GstBaseTransformClass parent_class;

the parent class