Define measurements to be made and reported results from the Photometry Service

[talister]

From the Requirements Doc we have a basic definition of inputs and outputs for the Photometry Service. This issue serves to document these, along with any other additions that are needed, allowing determination of completion of the service.

Overview:

Abstraction of the service to perform low SNR source detection, source measurement and forced photometry at specified locations and return the results to the Controller and the User

Input Parameters:

• list of Cutout image references (required) and either:
• (Source detection mode) :
• list of uncertainty search regions (required)
• SNR threshold (required)
• positional tolerance (required; some sensible default needed to override uncertainty for well determined objects)
• (Forced photometry mode):
• RA, Dec position pairs for each image (required)
• aperture radii to measure in (optional TBD if we let this be user configurable or fixed)

Output Parameters:

Either:

(Source detection mode)

• source catalog of detected objects and associated parameters that are within the uncertainty region and meet the positional and SNR thresholds
  or:
  (Forced photometry mode) table of photometry results containing at least:
• X/Y position
• RA/Dec position
• aperture fluxes and errors in the specified apertures
• magnitude and error
• flags (for e.g. bad pixel proximity, other objects, incomplete apertures, saturation)
• centroiding uncertainty
• separation from known source