Software Release Notes for Build "BP7"

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.

The Details

Specific Tests that need to be performed with the Telescope

Patches to the Release

  • PSF Version 4.53
    • Apply IssueTrak 3070 for LBC coma corrections: Only do rotation with opposite sign from previous.

  • GCS V2.4.1 B6
    • 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

  • GCS 2.4.1 B5
    • fixed an annoying bug in MovieThread that caused resends of a full frame ROI command when using a full frame ROI different from the detector size
    • added a change in WFSingThread::offAxisCorrection to fix a bug with MODS in compensating for off axis probe position requested by Doug, IT #3177

  • GCS V2.4.1 B4
    • added a new configuration value to lbt.conf: GCSL/R.maxFWHM which takes a maximum allowable FWHM in arcsecs for filtering Source Extractor results
    • added code to support this new value and filtering all Source Extractor results that exceed this limit.

  • GCS V2.4.1 B3
    • upon Doug's request put code from BP4 back into the WFS track that will optimize the grid positioning for maximum spot movement
    • made this slopeAverage iteration configurable through a config value in lbt.conf: WFSgridIterations, setting it to 0 switches it off, default is 6
    • fixed a problem during acquisition that caused warnings in presets saying GCS received an acquisition image in guide loop size. This also caused unnecessary image requests to AzCam. IT #3165

  • GCS V2.4.1 B2
    • added mutexes around external guide cam and wfs cam image requests to avoid collission with temperature readouts
    • put check for deselected AGW inside Mutex section for external guide cam and WFS cam readout request

  • GCS V2.4.1 B1
    • 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

Known Bugs

  • none.

Release Overview

  • 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

TCS Servers / Workstations

  • none.

agw-control computer

  • none.

jet computer, DSP, FPGA

  • none.

Networks

  • none.

PLCs

  • none.

TCS Subsystems and GUIs, and significant configuration files

lbt.conf

  • Change the path to the PSF collimations files from /home/telescope/TCS/Configuration/PSF/new to /home/telescope/TCS/Configuration/PSF.

AGw control server

  • none.

AOS - Adaptive Optics

  • none.

ECS - Enclosure Control

  • none.

ENV - Environmental Sensors

  • none.

IIF - Instrument Interface

  • IIF Version 8.6
    • Fix MultiEntries class so empty fields are handled correctly and do not crash the IIF (IssueTrak 2999).
    • Change oss.side[n].adsc.is_in_position[i] to oss.side[n].adsc.axis[i].is_in_position and same for terc at Paul's request.
    • Check for existence of DD names when the DD map file is read.
    • Support adding the raw DD names to the map.
    • Add reflective memory variables to track whether subsystems are running.
    • Add filters I,J,H,K and colorTypes B_R,R_I,J_K (IssueTrak 3009).
    • Change message for event noneMode to say the Preset is being canceled and add the reason.
    • Populate DDNames.conf
    • Add TCSSendWavefront command to the build for use by the LBC.
  • IIFGUI Version 3.5
    • Support the use of raw DD names in the map.
    • Add ability to edit the DD map file.
    • Use violet color if GCS is not sending corrections to PCS/PSF.
    • Only use red for AOS status if the loop should be closed.

GCS V2.4.1 - Guiding Control

  • 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

LSS - Logging and Events

  • none.

MCS / mcstemp - Mount Control

  • A bug in the hbs->stowpins GUI has been fixed.
  • The Azimuth and Elevation GUIs have had their display of stow pin status improved.
  • Some erroneous limits in the hbs->System GUI have been fixed. Some of the displayed temperatures had improper limit sna were shown in red when they were in the nominal range.
  • Some limits in the display of the lateral pad pressures GUI were changed to more correctly display nominal values.
  • MCSPU software has some additional logging to help find a problem in communication with the PLCs.
  • The Elevation gear ratio (ratio of telescope movement to drive motor shaft movement) was changed from 60.26 to 60.25641025
  • A label in the 'enc' display page of the Engineering Interface was changed.
  • AZ and EL proximity limits and emergency limits have been adjusted to reflect the latest determination of these by the engineering group.

OSS - Optical Support

  • none.

PCS - Pointing Control

  • PCS Version 6.10
    • 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.

PCS GUI

  • none.

Pointing Kernel / Pointing Kernel tools

  • none.

PMC - Primary Mirror Cell

  • PMC Version 5.13
    • Add actuator synchronous force status to the MirrorReport from VxWorks. This requires VxWorks Version 5.7 or higher.
  • PMCGUI Version 5.11
    • Remove ability to disable setting synchronous actuator forces. Synchronous actuator forces are now fully supported in VxWorks Version 5.7 and higher.

PSF - Point Spread Function

  • PSF Version 4.52
    • 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.

SDB - Star Database

  • none.

TCS GUI

  • none.

WX - Weather Station

  • none.

TCS Common Software

commandreturn - client command status returns

  • none.

commandsequencer - client/subsystem command handling

  • none.

core - foundation routines

  • none.

datadictionary - reflective memory and event support

  • none.

eventhandler - event handling

  • none.

networkconfig - subsystem management

  • The build name has been added to the SysLog messages when networkserver starts and stops.

reflectivememory - global shared memory

  • A "late" check has been added to received data packets in gshmserver which will result in a message to SysLog. The threshold is in lbt.conf, and is nominally 500 milli-seconds.

rpc - communication protocol

  • none.

setvalue - reflective memory access

  • none.

tcs_config - tcs configuration

  • none.

TCS Tools

DDEditor - Data Dictionary Editor

  • none.

DDBrowser - Data Dictionary Browser

  • none.

DDViewer - Data Dictionary Viewer

  • none.

Event Editor

  • none.

Telemetry

Collector

  • none.

Instruments and Environmental Sensors

DIMM - Differential Image Monitor

  • none.

idl

  • none.

iraf

  • none.

IRTC - Infrared Test Camera

  • IRTC Version 2.4
    • Add filters I,J,H,K and colorTypes B_R,R_I,J_K (IssueTrak 3009).
    • Correct proper motion units for the AO reference star.

LBC - LBT Binocular Camera

  • none.

LBTO Weather Station - 3DWGUI

  • none.

MAT - Mount Axillary Telescope

  • none.

All Sky Monitor

  • none.

-- NormCushing - 18 Nov 2010

This topic: Software > WebHome > SWReleases > SWReleaseNotes2010 > SWRelBuildBP7
Topic revision: 24 Feb 2011, TorstenLeibold
This site is powered by FoswikiCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding Foswiki? Send feedback