mBestImage Function Call

Function Arguments

/*-***********************************************************************/
/*                                                                       */
/*  mBestImage                                                           */
/*                                                                       */
/*  Given a list of images and a position, determine which image covers  */
/*  the location "best" (i.e. the one where the position is farthest     */
/*  from the nearest edge).                                              */
/*                                                                       */
/*   char   *tblfile    Input image metadata file                        */
/*   double  ra         RA (J2000) of point of interest                  */
/*   double  dec        Dec (J2000) of point of interest                 */
/*   int     debug      Debugging flag                                   */
/*                                                                       */
/*************************************************************************/



struct mBestImageReturn *mBestImage(char *tblfile, double ra, double dec, int debug)

Return Structure

struct mBestImageReturn
{
   int    status;        // Return status (0: OK, 1:ERROR)
   char   msg [1024];    // Return message (for error return)
   char   json[4096];    // Return parameters as JSON string
   char   file[1024];    // 'Best' file name
   int    hdu;           // Best HDU (if any)
   char   url [1024];    // URL to best file (if any)
   double edgedist;      // Closest edge distance 
};