.. _astroquery.nvas:

********************************
NVAS Queries (`astroquery.nvas`)
********************************

Getting started
===============

This module may be used to retrieve the NVAS VLA archive images. All images are
returned as a list of `~astropy.io.fits.HDUList` objects. Images may be
fetched by specifying directly an object name around which to search - in this
case the name will be resolved to coordinates by astropy name resolving methods
that use online services like SESAME. The search centre may also be entered as
a coordinate using any coordinate system from `astropy.coordinates`. ICRS
coordinates can also be entered directly as a string that conforms to the
format specified by `astropy.coordinates`. Some other parameters you may
optionally specify are the ``radius`` and the frequency band for which the image
must be fetched. You can also specify the maximum allowable noise level in mJy
via the ``max_rms`` keyword parameter. By default this is set to 10000 mJy

.. doctest-remote-data::

    >>> from astroquery.nvas import Nvas
    >>> import astropy.units as u
    >>> images = Nvas.get_images("3c 273", radius=2*u.arcsec, band="K", max_rms=500)  # doctest: +IGNORE_WARNINGS
    1 images found.
    >>> images      # doctest: +IGNORE_OUTPUT
    [[<astropy.io.fits.hdu.image.PrimaryHDU at 0x3376150>]]


The ``radius`` may be specified in any appropriate unit using a `~astropy.units.Quantity`
object. Apart from that it may also be entered as a string in a format
parsable by `~astropy.coordinates.Angle`. The frequency bands are specified
using the ``band`` keyword parameter. This defaults to a value of ``all`` - i.e all
the bands. Here's a list of the valid values that this parameter can take. ::

    "all", "L", "C", "X", "U", "K", "Q"

Let's look at an example that uses coordinates for specifying the search
centre.

.. doctest-remote-data::

    >>> from astroquery.nvas import Nvas
    >>> import astropy.coordinates as coord
    >>> import astropy.units as u
    >>> images = Nvas.get_images(coord.SkyCoord(49.489, -0.37,
    ...                          unit=(u.deg, u.deg), frame='galactic'), band="K")  # doctest: +IGNORE_WARNINGS
    2 images found.

You may also fetch UVfits files rather than the IMfits files which is the
default. To do this simply set the ``get_uvfits`` to ``True``, in any of the query
methods. You can also fetch the URLs to the downloadable images rather than the
actual images themselves. To do this use the
:meth:`~astroquery.nvas.NvasClass.get_image_list` which takes in all the same
arguments as :meth:`~astroquery.nvas.NvasClass.get_images` above except for the
``verbose`` argument which isn't relevant in this case.

.. doctest-remote-data::

    >>> from astroquery.nvas import Nvas
    >>> import astropy.coordinates as coord
    >>> import astropy.units as u
    >>> image_urls = Nvas.get_image_list("05h34m31.94s 22d00m52.2s",
    ...                               radius='0d0m0.6s', max_rms=500) # doctest: +IGNORE_WARNINGS
    >>> image_urls
    ['http://www.vla.nrao.edu/astro/archive/pipeline/position/J053431.5+220114/1.51I4.12_T75_1986AUG12_1_118.U3.06M.imfits',
     'http://www.vla.nrao.edu/astro/archive/pipeline/position/J053431.5+220114/1.51I3.92_T75_1986AUG20_1_373.U2.85M.imfits',
     'http://www.vla.nrao.edu/astro/archive/pipeline/position/J053431.5+220114/4.89I1.22_T75_1986AUG12_1_84.8U2.73M.imfits',
     'http://www.vla.nrao.edu/astro/archive/pipeline/position/J053431.9+220052/1.44I1.26_AH0336_1989FEB03_1_197.U8.29M.imfits',
     'http://www.vla.nrao.edu/astro/archive/pipeline/position/J053431.9+220052/1.44I1.32_AH0336_1989FEB03_1_263.U3.84M.imfits',
     'http://www.vla.nrao.edu/astro/archive/pipeline/position/J053431.9+220052/4.91I0.96_AH595_1996OCT14_1_41.3U2.45M.imfits',
     'http://www.vla.nrao.edu/astro/archive/pipeline/position/J053431.9+220052/4.91I0.89_AH595_1996OCT11_1_43.2U2.45M.imfits',
     'http://www.vla.nrao.edu/astro/archive/pipeline/position/J053431.9+220052/4.91I0.99_AH0595_1996OCT16_1_66.4U2.55M.imfits',
     'http://www.vla.nrao.edu/astro/archive/pipeline/position/J053431.9+220052/8.46I2.18_AM503_1996FEB23_1_243.U2.59M.imfits',
     'http://www.vla.nrao.edu/astro/archive/pipeline/position/J053431.9+220052/8.46I1.60_AM503_1996FEB01_1_483.U2.59M.imfits']


Troubleshooting
===============

If you are repeatedly getting failed queries, or bad/out-of-date results, try clearing your cache:

.. code-block:: python

    >>> from astroquery.nvas import Nvas
    >>> Nvas.clear_cache()

If this function is unavailable, upgrade your version of astroquery. 
The ``clear_cache`` function was introduced in version 0.4.7.dev8479.

     
Reference/API
=============

.. automodapi:: astroquery.nvas
    :no-inheritance-diagram:
