Chandra X-Ray Observatory
Skip to the navigation links
Last modified: 8 November 2018


Scripts & Modules Package

The CIAO Scripts and Modules Package contains analysis scripts and Python modules written by scientists at the CXC; see the list of scripts and modules. The scripts and modules automate repetitive tasks and extend the functionality of the CIAO software package by filling specific analysis needs.

The Script Version History has a record of all changes made to the scripts package since the CIAO 4.10 release.

These scripts and modules are not official CIAO tools. The user is responsible for the validity of any scientific results obtained from the analysis. Known issues with the scripts and modules are included in the CIAO bug pages.

Software Requirements

The scripts package depends on the components of the "standard" CIAO software installation: tools, ChIPS, Sherpa, and the CALDB. If you have installed a customized version of CIAO, it is possible that some of the scripts and modules will fail due to a missing package.


The scripts package can be installed and updated with the ciao-install script or manually added to your CIAO installation.

  1. ciao-install: run the installation script from the command line:

    unix% bash /<path>/ciao-install

    If the scripts package is not installed or there is a newer version, the CIAO installation is updated.

  2. To manually update the CIAO installation, download the current tarfile:

    Last Updated: 7 November 2018

    The scripts package should be unpacked from the directory which contains the root on the CIAO installation. For instance, if CIAO is installed in /soft/ciao-4.10/, the scripts package should be unpacked in /soft.

Keeping the installation current

A VERSION.CIAO_scripts file is included in the scripts package and is updated in each scripts package release. This allows you to check if you are working with the most recent script release:

unix% cat $ASCDS_CONTRIB/VERSION.CIAO_scripts 
scripts 4.10.3 Wednesday, November 7, 2018

The check_ciao_version script will also tell you if the scripts package should be updated:

unix% check_ciao_version
Using the CIAO installation at /soft/ciao-4.10

The following package:
    contrib   :  scripts 4.10.2 Tuesday, May 15, 2018
needs updating to:
    contrib   :  scripts 4.10.3 Wedesday, November  7, 2018

The CALDB installation at /soft/ciao-4.10/CALDB (link to
/data/CALDB/ciao) is up to date.

Please use the ciao-install script from
to update your CIAO installation.

The Script Version History has a record of all changes made to the scripts package since the CIAO 4.10 release.

Last modified: 8 November 2018
Smithsonian Institute Smithsonian Institute

The Chandra X-Ray Center (CXC) is operated for NASA by the Smithsonian Astrophysical Observatory. 60 Garden Street, Cambridge, MA 02138 USA.   Email: Smithsonian Institution, Copyright © 1998-2017. All rights reserved.