Chandra X-Ray Observatory
	(CXC)
Skip to the navigation links
Last modified: 9 December 2013

URL: http://cxc.harvard.edu/chips/convert/index.html

Conversion Guides

The ChIPS Gallery and ChIPS threads provide a large number of examples to help you produce your desired visualization.


CIAO 4.5 to CIAO 4.6

Virtually all ChIPS scripts and code from CIAO 4.5 should work in CIAO 4.6. Note that ChIPS state files - created by save_state - created by CIAO 4.5 can be loaded into CIAO 4.6, but files created in CIAO 4.6 can not be loaded into CIAO 4.5.

The major changes are:

  1. Scripts that change the label.angle field of an axis in CIAO 4.5 need to be updated to use the x.label.angle or y.label.angle field instead.

  2. Images or contours of files with a non-tangent plane projection will no longer be drawn with incorrect WCS axes in CIAO 4.6, instead falling back to the physical or logical system. A warning message will be displayed if this happens: for example

    chips WARNING: Unable to use world transform - RA---SIN, DEC--SIN is an unsupported type. Using physical transform.
    

CIAO 4.4 to CIAO 4.5

Virtually all ChIPS scripts and code from CIAO 4.4 should work in CIAO 4.5. Note that ChIPS state files - created by save_state - created by CIAO 4.4 can be loaded into CIAO 4.5, but files created in CIAO 4.5 can not be loaded into CIAO 4.4.


CIAO 4.3 to CIAO 4.4

Virtually all ChIPS scripts and code from CIAO 4.3 should work in CIAO 4.4. If you have used Crates commands to read in data files then you may need to make some changes, as discussed in the Crates ahelp page.

The interactive versions of the pan and zoom have been removed since the functionality is now directly available from the ChIPS GUI.


CIAO 4.2 to CIAO 4.3

Python scripts should require little, if any changes to run. There are several changes, listed in the upgrade guide that may result in differences to the output.

S-Lang scripts will no longer work in CIAO 4.3. Please see the FAQ entry for advice on converting S-Lang scripts to Python.


CIAO 4.1 to CIAO 4.2

Scripts and state files from CIAO 4.1 should work without change in CIAO 4.2. If the visualization contains contours, then the output may not quite match, since contours are now created with a data-aspect ratio of 1:1, which means that limits commands may need to adjust the given values to retain the aspect ratio of the plot.

The simplest change is to remove the ratio after a contour is created using add_contour or make_figure. For example

add_contor("img.fits")
set_data_aspect_ratio("")

although you may wish to retain the setting and change the calls to limits.

Of note in the CIAO 4.2 release - other than the support for images - is the make_script command that is available to Python users. This can be used to convert a state file from CIAO 4.1, or the current ChIPS visualization, into a Python script.


CIAO 4.0 to CIAO 4.1

The major compatibility change in CIAO 4.1 is that ChIPS state files from CIAO 4.0 - i.e. the files created by save_state and loaded by load_state - can not be loaded into CIAO 4.1.

Most ChIPS code written for CIAO 4.0 will continue to run in CIAO 4.1. However some code will need updating, as described in the upgrade guide.


CIAO 3.4 to CIAO 4.3

The CXC is committed to helping ChIPS users transition to new syntax as smoothly as possible. If you have existing ChIPS scripts or save files, submit them to us via the CXC Helpdesk and we will provide the CIAO 4.6 ChIPS syntax to you. Relevant data files may be placed on the FTP site (FTP Instructions).

[NOTE]
SherpaCL

Note that the sherpacl application - provided in CIAO 4.2 as part of the CIAO scripts and module package - is not available in CIAO 4.3 or later.


SM to CIAO 4.6


Last modified: 9 December 2013
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:   cxcweb@head.cfa.harvard.edu Smithsonian Institution, Copyright © 1998-2014. All rights reserved.