Developing a More Integrated NASA Exoplanet Archive

The NASA Exoplanet Archive team's effort to provide a more integrated and streamlined user experience is now complete.

A significant part of this transition has been the development of the new Planetary Systems (PS) and the Planetary Systems Composite Parameters (PSCompPars) tables, which are more integrated and more complete than the retired Confirmed Planets, Extended Planet Parameters, and Composite Parameters tables.

The PS Table combines data from the Confirmed Planets and Extended Planet Parameters tables (both retired) into a single table, and provides access to all of the planetary solutions served by the NASA Exoplanet Archive in a single location.

The PSCompPars Table is similar to the retired Composite Parameters Table: it's a more complete table of planet parameters combined from multiple references and calculations. The new PSCompPars Table is built from the new PS Table, and is thus more extensive and more complete.


As of April 2021, the Confirmed Planets, Extended Planet Parameters, and Composite Parameters tables are retired and no longer updated. Please use the PS and PSCompPars tables for planetary system data. Additional details are in the Archive 2.0 Release Notes.


Query-based Data Access with Table Access Protocol (TAP)

In addition to the new integrated content of the Planetary Systems tables, the new tables are connected to a new Table Access Protocol (TAP) service for a more IVOA-integrated experience.

Read the NASA Exoplanet Archive TAP User Guide to learn how to use TAP to extract data from the archive's data tables. A list of which archive tables currently support TAP is at the top of the page.


Which Data Table Should You Use?

Use the following table and this graphic as a guide. (Click to enlarge)

 

Table NameContains...Status
Planetary Systems (PS) All data from the Confirmed Planets and Extended Planet Data tables. Displays all solutions for planet and host star solutions, regardless of their relationship, including atypical systems such as free-floating planets and those with multiple stars. Also contains Kepler, K2, and TESS candidate solutions for confirmed planet systems, a nearly complete identification of published stellar companions, and projected and true planet obliquities. Each set of parameters is displayed in a separate row.

Use this table when you need a self-consistent set of planetary parameters for a given planet, or if you want a comprehensive list of published planet parameters in the archive.

Fully operational as of April 2021. See the Archive 2.0 Release Notes for details.

Available as:

Planetary Systems Composite Parameters (PSCompPars) Same data as the Planetary Systems table except the confirmed planet data includes parameters or calculations that are combined from different references into one parameter set, or row. References are given for each value.

Use this table when you need a more "filled-in" table to enable a statistical view of the known exoplanet population and their host environments.

Differences between the PS and PSCompPars tables: (Click to enlarge)

Fully operational as of April 2021. See the Archive 2.0 Release Notes for details.

Available as:

Documentation:

Confirmed Planets All confirmed planets with one default set of self-consistent, published parameters. How the archive designates parameter sets as default is explained in our FAQ. Retired in April 2021. Replaced by the Planetary Systems Table.

This table is no longer updated and API support will be discontinued in late August 2021. Please use the TAP service to retrieve data from the PS Table.

Extended Planet Data All confirmed planets with all self-consistent sets of published parameters—those both designated as default by the archive as well as non-default. Each set of parameters is displayed in a separate row. Retired in April 2021. Replaced by the Planetary Systems Table.

This table is no longer updated and API support will be discontinued in late August 2021. Please use the TAP service to retrieve data from the PS Table.

Composite Planet Data (a.k.a. Composite Parameters) All confirmed planets with parameters or calculations combined from different references. Retired in April 2021. Replaced by the Planetary Systems Composite Parameters Table.

This table is no longer updated and API support will be discontinued in late August 2021. Please use the TAP service to retrieve data from the PSCompPars Table.

K2 Planets and Candidates All information in the archive on K2 planetary objects, both confirmed and candidates. This is a new table that replaced the K2 Candidates table in November 2021. Please update any API queries to use the TAP service to retrieve data from the K2 Planets and Candidates Table.

Documentation:

Making the Transition

To help with the transition, the Exoplanet Archive provides some resources.

If you used the archive's application programming interface (API) for query-based data retrieval from the retired tables, you need to create new queries to use the archive's Table Access Protocol service that point to one of the new tables. The database columns names in the PS and PSCompPars tables are different than those used in the retired tables. The following documents will help you identify which new database names to use for your scripts/queries:

  • Master list of columns in the PS, PSCompPars, Confirmed Planets, Extended Planet Data, and Composite Parameters tables: PDF  CSV
  • Column mapping between the new PS Table and the retired Confirmed Planets, and Extended Planet Data tables: PDF  CSV
  • Column mapping between the new PSCompPars Table and the retired Composite Parameters Table: PDF  CSV
  • A list of parameters in the Confirmed Planets, Extended Planet Data and Composite Parameters tables, but not in the PS Table: PDF  CSV
  • Column names mapping document between old microlensing and new ML tables (for queries created before April 2021): PDF CSV
  • Column names mapping document between old K2 Candidates and new K2 Planets and Candidates tables (for queries created before November 2021): PDF CSV

Tell Us What You Think

As always, we want to hear your feedback on what is working and what can be improved. Please send us your feedback through the Helpdesk, follow the archive on social media, or subscribe to our email list to stay informed. See our Connect page for links.

 

See also:



Last updated: 19 November 2021