skip to navigation
skip to content

Not Logged In

ChiantiPy 0.5.2

a Python interface to the CHIANTI atomic database for astrophysical spectroscopy

Latest Version: 0.5.3

Welcome to ChiantiPy

changes from 0.5.1 to 0.5.2

this is another bugfix release

updating to this version is VERY STRONGLY suggested.

Changes from 0.5 to 0.5.1

this release fixes a major bug in ion.upsilonDescale.

updating to this version is VERY STRONGLY suggested.

Changes from 0.4.1 to 0.5

Changes have been made to reflect the names of the abundance files in CHIANTI database Version 7.1

The ion class has a new method - emissList - to provide a list of lines in a given wavelength range

The ion.intensityRatio has a new keyword argument wvlRanges so that by setting wvlRanges =[[100.,200.],[500.,600]], the top number of lines will be compiled from with the two specified ranges only, i.e., 201-499 will not be included.

What is ChiantiPy

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.

Detailed information can be found at


CHIANTI provides a database of atomic data that can be used to interpret the emission of spectral lines and continuua 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.

Getting started with ChiantiPy


  • Python ( latest 2.X version; not yet compatible with version 3)
  • Numpy
  • Scipy
  • Matplotlib
  • [Optional] PyQt4 or wxPython
  • CHIANTI, the atomic database for astrophysical spectroscopy

In addition, the FortranFormat module from Scientific Python, developed by Konrad Hinsen of the Centre de Biophysique Moleculaire (, is included in this distribution for simplicity.

Installing the CHIANTI database

The gzipped data tar ball can be downloaded from the CHIANTI website

  • put the file in a convenient directory, cd to the directory and untar the file
  • ChiantiPy uses the environment variable XUVTOP to find the database. Set XUVTOP to the name of the directory where the CHIANTI data tarball was placed. For example

> setenv XUVTOP /data1/xuv/directory.where.the.tarball.was.placed

Some sites have the CHIANTI database maintained as part of a SolarSoft distribution. In that case, simply set XUVTOP to the directory were it exists, usually something like $SSW/packages/chianti/dbase

Installing the ChiantiPy package

The ChiantiPy package can be downloaded from the ChiantiPy, untar it, cd to the directory where it was unpacked, and then, as root

> python install

If you do not have root privileges, simply put the ChiantiPy directory (simply called 'chianti') in your PYTHONPATH

Running ChiantiPy

The documentation can be found on its web page ChiantiPy

In particular, a quick start guide is included which should get you up and running fairly quickly.

Keeping track of ChiantiPy

There is a mailing list that you can subscribe to at In order to subscribe it is first necessary to obtain a user account from This is a straightforward process.

  • Downloads (All Versions):
  • 32 downloads in the last day
  • 97 downloads in the last week
  • 501 downloads in the last month