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.16 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.
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.16.2 Tuesday, August 20, 2024
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.16
The following package:
contrib : scripts 4.16.1 Monday, April 1, 2024
needs updating to:
contrib : scripts 4.16.2 Tuesday, August 20, 2024
The CALDB installation at /soft/ciao-4.16/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.16 release.