INTERFACE SMU # Secondary mirror unit task interface file # # History # UKTH::JHF : 13-Jun-1987 Original # JACH::MAREN: 10-Oct-1989 sort things alphabetical for documentation # JCMT::APGR: 16-Dec-1989 Update XB and YB for Goeran's new focus measurements # JACH::FJO: 21-Sep-1990 Changed N/S & E/W chop ampl scales (.17 to .010625) # JACH::FJO: 21-Sep-1990 Added N/S & E/W phase scale factor (360deg/4096firm) # JACH::FJO: 26-Sep-1990 Added ABORT N/S & E/W # JCMT::FJO: 01-Nov-1990 N/S & E/W amplitude scale change # JCMT::FJO: 02-Nov-1990 Removed UPDATE & TRACK actions # and added CHOP_INTERVAL # JCMT::FJO: 14-Nov-1990 Removed SET_CHOPPERW, # added MAX_SET_CHOPPER # JCMT::FJO 16-Nov-1990 Change NS EW amplitude scales # JCMT::RMP 17-Nov-1990 Change chop_interval default # JCMT::FJO 21-Nov-1990 Added CHOP_MONITOR flag # JCMT::FJO 23-Nov-1990 Added SYNC (External Sync) and REF (External Ref) # JCMT::RMP 24-Nov-1990 Change CHOP_MONITOR to logical # JCMT::RMP 24-Nov-1990 Change EW scale from 0.009539 to 0.0105 # JCMT::RMP 26-Nov-1990 Change EW scale to be same as NS, after work # Done by SEB # JCMT::RMP 30-Nov-1990 Change both scales after commissioning by GS # JCMT::FJO 04-Dec-1990 Added NS & EW TRIPOS flags for Centre Chopping # JACH::FJO 12-Dec-1990 Changed Frequency and Period ranges # Updated HELPs and FULLHELPs # JACH::FJO 16-Jan-1991 Prettied up HELP lines, etc. for Tex doc. # JACH::FJO 23-Jan-1991 Remove EXT_REF, EXT_SYNC actions, # Remove REF, SYNC parameters # Add CHOP_MODE action and MODE parameter # which supercedes the EXT_ commands. # JCMT::FJO 25-JAN-1991 EW scale change # JCMT::RMP 25-Mar-1991 EW scale change # JCMT::RMP 29-Mar-1991 Add X_OFFSET # JCMT::RMP 02-Apr-1991 EW and NS scale change, change default # frequency to 4.0 # JCMT::RMP 08-May-1991 Add action INS_OFFSET and associated parameters # JCMT::RMP 08-May-1991 EW scale change # JCMT::FJO 01-Jul-1991 Triangle wavetype (fjo) # JACH::FJO 03-Sep-1991 Linearly variable NS and EW amplitude scales # New params: FREQ_LIMIT, THROW_LIMIT, # EW_AMPL_SLOPE_1, EW_AMPL_SLOPE_2, # EW_AMPL_CONST_1, EW_AMPL_CONST_2 # NS_AMPL_SLOPE_1, NS_AMPL_SLOPE_2, # NS_AMPL_CONST_1, NS_AMPL_CONST_2 # JACH::FJO 05-Sep-1991 Set DEFAULT values of slope and constant # JCMT::RMP 18-Sep-1991 SET EW SLOPE CONST to 1 and 0 # JCMT::RMP 04-Oct-1991 Change all EW and NS values after removal # of scale0 parameters and re-fitting # JACH::FJO 20-Dec-1991 Changed default EW_AMPL_SLOPE_1 # JACH::FJO 09-Jan-1992 Added parameter BLANK_TIME, action SET_BLANK # JCMT::RMP 23-Mar-1992 Change EW_AMPL_SLOPE_1 # JACH::FJO 23-Jul-1992 Change XA, XB, YB, ZA, ZB; Add ZC (Non-linear term) # JACH::FJO 12-Aug-1992 Add parms JIGGLE_FILE, JIGGLE_START, JIGGLE_END, # and JIGGLE_DWELL # Add actions READ_JIGGLE, JIGGLE, # START_JIGGLE, STOP_JIGGLE # Add action CREATE_NB # # JACH::CJM 17-Aug-1992 Add parameter JIGGLE_MAX, rename JIGGLE to # LOAD_JIGGLE, update focus default coeffs # JACH::CJM 18-Aug-1992 Add parameter JIGGLE_COORDS # JACH::CJM 19-AUG-1992 restore JIGGLE action # JACH::FJO 01-Sep-1992 complete needs list for READ_JIGGLE and JIGGLE # JACH::FJO 03-Sep-1992 add IEEE_CONNECT_1 for the Tables routines # to separate it from the Chopper # JACH::CJM 06-Sep-1992 add code to support Nasmyth chopping # JACH::FJO 25-Sep-1992 add actions JIGGLE_START and JIGGLE_END # JACH::FJO 28-Sep-1992 add focus temp. parameters DZT_COEFF and DZT_CONST # add parameter MO_TASK # JACH::FJO 30-Sep-1992 add MO_TASK to needs of action CONNECT # JACH::CJM 06-Nov-1992 change needs list for read_jiggle & jiggle # JACH::CJM 18-NOV-1992 add parameter APPLY_TEMP_CORR # JACH::FJO 15-DEC-1992 supply x,y,z instrument offsets for all RX's. # JACH::FJO 08-JAN-1993 add instrument x, y, z offsets for RXC2 # JCMT::FJO 23-JUN-1993 set RXG_OFFSET_INS # JCMT::RMP 19-JUL-1993 Modify XB, YB, ZB (constants) after SMU removal # associated with FLC # JCMT::RMP 12-OCT-1993 Modify XB, YB, ZB (constants) after surface # adjustment 26th August and some worrying! # JCMT::FJO 01-Dec-1993 Add chopper signal wave output names (OUTPUT_WAVE) # and action WAVE_OUT # Add parameter MAX_RMSERR # JACH::FJO 02-Dec-1993 Add NS and EW output_wave parameters # JCMT::RMP 04-Dec-1993 Added PRINT_ERRORS parameter for SMU_SHOW_CHOPPER # JCMT::RMP 04-Dec-1993 Modified method of setting scales completely # JCMT::RMP 05-Dec-1993 Correct EW values # JACH::FJO 10-Dec-1993 Add fullhelp for OUTPUT_WAVE_EW and _NS # JACH::FJO 05-Dec-1993 Change BUS_2 (chopper) from 3 to 4 # JCMT::RMP 29-JAN-1994 Modify ZB, (constant) after FLC # JCMT::FJO 29-Sep-1994 Changed MAX_AMPL and MAX_OFFS for New Chopper # JCMT::FJO/RMP 30-Sep-1994 Changed EW_AMPL_SLOPE and NS_AMPL_SLOPE # JCMT::RMP 01-Oct-1994 Changed EW_AMPL_SLOPE # JCMT::RMP 01-Oct-1994 Changed XB, YB and ZB after SMU off/on # JCMT::RMP 02-Oct-1994 Change NS_AMPL_SLOPE, XB # JACH::FJO 07-Oct-1994 Add POSOFF_EW & POSOFF_NS Chopper tilt parms # Add parameter ABORTCHOP_WAIT # Add action CHOPPER_POSOFF # JACH::FJO 07-Oct-1994 Change signs of values of POSOFF_EW and POSOFF_NS # JACH::RMP 25-Oct-1994 Set POSOFF_EW and NS to 0 # JCMT::FJO 16-Nov-1994 Add parms RX, RY and RZ # JCMT::RMP 09-Mar-1995 Change SLOPE and CORR parameters # JCMT::RMP 09-Mar-1995 Change EW_AMPL_SLOPE # JACH::MARY 24-Apr-1995 Add RXW1, RXW2, RXB3CU, remove obsolete RX's # JACH::FJO 05-Sep-1995 Add FTS instrument offsets # JCMT::RMP 07-Feb-1996 Put SMU on bus 4 # JACH::FJO 17-Jul-1996 Changed DZT and DZT_CONST per IMC's focus study # JACH::FJO 14-Aug-1996 Add action LOAD_USERWAVE, param USERWAVE_FILE # JCMT::FJO 20-Aug-1996 Change WAVEFORM USERWAVE to USER, # WAVETYPE USER TO USERWAVE # JACH::FJO 17-Sep-1996 Add SCUBAWAVE waveform and SCUBAWAVE wavetype. # JACH::FJO 22-Oct-1996 Add SCUBA XYZ tables offsets # JACH::FJO 25-Oct-1996 Add RAMPWAVE waveform and wavetype # JCMT::RMP 04-Feb-1997 Modify receiver focus offsets for A and B3 # JACH::FJO 05-Jun-1997 Add params JIGGLE_DWELL,JIGGLE_COORDS,JIGGLE_SCALE # to the action LOAD_JIGGLE. # JACH::FJO 06-Jun-1997 Add params SCUBA_CHP_OFFS & SCUBA_CHP_CORR # Mary Fuka 25-Jun-1997 Translate RXB3CU to RXB # JACH::FJO 31-Dec-1997 Changed RXC2 x,y,z offsets per IMC values. # JACH::RMP 30-Apr-1998 Change FREQUENCY and PERIOD to allow 50Hz # JACH::RMP 07-May-1998 Change FREQUENCY and PERIOD to allow 1024Hz, # add JIGGLE_THROW # JACH::MARY 27-May-1998 Add RXW_C, RXW_D # JACH::RMP 27-May-1998 Subtract 0.3 from SCUBA XYZ_OFFSETS # HACH::MARY 25-Nov-1998 Add RXA3I # JACH::RMP 11-Jan-1999 Try putting SMU back on bus 3 # JACH::RMP 23-Mar-1999 Temporarily put SMU on bus 1 for tests # JACH::RMP 19-APr-1999 Add SPIFI # JACH::RMP 14-May-1999 add TEL_TASK parameter for PTCS # HP::FJO 27-Dec-1999 updated all instruments focus offsets # JACH::FJO 05-Jan-2000 updated SCUBA focus offsets # JCMT::FJO 31-MAY-2000 change tables move tolerance from 3 to 25 encs. # JACH::FJO 31-Jul-2000 add MPI xyz offsets, change y_tolerance by to 3. # JACH::FJO 06-Sep-2000 Added ZA_SCUBA, ZB_SCUBA, ZC_SCUBA. # JACH::FJO 07-Sep-2000 change active RX X,Y,Z offsets. # JACH::FJO 14-Sep-2000 add ZA_SPIFI, ZB_SPIFI, ZC_SPIFI. # JACH::IMC 08-Jan-2001 update RxW_ _X & _Y # JACH::IMC 10-Jan-2001 update SCUBA RxB & RxW_D # JACH::FJO 07-Mar-2001 add SCUBA_NUREST and SPIFI_NUREST params. # imc : 22-may-2001 : set ZA, ZA_SCUBA, ZA_SPIFI = 0.54, SCUBA_Y_OFFSET=-0.95 # JCMT::FJO 20-Jun-2001 add FTS_1 and FTS_2, leave FTS. # JCMT::FJO 20-Jun-2001 update X,Y,Z for FTS_1 and FTS_2. # imc : 31 Jul 2001 : update X,Y,Z for RxB & RxW_C : data from UT20010727 # imc : 13 Aug 2001 : update DZT_COEFF # fjo : 14 Dec 2001 : update X,Y,Z for FTS_1 and FTS_2 (set all to 0.0) # fjo : 19 dec 2001 : change FTS_1 x,y,z # fjo : 04 Jan 2002 : activate range checking for JIGGLE_COORDS # fjo : 07 Jan 2002 : activate range checking for (chop) COORDS # imc : 21 mar 2002 : updated focus offsets # fjo : 17 Apr 2002 : imc updated mpi x,y,z # fjo : 27 Aug 2002 : change BUS_1 and BUS_2 from 3 to 4. # imc : 31 Oct 2002 : update focus offsets & temperature relationship of Z # fjo : 24 Jul 2003 : copy of the 31 Oct 2002 (16:02:27.54) version # used prior to SMU X tables belt failure. # imc : 28 Jul 2003 : updates to XYZ axis zero points after SMU FCO # imc : 26 Aug 2003 : 2nd order updates to zeropoints # imc : 10 Sep 2003 : update to DZT_COEFF # imc : 03 Oct 2003 : update to Z-ZERO # fjo/imc : 16 Oct 2003 : update to DZT_COEFF (for antenna mean leg temp) # imc : 17 Oct 2002 : update Z_ZERO following yesterday's change # imc : 08 Dec 2003 : ewoff,nsoff from (0,0) to (+37.9,+39.3) # imc/fjo : 08 Dec 2003 : change ewoff and nsoff to _REALs. # imc : 17 Dec 2003 : zero-point changes made to Z & Y for SCUBA, RxA, RxB # fjo : 07 Jan 2004 : clear ewoff & nsoff, set posoff_ns and _ew instead. PARAMETER ABORT_CHOP_EW TYPE '_LOGICAL' VPATH 'INTERNAL' HELP 'Chop East-West axis abort state: YES = abort, NO = enable.' DEFAULT NO #FULLHELP This parameter is used to enable or disable the East-West chopper #FULLHELP axis. The default of NO will enable it. ENDPARAMETER PARAMETER ABORT_CHOP_NS TYPE '_LOGICAL' VPATH 'INTERNAL' HELP 'Chop North-South axis abort state: YES = abort, NO = enable.' DEFAULT NO #FULLHELP This parameter is used to enable or disable the North-South chopper #FULLHELP axis. The default of NO will enable it. ENDPARAMETER PARAMETER ABORTCHOP_WAIT TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 2.0 HELP 'Delay [sec] between enabling chop axes and applying position offsets' ENDPARAMETER PARAMETER APPLY_TEMP_CORR TYPE '_LOGICAL' VPATH 'INTERNAL' HELP 'If true then apply temperature corrections to the Z focus' DEFAULT TRUE #FULLHELP If this parameter is set to FALSE then temperature corrections are #FULLHELP not applied to the Z focus position. This allows temperature #FULLHELP tracking to be turned off independent of tables tracking ENDPARAMETER PARAMETER AZ_RESPONSE TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 1.0 HELP 'AZ_Chopper static/dynamic response coefficient.' #FULLHELP Never measured - value assumed. ENDPARAMETER PARAMETER BEAM TYPE 'LITERAL' VPATH 'INTERNAL' DEFAULT 'R' IN 'L','M','R','l','m','r' HELP 'Beam for offsetting the telescope.' #FULLHELP Note that quite by accident when the source is in the RIGHT beam #FULLHELP the chart recorder pen moves to the right and that when the #FULLHELP source is in the LEFT beam the pen moves to the left. ENDPARAMETER PARAMETER BLANK_TIME TYPE '_INTEGER' VPATH 'INTERNAL' HELP 'Chopper blanking time in millisecs.' DEFAULT 0 RANGE 0, 10000 ENDPARAMETER PARAMETER BUS_1 TYPE '_INTEGER' VPATH 'INTERNAL' HELP 'IEEE bus number to which XYZ device is attached.' DEFAULT 4 RANGE 1, 4 ENDPARAMETER PARAMETER BUS_2 TYPE '_INTEGER' VPATH 'INTERNAL' HELP 'IEEE bus number to which CHOPPER device is attached.' DEFAULT 4 RANGE 1, 4 ENDPARAMETER PARAMETER CHOP_INTERVAL TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 1 HELP 'SM Chopper update interval [seconds].' #FULLHELP When performing chopper tracking the update check #FULLHELP is performed every CHOP_INTERVAL seconds. ENDPARAMETER PARAMETER CHOP_MONITOR TYPE '_LOGICAL' VPATH 'INTERNAL' DEFAULT NO HELP 'SM Chopper monitoring flag.' #FULLHELP The monitor_chopper action will set this flag true (YES). #FULLHELP Canceling the monitor_chopper action will set it to false (NO). #FULLHELP A procedure can check this flag before starting a #FULLHELP monitor_chopper action. ENDPARAMETER PARAMETER CHOP_THRESHOLD TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 1.0 HELP 'Threshold for following the rotation of the field [arcsec].' #FULLHELP When a chop update is requested the demand chopper #FULLHELP NSAMP and EWAMP are computed for that epoch and compared #FULLHELP with the actual values in use. If the net difference #FULLHELP in the positions of the tips of the demand and actual #FULLHELP chop vectors is more than CHOP_THRESHOLD, an update #FULLHELP is performed. ENDPARAMETER PARAMETER CHOP_TRACKING TYPE '_INTEGER' VPATH 'INTERNAL' DEFAULT 0 HELP '0=Not chop_tracking, 1=chop_tracking.' #FULLHELP This flag is checked before an OBEY CHOP_TRACK command is issued #FULLHELP to check whether a CANCEL is needed. ENDPARAMETER PARAMETER COORDS TYPE 'LITERAL' VPATH 'INTERNAL' DEFAULT 'AZ' IN 'EN', 'AZ', 'LO','NA','NL','NR', 'en', 'az', 'lo', 'na','nl','nr' HELP 'Coordinate system for chopping.' #FULLHELP EN coordinates are the actual X and Y axes of the secondary mirror. #FULLHELP AZ coordinates are the horizon az/alt. #FULLHELP LO is the local coordinate system, so when you want to chop in #FULLHELP NA is the Nasmyth coordinate system used by SCUBA #FULLHELP 1950 RA and DEC then set the local coordinate system via the #FULLHELP CELL/LOCAL command to RB and set the chop coordinate system to LO #FULLHELP in the CHOP command. #FULLHELP This also means that if you subsequently change your local #FULLHELP coordinate system to AZ then you will start chopping in AZ. #FULLHELP NL, NR are Nasmyth left and right. NA is currently a synonym for NL #FULLHELP as this is where SCUBA and UKT14 are located. The NR code has not #FULLHELP been verified. ENDPARAMETER PARAMETER DX TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.0 HELP 'X table user offset [mm].' #FULLHELP This is a user specified offset and is added to all #FULLHELP X table demand positions. If a user specifies a value #FULLHELP it will be applied for the rest of the task run. ENDPARAMETER PARAMETER DY TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.0 HELP 'Y table user offset [mm].' #FULLHELP This is a user specified offset and is added to all #FULLHELP Y table demand positions. If a user specifies a value #FULLHELP it will be applied for the rest of the task run. ENDPARAMETER PARAMETER DZ TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.0 HELP 'Z table user offset [mm].' #FULLHELP This is a user specified offset and is added to all #FULLHELP Z table demand positions. If a user specifies a value #FULLHELP it will be applied for the rest of the task run. ENDPARAMETER PARAMETER DZT_COEFF TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.070 # DEFAULT 0.021 changed 16 Oct 2003 (fjo) # DEFAULT 0.058 changed 10 Sep 2003 (imc) # DEFAULT 0.069 changed 31 Oct 2002 (imc) # DEFAULT 0.058 changed 13 Aug 2001 (imc) # DEFAULT 0.058 changed 13 Aug 2001 (imc) # DEFAULT 0.071 changed 17 Jul 1996 (FJO) HELP 'Z linear temperature correction coefficient [mm/K].' #FULLHELP Temperature correction to the Z focus offset #FULLHELP is determined by the relation: #FULLHELP DZT = DZT_CONST + ( DZT_COEFF * MEAN_TEMPERATURE ) #FULLHELP The mean temperature is now (20031016) antenna mean leg temperature ENDPARAMETER PARAMETER DZT_CONST TYPE '_REAL' VPATH 'INTERNAL' DEFAULT -0.24 # DEFAULT 0.0 changed 17 July 1996 (FJO) HELP 'Z linear temperature correction constant term [mm].' #FULLHELP Temperature correction to the Z focus offset #FULLHELP is determined by the relation: #FULLHELP DZT = DZT_CONST + ( DZT_COEFF * MEAN_TEMPERATURE ) #FULLHELP The mean temperature is obtained from averaging the #FULLHELP temperatures from the front and back A-frame legs. ENDPARAMETER PARAMETER EL_RESPONSE TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 1.0 HELP 'EL_Chopper static/dynamic response coefficient.' #FULLHELP Never measured - value assumed. ENDPARAMETER PARAMETER ELEVATION_DEG TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 45.0 HELP 'Elevation [degrees].' #FULLHELP The elevation value used for setting the XYZ position from #FULLHELP the focus curves when updating during a slew to a new #FULLHELP centre. ENDPARAMETER PARAMETER ENABLE_TABLESW TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 1 HELP 'Time interval between checking tables have initialised [sec].' #FULLHELP Polling interval for ENABLE_TABLES completion. ENDPARAMETER PARAMETER EW_AMPL_SCALE TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 1.0E-02 HELP 'AZ chopper amplitude scale factor [arcsec per encoder unit].' #FULLHELP The East-West amplitude is divided by the scale factor #FULLHELP to convert it from arc seconds to encoder units. #FULLHELP This number is calculated from EW_AMPL_SLOPE and EW_AMPL_CORR #FULLHELP and should not be set manually ENDPARAMETER PARAMETER EW_AMPL_SLOPE TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 1.3413E-02 # DEFAULT 1.3476E-02 Changed from this 9th March 1995 (JCMT::RMP) # DEFAULT 1.334E-02 Changed from this 9th March 1995 (JCMT::RMP) # DEFAULT 1.342E-02 Changed from this 01-Oct-1994 (JCMT::RMP) # DEFAULT 1.07368E-02 Changed 30-Sep-1994 HELP 'AZ chopper amplitude slope factor [arcsec per encoder unit].' #FULLHELP The East-West amplitude scale is given by this slope, #FULLHELP corrected by EW_AMPL_CORR ENDPARAMETER PARAMETER EW_AMPL_CORR TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 9.81E-03 # DEFAULT 1.64E-02 Changed from this 9th March 1995 HELP 'Correction factor to apply to EW amplitude' #FULLHELP The East-West amplitude scale is given by EW_AMPL_SLOPE, #FULLHELP crrected by this factor ENDPARAMETER PARAMETER EW_PHASE_SCALE TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.087890625 HELP 'East/West chop phase scale factor [degree per firmware unit].' #FULLHELP The East/West phase is divided by the scale factor. Thus #FULLHELP to increase the phase, reduce the scale factor, and vice versa. ENDPARAMETER PARAMETER EWAMP # East-West amplitude TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 60.0 HELP 'East-west chop amplitude in SM units [arcsec].' #FULLHELP `The total primary offset due to the chopper position is:` #FULLHELP `CHOP_DAZ = EWOFF + BEAM_SIGN * AZ_RESPONSE * EWAMP` #FULLHELP `BEAM_SIGN = 1 for Left, 0 for Middle, -1 for Right` ENDPARAMETER PARAMETER EWOFF # East-West offset TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.0 # DEFAULT 37.9 changed 20040107 fjo # DEFAULT 0 changed 20031208 imc HELP 'East-west offset or tilt [arcsec].' #FULLHELP `The total primary offset due to the chopper position is:` #FULLHELP `CHOP_DAZ = EWOFF + BEAM_SIGN * AZ_RESPONSE * EWAMP` #FULLHELP `BEAM_SIGN = 1 for Left, 0 for Middle, -1 for Right` ENDPARAMETER PARAMETER EWPHASE # East-West phase TYPE '_INTEGER' VPATH 'INTERNAL' DEFAULT 0 HELP 'East-west phase [degree].' ENDPARAMETER PARAMETER FE_TASK TYPE 'LITERAL' VPATH 'INTERNAL' DEFAULT 'DISABLE' HELP 'Frontend task name.' #FULLHELP The frontend task name is required to get the value #FULLHELP of the rest frequency of observation needed for gain #FULLHELP calculations. It is also used to determine whether #FULLHELP a lockin delay is required after starting the chopper. #FULLHELP Currently UKT14 requires a delay of 15s to lock to #FULLHELP chopper signal. ENDPARAMETER PARAMETER FREQ_LIMIT TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 4.0 HELP 'Cutoff frequency for chopper scale determination [arcsec].' #FULLHELP Cut-off frequency below which corrections to EW_AMPL_SCALE #FULLHELP will not be done ENDPARAMETER PARAMETER FREQUENCY TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 7.8125 RANGE 0.0,1024.0 HELP 'Chopper frequency [Hz].' #FULLHELP Frequency of the chopper waveform. Reciprocal of PERIOD*1000. #FULLHELP Must lie in the range 0 to 1024 Hz ENDPARAMETER PARAMETER FTS_X_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.0 HELP 'X focus offset of FTS from nominal position' #FULLHELP The X offset in millimetres between the nominal tables position #FULLHELP and the best position for FTS ENDPARAMETER PARAMETER FTS_Y_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.0 HELP 'Y focus offset of FTS from nominal position' #FULLHELP The Y offset in millimetres between the nominal tables position #FULLHELP and the best position for FTS ENDPARAMETER PARAMETER FTS_Z_OFFSET TYPE '_REAL' VPATH 'INTERNAL' # DEFAULT -0.21 changed 14-Dec-2001 (fjo) DEFAULT 0.0 HELP 'Z focus offset of FTS from nominal position' #FULLHELP The Z offset in millimetres between the nominal tables position #FULLHELP and the best position for FTS ENDPARAMETER PARAMETER FTS_1_X_OFFSET TYPE '_REAL' VPATH 'INTERNAL' # DEFAULT 0.17 changed 14-Dec-2001 (fjo) DEFAULT -0.6 HELP 'X focus offset of FTS_1 (port 1) from nominal position' #FULLHELP The X offset in millimetres between the nominal tables position #FULLHELP and the best position for FTS_1 (port 1) ENDPARAMETER PARAMETER FTS_1_Y_OFFSET TYPE '_REAL' VPATH 'INTERNAL' # DEFAULT -0.08 changed 14-Dec-2001 DEFAULT -0.61 HELP 'Y focus offset of FTS_1 (port 1) from nominal position' #FULLHELP The Y offset in millimetres between the nominal tables position #FULLHELP and the best position for FTS_1 (port 1) ENDPARAMETER PARAMETER FTS_1_Z_OFFSET TYPE '_REAL' VPATH 'INTERNAL' # DEFAULT -3.78 changed 14-Dec-2001 DEFAULT -3.68 HELP 'Z focus offset of FTS_1 (port 1) from nominal position' #FULLHELP The Z offset in millimetres between the nominal tables position #FULLHELP and the best position for FTS_1 (port 1) ENDPARAMETER PARAMETER FTS_2_X_OFFSET TYPE '_REAL' VPATH 'INTERNAL' # DEFAULT 0.02 changed 14-Dec-2001 DEFAULT 0.0 HELP 'X focus offset of FTS_2 (port 2) from nominal position' #FULLHELP The X offset in millimetres between the nominal tables position #FULLHELP and the best position for FTS_2 (port 2) ENDPARAMETER PARAMETER FTS_2_Y_OFFSET TYPE '_REAL' VPATH 'INTERNAL' # DEFAULT -0.78 changed 14-Dec-2001 DEFAULT 0.0 HELP 'Y focus offset of FTS_2 (port 2) from nominal position' #FULLHELP The Y offset in millimetres between the nominal tables position #FULLHELP and the best position for FTS_2 (port 2) ENDPARAMETER PARAMETER FTS_2_Z_OFFSET TYPE '_REAL' VPATH 'INTERNAL' # DEFAULT -3.76 changed 14-Dec-2001 DEFAULT 0.0 HELP 'Z focus offset of FTS_2 (port 2) from nominal position' #FULLHELP The Z offset in millimetres between the nominal tables position #FULLHELP and the best position for FTS_2 (port 2) ENDPARAMETER PARAMETER GO_EW TYPE '_LOGICAL' VPATH 'INTERNAL' DEFAULT NO HELP 'YES if want to chop East-West, NO otherwise.' #FULLHELP There is a corresponding flag in the chopper controller system. #FULLHELP When the EW amplitude is non-zero, setting this flag to TRUE #FULLHELP will start the chopper vibrating. However, if the EW amplitude #FULLHELP is zero, the chopper will not vibrate even if GO_EW is TRUE. ENDPARAMETER PARAMETER GO_NS TYPE '_LOGICAL' VPATH 'INTERNAL' DEFAULT NO HELP 'YES if want to chop North-South NO otherwise.' #FULLHELP There is a corresponding flag in the chopper controller system. #FULLHELP When the NS amplitude is non-zero, setting this flag to TRUE #FULLHELP will start the chopper vibrating. However, if the NS amplitude #FULLHELP is zero, the chopper will not vibrate even if GO_NS is TRUE. ENDPARAMETER PARAMETER IEEE_CONNECT TYPE '_LOGICAL' VPATH 'INTERNAL' HELP 'YES if want to use IEEE to connect to the Chopper, NO if not.' DEFAULT YES ENDPARAMETER PARAMETER IEEE_CONNECT_1 TYPE '_LOGICAL' VPATH 'INTERNAL' HELP 'YES if want to use IEEE to connect to the Tables, NO if not.' DEFAULT YES ENDPARAMETER PARAMETER INTERRUPT_CHOP TYPE '_LOGICAL' VPATH 'INTERNAL' DEFAULT NO HELP 'Stop chop while moving tables?' #FULLHELP With the new SMU XYZ control hardware it is NOT necessary #FULLHELP to stop the chopper when moving the tables, as it was with #FULLHELP the old. ENDPARAMETER PARAMETER JIGGLE_COORDS TYPE 'LITERAL' VPATH 'INTERNAL' DEFAULT 'AZ' IN 'EN', 'AZ', 'LO','NA','NL','NR', 'en', 'az', 'lo', 'na','nl','nr' HELP 'Coordinate system for jiggling.' #FULLHELP This parameter specifies the co-ordinate system in which to jiggle. #FULLHELP It is related to the chop coordinate frame in that not all possible #FULLHELP combinations of chop and jiggle coords are allowed. The current #FULLHELP combinations are EN/EN, AZ/AZ, AZ/LO, NA/NA and LO/LO where #FULLHELP the first code refers to the chop and the second to the jiggle ENDPARAMETER PARAMETER JIGGLE_DWELL TYPE '_INTEGER' VPATH 'INTERNAL' DEFAULT 1 HELP 'The time in unit of chop period, to dwell at a jiggle point.' ENDPARAMETER PARAMETER JIGGLE_END TYPE '_INTEGER' VPATH 'INTERNAL' DEFAULT 1 HELP 'Index of the last jiggle offset value to be loaded.' #FULLHELP Once a jiggle pattern has been read into the SMU d-task with the #FULLHELP jiggle_read command, the user has the option of only loading a part #FULLHELP of it into the SMU controller. Jiggle_end specifies the end #FULLHELP index of the full pattern that is to be loaded. ENDPARAMETER PARAMETER JIGGLE_FILE TYPE 'LITERAL' VPATH 'INTERNAL' HELP 'Jiggle file name.' #FULLHELP The name of the current Jiggle pattern file which is stored #FULLFELP in MT_SMUDIR. The default file extension is .DATA if no extension #FULLHELP is given. The file consists of pairs of x,y jiggle pattern offsets #FULLHELP with one pair on each line. Units are arcsec. ENDPARAMETER PARAMETER JIGGLE_MAX TYPE '_INTEGER' VPATH 'INTERNAL' DEFAULT 1 HELP 'Maximum number of jiggle points in the current pattern' #FULLHELP This parameter is set to the maximum number of points in the #FULLHELP currently loaded jiggle pattern. It is set by the jiggle_read action #FULLHELP and should not be modified. It provides an upper bound on the user #FULLHELP specified parameter jiggle_end ENDPARAMETER PARAMETER JIGGLE_SCALE TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 1.0 HELP 'Scaling factor for the currently loaded jiggle pattern' #FULLHELP This parameter provides a simple way of modifying a jiggle pattern #FULLHELP that has been read in to the d-task. E.g. if a pattern with a #FULLHELP separation of say 2 arcsec has been loaded then to observe the same #FULLHELP pattern with a separation of 4 arcsec simply set jiggle_scale to 2.0 ENDPARAMETER PARAMETER JIGGLE_START TYPE '_INTEGER' VPATH 'INTERNAL' DEFAULT 1 HELP 'Index of the first jiggle offset value to be loaded.' #FULLHELP Once a jiggle pattern has been read into the SMU d-task with the #FULLHELP jiggle_read command, the user has the option of only loading a part #FULLHELP of it into the SMU controller. Jiggle_start specifies the starting #FULLHELP index of the full pattern that is to be loaded. ENDPARAMETER PARAMETER JIGGLE_THROW TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 60.0 HELP 'Hypothetical chop throw used with CHOP_THRESHOLD for updates' #FULLHELP It is possible to jiggle with zero (or small) chop throw. #FULLHELP The code which performs updates for field rotation for the #FULLHELP jiggle pattern used to assume that the normal chop throw #FULLHELP could be used for the test, but now if the throw is less #FULLHELP than JIGGLE_THROW, this is used instead ENDPARAMETER PARAMETER LOCKIN_DELAY TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 15 HELP 'Time for the FE_TASK to achieve lockin [sec].' #FULLHELP Delay between successful completion of START_CHOPPER #FULLHELP and notifying ready for integration (actual return #FULLHELP from START_CHOPPER). #FULLHELP Only applied if the FE_TASK is UKT14. ENDPARAMETER PARAMETER MAX_AMPL TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 24000 # DEFAULT 19712 Changed 29-Sep-1994 during Hvy Engr (FJO) HELP 'Maximum amplitude of the chop [encoder units].' ENDPARAMETER PARAMETER MAX_OFFS TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 24000 # DEFAULT 19712 Changed 29-Sep-1994 during Hvy Engr (FJO) HELP 'Maximum offset of the chop [encoder units].' ENDPARAMETER PARAMETER MAX_PHASE TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 4096 HELP 'Maximum phase (360 deg) of the chop function [firmware unit].' ENDPARAMETER PARAMETER MAX_SET_CHOPPER TYPE '_INTEGER' VPATH 'INTERNAL' DEFAULT 2 HELP 'Maximum number of tries to set the chopper parameters.' ENDPARAMETER PARAMETER MODE TYPE '_INTEGER' VPATH 'INTERNAL' DEFAULT 0 RANGE 0, 3 HELP 'Chopping mode specifing internal/external reference and sync.' #FULLHELP This parameter and the associated action (CHOP_MODE) replaces #FULLHELP the external reference and external sync actions. It is more #FULLHELP versatile by allowing more combinations of features to be #FULLHELP controlled by an external device (e.g. receiver). #FULLHELP `Current values and functions for the MODE parameter follows:` #FULLHELP ` ` #FULLHELP ` MODE = 0 : controller generates internal ref and sync signals` #FULLHELP ` MODE = 1 : external sync, edge trigger, internal ref` #FULLHELP ` MODE = 2 : external sync, level trigger, internal ref` #FULLHELP ` MODE = 3 : external reference signal` ENDPARAMETER PARAMETER MO_TASK TYPE 'LITERAL' VPATH 'INTERNAL' DEFAULT 'DISABLE' HELP 'Monitor task name' #FULLHELP The monitor task provides the parameters TMP_FRONT and TMP_BACK #FULLHELP which are used to correct the Z focus offset. ENDPARAMETER PARAMETER MPI_X_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT -0.28 # DEFAULT 0.0 changed 20020417 imc HELP 'X focus offset of MPI from nominal position' #FULLHELP The X offset in millimetres between the nominal tables position #FULLHELP and the best position for MPI ENDPARAMETER PARAMETER MPI_Y_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT -0.24 # DEFAULT 0.0 chnaged 20020417 imc HELP 'Y focus offset of MPI from nominal position' #FULLHELP The Y offset in millimetres between the nominal tables position #FULLHELP and the best position for MPI ENDPARAMETER PARAMETER MPI_Z_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT -1.64 # DEFAULT 0.0 changed 20020417 imc HELP 'Z focus offset of MPI from nominal position' #FULLHELP The Z offset in millimetres between the nominal tables position #FULLHELP and the best position for MPI ENDPARAMETER PARAMETER NO_DEVICES TYPE '_INTEGER' VPATH 'INTERNAL' HELP ' Number of IEEE devices.' DEFAULT 2 RANGE 0, 9 ENDPARAMETER PARAMETER NOD_WAIT TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.0 HELP 'User delay for the telescope to nod [seconds].' #FULLHELP Normally zero, can be used to debug timing problems' #FULLHELP The nod is commanded and then the SMU waits for #FULLHELP the TEL_CYCLE task to notify that the telescope is #FULLHELP on source. Then the SMU waits for NOD_WAIT seconds. ENDPARAMETER PARAMETER NS_AMPL_SCALE TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 1.0E-02 HELP 'EL chopper amplitude scale factor [arcsec per encoder unit].' #FULLHELP The North-South amplitude is divided by the scale factor #FULLHELP to convert it from arc seconds to encoder units. #FULLHELP This number is calculated from NS_AMPL_SLOPE and NS_AMPL_CORR #FULLHELP and should not be set manually ENDPARAMETER PARAMETER NS_AMPL_SLOPE TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 1.3138E-02 # DEFAULT 1.30727E-02 Changed from this 9th March 1995 # DEFAULT 1.297E-02 Changed from this 02-Oct-1994 # DEFAULT 1.0376E-02 Changed 30-Sep-1994 HELP 'EL chopper amplitude slope factor [arcsec per encoder unit].' #FULLHELP The North-South amplitude scale is given by this slope, #FULLHELP corrected by NS_AMPL_CORR ENDPARAMETER PARAMETER NS_AMPL_CORR TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 1.36E-03 # DEFAULT 9.08E-03 Changed from this 9th March 1995 HELP 'Correction factor to apply to NS amplitude' #FULLHELP The North-South amplitude scale is given by NS_AMPL_SLOPE, #FULLHELP crrected by this factor ENDPARAMETER PARAMETER NS_PHASE_SCALE TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.087890625 HELP 'North/South chop phase scale factor [deg per firmware unit].' #FULLHELP The North/South phase is divided by the scale factor. Thus #FULLHELP to increase the phase, reduce the scale factor, and vice versa. ENDPARAMETER PARAMETER NSAMP # North-South amplitude TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 60.0 HELP 'North-South amplitude in SM units [arcsec].' #FULLHELP `The total primary offset due to the chopper position is:` #FULLHELP `CHOP_DEL = NSOFF + BEAM_SIGN * EL_RESPONSE * NSAMP` #FULLHELP `BEAM_SIGN = 1 for Left, 0 for Middle, -1 for Right` ENDPARAMETER PARAMETER NSOFF # North-south offset TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.0 # DEFAULT 39.3 changed 20040107 fjo # DEFAULT 0 changed 20031208 imc HELP 'North-south offset or tilt [arcsec].' #FULLHELP `The total primary offset due to the chopper position is:` #FULLHELP `CHOP_DEL = NSOFF + BEAM_SIGN * EL_RESPONSE * NSAMP` #FULLHELP `BEAM_SIGN = 1 for Left, 0 for Middle, -1 for Right` ENDPARAMETER PARAMETER NSPHASE # East-West phase TYPE '_INTEGER' VPATH 'INTERNAL' DEFAULT 0 HELP 'North-south phase [degree].' ENDPARAMETER PARAMETER OUTPUT_WAVE_EW # Output wave signal from chopper TYPE 'LITERAL' VPATH 'INTERNAL' IN 'REF', 'POS', 'ERR', 'COP', 'EST', 'BLK' DEFAULT 'POS' HELP 'East/West output waveform signal from the chopper.' #FULLHELP Chopper Controller Output Waveform Signals #FULLHELP REF - Reference #FULLHELP POS - Position (LVDT) #FULLHELP ERR - Position Error #FULLHELP COP - Controller Output #FULLHELP EST - Estimator Error #FULLHELP BLK - 10 x Blanked RMS Error ENDPARAMETER PARAMETER OUTPUT_WAVE_NS # Output wave signal from chopper TYPE 'LITERAL' VPATH 'INTERNAL' IN 'REF', 'POS', 'ERR', 'COP', 'EST', 'BLK' DEFAULT 'POS' HELP 'North/South output waveform signal from the chopper.' #FULLHELP Chopper Controller Output Waveform Signals #FULLHELP REF - Reference #FULLHELP POS - Position (LVDT) #FULLHELP ERR - Position Error #FULLHELP COP - Controller Output #FULLHELP EST - Estimator Error #FULLHELP BLK - 10 x Blanked RMS Error ENDPARAMETER PARAMETER PERIOD # Period of the waveform TYPE '_INTEGER' VPATH 'INTERNAL' DEFAULT 128 RANGE 1, 10000 HELP 'Period of the waveform [milliseconds].' #FULLHELP With the old chopper controller, this was modulo 4 value. #FULLHELP The new controller resolves it to whole milliseconds. #FULLHELP The SM software truncates any fractional period. #FULLHELP Also, with the new controller, the long period went from #FULLHELP 1000 ms to 10000 ms while the short period went #FULLHELP from 64 ms to 1 ms. ENDPARAMETER PARAMETER POSANG TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 90.0 RANGE -360.,360. HELP 'Position angle of the chopper throw vector [degrees].' #FULLHELP POSANG = 0 chops in latitude, POSANG=90 chops in longitude. #FULLHELP The range is now set to -360 thru 360 degrees ENDPARAMETER PARAMETER POSOFF_EW TYPE '_INTEGER' VPATH 'INTERNAL' # -45" / .01334 enc/" = -3373 enc DEFAULT -2825 # DEFAULT 0 changed 20040107 fjo RANGE -7000,7000 HELP 'Chopper Position Offset to the E/W axis [encoder unit]' #FULLHELP A fixed "tilt" value for the SM E/W axis. ENDPARAMETER PARAMETER POSOFF_NS TYPE '_INTEGER' VPATH 'INTERNAL' # +70" / .01307 enc/" = +5356 enc DEFAULT -2991 # DEFAULT 0 changed 20040107 fjo RANGE -7000,7000 HELP 'Chopper Position Offset to the N/S axis [encoder unit]' #FULLHELP A fixed "tilt" value for the SM N/S axis. ENDPARAMETER PARAMETER PRIMARY_1 TYPE '_INTEGER' VPATH 'INTERNAL' HELP 'IEEE primary device address of XYZ microprocessor.' DEFAULT 16 ENDPARAMETER PARAMETER PRIMARY_2 TYPE '_INTEGER' VPATH 'INTERNAL' HELP 'IEEE primary device address of CHOPPER microprocessor.' DEFAULT 15 ENDPARAMETER PARAMETER PRINT_ERRORS TYPE '_LOGICAL' VPATH 'INTERNAL' HELP 'If this is set, Micro checksum info will be written to file' DEFAULT NO ENDPARAMETER PARAMETER RX TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.0 HELP 'X focus offset of the current frontend from the nominal position' #FULLHELP The X offset in millimetres between the nominal tables position #FULLHELP and the best position for the receiver. ENDPARAMETER PARAMETER RXW_C_X_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.74 # DEFAULT 0.04 changed 20021031 imc # DEFAULT -0.56 changed 20020321 imc # DEFAULT -0.1 changed 20011113 imc # DEFAULT 2.7 changed 20010731 imc #fake data borrowed from old RXA # DEFAULT 0.0 # June 15 1999 Mary Fuka - email from Iain Coulson # DEFAULT 1.34 changed 08-Jan-2001 imc # DEFAULT 2.1 changed 07-Sep-2000 FJO HELP 'X focus offset of RXW_C from nominal position' #FULLHELP The X offset in millimetres between the nominal tables position #FULLHELP and the best position for RXW_C ENDPARAMETER PARAMETER RXW_C_Y_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT -0.44 # DEFAULT 0.16 changed 20021031 imc # DEFAULT -0.74 changed 20020321 imc # DEFAULT -0.63 changed 20011113 imc # DEFAULT -0.43 changed 20010731 imc #fake data borrowed from old RXA # DEFAULT 0.0 # June 15 1999 Mary Fuka - email from Iain Coulson # DEFAULT -1.93 changed 08-Jan-2001 imc # DEFAULT -2.55 changed 07-Sep-2000 FJO HELP 'Y focus offset of RXW_C from nominal position' #FULLHELP The Y offset in millimetres between the nominal tables position #FULLHELP and the best position for RXW_C ENDPARAMETER PARAMETER RXW_C_Z_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT -1.00 # DEFAULT -0.51 changed 20021031 imc # DEFAULT -0.58 changed 20020321 imc # DEFAULT -0.44 changed 20011113 imc # DEFAULT -0.94 changed 20010731 imc #fake data borrowed from old RXA # DEFAULT 0.0 # June 15 1999 Mary Fuka - email from Iain Coulson # DEFAULT -1.42 changed 07-Sep-2000 FJO HELP 'Z focus offset of RXW_C from nominal position' #FULLHELP The Z offset in millimetres between the nominal tables position #FULLHELP and the best position for RXW_C ENDPARAMETER PARAMETER RXW_D_X_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.18 # DEFAULT -0.42 changed 20020321 imc # DEFAULT -3.05 changed 20011113 imc # DEFAULT -0.25 changed 20010731 imc #fake data borrowed from old RXA # DEFAULT 1.4 changed 10-Jan-2001 imc # DEFAULT 0.03 changed 08-Jan-2001 imc # DEFAULT 0.5 changed 07-Sep-2000 FJO HELP 'X focus offset of RXW_D from nominal position' #FULLHELP The X offset in millimetres between the nominal tables position #FULLHELP and the best position for RXW_D ENDPARAMETER PARAMETER RXW_D_Y_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.14 # DEFAULT -0.76 changed 20020321 imc # DEFAULT -0.96 changed 20011113 imc # DEFAULT -0.76 changed 20010731 imc #fake data borrowed from old RXA # DEFAULT 0.9 changed 10-Jan-2001 imc # DEFAULT -0.63 changed 08-Jan-2001 imc # DEFAULT -0.1 changed 07-Sep-2000 HELP 'Y focus offset of RXW_D from nominal position' #FULLHELP The Y offset in millimetres between the nominal tables position #FULLHELP and the best position for RXW_D ENDPARAMETER PARAMETER RXW_D_Z_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT -0.77 # DEFAULT -0.84 changed 20020321 imc # DEFAULT -0.38 changed 20011113 imc # DEFAULT -0.88 changed 20010731 imc #fake data borrowed from old RXA # DEFAULT -0.66 changed 10-Jan-2001 imc # DEFAULT -1.0 changed 07-Sep-2000 HELP 'Z focus offset of RXW_D from nominal position' #FULLHELP The Z offset in millimetres between the nominal tables position #FULLHELP and the best position for RXW_D ENDPARAMETER PARAMETER RXA2_X_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT -0.07 # DEFAULT -0.06 changed 4-Feb-1997 RMP # DEFAULT -0.11 changed 12-oct-1993 RMP HELP 'X focus offset of RXA2 from nominal position' #FULLHELP The X offset in millimetres between the nominal tables position #FULLHELP and the best position for RXA2 ENDPARAMETER PARAMETER RXA2_Y_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT -0.52 # DEFAULT -0.04 changed 4-Feb-1997 RMP # DEFAULT -0.39 changed 12-oct-1993 HELP 'Y focus offset of RXA2 from nominal position' #FULLHELP The Y offset in millimetres between the nominal tables position #FULLHELP and the best position for RXA2 ENDPARAMETER PARAMETER RXA2_Z_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT -0.67 # DEFAULT -0.35 changed 4-Feb-1997 # DEFAULT -0.86 changed 12-oct-1993 RMP HELP 'Z focus offset of RXA2 from nominal position' #FULLHELP The Z offset in millimetres between the nominal tables position #FULLHELP and the best position for RXA2 ENDPARAMETER PARAMETER RXA3I_X_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.33 # DEFAULT 0.21 changed 20021031 imc # DEFAULT -0.52 changed 20020321 imc # DEFAULT 0.09 chnaged 20011113 imc # DEFAULT 0.28 changed 07-Sep-2000 FJO HELP 'X focus offset of RXA2 from nominal position' #FULLHELP The X offset in millimetres between the nominal tables position #FULLHELP and the best position for RXA2 ENDPARAMETER PARAMETER RXA3I_Y_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT -0.09 # DEFAULT -0.26 changed 20031217 imc # DEFAULT -0.20 changed 20021031 imc # DEFAULT -0.59 changed 20020321 imc # DEFAULT -0.72 chnaged 20011113 imc # DEFAULT -0.25 changed 07-Sep-2000 FJO HELP 'Y focus offset of RXA2 from nominal position' #FULLHELP The Y offset in millimetres between the nominal tables position #FULLHELP and the best position for RXA2 ENDPARAMETER PARAMETER RXA3I_Z_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT -1.09 # DEFAULT -1.01 changed 20031217 imc # DEFAULT -0.88 changed 20021031 imc # DEFAULT -1.02 changed 20020321 imc # DEFAULT -1.00 chnaged 20011113 imc # DEFAULT -0.88 changed 07-Sep-2000 FJO HELP 'Z focus offset of RXA2 from nominal position' #FULLHELP The Z offset in millimetres between the nominal tables position #FULLHELP and the best position for RXA2 ENDPARAMETER PARAMETER RXB3_X_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.34 # DEFAULT -0.06 changed 20020321 imc # DEFAULT -0.32 changed 20011113 imc # DEFAULT -0.02 changed 20010731 imc # DEFAULT -0.11 changed 12-oct-1993 RMP HELP 'X focus offset of RXB3 from nominal position #FULLHELP The X offset in millimetres between the nominal tables position #FULLHELP and the best position for RXB3 ENDPARAMETER PARAMETER RXB3_Y_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 1.54 # DEFAULT 0.56 changed 20020321 imc # DEFAULT 0.18 changed 20011113 imc # DEFAULT -0.22 changed 20010731 imc # DEFAULT -0.39 changed 12-oct-1993 RMP HELP 'Y focus offset of RXB3 from nominal position' #FULLHELP The Y offset in millimetres between the nominal tables position #FULLHELP and the best position for RXB3 ENDPARAMETER PARAMETER RXB3_Z_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.34 # DEFAULT 0.41 changed 20031217 imc # DEFAULT 0.41 (un)changed 20020321 imc # DEFAULT 0.15 changed 20011113 imc # DEFAULT -0.25 changed 20010731 imc # DEFAULT -0.58 changed 12-oct-1993 HELP 'Z focus offset of RXB3 from nominal position' #FULLHELP The Z offset in millimetres between the nominal tables position #FULLHELP and the best position for RXB3 ENDPARAMETER PARAMETER RXB_X_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.16 # DEFAULT 0.06 changed 20021031 imc # DEFAULT -0.34 changed 20020321 imc # DEFAULT -0.14 changed 20011113 imc # DEFAULT -0.08 changed 10-Jan-2001 # DEFAULT -0.11 changed 4-Feb-1997 RMP HELP 'X focus offset of RXB from nominal position' #FULLHELP The X offset in millimetres between the nominal tables position #FULLHELP and the best position for RXB ENDPARAMETER PARAMETER RXB_Y_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT -0.12 # DEFAULT 0.15 changed 20021031 imc # DEFAULT -0.83 changed 20020321 imc # DEFAULT -1.21 changed 20011113 imc # DEFAULT -0.68 changed 10-Jan-2001 imc # DEFAULT -0.20 changed 07-Sep-2000 FJO # DEFAULT -0.70 changed 28-Jul-1999 MAF and IMC # DEFAULT -0.39 changed 4-Feb-1997 HELP 'Y focus offset of RXB from nominal position' #FULLHELP The Y offset in millimetres between the nominal tables position #FULLHELP and the best position for RXB ENDPARAMETER PARAMETER RXB_Z_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT -1.03 # DEFAULT -0.96 changed 20031217 imc # DEFAULT -0.91 changed 20021031 imc # DEFAULT -0.91 (un)changed 20020321 imc # DEFAULT -1.17 changed 20011113 imc # DEFAULT -0.94 changed 10-Jan-2001 imc # DEFAULT -1.0 changed 07-Sep-2000 FJO # DEFAULT -0.52 changed 28-Jul-1999 MAF and IMC # DEFAULT -0.92 changed 4-Feb-1997 RMP HELP 'Z focus offset of RXB from nominal position' #FULLHELP The Z offset in millimetres between the nominal tables position #FULLHELP and the best position for RXB ENDPARAMETER PARAMETER RXC2_X_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.41 # DEFAULT -0.08 changed 31-Dec-1997 fjo # DEFAULT 0.25 changed 12-oct-1993 HELP 'X focus offset of RXC2 from nominal position' #FULLHELP The X offset in millimetres between the nominal tables position #FULLHELP and the best position for RXC2 ENDPARAMETER PARAMETER RXC2_Y_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT -0.95 # DEFAULT -0.27 changed 31-Dec-1997 fjo # DEFAULT -0.43 changed 12-oct-1993 rmp HELP 'Y focus offset of RXC2 from nominal position' #FULLHELP The Y offset in millimetres between the nominal tables position #FULLHELP and the best position for RXC2 ENDPARAMETER PARAMETER RXC2_Z_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT -0.44 # DEFAULT +0.03 changed 31-Dec-1997 fjo # DEFAULT -0.64 changed 12-oct-1993 HELP 'Z focus offset of RXC2 from nominal position' #FULLHELP The Z offset in millimetres between the nominal tables position #FULLHELP and the best position for RXC2 ENDPARAMETER PARAMETER RXG_X_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.0 # DEFAULT -0.11 Changed 11-May-94 to agree with RXG run in March 94 HELP 'X focus offset of RXG from nominal position' #FULLHELP The X offset in millimetres between the nominal tables position #FULLHELP and the best position for RXG ENDPARAMETER PARAMETER RXG_Y_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.0 # DEFAULT -0.39 Changed 11-May-94 to agree with RXG run in March 94. HELP 'Y focus offset of RXG from nominal position' #FULLHELP The Y offset in millimetres between the nominal tables position #FULLHELP and the best position for RXG ENDPARAMETER PARAMETER RXG_Z_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT -0.21 # DEFAULT -.58 Changed 11-May-94 to agree with RXG run in March 94. HELP 'Z focus offset of RXG from nominal position' #FULLHELP The Z offset in millimetres between the nominal tables position #FULLHELP and the best position for RXG ENDPARAMETER PARAMETER RXH_X_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.0 HELP 'X focus offset of RXH from nominal position' #FULLHELP The X offset in millimetres between the nominal tables position #FULLHELP and the best position for RXH ENDPARAMETER PARAMETER RXH_Y_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.0 HELP 'Y focus offset of RXH from nominal position' #FULLHELP The Y offset in millimetres between the nominal tables position #FULLHELP and the best position for RXH ENDPARAMETER PARAMETER RXH_Z_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.0 HELP 'Z focus offset of RXH from nominal position' #FULLHELP The Z offset in millimetres between the nominal tables position #FULLHELP and the best position for RXH ENDPARAMETER PARAMETER SPIFI_NUREST TYPE '_REAL' VPATH 'INTERNAL' DEFAULT '345.0' HELP 'Rest frequency for SPIFI' #FULLHELP The rest frequency used to check for XYZ tables updates ENDPARAMETER PARAMETER SPIFI_X_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.0 HELP 'X focus offset of SPIFI from nominal position' #FULLHELP The X offset in millimetres between the nominal tables position #FULLHELP and the best position for SPIFI ENDPARAMETER PARAMETER SPIFI_Y_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.0 HELP 'Y focus offset of SPIFI from nominal position' #FULLHELP The Y offset in millimetres between the nominal tables position #FULLHELP and the best position for SPIFI ENDPARAMETER PARAMETER SPIFI_Z_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.0 HELP 'Z focus offset of SPIFI from nominal position' #FULLHELP The Z offset in millimetres between the nominal tables position #FULLHELP and the best position for SPIFI ENDPARAMETER PARAMETER SCUBA_CHP_CORR TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 1.00966 HELP 'Correction factor to the slope of the SCUBA chop scale relation' #FULLHELP This factor corrects the scale for the SCUBA chop throw #FULLHELP generated by the older method. The older method used the frequency #FULLHELP to determine the scale. In the new method, for 6.9444 Hz only, #FULLHELP the scale depends on the chop throw. ENDPARAMETER PARAMETER SCUBA_CHP_OFFS TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.75 HELP 'Zero point offset for SCUBA chop scale calibration.' #FULLHELP For the demand to measured throw linear relation, this is the zero #FULLHELP point offset. ENDPARAMETER PARAMETER SCUBA_NUREST TYPE '_REAL' VPATH 'INTERNAL' DEFAULT '230.0' HELP 'Rest frequency for SCUBA' #FULLHELP The rest frequency used to check for XYZ tables updates ENDPARAMETER PARAMETER SCUBA_X_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT -0.09 # DEFAULT -0.46 changed 20021031 imc # DEFAULT -1.08 changed 20020321 imc # DEFAULT -0.42 changed 20011113 imc # DEFAULT -0.82 changed 22-mar-2001 imc # DEFAULT -0.62 changed 20-Mar-2001 imc # DEFAULT -0.96 changed 10-Jan-2001 imc # DEFAULT -0.65 changed 07-Sep-2000 FJO # DEFAULT -0.75 changed from this 5-Jan-2000 FJO (IMC) # DEFAULT -0.45 changed from this 27-May-1998 RMP HELP 'X focus offset of SCUBA from nominal position' #FULLHELP The X offset in millimetres between the nominal tables position #FULLHELP and the best position for SCUBA ENDPARAMETER PARAMETER SCUBA_Y_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.00 # DEFAULT 0.15 changed 20031217 imc # DEFAULT 0.44 changed 20021031 imc # DEFAULT -1.03 changed 20020321 imc # DEFAULT -0.95 changed 20011113 imc # DEFAULT 0.00 changed 22-may-2001 imc # DEFAULT -0.51 changed 22-mar-2001 imc # DEFAULT -1.02 changed 20-Mar-2001 imc # DEFAULT -0.68 changed 10-Jan-2001 imc # DEFAULT -0.67 changed 07-Sep-2000 FJO # DEFAULT -0.42 changed from this 5-Jan2000 FJO # DEFAULT -0.12 changed from this 27-May-1998 RMP HELP 'Y focus offset of SCUBA from nominal position' #FULLHELP The Y offset in millimetres between the nominal tables position #FULLHELP and the best position for SCUBA ENDPARAMETER PARAMETER SCUBA_Z_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT -5.34 # DEFAULT -5.27 changed 20031217 imc # DEFAULT -5.05 changed 20021031 imc # DEFAULT -5.13 changed 20020321 imc # DEFAULT -4.89 changed 20011113 imc # DEFAULT -5.47 chnaged 22-mar-2001 imc # DEFAULT -5.18 changed 20-Mar-2001 imc # DEFAULT -4.80 changed 10-Jan-2001 imc # DEFAULT -5.4 changed 07-SEp-2000 FJO # DEFAULT -4.9 changed from this 5-Jan-2000 FJO # DEFAULT -4.6 changed from this 27-May-1998 RMP HELP 'Z focus offset of SCUBA from nominal position' #FULLHELP The Z offset in millimetres between the nominal tables position #FULLHELP and the best position for SCUBA ENDPARAMETER PARAMETER RY TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.0 HELP 'Y focus offset of the current frontend from the nominal position' #FULLHELP The Y offset in millimetres between the nominal tables position #FULLHELP and the best position for the receiver. ENDPARAMETER PARAMETER RZ TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.0 HELP 'Z focus offset of the current frontend from the nominal position' #FULLHELP The Z offset in millimetres between the nominal tables position #FULLHELP and the best position for the receiver. ENDPARAMETER PARAMETER UKT14_X_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0 # DEFAULT -0.11 set to zero RMP 12-Oct-1993 HELP 'X focus offset of UKT14 from nominal position' #FULLHELP The X offset in millimetres between the nominal tables position #FULLHELP and the best position for UKT14 ENDPARAMETER PARAMETER UKT14_Y_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0 # DEFAULT -0.39 set to zero RMP 12-Oct-1993 HELP 'Y focus offset of UKT14 from nominal position' #FULLHELP The Y offset in millimetres between the nominal tables position #FULLHELP and the best position for UKT14 ENDPARAMETER PARAMETER UKT14_Z_OFFSET TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0 # DEFAULT -0.48 set to zero 12-Oct-1993 HELP 'Z focus offset of UKT14 from nominal position' #FULLHELP The Z offset in millimetres between the nominal tables position #FULLHELP and the best position for UKT14 ENDPARAMETER PARAMETER SECONDARY_1 TYPE '_INTEGER' VPATH 'INTERNAL' HELP 'IEEE secondary device addr of XYZ micro; -1 = not used.' DEFAULT -1 ENDPARAMETER PARAMETER SECONDARY_2 TYPE '_INTEGER' VPATH 'INTERNAL' HELP 'IEEE secondary device addr of CHOPPER micro; -1 = not used.' DEFAULT -1 ENDPARAMETER PARAMETER SET_TABLESW TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 3 HELP 'Time interval between checking tables have set [sec].' #FULLHELP Polling interval for SET_TABLES, MOVE, TABLES_UPDATE #FULLHELP XYZ_OFFSET, X_OFFSET, #FULLHELP X_OFFSET_INC etc completion. ENDPARAMETER PARAMETER START_CHOPPERW TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 3 HELP 'Time interval between checking chopper has started [sec].' #FULLHELP Polling interval for START_CHOPPER completion. ENDPARAMETER PARAMETER STEP_THRESHOLD TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 1 HELP 'Threshold for stepping the telescope [arcsec].' #FULLHELP Threshold for feedback of a new set of offsets to #FULLHELP the telescope task. Normally 1 arc second. ENDPARAMETER PARAMETER STOP_CHOPPERW TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 3 HELP 'Time interval between checking chopper has stopped [sec].' #FULLHELP Polling interval for STOP_CHOPPER completion. ENDPARAMETER PARAMETER SX TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.0 HELP 'X table switched offset [mm].' #FULLHELP This is a control task specified offset and is added to all #FULLHELP X table demand positions in switching. It is only applied #FULLHELP within an observation and is zeroed at the end of it. ENDPARAMETER PARAMETER SY TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.0 HELP 'Y table switched offset [mm].' #FULLHELP This is a control task specified offset and is added to all #FULLHELP Y table demand positions in switching. It is only applied #FULLHELP within an observation and is zeroed at the end of it. ENDPARAMETER PARAMETER SZ TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.0 HELP 'Z table switched offset [mm].' #FULLHELP This is a control task specified offset and is added to all #FULLHELP Z table demand positions in switching. It is only applied #FULLHELP within an observation and is zeroed at the end of it. ENDPARAMETER PARAMETER T_TASK TYPE 'LITERAL' VPATH 'INTERNAL' HELP 'Telescope task name.' DEFAULT 'DISABLE' IN 'DISABLE','TEL' ENDPARAMETER PARAMETER TEL_TASK TYPE 'LITERAL' VPATH 'INTERNAL' HELP 'Telescope task name.' DEFAULT 'TEL' ENDPARAMETER PARAMETER TABLES_INTERVAL TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 30 HELP 'Tables monitoring interval [seconds].' #FULLHELP Number of seconds between each readout of the XYZ tables #FULLHELP position and status. ENDPARAMETER PARAMETER TABLES_TRACKING TYPE '_INTEGER' VPATH 'INTERNAL' DEFAULT 0 HELP '0=Not tables_tracking, 1=tables_tracking.' #FULLHELP This flag is checked before an OBEY TABLES_TRACK command is issued #FULLHELP to check whether a CANCEL is needed. ENDPARAMETER PARAMETER TEST_SMFGST TYPE 'LITERAL' VPATH 'INTERNAL' DEFAULT '8,96,0' HELP 'Dummy reply to the Chopper SMFGST command.' ENDPARAMETER PARAMETER TEST_SMP_ST TYPE 'LITERAL' VPATH 'INTERNAL' DEFAULT '0' HELP 'Dummy reply to the XYZ tables ST command.' ENDPARAMETER PARAMETER TEST_SMPSST TYPE 'LITERAL' VPATH 'INTERNAL' DEFAULT '0' HELP 'Dummy reply to the XYZ tables SMPSST command.' ENDPARAMETER PARAMETER TEST_SMV_ST TYPE 'LITERAL' VPATH 'INTERNAL' DEFAULT '0' HELP 'Dummy reply to the chopper ST command.' ENDPARAMETER PARAMETER TEST_SMVBST TYPE 'LITERAL' VPATH 'INTERNAL' DEFAULT '0000' HELP 'SMU Chopper Simulation status data (4 Digit Hex).' #FULLHELP `When simulating the chopper, this word is used to set the` #FULLHELP `North-South and East-West error statuses.' #FULLHELP ` Hex Error` #FULLHELP ` ---- ------------------` #FULLHELP ` 8000 - NS RMS Limit` #FULLHELP ` 4000 - NS LVDT Limit` #FULLHELP ` 2000 - NS Reference Limit` #FULLHELP ` 0080 - EW RMS Limit` #FULLHELP ` 0040 - EW LVDT Limit` #FULLHELP ` 0020 - EW Reference Limit` ENDPARAMETER PARAMETER THROW TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 60.0 HELP 'Chopper throw in arc seconds (2*ampl of vibration vector).' ENDPARAMETER PARAMETER TILT_EW TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.0 HELP 'EW tilt of chopper [arcsec].' #FULLHELP Same as EWOFF but is associated with the TILT command. ENDPARAMETER PARAMETER TILT_NS TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.0 HELP 'NS tilt of chopper [arcsec].' #FULLHELP Same as NSOFF but is associated with the TILT command. ENDPARAMETER PARAMETER TRACKING TYPE '_INTEGER' VPATH 'INTERNAL' DEFAULT 0 HELP '0=Not tracking, 1=tracking.' #FULLHELP This flag is checked before an OBEY TRACK command is issued #FULLHELP to check whether a CANCEL is needed. ENDPARAMETER PARAMETER TRIPOS_EW TYPE '_LOGICAL' VPATH 'INTERNAL' DEFAULT NO HELP 'Centre (3-Position) chopping along East-West axis.' #FULLHELP When used with the TRIPOS wave type, TRIPOS_EW = YES will cause #FULLHELP the chopper to spend equal times in the Left, Middle and Right #FULLHELP beams along the East-West axis; this is called "Centre" chopping. ENDPARAMETER PARAMETER TRIPOS_NS TYPE '_LOGICAL' VPATH 'INTERNAL' DEFAULT NO HELP 'Centre (3-Position) chopping along North-South axis.' #FULLHELP When used with the TRIPOS wave type, TRIPOS_NS = YES will cause #FULLHELP the chopper to spend equal times in the Left, Middle and Right #FULLHELP beams along the North-South axis.; this is called "Centre" chopping. ENDPARAMETER PARAMETER UPDATE_INTERVAL TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 15 HELP 'SM Tables update interval [seconds].' #FULLHELP When performing XYZ Tables tracking the update check #FULLHELP is performed every UPDATE_INTERVAL seconds. #FULLHELP There is a parameter of the same name in the CONTROL ctask, #FULLHELP but in that program it refers to Chopper tracking. ENDPARAMETER PARAMETER USERWAVE_FILE TYPE 'LITERAL' VPATH 'INTERNAL' HELP 'Name of Userwave file containing wave amplitudes' #FULLHELP The Userwave file contains the wave amplitudes, #FULLHELP one value per line, 4096 values in all, #FULLHELP of the user wave form to be downloaded into #FULLHELP the SMU chopper controller for use with the #FULLHELP USER waveform. ENDPARAMETER PARAMETER VIB_INTERVAL TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 30 HELP 'Chopper system monitoring interval [seconds].' #FULLHELP Number of seconds between each readout of the chopper #FULLHELP position and status. ENDPARAMETER PARAMETER WAVEFORM TYPE 'LITERAL' VPATH 'INTERNAL' DEFAULT 'SQUARE' IN 'SQUARE','TRIANGLE','SINE','TRIPOS','USERWAVE','SCUBAWAVE','RAMPWAVE' HELP 'Name of SM chopper waveform.' #FULLHELP Waveform for defining the displacement of the secondary mirror #FULLHELP from its centre position. #FULLHELP `SQUARE - square waveform; equal time in left and right beams.` #FULLHELP `TRIANGLE - triangular waveform peaked at the centre.` #FULLHELP `SINE - sine waveform.` #FULLHELP `TRIPOS - chop in left, middle and right beams equally.` #FULLHELP `USERWAVE - user wave selected.` #FULLHELP `SCUBAWAVE - SCUBA (Newtonian square) wave selected.` #FULLHELP 'RAMPWAVE - John White's ramp-up square wave.` #FULLHELP `mirror is made to oscillate using a user specified waveform.` ENDPARAMETER PARAMETER WAVETYPE TYPE 'LITERAL' VPATH 'INTERNAL' DEFAULT 'SQUARE' IN 'SQUARE','TRIANGLE','CIRCLE','CENTRE','USER','SCUBAWAVE','RAMPWAVE' HELP 'Name of SM chopper wavetype.' #FULLHELP Wave pattern for defining the displacement of the secondary mirror #FULLHELP from its centre position. #FULLHELP `SQUARE - square waveform; equal time in left and right beams.` #FULLHELP `TRIANGLE - triangular waveform.` #FULLHELP `CIRCLE - sine waveform for NS and EW axes.` #FULLHELP `CENTRE - three position; right, middle, left, middle, ...` #FULLHELP `USER - user wave selected.` #FULLHELP `SCUBAWAVE - SCUBA (Newtonian square) wave selected.` #FULLHELP `RAMPWAVE - John White's ramp-up square wave.` #FULLHELP `mirror is made to oscillate using a user specified waveform.` ENDPARAMETER PARAMETER X TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.0 RANGE -22.0,+22.0 HELP 'X table nominal position [mm].' #FULLHELP The CENTRE_UPDATE, TABLES_UPDATE and UPDATE commands set #FULLHELP X for the current elevation: #FULLHELP ` X = XA * COS (ELEVATION) + XB` #FULLHELP The MOVE command sets X to a user specified value. #FULLHELP The actual setpoint is always (X + DX + SX + X_ZERO) * X_SCALE ENDPARAMETER PARAMETER X_ENABLE TYPE '_LOGICAL' VPATH 'INTERNAL' DEFAULT YES HELP 'Enable X position control? ' #FULLHELP Enabling the X table turns on the X motor, releases the brake #FULLHELP and activates the microprocessor controlled X servo loop. ENDPARAMETER PARAMETER X_SCALE TYPE '_REAL' VPATH 'INTERNAL' DEFAULT -273.756 HELP 'Number of X encoder units per millimeter.' ENDPARAMETER PARAMETER X_SLIMN TYPE '_INTEGER' VPATH 'INTERNAL' DEFAULT 400 HELP 'X soft limit negative [encoder units].' ENDPARAMETER PARAMETER X_SLIMP TYPE '_INTEGER' VPATH 'INTERNAL' DEFAULT 13300 HELP 'X soft limit positive [encoder units].' ENDPARAMETER PARAMETER X_TOLERANCE TYPE '_INTEGER' VPATH 'INTERNAL' DEFAULT 3 HELP 'X encoder servo tolerance [encoder units].' #FULLHELP When moving the X table to a new demand position the #FULLHELP move is accepted has having successfully completed #FULLHELP when the difference between the demand and actual #FULLHELP positions is X_TOLERANCE encoder units. ENDPARAMETER PARAMETER X_ZERO TYPE '_REAL' VPATH 'INTERNAL' DEFAULT -27.63 # DEFAULT -27.44 changed 20030826 imc # DEFAULT -27.99 changed 20030728 following FCO HELP 'Encoder zero [mm].' ENDPARAMETER PARAMETER X2EL TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 30.25 HELP 'X to EL offset coefficient [arcsec/mm].' #FULLHELP The telescope pointing is corrected by X2EL*X arcsec in elevation ENDPARAMETER PARAMETER XA TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 5.791 # DEFAULT 5.42 Changed 23-July-1992 (JACH::FJO) HELP 'X focus curve gradient [mm].' ENDPARAMETER PARAMETER XB TYPE '_REAL' VPATH 'INTERNAL' DEFAULT -5.838 # DEFAULT -5.388 Changed from this 02-Oct-1994 (JCMT::RMP) # DEFAULT -4.588 Changed from this 01-Oct-1994 (JCMT::RMP) # DEFAULT -5.488 Changed 12-Oct-1993 (JCMT::RMP) # DEFAULT -4.758 Changed 19-July-1992 (JACH::RMP) # DEFAULT -3.98 Changed 23-July-1992 (JACH::FJO) HELP 'X focus curve intercept [mm].' ENDPARAMETER PARAMETER XYZ_THRESHOLD TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.01 HELP 'Fractional change in gain for updating the tables.' #FULLHELP In updating the XYZ tables, updates are only commanded #FULLHELP if : #FULLHELP `DELTA_GAIN_X + DELT_GAIN_Y + DELTA_GAIN_Z > XYZ_THRESHOLD` #FULLHELP `where` #FULLHELP `DELTA_GAIN_X = 0.09 * (DELTA_X / WAVELENGTH)**2` #FULLHELP `DELTA_X = X_DEMAND - X_ACTUAL` #FULLHELP `DELTA_GAIN_Y = 0.09 * (DELTA_Y / WAVELENGTH)**2` #FULLHELP `DELTA_Y = Y_DEMAND - Y_ACTUAL` #FULLHELP `DELTA_GAIN_Z = 1.0 * (DELTA_Z / WAVELENGTH)**2` #FULLHELP `DELTA_Z = Z_DEMAND - Z_ACTUAL` #FULLHELP `See SMU_XYZ_CHECK routine.` ENDPARAMETER PARAMETER Y TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.0 RANGE -22.0,+22.0 HELP 'Y table nominal position [mm].' #FULLHELP The CENTRE_UPDATE, TABLES_UPDATE and UPDATE commands set #FULLHELP Y for the coma offset: #FULLHELP ` Y = YB` #FULLHELP The MOVE command sets Y to a user specified value. #FULLHELP The actual setpoint is always (Y + DY + SY + Y_ZERO) * Y_SCALE ENDPARAMETER PARAMETER Y_ENABLE TYPE '_LOGICAL' VPATH 'INTERNAL' DEFAULT YES HELP 'Enable Y position control? ' #FULLHELP Enabling the Y table turns on the Y motor, releases the brake #FULLHELP and activates the microprocessor controlled Y servo loop. ENDPARAMETER PARAMETER Y_SCALE TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 257.02 HELP 'Number of Y encoder units per millimeter.' ENDPARAMETER PARAMETER Y_SLIMN TYPE '_INTEGER' VPATH 'INTERNAL' DEFAULT 275 HELP 'Y soft limit negative [encoder units].' ENDPARAMETER PARAMETER Y_SLIMP TYPE '_INTEGER' VPATH 'INTERNAL' DEFAULT 13250 HELP 'Y soft limit positive [encoder units].' ENDPARAMETER PARAMETER Y_TOLERANCE TYPE '_INTEGER' VPATH 'INTERNAL' DEFAULT 3 # DEFAULT 25 changed 31-July-2000 (fjo) # DEFAULT 3 changed 31-May-2000 (fjo) HELP 'Y Encoder servo tolerance [encoder units].' #FULLHELP When moving the Y table to a new demand position the #FULLHELP move is accepted has having successfully completed #FULLHELP when the difference between the demand and actual #FULLHELP positions is Y_TOLERANCE encoder units. ENDPARAMETER PARAMETER Y_ZERO TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 23.72 # DEFAULT 23.68 changed 20030826 # DEFAULT 22.88 changed 20030728 following FCO HELP 'Encoder zero [mm].' ENDPARAMETER PARAMETER Y2AZ TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 28.0 HELP 'Y to AZ offset coefficient [arcsec/mm].' #FULLHELP The telescope pointing is corrected by Y2AZ*Y arcsec in azimuth ENDPARAMETER PARAMETER YA TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.0 HELP 'Y focus curve gradient [mm].' ENDPARAMETER PARAMETER YB TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 3.73 # DEFAULT 5.03 Changed from this 1-Oct-1994 (JCMT::RMP) # DEFAULT 5.52 Changed 12-Oct-1993 (JACH::RMP) # DEFAULT 5.04 Changed 19-July-1993 (JACH::RMP) # DEFAULT 5.26 Changed 23-July-1992 (JACH::FJO) HELP 'Y focus curve intercept [mm].' ENDPARAMETER PARAMETER Z TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.0 RANGE -22.0,+22.0 HELP 'Z table nominal position [mm].' #FULLHELP The CENTRE_UPDATE, TABLES_UPDATE and UPDATE commands set #FULLHELP Z for the coma offset: #FULLHELP ` Z = ZA * SIN (ELEVATION) + ZB + ZC*SIN(ELEVATION)**2` #FULLHELP The MOVE command sets Y to a user specified value. #FULLHELP The actual setpoint is always (Z + DZ + SZ + Z_ZERO) * Z_SCALE. ENDPARAMETER PARAMETER Z_ENABLE TYPE '_LOGICAL' VPATH 'INTERNAL' DEFAULT YES HELP 'Enable Z position control? ' #FULLHELP Enabling the Z table turns on the Z motor, releases the brake #FULLHELP and activates the microprocessor controlled Z servo loop. ENDPARAMETER PARAMETER Z_SCALE TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 273.817 HELP 'Number of Z encoder units per millimeter.' ENDPARAMETER PARAMETER Z_SLIMN TYPE '_INTEGER' VPATH 'INTERNAL' DEFAULT 300 HELP 'Z soft limit negative [encoder units].' ENDPARAMETER PARAMETER Z_SLIMP TYPE '_INTEGER' VPATH 'INTERNAL' DEFAULT 12900 HELP 'Z soft limit positive [encoder units].' ENDPARAMETER PARAMETER Z_TOLERANCE TYPE '_INTEGER' VPATH 'INTERNAL' DEFAULT 3 HELP 'Z Encoder servo tolerance [encoder units].' #FULLHELP When moving the Z table to a new demand position the #FULLHELP move is accepted has having successfully completed #FULLHELP when the difference between the demand and actual #FULLHELP positions is Z_TOLERANCE encoder units. ENDPARAMETER PARAMETER Z_ZERO TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 25.16 # DEFAULT 25.52 changed 20031017 # DEFAULT 25.19 changed 20031003 # DEFAULT 25.01 changed 20030826 # DEFAULT 25.09 changed 20030728 following FCO HELP 'Encoder zero [mm].' ENDPARAMETER PARAMETER ZA TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.54 # DEFAULT 0.787 changed 22-may-2001 imc # DEFAULT 1.89 Changed 23-July-1992 (JACH::FJO) HELP 'Z focus curve gradient [mm].' ENDPARAMETER PARAMETER ZB TYPE '_REAL' VPATH 'INTERNAL' DEFAULT -12.53 # DEFAULT -19.33 Changed from this 1-Oct-1994 (JCMT::RMP) # DEFAULT -11.833 Changed 29-Jan-1994 (JACH::RMP) # DEFAULT -11.373 Changed 12-Oct-1993 (JACH::RMP) # DEFAULT -11.923 Changed 19-July-1993 (JACH::RMP) # DEFAULT -13.52 Changed 23-July-1992 (JACH::FJO) HELP 'Z focus curve intercept [mm].' ENDPARAMETER PARAMETER ZC TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.845 HELP 'Z focus curve non-linear term coefficient [mm].' ENDPARAMETER PARAMETER ZA_SCUBA TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.54 # DEFAULT 0.47 changed 22-may-2001 imc # DEFAULT 0.18 changed 08-mar-2001 - imc # DEFAULT -0.06 changed 08-mar-2001 -imc # DEFAULT 0.49 Changed 05-Mar-2001 - imc # DEFAULT 0.787 Changed 06-Sep-2000 (JACH::FJO) # DEFAULT 1.89 Changed 23-July-1992 (JACH::FJO) HELP 'Z focus curve gradient [mm].' ENDPARAMETER PARAMETER ZB_SCUBA TYPE '_REAL' VPATH 'INTERNAL' DEFAULT -12.4 # DEFAULT -13.31 changed 08-mar-2001 - imc # DEFAULT -12.81 changed 08-mar-2001 - imc # DEFAULT -12.53 changed 08-mar-2001 - imc # DEFAULT -19.33 Changed from this 1-Oct-1994 (JCMT::RMP) # DEFAULT -11.833 Changed 29-Jan-1994 (JACH::RMP) # DEFAULT -11.373 Changed 12-Oct-1993 (JACH::RMP) # DEFAULT -11.923 Changed 19-July-1993 (JACH::RMP) # DEFAULT -13.52 Changed 23-July-1992 (JACH::FJO) HELP 'Z focus curve intercept [mm].' ENDPARAMETER PARAMETER ZC_SCUBA TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.845 HELP 'Z focus curve non-linear term coefficient [mm].' ENDPARAMETER PARAMETER ZA_SPIFI TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.54 # DEFAULT 0.47 changed 22-may-2001 imc # DEFAULT -0.49 changed imc 2001 04 27 HELP 'Z focus curve gradient [mm].' ENDPARAMETER PARAMETER ZB_SPIFI TYPE '_REAL' VPATH 'INTERNAL' DEFAULT -12.53 HELP 'Z focus curve intercept [mm].' ENDPARAMETER PARAMETER ZC_SPIFI TYPE '_REAL' VPATH 'INTERNAL' DEFAULT 0.845 HELP 'Z focus curve non-linear term coefficient [mm].' ENDPARAMETER #============================ ACTION ABORT_CHOPPER OBEY NEEDS ABORT_CHOP_NS NEEDS ABORT_CHOP_EW ENDOBEY HELP 'Define CHOPPER axes abort states (True=Aborted).' #FULLHELP In the SMS menus, this corresponds to Enable_Chopper #FULLHELP where ABORT=FALSE implies ENABLE=TRUE. ENDACTION ACTION CENTRE_UPDATE OBEY NEEDS ELEVATION_DEG ENDOBEY HELP 'Set the SMU system for the demand centre position.' #FULLHELP Sets the X, Y, Z parameters from the focus curve formulae and the #FULLHELP ELEVATION_DEG parameter and moves the XYZ tables to the #FULLHELP position (X+DX+SX), (Y+DY+SY), (Z+DZ+SZ). #FULLHELP If chopping is being performed, then the details of the #FULLHELP new demand position are obtained from the TEL task and used #FULLHELP to update the chop NSAMP and EWAMP for the new centre. #FULLHELP Normally sent by the CONTROL task when slewing to a new centre. ENDACTION ACTION CHOP OBEY NEEDS WAVETYPE NEEDS FREQUENCY NEEDS COORDS NEEDS THROW NEEDS POSANG NEEDS BEAM NEEDS CHOP_INTERVAL NEEDS CHOP_THRESHOLD ENDOBEY HELP 'Set up vibrator and start chopping; start chop tracking.' #FULLHELP If CHOP_INTERVAL is zero then chop tracking will not take place. #FULLHELP If CHOP_INTERVAL is positive then the chopping vector will #FULLHELP be computed each interval and the chopper will be updated #FULLHELP if the difference of the old vector from the new one #FULLHELP exceeds CHOP_THRESHOLD. ENDACTION ACTION CHOP_MODE OBEY NEEDS MODE ENDOBEY HELP 'Specify whether to use internal/external sync and reference signals.' #FULLHELP This action replaces the EXT_REF and EXT_SYNC actions. It allows #FULLHELP the chopper to be controlled either by the Vax or by the Receiver. #FULLHELP Mode 0 (Internal) gives the Vax control of the chop throw and the #FULLHELP chop frequency and when to start chopping. For Mode 1 #FULLHELP (External Edge Triggered Sync) the chopper synchronizes to the #FULLHELP receiver's external signal rising edge. #FULLHELP For Mode 2 (External Level Triggered Sync) the chopper synchronizes #FULLHELP to the receiver's external signal level (high or low). #FULLHELP For Mode 3 (External Reference) the chopper follows the receiver's #FULLHELP analog external signal. ENDACTION ACTION CHOP_TRACK OBEY NEEDS CHOP_INTERVAL ENDOBEY CANCEL ENDCANCEL HELP 'Update chopper for current position each CHOP_INTERVAL sec.' #FULLHELP If chopping is being performed, then the details of the #FULLHELP new demand position are obtained from the TEL task and used #FULLHELP to update the chop NSAMP and EWAMP for the current position. #FULLHELP The state of the chopper system is only changed if the #FULLHELP CHOP_THRESHOLD is exceeded. #FULLHELP This action is repeated every CHOP_INTERVAL seconds. #FULLHELP When not chopping EN coords, this command can be used to #FULLHELP automatically update the chopper position for field rotation. ENDACTION ACTION CHOP_UPDATE OBEY ENDOBEY HELP 'Update the chopper for the current position.' #FULLHELP If chopping is being performed, then the details of the #FULLHELP new demand position are obtained from the TEL task and used #FULLHELP to update the chop NSAMP and EWAMP for the current position. #FULLHELP The state of the chopper system is only changed if the #FULLHELP CHOP_THRESHOLD is exceeded. #FULLHELP When not chopping in EN coords, this command can be used to #FULLHELP manually update the chopper position for field rotation. ENDACTION ACTION CHOPPER_POSOFF OBEY NEEDS POSOFF_NS NEEDS POSOFF_EW ENDOBEY HELP 'Apply the tilt position offsets to the N/S and E/W chopper axes.' #FULLLHELP The position offsets are given in encoder units. ENDACTION ACTION COEFFICIENTS OBEY NEEDS XA NEEDS XB NEEDS YB NEEDS ZA NEEDS ZB NEEDS Y2AZ NEEDS X2EL NEEDS EW_AMPL_SCALE NEEDS NS_AMPL_SCALE ENDOBEY HELP 'Set the XYZ focus curve and pointing coefficients.' ENDACTION ACTION CONNECT OBEY NEEDS FE_TASK NEEDS T_TASK NEEDS MO_TASK ENDOBEY HELP 'Find the CDA items for the FE_TASK and the T_TASK.' #FULLHELP If the task names are disabled, the required data #FULLHELP are simulated in the SMU task. ENDACTION ACTION CREATE_NB OBEY ENDOBEY HELP 'Create the SMU Notice Board.' ENDACTION ACTION ENABLE_TABLES OBEY NEEDS X_ENABLE NEEDS Y_ENABLE NEEDS Z_ENABLE ENDOBEY HELP 'Enable the XYZ tables.' #FULLHELP Start the motor, release the brakes and activate the microprocessor #FULLHELP servo position loop. ENDACTION ACTION INS_OFFSET OBEY NEEDS FE_TASK ENDOBEY CANCEL ENDCANCEL HELP 'Offset focus for given receiver' #FULLHELP Subtract the (X,Y,Z) offset from nominal of the current receiver, #FULLHELP and add the equivalent offset for the new receiver ENDACTION ACTION JIGGLE OBEY NEEDS JIGGLE_START NEEDS JIGGLE_END NEEDS JIGGLE_DWELL NEEDS JIGGLE_COORDS NEEDS JIGGLE_SCALE ENDOBEY HELP 'Sends a portion of the Jiggle Pattern to the SMU and start' #FULLHELP This action down loads part of a jiggle pattern from the d-task to #FULLHELP the SMU controller. Often, jiggle_start and jiggle_end will not #FULLHELP have to be specified as the jiggle_read action will have set them #FULLHELP to 1 and jiggle_max i.e. the whole pattern will be downloaded #FULLHELP The jiggle pattern will then be started. ENDACTION ACTION JIGGLE_START OBEY ENDOBEY HELP 'Start the SMU jiggling with the pattern previously loaded' #FULLHELP This action will start the SMU jiggling. It will NOT load #FULLHELP a new pattern to the SMU controller, but simply tell it #FULLHELP to begin jiggling. The controller will start jiggling #FULLHELP from the FIRST point of the patttern. ENDACTION ACTION JIGGLE_STOP OBEY ENDOBEY HELP 'Stop the SMU from jiggling' #FULLHELP This action will stop the SMU jiggling. ENDACTION ACTION LOAD_JIGGLE OBEY NEEDS JIGGLE_START NEEDS JIGGLE_END NEEDS JIGGLE_DWELL NEEDS JIGGLE_COORDS NEEDS JIGGLE_SCALE ENDOBEY HELP 'Sends a portion of the Chopper Jiggle Pattern to the SMU controller' #FULLHELP This action down loads part of a jiggle pattern from the d-task to #FULLHELP the SMU controller. Often, jiggle_start and jiggle_end will not #FULLHELP have to be specified as the jiggle_read action will have set them #FULLHELP to 1 and jiggle_max i.e. the whole pattern will be downloaded #FULLHELP This action is intended for diagnostic purposes, users will #FULLHELP normally issue JIGGLE which does a load_jiggle, start_jiggle. ENDACTION ACTION LOAD_USERWAVE OBEY NEEDS USERWAVE_FILE ENDOBEY HELP 'Read user wave file and send waveform to the SMU chopper controller.' #FULLHELP This action opens the supplied userwave file and down loads the user #FULLHELP waveform time-series, which are wave amplitudes at fixed time #FULLHELP intervals, to the SMU chopper controller. Exactly 4096 integer points #FULLHELP are required in the range +32767 to -32767. ENDACTION ACTION MONITOR_CHOPPER OBEY NEEDS VIB_INTERVAL ENDOBEY CANCEL ENDCANCEL HELP 'Monitor the current status and position of the chopper.' #FULLHELP Read back every VIB_INTERVAL seconds the current status #FULLHELP and position of the chopper and report any error states. ENDACTION ACTION MONITOR_TABLES OBEY NEEDS TABLES_INTERVAL ENDOBEY CANCEL ENDCANCEL HELP 'Monitor the current status and position of the XYZ tables.' #FULLHELP Read back the current status and position of the XYZ tables #FULLHELP and report any error states every TABLES_INTERVAL seconds. ENDACTION ACTION MOVE OBEY NEEDS X NEEDS Y NEEDS Z ENDOBEY HELP 'Move the tables to (X+DX+SX), (Y+DY+SY), (X+DZ+SZ).' #FULLHELP Set the tables position. Note in normal observing #FULLHELP X, Y, Z are set from the elevation and XYZ_OFFSET #FULLHELP is to displace the tables from this nominal focus. ENDACTION ACTION NOCHOP_TRACK OBEY ENDOBEY HELP 'Stop chop tracking?' #FULLHELP Dummy action equivalent to SEND SMU CANCEL CHOP_TRACK #FULLHELP Exists for SMS help. ENDACTION ACTION NOD OBEY NEEDS BEAM ENDOBEY HELP 'Step the telescope into beam.' #FULLHELP Step the telescope into the beam and wait for completion. #FULLHELP The wait for NOD_WAIT seconds (usually zero) before #FULLHELP returning. ENDACTION ACTION READ_JIGGLE OBEY NEEDS JIGGLE_FILE ENDOBEY HELP 'Read offset values from the Jiggle file and store them in NBS.' #FULLHELP This action is used to read a jiggle file from disk and store #FULLHELP it internally in the SMU d-task. This action must be executed #FULLHELP prior to issuing the jiggle action. ENDACTION ACTION SET_BLANK OBEY NEEDS BLANK_TIME ENDOBEY HELP 'Specify the chopper blanking time in milliseconds.' ENDACTION ACTION SET_CHOPPER OBEY NEEDS WAVEFORM NEEDS PERIOD NEEDS EWAMP NEEDS EWOFF NEEDS EWPHASE NEEDS NSAMP NEEDS NSOFF NEEDS NSPHASE ENDOBEY HELP 'Set the function generator parameters.' #FULLHELP The chopper must be stopped before the function generator #FULLHELP can be reprogrammed. ENDACTION ACTION SET_IEEE_DEVICE OBEY NEEDS IEEE_CONNECT_1 NEEDS IEEE_CONNECT ENDOBEY HELP 'Set SMU task for real or simulated IEEE operation.' #FULLHELP Real mode is used actual control of the hardware. #FULLHELP In simulate mode the replies from an imaginary micro are #FULLHELP generated. IEEE_CONNECT_1 specifies the Tables mode and #FULLHELP IEEE_CONNECT specifies the Chopper mode. ENDACTION ACTION SET_TABLES OBEY NEEDS X NEEDS Y NEEDS Z ENDOBEY HELP 'Set the tables to the demand XYZ values.' #FULLHELP Move the tables to the position X+DX+SX, Y+DY+SY, Z+DZ+DZ. #FULLHELP Unlike the MOVE command, the status of the chopper is #FULLHELP irrelevant. This is the low level action for moving the #FULLHELP tables and is called by all the other actions which move the #FULLHELP tables. Not normallly employed by users. ENDACTION ACTION SETUP OBEY ENDOBEY HELP 'Interrogate the SM status and set control variables.' #FULLHELP Initializes the SMU d-task; usually called after loading #FULLHELP and connecting to other tasks and the IEEE. ENDACTION ACTION SHOW_CHOPPER OBEY ENDOBEY HELP 'Read back the current status and position of the chopper.' #FULLHELP Read back once the current status and position of the chopper #FULLHELP and report any error states. ENDACTION ACTION SHOW_TABLES OBEY ENDOBEY HELP 'Read back the current status and position of the XYZ tables.' #FULLHELP Read back the current status and position of the XYZ tables #FULLHELP and report any error states. ENDACTION ACTION START_CHOPPER OBEY NEEDS GO_NS NEEDS GO_EW ENDOBEY HELP 'Start chopping' #FULLHELP To start chopping, the GO state of an axis must be set TRUE. #FULLHELP In addition, the axis amplitude must be non-zero. ENDACTION ACTION STOP_CHOPPER OBEY ENDOBEY HELP 'Stop chopping.' #FULLHELP Stopping the chopper will set the GO state to FALSE for both #FULLHELP axes. However, all other parameters (e.g., amplitude) #FULLHELP remain the same. ENDACTION ACTION START_JIGGLE OBEY ENDOBEY HELP 'Start the chopper jiggle function.' ENDACTION ACTION STOP_JIGGLE OBEY ENDOBEY HELP 'Stop the chopper jiggle function.' ENDACTION ACTION TABLES_TRACK OBEY NEEDS UPDATE_INTERVAL ENDOBEY CANCEL ENDCANCEL HELP 'Update SMU tables for current pos each UPDATE_INTERVAL sec.' #FULLHELP Sets the X, Y, Z parameters from the focus curve formulae and the #FULLHELP TEL task current elevation and moves the XYZ tables to the #FULLHELP position (X+DX+SX), (Y+DY+SY), (Z+DZ+SZ). #FULLHELP This is repeated every UPDATE_INTERVAL seconds. #FULLHELP The position of the SMU tables is only changed if the #FULLHELP XYZ_THRESHOLD is exceeded. ENDACTION ACTION TABLES_UPDATE OBEY ENDOBEY HELP 'Set the SMU system for the current position.' #FULLHELP Sets the X, Y, Z parameters from the focus curve formulae and the #FULLHELP TEL task current elevation and moves the XYZ tables to the #FULLHELP position (X+DX+SX), (Y+DY+SY), (Z+DZ+SZ). #FULLHELP The position of the SMU tables is only changed if the #FULLHELP XYZ_THRESHOLD is exceeded. ENDACTION ACTION TILT OBEY NEEDS TILT_NS NEEDS TILT_EW ENDOBEY HELP 'Tilt the secondary mirror by TILT_NS, TILT_EW arc seconds.' #FULLHELP Note: this is a command to the chopper system via the #FULLHELP function generator, not to the tables. ENDACTION ACTION WAVE_OUT OBEY NEEDS OUTPUT_WAVE_NS NEEDS OUTPUT_WAVE_EW ENDOBEY HELP 'Specify the signal output waves from the chopper.' ENDACTION ACTION X_OFFSET OBEY NEEDS DX ENDOBEY HELP 'Offset the X table to X+DX+SX.' ENDACTION ACTION X_OFFSET_INC OBEY NEEDS SX ENDOBEY HELP 'Switch the offset of the X table to X+DX+SX.' #FULLHELP Used by the CONTROL task to switch the focus. ENDACTION ACTION XYZ_OFFSET OBEY NEEDS DX NEEDS DY NEEDS DZ ENDOBEY HELP 'Offset the tables to (X+DX+SX), (Y+DY+SY), (X+DZ+SZ).' ENDACTION ACTION XYZ_OFFSET_INC OBEY NEEDS SX NEEDS SY NEEDS SZ ENDOBEY HELP 'Switch the offset of the tables to X+DX+SX, Y+DY+SY, Z+DZ+DZ.' #FULLHELP Used by the CONTROL task to switch the focus. ENDACTION ACTION Y_OFFSET OBEY NEEDS DY ENDOBEY HELP 'Offset the Y table to Y+DY+SY.' ENDACTION ACTION Y_OFFSET_INC OBEY NEEDS SY ENDOBEY HELP 'Switch the offset of the Y table to Y+DY+SY.' #FULLHELP Used by the CONTROL task to switch the focus. ENDACTION ACTION Z_OFFSET OBEY NEEDS DZ ENDOBEY HELP 'Offset the Z table to Z+DZ+SZ.' ENDACTION ACTION Z_OFFSET_INC OBEY NEEDS SZ ENDOBEY HELP 'Switch the offset of the Z table to Z+DZ+SZ.' #FULLHELP Used by the CONTROL task to switch the focus. ENDACTION #GROUP CONTROL #HELP 'Commands for combined control of the tables and chopper.' #ENDGROUP #GROUP XYZ_CONTROL #HELP 'Commands for the control of the tables.' #ENDGROUP #GROUP CHOP_CONTROL #HELP 'Commands for control of the chopper.' #ENDGROUP @MT_ACTDIR:ACT_LIB.IFL_D_TASK ENDINTERFACE