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


Downloading CIAO 4.10 and CALDB 4.8.1

The default CIAO installation uses Python 3

The standard CIAO 4.10 release is packaged with Python 3.5. Users who wish to continue to use Python 2.7 can install CIAO with the --python2 flag

unix% bash /<path>/ciao-install --python2

The Python 3 for Scientists website provides guidance on updating code written for Python 2, and the CXC Helpdesk can provide support.

macOS Sierra, High Sierra, and Mojave

An update to the macos operating system has caused a problem with chips. The chips-smoke003 test now fails with messages that look like:

error: xp_import_surface returned: 2
xp_destroy_surface: assertion failed: s != NULL
xp_destroy_surface error: 3
xp_import_surface: assertion failed: s == NULL

The problem has been isolated to actions involving deleting a window: using the clear() command, delete_window() command, or clicking on the close button on the title bar. Those actions will succeed however, it will result in the background chips server crashing on any command which subsequently creates a new window.

As a work around, users can repeat the same command. Repeating the same command will recognize that the chips server is gone and will restart it automatically.

No support for 32-bit Linux, nor OSX 10.9 (Mavericks) and earlier.

CIAO is no longer available for 32-bit Linux, nor it it available for OSX 10.9 (Mavericks) or earlier versions of OSX. CIAO 4.7 is still available for users who are unable to upgrade their system. The platform support page describes the operating systems that can be used with CIAO 4.10

CIAO on Mac needs recent XQuartz and XCode

OSX users, particularly those that have upgraded to 10.11 from an earlier OSX version, should ensure that compatible versions of XQuartz (at least version 2.7.11) and XCode (also comes as part of Apple Developer Tools) are installed on the system before proceeding with the CIAO installation.

Steps to install CIAO (if the following does not work then try the Manually Installing CIAO 4.10 thread):

  1. [WARNING]
    What is the download called?

    The following document assumes that the script has been downloaded with the name ciao-install. This is the default name, but the web browser may well add on a suffix (such as "(1)") to avoid overwriting an existing file. Please rename the downloaded file - or use the new name - in the following steps!

  2. [WARNING]
    Do Not Install as Root or Super User

    It is strongly suggested that CIAO be installed as a non-privileged, regular user and not as the root or a super user.

    Install CIAO in new terminal window

    Users should install CIAO in a new terminal window which is not already configured for CIAO-4.10 or earlier, nor setup for any other common analysis packages such as FTOOLS/HEASOFT/XSPEC, SAS, or others.

    Run the script that has been downloaded; this will download the requested parts of CIAO and install them on your system, and is described in more detail in the Installing CIAO 4.10 using the ciao-install script thread:

    unix% bash /<path>/ciao-install

    for the Python 3.5 version, or:

    unix% bash /<path>/ciao-install --python2

    for the Python 2.7 version.

    We strongly suggest that the smoke tests are run, the results reviewed, and that the bug page for CIAO installation is reviewed before contacting the CXC Helpdesk if there are any problems.

  3. Set up an alias to start CIAO: for example, if CIAO has been installed into the directory /soft/ciao-4.10/, then

    alias ciao "source /soft/ciao-4.10/bin/ciao.csh"

    for csh and tcsh users and

    alias ciao="source /soft/ciao-4.10/bin/ciao.bash"

    for bash users.

  4. This alias should then be called in the terminal in which you plan to use CIAO (multiple terminals can be set up to use CIAO at the same time). When called, a version message will be displayed and then the parts of CIAO that were downloaded - such as tools or Sherpa - will be available:

    unix% ciao
    CIAO configuration is complete... 
    CIAO 4.10 Thursday, April 12, 2018
      bindir      : /soft/ciao-4.10/bin
      CALDB       : 4.8.1

    Please review the notes on starting and installing CIAO for potential conflicts between CIAO and other systems, such as XMM SAS and HEASoft.

    The ciaover script can be used to display the CIAO and CALDB versions (it reports the same information that the ciao alias above does). The --version flag to python can be used to display the Python version in use (the versions included in CIAO 4.10 are 2.7.14 and 3.5.4);

    unix% python --version
    Python 3.5.4
  5. Once CIAO has been started, the MARX suite of tools for simulating the on-orbit performance of Chandra can be downloaded and installed with the install_marx script (it can be installed at any time). The script takes a single argument, the location to install MARX. Change /soft/marx to a suitable location:

    unix% install_marx /soft/marx

    An alias can be created to set the MARX environment. For instance

    alias setup_marx "source /soft/marx/setup_marx.csh"

    for csh and tcsh users and

    alias setup_marx="source /soft/marx/"

    for bash users.

Would you like to receive Chandra and CIAO announcements?

Send an email message to:

Last modified: 13 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.