.. DO NOT EDIT. .. THIS FILE WAS AUTOMATICALLY GENERATED BY SPHINX-GALLERY. .. TO MAKE CHANGES, EDIT THE SOURCE PYTHON FILE: .. "auto_tutorials/images/image_query_2.py" .. LINE NUMBERS ARE GIVEN BELOW. .. only:: html .. note:: :class: sphx-glr-download-link-note :ref:`Go to the end ` to download the full example code. .. rst-class:: sphx-glr-example-title .. _sphx_glr_auto_tutorials_images_image_query_2.py: ################## Detection Overlays ################## To aid the matching of positional data, image queries support detection overlays. .. note:: By default, detection overlays are configured for the following Vizier catalogues: .. include:: ../getting_started/supported_aliases.rst A tutorial on defining detection overlays for any Vizier catalogue can be found :doc:`here <../extension/vizier>`. | | Requesting an Overlay ===================== An overlay can be requested by passing ``overlays`` to :func:`~ATK.Tools.query` with a list of surveys: .. GENERATED FROM PYTHON SOURCE LINES 22-28 .. code-block:: Python from ATK import query ps_query = query("image", targets=2552928187080872832, survey="panstarrs", band="g", size=120, overlays=["galex"], path="example_image_2.fits.gz") ps_query.open() .. raw:: html
Bokeh Figure


.. GENERATED FROM PYTHON SOURCE LINES 44-54 As with all figure elements, overlayed **detections can be hidden by clicking them in the legend**. Hovering over a detection displays its key parameters (e.g. its position and magnitude), and **clicking a detection searches for the object in SIMBAD**. Detections are corrected for proper motion where possible, as stated by the ``corrected`` flag. **Non-gaia detections are also corrected by crossmatching them with corresponding Gaia detections**. The GALEX data that was found for van Maanen's Star from the :doc:`previous section <../getting_started/data_query>` is a match! | | Overlay Configuration ===================== By default, a detection overlay uses whichever band is listed first in the catalogue's overlay definition (see :doc:`here <../extension/vizier>`). If a different band is required, or perhaps multiple bands from the same catalogue need to be overlayed simultaneously, ``overlays`` can instead be passed as a ``dict``: .. GENERATED FROM PYTHON SOURCE LINES 55-67 .. code-block:: Python ps_query = query( "image", targets=2552928187080872832, survey="panstarrs", band="g", size=120, overlays={"galex": ["NUVmag", "FUVmag"]}, path="example_image_4.fits.gz", ) ps_query.open() .. raw:: html
Bokeh Figure


.. GENERATED FROM PYTHON SOURCE LINES 77-80 .. note:: Where possible, detection markers are scaled in size by magnitude. Markers labelled ``galex detection`` in the above image are detections that had an invalid magnitude, and hence could not be scaled. .. GENERATED FROM PYTHON SOURCE LINES 82-87 | | | .. rubric:: Download this Tutorial .. rst-class:: sphx-glr-timing **Total running time of the script:** (0 minutes 0.846 seconds) .. _sphx_glr_download_auto_tutorials_images_image_query_2.py: .. only:: html .. container:: sphx-glr-footer sphx-glr-footer-example .. container:: sphx-glr-download sphx-glr-download-jupyter :download:`Download Jupyter notebook: image_query_2.ipynb ` .. container:: sphx-glr-download sphx-glr-download-python :download:`Download Python source code: image_query_2.py ` .. container:: sphx-glr-download sphx-glr-download-zip :download:`Download zipped: image_query_2.zip ` .. only:: html .. rst-class:: sphx-glr-signature `Gallery generated by Sphinx-Gallery `_