kohn - tah - mee - nahn - teh

A package to help find the contaminant transiting source in NASA's Kepler, K2 or TESS data. When hunting for transiting planets, sometimes signals come from neighboring contaminants. This package helps users identify where the transiting signal comes from in their data.

What does contaminante do?

contaminante uses pixel level modeling of the TargetPixelFile data from NASA's astrophysics missions that are processed with the Kepler pipeline. The output of contaminante is a Python dictionary containing the source location and transit depth, and a contaminant location and depth. Optionally you can output a figure showing

  1. Where the main target is centered in all available TPFs.
  2. What the phase curve looks like for the main target
  3. Where the transiting source is centered in all available TPFs, if a transiting source is located outside the main target
  4. The transiting source phase curve, if a transiting source is located outside the main target

An example output is shown below for a target with a transiting contaminant.

Where as a transit that is centered on the target gives the following output:

How do I use contaminante?

You can check out our tutorial for how to run contaminante. To run contaminante you will need a target name, a transit period, a transit center and a transit duration.

How do I install contaminante?

You can install contaminante using pip:

pip install contaminante --upgrade

You can also install contaminante by cloning this repo:

git clone
cd contaminante
python install

Help, I can't install contaminante!

You might not be able to install contaminante because your computer doesn't support some of the features, or perhaps you're new to Python. Don't worry, you can still use contaminante! If you're struggling to install, try running contaminante online using Google's Colaboratory. You can click here to open a new Colaboratory notebook and run contaminante in the cloud!


contaminante uses the most up to date version of lightkurve, and uses some of the features available in v2.0. Make sure your lightkurve installation is up to date before using contaminante.