gpilib User’s Guide¶
This documentation describes how to align, calibrate and use GPI’s AO system and how to interact with GPI via IDL commands and scripting.
This is done using the gpilib IDL library.
Procedures in this library provide the ability to
control the instrument, automatically do sequences of tasks
that calibrate and align it, and also execute verification
tests of both fundamental operation and top-level requirements.
This library also contains many useful analysis tools for data and telemetry
collected by the AO system, and can be used for analysis tasks independently of GPI.
Below you will find detailed descriptions of the high-level
tasks as well as detailed information (from headers)
for all gpilib procedures.
Warning
Work in continuous progress
Contents¶
- Quick Start Guide
- gpilib Overview, Installation and Setup
- gpilib at Gemini
- AO telemetry
- Calibrations and Defaults
- System Alignment
- An Annotated Guide to ‘ult_sysalign,/guide’
- Set the AO I Magnitude
- Set the CAL H Magnitude
- Select your light source
- Select your attenuation
- Autoselect LQG
- (Optional) Power on the supercontinuum source, if off
- (Optional) Power on AO devices, if off.
- (Optional) You do not seem to have run start_us_up yet. Should I do so now?
- Configuring the AO system
- Activate open loop models
- Spatial filter, Apodizer, and DAR setup
- AO PnCs to previous last best centering
- Do you want to get new AO WFS darks?
- MEMS rotation check
- Closed Loop Focus Offset
- Do you want to align the MEMS to the AOWFS?
- Do you want to use the IS alignment (if No use IDL) ([Yes]/No)?
- Do you want to check the spatial filter alignment? ([Yes]/No)?
- Do you want to get new DM flats? ([No]/Yes)?
- Tip-Tilt Vibration measurement
- You are now aligned up through the CAL. Do you want to stop here?
- Select an Observation Mode
- Do you want to take new CAL darks?
- Check apodizer and Lyot alignments
- Center the pinhole?
- Take IFS Image
- System alignment complete
- Next Steps
- Top-level troubleshooting
- AOC Subsystem
- Top Level Control
- Speckle Nulling
- VNC Setup and Connecting
Using IDL Code Blocks¶
This documentation contains numerous IDL code blocks. For clarity, these include the IDL prompt and (occasionally) outputs.
You can toggle these on and off in order to cut and paste directly to an IDL
session by clicking the IDL> button in the upper right-hand corner
of each block, as in the example below:
IDL> an idl command some IDL output IDL> another idl command some more IDL output
Credits¶
gpilib is written by Lisa Poyneer, Bruce Macintosh, Sandrine
Thomas, Dmitry Savransky with contributions from Don Gavel, Patrick
Ingraham, Naru Sadakuni and the GPI integration and testing team.
Documentation by Lisa Poyneer, Sandrine Thomas, Dmitry Savransky, and Marshall Perrin.
Portions of this documentation were written under the auspices of the U.S. Department of Energy by Lawrence Livermore National Laboratory under Contract DE-AC52-07NA27344. LLNL-SM-639818.
