Membership of the Current Calibration File

XMM-Newton Science Analysis System

cifbuild (cifbuild-4.7.1) [xmmsas_20080701_1801-8.0.0]

Here we address the issue of how to determine what calibration files make up the current calibration file for a given observation time.

Each calibration file has a validity start date and a validity end date. These are indicated by the FITS keywords VALDATE and EVALDATE. A missing EVALDATE is taken to mean no end of validity.

Given the naming convention above, a calibration file can be labeled with a quadruplet of the form $\{Fname, Issue, T_{start}, T_{end}\}$ , where $Fname \equiv \textrm{ \textbf{scope}\_\textbf{calname}}$ , and $T_{end}$ is optional.

New issues of a calibration file can enter the archive with any $T_{start}$ , any $T_{end}$ , and increasing issue numbers.

In the simplest case (no end of validity date), a new version of the calibration file -- call it $\{Fname, Issue^\prime, T_{start}^\prime\}$ , will have $T_{start} < T_{start}^\prime$ and $Issue < Issue^\prime$ (figure 1).

A more complex situation is illustrated in figure 2. Here new versions are introduced to improve on past calibrations.

$\begin{figure} % latex2html id marker 332 \begin{center} \leavevmode \epsfig{... ...One\_0001.ccf} and \textit{xmm\_ExampleTwo\_0005.ccf}} \end{center}\end{figure}$

In figure 3 we show an example where a CCF constituent has an end of validity date. In this case at the time the situation is the same as shown in figure 2, whereas at the time $T1$

the constituent xmm_ExampleTwo_005.ccf is no longer applicable.

$\begin{figure} % latex2html id marker 343 \begin{center} \leavevmode \epsfig{... ...ne\_0001.ccf} and \textit{xmm\_ExampleTwo\_0003.ccf}.} \end{center}\end{figure}$

Within this scheme, at any time the applicable issue of the calibration file

is obtained by selecting among all files the one with the higher issue number.

Should it become necessary, a new

can be introduced in the archive, as illustrated in figure 4.

$\begin{figure} % latex2html id marker 356 \begin{center} \leavevmode \epsfig{... ...o\_0003.ccf} and \textit{xmm\_ExampleThree\_0002.ccf}} \end{center}\end{figure}$

With this scheme the number of constituents in the current calibration file is not fixed, and can be determined only when the time is specified.