tifGetFitsStartLGSF

NAME

SYNOPSIS

#include <tif.h>
ccsCOMPL_STAT tifGetFitsStart(const char *imageFile, ccsERROR *error = NULL)
ccsCOMPL_STAT tifGetFitsEnd(const char *imageFile, ccsERROR *error = NULL)

DESCRIPTION

These functions are used to generate an ASCII file with the FITS
header keywords from TEL and ADA categories.

tifGetFitsStart- get TCS FITS header with keywords at start of exposure
tifGetFitsEnd  - get TCS FITS header with keywords at end of exposure

imageFile <IN>  name of the fits file holding the final data and header.
                tif uses this name with the added extension .tcs as the
                output in form of an ASCII file with TCS keywords
error     <OUT> error stack. If NULL is passed the default eccs error
                stack is used.

The <imageFile>.tcs is created in directory $INS_ROOT/$INS_USER/DETDATA/.
If it already exists it is deleted by tifGetFitsStart.
Keywords are collected in an oslxSETUP object and dumped to ASCII
file by tifGetFitsEnd.

The observation software (OS) is expected to call tifGetFitsStart at start
of exposure and tifGetFitsEnd at end of exposure to obtain the standard
FITS keywords for header from TCS and ADA. The result from calling these
query functions is the ASCII file <imageFile>.tcs, which OS should merge
with similar files from ins and det.

FILES

<imageFile>.tcs FITS keyword header with TCS and ADA keywords

ENVIRONMENT

TCS_ENVNAME specifies the environment in which TCS runs
TCS_DBPOINT specifies the root point of the TCS database branch
INS_ROOT to find path where to dump ASCII file
INS_USER to find path where to dump ASCII file

RETURN VALUES

SUCCESS if everything ok
FAILURE if any error occured

EXAMPLE

See file test/tifTestDataLib_3.C how OS can make use of these functions

Index

NAME

SYNOPSIS

DESCRIPTION

FILES

ENVIRONMENT

RETURN VALUES

EXAMPLE