Skip to the navigation links
Last modified: 22 August 2023

URL: https://cxc.cfa.harvard.edu/ciao/download/scripts/index.html

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.15 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, 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.

Installation

The scripts package can be installed and updated with either conda or the ciao-install script, or manually added to your CIAO installation (which should only be done for ciao-install installations).

conda

The conda tool can be used to update the package. First we check what will get updated

unix% conda update --no-update-deps -c https://cxc.cfa.harvard.edu/conda/ciao -c conda-forge ciao-contrib --dry-run

and then we can apply these changes with

unix% conda update --no-update-deps -c https://cxc.cfa.harvard.edu/conda/ciao -c conda-forge ciao-contrib
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.

Manual

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

Last Updated: 21 August 2023

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.15/, 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.15.3 Monday, August 21, 2023

The check_ciao_version script will also tell you if the scripts package should be updated. The exact output depends on whether you have a conda or ciao-install installation; the following is from a ciao-install installation.

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

The following package:
    contrib   :  scripts 4.15.2 Wednesday, June  7, 2023
    
needs updating to:
    contrib   :  scripts 4.15.3 Monday, August 21, 2023

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

Please use the ciao-install script from
   http://cxc.harvard.edu/ciao/download/
to update your CIAO installation.

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