GSTLALStateVector

GSTLALStateVector — Converts a state vector stream into booleans, for example to drive a lal_gate element.

Synopsis

struct              GSTLALStateVector;
struct              GSTLALStateVectorClass;
#define             GSTLAL_STATEVECTOR_TYPE

Object Hierarchy

  GObject
   +----GstObject
         +----GstElement
               +----GstBaseTransform
                     +----GSTLALStateVector

Properties

  "gap-samples"              guint64               : Read
  "off-samples"              guint64               : Read
  "on-samples"               guint64               : Read
  "required-off"             guint                 : Read / Write / Construct
  "required-on"              guint                 : Read / Write / Construct

Description

Each sample of the input stream is interpreted as a bit vector, and mapped one-to-one to boolean-valued output samples. Each bit of the input vectors can be required to be on, required to be off, or ignored. The bits that must be on are set with the required-on property; the bits that must be off are set with the required-off property. For each input sample that satisfies the on/off requirements the output is a non-zero sample, all other output samples are 0. Note that if the bitwise intersection of the required-on and required-off properties is non-zero it will be impossible for the input stream to satisfy the conditions and the output will be identically 0.

Typically this element is used to transform a bit vector-valued stream into a boolean stream suitable for controling a gate element.

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

Details

struct GSTLALStateVector

struct GSTLALStateVector;

struct GSTLALStateVectorClass

struct GSTLALStateVectorClass {
	GstBaseTransformClass parent_class;
};

GstBaseTransformClass parent_class;

the parent class

GSTLAL_STATEVECTOR_TYPE

#define             GSTLAL_STATEVECTOR_TYPE

Property Details

The "gap-samples" property

  "gap-samples"              guint64               : Read

number of samples seen thus far marked as gap.

Default value: 0


The "off-samples" property

  "off-samples"              guint64               : Read

Number of samples seen thus far marked as off.

Default value: 0


The "on-samples" property

  "on-samples"               guint64               : Read

Number of samples seen thus far marked as on.

Default value: 0


The "required-off" property

  "required-off"             guint                 : Read / Write / Construct

Bit mask setting the bits that must be off in the state vector.

Default value: 0


The "required-on" property

  "required-on"              guint                 : Read / Write / Construct

Bit mask setting the bits that must be on in the state vector. Note: if the mask is wider than the input stream, the high-order bits should be 0 or the on condition will never be met.

Default value: 0