/*--------------------------------------------------------------------------- File name : dicbkeys.h Author : Y. Jung Created on : July 2000 Description : conica functions using DFS FITS header keywords *--------------------------------------------------------------------------*/ /* $Id: dicbkeys.h,v 1.7 2002/01/29 04:31:08 yjung Exp $ $Author: yjung $ $Date: 2002/01/29 04:31:08 $ $Revision: 1.7 $ */ #ifndef _CO_DICB_KEYS_H_ #define _CO_DICB_KEYS_H_ /*--------------------------------------------------------------------------- Function prototypes ---------------------------------------------------------------------------*/ /*-------------------------------------------------------------------------*/ /** @name conica_get_arcfile @memo find out the arcfile @param filename conica FITS file name @return pointer to statically allocated character string @doc */ /*--------------------------------------------------------------------------*/ char * conica_get_arcfile(char * filename) ; /*-------------------------------------------------------------------------*/ /** @brief find out the date of observation @param filename conica FITS file name @return pointer to statically allocated character string */ /*--------------------------------------------------------------------------*/ char * conica_get_date_obs(char * filename) ; /*-------------------------------------------------------------------------*/ /** @name conica_get_frame_type @memo find out the frame type @param filename conica FITS file name @return pointer to statically allocated character string @doc */ /*--------------------------------------------------------------------------*/ char * conica_get_frame_type(char * filename) ; /*-------------------------------------------------------------------------*/ /** @name conica_get_opti4_id @memo find out the OPTI4 ID @param filename conica FITS file name @return pointer to statically allocated character string @doc */ /*--------------------------------------------------------------------------*/ char * conica_get_opti4_id(char * filename) ; /*-------------------------------------------------------------------------*/ /** @name conica_get_templateid @memo find out the template id @param filename conica FITS file name @return pointer to statically allocated character string @doc */ /*--------------------------------------------------------------------------*/ char * conica_get_templateid(char * filename); /*-------------------------------------------------------------------------*/ /** @name conica_get_numbexp @memo find out the number of expositions @param filename conica FITS file name @return pointer to statically allocated character string @doc */ /*--------------------------------------------------------------------------*/ char * conica_get_numbexp(char * filename) ; /*-------------------------------------------------------------------------*/ /** @brief find out the number of the current exposition @param filename conica FITS file name @return pointer to statically allocated character string */ /*--------------------------------------------------------------------------*/ char * conica_get_expno(char * filename) ; /*-------------------------------------------------------------------------*/ /** @name conica_get_mjdobs @memo find out the mjd-obs keyword @param filename conica FITS file name @return pointer to statically allocated character string @doc */ /*--------------------------------------------------------------------------*/ char * conica_get_mjdobs(char * filename) ; /*-------------------------------------------------------------------------*/ /** @name conica_get_ndit @memo find out the character string associated to the NDIT keyword in an conica header @param filename conica FITS file name @return pointer to statically allocated character string History support for various conventions The returned string is statically allocated, no need to free() it! */ /*--------------------------------------------------------------------------*/ char * conica_get_ndit(char * filename) ; /*-------------------------------------------------------------------------*/ /** @brief find out the RA keyword in a CONICA header @param filename CONICA FITS file name @return pointer to statically allocated character string History support for various conventions The returned string is statically allocated, no need to free() it! */ /*--------------------------------------------------------------------------*/ char * conica_get_ra(char * filename) ; /*-------------------------------------------------------------------------*/ /** @brief find out the DEC keyword in a CONICA header @param filename CONICA FITS file name @return pointer to statically allocated character string History support for various conventions The returned string is statically allocated, no need to free() it! */ /*--------------------------------------------------------------------------*/ char * conica_get_dec(char * filename) ; /*-------------------------------------------------------------------------*/ /** @name conica_get_dit @memo find out the character string associated to the DIT keyword in an conica header @param filename conica FITS file name @return pointer to statically allocated character string @doc History support for various conventions The returned string is statically allocated, no need to free() it! */ /*--------------------------------------------------------------------------*/ char * conica_get_dit(char * filename) ; /*-------------------------------------------------------------------------*/ /** @brief find out the character string associated to the DET.NCORRS key. @param filename conica FITS file name @return pointer to statically allocated character string History support for various conventions The returned string is statically allocated, no need to free() it! */ /*--------------------------------------------------------------------------*/ char * conica_get_rom(char * filename) ; /*-------------------------------------------------------------------------*/ /** @brief find out the character string associated to DET.NCORRS.NAME @param filename conica FITS file name @return pointer to statically allocated character string History support for various conventions The returned string is statically allocated, no need to free() it! */ /*--------------------------------------------------------------------------*/ char * conica_get_rom_name(char * filename) ; /*-------------------------------------------------------------------------*/ /** @brief find out the character string associated to DET.MODE.NAME @param filename conica FITS file name @return pointer to statically allocated character string History support for various conventions The returned string is statically allocated, no need to free() it! */ /*--------------------------------------------------------------------------*/ char * conica_get_mode(char * filename) ; /*-------------------------------------------------------------------------*/ /** @brief find out the character string associated to the EXPTIME keyword @param filename conica FITS file name @return pointer to statically allocated character string History support for various conventions The returned string is statically allocated, no need to free() it! */ /*--------------------------------------------------------------------------*/ char * conica_get_exptime(char * filename) ; /*-------------------------------------------------------------------------*/ /** @name conica_get_cumoffsetx @memo find out the character string associated to the CUMOFFSETX keyword in an conica header @param filename conica FITS file name @return pointer to statically allocated character string @doc History support for various conventions The returned string is statically allocated, no need to free() it! */ /*--------------------------------------------------------------------------*/ char * conica_get_cumoffsetx(char * filename) ; /*-------------------------------------------------------------------------*/ /** @name conica_get_cumoffsety @memo find out the character string associated to the CUMOFFSETY keyword in an conica header @param filename conica FITS file name @return pointer to statically allocated character string @doc History support for various conventions The returned string is statically allocated, no need to free() it! */ /*--------------------------------------------------------------------------*/ char * conica_get_cumoffsety(char * filename) ; /*-------------------------------------------------------------------------*/ /** @name conica_get_pixscale @memo find out the character string associated to the PIXSCALE keyword in an conica header @param filename conica FITS file name @return pointer to statically allocated character string @doc History support for various conventions The returned string is statically allocated, no need to free() it! */ /*--------------------------------------------------------------------------*/ char * conica_get_pixscale(char * filename) ; /*-------------------------------------------------------------------------*/ /** @name conica_get_instrument @memo find out the character string associated to the instrument @param filename conica FITS file name @return pointer to statically allocated character string @doc History support for various conventions The returned string is statically allocated, no need to free() it! */ /*--------------------------------------------------------------------------*/ char * conica_get_instrument(char * filename) ; /*-------------------------------------------------------------------------*/ /** @name conica_get_dpr_catg @memo find out the data category as defined by the DataFlow @param filename source FITS file @return statically allocated char string, no need to free() it @doc returns NULL if error occurred */ /*--------------------------------------------------------------------------*/ char * conica_get_dpr_catg(char * filename) ; /*-------------------------------------------------------------------------*/ /** @name conica_get_dpr_type @memo find out the data type as defined by the DataFlow @param filename source FITS file @return statically allocated char string, no need to free() it @doc returns NULL if error occurred */ /*--------------------------------------------------------------------------*/ char * conica_get_dpr_type(char * filename) ; /*-------------------------------------------------------------------------*/ /** @name conica_get_dpr_tech @memo find out the data tech as defined by the DataFlow @param filename source FITS file @return statically allocated char string, no need to free() it @doc returns NULL if error occurred */ /*--------------------------------------------------------------------------*/ char * conica_get_dpr_tech(char * filename) ; /*-------------------------------------------------------------------------*/ /** @name conica_get_filter @memo find out the filter used in a CONICA FITS frame. @param filename source FITS file @return statically allocated char string, no need to free() it @doc returns NULL if error occurred */ /*--------------------------------------------------------------------------*/ char * conica_get_filter(char * filename); /*-------------------------------------------------------------------------*/ /** @brief find out the ambient humidity level as defined in the relevant ambient monitor dictionary @param filename source FITS file @return statically allocated char string, no need to free() it returns NULL if keyword cannot be found */ /*--------------------------------------------------------------------------*/ char * conica_get_humidity_level(char * filename) ; /*-------------------------------------------------------------------------*/ /** @brief get airmass start or end from an CONICA FITS file @param filename source FITS file @param when 0 to get start, 1 to get end @return Char string containing what was found in header, NULL if error. */ /*--------------------------------------------------------------------------*/ char * conica_get_airmass(char * filename, int when) ; /*-------------------------------------------------------------------------*/ /** @brief find out the OBS ID keyword @param filename CONICA FITS file name @return pointer to statically allocated character string */ /*--------------------------------------------------------------------------*/ char * conica_get_obs_id(char * filename) ; /*-------------------------------------------------------------------------*/ /** @brief find out the OBS ID keyword @param filename CONICA FITS file name @return pointer to statically allocated character string */ /*--------------------------------------------------------------------------*/ char * conica_get_opti7_no(char * filename) ; /*-------------------------------------------------------------------------*/ /** @brief find out the INS CON XREFZERO keyword @param filename CONICA FITS file name @return pointer to statically allocated character string */ /*--------------------------------------------------------------------------*/ char * conica_get_refzerox(char * filename) ; /*-------------------------------------------------------------------------*/ /** @brief find out the INS CON YREFZERO keyword @param filename CONICA FITS file name @return pointer to statically allocated character string */ /*--------------------------------------------------------------------------*/ char * conica_get_refzeroy(char * filename); #endif