Chandra X-Ray Observatory
Skip to the navigation links
Last modified: June 2010

Jump to: Description · Examples · See Also

AHELP for CIAO 4.9


Context: contrib


Check whether the locally-installed version of the Chandra Calibration DataBase (CALDB) is up to date



The return value is None or a tuple of (version checked against,


The check_caldb_version() checks that the locally-installed version of the Chandra CALDB is up to date. If it is, then the routine returns None, otherwise a tuple is returned, containing the version checked against and the latest version (both as strings).

The version argument

The version argument is used to define the version of the CALDB to check against. A value of None means that the version of the locally-installed Chandra CALDB is used, otherwise it should be a string such as "4.2.2". An error will be thrown if the version number is not recognized.

The routine requires that the computer is on-line and able to access the CALDB web site.

What is checked

The routine only checks the main Chandra CALDB package; it does not look for updates to any additional packages that may be installed, such as the background or PSF files.

CALDB downloads

The CALDB web site can be used to download newer versions of the Chandra CALDB, as can the ciao_install tool.

Loading the routine

The routine can be loaded into Sherpa by saying:

from ciao_contrib.caldb import *

Example 1

chips> check_caldb_version()

If the CALDB installation is up to date then v will be None, so there will be no screen output above, otherwise you will see something like the following

         ('4.2.0', '4.2.2')

which says that the installed version if 4.2.0, but that the latest release is version 4.2.2.

Example 2

chips> check_caldb_version("4.2.1")

Here we check whether version 4.2.1 is the latest version available.

Example 3

The following fragment shows how the routine can be used in a script to check whether the CALDB is up to date:

from ciao_contrib.caldb import *
v = check_caldb_version()
if v == None:
    print("CALDB is up to date")
    print("The installed CALDB version of {0} needs updating to {1}".format(v))

See Also

ciao_caldb, get_caldb

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