Software Release Notes for Build "BP14"

Release Date: Nov 25, 2011 Generic Release Name: BP14 Public Release Name: "Binocular Observing" release 14 General Description: 2nd release of non-sidereal presets with hot spot drift guiding

Telescope Operator Overview Information

• GCS now allows for a drifting hotspot in closed loop guiding by asking PCS in every cycle where the Guidestar SFP should be and translating this into a pixel drift, IT #2853 this new feature can be turned off by setting GCSL/R.driftingHotspot to false in gcs.conf (this will be checked in every guide cycle) if it turned out to be faulty.
• GCS configuration scheme has been completely overhauled which affects location and names of AGW configuration files. Please see the Commissioning Wiki entries for AGWStages and RunningGCS to get a full description of the new system.
• The IIFGUI has a new 'Status' form that shows subsystem activity for PresetTelescope and OffsetPointing commands.

Support Astronomer Overview Information

• PCS implemented two new methods, enableRBTipTilt() and applyRBTipTilt(), in support of the PSFs to provide the PCS with the tip/tilt requests which accomplish range balancing. The enableRBTipTilt() is intended for testing only; it enables/disables use of the PSF tip/tilt requests. The applyRBTipTilt() method is the routine invoked by the PSFs to deliver their tip/tilt requests to the PCS.
  • New Reflective Memory variables
    • pcs.side[0|1].optics.[tip|tilt]RB - PSF tip/tilt request to the PCS to accomplish range balancing (arcseconds)
    • pcs.useRBValues - Indicator to use or reject the PSF tip/tilt requests (Currently must use the pcsclient to enable/disable the PSF requests.)
• New PresetTelescope modes are supported for AO. They allow for transitioning to adaptive mode from modes other than ACTIVE, and if the AO loop is opened, the fallback will be to the simpler mode. ADAPTIVExxx can be used as aliases for ADAPTIVExxx_ACTIVE.
  • ADAPTIVETTM_TRACK, ADAPTIVETTM_GUIDE, ADAPTIVETTM_ACTIVE
  • ADAPTIVEACE_TRACK, ADAPTIVEACE_GUIDE, ADAPTIVEACE_ACTIVE
  • ADAPTIVEICE_TRACK, ADAPTIVEICE_GUIDE, ADAPTIVEICE_ACTIVE

The Details

Specific Tests that need to be performed with the Telescope

• Software Tests and Status

Patches to the Release

• none.

Known Bugs

• none.

Release Overview

• none.

IIF list of Public Data Dictionary Variables

• IIF Public Data Dictionary Variables compatible with this release.

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

tcs.conf

• none.

AGw control server

• none.

AOS - Adaptive Optics

• none.

ECS - Enclosure Control

• none.

ENV - Environmental Sensors

• ENV Version 1.11
  • Do not collect anemometer data. Do as little setup as possible in this case, but leave all the code in for now.
• ENVGUI Version 1.8
  • Do not display ENV anemometer data; instead display AOS anemometer data for both sides.

IIF - Instrument Interface

• IIF Version 8.13
  • Support ACQUIRE mode Offsets.
  • Support subsystem activity messages for Preset and Offset commands.
  • Remove PCS setGuidingSubsystem() calls as unneeded.
  • Make general changeMode event and remove specific events (i.e. trackMode, etc.).
  • Add cancelPreset event when a Preset is canceled.
  • Create method to generate 'friendly' mode names.
  • Support complex adaptive modes (IssueTrak 3738). Adaptive mode can now be reached from TRACK, GUIDE, or ACTIVE, instead of just ACTIVE. If the adaptive loop is opened, the fallback will be to the starting mode.
  • Add method to check for GCS focal stations.
  • Add spare bools in reflective memory.
  • Store hijack non-sidereal type in reflective memory for the GUI.
  • Improve debug output when reading the data dictionary.
  • Remove support for old 'csq' reflective memory names.
• IIFGUI Version 3.9
  • Display the effective (fallback) mode if it is different from the actual mode.
  • Add status form to display the subsystem activity for Preset and Offset commands.
  • Display non-sidereal type when non-sidereal override flag is set.
  • Display parallactic angle and airmass.

GCS - Guiding Control V2.6.0

• updated the AGW configuration files' WFS_redefine_hex_z settings as requested in IT# 3743
• autoSelectAGW() & setNewInstrument() do not return a warning state anymore if a FS/instrument combination has a NOAGW definition explicitly set, they still return a warning if it couldn't find a definition
• updated the AGW configuration files' WFS_redefine_hex_z settings as requested in IT# 3762 - which contradict some in #3743
• adding guidecam_maxExposure back into OSU_L.cfg as described in IT #3765
• added WFS_lenslet_rotation settings to AIP_R.cfg and AIP_IRTC_R.cfg (IT #3777)
• copied the AGW1_IRTC config files from the mountain and updated them in SVN (IT #3775)
• split the configuration files into public and private, private is where they used to be, public ones are in ~telescope/TCS/Configuration/GCS/
• moved the rotator definition from public into private config file and adapted WFS references to match this change
• moved the onAxis position definition from public into private config file
• converting agw-control machine name to IP and keep it internally to avoid numerous DNS lookups with oacontrol calls (IT #3772)
• updated WFS_pupil_dir_x/y to +1 in AO_IRTC_L.cfg as requested in IT #3775
• added AGW status info to show up in GUI that indicates initialization of probe, guide and WFS cams, so it shows in which state the GCS might hang if it does

LSS - Logging and Events

• none.

MCS / mcstemp - Mount Control

• none.

OSS - Optical Support

• none.

PCS - Pointing Control

• PCS_Version-6.16
  • Wavelength for all non-sidereal targets is as requested if within the valid range (0.3 - 15.0 microns). Otherwise, the wavelength is set to the value in the PCSInstrument.conf file for the specific instrument. Formerly, the default wavelength for non-sidereal targets was 0.55 microns, but the wavelength should not be treated specially just for non-sidereal targets.
  • Modified the updatePointingReference (absorb functionality) to handle non-sidereal targets and any binocular targets properly.
  • Modified the examination of the command return object from the PSF adjustPointing() method.
  • Implemented two new methods, enableRBTipTilt() and applyRBTipTilt(), in support of the PSFs to provide the PCS with the tip/tilt requests which accomplish range balancing. The enableRBTipTilt() is intended for testing only; it enables/disables use of the PSF tip/tilt requests. The applyRBTipTilt() method is the routine invoked by the PSFs to deliver their tip/tilt requests to the PCS.
    • New Reflective Memory variables
      • pcs.side[0|1].optics.[tip|tilt]RB - PSF tip/tilt request to the PCS to accomplish range balancing (arcseconds)
      • pcs.useRBValues - Indicator to use or reject the PSF tip/tilt requests
  • Ensure that regardless of when the PCS is started with respect to the MCSPU ("before" or "after" where "after" is typical), the PCS obtains the error codes for the four telescope axes as necessary.
  • Fixed a subtle bug which was revealed when using the Left, Rear, Bent Gregorian rotator. If the RPC communication with the MCSPU were to return an RPCERROR unexpectedly, instead of returning the rotator error code string of ten characters, actions performed on the RPCERROR string could crash the PCS. Patched on the mountain in BP13.
  • Fixed a bug in the linear interpolation routine which computes the target RA from the non-sidereal ephemeris. Specifically, the fix addresses the RA transition boundary 0<->23:59:59.
  • Fixed a bug in the binocular algorithm when neither telescope side is locked and one telescope roll is just less then pi and the other telescope roll is just greater than -pi.
  • Includes the patch to turn on the appropriate rotator indexing in order to generate rotator trajectories for the Left, Back, Bent Gregorian focal station. This change was checked into the BP13 branch and trunk.

PCS GUI

• none.

Pointing Kernel / Pointing Kernel tools

• none.

PMC - Primary Mirror Cell

• PMCGUI Version 5.17
  • Use frameGeometry class to get correct window widths and heights.

PSF - Point Spread Function

• PSF Version 5.2
  • Use new PCS method applyRBTipTilt() to send desired tip/tilts to the PCS.
• PSFGUI Version 4.36
  • Use frameGeometry class to get correct window widths and heights.

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

• Add underlying support for type 'bool'.

eventhandler - event handling

• none.

networkconfig - subsystem management

• Add SysLog messages for bad IP filters (IssueTrak 1195) in NetworkConfig.cpp.

reflectivememory - global shared memory

• none.

rpc - communication protocol

• none.

setvalue - reflective memory access

• Add underlying support for type 'bool'.

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 Motion Monitor

• none.

idl

• none.

iraf

• none.

IRTC - Infrared Test Camera

• IRTC Version 3.1
  • Improve help for OffsetPointing.
  • Add new adaptive modes to help for PresetTelescope.

LBC - LBT Binocular Camera

• none.

LBTO Weather Station - 3DWGUI

• none.

MAT - Mount Axilliary Telescope

• none.

All Sky Monitor

• none.

-- NormCushing - 24 Oct 2011