gsselect 1.3.2

Gemini guide star selection and URL target-of-opportunity (TOO) triggering

GSselect

This repository provides a python example of using the Gemini Observatory API for triggering template observations that are On Hold. Details of the ToO activation process are given here. The document urltoo_readme.txt give more details about the API.

The example triggering script is urltrigger.py but most of the code is for selecting a guide star. The triggering API does not support the new automated guide star selection features in the Observing Tool. The script gsselect.py mimics these features and should find an appropriate guide star if one is available in the UCAC4 catalog. It can also display the guide star candidates and the wavefront sensor field of view on a DDS image of the field.

Gsselect also has a 'find' position angle (PA) feature that we never implemented in the OT. This will pick the best guide star available and set the PA so that it is reachable. This is useful with the GMOS and F2 OIWFS guide probes if the PA is unimportant.

Installation

The scripts require a standard Python distribution that includes numpy (at least 1.15.4), matplotlib, astropy, and requests.

Then install the scripts by downloading and unpacking the zip file or use git, e.g.

git clone https://github.com/bryanmiller/gsselect.git

The gsselect guide star selection routines can also be installed as a pip package with

pip install gsselect

Authentication

Authentication for the trigger requires a 'user key' for the Observing Tool that is associated with an email address that is included in the active program. See this page for more information on user keys and how to obtain one.