skyscapes.io

Data loaders for external simulation formats.

Submodules

• skyscapes.io._frames
• skyscapes.io.exovista

Functions

from_exovista(fits_file[, planet_indices, only_earths])	Load an ExoVista FITS file into a scene.System.
get_earth_like_planet_indices(fits_file)	Identify Earth-like planets in an ExoVista FITS file.

Package Contents

skyscapes.io.from_exovista(fits_file, planet_indices=None, only_earths=False)

Load an ExoVista FITS file into a scene.System.

The system’s midplane inclination and position angle (FITS star header keys I and PA) are applied at load time as a frame rotation of each planet’s state vector before its Keplerian elements are computed. The same angles are stored as System.midplane_inc_deg and System.midplane_pa_deg for downstream diagnostic use.

Args:

fits_file: Path to ExoVista FITS file. planet_indices: Planet indices to load (0-based). None = all. only_earths: If True and planet_indices is None, auto-filter Earths.

Returns:

scene.System with star, planets (tuple), disk, and midplane metadata.

Parameters:

• fits_file (str)

• planet_indices (collections.abc.Sequence[int] | None)

• only_earths (bool)

Return type:

skyscapes.scene.System

skyscapes.io.get_earth_like_planet_indices(fits_file)

Identify Earth-like planets in an ExoVista FITS file.

Classification criteria:

• Scaled semi-major axis: 0.95 <= a / sqrt(L_star) < 1.67 AU

• Planet radius: 0.8 / sqrt(a_scaled) <= R < 1.4 R_earth

Parameters:

fits_file (str)

Return type:

list[int]