Basic Info
==========

------------
Installation
------------
The package can be installed through pip:

.. code-block:: python

    pip install AstroToolkit

---------------------
Important Information
---------------------
Two of the primary goals of ATK are interactivity and shareability. To this end, ATK makes extensive use of `Bokeh <https://bokeh.org/>`_ as its plotting library. This allows for all graphical representations to be stored as static HTML files which retain their interactive elements. An example of a plot generated by the package is shown below - try hovering over and clicking on the centres of the detection markers! Elements in all ATK plots (such as the Gaia/GALEX detections here) can be hidden by toggling them in the legend, and the legend itself can be hidden by double-clicking anywhere in the figure. 

.. raw:: html
    
    <div align="center"><embed src="../_static/image.html" width=100% height=450></embed></div>


Another key feature of ATK is proper motion correction, which is made possible by Gaia. There will be more on this later, but an example is already seen in the image above. Wolf 28, or van Maanen 2, is the closest known solitary white dwarf to our solar system, and hence has an extremely high proper motion of approximately 3 arcsec/yr. As a result, matching positional data to systems such as this one can quickly become a difficult task. By targeting Wolf 28 through Gaia (with an epoch of 2016), the above image displays the use of proper motion measurements from Gaia in the following ways:

- The image, which was taken in February 2012 by Pan-STARRS, has been focused on Wolf 28 despite the 4 year difference between the epochs of the image and Gaia (equating to a displacement of around 12 arcsec).

- Gaia's detection markers have been corrected for this displacement, correctly aligning them with their host systems.

- GALEX detection markers have also been corrected where possible, despite the survey not providing its own proper motion measurements.

- Clicking on the centres of any detection marker uses corrected coordinates to successfully find the host object in SIMBAD.

To make use of proper motion correction in ATK, systems must be targeted with a Gaia Source ID. Systems may also be targeted using standard J2000 celestial coordinates, however the application of proper motion correction will be severely limited in this case.