Skip to the navigation links
Last modified: 29 October 2019

URL: http://cxc.harvard.edu/csc/download.html

How to access the Chandra Source Catalog Release 2.0


Release 2.0 of the Chandra Source Catalog (CSC) contains both tabular data - such as source name, position, and photometric properties, as well as related information linking a master source to the stack and obervation properties - as well as associated data products, including source spectra, images, exposure maps, and draws files from the MCMC error analysis stages.

There are a range of options for accessing the data - both columns and files - discussed below:


The CSCview application

The main interface to CSC 2.0 is the CSCview application. This is a Java program which allows you to search release 2.0 of the catalog, as well as previous releases (1.0 and 1.1). The application provides access to both the database columns - such as master-source name and aperture photometry - and the associated files, such as the per-stack limiting-sensitivity images and per-compact-source spectral products (PHA, ARF, and RMF). The CXCview help page provides help on how to use this application.

[NOTE]
Note

If you have an old version of CSCview you will be told to update when it starts, as it may not be capable of searching the CSC 2.0 release.


Quick Search: the CSC web interface [New]

This is a new interface for CSC 2.0, and lets you perform a basic search (equivalent to the default master-search query in CSCview) around one or more locations. It returns a fixed set of columns and the limiting sensitivity for each location. The other services described on this page should be used for more complex queries, access to different columns, or downloading data products.

The interface is at: http://cda.cfa.harvard.edu/cscweb/


CIAO scripts

The CIAO contributed-script package contains the search_csc and obsid_search_csc tools for searching the CSC. These scripts provide common "command-line" access services, but do not replicate all the functionality provided by CSCview.

The scripts default to search release 2.0, but can be changed to search release 1.1 with the catalog parameter.

[NOTE]
Note

You must update to at least version 4.11.5 of the contributed scripts package otherwise these scripts will fail with an error message similar to

# search_csc (06 March 2018): ERROR: Problem accessing CSC site.  Server responded with the following message:
Query error: master_obi_assoc not found. Specify owner.objectname or use sp_help to check whether the object
exists (sp_help may produce lots of output).

search_csc

Performs a cone search around a location - either given explicitly or as a name (which is converted to a location) - and returns the properties and associated data products for the matching sources. The exact set of columns and products returned can be changed.

The following example returns basic information - the master-source name, position, and observation id - for all sources within one arcminute of Polaris, with output to the screen and no download of associated data products:

unix% search_csc polaris 1 outfile=
search_csc
             pos = polaris
          radius = 1
         outfile = 
         radunit = arcmin
         columns = INDEF
     sensitivity = no
        download = none
            root = ./
           bands = broad,wide
       filetypes = regevt,pha,arf,rmf,lc,psf,regexp
         catalog = csc2
         verbose = 1
         clobber = no
            mode = ql


2 rows returned by query
2 Different Master Source(s).
1 Different Observation(s).

name                	ra          	dec         	sepn	obsid	
 2CXO J023149.6+891550	3.795698e+01	8.926411e+01	0.0085'	 6431	
 2CXO J023432.2+891529	3.863441e+01	8.925814e+01	0.64'	 6431	

obsid_search_csc

This script returns data - both columns and files - for one or more observation identifiers in the catalog.

Here we find all master sources in ObsId 6431, and save the results to the file sources.6431.tsv:

unix% obsid_search_csc 6431 sources.6431.tsv
obsid_search_csc
           obsid = 6431
         outfile = sources.6431.tsv
         columns = INDEF
        download = none
            root = ./
           bands = broad,wide
       filetypes = regevt,pha,arf,rmf,lc,psf,regexp
         catalog = csc2
         verbose = 1
         clobber = no
            mode = ql


34 rows returned by query
34 Different Master Source(s).
1 Different Observation(s).

name                	ra          	dec         	obsid	
 2CXO J014518.9+891732	2.632904e+01	8.929226e+01	 6431	
 2CXO J014614.3+891102	2.655971e+01	8.918411e+01	 6431	
...
 2CXO J033006.4+890752	5.252701e+01	8.913117e+01	 6431	
 2CXO J033910.1+892223	5.479212e+01	8.937325e+01	 6431	

The screen output shows name, location, and ObsId, whereas the fiel contains many-more columns. We can use the dmlist CIAO tool to view the contents (using the dmascii support for CSC TSV files):

unix% dmlist "sources.6431.tsv[opt kernel=text/tsv]" cols
 
--------------------------------------------------------------------------------
Columns for Table Block sources.6431.tsv
--------------------------------------------------------------------------------
 
ColNo  Name                 Unit        Type             Range
   1   name                              String[22]                          Source name in the format '2CXO Jhhmmss.s{+|-}ddmmss[X]'
   2   ra                   deg          Real4          -Inf:+Inf            Source position, ICRS right ascension
   3   dec                  deg          Real4          -Inf:+Inf            Source position, ICRS declination
   4   err_ellipse_r0       arcsec       Real4          -Inf:+Inf            Major radius of the 95% confidence level position error ellipse
   5   conf_flag                         String[5]                           Source may be confused (source and/or background regions overlap in one or more 
   6   sat_src_flag                      String[5]                           Source is saturated in all observations; source properties are unreliable
...
  61   var_index_b                       Int4           -                    Intra-observation Gregory-Loredo variability index in the range [0, 10]: indicat
  62   var_index_w                       Int4           -                    Intra-observation Gregory-Loredo variability index in the range [0, 10]: indicat
  63   detect_stack_id                   String[24]                          Detect stack identifier (designation of observation stack used for source detect

Using Virtual-Observatory interfaces

There are a number of interfaces provided to access release 2.0 of the CSC using International Virtual Observatory Alliance interfaces.

Astronomica Data Query Language

The ADQL interface can be used to query the catalog, but it does not provide access to the ancillary data products, such as spectral data files. Access is via a HTTP query, as described on the help page for the command-line interface.

Cone search

The VO cone-search service can be used to query version 2.0 of the CSC.

The interface is at: http://cda.cfa.harvard.edu/cscvo/

The cone search for version 1.1 of the CSC is available at http://cda.cfa.harvard.edu/csc1scs/

Table Access Protocol

The VO Table Access Protocol service can be used to query version 2.0 of the CSC.

The interface is at: http://cda.cfa.harvard.edu/csctap/

The TAP service for version 1.1 of the CSC is available at http://cda.cfa.harvard.edu/csc1tap/

Simple Image Access Protocal

The VO SIAP service can be used to identify images - in both FITS and JPEG formats - of sources and stacks in version 2.0 of the CSC.

The interface is at: http://cda.cfa.harvard.edu/cscsiap/

The SIA search for version 1.1 of the CSC is available at http://cda.cfa.harvard.edu/csc1siap/