Metadata-Version: 2.1
Name: gsselect
Version: 1.3.2
Summary: Gemini guide star selection and URL target-of-opportunity (TOO) triggering
Home-page: https://github.com/bryanmiller/gsselect
Author: Bryan Miller
Author-email: millerwbryan@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Intended Audience :: Science/Research
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
License-File: LICENSE

# 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](https://www.gemini.edu/observing/phase-ii/useful-know#ToO).
The document [urltoo_readme.txt](https://github.com/bryanmiller/gsselect/blob/master/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](https://www.gemini.edu/observing/phase-ii/ot/ot-description/menu-bar#Keychain)
for more information on user keys and how to obtain one.



