WHT Telescope Control System

Release Notes for Version W40

TCS-WHTREL-40

Issue: 0.2 2010-12-15

Author: F J Gribbin

tcsman@ing.iac.es

1. Summary

This document summarises the changes made to the latest version in the W39 release tree of the WHT Telescope Control System, W39-1-1, to produce the release tree W40.

2. Release History

Version	Date	Description	Author(s)
W9-0-0	26 Sep 1999	First version built with VMS 7.1	MPF
W10-1-0	22 Oct 1999	New commands CLONE & GOMOON; updated IERS params & GHRIL IR derot model	RPC/MPF
W12-0-6	17 Mar 2000	Display instrument rotator limits, add INGRID support	RPC
W14-1-4	2 Aug 2000	New command SLOWOFF, write sky PA not mount PA in headers, update GHRIL IR derot corrections	RPC
W14-1-6	21 Aug 2000	Add support for NAOMI autoguider	RPC
W14-1-7	1 Sep 2000	Encoder & autoguider logs are stored on separate disk	RPC
W14-1-8	15 Sep 2000	Default to DRAMA comms	RPC
W14-1-10	6 Nov 2000	FOCUS & DOME commands always send completion status to DRAMA	RPC
W14-1-11	18 Nov 2000	TELD timeout values changed for INGRID compatibility	RPC
W14-1-14	5 Jan 2001	New Cass & GHRIL pointing models, IERS update	RPC
W15-0-0	6 Mar 2001	Revert to correct version of time-to-limits code	MPF
W15-1-0	29 Mar 2001	Fix problem with RA, Dec having half true value in headers	MPF
W15-1-1	28 Apr 2001	Revert to old Cass & GHRIL pointing models	MPF
W16-0-0	4 Jun 2001	New Cass & GHRIL pointing models, improved SLOWOFF command, add TWEAK as a DRAMA action	MPF
W16-0-1	12 Jul 2001	New position of azimuth zeroset target	MPF
W16-1-0	12 Oct 2001	Same as W16-0-1, but using DRAMA v1.3	MPF
W17-1-0	1 Sep 2001	Simultaneous use of TCS from DECnet & DRAMA, log TELD messages, uses DRAMA v1.3	MPF
W17-2-0	24 Oct 2001	Start TELD from menu, log focus encoder, ICL command completion fixed	MPF
W17-4-0	30 Oct 2001	Negative longitude for headers, fix problems with data blocks sent to dtasks	MPF
W17-5-0	15 Jul 2002	Fixed memory leak	RR/MPF
W17-5-1	3 Jan 2003	Add support for acquisition TV as AF2 autoguider	MPF
W18-0-0	22 Jan 2003	New LOG command, fix rotator glitch at azimuth reversal, focus-temp correction at Prime	MPF
W18-0-4	17 Feb 2003	Add LIRIS values	MPF/FJG
W19-0-0	9 Mar 2003	New logging process logs to 30 minute ring file, focus data logged continuously.	MPF
W20-0-1	14 Apr 2003	Configure NAOMI in GRACE, replacing UES.	FJG
W20-1-0	26 May 2003	Encoder logging bug fixes.	MPF
W20-1-3	10 Jul 2003	New GRACE pointing model.	MPF
W20-1-4	22 Aug 2003	Uses new SDSU autoguider for INTEGRAL.	MPF
W21-2-1	18 Sep 2003	Implementation of nominal positional offset, and ability to use cumulative slow offsets. CTRL-C from a script no longer stops the telescope.	MPF
W21-2-2	9 Oct 2003	New altitude target zeroset position.	MPF
W21-3-0	21 Nov 2003	Fix bug in differential tracking.	MPF
W21-3-1	6 Dec 2003	Uses new SDSU autoguider for Cass.	FJG
W22-0-0	17 Dec 2003	Extra focus items added to TCS FITS packet.	MPF
W23-0-0	12 Jan 2004	Improved TCS-ICS DRAMA communication; improved reporting of tracking status.	MPF
W23-1-1	12 Mar 2004	System catalogue stored with TCS version tree. New Prime pointing model.	MPF
W23-1-2	30 Apr 2004	Add support for instrument Ultracam.	FJG
W23-1-3	7 Jul 2004	Add support for SCAM/STJ with UV derotator in GHRIL	FJG
W23-1-4	10 Jul 2004	STJ autoguiding parameters corrected	FJG
W25-0-0	6 Sep 2004	Revamp FITS packet; check if ICS disk mounted	MPF
W25-0-1	1 Oct 2004	Azimuth transition radius was reduced.	MPF
W25-2-0	2 Dec 2004	Uses VMS 7.3-2. New menu layout at login.	MPF
W25-3-0	19 Feb 2005	Increase pagefile quota for creation of cloned displays.	MPF
W27-0-0	15 Apr 2005	New DRAMA action PULLIN, completes once guide star is in position.	MPF
W27-1-0	16 Jun 2005	Fix focusrun bug, increase PULLIN timeout to 1 minute.	MPF
W29-0-0	25 May 2006	Improve servo to fix azimuth oscillations; increase RPC timeout; update Cass pointing model.	MPF
W30-0-0	5 Mar 2007	Do not allow telescope to move unless both axes have been zeroset; disallow use of ZEROSET AZIMUTH ABSOLUTE command; disable WRAP command.	MPF
W31-0-0	26 Apr 2007	Increase PULLIN timeout to 2 minutes (for LIRIS).	FJG
W31-1-0	1 July 2007	FITS header changes: EQUINOX real, add UTOBS	MPF
W31-2-0	8 July 2007	FITS header: UTOBS comment amended	MPF
W32-0-0	14 Dec 2007	TWEAK performance improved	FJG
W33-0-0	5 Jan 2008	Sound alarm if dome is misaligned	MPF
W34-0-0	3 Sep 2008	Support ExPo instrument, send RA,Dec to TELD when moving	MPF
W35-0-0	5 Oct 2008	Support Ax/El autoguiders (for ExPo)	MPF
W36-0-0	1 Dec 2008	Altitude limit for GLAS Laser (LASER_LIMIT)	FJG
W37-0-0	18 Jan 2009	Add Instrument ACAM	FJG
W38-0-0	22 Apr 2009	Updated ACAM parameters	FJG
W39-0-0	7 Oct 2009	Fixes for 20 char source names, CLONE target name	FJG
W40-0-0	15 Sep 2009	Support for CANARY, disable hold screen for windows	FJG

3. Hardware and Firmware Modifications

None

4. Deliverables and Installation

The CMS classes necessary to build TCS versions in the W40 release tree are defined in Section 8, they are also defined in the version files in [WHT_LOGIN.VERSION].
CMS libraries containing the source code for the TCS, the PLOT and CAMTEST utilities, and the build procedures are held on LPAS3; the root directory for the CMS libraries is defined by the logical name SOURCE_DIR.
The release notes document for the W40 release tree (this document) is stored in ~docs/tcs/whtrel/tcs-whtrel-40/tcs-whtrel-40.html
The WHT TCS User Manual can be found here.

5. Reasons for release

W40-0-0

New features

Support for CANARY (E-ELT AO Testbed in GHRIL). Canary has it's own derotation optics.
New station is selected by command STATION GHRIL_CANARY
Autoguiding is selected by command AGSELECT CANARY
Instrument offset is selected by command INSTRUMENT CANARY
When TCS starts it will report a failure to mount the disk partition from ICS, warning that no TCS FITS header packets will be written and suggest recovery.

Defects fixed

Various fault reports over the years have noted problems resulting from users pressing hold-screen (control-Q) unintentionally. Sometimes the user thought TCS had hung. On others occasions commands from the ICS were not executed. Now control-Q will not hold output neither in INFODISP window nor USER terminal.

W40-1-0

New features

None

Defects fixed

TCS windows now use small font as default. (See FR 19281). This had changed to large fault at W40-0-0.

W40-2-0

New features

Timeout on TELD TWEAK commmand increased to 60 seconds. TWEAK invoked from ACAM acquisition tool reported as often timing out during initial use.

6. Known problems and restrictions

FR 18269 : Incorrect AIRMASS headers when two runs performed simultaneously (e.g. ISIS red & blue arms).
Also related report 19201.

FR 19162: TELD crashed while writing FITS header.

Enhancements are noted in the TCS Work List which can be found in BSCW under ING Engineering Projects - Telescope Control Systems - 0004 Project Plans.

7. Compatibility

Needs CAMAC driver v2-3.
Compatible with TPOINT v4.4-4.

8. Software changes

W40-0-0

W40-0-0 comprises the following subsystem versions; any changes made to a subsystem since W39-1-1 are listed.

ALTAZLIB V2-01

Unchanged.

BUILD v1-01

Unchanged

CAMACDB v0-1

Unchange.

DISPLAY v2-03

Uses new terminal properties file DISPLAY_TERMINAL.DAT to disable hold screen (control-S).

GSEXAM v0-1

Unchanged.

INCLIB V6-17

Add support for CANARY (extra focal station globals).

MONITOR v1-02

Unchanged.

MSG v1-01

Unchanged.

NETSERVER v0-7

Unchanged.

OUTLOG v0-05

Unchanged.

POINT v0-6

Unchanged

RUN v2-03

NFSMOUNT.COM reports failure to mount partition from ICS (where FITS packets are written) and suggests recovery.

SHARE v0-3

Unchanged.

SYNC v6-03

Unchanged.

SYSCOMP v1-08

Unchanged.

TCSLIB v1-2

Unchanged.

TELD v6-09

Unchanged.

TV v1-06

Unchanged.

USER v6-09

Uses new terminal properties file USER_TERMINAL.DAT to disable hold screen (control-S).
Opens system catalogue file as READONLY. Previously required (non-default) write access to catalog file SYSTEM.SAV. This had caused problems for GOCAT, BLIND and FIND commands after some releases.

WHT v2-17

Unchanged.

WHTINIT v4-17

Support for CANARY. Values for CANARY are mostly copied from GHRIL_UVDEROT.
CANARY team are not worried about determining derotator corrections, so these are left as zero.
Derotator, instrument and autoguider parameters are set to zero/nominal values for CANARY. They do not require any particular orientation on sky and will ajust the application of autoguiding corrections by amending the packets sent by the CANARY autoguiding software.