STCSK2 Commands Reference SOAR TCS

STCSK2 Commands Reference SOAR TCS Revision 2.4.0, June 2016 Change Record Version Date Description Owner Name 1.0.0 March 13, 2015 Created ...
Author: Roger Flowers
5 downloads 0 Views 111KB Size
STCSK2 Commands Reference SOAR TCS

Revision 2.4.0, June 2016

Change Record Version

Date

Description

Owner Name

1.0.0

March 13, 2015

Created

R.Cantarutti

2.0.0

May 14, 2015

Add N1T, N2T, TARGETZ, ADJCOL, ROTLOC

R.Cantarutti

2.1.0

July 22, 2015

Add STOP

R.Cantarutti

2.2.0

August 24, 2015

Add MODCAL. Add parameters to FIELD. Add parameters to OFFSET.

R.Cantarutti

2.3.0

October 20, 2015

Add WEATHER

R.Cantarutti

2.3.1

October 29, 2015

COLPARS option to MODCAL

R.Cantarutti

2.3.2

April 4, 2016

Fix ADJCOL command documentation

R.Cantarutti

2.3.3

May 9, 2016

Fix footer legend

R.Cantarutti

2.4.0

June 20, 2016

Add TARGETM parameters. Change units of XY offsets.

R.Cantarutti

ii

1. Command Reference MDC TC Take control of the MCU to issue commands and change the operation state of the MCU to Position Designate Mode using the current mount position as reference. If another unit has control of the MCU the command will fail. For example: MDC TC ERROR: Command to take mount control rejected MDC TC ACTIVE MDC RC Release control of the MCU. For example MDC RC ACTIVE MDC STOP Change the operational state of the MCU to Stop Mode and then back to Position Designate Mode using the current mount position as reference. For example MDC STOP ACTIVE MDC N1D The N1 axis is driven to the given angle in response to this command. For example: MDC N1D N1=24.7 ERROR: Command to move N1 rejected MDC N1D N1=24.7 ACTIVE MDC N1D ACTIVE N1=88.7 MDC N1D DONE N1=24.7

3

STCSK2 Commands 2.4.0, June 2016

MDC N2D The N2 axis is driven to the given angle in response to this command. For example: MDC N2D N2=24.7 ERROR: Command to move N2 rejected MDC N2D N2=24.7 ACTIVE MDC N2D ACTIVE N2=88.7 MDC N2D DONE N2=24.7 MDC NSTOP Stop motion of both N1 and N2 and disables tracking. For example: MDC NSTOP ACTIVE MDC TON Enables mount tracking For example: MDC TON ERROR: Enable track command rejected MDC TON ACTIVE MDC TOFF Disables mount tracking For example: MDC TOFF ERROR: Disable track command rejected MDC TOFF ACTIVE MDC N1T Enables N1 tracking. If the right Nasmyth location is not selected, the software will reject the command. If the mount is not tracking, the software will reject the command. For example: MDC N1T ERROR: N1 is not selected MDC N1T 4

STCSK2 Commands 2.4.0, June 2016

ERROR: Cannot process track request for N1 MDC N1T ACTIVE MDC N2T Enables N2 tracking. If the left Nasmyth location is not selected, the software will reject the command. If the mount is not tracking, the software will reject the command. For example: MDC N2T ERROR: N2 is not selected MDC N2T ERROR: Cannot process track request for N2 MDC N2T ACTIVE MDC TARGETZ Mount AZ,EL slew motion. Units are degrees. If the TCSK is not in control of the MCU the command will be rejected. If the TCSK is tracking, the mount will move to the given angles and stop tracking. For example: MDC TARGETZ AZ=90 EL=45 ACTIVE MDC TARGETZ ACTIVE AZ=102.577500 EL=45.012166 MDC TARGETZ DONE AZ=90.000000 EL=45.012167

MDC TARGETM Mount RA,Dec slew motion. Units are degrees. If the TCSK is not tracking the command will be rejected. If the TCSK is tracking the mount will move to the given angles and continue tracking. If the EPOCH parameter is omitted it defaults to J2000.0. If the proper motion parameters PMRA, PMDEC (mas per year) are omitted they default to zero. Radial velocity parameter RV (Km/s) defaults to zero. Parallax parameter PARALLAX (radians) defaults to zero. For example: MDC TARGETM RA=100 DEC=-60.25 ACTIVE AZF=164.177227 ELF=57.888815 MDC TARGETM ACTIVE RA=06:40:06.733 DEC=-60:14:33.779 MDC TARGETM DONE RA=06:39:59.957 DEC=-60:14:59.973

5

STCSK2 Commands 2.4.0, June 2016

MDC TARGETM RA=100 DEC=-60.25 EPOCH=2000.0 ACTIVE AZF=164.177227 ELF=57.888815 MDC TARGETM RA=135.77 DEC=-53.550 PMRA=-27 PMDEC=-29 ACTIVE AZF=186.632973 ELF=66.393339

MDC TARGETNS Mount track at non-sidereal rates. Differential rate units are arc-seconds per hour. If the TCSK is not tracking the command will be rejected. Optionally the mount can slew to the specified coordinates and continue tracking at given differential rates. A differential rate of 0.0 will set tracking back to sidereal rates. For example: MDC TARGETNS DRA=1.2 DDEC=2.3 ACTIVE AZF=200.276988 ELF=56.389542 MDC TARGETNS RA=70 DEC=-60.25 DRA=1.2 DDEC=2.3 ACTIVE AZF=199.804455 ELF=56.583282 MDC TARGETNS ACTIVE RA=05:38:38.471 DEC=-63:19:10.149 MDC TARGETNS DONE RA=04:39:59.891 DEC=-60:14:59.667 MDC TARGETNS DRA=0.0 DDEC=0.0 ACTIVE AZF=171.864619 ELF=59.451071 MDC TARGETNS DONE RA=06:39:59.950 DEC=-60:15:00.001

MDC IMPOS For example: MDC IMPOS X=10.4 Y=5.1 ACTIVE

MDC OFFSET Offset the telescope by the specified values in the focal plane. Offsets in Ra/Dec, Az/El and XY are possible. Units are arc-seconds. The XY coordinates are instrument coordinates. For example: MDC OFFSET N=8.3 E=3.4 ACTIVE MDC OFFSET U=5.1 L=3.2 ACTIVE MDC OFFSET X=10 Y=4 6

STCSK2 Commands 2.4.0, June 2016

ACTIVE MDC OFFSET ACTIVE MDC OFFSET DONE

MDC MODCAL Apply adjustments to the pointing model by setting or adding offsets to terms IA, IE and CA of the pointing model in file soarpmod.dat. Units are arc-seconds. For example: MDC MODCAL SET OIA=8.3 OIE=3.4 OCA=1.9 ACTIVE MDC MODCAL ADJUST OIA=1.2 OIE=0.2 OCA=0.5 ACTIVE MDC MODCAL DONE IA=9.500 IE=3.600 CA=2.400 OIA=9.500 OIE=3.600 OCA=2.400 MDC MODCAL RESET ACTIVE MDC MODCAL COLPARS DONE EL=82.321 DAZ=-59.732 DEL=-10.836

MDC ZPOINT Apply a zero point adjustment to the pointing model by setting or adding offsets to the index error terms IA and IE of the pointing model in file soarpmod.dat. Units are arc-seconds. For example: MDC ZPOINT SET OIA=8.3 OIE=3.4 ACTIVE MDC ZPOINT ADJUST OIA=1.2 OIE=0.2 ACTIVE MDC ZPOINT DONE IA=9.500 IE=3.600 OIA=9.500 OIE=3.600 MDC ZPOINT RESET ACTIVE MDC ZPOINT AUTO ACTIVE

MDC ADJCOL Apply a collimation adjustment to the pointing model by setting or adding offsets to the collimation terms CA and IE of the pointing model in file soarpmod.dat. Three sources of adjustments are provided INSTR, M2 and ADC. Units are arc-seconds. 7

STCSK2 Commands 2.4.0, June 2016

For example: MDC ADJCOL M2 SET OCA=3.7 OIE=2.5 ACTIVE MDC ADJCOL ADC SET OCA=8.3 OIE=3.4 ACTIVE MDC ADJCOL INSTR SET OCA=0.0 OIE=0.0 ACTIVE MDC ADJCOL M2 DONE CA=12.000 IE=9.500 OCA=3.700 OIE=2.500 MDC ADJCOL ADC DONE CA=12.000 IE=9.500 OCA=8.300 OIE=3.400 MDC ADJCOL DONE CA=12.000 IE=9.500 OCA=12.000 OIE=5.900 MDC ADJCOL M2 RESET ACTIVE MDC ADJCOL ADC RESET ACTIVE

MDC GERROR Coordinates in X-Y guider coordinate system as defined by parameter file stcsk.ini. A negative value of EX moves the image in positive X. A negative value of EY moves the image in positive Y. Units are arc-seconds. For example: MDC GERROR EX=2.14 EY=1.3 ACTIVE

MDC PLOG [CLOSE | OPEN | LOG] Pointing map test observations manager. For example: MDC PLOG OPEN ACTIVE PLOG=/home/smount/Logs/spoint-20150580T211148.log MDC PLOG LOG ACTIVE PLOG=2015-05-80T21:11:58 MDC PLOG CLOSE ACTIVE PLOG=END

MDC FIELD Set the instrument position angle IPA and the instrument alignment angle IAA. Also sets the instrument and guider parameter for transformation to focal plane coordinates.

8

STCSK2 Commands 2.4.0, June 2016

For example: MDC FIELD IPA=90.0 IAA=-90.0 ACTIVE MDC FIELD IPARS SCALE=5.1 ROT=0.0 XFLIP=1 YFLIP=0 ACTIVE MDC FIELD GPARS SCALE=5.02 ROT=90.1 XFLIP=0 YFLIP=0 ACTIVE MDC FIELD DONE IPA=90.000 IAA=-90.000 ISCALE=5.1 IROT=0.0 IXFLIP=1 IYFLIP=0 GSCALE=5.02 GROT=90.1 GXFLIP=0 GYFLIP=0

MDC TARGETG Create a new target for the auto-guider attached to the current rotator. The XY coordinates are in guider coordinate system (stcsk.ini) in units of [mm]. The RA/Dec coordinates are in units of degrees. For example: MDC TARGETG X=8.3 Y=3.4 ACTIVE MDC TARGETG RA=23.1 DEC=-30.09 ACTIVE MDC TARGETG DONE X=8.3 Y=3.4

MDC ROTLOC Set the active rotator. For example: MDC ROTLOC ROT=OTA ACTIVE MDC ROTLOC DONE ROT=OTA MDC ROTLOC ROT=NASMYTH_R ACTIVE MDC ROTLOC ROT=NASMYTH_L ACTIVE MDC ROTLOC ROT=CWFS

MDC WEATHER Update the pointing model weather parameters for pressure, temperature and relative humidity. Units for pressure are mBar. Units for temperature are Kelvin degrees. Relative humidity is a number between 0 and 1. 9

STCSK2 Commands 2.4.0, June 2016

For example: MDC WEATHER WATM=748 WT=290 WRH=0.3 ACTIVE

10

STCSK2 Commands 2.4.0, June 2016