const char isaac_illum_version[] = "$Revision: 1.2 $";
const char isaac_illum_date[]="$Date: 2001/07/31 07:26:34 $";
int  isaac_illum_main(void * d);

cmdline_spec isaac_illum_cmd[] = {
    {'o', "output", "Specify an output file base name", 1, "filename"},
    {'d', "dark", "Specify a dark for subtraction", 1, "filename"},
    {'f', "flat", "Specify a flat-field for division", 1, "filename"},
    {'b', "badpix", "Specify a bad pixel mask", 1, "filename"},
    {'s', "search", "Standard star search half-sizes", 1, "'hx hy'"},
    {'r', "radius", "Photometry computation radiuses", 1, "'star bgin bgout'"},
    {'F', "flux", "Output flux computation to ASCII file", 1, "filename"},
    {0, 0, 0, 0, 0}
};

const char isaac_illum_man[]=
"\n"
"NAME\n"
"\tillum - ISAAC illumination frame handling\n"
"\n"
"SYNOPSIS\n"
"\tisaacp illum [options] in\n"
"\n"
"DESCRIPTION\n"
"\tillum  applies  the pipeline data reduction process for\n"
"\tillumination frames taken with ISAAC. The  algorithms  are\n"
"\thopefully the same for any similar detector.\n"
"\n"
"ALGORITHM\n"
"\tillum  expects  a  list  of illumination frames to work\n"
"\twith. Illumination frames are a set of images of  a  stan­\n"
"\tdard star taken on a regular grid over the detector, typi­\n"
"\tcally 4x4 or 5x5. The offsets  in  pixels  between  frames\n"
"\tmust be provided in the header. The first frame in the set\n"
"\tmust be at offset (0,0) (the star is roughly at the center\n"
"\tof  the  image),  all  other offsets being specified rela­\n"
"\ttively to this one.\n"
"\n"
"\tillum will subtract dark, divide by flat-field and cor­\n"
"\trect  bad  pixels  if  the  adequate calibration files are\n"
"\tavailable (see -d -f and -b options).   Offsets  are  then\n"
"\tread from the FITS headers, and a peak re-location is per­\n"
"\tformed to localize precisely where the star lies  in  each\n"
"\timage.  The  search domain size around the provided places\n"
"\tcan be changed through the -s  option  if  you  know  that\n"
"\theader  offsets  are  false  by  a  larger amount than the\n"
"\tdefault one (50).\n"
"\n"
"\tAperture photometry in each plane is then computed accord­\n"
"\ting  to  three radii you can change through the -r option.\n"
"\tThe first radius encloses the star, the two others enclose\n"
"\tthe  background to be subtracted out.  Computed fluxes can\n"
"\tbe written to an ASCII file upon user request.\n"
"\n"
"\tNext step is then to fit a 2d polynomial  surface  to  the\n"
"\tlist  of photometric values, and normalize this surface to\n"
"\ta mean value of 1.  The  result  frame  is  saved  with  a\n"
"\tdefault name if none was provided.\n"
"\n"
"OPTIONS\n"
"\n"
"\t-d or --dark filename\n"
"\t\tSpecifies the name of the dark file to use. Default\n"
"\t\tis no dark file.\n"
"\n"
"\t-f or --ff filename\n"
"\t\tSpecifies  the  name  of  the  flat-field  to  use.\n"
"\t\tDefault is no flat-field.\n"
"\n"
"\t-b or --badpix filename\n"
"\t\tSpecifies  the  name  of  a  bad  pixel map to use.\n"
"\t\tDefault is no bad pixel map.\n"
"\n"
"\t-s or --search 'hx hy'\n"
"\t\tChanges the size of the search  domain  around  the\n"
"\t\tprovided  positions.   hx  and hy are half sizes in\n"
"\t\tpixels, i.e. if hx=50 and hy=50 the  search  domain\n"
"\t\tis  101x101  pixels  around  each  position. If you\n"
"\t\tenlarge  too  much  this  domain,  you  risk  false\n"
"\t\tmatches  (the  detected peak does not correspond to\n"
"\t\tthe standard star but to another bright  object  in\n"
"\t\tthe  neighborhood).  Default is hx=50 and hy=50. Of\n"
"\t\tcourse, peak re-location will NOT work  in  crowded\n"
"\t\tfields.\n"
"\n"
"\t-r or --radii 'rstar rbgin rbgout'\n"
"\t\tSpecifies three radii for fixed-aperture photometry\n"
"\t\tcomputation.  belonging to the  star.  'rbgin'  and\n"
"\t\t'rbgout'  specify  a  crown  centered  on the star,\n"
"\t\twithin which all pixels will be considered as back­\n"
"\t\tground.   The  algorithm  gathers all pixels within\n"
"\t\tthat crown, picks the median value,  and  subtracts\n"
"\t\tit  from all star pixels while summing up.  Default\n"
"\t\tvalues are rstar=10, rbgin=12, rbgout=30.\n"
"\n"
"\t-F or --flux filename\n"
"\t\tWill produce an  ASCII  file  containing  for  each\n"
"\t\tinput plane the position of the re-located star and\n"
"\t\tthe computed flux.\n"
"\n"
"\n"
"\n\n";