SDSSClass¶
- class astroquery.sdss.SDSSClass[source]¶
Bases:
BaseQuery
Attributes Summary
Methods Summary
get_images
(*[, coordinates, radius, ...])Download an image from SDSS.
get_images_async
([coordinates, radius, ...])Download an image from SDSS.
get_spectra
(*[, coordinates, radius, ...])Download spectrum from SDSS.
get_spectra_async
(*[, coordinates, radius, ...])Download spectrum from SDSS.
get_spectral_template
([kind, timeout, ...])Download spectral templates from SDSS DR-2.
get_spectral_template_async
([kind, timeout, ...])Download spectral templates from SDSS DR-2.
query_crossid
(*args, **kwargs)Queries the service and returns a table object.
query_crossid_async
(coordinates, *[, ...])Query using the cross-identification web interface.
query_photoobj
(*args, **kwargs)Queries the service and returns a table object.
query_photoobj_async
(*[, run, rerun, ...])Used to query the PhotoObjAll table with run, rerun, camcol and field values.
query_region
(*args, **kwargs)Queries the service and returns a table object.
query_region_async
(coordinates, *[, radius, ...])Used to query a region around given coordinates.
query_specobj
(*args, **kwargs)Queries the service and returns a table object.
query_specobj_async
(*[, plate, mjd, ...])Used to query the SpecObjAll table with plate, mjd and fiberID values.
query_sql
(*args, **kwargs)Queries the service and returns a table object.
query_sql_async
(sql_query, *[, timeout, ...])Query the SDSS database.
Attributes Documentation
- AVAILABLE_TEMPLATES = {'galaxy': [24, 25, 26], 'galaxy_early': 23, 'galaxy_late': 27, 'galaxy_lrg': 28, 'qso': 29, 'qso_bal': [30, 31], 'qso_bright': 32, 'star_A': [3, 4], 'star_B': 2, 'star_F': [6, 7], 'star_FA': 5, 'star_G': [8, 9], 'star_K': 10, 'star_Ksubdwarf': 22, 'star_L1': 15, 'star_M1': 11, 'star_M3': 12, 'star_M5': 13, 'star_M8': 14, 'star_O': 0, 'star_OB': 1, 'star_carbon': [17, 18, 19], 'star_wd': [16, 20, 21]}¶
- IMAGING_URL_SUFFIX = '{base}/dr{dr}/{instrument}/photoObj/frames/{rerun}/{run}/{camcol}/frame-{band}-{run:06d}-{camcol}-{field:04d}.fits.bz2'¶
- MAX_CROSSID_RADIUS = <Quantity 3. arcmin>¶
- PARSE_BOSS_RUN2D = re.compile('v(?P<major>[0-9]+)_(?P<minor>[0-9]+)_(?P<bugfix>[0-9]+)')¶
- QUERY_URL_SUFFIX_DR_10 = '/dr{dr}/en/tools/search/x_sql.aspx'¶
- QUERY_URL_SUFFIX_DR_NEW = '/dr{dr}/en/tools/search/x_results.aspx'¶
- QUERY_URL_SUFFIX_DR_OLD = '/dr{dr}/en/tools/search/x_sql.asp'¶
- SPECTRA_URL_SUFFIX = '{base}/dr{dr}/{redux_path}/{run2d}/{spectra_path}/{plate:0>4d}/spec-{plate:0>4d}-{mjd}-{fiber:04d}.fits'¶
- TEMPLATES_URL = 'http://classic.sdss.org/dr7/algorithms/spectemplates/spDR2'¶
- TIMEOUT = 60¶
- XID_URL_SUFFIX_DR_10 = '/dr{dr}/en/tools/crossid/x_crossid.aspx'¶
- XID_URL_SUFFIX_NEW = '/dr{dr}/en/tools/search/X_Results.aspx'¶
- XID_URL_SUFFIX_OLD = '/dr{dr}/en/tools/crossid/x_crossid.asp'¶
Methods Documentation
- get_images(*, coordinates=None, radius=<Quantity 2. arcsec>, matches=None, run=None, rerun=301, camcol=None, field=None, band='g', timeout=60, cache=True, get_query_payload=False, data_release=17, show_progress=True)[source]¶
Download an image from SDSS.
Querying SDSS for images will return the entire plate. For subsequent analyses of individual objects
The query can be made with one the following groups of parameters (whichever comes first is used):
matches
(result of a call toquery_region
);coordinates
,radius
;run
,rerun
,camcol
,field
.
See below for examples.
- 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 theastropy.coordinates
module.- radiusstr or
Quantity
object, optional The string must be parsable by
Angle
. The appropriateQuantity
object fromastropy.units
may also be used. Defaults to 2 arcsec.- matches
Table
Result of
query_region
.- runinteger, optional
Length of a strip observed in a single continuous image observing scan.
- reruninteger, optional
Reprocessing of an imaging run. Defaults to 301 which is the most recent rerun.
- camcolinteger, optional
Output of one camera column of CCDs.
- fieldinteger, optional
Part of a camcol of size 2048 by 1489 pixels.
- bandstr or list
Could be individual band, or list of bands. Options:
'u'
,'g'
,'r'
,'i'
, or'z'
.- timeoutfloat, optional
Time limit (in seconds) for establishing successful connection with remote server. Defaults to
SDSSClass.TIMEOUT
.- get_query_payloadbool, optional
If True, this will return the data the query would have sent out, but does not actually do the query.
- cachebool
Defaults to True. If set overrides global caching behavior. See caching documentation.
- data_releaseint, optional
The data release of the SDSS to use.
- show_progressbool, optional
If False, do not display download progress.
- coordinatesstr or
- Returns:
- listList of
HDUList
objects.
- listList of
Examples
Using results from a call to
query_region
:>>> from astropy import coordinates as coords >>> from astroquery.sdss import SDSS >>> co = coords.SkyCoord('0h8m05.63s +14d50m23.3s') >>> result = SDSS.query_region(co) >>> imgs = SDSS.get_images(matches=result)
Using coordinates directly:
>>> imgs = SDSS.get_images(co)
Fetch the images from all runs with camcol 3 and field 164:
>>> imgs = SDSS.get_images(camcol=3, field=164)
Fetch only images from run 1904, camcol 3 and field 164:
>>> imgs = SDSS.get_images(run=1904, camcol=3, field=164)
- get_images_async(coordinates=None, radius=<Quantity 2. arcsec>, matches=None, run=None, rerun=301, camcol=None, field=None, band='g', timeout=60, cache=True, get_query_payload=False, data_release=17, show_progress=True)[source]¶
Download an image from SDSS.
Querying SDSS for images will return the entire plate. For subsequent analyses of individual objects
The query can be made with one the following groups of parameters (whichever comes first is used):
matches
(result of a call toquery_region
);coordinates
,radius
;run
,rerun
,camcol
,field
.
See below for examples.
- 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 theastropy.coordinates
module.- radiusstr or
Quantity
object, optional The string must be parsable by
Angle
. The appropriateQuantity
object fromastropy.units
may also be used. Defaults to 2 arcsec.- matches
Table
Result of
query_region
.- runinteger, optional
Length of a strip observed in a single continuous image observing scan.
- reruninteger, optional
Reprocessing of an imaging run. Defaults to 301 which is the most recent rerun.
- camcolinteger, optional
Output of one camera column of CCDs.
- fieldinteger, optional
Part of a camcol of size 2048 by 1489 pixels.
- bandstr or list
Could be individual band, or list of bands. Options:
'u'
,'g'
,'r'
,'i'
, or'z'
.- timeoutfloat, optional
Time limit (in seconds) for establishing successful connection with remote server. Defaults to
SDSSClass.TIMEOUT
.- get_query_payloadbool, optional
If True, this will return the data the query would have sent out, but does not actually do the query.
- cachebool
Defaults to True. If set overrides global caching behavior. See caching documentation.
- data_releaseint, optional
The data release of the SDSS to use.
- show_progressbool, optional
If False, do not display download progress.
- coordinatesstr or
- Returns:
- listList of
HDUList
objects.
- listList of
Examples
Using results from a call to
query_region
:>>> from astropy import coordinates as coords >>> from astroquery.sdss import SDSS >>> co = coords.SkyCoord('0h8m05.63s +14d50m23.3s') >>> result = SDSS.query_region(co) >>> imgs = SDSS.get_images(matches=result)
Using coordinates directly:
>>> imgs = SDSS.get_images(co)
Fetch the images from all runs with camcol 3 and field 164:
>>> imgs = SDSS.get_images(camcol=3, field=164)
Fetch only images from run 1904, camcol 3 and field 164:
>>> imgs = SDSS.get_images(run=1904, camcol=3, field=164)
- get_spectra(*, coordinates=None, radius=<Quantity 2. arcsec>, matches=None, plate=None, fiberID=None, mjd=None, timeout=60, get_query_payload=False, data_release=17, cache=True, show_progress=True)[source]¶
Download spectrum from SDSS.
The query can be made with one the following groups of parameters (whichever comes first is used):
matches
(result of a call toquery_region
);coordinates
,radius
;plate
,mjd
,fiberID
.
See below for examples.
- 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 theastropy.coordinates
module.- radiusstr or
Quantity
object, optional The string must be parsable by
Angle
. The appropriateQuantity
object fromastropy.units
may also be used. Defaults to 2 arcsec.- matches
Table
Result of
query_region
.- plateinteger, optional
Plate number.
- fiberIDinteger, optional
Fiber number.
- mjdinteger, optional
Modified Julian Date indicating the date a given piece of SDSS data was taken.
- timeoutfloat, optional
Time limit (in seconds) for establishing successful connection with remote server. Defaults to
SDSSClass.TIMEOUT
.- get_query_payloadbool, optional
If True, this will return the data the query would have sent out, but does not actually do the query.
- data_releaseint, optional
The data release of the SDSS to use. With the default server, this only supports DR8 or later.
- cachebool
Defaults to True. If set overrides global caching behavior. See caching documentation.
- show_progressbool, optional
If False, do not display download progress.
- coordinatesstr or
- Returns:
- listList of
HDUList
objects.
- listList of
Examples
Using results from a call to
query_region
:>>> from astropy import coordinates as coords >>> from astroquery.sdss import SDSS >>> co = coords.SkyCoord('0h8m05.63s +14d50m23.3s') >>> result = SDSS.query_region(co, spectro=True) >>> spec = SDSS.get_spectra(matches=result)
Using coordinates directly:
>>> spec = SDSS.get_spectra(co)
Fetch the spectra from all fibers on plate 751 with mjd 52251:
>>> specs = SDSS.get_spectra(plate=751, mjd=52251)
- get_spectra_async(*, coordinates=None, radius=<Quantity 2. arcsec>, matches=None, plate=None, fiberID=None, mjd=None, timeout=60, get_query_payload=False, data_release=17, cache=True, show_progress=True)[source]¶
Download spectrum from SDSS.
The query can be made with one the following groups of parameters (whichever comes first is used):
matches
(result of a call toquery_region
);coordinates
,radius
;plate
,mjd
,fiberID
.
See below for examples.
- 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 theastropy.coordinates
module.- radiusstr or
Quantity
object, optional The string must be parsable by
Angle
. The appropriateQuantity
object fromastropy.units
may also be used. Defaults to 2 arcsec.- matches
Table
Result of
query_region
.- plateinteger, optional
Plate number.
- fiberIDinteger, optional
Fiber number.
- mjdinteger, optional
Modified Julian Date indicating the date a given piece of SDSS data was taken.
- timeoutfloat, optional
Time limit (in seconds) for establishing successful connection with remote server. Defaults to
SDSSClass.TIMEOUT
.- get_query_payloadbool, optional
If True, this will return the data the query would have sent out, but does not actually do the query.
- data_releaseint, optional
The data release of the SDSS to use. With the default server, this only supports DR8 or later.
- cachebool
Defaults to True. If set overrides global caching behavior. See caching documentation.
- show_progressbool, optional
If False, do not display download progress.
- coordinatesstr or
- Returns:
- listlist
A list of context-managers that yield readable file-like objects. The function returns the spectra for only one of
matches
, orcoordinates
andradius
, orplate
,mjd
andfiberID
.
Examples
Using results from a call to
query_region
:>>> from astropy import coordinates as coords >>> from astroquery.sdss import SDSS >>> co = coords.SkyCoord('0h8m05.63s +14d50m23.3s') >>> result = SDSS.query_region(co, spectro=True) >>> spec = SDSS.get_spectra(matches=result)
Using coordinates directly:
>>> spec = SDSS.get_spectra(co)
Fetch the spectra from all fibers on plate 751 with mjd 52251:
>>> specs = SDSS.get_spectra(plate=751, mjd=52251)
- get_spectral_template(kind='qso', *, timeout=60, show_progress=True)[source]¶
Download spectral templates from SDSS DR-2.
Location: http://classic.sdss.org/dr7/algorithms/spectemplates/
There 32 spectral templates available from DR-2, from stellar spectra, to galaxies, to quasars. To see the available templates, do:
from astroquery.sdss import SDSS print SDSS.AVAILABLE_TEMPLATES
- Parameters:
- kindstr or list
Which spectral template to download? Options are stored in the dictionary astroquery.sdss.SDSS.AVAILABLE_TEMPLATES
- timeoutfloat, optional
Time limit (in seconds) for establishing successful connection with remote server. Defaults to
SDSSClass.TIMEOUT
.- show_progressbool, optional
If False, do not display download progress.
- Returns:
- listList of
HDUList
objects.
- listList of
Examples
>>> qso = SDSS.get_spectral_template(kind='qso') >>> Astar = SDSS.get_spectral_template(kind='star_A') >>> Fstar = SDSS.get_spectral_template(kind='star_F')
- get_spectral_template_async(kind='qso', *, timeout=60, show_progress=True)[source]¶
Download spectral templates from SDSS DR-2.
Location: http://classic.sdss.org/dr7/algorithms/spectemplates/
There 32 spectral templates available from DR-2, from stellar spectra, to galaxies, to quasars. To see the available templates, do:
from astroquery.sdss import SDSS print SDSS.AVAILABLE_TEMPLATES
- Parameters:
- kindstr or list
Which spectral template to download? Options are stored in the dictionary astroquery.sdss.SDSS.AVAILABLE_TEMPLATES
- timeoutfloat, optional
Time limit (in seconds) for establishing successful connection with remote server. Defaults to
SDSSClass.TIMEOUT
.- show_progressbool, optional
If False, do not display download progress.
- Returns:
- listList of
HDUList
objects.
- listList of
Examples
>>> qso = SDSS.get_spectral_template(kind='qso') >>> Astar = SDSS.get_spectral_template(kind='star_A') >>> Fstar = SDSS.get_spectral_template(kind='star_F')
- query_crossid(*args, **kwargs)¶
Queries the service and returns a table object.
Query using the cross-identification web interface.
This query returns the nearest primary object.
Note that there is a server-side limit of 3 arcmin on
radius
.- Parameters:
- coordinatesstr or
astropy.coordinates
object or (list orColumn
) of coordinates The target(s) 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 theastropy.coordinates
module.Example: ra = np.array([220.064728084,220.064728467,220.06473483]) dec = np.array([0.870131920218,0.87013210119,0.870138329659]) coordinates = SkyCoord(ra, dec, frame=’icrs’, unit=’deg’)
- radiusstr or
Quantity
object orAngle
object, optional The string must be parsable by
Angle
. The appropriateQuantity
object fromastropy.units
orAngle
object fromastropy.coordinates
may also be used. Defaults to 5 arcsec. The maximum allowed value is 3 arcmin.- timeoutfloat, optional
Time limit (in seconds) for establishing successful connection with remote server. Defaults to
SDSSClass.TIMEOUT
.- fieldslist, optional
SDSS PhotoObj or SpecObj quantities to return. If None, defaults to quantities required to find corresponding spectra and images of matched objects (e.g. plate, fiberID, mjd, etc.).
- photoobj_fieldslist, optional
PhotoObj quantities to return. If photoobj_fields is None and specobj_fields is None then the value of fields is used
- specobj_fieldslist, optional
SpecObj quantities to return. If photoobj_fields is None and specobj_fields is None then the value of fields is used
- obj_namesstr, or list or
Column
, optional Target names. If given, every coordinate should have a corresponding name, and it gets repeated in the query result. It generates unique object names by default.
- spectrobool, optional
Look for spectroscopic match in addition to photometric match? If True, objects will only count as a match if photometry and spectroscopy exist. If False, will look for photometric matches only.
- regionbool, optional
Normally cross-id only returns the closest primary object. Setting this to
True
will return all objects.- field_help: str or bool, optional
Field name to check whether a valid PhotoObjAll or SpecObjAll field name. If
True
or it is an invalid field name all the valid field names are returned as a dict.- get_query_payloadbool, optional
If True, this will return the data the query would have sent out, but does not actually do the query.
- data_releaseint, optional
The data release of the SDSS to use.
- cachebool
Defaults to True. If set overrides global caching behavior. See caching documentation.
- coordinatesstr or
- Returns:
- tableA
Table
object.
- tableA
- Raises:
- TypeError
If the
radius
keyword could not be parsed as an angle.- ValueError
If the
radius
exceeds 3 arcmin, or if the sizes ofcoordinates
andobj_names
do not match.
- query_crossid_async(coordinates, *, radius=<Quantity 5. arcsec>, timeout=60, fields=None, photoobj_fields=None, specobj_fields=None, obj_names=None, spectro=False, region=False, field_help=False, get_query_payload=False, data_release=17, cache=True)[source]¶
Query using the cross-identification web interface.
This query returns the nearest primary object.
Note that there is a server-side limit of 3 arcmin on
radius
.- Parameters:
- coordinatesstr or
astropy.coordinates
object or (list orColumn
) of coordinates The target(s) 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 theastropy.coordinates
module.Example: ra = np.array([220.064728084,220.064728467,220.06473483]) dec = np.array([0.870131920218,0.87013210119,0.870138329659]) coordinates = SkyCoord(ra, dec, frame=’icrs’, unit=’deg’)
- radiusstr or
Quantity
object orAngle
object, optional The string must be parsable by
Angle
. The appropriateQuantity
object fromastropy.units
orAngle
object fromastropy.coordinates
may also be used. Defaults to 5 arcsec. The maximum allowed value is 3 arcmin.- timeoutfloat, optional
Time limit (in seconds) for establishing successful connection with remote server. Defaults to
SDSSClass.TIMEOUT
.- fieldslist, optional
SDSS PhotoObj or SpecObj quantities to return. If None, defaults to quantities required to find corresponding spectra and images of matched objects (e.g. plate, fiberID, mjd, etc.).
- photoobj_fieldslist, optional
PhotoObj quantities to return. If photoobj_fields is None and specobj_fields is None then the value of fields is used
- specobj_fieldslist, optional
SpecObj quantities to return. If photoobj_fields is None and specobj_fields is None then the value of fields is used
- obj_namesstr, or list or
Column
, optional Target names. If given, every coordinate should have a corresponding name, and it gets repeated in the query result. It generates unique object names by default.
- spectrobool, optional
Look for spectroscopic match in addition to photometric match? If True, objects will only count as a match if photometry and spectroscopy exist. If False, will look for photometric matches only.
- regionbool, optional
Normally cross-id only returns the closest primary object. Setting this to
True
will return all objects.- field_help: str or bool, optional
Field name to check whether a valid PhotoObjAll or SpecObjAll field name. If
True
or it is an invalid field name all the valid field names are returned as a dict.- get_query_payloadbool, optional
If True, this will return the data the query would have sent out, but does not actually do the query.
- data_releaseint, optional
The data release of the SDSS to use.
- cachebool
Defaults to True. If set overrides global caching behavior. See caching documentation.
- coordinatesstr or
- Returns:
- Raises:
- TypeError
If the
radius
keyword could not be parsed as an angle.- ValueError
If the
radius
exceeds 3 arcmin, or if the sizes ofcoordinates
andobj_names
do not match.
- query_photoobj(*args, **kwargs)¶
Queries the service and returns a table object.
Used to query the PhotoObjAll table with run, rerun, camcol and field values.
At least one of
run
,camcol
orfield
parameters must be specified.- Parameters:
- runinteger, optional
Length of a strip observed in a single continuous image observing scan.
- reruninteger, optional
Reprocessing of an imaging run. Defaults to 301 which is the most recent rerun.
- camcolinteger, optional
Output of one camera column of CCDs.
- fieldinteger, optional
Part of a camcol of size 2048 by 1489 pixels.
- fieldslist, optional
SDSS PhotoObj or SpecObj quantities to return. If None, defaults to quantities required to find corresponding spectra and images of matched objects (e.g. plate, fiberID, mjd, etc.).
- timeoutfloat, optional
Time limit (in seconds) for establishing successful connection with remote server. Defaults to
SDSSClass.TIMEOUT
.- field_help: str or bool, optional
Field name to check whether a valid PhotoObjAll or SpecObjAll field name. If
True
or it is an invalid field name all the valid field names are returned as a dict.- get_query_payloadbool, optional
If True, this will return the data the query would have sent out, but does not actually do the query.
- data_releaseint, optional
The data release of the SDSS to use.
- cachebool
Defaults to True. If set overrides global caching behavior. See caching documentation.
- Returns:
- tableA
Table
object.
- tableA
Examples
>>> from astroquery.sdss import SDSS >>> result = SDSS.query_photoobj(run=5714, camcol=6) >>> print(result[:5]) ra dec objid run rerun camcol field ------------- ------------- ------------------- ---- ----- ------ ----- 30.4644529079 7.86460794626 1237670017266024498 5714 301 6 75 38.7635496073 7.47083098197 1237670017269628978 5714 301 6 130 22.2574304026 8.43175488904 1237670017262485671 5714 301 6 21 23.3724928784 8.32576993103 1237670017262944491 5714 301 6 28 25.4801226435 8.27642390025 1237670017263927330 5714 301 6 43
- query_photoobj_async(*, run=None, rerun=301, camcol=None, field=None, fields=None, timeout=60, get_query_payload=False, field_help=False, data_release=17, cache=True)[source]¶
Used to query the PhotoObjAll table with run, rerun, camcol and field values.
At least one of
run
,camcol
orfield
parameters must be specified.- Parameters:
- runinteger, optional
Length of a strip observed in a single continuous image observing scan.
- reruninteger, optional
Reprocessing of an imaging run. Defaults to 301 which is the most recent rerun.
- camcolinteger, optional
Output of one camera column of CCDs.
- fieldinteger, optional
Part of a camcol of size 2048 by 1489 pixels.
- fieldslist, optional
SDSS PhotoObj or SpecObj quantities to return. If None, defaults to quantities required to find corresponding spectra and images of matched objects (e.g. plate, fiberID, mjd, etc.).
- timeoutfloat, optional
Time limit (in seconds) for establishing successful connection with remote server. Defaults to
SDSSClass.TIMEOUT
.- field_help: str or bool, optional
Field name to check whether a valid PhotoObjAll or SpecObjAll field name. If
True
or it is an invalid field name all the valid field names are returned as a dict.- get_query_payloadbool, optional
If True, this will return the data the query would have sent out, but does not actually do the query.
- data_releaseint, optional
The data release of the SDSS to use.
- cachebool
Defaults to True. If set overrides global caching behavior. See caching documentation.
- Returns:
Examples
>>> from astroquery.sdss import SDSS >>> result = SDSS.query_photoobj(run=5714, camcol=6) >>> print(result[:5]) ra dec objid run rerun camcol field ------------- ------------- ------------------- ---- ----- ------ ----- 30.4644529079 7.86460794626 1237670017266024498 5714 301 6 75 38.7635496073 7.47083098197 1237670017269628978 5714 301 6 130 22.2574304026 8.43175488904 1237670017262485671 5714 301 6 21 23.3724928784 8.32576993103 1237670017262944491 5714 301 6 28 25.4801226435 8.27642390025 1237670017263927330 5714 301 6 43
- query_region(*args, **kwargs)¶
Queries the service and returns a table object.
Used to query a region around given coordinates. Either
radius
orwidth
must be specified.When called with keyword
radius
, a radial or “cone” search is performed, centered on each of the given coordinates. In this mode, internally, this function is equivalent to the object cross-ID (query_crossid
), with slightly different parameters. Note that in this mode there is a server-side limit of 3 arcmin onradius
.When called with keyword
width
, and optionally a differentheight
, a rectangular search is performed, centered on each of the given coordinates. In this mode, internally, this function is equivalent to a general SQL query (query_sql
). The shape of the rectangle is not corrected for declination (i.e. no \(\cos \delta\) correction); conceptually, this means that the rectangle will become increasingly trapezoidal-shaped at high declination.In both radial and rectangular modes, this function returns all objects within the search area; this could potentially include duplicate observations of the same object.
- Parameters:
- coordinatesstr or
astropy.coordinates
object or (list orColumn
) of coordinates The target(s) 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 theastropy.coordinates
module.Example: ra = np.array([220.064728084,220.064728467,220.06473483]) dec = np.array([0.870131920218,0.87013210119,0.870138329659]) coordinates = SkyCoord(ra, dec, frame=’icrs’, unit=’deg’)
- radiusstr or
Quantity
object, optional The string must be parsable by
Angle
. The appropriateQuantity
object fromastropy.units
may also be used. The maximum allowed value is 3 arcmin.- widthstr or
Quantity
object, optional The string must be parsable by
Angle
. The appropriateQuantity
object fromastropy.units
may also be used.- heightstr or
Quantity
object, optional The string must be parsable by
Angle
. The appropriateQuantity
object fromastropy.units
may also be used. If not specified, it will be set to the same value aswidth
.- timeoutfloat, optional
Time limit (in seconds) for establishing successful connection with remote server. Defaults to
SDSSClass.TIMEOUT
.- fieldslist, optional
SDSS PhotoObj or SpecObj quantities to return. If None, defaults to quantities required to find corresponding spectra and images of matched objects (e.g. plate, fiberID, mjd, etc.).
- photoobj_fieldslist, optional
PhotoObj quantities to return. If photoobj_fields is None and specobj_fields is None then the value of fields is used
- specobj_fieldslist, optional
SpecObj quantities to return. If photoobj_fields is None and specobj_fields is None then the value of fields is used
- obj_namesstr, or list or
Column
, optional Target names. If given, every coordinate should have a corresponding name, and it gets repeated in the query result.
- spectrobool, optional
Look for spectroscopic match in addition to photometric match? If True, objects will only count as a match if photometry and spectroscopy exist. If False, will look for photometric matches only.
- field_help: str or bool, optional
Field name to check whether a valid PhotoObjAll or SpecObjAll field name. If
True
or it is an invalid field name all the valid field names are returned as a dict.- get_query_payloadbool, optional
If True, this will return the data the query would have sent out, but does not actually do the query.
- data_releaseint, optional
The data release of the SDSS to use.
- cachebool
Defaults to True. If set overrides global caching behavior. See caching documentation.
- coordinatesstr or
- Returns:
- tableA
Table
object.
- tableA
- Raises:
- TypeError
If the
radius
,width
orheight
keywords could not be parsed as an angle.- ValueError
If both
radius
andwidth
are set (or neither), or if theradius
exceeds 3 arcmin, or if the sizes ofcoordinates
andobj_names
do not match, or if the units ofwidth
orheight
could not be parsed.
Examples
>>> from astroquery.sdss import SDSS >>> from astropy import coordinates as coords >>> co = coords.SkyCoord('0h8m05.63s +14d50m23.3s') >>> result = SDSS.query_region(co) >>> print(result[:5]) ra dec objid run rerun camcol field ------------- ------------- ------------------- ---- ----- ------ ----- 2.02344282607 14.8398204075 1237653651835781245 1904 301 3 163 2.02344283666 14.8398204143 1237653651835781244 1904 301 3 163 2.02344596595 14.8398237229 1237652943176138867 1739 301 3 315 2.02344596303 14.8398237521 1237652943176138868 1739 301 3 315 2.02344772021 14.8398201105 1237653651835781243 1904 301 3 163
- query_region_async(coordinates, *, radius=None, width=None, height=None, timeout=60, fields=None, photoobj_fields=None, specobj_fields=None, obj_names=None, spectro=False, field_help=False, get_query_payload=False, data_release=17, cache=True)[source]¶
Used to query a region around given coordinates. Either
radius
orwidth
must be specified.When called with keyword
radius
, a radial or “cone” search is performed, centered on each of the given coordinates. In this mode, internally, this function is equivalent to the object cross-ID (query_crossid
), with slightly different parameters. Note that in this mode there is a server-side limit of 3 arcmin onradius
.When called with keyword
width
, and optionally a differentheight
, a rectangular search is performed, centered on each of the given coordinates. In this mode, internally, this function is equivalent to a general SQL query (query_sql
). The shape of the rectangle is not corrected for declination (i.e. no \(\cos \delta\) correction); conceptually, this means that the rectangle will become increasingly trapezoidal-shaped at high declination.In both radial and rectangular modes, this function returns all objects within the search area; this could potentially include duplicate observations of the same object.
- Parameters:
- coordinatesstr or
astropy.coordinates
object or (list orColumn
) of coordinates The target(s) 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 theastropy.coordinates
module.Example: ra = np.array([220.064728084,220.064728467,220.06473483]) dec = np.array([0.870131920218,0.87013210119,0.870138329659]) coordinates = SkyCoord(ra, dec, frame=’icrs’, unit=’deg’)
- radiusstr or
Quantity
object, optional The string must be parsable by
Angle
. The appropriateQuantity
object fromastropy.units
may also be used. The maximum allowed value is 3 arcmin.- widthstr or
Quantity
object, optional The string must be parsable by
Angle
. The appropriateQuantity
object fromastropy.units
may also be used.- heightstr or
Quantity
object, optional The string must be parsable by
Angle
. The appropriateQuantity
object fromastropy.units
may also be used. If not specified, it will be set to the same value aswidth
.- timeoutfloat, optional
Time limit (in seconds) for establishing successful connection with remote server. Defaults to
SDSSClass.TIMEOUT
.- fieldslist, optional
SDSS PhotoObj or SpecObj quantities to return. If None, defaults to quantities required to find corresponding spectra and images of matched objects (e.g. plate, fiberID, mjd, etc.).
- photoobj_fieldslist, optional
PhotoObj quantities to return. If photoobj_fields is None and specobj_fields is None then the value of fields is used
- specobj_fieldslist, optional
SpecObj quantities to return. If photoobj_fields is None and specobj_fields is None then the value of fields is used
- obj_namesstr, or list or
Column
, optional Target names. If given, every coordinate should have a corresponding name, and it gets repeated in the query result.
- spectrobool, optional
Look for spectroscopic match in addition to photometric match? If True, objects will only count as a match if photometry and spectroscopy exist. If False, will look for photometric matches only.
- field_help: str or bool, optional
Field name to check whether a valid PhotoObjAll or SpecObjAll field name. If
True
or it is an invalid field name all the valid field names are returned as a dict.- get_query_payloadbool, optional
If True, this will return the data the query would have sent out, but does not actually do the query.
- data_releaseint, optional
The data release of the SDSS to use.
- cachebool
Defaults to True. If set overrides global caching behavior. See caching documentation.
- coordinatesstr or
- Returns:
- Raises:
- TypeError
If the
radius
,width
orheight
keywords could not be parsed as an angle.- ValueError
If both
radius
andwidth
are set (or neither), or if theradius
exceeds 3 arcmin, or if the sizes ofcoordinates
andobj_names
do not match, or if the units ofwidth
orheight
could not be parsed.
Examples
>>> from astroquery.sdss import SDSS >>> from astropy import coordinates as coords >>> co = coords.SkyCoord('0h8m05.63s +14d50m23.3s') >>> result = SDSS.query_region(co) >>> print(result[:5]) ra dec objid run rerun camcol field ------------- ------------- ------------------- ---- ----- ------ ----- 2.02344282607 14.8398204075 1237653651835781245 1904 301 3 163 2.02344283666 14.8398204143 1237653651835781244 1904 301 3 163 2.02344596595 14.8398237229 1237652943176138867 1739 301 3 315 2.02344596303 14.8398237521 1237652943176138868 1739 301 3 315 2.02344772021 14.8398201105 1237653651835781243 1904 301 3 163
- query_specobj(*args, **kwargs)¶
Queries the service and returns a table object.
Used to query the SpecObjAll table with plate, mjd and fiberID values.
At least one of
plate
,mjd
orfiberID
parameters must be specified.- Parameters:
- plateinteger, optional
Plate number.
- mjdinteger, optional
Modified Julian Date indicating the date a given piece of SDSS data was taken.
- fiberIDinteger, optional
Fiber number.
- fieldslist, optional
SDSS PhotoObj or SpecObj quantities to return. If None, defaults to quantities required to find corresponding spectra and images of matched objects (e.g. plate, fiberID, mjd, etc.).
- timeoutfloat, optional
Time limit (in seconds) for establishing successful connection with remote server. Defaults to
SDSSClass.TIMEOUT
.- field_help: str or bool, optional
Field name to check whether a valid PhotoObjAll or SpecObjAll field name. If
True
or it is an invalid field name all the valid field names are returned as a dict.- get_query_payloadbool, optional
If True, this will return the data the query would have sent out, but does not actually do the query.
- data_releaseint, optional
The data release of the SDSS to use.
- cachebool
Defaults to True. If set overrides global caching behavior. See caching documentation.
- Returns:
- tableA
Table
object.
- tableA
Examples
>>> from astroquery.sdss import SDSS >>> result = SDSS.query_specobj(plate=2340, ... fields=['ra', 'dec','plate', 'mjd', 'fiberID', 'specobjid']) >>> print(result[:5]) ra dec plate mjd fiberID specobjid ------------- ------------- ----- ----- ------- ------------------- 49.2020613611 5.20883041368 2340 53733 60 2634622337315530752 48.3745360119 5.26557511598 2340 53733 154 2634648175838783488 47.1604269095 5.48241410994 2340 53733 332 2634697104106219520 48.6634992214 6.69459110287 2340 53733 553 2634757852123654144 48.0759195428 6.18757403485 2340 53733 506 2634744932862027776
- query_specobj_async(*, plate=None, mjd=None, fiberID=None, fields=None, timeout=60, get_query_payload=False, field_help=False, data_release=17, cache=True)[source]¶
Used to query the SpecObjAll table with plate, mjd and fiberID values.
At least one of
plate
,mjd
orfiberID
parameters must be specified.- Parameters:
- plateinteger, optional
Plate number.
- mjdinteger, optional
Modified Julian Date indicating the date a given piece of SDSS data was taken.
- fiberIDinteger, optional
Fiber number.
- fieldslist, optional
SDSS PhotoObj or SpecObj quantities to return. If None, defaults to quantities required to find corresponding spectra and images of matched objects (e.g. plate, fiberID, mjd, etc.).
- timeoutfloat, optional
Time limit (in seconds) for establishing successful connection with remote server. Defaults to
SDSSClass.TIMEOUT
.- field_help: str or bool, optional
Field name to check whether a valid PhotoObjAll or SpecObjAll field name. If
True
or it is an invalid field name all the valid field names are returned as a dict.- get_query_payloadbool, optional
If True, this will return the data the query would have sent out, but does not actually do the query.
- data_releaseint, optional
The data release of the SDSS to use.
- cachebool
Defaults to True. If set overrides global caching behavior. See caching documentation.
- Returns:
Examples
>>> from astroquery.sdss import SDSS >>> result = SDSS.query_specobj(plate=2340, ... fields=['ra', 'dec','plate', 'mjd', 'fiberID', 'specobjid']) >>> print(result[:5]) ra dec plate mjd fiberID specobjid ------------- ------------- ----- ----- ------- ------------------- 49.2020613611 5.20883041368 2340 53733 60 2634622337315530752 48.3745360119 5.26557511598 2340 53733 154 2634648175838783488 47.1604269095 5.48241410994 2340 53733 332 2634697104106219520 48.6634992214 6.69459110287 2340 53733 553 2634757852123654144 48.0759195428 6.18757403485 2340 53733 506 2634744932862027776
- query_sql(*args, **kwargs)¶
Queries the service and returns a table object.
Query the SDSS database.
- Parameters:
- sql_querystr
An SQL query
- timeoutfloat, optional
Time limit (in seconds) for establishing successful connection with remote server. Defaults to
SDSSClass.TIMEOUT
.- data_releaseint, optional
The data release of the SDSS to use.
- cachebool
Defaults to True. If set overrides global caching behavior. See caching documentation.
- Returns:
- tableA
Table
object.
- tableA
Examples
>>> from astroquery.sdss import SDSS >>> query = "select top 10 z, ra, dec, bestObjID from specObj where class = 'galaxy' and z > 0.3 and zWarning = 0" >>> res = SDSS.query_sql(query) >>> print(res[:5]) z ra dec bestObjID --------- --------- --------- ------------------- 0.3000011 16.411075 4.1197892 1237678660894327022 0.3000012 49.459411 0.847754 1237660241924063461 0.3000027 156.25024 7.6586271 1237658425162858683 0.3000027 256.99461 25.566255 1237661387086693265 0.300003 175.65125 34.37548 1237665128003731630
- query_sql_async(sql_query, *, timeout=60, data_release=17, cache=True, **kwargs)[source]¶
Query the SDSS database.
- Parameters:
- sql_querystr
An SQL query
- timeoutfloat, optional
Time limit (in seconds) for establishing successful connection with remote server. Defaults to
SDSSClass.TIMEOUT
.- data_releaseint, optional
The data release of the SDSS to use.
- cachebool
Defaults to True. If set overrides global caching behavior. See caching documentation.
- Returns:
Examples
>>> from astroquery.sdss import SDSS >>> query = "select top 10 z, ra, dec, bestObjID from specObj where class = 'galaxy' and z > 0.3 and zWarning = 0" >>> res = SDSS.query_sql(query) >>> print(res[:5]) z ra dec bestObjID --------- --------- --------- ------------------- 0.3000011 16.411075 4.1197892 1237678660894327022 0.3000012 49.459411 0.847754 1237660241924063461 0.3000027 156.25024 7.6586271 1237658425162858683 0.3000027 256.99461 25.566255 1237661387086693265 0.300003 175.65125 34.37548 1237665128003731630