IDL Commands for presets and offsets

HINT

If ever a routine returns an error, type the command
IDL> retall

This command clears IDL back to its original state.

Monocular Operation

Preset

The following steps will preset the telescope in monocular mode.

Note: In monocular mode the GCS guide corrections are applied to the PCS pointing.

Before the step listed below are executed the telescope operator must Authorize the appropriate Instrument/Focal Station combination via the IIF GUI.

The steps are:
  1. Start IDL.
  2. Register the IDL process with the IIF - selecting the currently authorized instrument.
  3. Send the preset telescope request to IIF and Wait for it to complete.
  4. If preset is Active, then Wait for the Active Optics to reduce the wavefront error to < 1000 nm rms (see GCS GUIs).
  5. Request AO Loop to close.

The commands for a monocular preset are:
  1. % idl
  2. IDL> iif_register, /TCS
  3. IDL> iif_preset, BS9177, MODE=ACE, GS=10, RS=0, PA=-90
  4. Wait for Active Optics collimation to < 1000 nm rms (see GCS GUI)
  5. IDL> iif_runao

Offset

  1. iif_offset, 1, 5

Binocular Operation

Preset

Synchronous Presets Both Sides

The following steps will preset the telescope in fully binocular mode with the possibility of different types of preset (eg. TRACK or ACTIVE or ACE, etc) with different instrument and focal stations on the two sides (eg. LBTI@LCBG and IRTC@RFBG).

Note: If the targets on the two side are not the same, but PCS points the telescope about half way between the two targets and the difference is applied by pointing the optics on each side.

Note: In binocular mode the GCS guide corrections are applied to each side separately by moving optics.

_Does the TCS automatically fold the pointing corrections from both side back to the telescope pointing (balancing)?
Yes, the optics corrections are balanced with the mount whenever new syncronized presets or offsets are sent, and/or if leaking is enabled for both of the authorized instruments._

Before the steps listed below are executed, the telescope operator must Authorize the appropriate Instrument/Focal Station combinations on both sides of the telescope via the IIF GUI.

The steps are:
  1. Start the IDL process.
  2. Register the IDL process with the IIF - selecting the currently authorized instruments.
  3. Set the parameters for the presets on LEFT and RIGHT.
  4. Send the binocular preset request to IIF and Wait for it to complete. Many commands are sent to the IIF, but the ones that make the presets Synchronous are the Binocular Control SYNCPRESET sent to both sides. A PresetTelescope must then be sent to both sides before the telescope moves and the presets are process on both sides.
  5. If preset is Active, then Wait for the Active Optics to reduce the wavefront error to < 1000 nm rms (see GCS GUIs)
  6. Request AO Loop to close on both sides.

The commands for a binocular preset are:
  1. % idl
  2. IDL> iif_register, /TCS
  3. (Set the preset parameters for both sides)
    • Same preset on both sides
      • IDL> iif_preset, BS9177, MODE=ACE, GS=10, RS=0, PA=90, /BOTH
    • Different presets on the two sides
      • IDL> iif_preset, BS9177, MODE=ACE, GS=10, RS=0, PA=-90, /RIGHT
      • IDL> iif_preset, BS9177, MODE=ACE, GS=20, RS=0, PA=90, /LEFT
  4. (Send the synchronized presets)
    • IDL> iif_binoc_preset
  5. Wait for Active Optics collimation to < 1000 nm rms (see GCS GUIs)
  6. Close AO Loop (Send runAO to both sides)
    • IDL> iif_binoc_runao

Asynchronous Preset: Both Sides

Asynchronous presets to move the telescope to a new position in binocular operation are not support in these IDL routines. To move the telescope with a preset to only one side the IIF must receive a BinocularControl ASYNCPRESET command and then a preset to only one side will be executed. Once this preset has completed another asynchronous preset can be executed on the other side to complete the binocular preset.

In these IDL routines a synchronous preset must be request to move the telescope to the next object.

Asynchronous Preset: One Side

If a preset on one side fails for some reason during a binocular preset, or the preset is cancelled during operation (e.g. lost guide star, AO loop open, etc) it is possible re-send a preset to only one side. The other side will remain in its current state.

The steps are:
  1. IDL> iif_preset, /RIGHT
  2. Wait for Active Optics collimation to < 1000 nm rms (see GCS GUI)
  3. IDL> iif_runao, /RIGHT

You can change the preset parameters and resend this asynchronous preset. The target must be within the pointing limits for binocular operation (<20" ?).

  1. IDL> iif_preset, BS9177, MODE=ACE, GS=5, RS=0, PA=-45, /RIGHT
  2. IDL> iif_preset, /RIGHT
  3. Wait for Active Optics collimation to < 1000 nm rms (see GCS GUI)
  4. IDL> iif_runao, /RIGHT

Offset

Synchronous Offset: Both Side

To offset the telescope on both sides a synchronous offset should be used. Similar to the synchronous offset the synchronous offset uses the request BinocularControl SYNCOFFET to indicate the IIF should wait for an offset request for both side before making the offset. The offsets do not need to be the same on the two sides, but the final positions of the two sides must be within the pointing limit of 40".

When any type of offset is executed the mount pointing position is modified to be half way between the positions of the two sides.

Asynchronous Offset: One Side

It is possible to offset just one side of the telescope while in binocular operation. In this case the offset is accomplished by moving the optics on the requested side. Offset of less than 20" are possible. If a larger one sided offset is request the IIF will return an error and no action will be taken (i.e. the telescope will remain at the same position and in the same state for both sides).

When any type of offset is executed the mount pointing position is modified to be half way between the positions of the two sides.

The steps are:
  1. IDL> iif_offset, 1.0, -10.0, /RIGHT
  2. IDL> iif_offset, /RIGHT

Note: offsets requested are absolute mode and in the detector coordinates. Thus, iif_offset, 0.0, 0.0, /RIGHT will return the telescope to the original position. (PISCES detector is rotated by 90 deg from normal DETXY coordinates.)

Additional Flags

Most of the commands above also accept the /DEBUG flag for more verbose output. The /TEST flag can be specified to run the command without actually moving the telescope.

Successful examples with PISCES@RFBG and LBTI@LCBG on 20131017

# Start IDL -- Comments are in Red
lbto@obs2:3 % idl
IDL Version 8.1 (linux x86 m32). (c) 2011, ITT Visual Information Solutions
Installation number: 223182.
Licensed for use by: LBTO-University of Arizona

% LOADCT: Loading table RED TEMPERATURE
  => Log file: /tmp/idl_lbto.log

**********************************************
*
*  => LEFT Focal Station LFBG: LUCI1
*
**********************************************


**********************************************
*
*  => RIGHT Focal Station RFBG: IRTC2
*
**********************************************

  => Using catalogs in /lbt/catalogs
  => Using catalogs in /home/lbto/idl/catalogs

# Register with TCS/IIF as the currently authorized instruments
IDL> iif_register,/TCS

**********************************************
*
*  => LEFT Focal Station LCBG: LLBTI
*
**********************************************

# Set the preset parameters: ACQUIRE on the RIGHT, ACE on the LEFT
IDL> iif_preset, SDT_HR8799, MODE=ACQUIRE, GS=0, RS=0, PA=20, /RIGHT
IDL> iif_preset, SDT_HR8799, MODE=ACE, ROT=ADI, GS=0, RS=0, /LEFT

# Send the Syncronized binocular presets
IDL> iif_binoc_preset

         # Target star: 0   SDT_HR8799
           23:07:28.647 +21:08:03.73 RADEC 2000.0 J2000 107.9 -49.6 5.80 R 0.00 B_V 1.65
         # Guide star: 0
           23:07:28.647 +21:08:03.73 RADEC 2000.0 J2000 107.9 -49.6 5.80 R 0.00 B_V 0.63
         # AO Reference star: 0
           23:07:28.647 +21:08:03.73 RADEC 2000.0 J2000 107.9 -49.6 5.80 R 0.00 B_V 1.65

     IRCL&: preset, SDT_HR8799, MODE=ADAPTIVEACE_TRACK, GS=0, RS=0, ROTMODE=PARALLACTIC, PA=0.00000     (iif_preset)

         # Target star: 0   SDT_HR8799
           23:07:28.647 +21:08:03.73 RADEC 2000.0 J2000 107.9 -49.6 5.80 R 0.00 B_V 1.65
         # Guide star: 0
           23:07:28.647 +21:08:03.73 RADEC 2000.0 J2000 107.9 -49.6 5.80 R 0.00 B_V 0.63

      IRCR: preset, SDT_HR8799, MODE=ACQUIRE, GS=0, RS=0, PA=20.0000     (iif_preset)

# Send an asyncronous ACTIVE preset on the RIGHT
IDL> iif_preset, SDT_HR8799, MODE=ACTIVE, GS=1, RS=0, PA=-40, /RIGHT
IDL> iif_preset, /RIGHT

         # Target star: 0   SDT_HR8799
           23:07:28.647 +21:08:03.73 RADEC 2000.0 J2000 107.9 -49.6 5.80 R 0.00 B_V 1.65
         # Guide star: 1
           23:07:18.9486 +21:09:29.313 RADEC 2000.0 J2000 -14.0 -0.4 15.40 R 1.08 B_V 0.63

      IRCR: preset, SDT_HR8799, MODE=ACTIVE, GS=1, RS=0, PA=-40.0000     (iif_preset)

# Send an ACE preset on the RIGHT
IDL> iif_preset, SDT_HR8799, MODE=ACE, GS=1, RS=0, PA=-40, /RIGHT
IDL> iif_preset, /RIGHT

         # Target star: 0   SDT_HR8799
           23:07:28.647 +21:08:03.73 RADEC 2000.0 J2000 107.9 -49.6 5.80 R 0.00 B_V 1.65
         # Guide star: 1
           23:07:18.9486 +21:09:29.313 RADEC 2000.0 J2000 -14.0 -0.4 15.40 R 1.08 B_V 0.63
         # AO Reference star: 0
           23:07:28.647 +21:08:03.73 RADEC 2000.0 J2000 107.9 -49.6 5.80 R 0.00 B_V 1.65

      IRCR: preset, SDT_HR8799, MODE=ADAPTIVEACE_ACTIVE, GS=1, RS=0, PA=-40.0000     (iif_preset)

# Send the RUNAO command on the RIGHT
IDL> iif_runao,/RIGHT

# Send an ADI preset on the RIGHT
IDL> iif_preset, SDT_HR8799, MODE=ACE, GS=1, RS=0, ROT=ADI, /RIGHT
IDL> iif_preset, /RIGHT

         # Target star: 0   SDT_HR8799
           23:07:28.647 +21:08:03.73 RADEC 2000.0 J2000 107.9 -49.6 5.80 R 0.00 B_V 1.65
         # Guide star: 1
           23:07:18.9486 +21:09:29.313 RADEC 2000.0 J2000 -14.0 -0.4 15.40 R 1.08 B_V 0.63
         # AO Reference star: 0
           23:07:28.647 +21:08:03.73 RADEC 2000.0 J2000 107.9 -49.6 5.80 R 0.00 B_V 1.65

      IRCR: preset, SDT_HR8799, MODE=ADAPTIVEACE_TRACK, GS=1, RS=0, ROTMODE=PARALLACTIC, PA=0.00000     (iif_preset)

IDL> iif_runao,/RIGHT

One-Sided Binocular Operation

Before the steps listed below are executed, the telescope operator must Authorize the appropriate Instrument/Focal Station combinations on both sides of the telescope via the IIF GUI.

The steps are:
  1. Start the IDL process.
  2. Register the IDL process with the IIF - selecting the currently authorized instruments only on the side you specified.

The commands for a binocular preset are:
  1. % idl
  2. IDL> iif_register, /RIGHT

One-Sided Binocular Operation on the Passive side of PseudoMonocular Mode

Before the steps listed below are executed, the telescope operator must Authorize the appropriate Instrument/Focal Station combinations on both sides of the telescope via the IIF GUI.

The steps are:
  1. Start the IDL process.
  2. Register the IDL process with the IIF - selecting the currently authorized instruments only on the side you specified.

The commands for a binocular offset are:
  1. % idl
  2. IDL> station_set, RBBG
  3. IDL> iif_register, /RIGHT

Preset with an Off-Axis star as the Target Star

Sometimes it is desirable to use an off-axis guide star as the target star rather than the central star the catalog was built around. An example is to point at a star nearby a very bright star. Specifically, the stars used by the DIMM are too bright for Active and Adaptive Optics, but the catalogs are built with the bright DIMM star as the target (i.e. GS=0).

For example, the DIMM star Dimm_69DelUMa:

  • Dimm_69DelUMa Finder Chart:
    Dimm_69DelUMa.jpg

To send an ACE preset with guide star = 1 on-axis (i.e. the AO Reference star) and the Active Optics guide star = 4, the IDL preset would look like:
IDL> iif_register, /TCS
IDL> iif_preset, Dimm_69DelUMa, MODE=ACE, TS=1, RS=1, GS=4, PA=180

Process historical WFSC image

This command is useful to process the request WFSC image, say from /Repository, display the WFSC image and show a side by side comparison of the GCS calculate incremental values and the final calculated Zernikes.

The steps are:
  1. Start IDL.
  2. Register the IDL process with the IIF - LFBG, RFBG, LDG, RDG, etc
  3. Execute the wfsc processing routine

The commands for a monocular preset are:
  1. % idl
  2. IDL> iif_register, LFBG
  3. IDL> wfsc_process_file, "/Repository/20180914/GCS/left_wfscimage000050.fits"
  4. or
  5. IDL> wfsc_process_file, "left_wfscimage000050.fits" (if the file is in you present-working-directory)

-- DougMiller - 15 Oct 2013
Topic attachments
I Attachment Action Size Date Who Comment
Dimm_69DelUMa.jpgjpg Dimm_69DelUMa.jpg manage 116 K 09 Apr 2014 - 04:29 DougMiller Dimm_69DelUMa Finder Chart
Topic revision: r20 - 15 Dec 2020, JohnHill
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