Software Release Notes for Build "BP4"

Release Date: Oct 17, 2010
Generic Release Name: BP4
Public Release Name: "Binocular Operations" release 4
General Description: Functionality for Binocular Operations. Specifically, optics demand passed from PCS to PSF; locking sides, or not; leaking back to the optimized position.

Telescope Operator Overview Information

  • PCS_Version-6.7
    • New events are now generated in the PCS fast loop indicating a situation which requires attention (e.g., NO RPC or BELOW THE HORIZON). The "below the horizon" events are throttled to be once every 30 minutes. Other MCSPU complaints are NOT throttled (e.g., Nans in the rotator polynomials).
    • Added a WARNING event to check the magnitude of the proper motion values in case the user forgets to put the values in radians. If the proper motion values are larger than for Barnard's star, issue the warning.
      • pcs.command.setEquatorialTarget.properMotionWarning
  • The IIFGUI now displays information about the status of the RunAO command, as well as some AO information.

  • GCS V2.3.5
    • A slight modification to the guide star acquisition procedure has been added to accommodate changes in the PCS. You might not even notice it but after a successful guide star acquisition the GCS will be in guiding_paused mode until the PCS signals that it is ready to receive guide corrections. It is then that the IIF will send a resumeGuiding command to the GCS to continue the guide loop. When closely looking at the GCSGUI or following the logs you might see this brief moment the GCS is paused after acquisition.

Support Astronomer Overview Information

  • PCS_Version-6.7
    • Implemented the latest "leaking" algorithm with tip/tilt demands. Currently, the PCS will send the tip/tilt demands to the PSFs if any one of the demand tip/tilt values in the set (SX or DX) exceeds the threshold values defined in lbt.conf; The tip/tilt thresholds are set to 250 mas.
    • Created both SX and DX temporary tip/tilt multiplicative factors (+/-1) in lbt.conf in order to be able to modify the tips and tilts on each telescope side separately during determination of signs of these values.
    • Offsets in DETXY are not yet supported in binocular mode.

  • GCS V2.3.5
    • A new optional AGW configuration file entry is supported: guidecam_ROI. It defines the full frame readout size for the detector. Downsizing this full frame helps removing overscan artifacts or other unwanted objects that confuse the centroiding algorithm. The full syntax is "guidecam_ROI 'x1 y1 x2 y2" string' with xn and yn being absolute CCD pixel coordinates, x1, y1 >= 1; x2 <= 532, y2 <= 528. Removing or commenting this line will automatically use the full detector size for the readout again.

The Details

Specific Tests that need to be performed with the Telescope

Patches to the Release

  • PSF Version 4.51
    • The Y rotation is now negative for Mode 1 pointing adjustments (IssueTrak 2934).

Known Bugs

  • none.

Release Overview

  • none.

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

  • none.

AGw control server

  • none.

AOS - Adaptive Optics

  • none.

ECS - Enclosure Control

  • none.

ENV - Environmental Sensors

  • ENV Version 1.7
    • Add build names to the startup event.
  • ENVGUI Version 1.4
    • Add build names to the 'about' box.

IIF - Instrument Interface

  • IIF Version 8.3
    • Change logic in Preset so a synchronous preset that fails before sending the target to the PCS is not counted as a synchronous preset. This allows resending the corrected preset.
    • Add build names to the startup event.
    • Correct names of AO modes in IIFGlobals.
    • Add reflective memory variable iif.side[x].aoclosed to keep track of when the AO loop should be running.
    • Add event adaptiveOff to signal when the AO loop opens unexpectedly.
    • Add RunAO running to the list of conditions that reset the counter in the offSource check for canceling Presets.
    • Re-write AO off check (needs more work).
    • Add check for AO loop open using aoclose reflective memory variable.
    • Set and clear aoclosed as appropriate in commands UpdateTargetWavelength, TipTilt, StepFocus, ResumeGuiding, ResumeAO, PauseGuiding, PauseAO, RunAO, Preset, and Offset.
    • Lock/unlock both sides of the PCS in Preset and Offset when in monocular mode.
    • Add the failing XML string to the deserialize error message in the C interface routine StatusInfo_CommandResult_getResult() (IssueTrak 1318).
    • Move wait for GCS probe motion in Preset to after wait for telescope onSource. This will shorten some Presets.
    • Skip the wait for condition 'false' in wait for elevation and wait for telescope in Preset. This will eliminate two 2 second waits most of the time.
    • Make the Authorize command return success if the instrument is not authorized to eliminate red events being generated. The status correctly tells the instrument whether it is authorized or not.
  • IIFGUI Version 3.2
    • Add AO status (needs more work).
    • Add RunAO command status.
    • Improve checks for focal station and instrument when setting colors for status displays.

GCS - Guiding Control V2.3.5B1 (updates since BP2)

  • fixed a problem in gcsClient that ignored the triggerWFS command and incorrectly executed the sendernikesToPSF command instead
  • fixed a problem with the calculation of the initial pointing correction not taking the full frame ROI into account
  • fixed the GUI to honor the full frame ROI in the acquisition image header DETSEC entry and position hotspot related items correctly in the image
  • added the getFocus fix for MODS to handle negative focus settings as allowable results in getFocus and not as an error
  • added mods_initTrans fix that corrects for C logic
  • parkActiveProbe now returns a warning when no AGW unit is selected instead of an error which fixes IT #2868
  • added correct resetting of the guidingPaused flag in DD with stopGuiding and when starting the guide loop, same for the WFSpaused flag
  • fixed a problem that the AGW status always showed "SIMULATED" even if it did use the physical probe
  • fixed a problem generating AzCam 4.0 DATE-OBS FITS header, the year didn't get the offset of 1900 added
  • applies WFS pinhole offset for offsets if MODS AGW is active
  • changed the way the acquisition WFS pinhole offset is calculated from SFPachieved_X/Y to SFPrequested_X/Y to maintain
  • consistency with the way the WFS offset is calculated during telescope offsets.
  • fixed a problem with offsetGuiding and the book-keeping of the MODS WFS pupil offset which caused huge guide corrections after offset
  • more detailed logging of IIF DD variables on startup to determine how AGW got autoselected
  • changed WFSCam_minExposure to 5000 as requested in IT #2900
  • fixed a problem with the side not being updated in event logging for the right side
  • added guidecam_ROI entry to OSU_L.cfg which can define the full frame ROI for acquisition images and the movie thread
  • coordinates that reference absolute pixel coordinates in the acquisition image, i.e. hotspots, will have to be redefined and take any offsets into account
  • added code to AzCam and AGWCamera classes to support this optional full frame ROI definition

  • added DD variable GuideCam.centroid_FWHM_ellipticity to report Source Extractors ellipticity findings for the current guide star
  • added support for one FWHM value and an ellipticity ratio for the guide star instead of FWHM_X and _Y as it was used in the internal centroidiing functions.
  • added GuideCam.centroid_distance_RMS which contains the offset error of up to 100 centroids of the cuirrent cycle. It should give a good idea of the long-term stability of the guiding.
  • added GuideCam.centroid_distance which will provide the distance error of the last centroid.
  • added GuideCam.centroid_distance_Mean, GuideCam.centroid_distance_StdDev, GuideCam.centroid_distance_population for additional statistics on the stability of the guiding
  • added support in GCS to calculate and populate the new DD variables
  • deprecated GuideCam.centroid_errX and GuideCam.centroid_errY as well as GuideCam.centroid_FWHM_Y. They will be removed future versions of GCS.
  • full MODS support with latest library as of 27-Aug-2010
  • failing initialization of MODS AGW if transformations couldn't get loaded from server
  • changed DD variable GuideCam/centroid_FWHM_ellipticity to guidestar_ellipticity
  • added GuideCam/guidestar_ellipticity_RMS to DD
  • removed all GuideCam/centroid_distance_* values as they are meaningless
  • added GuideCam/centroid_mean_population describing the size of the set used to calculate the means of centroid related values
  • added GuideCam/centroid_deltaX/Y_mean to calculate the centroid deltas over a period of time to show drift tendencies
  • added GuideCam/centroid_FWHM_mean
  • startGuiding returns with a paused guide loop if it succeeded to give PCS a chance to lock the access to the mount. IIF sends a resumeGuiding command after PCS confirms the lock.
  • adding DD variables GuideCam.centroid_ccd_X/Y_mean, GuideCam.centroid_ccd_X/Y_RMS, GuideCam.centroid_FWHM_RMS. These values are intialized but don't get populated yet.
  • renamed DD variable GuideCam.guidestar_ellipticity_RMS to GuideCam.guidestar_ellipticity_mean
  • updated config files AIP_L.cfg, AIP_IRTC_L.cfg and AIP_IRTC_DG_L.cfg with the new hotspot position for AGW #3 and #4 as documented in IT #2823
  • added lbt.conf values GCSL/R.maxEllipticity to support the implementation of a guide star elongation watchdog. This should adress IT #2500 and #2727 and while not solving the problem at least make observers and TO more aware of a situation of low WFS RMS values along with elongation of the guide star which hints to bad collimation.
  • implemented evaluation of ellipticity property of Source Extractor when WFS is enabled and claims to be collimated AND star is inside required circle around hotspot. A warning would be displayed on GUI if elongation was detected under the prescribed conditions.
  • updated focus values for AGW #2 to 31.6mm as requested per IT #2755
  • added interface changes for binocular PCS calls in GCS.cpp and GuidngThread.cpp
  • added DD variable GuideCam.elongatedStar which is set to true when guiding detects a star exceeding the ellipticity setting in lbt.conf AND with WFS claiming to be in good collimation.
  • added necessary code to maintain status of GuideCam.elongatedStar in GuidingThread.cpp
  • added DD variables xmitCorrectionsToPCS and xmitCorrectionsToPSF (both bool) to indicate if the GCS is sending centroids or wavefronts to the corresponding subsystems
  • added code to support the two new DD variables

LSS - Logging and Events

  • LSS Version 3.5
    • Add build names to the startup event.
  • LSSGUI Version 1.9
    • Add build names to the 'about' box.

MCS / mcstemp - Mount Control

  • MCSGUI Version 2.10
    • Add build names to the 'about' box.
    • Change font family from 'Helvetica' to 'Luxi Sans' since Helvetica is no longer available.

OSS - Optical Support

  • Converted existing OSSGUI completely to native QT 4.6 format.
  • Modified all text such that black text on a gray background is now white.
  • Added new icons to show various parts simulation status.
  • Removed icons which are no longer used,
  • Changed several BYTE variables to BIT type, since they are either true or false only.
  • Added a new, top level main window to the GUI which shows the high-level status for each component only, as well as launching the other, more detail oriented windows.
  • Added new 'reconfigure' window to the OSSGUI to allow the operator to change the swing arms and dynamic balance configuration.
  • Added new 'BoolIconControl' class to OSSGUI to handle changing the widget's associated icon based on a reflective memory simulation variable.
  • Fixed color display for swing arms lockout on GUI, added code to change event dialog yellow and red when necessary.
  • Increased decimal input for selector. It was 2 decimal places, but needed to be four.
  • Modified existing simulation variables type from int to bit. Also added preliminary mirror cover simulation variables.
  • Added a try-catch block around the tertiary mirror automatic reconnect. This will prevent the OSS from crashing if a connect is attempted while running.

PCS - Pointing Control

  • PCS_Version-6.7
  • MONOCULAR
    • Modified startup and shutdown events to include the Build name (e.g., BP4).
    • Created a new event to indicate when a user-supplied HotSpot is being used instead of the default.
      • pcs.telescope.command.setEquatorialTarget.hotSpotSupplied
    • Even though the trajectory feedback from the MCSPU is in the fast loop, the types of errors generated here (e.g., NO RPC or BELOW THE HORIZON) require immediate action. Therefore added events to inform the observers of any issues. The "below the horizon" events are throttled to be once every 30 minutes. Other MCSPU complaints are NOT throttled (e.g., Nans in the rotator polynomials).
    • Added a WARNING event to check the magnitude of the proper motion values in case the user forgets to put the values in radians. If the proper motion values are larger than for Barnard's star, issue the warning.
      • pcs.command.setEquatorialTarget.properMotionWarning
    • The error computation on achieved coordinates has been re-instated and is in the EncoderFeedback class.

  • BINOCULAR
    • Created separate semaphores and associated flags to handle Presets, Offsets, and the Pointing Correction.
    • The pointing correction will be set to "synchronized" internally by the PCS when a Synchronized Preset is requested and the instruments on each telescope side will be issuing a pointing correction via the GCS. If the Synchronized Preset is aborted, AND it has already set the Synchronize Pointing Correction flag, the flag will be cleared.
    • When a Preset and an Offset are both specified in the Preset AND a Synchronized Preset was requested, assume the observer also wants a Synchronized Offset.
    • Implemented the latest "leaking" algorithm with tip/tilt demands - The tip/tilt demands at the "top" of the fast loop only retain their newly computed values IFF the demands have been communicated to the PSFs. Currently, the PCS will send the tip/tilt demands to the PSFs if any one of the demand tip/tilt values in the set (SX or DX) exceeds the threshold values defined in lbt.conf. The tip/tilt thresholds are set to 250 mas. Please note this very well may not be a good theshold value. Further, the current threshold trigger may not be an optimum criterion for the demands to be sent to the PSFs.
    • Created a new class, TipTilt2PSF, used for communicating the tip/tilt values from PCS to PSFL/R as this allows a different thread to be used for the communication versus the fast loop computation.
    • Created both SX and DX temporary tip/tilt multiplicative factors (+/-1) in lbt.conf in order to be able to modify the tips and tilts on each telescope side separately during determination of signs of these values.
    • Offsets in DETXY are not yet supported in binocular mode.

PCS GUI

  • none.

Pointing Kernel / Pointing Kernel tools

  • none.

PMC - Primary Mirror Cell

  • PMC Version 5.11
    • Add build names to the startup event.
    • Support dynamic enable/disable of individual thermal sensors.
  • PMCGUI Version 5.10
    • Add build names to the 'about' box.
    • Make cell pressure on thermal form yellow if ECS is not running or blower is off.
    • Support dynamic enable/disable of individual thermal sensors.

PSF - Point Spread Function

  • PSF Version 4.50
    • Add build names to the startup event.
  • PSFGUI Version 4.30
    • Add build names to the 'about' box.

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

  • none.

reflectivememory - global shared memory

  • none.

rpc - communication protocol

  • Protect the RPC reConnect() method with the same mutex used in execute to allow multi-threading using a DispatcherRPC object (IssueTrak 2851).

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

  • Fix reading the lines in refmem.dat.

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.3
    • Correct help text for commands PresetTelescope and SetHotspot.

LBC - LBT Binocular Camera

  • none.

LBTO Weather Station - 3DWGUI

  • none.

MAT - Mount Axillary Telescope

  • none.

All Sky Monitor

  • none.

-- NormCushing - 06 Oct 2010

This topic: Software > WebHome > SWReleases > SWReleaseNotes2010 > SWRelBuildBP4
Topic revision: 19 Oct 2010, 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