Skip to main content
ExoCTK Logo https://img.shields.io/github/release/ExoCTK/exoctk.svg https://img.shields.io/github/license/ExoCTK/exoctk.svg Build status Test status https://readthedocs.org/projects/exoctk/badge/?version=latest https://zenodo.org/badge/DOI/10.5281/zenodo.4556063.svg https://img.shields.io/badge/powered%20by-STScI-blue.svg?colorA=707170&colorB=3e8ddd&style=flat

Introduction

ExoCTK is an open-source, modular data analysis package focused primarily on atmospheric characterization of exoplanets. The subpackages included are:

  • Contamination and Visibility Calculator

  • Integrations and Groups Calculator

  • Transit Light-Curve Fitter

  • Limb Darkening Calculator

  • Phase Constraint Calculator

  • Atmospheric Forward Modeling

For more information on each package visit our documentation at readthedocs.

Most packages are also available through interactive tools at our web portal.

Installation

The following are instructions on how to install the exoctk package for both users and contributors. The exoctk repository provides a conda environment containing all of the dependencies needed to install and execute the exoctk software.

Download Anaconda or Miniconda

You must first have a working installation of conda (or mamba) for Python 3. If you do not yet have this on your system, you can visit the following links for download and installation instructions:

Obtain the exoctk Package

To obtain the exoctk package with the necessary environment file, clone the repository directly from GitHub:

git clone https://github.com/ExoCTK/exoctk.git
cd exoctk

Environment Installation

You can create the ExoCTK conda environment via the exoctk-env.yml file with the following conda (or mamba) command:

conda env create -f exoctk-env.yml

One can activate the newly-created environment with:

conda activate exoctk-env

After activating the environment, install exoctk from the cloned source.

Package Installation From Source

To install the latest development version of exoctk use pip to install directly from the cloned source:

pip install -e .

Obtain the exoctk Data

To obtain the necessary data to run ExoCTK, you just need to execute the exoctk.utils.download_exoctk_data() function. This function will download a series of compressed files, extract the files, and organize them into an exoctk_data/ directory. Note that this can only be done once the exoctk package has been fully installed (see instructions above).

Lastly, export an environment variable for EXOCTK_DATA.

  • For Mac OS/Linux, add the line

export EXOCTK_DATA='/path/to/your/unzipped/directory/exoctk_data/'

to your .bashrc or .bash_profile.

  • For Windows, add an environment variable using System Utility.

Missing Dependencies?

If you find that the exoctk environment is missing a required dependency, please feel free to submit a GitHub Issue detailing the problem.

Citation

If you use ExoCTK for work/research presented in a publication (whether directly, or as a dependency to another package), we recommend and encourage the following acknowledgment:

This research made use of the open source Python package exoctk, the Exoplanet Characterization Toolkit (Bourque et al, 2021).

where (Bourque et al, 2021) is a citation of the Zenodo record, e.g.:

@software{matthew_bourque_2021_4556063,
  author       = {Matthew Bourque and
                  Néstor Espinoza and
                  Joseph Filippazzo and
                  Mees Fix and
                  Teagan King and
                  Catherine Martlin and
                  Jennifer Medina and
                  Natasha Batalha and
                  Michael Fox and
                  Jules Fowler and
                  Jonathan Fraine and
                  Matthew Hill and
                  Nikole Lewis and
                  Kevin Stevenson and
                  Jeff Valenti and
                  Hannah Wakeford},
  title        = {The Exoplanet Characterization Toolkit (ExoCTK)},
  month        = feb,
  year         = 2021,
  publisher    = {Zenodo},
  version      = {1.0.0},
  doi          = {10.5281/zenodo.4556063},
  url          = {https://doi.org/10.5281/zenodo.4556063}
}

Want to stay up-to-date with our releases and updates?

Subscribe to our newsletter by sending an email with a blank body and subject to exoctk-news-subscribe-request@maillist.stsci.edu from the email you want to enroll. You should then receive a confirmation email with instructions on how to confirm your subscription, please be sure to do so within 48 hours.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

exoctk-2026.7.tar.gz (21.6 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

exoctk-2026.7-py3-none-any.whl (21.0 MB view details)

Uploaded Python 3

File details

Details for the file exoctk-2026.7.tar.gz.

File metadata

  • Download URL: exoctk-2026.7.tar.gz
  • Upload date:
  • Size: 21.6 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for exoctk-2026.7.tar.gz
Algorithm Hash digest
SHA256 5a743d1c2ce03d33ff6c7f3b52bbf4552e6c5851c58450a81abc8b4841f26058
MD5 da844f3ba1b07dd8b143acd482e51461
BLAKE2b-256 7beaa77b71adb11b7c87845476b5261b7a9dd275a2eca825b548b24ace21e34b

See more details on using hashes here.

Provenance

The following attestation bundles were made for exoctk-2026.7.tar.gz:

Publisher: build.yml on ExoCTK/exoctk

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file exoctk-2026.7-py3-none-any.whl.

File metadata

  • Download URL: exoctk-2026.7-py3-none-any.whl
  • Upload date:
  • Size: 21.0 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for exoctk-2026.7-py3-none-any.whl
Algorithm Hash digest
SHA256 62f0347f878953a6b3175529d62b26089e26b353724452aa54b13b5c8cea88b7
MD5 6a6ca400ffff390aad2f94f54e2ff458
BLAKE2b-256 4f416a0dffa409a269598d45f59cae8f4f47e70da67cdfc51c8985e8eabca125

See more details on using hashes here.

Provenance

The following attestation bundles were made for exoctk-2026.7-py3-none-any.whl:

Publisher: build.yml on ExoCTK/exoctk

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

2026.7 This release

2 files

1.2.6

2 files

1.2.5

2 files

1.1.0

2 files

1.0.0

2 files

0.4.0

3 files

0.2.3

1 file

0.2.1

1 file

0.1.3

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page