Chandra X-Ray Observatory
	(CXC)
Skip to the navigation links
Last modified: 25 September 2017

URL: http://cxc.harvard.edu/ciao/download/custom.html

Custom Installation: CIAO 4.9 & CALDB 4.7.6

[IMPORTANT]
No support for 32-bit Linux and OSX 10.6.8, 10.7, 10.8

CIAO is no longer available for 32-bit Linux, OSX 10.6.8, 10.7, & 10.8. 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.9

This page allows users to create a customized version of the ciao-install installation script: that is, select exactly which packages are installed and whether the source code is also downloaded. The inital options are those used by the Standard Install with the base CALDB version.. If the following does not work then try the Manually Installing CIAO 4.9 thread.

    • The default setting - "Autodetect Platform" - allows ciao-install to determine what platform you are using and to select the appropriate build of CIAO. The Platform Support page has more information on the officially supported CIAO platforms.
      [NOTE]
      Python 3

      The CIAO 4.9 release comes packaged in a fully supported version with Python 2.7 and a Python 3.5 beta version, as a transitional step towards complete Python 3 integration.

      When "Autodetect Platform" is selected for the customized installation, the Python 2.7 version of CIAO will be obtained by default unless a "--python3" flag is used with ciao-install, which will then obtain the Python 3.5 version of CIAO.

      unix% bash  /<path>/ciao-install --python3
      
    • Sherpa is also available directly from GitHub, if you wish to install it outside of CIAO or help its development, by adding new features, reporting or fixing bugs, or adding documentation.
    • The CALDB contains all the calibration files required for Chandra data analysis. The ciao-install script will determine whether a patch file can be installed, or if a full download is required.
    • The ACIS background files - derived from observations - are large, and so not included in the base CALDB.
    • The HRC background files - derived from observations - are large, and so not included in the base CALDB.
    • The source build option is for users who wish to compile CIAO themselves. There are platform specific build instructions for Linux and OSX when starting with the CIAO precompilied OTS packages. Some common build problems are discussed on the bug page for known source build issues. Users must either also select the appropriate binary packages or must rebuild all the Off The Shelf (OTS) packages as outlined in the instructions.

    [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!

  1. [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.

    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.9 using the ciao-install script thread:

    unix% bash /<path>/ciao-install
    

    for the Python 2.7 version, or:

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

    for the Python 3.5 beta 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.

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

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

    for csh and tcsh users and

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

    for bash users.

  3. 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.9 December 2016
      bindir      : /soft/ciao-4.9/bin
      CALDB       : 4.7.6
    

    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 supported in CIAO 4.9 are 2.7.11 and 3.5.1);

    unix% python --version
    Python 3.5.1
    
  4. 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
    
    [WARNING]
    Warning
    Some users have reported problems with MARX built with the default llvm/clang compilers on OSX. More information about the problem can be found on the Downloading and Installing Marx page.

    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/setup_marx.sh"
    

    for bash users.


[NOTE]
Would you like to receive Chandra and CIAO announcements?
Send an email message to: chandra-announce+subscribe@cfa.harvard.edu

Last modified: 25 September 2017
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:   cxchelp@head.cfa.harvard.edu Smithsonian Institution, Copyright © 1998-2017. All rights reserved.