species provides a coherent framework for spectral and photometric analysis of directly imaged exoplanets and brown dwarfs. This page contains a overview of the various data that are supported and some of the tools and features that are available.

Supported data#

The toolkit benefits from publicly available data resources such as atmospheric model spectra, photometric and spectral libraries, evolutionary tracks, and photometry of directly imaged companions. The relevant data are automatically downloaded and added to the HDF5 database, which acts as the central data storage for a workflow. All data are stored in a fixed format such that the analysis and plotting tools can easily access and process the data.

The following data and models are currently supported:

Atmospheric models


It is also possible to add your own custom grid of model spectra with add_custom_model(). Have a look at the documentation for details on the required file format.


The available_models() method of the Database class can be used for getting a complete overview of all model grids, including details on the input parameters, wavelength range, \(T_\mathrm{eff}\) range, and spectral resolution:

import species


database = species.Database()

Evolutionary models

Spectral libraries

Photometric libraries


Dust extinction

Please give credit to the relevant references when using any of the external data in a publication. More information is available on the respective websites. Support for other datasets can be requested by creating an issue on the Github page.

Analysis tools#

After adding the relevant data to the database, the user can take advantage of the suite of tools that have been implemented for spectral and photometric analysis. Here is an incomplete list of available features and tools: