Metadata-Version: 2.1
Name: gsselect
Version: 1.0.4
Summary: Gemini guide star selection and URL 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
Requires-Dist: astropy
Requires-Dist: matplotlib
Requires-Dist: numpy
Requires-Dist: aplpy

# 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/sciops/observing-gemini/phase-ii-and-s/w-tools/too-activation).
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. As of November 2018 guide 
stars are still required with the trigger and the 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. 

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, requests, and [aplpy](http://aplpy.github.io). 

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

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

## 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/sciops/observing-gemini/phase-ii-and-s/w-tools/observing-tool/science-program-editor/keychain-manage)
for more information on user keys and how to obtain one.



