NASA Exoplanet Archive (astroquery.nasa_exoplanet_archive
)¶
This module can be used to query the NASA Exoplanet Archive via the API. A full discussion of the available tables and query syntax is available at 1.
Query methods¶
The query_object
method can be used to query for a specific planet or planet host.
For example, the following query searches the exoplanets
table of confirmed exoplanets for information about the planet K2-18 b.
>>> from astroquery.nasa_exoplanet_archive import NasaExoplanetArchive
>>> NasaExoplanetArchive.query_object("K2-18 b")
<QTable masked=True length=1>
pl_hostname pl_letter pl_name ... rowupdate pl_facility sky_coord
... deg,deg
str5 str1 str7 ... str10 str2 object
----------- --------- ------- ... ---------- ----------- -------------------
K2-18 b K2-18 b ... 2019-03-21 K2 172.560455,7.588391
Similarly, cone searches can be executed using the query_region
method:
>>> import astropy.units as u
>>> from astropy.coordinates import SkyCoord
>>> from astroquery.nasa_exoplanet_archive import NasaExoplanetArchive
>>> NasaExoplanetArchive.query_region(
... table="exoplanets", coordinates=SkyCoord(ra=172.56 * u.deg, dec=7.59 * u.deg),
... radius=1.0 * u.deg)
<QTable masked=True length=2>
pl_hostname pl_letter pl_name ... dist angle sky_coord
... deg,deg
str5 str1 str7 ... float64 float64 object
----------- --------- ------- ... -------- ---------- -------------------
K2-18 b K2-18 b ... 6.016586 164.332463 172.560455,7.588391
K2-18 c K2-18 c ... 6.016586 164.332463 172.560455,7.588391
The most general queries can be performed using the query_criteria
method.
For example, a full table can be queried as follows:
>>> from astroquery.nasa_exoplanet_archive import NasaExoplanetArchive
>>> NasaExoplanetArchive.query_criteria(table="cumulative", select="*")
<QTable masked=True length=9564>
kepid kepoi_name kepler_name ... koi_fittype koi_score sky_coord
... deg,deg
int64 str9 str15 ... str7 float64 object
-------- ---------- ------------ ... ----------- --------- -------------------
10797460 K00752.01 Kepler-227 b ... LS+MCMC 1.0 291.93423,48.141651
10797460 K00752.02 Kepler-227 c ... LS+MCMC 0.969 291.93423,48.141651
... ... ... ... ... ... ...
10155286 K07988.01 -- ... LS+MCMC 0.092 296.76288,47.145142
10156110 K07989.01 -- ... LS+MCMC 0.0 297.00977,47.121021
Example queries¶
Specific searches can be executed using the where
, select
, order
, and other parameters as described in the documentation 1.
In this section, we demonstrate
The number of confirmed planets discovered by TESS:
>>> from astroquery.nasa_exoplanet_archive import NasaExoplanetArchive
>>> NasaExoplanetArchive.query_criteria(table="exoplanets", select="count(*)",
... where="pl_facility like '%TESS%'")
<QTable length=1>
count(*)
int64
--------
45
The list of confirmed planets discovered by TESS and their coordinates:
>>> from astroquery.nasa_exoplanet_archive import NasaExoplanetArchive
>>> NasaExoplanetArchive.query_criteria(table="exoplanets", select="pl_hostname,ra,dec",
... where="pl_facility like '%TESS%'")
<QTable length=45>
pl_hostname ra dec sky_coord
deg deg deg,deg
str11 float64 float64 object
----------- ---------- ---------- ---------------------
HD 39091 84.291214 -80.469124 84.291214,-80.469124
HD 219666 349.556792 -56.903786 349.556792,-56.903786
... ... ... ... ...
HD 221416 353.03363 -21.801424 353.03363,-21.801424
TOI-150 112.965667 -73.606153 112.965667,-73.606153
The list of confirmed planets discovered using microlensing that have data available in the archive:
>>> from astroquery.nasa_exoplanet_archive import NasaExoplanetArchive
>>> NasaExoplanetArchive.query_criteria(
... table="exoplanets", where="pl_discmethod like 'Microlensing' and st_nts > 0")
<QTable masked=True length=32>
pl_hostname pl_letter ... pl_facility sky_coord
... deg,deg
str21 str1 ... str4 object
--------------------- --------- ... ----------- ---------------------
MOA-2011-BLG-028L b ... MOA 270.854,-29.213417
OGLE-2012-BLG-0724L b ... OGLE 268.968292,-29.818528
... ... ... ... ...
MOA-2011-BLG-262L b ... MOA 270.097833,-31.245258
OGLE-2015-BLG-0966L b ... OGLE 268.75425,-29.047111
The list of confirmed planets where the host star name starts with “Kepler” using a wildcard search:
>>> from astroquery.nasa_exoplanet_archive import NasaExoplanetArchive
>>> NasaExoplanetArchive.query_criteria(
... table="exoplanets", where="pl_hostname like 'Kepler%'", order="pl_hostname")
<QTable masked=True length=2312>
pl_hostname pl_letter pl_name ... rowupdate pl_facility sky_coord
... deg,deg
str12 str1 str14 ... str10 str34 object
----------- --------- ------------- ... ---------- ----------- --------------------
Kepler-10 c Kepler-10 c ... 2017-07-27 Kepler 285.679394,50.241299
Kepler-10 b Kepler-10 b ... 2015-10-15 Kepler 285.679394,50.241299
... ... ... ... ... ... ...
Kepler-998 b Kepler-998 b ... 2016-05-10 Kepler 296.754151,49.208744
Kepler-999 b Kepler-999 b ... 2016-05-10 Kepler 299.660466,46.198418
The Kepler Objects of Interest that were vetted more recently than January 24, 2015 using a date search:
>>> from astroquery.nasa_exoplanet_archive import NasaExoplanetArchive
>>> NasaExoplanetArchive.query_criteria(
... table="koi", where="koi_vet_date>to_date('2015-01-24','yyyy-mm-dd')",
... select="kepoi_name,koi_vet_date", order="koi_vet_date")
<QTable length=34652>
kepoi_name koi_vet_date
str9 str10
---------- ------------
K00866.01 2015-09-24
K00867.01 2015-09-24
... ...
K06824.01 2018-08-16
K06825.01 2018-08-16
References¶
Reference/API¶
astroquery.nasa_exoplanet_archive Package¶
NASA Exoplanet Archive Query Tool¶
Module to query the NASA Exoplanet Archive via the API.
Classes¶
The interface for querying the NASA Exoplanet Archive API |
|
Configuration parameters for |