Metadata-Version: 2.1
Name: gsselect
Version: 1.3.0
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
Description: # 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.
        
        
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
