Data Display

This page provides a description of the FrDisplay tool. Further documentation on the FrDisplay tool is available at the following links:

• VirgoWeek_16Nov11_FrDisplay.pdf

Overview

The FrDisplay tool enables the plotting of spectrograms, spectra and waveforms from data contained in frame files. It wraps the considered frame files and Baudline, a software developed for data visualization in the time-frequency domain. FrDisplay can also be used to list the channels available in the considered frames, see this page: How to dump the frame file contents.

Warning

Baudeline is not longer maintained, the latest version dates back to 2013, only the executable is available and still works.

A graphical overview of the FrDisplay tool is provided by the following image:

Examples

The following command lines are examples of how to use the FrDisplay tool (see here for the meaning of PROC and ADC):

• Help Commands:

  list of ligo_data_find data_type (only for ATLAS & CIT)
  FrDisplay -i ldf -s help
  baudline list of parameters
  FrDisplay -x help
  filter help
  FrDisplay -k help
  

• How to control baudline display:

  Data are sent to baudline in continuos way until the end of last frame,
  to stop the flux of data select the baudline window and press space
  to start press again space
  To exit select the command line window and press CTRL-C and type 'y'
  Note: some time is necessary to press 2 times CTRL-C
  To save the baudline picture in png format select the command line window and press CTRL-C and type 's'
  then select the the baudline window to be saved. The picture is saved in the current directory
  with the name reported in the command window
  If the exit command do not complete successfully use the command kbaudine or kFrDisplay
  

• Display of Proc Data:

  There are different way to access to frame data

  by file name (same syntax as FrDump)
  FrDisplayPROC -t H1:LDAS-STRAIN -i /atlas/data/d14/LSC/H/95560/H-H1_LDAS_C02_L2-955609344-128.gwf
  FrDisplayPROC -t G1:DER_DATA_H -i /atlas/hsm/GEO/h/RDS3/frames/2011/day155/hour18/G-G1_RDS_C01_L3-991247*.gwf
  by ffl file list
  FrDisplayPROC -t H1:LDAS-STRAIN -i $FRDISPLAY_DIR/ffl/h1_atlas.ffl
  by ligo_data_find command (embedded in the FrDisplay)
  FrDisplayPROC -t H1:LDAS-STRAIN -i ldf -o H -s H1_LDAS_C02_L2 -f 955609344 -l 955609544
  It is possible to list the channels present in the frame file
  FrDisplayPROC -i ldf -o H -s H1_LDAS_C02_L2 -f 955609344 -l 955619944
  FrDisplayPROC -i /atlas/data/d14/LSC/H/95560/H-H1_LDAS_C02_L2-955609344-128.gwf
  It is possible to display a channel using the channel number of the list
  FrDisplayPROC -i /atlas/data/d14/LSC/H/95560/H-H1_LDAS_C02_L2-955609* -t 3
  

• Display of Adc Data:

  If in the frame file there are many channels. It possible to show simultaneusly up to 3 channels
  NB: the scale normalization of the 3 channels is set to the same level !!!
  FrDisplayADC -t "V1:Sc_OB_Gr_Coil1 V1:Sc_OB_tyCorr V1:Pr_B2_DC" -i /home/vedovato/frames/V1_RAW_TST/V-raw-986188050-150.gwf
  It is possible to list the channels present in the frame file
  (NB! only channels with sample rate>50Hz)
  FrDisplayADC -i /home/vedovato/frames/V1_RAW_TST/V-raw-986188050-150.gwf
  

• Apply Filters to Data:

  The dinamic of baudline is 16bit, so to avoid signal dirstorsions is necessary to apply a high pass filter to the data
  to pass the filter parameters use the key -k
  Ex: -k "-Bu -Hp -o 6 -a 50"  is a HighPass (-Hp) Butterworth (-Bu) filter of order 6 (-o 6) with a corner frequency 50Hz (-a 50)
  For more options see the mkfilter manual
  FrDisplayPROC -t G1:DER_DATA_H -i ldf -o G -s G1_RDS_C01_L3 -f 991247040 -l 991248040 -k "-Bu -Hp -o 6 -a 50"
  

• Apply Baudline options to Data:

  It is possible to pass the baudline parameters from the FrDisplay command line using the key -x
  Ex: -x "-decimateby 4 -downmix 600 -decimategain 48"  : data are decimate bny a factor 4, the new start freq is 600Hz and the amplitude gain is 48dB
  FrDisplayPROC -t H1:LDAS-STRAIN -i ldf -o H -s H1_LDAS_C02_L2 -f 955609344 -l 955619944 -x "-decimateby 4 -downmix 601 -decimategain 48"
  The gain of the data is selected to obtain the best visualization in baudline
  If the user want to apply a differnt gain use the option -uscaleby
  Ex : -x "-uscaleby 0.5" - the gain is divided by 2
  FrDisplayPROC -t H1:LDAS-STRAIN -i ldf -o H -s H1_LDAS_C02_L2 -f 955609344 -l 955619944 -x "-uscaleby 0.5"
  For more options see the baudline online manual
  

The complete list of options is available at the following directory in the git distribution:

tools/frdisplay/README.*