TDS documentation

gistfile1.txt

pt@pt-ws2 /opt/src/projects-aei/tds/TDS $ ls
Makefile     tdscntr.cc     tdsdcpl     tdsline     tdsread.o     tdssine.cc
Makefile.am  tdscntr.o      tdsdcpl.cc  tdsline.cc  tdsrelief     tdssine.o
Makefile.in  tdsdata        tdsdcpl.o   tdsline.o   tdsrelief.cc  tdswait.cc
tdsalgn.cc   tdsdata.cc     tdsdmd      tdslink     tdsrelief.o   tdswfs.cc
tdsavg       tdsdataGPS     tdsdmd.cc   tdslink.cc  tdsresp       tdswrite
tdsavg.cc    tdsdataGPS.cc  tdsdmd.o    tdslink.o   tdsresp.cc    tdswrite.cc
tdsavg.o     tdsdataGPS.o   tdsdump.cc  tdsread     tdsresp.o     tdswrite.o
tdscntr      tdsdata.o      tdshead.hh  tdsread.cc  tdssine
pt@pt-ws2 /opt/src/projects-aei/tds/TDS $ ./tdsavg
USAGE: ./tdsavg <duration> <chan 0> [<chan 1> ...]

Avgerage channels over some time.
Output is one value per line.

Example usage:
./tdsavg 10 H1:LSC-AS1_Q_OUT16 H1:LSC-AS2_Q_OUT16

pt@pt-ws2 /opt/src/projects-aei/tds/TDS $ ./tdscntr
USAGE: ./tdscntr <IFO> <ARM> timeout pit_gain yaw_gain pit_set yaw_set
<IFO>   = C1, L1, H2 or H1
<ARM>   = X or Y

Example usage:
./tdscntr L1 X 30 20 20 -73 -41

pt@pt-ws2 /opt/src/projects-aei/tds/TDS $ ./tdsdata
USAGE: ./tdsdata <sample freq> <duration> <chan 0> [<chan 1> ...]

Example usage:
./tdsdata 256 10 L1:IOO-MC_F

pt@pt-ws2 /opt/src/projects-aei/tds/TDS $ ./tdsdataGPS
USAGE: ./tdsdataGPS <sample freq> <duration> <chan 0> [<chan 1> ...]

Example usage:
./tdsdataGPS 256 10 L1:IOO-MC_F

pt@pt-ws2 /opt/src/projects-aei/tds/TDS $ ./tdsdcpl
USAGE: ./tdsdcpl <freq> <amp> <nCycle> <nAvg>  <exc chan> <meas chans> <knobs>
<freq>       = excitation frequency
<amp>        = excitation amplitude
<nCycle>     = measurement cycles
<nAvg>       = measurement averages
<exc chan>   = excitation channel
<meas chans> = measurement channels, each preceded by -m
<knobs>      = adjustable record, each precedeed by -k 
-t <time>    = dead time between steps (default 2.0)
-tol         = exit tolerance (default 0.5)
-dry         = dry run - output position, but don't move

./tdsdcpl measures the sine response of the measurement
channels to the excitation channel, then attemps to change
the knob values to zero the response in all measurement
channels. This is done as an iterative exploration of the
knob space.  To make multi-record knobs, list each record
and its step size without a separating -k, as in the example.
Measurements can be given a weight value (defalut is 1.0).
Multi-channel measurements are not yet supported.

Example usage:
./tdsdcpl 95.2 10.0 50 10 H1:SUS-ETMX_ASCPIT_EXC -m H1:LSC-AS_Q \
  -k H1:SUS-ETMX_ULPIT_GAIN 0.02 H1:SUS-ETMX_URPIT_GAIN 0.02 \
     H1:SUS-ETMX_LLPIT_GAIN 0.02 H1:SUS-ETMX_LRPIT_GAIN 0.02
This example has a single measurement channel and a single
four-record knob.  It could be used to diagonalize the pitch
drive on H1:ETMX. A similar example for H2:MC2:

./tdsdcpl 95.2 0.01 50 10 H2:SUS-MC2_ASCPIT_EXC -m H2:IOO-MC_F \
  -k H2:SUS-MC2_ULPIT_GAIN 0.02 H2:SUS-MC2_URPIT_GAIN 0.02 \
     H2:SUS-MC2_LLPIT_GAIN 0.02 H2:SUS-MC2_LRPIT_GAIN 0.02

ASC Output Matrix Example:
./tdsdcpl 22.2 20.0 40 10 H1:ASC-WFS2A_PIT_EXC \
 -m H1:ASC-WFS3_IP -m H1:ASC-WFS4_IP 2.0 \
 -k H1:ASC-WFS_MP12 0.03 H1:ASC-WFS_MP22 0.03 \
 -k H1:ASC-WFS_MP52 0.03 -t 1.0

ERROR: TDS - Run with no arguments for usage information.
pt@pt-ws2 /opt/src/projects-aei/tds/TDS $ ./tdsdmd
ERROR: wrong number of arugments (0 < 4)
USAGE: ./tdsdmd <freq> <nCycle> <nAvg> <meas chans>
<freq>       = demodulation frequency
<nCycle>     = measurement cycles
<nAvg>       = measurement averages
<meas chans> = measurement channels

./tdsdmd measures the amplitude of a single frequency in
the mesurement channels.
The output has one row for each measurement channel.  Each
row is [coh mag phi re im err_re err_im].  Obviously,
there is some redundancy in this output.

Example usage:
./tdsdmd 24.4 10 5 L1:ASC-WFS5_PIT_EXC \
 L1:ASC-WFS5_PIT_IN1 L1:ASC-WFS5_PIT_IN2

pt@pt-ws2 /opt/src/projects-aei/tds/TDS $ ./tdslink
USAGE: ./tdslink <input chan> <output record>

./tdslink reads the input channel, filters it with two poles at
1 Hz and two more at 10 Hz, and writes the result to the
output record at 4 Hz.  The gain at DC is one, the phase delay
is 25 degrees at 0.1 Hz, 50 at 0.2, 90 at 0.3, and 180 at 0.6.

Example usage:
./tdslink L1:LSC-ETMX_OUT L1:SEI-ETMX_TIDAL_DM_OFFSET

pt@pt-ws2 /opt/src/projects-aei/tds/TDS $ ./tdsread
USAGE: ./tdsread < record > [< record > ...]
< record >       = record name

Example usage:
./tdsread L1:SUS-MC1_ASCPIT_GAIN L1:SUS-MC1_ASCYAW_GAIN

pt@pt-ws2 /opt/src/projects-aei/tds/TDS $ ./tdsresp
ERROR: wrong number of arugments (0 < 5)
USAGE: ./tdsresp <freq> <amp> <nCycle> <nAvg>  <exc chan> <meas chans>
<freq>       = excitation frequency
<amp>        = excitation amplitude
<nCycle>     = measurement cycles
<nAvg>       = measurement averages
<exc chan>   = excitation channel
<meas chans>  = measurement channels

./tdsresp measures the sine response of the measurement
channels to the excitation channel. The excitation channel
is also included as a measurement channel for reference.
The output has one row for each measurement channel.  Each
row is [coh mag phi re im err_re err_im].  Obviously,
there is some redundancy in this output.

Example usage:
./tdsresp 24.4 0.1 10 5 L1:ASC-WFS5_PIT_EXC \
 L1:ASC-WFS5_PIT_IN1 L1:ASC-WFS5_PIT_IN2

pt@pt-ws2 /opt/src/projects-aei/tds/TDS $ ./tdssine
ERROR: wrong number of arugments (0 != 3 or 4)
USAGE: ./tdssine <freq> <amp> <chan> [<timeout>]
<freq>       = stimulus frequency
<amp>        = stimulus amplitude
<chan>       = stimulus channel
<timeout>    = maximum run time, default is 120 seconds

Example usage:
./tdssine 21 100 L1:SUS-MC1_ASCPIT_EXC

pt@pt-ws2 /opt/src/projects-aei/tds/TDS $ ./tdswrite
USAGE: tdswrite < record > < value > [< record > < value > ...]
< record >       = record name
< value >        = record value

options:
-sw < filter bank > < options >
  standard filter bank switching (as ezcaswitch) 
-sleep < seconds >
  sleep for the specified time
-verb
  start verbose reporting
-quiet
  stop verbose reporting


Example usage:
tdswrite L1:SUS-MC2_POFF_COMM 0.0 L1:SUS-MC2_YOFF_COMM 0.0

More complicated example usage:
tdswrite -verb L1:ASC-WFS5_YAW_OFFSET 10 \
  -sw L1:ASC-WFS5_YAW OFFSET FM1 ON -sleep 5 \
  -sw L1:ASC-WFS5_YAW OFFSET OFF CLEAR -sleep 5 \
  -sw L1:ASC-WFS5_YAW FMALL OFF L1:ASC-WFS5_YAW_OFFSET 0