Ukidss

class astroquery.ukidss.core.Ukidss(username, password, community, database='UKIDSSDR7PLUS', programme_id='all')

Bases: astroquery.query.QueryWithLogin

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.

Attributes Summary

ARCHIVE_URL	str(object=’‘) -> string
BASE_URL	str(object=’‘) -> string
IMAGE_URL	str(object=’‘) -> string
LOGIN_URL	str(object=’‘) -> string
REGION_URL	str(object=’‘) -> string
TIMEOUT	int(x=0) -> int or long
databases	tuple() -> empty tuple
filters
frame_types
ukidss_programmes_long
ukidss_programmes_short

Methods Summary

extract_urls(*args, **kwds)	Helper function that uses reges to extract the image urls from the given HTML.
get_image_list(*args, **kwds)
get_images(*args, **kwds)	Get an image around a target/ coordinates from UKIDSS catalog.
get_images_async(*args, **kwds)	Serves the same purpose as get_images() but returns a list of file handlers to remote files :Parameters: coordinates : str or astropy.coordinates object The target around which to search.
list_catalogs(*args, **kwds)	Returns a lsit of available catalogs in UKIDSS.
list_databases(*args, **kwds)	List the databases available from the UKIDSS WFCAM archive
logged_in()	Determine whether currently logged in.
login(username, password, community)	Login to non-public data as a known user
query_region(*args, **kwds)	Used to query a region around a known identifier or given coordinates from the catalog.
query_region_async(*args, **kwds)	Serves the same purpose as query_region().

Attributes Documentation

ARCHIVE_URL = 'http://surveys.roe.ac.uk:8080/wsa/ImageList'

BASE_URL = 'http://surveys.roe.ac.uk:8080/wsa/'

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 = 60

databases = ('UKIDSSDR9PLUS', 'UKIDSSDR8PLUS', 'UKIDSSDR7PLUS', 'UKIDSSDR6PLUS', 'UKIDSSDR5PLUS', 'UKIDSSDR4PLUS', 'UKIDSSDR3PLUS', 'UKIDSSDR2PLUS', 'UKIDSSDR1PLUS', 'UKIDSSDR1', 'UKIDSSEDRPLUS', 'UKIDSSEDR', 'UKIDSSSV', 'WFCAMCAL08B')

filters = {'H2': 6, 'all': 'all', 'Z': 1, 'Br': 7, 'Y': 2, 'H': 4, 'K': 5, 'J': 3}

frame_types = {'interleave': 'leav', 'confidence': 'conf', 'all': 'all', 'normal': 'normal', 'leavstack': 'leavstack', 'difference': 'diff', 'stack': 'stack', 'deep_stack': 'deep%stack'}

ukidss_programmes_long = {'Galactic Plane Survey': 102, 'Deep Extragalactic Survey': 104, 'Galactic Clusters Survey': 103, 'Ultra Deep Survey': 105, 'Large Area Survey': 101}

ukidss_programmes_short = {'UDS': 105, 'GCS': 103, 'GPS': 102, 'DXS': 104, 'LAS': 101}

Methods Documentation

static extract_urls(*args, **kwds)

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

Parameters :

html_in : str

source from which the urls are to be extracted

Returns :

links : list

The list of URLS extracted from the input.

static get_image_list(*args, **kwds)

static get_images(*args, **kwds)

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

Parameters :

coordinates : str 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.

waveband : str

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

frame_type : str

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

image_width : str or astropy.units.Quantity object, optional

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

image_height : str or astropy.units.Quantity object, optional

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

radius : str or astropy.units.Quantity object, optional

The string must be parsable by astropy.coordinates.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_id : str

The survey or programme in which to search for

database : str

The UKIDSS database to use

verbose : bool

Defaults to True. When True prints additional messages.

get_query_payload : bool, optional

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

Returns :

A list of `astropy.fits.HDUList` objects :

static get_images_async(*args, **kwds)

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

Parameters :

coordinates : str 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.

waveband : str

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

frame_type : str

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

image_width : str or astropy.units.Quantity object, optional

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

image_height : str or astropy.units.Quantity object, optional

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

radius : str or astropy.units.Quantity object, optional

The string must be parsable by astropy.coordinates.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_id : str

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

database : str

The UKIDSS database to use.

verbose : bool

Defaults to True. When True prints additional messages.

get_query_payload : bool, optional

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

Returns :

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

static list_catalogs(*args, **kwds)

Returns a lsit of available catalogs in UKIDSS. These can be used as programme_id in queries

Parameters :

style : str, optional

Must be one of [‘short’, ‘long’]. Defaults to ‘short’. Determines whether to print long names or abbreviations for catalogs.

Returns :

list :

list containing catalog name strings in long or short style.

static list_databases(*args, **kwds)

List the databases available from the UKIDSS WFCAM archive

logged_in()

Determine whether currently logged in.

login(username, password, community)

Login to non-public data as a known user

Parameters :

username : string

password : string

community : string

static query_region(*args, **kwds)

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

Parameters :

coordinates : str 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.

radius : str or astropy.units.Quantity object, optional

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

programme_id : str

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

database : str

The UKIDSS database to use

verbose : bool, optional.

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

get_query_payload : bool, optional

if set to 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

Returns :

result : astropy.table.Table

The result of the query as an astropy.table.Table object.

static query_region_async(*args, **kwds)

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

Parameters :

coordinates : str 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.

radius : str or astropy.units.Quantity object, optional

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

programme_id : str

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

database : str

The UKIDSS database to use

get_query_payload : bool, optional

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

Returns :

response : requests.Response

The HTTP response returned from the service