This page provides a description of the FrDisplay tool. Further documentation on the FrDisplay tool is available at the following links:
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.
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:
The following command lines are examples of how to use the FrDisplay tool (see here for the meaning of PROC and ADC):
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