Detailed Description

This program will play data in a variety of ways.

This program will play data in a variety of ways. Its input is anything supported by :any:datasource. You can additionally whiten the data or apply a band pass filtering. It can direct its output to either your sound card, various audio file formats, or stderr/stdout in tab delimited ASCII text.

Graph of the gsreamer pipeline

gray boxes are optional and depend on the command line given

.. graphviz::

digraph G { // graph properties

rankdir=LR; compound=true; node [shape=record fontsize=10 fontname="Verdana"]; edge [fontsize=8 fontname="Verdana"];

// nodes

"mkbasicsrc()" [URL="\ref datasource.mkbasicsrc()"]; "whitened_multirate_src()" [label="whitened_multirate_src()", URL="\ref multirate_datasource.mkwhitened_multirate_src()", style=filled, color=lightgrey]; "mkresample()" [URL="\ref pipeparts.mkresample()", style=filled, color=lightgrey]; "mkcapsfilter()" [URL="\ref pipeparts.mkcapsfilter()", style=filled, color=lightgrey]; "mkaudiochebband()" [URL="\ref pipeparts.mkaudiochebband()", style=filled, color=lightgrey]; "mkaudiocheblimit()" [URL="\ref pipeparts.mkaudiocheblimit()", style=filled, color=lightgrey]; "mkaudioconvert()" [URL="\ref pipeparts.mkaudioconvert()"]; "mkaudioamplify()" [URL="\ref pipeparts.mkaudioamplify()"]; "mkautoaudiosink()" [URL="\ref pipeparts.mkautoaudiosink()", style=filled, color=lightgrey]; "mkwavenc()" [URL="\ref pipeparts.mkwavenc()", style=filled, color=lightgrey]; "mkflacenc()" [URL="\ref pipeparts.mkflacenc()", style=filled, color=lightgrey]; "mkvorbisenc()" [URL="\ref pipeparts.mkvorbisenc()", style=filled, color=lightgrey]; "mkfilesink()" [URL="\ref pipeparts.mkfilesink()", style=filled, color=lightgrey]; "mknxydumpsink()" [URL="\ref pipeparts.mknxydumpsink()", style=filled, color=lightgrey];

// connections

"mkbasicsrc()" -> "mkresample()" [label=" --whiten not provided"]; "mkresample()" -> "mkcapsfilter()"; "mkcapsfilter()" -> "mkaudioconvert()" [label=" neither --low-pass-filter nor --high-pass-filter provided"]; "mkcapsfilter()" -> "mkaudiochebband()" [label=" --low-pass-filter and --high-pass-filter provided"]; "mkcapsfilter()" -> "mkaudiocheblimit()" [label=" --low-pass-filter or --high-pass-filter provided"];

"mkbasicsrc()" -> "whitened_multirate_src()" [label=" --whiten provided"]; "whitened_multirate_src()" -> "mkaudioconvert()" [label=" neither --low-pass-filter nor --high-pass-filter provided"]; "whitened_multirate_src()" -> "mkaudiochebband()" [label=" --low-pass-filter and --high-pass-filter provided"]; "whitened_multirate_src()" -> "mkaudiocheblimit()" [label=" --low-pass-filter or --high-pass-filter provided"];

"mkaudiochebband()" -> "mkaudioconvert()"; "mkaudiocheblimit()" -> "mkaudioconvert()";

"mkaudioconvert()" -> "mkaudioamplify()";

"mkaudioamplify()" -> "mkautoaudiosink()" [label=" --output not provided"]; "mkaudioamplify()" -> "mkwavenc()" [label=" --output ends with '.wav'"]; "mkaudioamplify()" -> "mkflacenc()" [label=" --output ends with '.flac'"]; "mkaudioamplify()" -> "mkvorbisenc()" [label=" --output ends with '.ogg'"]; "mkaudioamplify()" -> "mknxydumpsink()" [label=" --output ends with '.txt' or is /dev/stderr or /dev/stdout"]; "mkwavenc()" -> "mkfilesink()"; "mkvorbisenc()" -> "mkfilesink()"; "mkflacenc()" -> "mkfilesink()"; }

Usage cases

See :py:func:datasource.append_options for additional usage cases for datasource specific command line options

Viewing low latency data in stdout (e.g. on CIT cluster) Note ctrl+c kills this::

$ gstlal_play –data-source framexmit –channel-name=L1=FAKE-STRAIN \ –output /dev/stdout
Pipe low latency data to an ogg file narrowing in on the sweet spot and add amplification to make it audible. Note ctrl+c kills this::

$ gstlal_play –data-source framexmit –channel-name=L1=FAKE-STRAIN \ –high-pass-filter 40 –low-pass-filter 1000 –amplification 1e21 –output test.ogg
Write injection time series from an xml file into an ASCII delimited text file::

$ gstlal_play –data-source silence –gps-start-time 966383960 \ –gps-end-time 966384960 –channel-name=L1=FAKE-STRAIN \ –injections=BNS-MDC1-FIXEDMASS.xml –output test.txt
Other things are certainly possible. Please add some!

Definition at line 134 of file gstlal_play.

The documentation for this class was generated from the following file:

/home/abuild/rpmbuild/BUILD/gstlal-1.4.1/bin/gstlal_play