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

Skip the navigation links
Last modified: December 2006

URL: http://cxc.harvard.edu/ciao3.4/calsetdate.html
Hardcopy (PDF): A4 | Letter
AHELP for CIAO 3.4 calSetDate Context: caldb

Synopsis

Sets the date for the next CALDB query.

Syntax

calSetDate( Caldb_Type cal, String_Type date )

Description

This sets the date to be used for the CALDB query. It represents the start of the observation and should either be one of the following:

Format Description
YYYY-MM-DD This sets the date to use for the query.
YYYY-MM-DDTHH:MM:SS This sets both the date and the time to use for the query.
"now" If set to the string "now" then the CALDB search will look for files that are currently active.

This field matches the date parameter of the quizcaldb tool, and can be set equal to the contents of the FITS DATE-OBS keyword.

Example 1

chips> cal = calCreateInfo
chips> calSetDate( cal, "now" )

This sets the CALDB search to look for files relevant for observations at the time you call calFindFile().

Example 2

chips> cal = calCreateInfo
chips> calSetDate( cal, "2002-03-24" )

This sets the CALDB search to look for files relevant for observations taken on 24 March 2002. The default time is "00:00:00", which can be changed using calSetTime().

Example 3

chips> cal = calCreateInfo
chips> calSetDate( cal, "2002-03-24T17:45:23" )

This sets the CALDB search to look for files relevant for observations taken on 24 March 2002 at 17:45:23.

Bugs

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

Hardcopy (PDF): A4 | Letter
Last modified: December 2006



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.