About Chandra Archive Proposer Instruments & Calibration Newsletters Data Analysis HelpDesk Calibration Database NASA Archives & Centers Chandra Science Links

Skip the navigation links
Last modified: April 2009

URL: http://cxc.harvard.edu/ciao4.1/calquiz.html
AHELP for CIAO 4.1

calquiz

Context: tools

Synopsis

Find calibration files in the CALDB

Syntax

calquiz  infile product calfile [outfile] [verbose]

Description

`calquiz' is the CALDB4 replacement for the 'quizcaldb' tool. The tool is use to query the CALDB for calibrations matching a set of conditions.

Example 1

calquiz acisf00459N002_evt2.fits product=DET_GAIN calfile=CALDB
pget calquiz outfile
/soft/ciao/CALDB/data/chandra/acis/det_gain/acisD1999-09-16gainN0006.fit
s[2]

Query the CALDB for the detector gain (DET_GAIN) for the data in acisf00459N002_evt2.fits. The pget tool is used to get the resulting filename from calquiz.par.

Example 2

calquiz sources.wmap8 fef_pha calfile=CALDB verbose=1

Use the information in sources.wmap8 to determine which FEF file would be used to create the RMF. calquiz is run with "verbose=1", so the information is printed to the screen:

   Telescope: CHANDRA
  Instrument: ACIS
        Data: FEF_PHA
    Detector: -
  Start-Date: 2002-02-27
  Start-Time: 14:51:49
   Stop-Date: 2002-03-01
   Stop-Time: 01:38:40
  Expression: GRATING=NONE
              CTI_APP=PPPPPNPNPP
              FP_TEMP=153.446
      Config: /proj/xena/ciao4.1.2/fc8.090301/ciao-4.1/CALDB/software/tools/caldb.config
   CXC-caldb: v1.6
caldb4: #
 No error.

Found 1 file:
/soft/ciao/CALDB/data/chandra/acis/fef_pha/acisD2000-01-29fef_pha_ctiN0004.fits[2]

Parameters

name type ftype def min max reqd
infile file input       yes
product string         yes
calfile string   CALDB     yes
outfile string output        
verbose integer   0 0 5  

Detailed Parameter Descriptions

Parameter=infile (file required filetype=input)

Input file name

The input file from which the metadata needed to complete the CALDB lookup is obtained. This includes things such as DATE-OBS, DATE-END, INSTRUME, TELESCOP, etc. The file can be either a datamodel file or a parameter file.

Parameter=product (string required)

Calibration Database product code name

Each data type of data-product in the CALDB has a unique code-name. See for a complete list of code names. Common examples are things like: DET_GAIN, P2_RESP, PI_FEF, DEGAP.

Parameter=calfile (string required default=CALDB)

The CALDB directive

Seemingly redundent, this is the parameter that specifies to use the CALDB to lookup the file. It is here to miminc the behavior of what will be implemented for each tool.

In particular, as in the previous CALDB, we have added optional arguments to the CALDB directive in the form

CALDB(PARAMETER=VALUE;PARAMETER=VALUE)

The PARAMTER's above are arbitrary, so if for example the CALDB query needs a value for 'GRATTYPE' but no such header keyword exists, you can specify

CALDB(GRATTYPE=HEG)

There are two special directives:

  • _FIDELITY : this can take the values 'HIGHEST', 'LOWEST', or can take a colon separated range, eg '1:3.4', ':4', or '0:'
  • _MATCH : this can take the values 'ALL', 'FIRST', 'WARNFIRST', 'LAST', 'WARNLAST', 'SINGLE'

Parameter=outfile (string filetype=output)

The selected file with path and extension appended.

This field is populated after the tool has finished running. The information is also printed to the screen if verbose>0.

Parameter=verbose (integer default=0 min=0 max=5)

Amount of tool output.

Bugs

See the bugs page for this tool on the CIAO website for an up-to-date listing of known bugs.

See Also

calibration
ardlib, caldb
modules
pixlib
tools
calindex, check_ciao_caldb
Last modified: April 2009



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-2004. All rights reserved.