AO IC Command Dictionary

This page provide documentation on the AO IC commands.

APD.Off.Ceil [ XUI IC ] Since it is dangerous to turn off the APD with they have high count, this parameter indicated the ceiling value of the safety zone. The software won't turn off the APC unless the DC counts are under this value.

Syntax APD.Off.Ceil count

Range count - Max Count. Range is 0 to 100.

Cal.Mean.Period - [ XUI IC ] Sets the period used to calculate mean values for DC, signal.

Syntax Cal.Mean.Period sec

Range sec - Period in seconds. Ranges from 0.1 to 10.0.

Capture.Enable [ XUI IC ] This command enable, or starts the capture.

Syntax Capture.Enable

Capture.N - [ XUI IC ] Tell the capture routine the number of sample to record.

Syntax Capture.N n_samples

Range n_samples - Number of Samples. Ranges from 1 to 30000.

Capture.Save [ XUI IC ] This command save the super capture data to a 3D FITS file.

Syntax Capture.Save pathname

Range pathname - Full pathname of the destination file.

Data2DV.Data [ XUI IC ] This command identifies the default data for the data2DV command.

Syntax Data2DV.Data data

Range data - Select from: AC, DC, DC.mean, Signal,signal.mean, Delta.Drive, Primary.out, Primary.flat, PhaseA, PhaseB, tt.out, tt.delta.drive, tt.flat, inverse, tt.inverse.

Data2DV [ XUI IC ] This command instructs the XUI to package AO data as a FITS and pipe it over to DV.
For example, to send the signal values to DV running on stefan:
Data2Dv signal stefan 30125 A

Syntax Data2DV [data] [dv_hostname] [dv_port] [dv_buf_ID]

Range data - Which data to send to DV. Select from: AC, DC, DC.mean, Signal,signal.mean, Delta.Drive, Primary.out, Primary.flat, PhaseA, PhaseB, tt.out, tt.delta.drive, tt.flat, inverse, tt.inverse.

dv_hostname - ID's the Host running DV. Defaults to the XUI's DVHostname.

dv_port - ID's the port DV is using. Defaults to the XUI's DVPort.

dv_buf_ID - Which DV buffer to use. Defaults to 'A'.

DC.Floor - [ XUI IC ] Modifies the DC.Floor. The Dc.Floor is the minimum value for a 'good' DC signal. RT loop does something like:

   if( dc < dc_floor )
      signal = 0
   else
      signal = ac/dc

Syntax DC.Floor floor

Range floor - dc.floor term. Ranges from -2000 to 2000.

Die [ IC ] Tells the IC application to terminate execute.

Syntax Die

Dv [ XUI ] This command give the XUI the ability to issue a DV command.

Syntax Dv command

Range command - Any legal DV command.

DvHostname [ XUI IC ] Identifies the host running DV. The AO software can transmit data and commands over the network to DV for viewing. This commmand give the host running the DV application.

Syntax DvHostname host

Range host - The name of the computer running DV.

DvPort [ XUI IC ] Identifies the port used by DV. The AO software can transmit data and commands over the network to DV for viewing. A hosname and port number is used to identify the network connection.

Syntax DvPort port

Range port - The port used by DV. Range limited to 10000 to 32000.

FCS - [ XUI IC ] Positions the Fiber Calibration Source to its Out or In position.

Syntax FCS { out | in }

Range out - Moves the FCS out of the beam.

in - Moves the FCS in the beam.

FCS.Init - [ XUI IC ] Initializes the Fiber Calibration Source mechanism by performing the home procedure, then position it to the out position.

Syntax fcs.Init

FCS.pos - [ XUI IC ] Positions the fiber calibration source to the indicated motor value.

Syntax FCS.pos pos

Range pos - move to this motor value. Range is approx -25670 to 25630.

FCS.Sim - [ XUI IC ] Sets the FCS simulation flag.

Syntax fcs.sim { off | on }

Range Off - Off controls the actual hardware.

On - On will simulate hawdware motion.

Filter - [ XUI IC ] Selects a WFS NDR filter.

Syntax filter { f0 | f1 .. | f5 }

Range f0 - Filter Position 0

f1 - Filter Position 1

Filter.Init - [ XUI IC ] Initializes the filter wheel.

Syntax filter.Init

Filter.Sim - [ XUI IC ] Sets the filter simulation flag.

Syntax filter.sim { off | on }

Range Off - Off controls the actual hardware.

On - On will simulate hawdware motion.

Focus.Gain [ XUI IC ] For focus offload, the mean_curvature_per_second is determine. The a focus.gain is applied to calculate the focuc.inc. If the focus.inc is above a certain threshold, AO will try to adjust the telescope focus.
The focus.gain translates focus.mcps to a Observatory focus value:

focus.inc = focus.gain * focus.mcps

Syntax focus.gain gain

Range gain - Range is -5.0 to 5.0.

Focus.OffLoad - [ XUI ] During feedback, the means curvature many indicated a focus offset. The AO system can offload this focus curvature to the TCS. For the IRTF, this means adjusting the position of the hexapod. This command turns the feature off or on.

Syntax focus.offload { off | on }

Range off - Offload is off.

on - Do focus offload.

Focus.OffLoad.Period - [ XUI ] The AO system can offload this focus curvature to the TCS. For the IRTF, this means adjusting the position of the hexapod. This command turns specifies the period of the offload correction.

Syntax focus.offload.period sec

Range sec - The offload period in seconds. range is 1 to 60 seconds.

Freq - [ XUI IC ] Sets the frequency(HZ) for the membrane mirror. Also see the membrane command.

Syntax freq f

Range f - frequency in Hz. Range is 200 to 5000.

Get.Lp.State - [ XUI IC ] This command return the current state of the loop process (lp). The return value is a string, for example: idle

Syntax get.lp.state f

HexeIO [ IC ] Transmits a command to the hexapod (via the hexed).

Syntax HexeIO cmd

Range cmd - Any legal hexed command.

ICHostname [ XUI ] Identifies the host running the IC. The XUI needs to know the which computer is running the IC (and thus the realtime loop).

Syntax ICHostname host

Range host - The name of the computer running IC. (Usually aoic ).

Log [ IC ] create a message to the log. The message is also displayed on the XUI feedback window.

Syntax Log str

Range str - Any string.

Lp.Pause - [ XUI IC ] When the AO lp.state is in feedback mode the servos output can be paused using this command. When pause is on the lp, tt, tt_offload, and focus update are paused.

Syntax lp.pause { off | on }

Range off - Pause the servo update. on - Disable pause

Lp.State - [ XUI IC ] Request a change of state to the AO system. The state determine the algorithm/procedure currently be perfomed by the lp process.

Syntax lp.state { idle | feedback | pr.imat | ttdm.imat | ttsa.imat }

Range idle - no data processing. feedback - implement ao feedback correction. shadow - The DM values are based on sensor levels. pr.imat - primary IMAT data collection procedure. ttdm.imat - TT DM IMAT data collection procedure. ttsa.imat - TT SA IMAT data collection procedure.

Membrane - [ XUI IC ] Sets the frequency(HZ), phase (micro-rotation) & amplitude(micro-range) for the membrane mirror.

Syntax membrane freq phase amp

Range freq - frequency in Hz. Range is 200 to 5000.

phase - The phase indicates when the counts are read during the sin wave. This offset is specifed in micro-rotations: 0 to 1000000.

amp - The amplitude of the sine wave in micro-range. 0 to 1000000.

MFocus - [ XUI IC ] Selects the membrane focus position using the scale values of -1.0 to 1.0.

Syntax MFocus svalue

Range svalue - A scale value from -1.0 to 1.0.

MFocus.Init - [ XUI IC ] Initializes the Membrane Focus mechanism by performing the home procedure, then position it to the default position.

Syntax MFocus.Init

MFocus.pos - [ XUI IC ] Positions the Membrane Focus mechanism to the indicated motor step position.

Syntax MFocus.pos pos

Range pos - move to this motor value. Ranage is 0 to about 170000.

MFocus.Sim - [ XUI IC ] Sets the MFocus simulation flag.

Syntax mfocus.sim { off | on }

Range Off - Off controls the actual hardware.

On - On will simulate hawdware motion.

Phase - [ XUI IC ] Sets the Phase(micro-rotation) for the membrane mirror. Also see the membrane command.

Syntax freq p

Range p - The Phase indicates when the counts are read during the sin wave. This offset is specifed in micro-rotations: 0 to 1000000.

POM - [ XUI IC ] Positions the Pick-Off Mirror to its Out or In position.

Syntax POM { out | in }

Range out - Moves the POM out of the beam.

in - Moves the POM in the beam.

POM.Init - [ XUI IC ] Initializes the Pick-Off Mirror mechanism by performing the home procedure, then position it to the out position.

Syntax POM.Init

POM.pos - [ XUI IC ] Positions the Pick-Off Mirror to the indicated motor value.

Syntax POM.pos pos

Range pos - move to this motor value. Ranage is 0 to about 100650.

POM.Sim - [ XUI IC ] Sets the Pick-Off-Mirror simulation flag.

Syntax pom.sim { off | on }

Range Off - Off controls the actual hardware.

On - On will simulate hawdware motion.

Pr.Flat.Apply - [ XUI IC ] Sets pr_out[a] to pr_flat[a].

Syntax pr.flat.apply

Pr.Flat.Ele - Changes a value in the pr_flat[a] table. This table is used to flatten the DM mirror.

Syntax pr.flat.ele { inx | all } value

Range inx | all - Enter the actuator index(0 to NUM_P_ACTUATORS). Or 'all' will set all the pr_flat[a] to value.

value - Set pr_flat[inx] to this value.

Pr.Flat.Read - [ XUI ] Reads a FITS file and fills the primary_flat[a] matrix.

Syntax Pr.Flat.Read filename

Range filename - path of the FITS file containing the data. Number of data items in FITS must equal AO_NUM_P_ACTUATORS.

Pr.Gain - [ XUI IC ] Modifies the primary gain. The gain is applied to the DeltaDrive[a] to produce the Primary_out[a] in the feedback loop.

Syntax Pr.Gain gain

Range gain - Gain term. Ranges from 0.0 to 1.0.

Pr.Imat.Act.Stroke - [ XUI IC ] Sets the primary (DM) actuator Stroke value for the IMAT procedure. The act.stroke is added/subtracted to the primary_flat[a] before obtaining the signal value in the IMAT data collection procedure.

Syntax pr.imat.act.stroke s

Range s - stroke delta. Accepts a value from -1 to 1.
(primary_flat[a] + s) should be < 1.0
(primary_flat[a] - s) should be > -1.0

Pr.Imat.Coadds - [ XUI IC ] Set the number of integration cycles to co-add during the primary imat procedure.

Syntax pr.imat.coadd coadds

Range coadds - number of coadds. Range is 1 to 100000.

Pr.Imat.Cycles - [ XUI IC ] Set the number of cycles during the primary imat procedure. A cycle is define as a single sweep through each primary acturator.

Syntax pr.imat.cycles cycles

Range cycles - number of cycles. Range is 1 to 100000.

Pr.Imat.Membrane.Stoke - [ XUI IC ] Specifies the membrane stroke during the imat procedures.

Syntax Pr.Imat.Membrane.Stoke s

Range s - stroke value. Range is 0 to 1000000.

Pr.Imat.Save [ XUI IC ] Save the interaction matrix results, pr.imat_data[s][a], to a file. Three files are created:
rootname.imat.txt - Imat data as a FITS file.
rootname.imat.txt - Imat data as a text file.
rootname.info.txt - Records the imat parameters.

Syntax Pr.Imat.Save path rootname

Range path - The files will be written to this directory.
rootname - The prefix names for the files: .imat.txt and .info.txt is appended to complete the filenames.

Pr.Imat.Wait.Count - [ XUI IC ] During the Pr Imat procedure, delay are introduced when transitioning between pr sub-states. For example, from 'setting primary actuators' to 'coadd positive signal' values. This parameter controls the duration of this transition. Wait.Count are the number of loop cycles count before continuing. So the actual pause time will depend on the membrane frequency.

Syntax pr.imat.wait.count wait.count

Range wait.count - number of waits (loops). Range is 1 to 100000.

Pr.Inverse.Ele - [ XUI IC ] Inserts a value in the Inverse[a][s] table. This Inverse table is used to calculate the corrections for the primary actuators base on the sensor data.

Syntax Pr.Inverse.Ele act sen val

Range act - Which Actuator vector: 0 to NUM_PRIMARY_ACTUATORS.

sen - Which sensor coefficent in actuator vector: 0 to NUM_SENSORS.

val - Insert this value in the table: -100000 to 100000.

Pr.Inverse.Read - [ XUI ] Reads a FITS file and fills the inverse[a][s] matrix.

Syntax Pr.Inverse.Read filename

Range filename - path of the FITS file containing the inverse data. FITS file dimension: naxis1=AO_NUM_SENSORS; naxis2=AO_NUM_P_ACTUATORS

Pr.Out - [ XUI IC ] Changes a value in the pr_out[a] table. This table is controls the setting of the primary actuators (Deformable Mirror).

Syntax pr.out { inx | all } value

Range inx | all - Enter the actuator index(0 to NUM_ACTUATORS). Or 'all' will set all the pr_out[a] to value.

value - Set pr_out[inx] to this value. -1 to 1.

Pr.Servo - [ XUI IC ] In the feedback state, this control whether the primary corrections are applied to the actuators hardware.

Syntax pr.servo { off | pr | prtt }

Range off - Primary servo is off.

pr - Primary loop on (standard algorthim)

prtt - Primary loop on (with TT canceling to pr_out).

Pr.Sign - [ XUI IC ] Sets the value of the primary sign when calculating the delta_drive in the feedback loop.
delta_drive[a] = pr_sign * inverse[a][s] * signal[s]

Syntax Pr.Sign gain

Range sign - sign term. sign is either 1 or -1.

SetTimer [ XUI only ] Sets the update rate on the XUI.

Syntax SetTimer ms

Range ms - milliseconds. Range is 100 to 5000.

sm.os.init - [ IC ] Initialize the sm_os[ra,dec] values. This command is used by the ostool to support offset guiding on an AO object.

This command:

Syntax sm.os.init ra dec

Range ra - The RA offset in arcseconds.

dec - The Dec offset in arcseconds.

sm.os.update - [ IC ] Updates the sm_os[ra,dec] values. Also moves the steering mirror position. This command is used by the ostool to support offset guiding on an AO object while AO is active. Ra,Dec increment should be small -> will inside the FOV of the DM mirror.

Syntax sm.os.update ra dec

Range ra - The absolute RA offset in arcseconds.

dec - The absolute Dec offset in arcseconds.

SM.Tracker.Enable - [ IC ] Enables/Disables the SM tracker function. When enabled, the sm.tracker function tries to track the tcs offset position and moves the steering mirror to match the TCS displacements.

Syntax Sm.Tracker.Enable { off | on }

Range off - SM.Tracker is disabled.

on - SM.Tracker is enabled.

SM.Tracker.Go - [ IC ] Triggers the sm.tracker function. This command is intended to issued to the AO system by the tcsd. Sm.tracking is need when a offset command is being performed by the TCS.

The Sm.tracker.enable value also need to be ON to perform tracking.

Syntax Sm.Tracker.Go

SMirror.AS - [ IC ] Specifies a steering mirror position in units of arcseconds.

Detailed information on the steering mirror in smirror_details.pdf

Syntax SMirror.AS ra dec

Range ra - RA position in arcseconds.

dec - Dec position in arcseconds.

SMirror.Bin2AS.Rot - [ IC ] Specifies the Steering Mirror Binary-to-Arcseconds rotation parameter. The mapping between binary x/y analog output and sky Ra,Dec offset are controlled using 2D Rotation, Translation, and Scaling parameters. This command allow you to specify the rotation value.

Syntax SMirror.Bin2AS.Rot r

Range r - Rotation angle in degrees (-360 to 360).

SMirror.Bin2AS.Scale - [ IC ] Specifies the Steering Mirror Binary-to-Arcseconds Scaling parameters. The mapping between binary x/y analog output and sky Ra,Dec offset are controlled using 2D Rotation, Translation, and Scaling parameters. This command allow you to specify the scaling value.

Syntax SMirror.Bin2AS.Scale Sx Sy

Range Sx - Scaling for the X axis.

Sy - Scaling for the Y axis.

SMirror.Bin2AS.Trans - [ IC ] Specifies the Steering Mirror Binary-to-Arcseconds Translation parameters. The mapping between binary x/y analog output and sky Ra,Dec offset are controlled using 2D Rotation, Translation, and Scaling parameters. This command allow you to specify the translation values.

Syntax SMirror.Bin2AS.Trans Tx Ty

Range Tx - Translation for the X axis.

Ty - Translation for the Y axis.

SMirror.Init - [ IC ] Initializes the steering mirror mechanism.

Detailed information on the steering mirror in smirror_details.pdf

Syntax SMirror.Init

SMirror.pos - [ IC ] Positions the steering mirror.

Detailed information on the steering mirror in smirror_details.pdf

Syntax SMirror.Pos x y

Range x - X position in units of the digial value for the D/A. Range is -32768 to 32767.

y - Y position in units of the digial value for the D/A. Range is -32768 to 32767.

SMirror.Sim - [ XUI IC ] Sets the smirror simulation flag.

Syntax smirror.sim { off | on }

Range Off - Off controls the actual hardware.

On - On will simulate hawdware motion.

Stroke - [ XUI IC ] Sets the stroke (amplitude) for the membrane mirror. Also see the membrane command.

Syntax stroke amp

Range amp - The amplitude of the sine wave in micro-range. 0 to 1000000.

TCSIO [ IC ] Transmits a command to the tcs (via the tcsd).

Syntax tcsio cmd

Range cmd - Any legal tcsd command.

TT.Flat.Apply - [ XUI IC ] Copies tt_flat[a] to tt_out[a]. Effectively flatting the TT actuators. Note the tt_flat[] values can be set using the tt.flat command.

Syntax tt.flat.apply

TT.Flat - Changes a value in the tt_flat[a] table. This table is used to flatten the TT actuators.

Syntax tt.flat { inx | all } value

Range inx | all - Enter the actuator index(0 to NUM_TT_ACTUATORS). Or 'all' will set all the tt_flat[a] to value.

value - Set tt_flat[inx] to this value.

TT.Gain - [ XUI IC ] Modifies the tiptilt gain. The gain is applied to the tt_DeltaDrive[a] to produce the tt_out[a] in the feedback loop.

Syntax TT.Gain gain

Range gain - Gain term. Ranges from 0.0 to 1.0.

TT.Imat.Act.Stroke - [ XUI IC ] Sets the tiptilt actuator Stroke value for the IMAT procedure. The act.stroke is added/subtracted to the tt_flat[a] before obtaining the signal value in the IMAT data collection procedure.

Syntax tt.imat.act.stroke s

Range s - stroke delta. Accepts a value from -1 to 1.
(tt_flat[a] + s) should be < 1.0
(tt_flat[a] - s) should be > -1.0

TT.Imat.Coadds - [ XUI IC ] Set the number of integration cycles to co-add during the tt imat procedure.

Syntax tt.imat.coadd coadds

Range coadds - number of coadds. Range is 1 to 100000.

TT.Imat.Cycles - [ XUI IC ] Set the number of cycles during the TT imat procedure. A cycle is define as a single sweep through each TT acturator.

Syntax tt.imat.cycles cycles

Range cycles - number of cycles. Range is 1 to 100000.

TT.Imat.Membrane.Stoke - [ XUI IC ] Specifies the membrane stroke during the imat procedures.

Syntax TT.Imat.Membrane.Stoke s

Range s - stroke value. Range is 0 to 1000000.

TT.Imat.Wait.Count - [ XUI IC ] During the TT Imat procedure, delay are introduced when transitioning between tt sub-states. For example, from 'setting actuators' to 'coadd positive signal' values. This parameter controls the duration of this transition. Wait.Count are the number of loop cycles count before continuing. So the actual pause time will depend on the membrane frequency.

Syntax tt.imat.wait.count wait.count

Range wait.count - number of waits (loops). Range is 1 to 100000.

TT.OffLoad.Cmd - [ XUI ] When TT.OffLoad is On, the TT.OffLoad.Cmd parameter indicates the type of commands that is used to offset the TCS.

Syntax tt.offload.cmd { error | offset }

Range error - Treats the correction as a guiding correction.

offset - Treats the correction as a offset to the TCS position.

TT.OffLoad - [ XUI ] The tip-tilt correction value can be off loaded to the TCS as an offset or guiding error correction. This command turns this feature off or on. This offload correction is done by the XUI every 30 seconds - So only ONE xui should enable this feature.

Syntax tt.offload { off | on }

Range off - tt offload is off.

on - offset the TCS to keep the TT actuator centered.

TT.OffLoad.Period - [ XUI ] The AO system can offload Tip Tilt actuator position to the TCS. For the IRTF, this means adjusting the tcd offsets. This command turns specifies the period of the offload correction.

Syntax tt.offload.period sec

Range sec - The offload period in seconds. range is 1 to 60 seconds.

TT.Out - [ XUI IC ] Changes a value in the tt_out[a] table. This table is controls the setting of the tiptilt actuators.

Syntax tt.out { inx | all } value

Range inx | all - Enter the actuator index (0 to 2). Or 'all' will set all the tt_out[a] to value.

value - Set tt_out[inx] to this value. (-1 to 1).

TT.Servo - [ XUI IC ] In the feedback state, this control if or how TipTilt corrections are applied to the tiptilt actuators.

Syntax tt.servo { off | dm | sa }

Range off - Tiptilt correction if off.

dm - Use the DM (Diformable Mirror) method: TT correction based on primary_out[] information from primary loop corrections.

sa - Use the SA (Sensor Array) method: TT correction based on signal[] (Lenslet Sensor)

Pr.Sign - [ XUI IC ] Sets the value of the tt sign for calculating the tt_delta_drive in the feedback secondary loop.
tt_delta_drive[a] = tt_sign * tt_inverse[a][s] * primary_out[s]

Syntax TT.Sign gain

Range sign - sign term. sign is either 1 or -1.

tt2as.Rot - [ IC ] The mapping between the tip-tilt actuators and sky Ra,Dec offset are controlled using 2D Rotation, Translation, and Scaling parameters. This command allow you to specify the rotation value.

Syntax tt2as.Rot r

Range r - Rotation angle in degrees (-360 to 360).

tt2as.Scale - [ IC ] The mapping between tip-tilt actuators and sky Ra,Dec offset are controlled using 2D Rotation, Translation, and Scaling parameters. This command allow you to specify the scaling value.

Syntax tt2as.Scale Sx Sy

Range Sx - Scaling for the X axis.

Sy - Scaling for the Y axis.

tt2as.Trans - [ IC ] The mapping between tiptilt actuators and sky Ra,Dec offset are controlled using 2D Rotation, Translation, and Scaling parameters. This command allow you to specify the translation values.

Syntax tt2as.Trans Tx Ty

Range Tx - Translation for the X axis.

Ty - Translation for the Y axis.

ttDM.Imat.Save [ XUI IC ] Save the interaction matrix results, ttDM.imat_data[s][a], to a FITS file. File save using the following name: rootname.imat.fits.

Syntax ttDM.Imat.Save path rootname

Range path - The files will be written to this directory.
rootname - The prefix names for the files: .imat.fits is appended to complete the filenames.

ttDM.Inverse.Ele - [ XUI IC ] Inserts a value in the ttDM.Inverse[a][s] table. This Inverse table is used to calculate the corrections for the TT actuators base on the primary_out[] data for the tt.servo DM method.

Syntax ttDm.Inverse.Ele act sen val

Range act - Which Actuator vector: 0 to NUM_TT_ACTUATORS.

sen - Which sensor (primary_out): 0 to AO_NUM_P_ACTUATORS.

val - Insert this value in the table: -100000 to 100000.

ttDM.Inverse.Read - [ XUI ] Reads a FITS file and fills the ttdm_inverse[a][s] matrix.

Syntax ttDM.Inverse.Read filename

Range filename - path of the FITS file containing the inverse data. FITS file dimension: naxis1=AO_NUM_P_ACTUATORS; naxis2=AO_NUM_TT_ACTUATORS

ttex.Gain - [ XUI IC ] Modifies the ttex gain. Used by the primary loop's ttex servo's. This gain control the amount of TT information to remove.

Syntax TTex.Gain gain

Range gain - Gain term. Ranges from 0.0 to 1.0.

ttex.Imat.Read - [ XUI ] Reads a FITS file and fills the ttex_imat[s][a] matrix. This maxtix is used in prtt primary servo loop to determine the TT components to be removed from pr_out[].

Syntax ttex.Imat.Read filename

Range filename - path of the FITS file containing the data. FITS file dimension: naxis1=AO_NUM_TT_ACTUATORS; naxis2=AO_NUM_P_ACTUATORS

ttSA.Imat.Save [ XUI IC ] Save the interaction matrix results, ttSA.imat_data[s][a], to a FITS file. File save using the following name: rootname.imat.fits.

Syntax ttSA.Imat.Save path rootname

Range path - The files will be written to this directory.
rootname - The prefix names for the files: .imat.fits is appended to complete the filenames.

ttSA.Inverse.Ele - [ XUI IC ] Inserts a value in the ttSA.Inverse[a][s] table. This Inverse table is used to calculate the corrections for the TT actuators base on the signal[] data for the tt.servo SA method.

Syntax ttSA.Inverse.Ele act sen val

Range act - Which Actuator vector: 0 to NUM_TT_ACTUATORS.

sen - Which sensor vector: 0 to AO_NUM_SENSORS.

val - Insert this value in the table: -100000 to 100000.

ttSA.Inverse.Read - [ XUI ] Reads a FITS file and fills the ttsa_inverse[a][s] matrix.

Syntax ttSA.Inverse.Read filename

Range filename - path of the FITS file containing the inverse data. FITS file dimension: naxis1=AO_NUM_SENSORS; naxis2=AO_NUM_TT_ACTUATORS

view.diag.autoscale [ XUI ] Specifies a XUI's view diagram's autoscale setting. The scale refers to the min/max of the rectangle scale on the right side.

Syntax view.diag.autoscale inx { off | on }

Range inx - The figure index. 0 to 9.

off - The scale is using view.diag.range settings.
on - The scale is based on max/min of data.

view.diag.range [ XUI ] Setting for the XUI's view diagram window. When View.diag.Autoscale is OFF, the min/max value for the scale is set using these values.

Syntax view.diag.range inx min max

Range inx - The is the view diagram index. 0 to 9.

min - The min value of the scale. -32768 to 32768.
max - The max value of the scale. -32768 to 32768. And should be > min.

view.diag.source [ XUI ] Specifies the XUI view diagram's data source.

Syntax view.diag.source inx data_ID

Range inx - The is the figure index. 0 to 8.

data_ID - Identifies the data to be graphed. Data_id are: ac, dc, dc.mean, signal, signal.mean, delta.drive, delta.drive.mean, pr.out, pr.out.mean, pr.flat, phaseA, PhaseB, tt.out, tt.delta.drive, tt.flat

fig.type [ XUI ] Specifies the type of figure graphic.

Syntax fig.type inx type

Range inx - The is the figure index. 0 to 5.

data_ID - Identifies the type of graph to be used: diagram, histogram.

view.text.source [ XUI ] In the XUI view text window, this command is used to selet the text source to view.

Syntax view.text.source inx data_ID

Range inx - The column index.

data_ID - Identifies the data to be display in column. Data_id are: ac, dc, dc.mean, signal, signal.mean, delta.drive, delta.drive.mean, pr.out, pr.out.mean, pr.flat, phaseA, PhaseB, tt.out, tt.delta.drive, tt.flat

Syntax	`APD.Off.Ceil count`
Range	`count` - Max Count. Range is 0 to 100.

Syntax	`Cal.Mean.Period sec`
Range	`sec` - Period in seconds. Ranges from 0.1 to 10.0.

Syntax	`Capture.N n_samples`
Range	`n_samples` - Number of Samples. Ranges from 1 to 30000.

Syntax	`Capture.Save pathname`
Range	`pathname` - Full pathname of the destination file.

Syntax	`Data2DV.Data data`
Range	`data` - Select from: AC, DC, DC.mean, Signal,signal.mean, Delta.Drive, Primary.out, Primary.flat, PhaseA, PhaseB, tt.out, tt.delta.drive, tt.flat, inverse, tt.inverse.

Syntax	`Data2DV [data] [dv_hostname] [dv_port] [dv_buf_ID]`
Range	`data` - Which data to send to DV. Select from: AC, DC, DC.mean, Signal,signal.mean, Delta.Drive, Primary.out, Primary.flat, PhaseA, PhaseB, tt.out, tt.delta.drive, tt.flat, inverse, tt.inverse.
	`dv_hostname` - ID's the Host running DV. Defaults to the XUI's DVHostname.
	`dv_port` - ID's the port DV is using. Defaults to the XUI's DVPort.
	`dv_buf_ID` - Which DV buffer to use. Defaults to 'A'.

Syntax	`DC.Floor floor`
Range	`floor` - dc.floor term. Ranges from -2000 to 2000.

Syntax	`DvHostname host`
Range	`host` - The name of the computer running DV.

Syntax	`DvPort port`
Range	`port` - The port used by DV. Range limited to 10000 to 32000.

Syntax	`FCS { out \| in }`
Range	`out` - Moves the FCS out of the beam.
	`in` - Moves the FCS in the beam.

Syntax	`FCS.pos pos`
Range	`pos` - move to this motor value. Range is approx -25670 to 25630.

Syntax	`fcs.sim { off \| on }`
Range	`Off` - Off controls the actual hardware.
	`On` - On will simulate hawdware motion.

Syntax	`filter { f0 \| f1 .. \| f5 }`
Range	`f0` - Filter Position 0
	`f1` - Filter Position 1

Syntax	`filter.sim { off \| on }`
Range	`Off` - Off controls the actual hardware.
	`On` - On will simulate hawdware motion.

Syntax	`focus.offload { off \| on }`
Range	`off` - Offload is off.
	`on` - Do focus offload.

Syntax	`focus.offload.period sec`
Range	`sec` - The offload period in seconds. range is 1 to 60 seconds.

Syntax	`freq f`
Range	`f` - frequency in Hz. Range is 200 to 5000.

Syntax	`ICHostname host`
Range	`host` - The name of the computer running IC. (Usually aoic ).

Syntax	`lp.pause { off \| on }`
Range	`off` - Pause the servo update. `on` - Disable pause

Syntax	`lp.state { idle \| feedback \| pr.imat \| ttdm.imat \| ttsa.imat }`
Range	`idle` - no data processing. `feedback` - implement ao feedback correction. `shadow` - The DM values are based on sensor levels. `pr.imat` - primary IMAT data collection procedure. `ttdm.imat` - TT DM IMAT data collection procedure. `ttsa.imat` - TT SA IMAT data collection procedure.

Syntax	`membrane freq phase amp`
Range	`freq` - frequency in Hz. Range is 200 to 5000.
	`phase` - The phase indicates when the counts are read during the sin wave. This offset is specifed in micro-rotations: 0 to 1000000.
	`amp` - The amplitude of the sine wave in micro-range. 0 to 1000000.

Syntax	`MFocus svalue`
Range	`svalue` - A scale value from -1.0 to 1.0.

Syntax	`MFocus.pos pos`
Range	`pos` - move to this motor value. Ranage is 0 to about 170000.

Syntax	`mfocus.sim { off \| on }`
Range	`Off` - Off controls the actual hardware.
	`On` - On will simulate hawdware motion.

Syntax	`freq p`
Range	`p` - The Phase indicates when the counts are read during the sin wave. This offset is specifed in micro-rotations: 0 to 1000000.

Syntax	`POM { out \| in }`
Range	`out` - Moves the POM out of the beam.
	`in` - Moves the POM in the beam.

Syntax	`POM.pos pos`
Range	`pos` - move to this motor value. Ranage is 0 to about 100650.

Syntax	`pom.sim { off \| on }`
Range	`Off` - Off controls the actual hardware.
	`On` - On will simulate hawdware motion.

Syntax	`pr.flat.ele { inx \| all } value`
Range	`inx \| all` - Enter the actuator index(0 to NUM_P_ACTUATORS). Or 'all' will set all the pr_flat[a] to value.
	`value` - Set pr_flat[inx] to this value.

Syntax	`Pr.Flat.Read filename`
Range	`filename` - path of the FITS file containing the data. Number of data items in FITS must equal AO_NUM_P_ACTUATORS.