sunset: A database of synthetic atmospheric-escape transmission spectra for nearly every transiting exoplanet

This sunset version belongs to the arXiv paper. The transmission spectra are the same as the A&A paper, but some of the TSM metrics are different, as well as the instructions to recreate the models with sunbather (which use the legacy version of the code (v0.9), not the pip-installable version (v1.0.0)).

This repository contains the sunset database of atmospheric-escape transmission spectra for most currently known transiting exoplanets. This database is described in Linssen et al. (in review). The complete zipped (unzipped) database is ~5GB (~28GB). To prevent a huge download just to access a specific single planet model, we have uploaded sunset in a few different batches. The "zip_dictionary.txt" file lists each planet and which zip batch it is in. 

For each planet, there are three files:
- The "info" file contains warnings that pertain to that planet specifically (for general warnings that apply to each planet, see Linssen et al. 2024b). It also lists the used planetary parameters, and the transit depth, equivalent width and line transmission spectroscopy metric for a few spectral lines. Finally, it gives simple step-by-step instructions on how to reproduce the model results using sunbather: www.github.com/dlinssen/sunbather.
- The "spectrum_sparse" file contains the transmission spectrum. In principle, the spectrum runs from 911 to 11,000 angstroms in 1,000,000 bins (translating to R~400,000). However, in large portions of this wavelength grid, there are no spectral lines and the transit spectrum is simply equal to the continuum. To keep the file size to a minimum, we have removed those continuum regions from the spectrum, resulting in a "sparse" spectrum.
- The "structure" file contains the radial atmospheric structure profiles of the density, velocity, temperature and mean molecular weight.

Additionally, this repository includes "included_lines_by_species.txt" and "included_lines_by_wavelength.txt", which list all the spectral lines that are present in the transmission spectra. Lines are labeled by the specific ion that they originate from, as well as the energy level. The energy level is expressed as a number, where 1 is the ground state, 2 is the first excited state, etc. Translating this energy level into the atomic configuration can be done by looking in the sunbather source code: in the /sunbather/src/RT_tables/ folder, each ion has a file such as "Fe+_levels_processed.txt", which lists the energy levels and their atomic configurations.

Finally, there is a large tabular file called "sunset_overview.csv". This file includes the NASA Exoplanet Archive parameters of each exoplanet. Additionally, there are some columns that we added, with calculated variables such as the atmospheric mass-loss rate, the Parker wind temperature, and line depths, equivalent widths, and TSM metrics for various spectral lines. See the file header for explanation of each column. The file can easily be read in Python using pandas.read_csv("sunset_overview.csv", comments="#")