Image Cutout Service Requirements (draft)

VO reference (for future check): IVOA SODA

DM-9769 - Getting issue details... STATUS

A. Requirements

For a given imageID (which uniquely identifies an image), based on the cutout parameters (orientation, center position, and size),  the cutout service will return a cutout image.

This document addresses the cutout services for two types of images, Processed Visit Images (PVIs) and coadded images.  

For PVI cutout: 

• • If the requested cutout size is larger than the given PVI, the cutout service needs to stitch multiple PVIs together:
    • The cutout service should only use the PVIs from the same full field of view (FOV), in other words, they are all taken at the same time. 
    • The cutout service needs to be able to cross image edges and to handle gaps in the coverage (e.g., gaps between CCDs) and set those pixels to some value (NULL?) that can be read by the visualizers and set to 'black'.
  • User could request the orientation of the cutout image in the camera array coordinate system (equivalent to the pixel space coordinate system) or any world coordinate system. 
  • If the orientation of the cutout is in the camera array coordinate system, the cutout service should respect that and do not do re-projection. The flux value in the output image should be the same as in original image. 
  • If the requested orientation of the cutout is in world coordinate system, the image needs to be re-projected to generate the cutout.

For coadded image cutout:

• • If the requested cutout size is larger than the given image, the cutout service needs to stitch multiple coadded images together.   
    • The cutout service may not need to take care of the gaps as there are supposedly no gaps between the coadded images.
  • User could request the orientation of the cutout, either in the pixel space coordinate of the given image or in any of the world coordinate systems.
  • If the requested orientation of the cutout is in world coordinate system, the image needs to be re-projected to generate the cutout.

The cutout service should be able to handle many calls without performance degrading.

B. Inputs to the cutout service

For a given image, the cutout input parameters define the orientation, the center position, and the size of the cutout image. 

(1)Orientation (string):

       This input defines the orientation of the cutout.  The cutout will be done along the longitude and latitude of the coordinate system (see Notes). 

        The orientation could be any of the following:

• • Pixel Coordinate 
  • Equatorial J2000
  • Equatorial B1950
  • Ecliptic J2000
  • Ecliptic B1950
  • Galactic
  • Super Galactic

(2)Center (decimal, decimal, string):

x, y, unit

• • The center parameter consists of a coordinate pair and an optional unit.
  • Unit can be pixel (px, pix, pixels) or angular (arcsec, arcmin, deg).
  • If unit is in pixel,  (x,y) is interpreted as the pixel space coordinate in the input image.
  • If unit is angular, (x,y) is interpreted as the right ascension(RA) and declination(Dec) in Equatorial J2000.
  • Valid Dec range is [-90, 90] degrees; Valid RA range is [0, 360]. 
    
    

Examples:

  (3)Size (decimal, decimal, string):

x, y, unit

• The size parameter consists of two size values and a unit specification. 
• Unit can be pixel (px, pix, pixels) or angular (arcsec, arcmin, deg).
• The (x, y) is taken to be the (full-width, full-height) in arc length of the requested cutout along the (longitude, latitude) direction or the (horizontal, vertical) pixel direction given in Orientation parameter above.
• Valid size values are positive decimal numbers.
  
  
  Examples:

C. Notes

We require that all the cutout images shall be North Up. In other words, if the orientation is one of the world coordinates, the line of longitude through the center of the cutout must be upright and at the middle of the image. See attached images from https://skyview.gsfc.nasa.gov.

D. Questions:

• LSST generated images:

• Definition of Track, ...