mSubset Function Call

Function Arguments

/*-***********************************************************************/
/*                                                                       */
/*  mSubset                                                              */
/*                                                                       */
/*  Given a list of image metadata and a region definition (in the form  */
/*  of a "header" file), determine which subset of the list to keep by   */
/*  checking to see if the image overlaps with the area defined by the   */
/*  header.                                                              */
/*                                                                       */
/*   char  *tblfile        Image metadata table                          */
/*   char  *template       FITS header file used to define the desired   */
/*                         output region                                 */
/*                                                                       */
/*   char  *subtbl         Subset of the metadata table that overlap     */
/*                         with the template                             */
/*                                                                       */
/*   int    fastMode       Overlap check just involves great circles     */
/*                         connecting the image/template corners         */
/*                                                                       */
/*   int    debug          Debugging output level                        */
/*                                                                       */
/*************************************************************************/

struct mSubsetReturn *mSubset(char *tblfile, char *template, char *subtbl, int fastmode, int debugin)

Return Structure

struct mSubsetReturn
{
   int    status;        // Return status (0: OK, 1:ERROR)
   char   msg [1024];    // Return message (for error return)
   char   json[4096];    // Return parameters as JSON string
   int    count;         // Number of images in the input table.
   int    nmatches;      // Number of matches.
};