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 2007

URL: http://cxc.harvard.edu/ciao4.0/calsetdate.html
AHELP for CIAO 4.0 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.

The caldb module is not available by default; to use it in a S-Lang program, it must be loaded using the S-Lang require() function:

  require("caldb");

Example 1

slsh> cal = calCreateInfo;
slsh> calSetDate( cal, "now" );

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

Example 2

slsh> cal = calCreateInfo;
slsh> 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

slsh> cal = calCreateInfo;
slsh> 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.

Last modified: December 2007



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.