UkidssClass

class astroquery.ukidss.UkidssClass(*, username=None, password=None, community=None, database='UKIDSSDR11PLUS', programme_id='all')[source]

Bases: BaseWFAUClass

The UKIDSSQuery class. Must instantiate this class in order to make any queries. Allows registered users to login, but defaults to using the public UKIDSS data sets.

The BaseWFAUClass __init__ is meant to be overwritten

Attributes Summary

ARCHIVE_URL

BASE_URL

CROSSID_FORM

CROSSID_URL

IMAGE_FORM

IMAGE_URL

LOGIN_URL

REGION_URL

TIMEOUT

all_databases

archive

cache_location

filters

frame_types

programmes_long

programmes_short

Methods Summary

__call__(*args, **kwargs)

init a fresh copy of self

authenticated()

clear_cache()

Removes all cache files.

extract_urls(html_in)

Helper function that uses regexps to extract the image urls from the given HTML.

get_image_list(coordinates, *[, waveband, ...])

Function that returns a list of urls from which to download the FITS images.

get_images(coordinates, *[, waveband, ...])

Get an image around a target/ coordinates from a WFAU catalog.

get_images_async(coordinates, *[, waveband, ...])

Serves the same purpose as get_images but returns a list of file handlers to remote files.

list_catalogs(*[, style])

Returns a list of available catalogs in WFAU.

list_databases()

List the databases available from the WFAU archive.

logged_in()

Determine whether currently logged in.

login(username, password, community)

Login to non-public data as a known user.

query_cross_id(*args, **kwargs)

See query_cross_id_async

query_cross_id_async(coordinates, *[, ...])

Query the crossID server

query_region(coordinates, *[, radius, ...])

Used to query a region around a known identifier or given coordinates from the catalog.

query_region_async(coordinates, *[, radius, ...])

Serves the same purpose as query_region.

reset_cache_location()

Resets the cache location to the default astropy cache

Attributes Documentation

ARCHIVE_URL = 'http://surveys.roe.ac.uk:8080/wsa/ImageList'
BASE_URL = 'http://surveys.roe.ac.uk:8080/wsa/'
CROSSID_FORM = 'crossID_form.jsp'
CROSSID_URL = 'http://surveys.roe.ac.uk:8080/wsa/CrossID'
IMAGE_FORM = 'getImage_form.jsp'
IMAGE_URL = 'http://surveys.roe.ac.uk:8080/wsa/GetImage'
LOGIN_URL = 'http://surveys.roe.ac.uk:8080/wsa/DBLogin'
REGION_URL = 'http://surveys.roe.ac.uk:8080/wsa/WSASQL'
TIMEOUT = 30
all_databases = ('UKIDSSDR11PLUS', 'UKIDSSDR10PLUS', 'UKIDSSDR9PLUS', 'UKIDSSDR8PLUS', 'UKIDSSDR7PLUS', 'UKIDSSDR6PLUS', 'UKIDSSDR5PLUS', 'UKIDSSDR4PLUS', 'UKIDSSDR3PLUS', 'UKIDSSDR2PLUS', 'UKIDSSDR1PLUS', 'UKIDSSDR1', 'UKIDSSEDRPLUS', 'UKIDSSEDR', 'UKIDSSSV', 'WFCAMCAL08B', 'U09B8v20120403', 'U09B8v20100414')
archive = None
cache_location
filters = {'Br': 7, 'H': 4, 'H2': 6, 'J': 3, 'K': 5, 'Y': 2, 'Z': 1, 'all': 'all'}
frame_types = {'all': 'all', 'confidence': 'conf', 'deep_stack': 'deep%stack', 'difference': 'diff', 'interleave': 'leav', 'leavstack': 'leavstack', 'normal': 'normal', 'stack': 'stack'}
programmes_long = {'Deep Extragalactic Survey': 104, 'Galactic Clusters Survey': 103, 'Galactic Plane Survey': 102, 'Large Area Survey': 101, 'Ultra Deep Survey': 105}
programmes_short = {'DXS': 104, 'GCS': 103, 'GPS': 102, 'LAS': 101, 'UDS': 105}

Methods Documentation

__call__(*args, **kwargs)

init a fresh copy of self

authenticated()
clear_cache()

Removes all cache files.

extract_urls(html_in)

Helper function that uses regexps to extract the image urls from the given HTML.

Parameters:
html_instr

source from which the urls are to be extracted.

Returns:
linkslist

The list of URLS extracted from the input.

get_image_list(coordinates, *, waveband='all', frame_type='stack', image_width=<Quantity 1. arcmin>, image_height=None, radius=None, database=None, programme_id=None, get_query_payload=False)

Function that returns a list of urls from which to download the FITS images.

Parameters:
coordinatesstr or astropy.coordinates object

The target around which to search. It may be specified as a string in which case it is resolved using online services or as the appropriate astropy.coordinates object. ICRS coordinates may also be entered as strings as specified in the astropy.coordinates module.

wavebandstr

The color filter to download. Must be one of 'all', 'J', 'H', 'K', 'H2', 'Z', 'Y', 'Br'].

frame_typestr

The type of image. Must be one of 'stack', 'normal', 'interleave', 'deep_stack', 'confidence', 'difference', 'leavstack', 'all']

image_widthstr or Quantity object, optional

The image size (along X). Cannot exceed 15 arcmin. If missing, defaults to 1 arcmin.

image_heightstr or Quantity object, optional

The image size (along Y). Cannot exceed 90 arcmin. If missing, same as image_width.

radiusstr or Quantity object, optional

The string must be parsable by Angle. The appropriate Quantity object from astropy.units may also be used. When missing only image around the given position rather than multi-frames are retrieved.

programme_idstr

The survey or programme in which to search for. See list_catalogs.

databasestr

The WFAU database to use.

verbosebool

Defaults to True. When True prints additional messages.

get_query_payloadbool, optional

If True then returns the dictionary sent as the HTTP request. Defaults to False.

Returns:
url_listlist of image urls
get_images(coordinates, *, waveband='all', frame_type='stack', image_width=<Quantity 1. arcmin>, image_height=None, radius=None, database=None, programme_id=None, verbose=True, get_query_payload=False, show_progress=True)

Get an image around a target/ coordinates from a WFAU catalog.

Parameters:
coordinatesstr or astropy.coordinates object

The target around which to search. It may be specified as a string in which case it is resolved using online services or as the appropriate astropy.coordinates object. ICRS coordinates may also be entered as strings as specified in the astropy.coordinates module.

wavebandstr

The color filter to download. Must be one of 'all', 'J', 'H', 'K', 'H2', 'Z', 'Y', 'Br'].

frame_typestr

The type of image. Must be one of 'stack', 'normal', 'interleave', 'deep_stack', 'confidence', 'difference', 'leavstack', 'all']

image_widthstr or Quantity object, optional

The image size (along X). Cannot exceed 15 arcmin. If missing, defaults to 1 arcmin.

image_heightstr or Quantity object, optional

The image size (along Y). Cannot exceed 90 arcmin. If missing, same as image_width.

radiusstr or Quantity object, optional

The string must be parsable by Angle. The appropriate Quantity object from astropy.units may also be used. When missing only image around the given position rather than multi-frames are retrieved.

programme_idstr

The survey or programme in which to search for.

databasestr

The WFAU database to use.

verbosebool

Defaults to True. When True prints additional messages.

get_query_payloadbool, optional

If True then returns the dictionary sent as the HTTP request. Defaults to False.

Returns:
listA list of HDUList objects.
get_images_async(coordinates, *, waveband='all', frame_type='stack', image_width=<Quantity 1. arcmin>, image_height=None, radius=None, database=None, programme_id=None, verbose=True, get_query_payload=False, show_progress=True)

Serves the same purpose as get_images but returns a list of file handlers to remote files.

Parameters:
coordinatesstr or astropy.coordinates object

The target around which to search. It may be specified as a string in which case it is resolved using online services or as the appropriate astropy.coordinates object. ICRS coordinates may also be entered as strings as specified in the astropy.coordinates module.

wavebandstr

The color filter to download. Must be one of 'all', 'J', 'H', 'K', 'H2', 'Z', 'Y', 'Br'].

frame_typestr

The type of image. Must be one of 'stack', 'normal', 'interleave', 'deep_stack', 'confidence', 'difference', 'leavstack', 'all']

image_widthstr or Quantity object, optional

The image size (along X). Cannot exceed 15 arcmin. If missing, defaults to 1 arcmin.

image_heightstr or Quantity object, optional

The image size (along Y). Cannot exceed 90 arcmin. If missing, same as image_width.

radiusstr or Quantity object, optional

The string must be parsable by Angle. The appropriate Quantity object from astropy.units may also be used. When missing only image around the given position rather than multi-frames are retrieved.

programme_idstr

The survey or programme in which to search for. See list_catalogs.

databasestr

The WFAU database to use.

verbosebool

Defaults to True. When True prints additional messages.

get_query_payloadbool, optional

If True then returns the dictionary sent as the HTTP request. Defaults to False.

Returns:
listlist

A list of context-managers that yield readable file-like objects.

list_catalogs(*, style='short')

Returns a list of available catalogs in WFAU. These can be used as programme_id in queries.

Parameters:
stylestr, optional

Must be one of 'short', 'long'. Defaults to 'short'. Determines whether to print long names or abbreviations for catalogs.

Returns:
listlist containing catalog name strings in long or short style.
list_databases()

List the databases available from the WFAU archive.

logged_in()

Determine whether currently logged in.

login(username, password, community)

Login to non-public data as a known user.

Parameters:
usernamestr
passwordstr
communitystr
query_cross_id(*args, **kwargs)

See query_cross_id_async

query_cross_id_async(coordinates, *, radius=<Quantity 1. arcsec>, programme_id=None, database=None, table='source', constraints='', attributes='default', pairing='all', system='J2000', get_query_payload=False)

Query the crossID server

Parameters:
coordinatesastropy.SkyCoord

An array of one or more astropy SkyCoord objects specifying the objects to crossmatch against.

radiusstr or Quantity object, optional

The string must be parsable by Angle. The appropriate Quantity object from astropy.units may also be used. When missing defaults to 1 arcsec.

programme_idstr

The survey or programme in which to search for. See list_catalogs.

databasestr

The WFAU database to use.

tablestr

The table ID, one of: “source”, “detection”, “synopticSource”

constraintsstr

SQL constraints. If ‘source’ is selected, this will be expanded automatically

attributesstr

Additional attributes to select from the table. See, e.g., http://horus.roe.ac.uk/vsa/crossID_notes.html

system‘J2000’ or ‘Galactic’

The system in which to perform the query. Can affect the output data columns.

get_query_payloadbool, optional

If True then returns the dictionary sent as the HTTP request. Defaults to False.

query_region(coordinates, *, radius=<Quantity 1. arcmin>, programme_id=None, database=None, verbose=False, get_query_payload=False, system='J2000', attributes=['default'], constraints='')

Used to query a region around a known identifier or given coordinates from the catalog.

Parameters:
coordinatesstr or astropy.coordinates object

The target around which to search. It may be specified as a string in which case it is resolved using online services or as the appropriate astropy.coordinates object. ICRS coordinates may also be entered as strings as specified in the astropy.coordinates module.

radiusstr or Quantity object, optional

The string must be parsable by Angle. The appropriate Quantity object from astropy.units may also be used. When missing defaults to 1 arcmin. Cannot exceed 90 arcmin.

programme_idstr

The survey or programme in which to search for. See list_catalogs.

databasestr

The WFAU database to use.

verbosebool, optional.

When set to True displays warnings if the returned VOTable does not conform to the standard. Defaults to False.

get_query_payloadbool, optional

If True then returns the dictionary sent as the HTTP request. Defaults to False.

system‘J2000’ or ‘Galactic’

The system in which to perform the query. Can affect the output data columns.

attributeslist, optional.

Attributes to select from the table. See, e.g., http://horus.roe.ac.uk/vsa/crossID_notes.html

constraintsstr, optional

SQL constraints to the search. Default is empty (no constrains applied).

Returns:
resultTable

Query result table.

query_region_async(coordinates, *, radius=<Quantity 1. arcmin>, programme_id=None, database=None, get_query_payload=False, system='J2000', attributes=['default'], constraints='')

Serves the same purpose as query_region. But returns the raw HTTP response rather than the parsed result.

Parameters:
coordinatesstr or astropy.coordinates object

The target around which to search. It may be specified as a string in which case it is resolved using online services or as the appropriate astropy.coordinates object. ICRS coordinates may also be entered as strings as specified in the astropy.coordinates module.

radiusstr or Quantity object, optional

The string must be parsable by Angle. The appropriate Quantity object from astropy.units may also be used. When missing defaults to 1 arcmin. Cannot exceed 90 arcmin.

programme_idstr

The survey or programme in which to search for. See list_catalogs.

databasestr

The WFAU database to use.

get_query_payloadbool, optional

If True then returns the dictionary sent as the HTTP request. Defaults to False.

attributeslist, optional.

Attributes to select from the table. See, e.g., http://horus.roe.ac.uk/vsa/crossID_notes.html

constraintsstr, optional

SQL constraints to the search. Default is empty (no constrains applied).

Returns:
responserequests.Response

The HTTP response returned from the service.

reset_cache_location()

Resets the cache location to the default astropy cache