How to find & download Chandra images for use with ds9

This page is intended as a resource for finding, downloading, and using Chandra images.
last updated  6/28/05

        contents



The Chandra-Ed site has
However, what may not be so obvious is

How to find images that are not listed in the Chandra-Ed Images Archive

                a) if you know the object's name,
                   
                    go to Chandra Data Archive Observation Search Page and type in the name of the object in the Target Name box.
                    All observations which have that name in the observation title are returned, in order of ObsId number.
                    Note the Status of the observation.  If
archived,  the observation will appear in the Chandra archive. 
                    If observed, it's still the "property" of the observer (who generally retains proprietary rights for 1 year after the observation).

                b) if you want to search by coordinates

                  
go to Chandra Data Archive Observation Search Page and type in an RA and a Dec in the appropriate boxes.
                   make sure that the size parameter is large enough to encompass a reasonably large region about the center search coordinates


                   To obtain a complete list of the observations ordered by RA, leave all Search boxes blank. 
                    In the
Customize Output section near the bottom, select RA in the Sort Order option box.
Although a few of the objects will be recognizable by name, most will not be to non-astronomers.  Here are some clues to object identification:

abbreviation
catalog
wavelength band; types of objects
NGC
New General Catalog
optical; galaxies, star clusters, nebulae
3C
3rd Cambridge catalog
radio; usually active galaxies and quasars
PSS
Palomar Sky Survey
quasars
SDSS
Sloan DIgital Sky Survey
optical and infrared; stars, galaxies, quasars
PSR
 
radio; pulsars 
2MASS
2-micron All Sky Survey
infrared
SN, SNR
 
supernova, supernova remnant
GRB
 
gamma ray burster
RX
RoSat
xray
Abell
 
clusters of galaxies

 

Go to the Chandra Data FTP Archive .

The images are located in the science directory, but not in a very user-friendly manner.  In the science directory, there is a subdirectory for each cycle (or calendar year) that Chandra has been operating.  The sub-directories are titled ao<nn> (where the number nn stands for the Chandra operating year, with 00 standing for the year beginning in mid-1999 when Chandra began observations).  Within each ao<nn> sub-directory are further sub-drectories (each named cat<i>) which contain objects of homogeneous type.  <i> types are

    0 Non-celestial (Engineering) Observation
    1 Solar System
    2 Normal Stars and White Dwarfs
    3 White Dwarf Binaries and Cataclysmic Variables
    4 Black Hole and Neutron Star Binaries
    5 Supernovae, Supernova Remnants, and Isolated Neutron Stars
    6 Normal Galaxies
    7 Active Galaxies and Quasars
    8 Clusters of Galaxies
    9 Extragalactic Diffuse Emission and Surveys and Galactic Diffuse Emission and Surveys

Therefore, the cat1 sub-directory contains observations of only Solar System objects.

Archived data and observations
Within each category sub-directory are the observations sorted by ObsId number.  So you still don't know the specific object associated with an observation unless you open the image and read the FITS header.
 

the advantage of using HEASARC is that you can search for data from other satellite missions (not only in the x-ray, but also in other parts of the spectrum)

Once you've filled in the Object Name and checked the appropriate mission/catalogs boxes, make sure that, under #3, the "Archived data and observations" box is checked (probably the only one you want checked), and then click on the 
"start search" button under #5.

A new page opens that lists the relevant observations.


How to download images

If option 1 above did not work....
If you know the ObsId number, you can type it in directly in the box provided at the
Chandra Data Archive Observation Search Page

A new Search Results page will be returned with the appropriate ObsId along with other information about the image;
in general, the primary and secondary products boxes will be checked for retrieval; it's likely that you will want only primary products;
click on the Retrieval List link at the upper right; the products that will be retrieved are listed;
click on the Browse Products link at the upper left to see what specific files will be retrieved;
click on the Retrieve Products link at the upper left to retrieve these files;
the Retrieval Results page will contain an ftp link will be returned for downloading the images

Most likely the file you want will end with ...evt2.fits (it's called an "events file" and essentially contains the most detailed information, including the arrival time and energy of each photon). 
Files ending in img.fits contain images, but cannot be analyzed to produce light curves or spectra.

Select the "Save to Disk" option.

If you used the Chandra Data FTP Archive, locate the files you want under the ObsId sub-directory, click on the compressed FITS file (generally a .gz file) to download the file.

If you used HEASARC, check the box for each row of data you want.  As explained above, the file you want ends with ...evt2.fits.  Follow directions above for retrieving and downloading.


how to uncompress the downloaded, compressed files

 
unzipping the files
in Windows
(using WINZIP)
in UNIX

Locate the directory in which you saved the *.tar file.
.tar file Double-click on the *.tar file to start
the WINZIP software which will convert the tar file
to individually compressed *.gz files.
tar -xvf filename.tar
.gz file click of the *.gz files to uncompress them
(in 1 step)
gunzip filename.tar
.Z file uncompress filename.Z

Warnings
the WINZIP uncompression could place either the
.gz file and/or the .fits file in a directory OTHER than that
in which the .tar file resided... 
you may have to search it among subdirectories.

 

using the Analysis Tools in ds9 with your downloaded images

Start DS9 and load one of the special images available on the Chandra-Ed or Rutgers servers (this will allow us to access the Analysis tools for any image):

    (1)   Load DS9
    (2)   Under Analysis, select Virtual Observatory
    (3)   Check one of the server options in the Dialog box that opens
            (Chandra Education, Chandra-ed Archive, Rutgers)
    (4)   The check box should turn green and color, and another web page should load
            which allows the user to choose an image
    (5)   Load any one of the images made available by the server

    The advantage of doing step 5 above is that once the Analysis Tools are loaded for one
    of the special images (Cas A, 3C273, M31, plus some others listed by either the Chandra-Ed
    server or the Basho Rutgers server) is that the Analysis Tools (except the FTOOLS
    commands at the bottom of the Analysis meny) will be subsequently available for ANY
    other Chandra image.

    Warning:  although any FITS image can be loaded into ds9 and many of the functions will
    work (e.g., scale, color, pixel table, etc.) don't expect the bulk of the Analysis tools
    (e.g., light curve, energy spectrum, etc.) to work

loading an optical image of the same sky field

Chandra also has the capability to load the DSS (Palomar's Digital Sky Survey in the visible
part of the spectrum) image in a side frame, automatically change the two images to the
same scale, and match the cursor positions on the two images:

    (1) Under Frame, select Tile Frames
    (2) Under Analysis, select DSS
    (3) Click Retrieve in the Dialog Box that opens (which should have the right ascension
                and declination inserted)
     (4)  The optical DSS image should now open in a frame to the right of the Chandra x-ray image
     (5)  Under Frame, select Match Frames --> WCS
     (6)  Under Frame, select Lock Crosshairs --> WCS
     (7)  Under Edit, select Crosshair
     (8)  You should now be able to click & drag the cursor around in one image and have the cursor
                move correspondingly in the adjacent image

     (To return the cursor to its previous functions, Under Frame, select Pointer)


questions?  suggestions? complaints? etc  to John Kolena