Release Date: Dec 13, 2010
Generic Release Name: BP7
Public Release Name: "Binocular Pointing Operations" release 7
General Description: This release is BP6 with bug fixes and improvements to many of the TCS subsystems. The bulk of the changes are for binocular operations as it relates to the PCS, IIF, PSF, and GCS. Regarding Binocular Operations this is the first serious attempt to properly control mount pointing, locking/unlocking in the pointing kernel, and guiding using tip/tilt.
Telescope Operator Overview Information
GCSGUI V0.1.21: supports camera temperature readouts in the GuideCam and WFSCam tabs for the respective camera heads. Currently shown are the CCD array and the dewar temperatures and also a counter showing how many seconds ago this information was acquired. AGW temperatures and humidty readouts are also acquired by the GCS but not yet visualized on the GUI but stored in the Syslog every few seconds.
GCS V2.4.1: to enable or disable temperature readouts in GCSL or GCSR set the new lbt.conf variable GCSL/R.readTemperatures to true or false accordingly. Changes will have an immediate effect, no need to reboot or anything. There is a theoretical possibility that temperature readouts could interfere with guide image acquisition during closed loop guiding. If this happens, turn the temp readouts off and file an issue track.
Support Astronomer Overview Information
The PSF collimation files have been moved up one level: from /home/telescope/TCS/Comfiguration/PSF/new to /home/telescope/TCS/Comfiguration/PSF.
PCS now sends tip/tilt demands to the PSFs every "n" seconds, where "n" is a configurable variable in lbt.conf called "tipTiltUpdateTime". The default value is 10. Even though the tips/tilts are communicated to the PSFs every "n" seconds, the pointing kernel is not told the tips/tilts have been used until the individual PSFs have confirmed their usage. Once confirmation has been done by a sided-PSF, the tip/tilt for that telescope side is then fed back into the pointing kernel for the next computation.
The IIF now has the command line command TCSSendWavefront to use instead of the one supplied by Andrea Di Paola.
Specific Tests that need to be performed with the Telescope
removed sextractor analysis of movement verification acquisition images when using MODS as the last one caused many acquisitions to fail because the star ended up in the darker area of the prism as well as close or a little beyond the edge. The images will still be visualized but they wioll not have a red centroid marker on them as sextractor is not evaluating them. These images are not used to get the star in the box and the sextractor result on them was not used to do anything but a sanity check if the signs for the telescope and guide probe movements were correct. This will finally fix the problems with IT #2893
added an exclusion for frequently updating AGW house keeping values in the log if MODS' AGW is selected as it is not providing such information.
The DD entries for AGW humidity and temperature values are set to hum: -1.0, temp: -273.0, ambient temp.: -273.0 to indicate that these values are not available.
found a bug in the temperature command name mappings in Python AzCam version, working around it in GCS by adapting to incorrect command mapping
The 'Public' interface to the Data Dictionary is now populated. The variables should include all the ones instruments are currently reading. The Public names have not yet been published, so if the name lookup fails, the IIF will attempt to directly use the supplied name. This feature can be turned off on the IIFGUI.
Operating System, System Configuration, TCS and Hardware Computers
added an exclusion for frequently updating AGW house keeping values in the log if MODS' AGW is selected as it is not providing such information. The DD entries for AGW humidity and temperature values are set to hum: -1.0, temp: -273.0, ambient temp.: -273.0 to indicate that these values are not available.
added temperature readout of guidecam in Acquire mode
fixed a logic error in updateDDvariabbles determining closed WFS loop
clearing receive buffer when temp readout detects loss of synchronization with AzCam
explicit logging if problems with AGWCamera::requestImage occur with guider of WFS cam
added mutexes around AzCam commands sending so only one command/reply pair is handled at the time
added additional locking for the exception of the Guide command that does not use the usual command/reply sequence due to delayed response
added dead lock detection and resolution in AzCam class in the event of a dead locked mutex
added code to frequently update AGW temperatures and humidity reported by probe if an AGW device is selected
added code to frequently update AzCam reported temperatures for the cameras when an AGW is selected. Updated every 5 seconds when cameras are idle.
when cameras are used by guide or wfs loop, the temperatures are updated after every image, this update can be disabled by setting GCSL/R.readTemperatures in lbt.conf to false,
this value is being updated in GCS with every new preset but not in a closed guide loop.
added logging of temperatures and humidity readouts from AGW probe and cameras
modified AzCam deadlock detection and resolution. Image request have absolute priority and could force a lock on the mutex.
changed the GCSMutex class to take the timedLock() timeout as a parameter and not from a member variable to avoid unintended changes to the timeout
fixed a problem in the poisson number generation that could cause the guide and WFS loops to lock up in simulation mode when both were running
GCSL/R.readTemperatures completely disables any temperature readouts in main DD update thread and guiding and WFSing loops in case there's any kind of issue with it. Effect of flag change will be immediate.
removed a join call in destructors of Guiding and WFS loop if the respective thread is not running to avoid creating a core on occasion.
added an additional client program function that feeds guide image sequences to the GUI to review the images from a TO's perspective (feedGuideImages)
fixed a glitch with a missing ! in AzCam class when determining camera temperatures
fixed missing GS RADEC info in FITS header of externally requested full CCD readouts
added unit definitions to GS RA/DEC DD information
fixed 90 degree Zernike rotation error in WFS track with MODS
removed the verifyStarinBox procedure from the acquisition process
always starting the guide thread in paused mode
updating SVN copy of OSU_L.cfg with the results of the last MODS run on the mountain
adding logic and debug messages to identify source of zero position problem with MODS for the next run
adding an AGW status text showing detected zero position for probe in GUI
fixed IT #2867 that showed a message "error: no error" when AGW initialization failed.
updated AIP_IRTC_R.cfg with WFS_rmsLimit set to 1000.0 as requested by Doug Miller
fixed IT #2873 by setting a warning state if an instrument, side, focal station combination does not have an
AGW definition with GCS, therefore avoiding an error message. If a combination has an AGW definition and the initialization fails, this will still generate an error.
fixed the broken WFS image simulation which didn't work right all the time any more since the new WFS code was implemented
added source extractor configurations for MODS left and right
Changed the criterion for sending tip/tilt values to the PSFs. As an improvement to using threshold values, the PCS will now send tip/tilt demands to the PSFs every "n" seconds, where "n" is a configurable variable in lbt.conf called "tipTiltUpdateTime". The default value is 10. Even though the tips/tilts are communicated to the PSFs every "n" seconds, the pointing kernel is not told the tips/tilts have been used until the individual PSFs have confirmed their usage. Once confirmation has been done by a sided-PSF, the tip/tilt for that telescope side is then fed back into the pointing kernel for the next computation.
PCS pauses the guiding once tips/tilts have been issued to the PSF. When the PSF handshakes with the PCS (success or failure), the PCS resumes the GCS guiding.
Communication of the tips/tilts from PCS to PSF can be disabled by a client call enableTipTilt2PSF (side, bool).
If a rotator on a telescope side does not respond to an "rhold" command, it is only a warning (not a failure). While it should be understood why the rotator could/did not respond to the command, the PCS/TCS should continue to process the Instrument requests.
Fixed a malformed if statement in the setEquatorialTarget function when the decision is made to invoke the synchronizePointingCorrection. The improper statement caused the synchronization to happen for the pointing correction even though PCS was in monocular mode. (Done as a patch to BP6)
Added a check: If a "set" of instruments is authorized on both sides of the telescope, a Preset is issued as BOTH, and a pointing correction is to be done by GCS, then the pointing correction should be done in a synchronized fashion. This check at this time applies to: MODS, LUCIFER, PEPSI, IRTCDG, and IRTCBGF.
Change from glass to telescope steel temperature (301) for collimation temperature correction for all three mirrors.
PSFGUI Version 4.32
Added two numbers to the primary mirror platform position display: the effective radial displacement and the effective height displacement. These are at the suggestion of Steve Allanson and will help the operators see how near the primary is to its travel limits.