Skip to article frontmatterSkip to article content
Site not loading correctly?

This may be due to an incorrect BASE_URL configuration. See the MyST Documentation for reference.

โฑ๏ธ Quickstart

Letโ€™s take a brief whirlwind tour of some of the basic tools in exoatlas. Most of the concepts seen here are described in more detail later, but hopefully this is enough for you to get started!

import exoatlas as ea
import exoatlas.visualizations as vi
import astropy.units as u

ea.version()
'0.7.8'

๐ŸŒŒ Make Populations of Planetsยถ

exoatlas can create objects containing properties for large samples of planets. Solar System planets come from JPL Solar System Dynamics, and exoplanets come from the NASA Exoplanet Archive.

solar = ea.SolarSystem()
solar
โœจ Solar System | 8 elements โœจ
exoplanets = ea.Exoplanets()
exoplanets
โœจ Exoplanets | 6128 elements โœจ

๐Ÿงฎ Extract Quantities and Uncertaintiesยถ

For a population, exoatlas can provide easy access to archival table columns and their uncertainties. All quantities have astropy.units attached to them, to minimize confusion about unit conversion.

exoplanets.mass()
Loading...
exoplanets.mass_uncertainty()
Loading...

exoatlas can also calculate derived quantities and use astropy.uncertainty to propagate uncertainties for those derived quantities.

exoplanets.insolation()
Loading...
exoplanets.insolation_uncertainty()
Loading...
exoplanets.insolation_uncertainty() / exoplanets.insolation()
Loading...

โš—๏ธ Filter Populations by Propertiesยถ

exoatlas can extract subsets of populations, selecting planets just in a specific range of interest for particular properties. These subsets have all the same powers as their parent populations. By setting attributes for these subset populations, we can affect how theyโ€™ll be visualized.

nearby = exoplanets[exoplanets.distance() < 30 * u.pc]
nearby.label = "Nearby"
nearby.color = "coral"
nearby.marker = "P"
nearby.size = 20
nearby
โœจ Nearby | 518 elements โœจ
easy = exoplanets[
    exoplanets.transmission_snr(telescope="JWST", wavelength=4 * u.micron) > 10
]
easy.label = "Easy"
easy.color = "orchid"
easy.marker = "*"
easy.outlined = True
easy.filled = False
easy.size = 100
easy.annotate_planets = True
easy
โœจ Easy | 9 elements โœจ
first = exoplanets["HD209458b"]
first.size = 500
first.color = "magenta"
first
โœจ HD209458b | 1 elements โœจ

๐ŸŽจ Visualize Populations Togetherยถ

exoatlas provides some built-in visualizations, as well as a framework for constructing new plots that can easily compare multiple populations to each other.

ps = vi.PlanetGallery()
ps.build([solar, exoplanets, nearby, easy, first])
<Figure size 1000x500 with 4 Axes>

Gosh, what a complicated plot! But at least it demonstrates lots of ways of visualizing populations!

๐Ÿ““ Create Tablesยถ

exoatlas can save populations out into tables, for whatever other purposes you want!

easy.create_table()
Loading...

๐ŸŽ‰ and more...ยถ

Please explore the rest of the documentation to learn if/how you can use exoatlas to help with your research or teaching or learning!