Skip to main content

a Python interface to the CHIANTI atomic database for astrophysical spectroscopy

Project description

Documentation Status Coverage Status ascl:1308.017

ChiantiPy is the Python interface to the CHIANTI atomic database for astrophysical spectroscopy. It provides the capability to calculate the emission line and continuum spectrum of an optically thin plasma based on the data in the CHIANTI database.

What is CHIANTI?

CHIANTI provides a database of atomic data that can be used to interpret the emission of spectral lines and continua emitted from high-temperature, optically-thin astrophysical sources. The CHIANTI project provides a suite of routines written in Interactive Data Language (IDL) to access the database and calculate various quantities for use in interpreting observed spectra or producing synthetic spectra. As of ChiantiPy 0.10.0, the CHIANTI database version 10 or later is required


The following dependencies are required to run ChiantiPy,

The following two are extremely useful for running Python programs

Optionally, if you’d like to use the GUI dialogs,

If you are not familiar with installing Python and the needed dependencies, we recommend the Anaconda platform. Next, download the CHIANTI database, version 10.0 or later. Assuming you’ve placed the CHIANTI tree in $HOME, set the environment variable in your .bashrc file,


should point to the top directory of your CHIANTI distribution

Finally, clone and install the source from GitHub,

$ git clone --recursive
$ cd ChiantiPy
$ python install

The release is also available on PyPI


As a quick example, we’ll calculate the populations of the top 10 levels of Fe XIV as a function of temperature at constant density and plot them:

>>> import ChiantiPy.core as ch
>>> import numpy as np
>>> import matplotlib.pyplot as plt
>>> temperature = np.logspace(5.8,6.8,21)
>>> fe14 = ch.ion('fe_14',temperature=temperature,eDensity=1.e+9,em=1.e+27)
>>> fe14.popPlot()


For more information about installing and using either ChiantiPy or the CHIANTI atomic database, check out the following links:

Project details

Download files

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

Source Distribution

ChiantiPy-0.15.1.tar.gz (8.2 MB view hashes)

Uploaded source

Built Distribution

ChiantiPy-0.15.1-py3-none-any.whl (170.8 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page