The IRSA Cutouts Service is a companion service to Atlas, IRSA's image search service. Atlas returns entire images, but Cutouts creates subimages from the original files at locations and sizes requested by the user. The Cutouts Service can be used on many of the data collections at IRSA. The cutouts can be requested via a web form, or an HTTP GET/POST program interface where the request is a set of "parameter=value" pairs and the return is an XML document containing URL links to the resulting data and metadata.

This document describes the program interface input parameters and the structure of the returned XML. Examples for some services are shown below.

A table upload option is available on the form interface but is not vital in program mode since users can perform this looping themselves.

Since Cutouts serves data for a large number of different datasets from different missions/collections, there are no default parameters for this service. The user must specify all required parameters. The form is:

• Base URL for the service is

  https://irsa.ipac.caltech.edu/cgi-bin/Cutouts/nph-cutouts

• Input parameters are specified by standard parameter/value pairs. For instance, "locstr=m51" searches for data covering M51.

• Output is an XML document containing a set of URL links to: the summaries of retrieved counts; the metadata tables; the download scripts for the retrieved data; and, for completeness, the HTML result page generated for the default interactive (non-program) mode. See the example in the XML Output section below for details.

The input parameters are entered as standard HTTP "parameter=value" pairs in HTTP/GET syntax. In this syntax, the parameter name is followed by an equal sign which is then followed by a value. No extra spaces are allowed and if the value contains any spaces or special characters that might cause ambiguities they have to be encoded as shown in any HTTP or URL reference (e.g. here). As shown above, these pairs are separated from each other by ampersand (&) characters.

The parameters are grouped here for presentation clarity into two subsets: manadatory search parameters for all data collections and manadatory search parameters for for specific data collections.

Mission = C2D

Mission = COSMOS

Mission = EIGA

Mission = ELFLock

Mission = FIDEL

Mission = FLS_ELAISN1_R

Mission = FLS_MAIN_R

Mission = FLS_VLA

Mission = GLIMPSE

Mission = GOODS

Mission = IGA

Mission = IRIS

Mission = IRTS

Mission = ISSA

Mission = LGA

Mission = LH

Mission = MIGA

Mission = MIPSGAL

Mission = MSX

Mission = SAGE

Mission = SWIRE

Mission = Taurus

Examples are given below using every mission parameter (dataset) listed above. The rest of the parameters are varied to show as examples. The same example is given twice, once for HTTP results and once for XML results (mode=PI). Valid input locations are used for each dataset. Listed at the very bottom of the examples are a few which show error conditions (bad input) and warnings of no data found at a specified location.

1. C2D (HTTP results)
   nph-cutouts?mission=C2D&min_size=1&max_size=600&units=arcsec&locstr=L1228&sizeX=45&ntable_cutouts=7&cutouttbl1=images_irac&cutouttbl2=images_irac_unc&cutouttbl3=images_irac_cov&cutouttbl4=images_mips&cutouttbl5=images_mips_unc&cutouttbl6=images_mips_cov&cutouttbl7=images_Av
   C2D (mission) data are searched at location of source "L1228" (locstr); size of search is 45 (sizeX) arcsec (units). The minimum allowed cutout size is 1 arcsec (min_size) and the maximum allowed cutout size is 600 arcsec (max_size). The number of Cutouts metadata tables is 7 (ntable_cutouts); each of the metadata table names are as follows: cutouttbl1=images_irac, cutouttbl2=images_irac_unc, cutouttbl3=images_irac_cov, cutouttbl4=images_mips, cutouttbl5=images_mips_unc, cutouttbl6=images_mips_cov, cutouttbl7=images_Av. The mode is not set (HTTP output).
   
   C2D (XML results)
   nph-cutouts?mission=C2D&min_size=1&max_size=600&units=arcsec&locstr=L1228&sizeX=45&ntable_cutouts=7&cutouttbl1=images_irac&cutouttbl2=images_irac_unc&cutouttbl3=images_irac_cov&cutouttbl4=images_mips&cutouttbl5=images_mips_unc&cutouttbl6=images_mips_cov&cutouttbl7=images_Av&mode=PI
   The same parameters apply as above but the mode is set to Program Interface (PI).
   
   
2. COSMOS (HTTP results)
   nph-cutouts?mission=COSMOS&max_size=180&locstr=150.425933+2.430235&sizeX=15&ntable_cutouts=18&cutouttbl1=acs_mosaic_2.0&cutouttbl2=wfpc&cutouttbl3=nicmos_sci&cutouttbl4=subaru_mosaics&cutouttbl5=cfht_mosaics&cutouttbl6=kpno_mosaics&cutouttbl7=sdss_sci&cutouttbl8=irac_sci&cutouttbl9=mips_sci&cutouttbl10=galex_sci&cutouttbl11=vla_lg_dp&cutouttbl12=xmm_img
   COSMOS (mission) data are searched at location of source "150.425933 2.430235" (locstr); size of search is 15 (sizeX) degrees (units). There is no minimum allowed cutout size (min_size) and the maximum allowed cutout size is 180 degrees (max_size). The number of Cutouts metadata tables is 18 (ntable_cutouts); each of the metadata table names are as follows: cutouttbl1=acs_mosaic_2.0, cutouttbl2=wfpc, cutouttbl3=nicmos_sci, cutouttbl4=subaru_mosaics, cutouttbl5=cfht_mosaics, cutouttbl6=kpno_mosaics, cutouttbl7=sdss_sci, cutouttbl8=irac_sci, cutouttbl9=mips_sci, cutouttbl10=galex_sci, cutouttbl11=vla_lg_dp, cutouttbl12=xmm_sci. The mode is not set (HTTP output)
   
   COSMOS (XML results)
   nph-cutouts?mission=COSMOS&max_size=180&locstr=150.425933+2.430235&sizeX=15&ntable_cutouts=18&cutouttbl1=acs_mosaic_2.0&cutouttbl2=wfpc&cutouttbl3=nicmos_sci&cutouttbl4=subaru_mosaics&cutouttbl5=cfht_mosaics&cutouttbl6=kpno_mosaics&cutouttbl7=sdss_sci&cutouttbl8=irac_sci&cutouttbl9=mips_sci&cutouttbl10=galex_sci&cutouttbl11=vla_lg_dp&cutouttbl12=xmm_img&mode=PI
   The same parameters apply as above but the mode is set to Program Interface (PI).
   
   
3. EIGA (HTTP results)
   nph-cutouts?mission=EIGA&min_size=756&max_size=7200&units=deg&locstr=20h+50m+36.82s++51d+46m+13.7s+Equ+J2000&sizeX=0.25&ntable_cutouts=4&cutouttbl1=EIGA_band3_iter1&cutouttbl2=EIGA_band4_iter1&cutouttbl3=EIGA_band3_iter20&cutouttbl4=EIGA_band4_iter20
   EIGA (mission) data are searched at location of source location: "20h 50m 36.82s +51d 46m+13.7s Equ J2000" (locstr); size of search is 0.25 (sizeX) degrees (units). The minimum allowed cutout size is 756 degrees (min_size) and the maximum allowed cutout size is 7200 degrees (max_size). The number of Cutouts metadata tables is 4 (ntable_cutouts); each of the metadata table names are as follows: cutouttbl1=EIGA_band3_iter1, cutouttbl2=EIGA_band4_iter1, cutouttbl3=EIGA_band3_iter20, cutouttbl4=EIGA_band4_iter20. The mode is not set (HTTP output).
   
   EIGA (XML results)
   nph-cutouts?mission=EIGA&min_size=756&max_size=7200&units=deg&locstr=20h+50m+36.82s++51d+46m+13.7s+Equ+J2000&sizeX=0.25&ntable_cutouts=4&cutouttbl1=EIGA_band3_iter1&cutouttbl2=EIGA_band4_iter1&cutouttbl3=EIGA_band3_iter20&cutouttbl4=EIGA_band4_iter20&mode=PI
   The same parameters apply as above but the mode is set to Program Interface (PI).
   
   
4. ELFLock (HTTP results)
   nph-cutouts?mission=ELFLock&min_size=1&max_size=3600&units=arcmin&locstr=NGC+3353&sizeX=5.0&ntable_cutouts=1&cutouttbl1=image
   ELFLock (mission) data are searched at location of source "NGC 3353" (locstr); size of search is 5.0 (sizeX) arcmin (units). The minimum allowed cutout size is 1 arcmin (min_size) and the maximum allowed cutout size is 3600 arcmin (max_size). The number of Cutouts metadata tables is 1 (ntable_cutouts); the metadata table name is: cutouttbl1=images. The mode is not set (HTTP output).
   
   ELFLock (XML results)
   nph-cutouts?mission=ELFLock&min_size=1&max_size=3600&units=arcmin&locstr=NGC+3353&sizeX=5.0&ntable_cutouts=1&cutouttbl1=image&mode=PI
   The same parameters apply as above but the mode is set to Program Interface (PI).
   
   
5. FIDEL (HTTP results)
   nph-cutouts?mission=FIDEL&min_size=1&max_size=600&units=arcsec&locstr=53.158591+-27.891113+eq&sizeX=30.0&ntable_cutouts=3&cutouttbl1=images_sci&cutouttbl2=images_std&cutouttbl3=images_exp
   FIDEL (mission) data are searched at location "53.158591 -27.891113 eq" (locstr); size of search is 30.0 (sizeX) arcsec (units). The minimum allowed cutout size is 1 arcsec (min_size) and the maximum allowed cutout size is 600 arcsec (max_size). The number of Cutouts metadata tables is 3 (ntable_cutouts); the metadata table names are: cutouttbl1=images_sci, cutouttbl2=images_std, and cutouttbl3=images_exp. The mode is not set (HTTP output).
   
   FIDEL (XML results)
   nph-cutouts?mission=FIDEL&min_size=1&max_size=600&units=arcsec&locstr=53.158591+-27.891113+eq&sizeX=30.0&ntable_cutouts=3&cutouttbl1=image_sci&cutouttbl2=images_std&cutouttbl3=images_exp&mode=PI
   The same parameters apply as above but the mode is set to Program Interface (PI).
   
   
6. FLS_ELAISN1_R (HTTP results)
   nph-cutouts?mission=FLS_ELAISN1_R&min_size=1&max_size=600&units=arcsec&locstr=242.76971++54.47632+eq&sizeX=25&ntable_cutouts=4&cutouttbl1=FLS_ELAISN1_R&cutouttbl2=FLS_ELAISN1_R_fullfield
   FLS_ELAISN1_R (mission) data are searched at location of source "242.76971 +54.47632 eq" (locstr); size of search is 25 (sizeX) arcsec (units). The minimum allowed cutout size is 1 arcsec (min_size) and the maximum allowed cutout size is 600 arcsec (max_size). The number of Cutouts metadata tables is 4 (ntable_cutouts); each of the metadata table names are as follows: cutouttbl1=FLS_ELAISN1_R, cutouttbl2=FLS_ELAISN1_R_fullfield. The mode is not set (HTTP output).
   
   FLS_ELAISN1_R (XML results)
   nph-cutouts?mission=FLS_ELAISN1_R&min_size=1&max_size=600&units=arcsec&locstr=242.76971++54.47632+eq&sizeX=25&ntable_cutouts=4&cutouttbl1=FLS_ELAISN1_R&cutouttbl2=FLS_ELAISN1_R_fullfield&mode=PI
   The same parameters apply as above but the mode is set to Program Interface (PI).
   
   
7. FLS_MAIN_R (HTTP results)
   nph-cutouts?mission=FLS_MAIN_R&min_size=1&max_size=600&units=arcsec&locstr=FLSVLA J171940.2+592449&sizeX=25&ntable_cutouts=2&cutouttbl1=FLS_MAIN_R&cutouttbl2=FLS_MAIN_R_fullfield
   FLS_MAIN_R (mission) data are searched at location of source "FLSVLA J171940.2 +592449" (locstr); size of search is 25 (sizeX) arcsec (units). The minimum allowed cutout size is 1 arcsec (min_size) and the maximum allowed cutout size is 600 arcsec (max_size). The number of Cutouts metadata tables is 2 (ntable_cutouts); each of the metadata table names are as follows: cutouttbl1=FLS_MAIN_R, cutouttbl2=FLS_MAIN_R_fullfield. The mode is not set (HTTP output).
   
   FLS_MAIN_R (XML results)
   mission=FLS_MAIN_R&min_size=1&max_size=600&units=arcsec&locstr=FLSVLA J171940.2+592449&sizeX=25&ntable_cutouts=2&cutouttbl1=FLS_MAIN_R&cutouttbl2=FLS_MAIN_R_fullfield&mode=PI
   The same parameters apply as above but the mode is set to Program Interface (PI).
   
   
8. FLS_VLA (HTTP results)
   nph-cutouts?mission=FLS_VLA&min_size=20&max_size=3600&units=arcmin&outtype=single&locstr=89.33984+34.69237+ga&sizeX=4.0&upload=&col_ra=1&col_dec=2&col_sizeX=&tbl_sizeX=4.0&ntable_cutouts=1&cutouttbl1=FLS_VLA
   FLS_VLA (mission) data are searched at location of source "FLSVLA J171940.2 +592449" (locstr); size of search is 25 (sizeX) arcmin (units). The minimum allowed cutout size is 1 arcmin (min_size) and the maximum allowed cutout size is 600 arcmin (max_size). The number of Cutouts metadata tables is 4 (ntable_cutouts); each of the metadata table names are as follows: cutouttbl1=FLS_MAIN_R, cutouttbl2=FLS_MAIN_R_fullfield. The mode is not set (HTTP output).
   
   FLS_VLA (XML results)
   nph-cutouts?mission=FLS_VLA&min_size=20&max_size=3600&units=arcmin&outtype=single&locstr=89.33984+34.69237+ga&sizeX=4.0&upload=&col_ra=1&col_dec=2&col_sizeX=&tbl_sizeX=4.0&ntable_cutouts=1&cutouttbl1=FLS_VLA&mode=PI
   The same parameters apply as above but the mode is set to Program Interface (PI).
   
   
9. GLIMPSE (HTTP results)
   nph-cutouts?mission=GLIMPSE&min_size=1&max_size=599&units=arcsec&locstr=+16h+38m+06.53s+-45d+52m+55.3s+Equ+J2000&sizeX=25&ntable_cutouts=8&cutouttbl1=IRAC1_0.6ResMos&cutouttbl2=IRAC2_0.6ResMos&cutouttbl3=IRAC3_0.6ResMos&cutouttbl4=IRAC4_0.6ResMos&cutouttbl5=IRAC1_1.2ResMos&cutouttbl6=IRAC2_1.2ResMos&cutouttbl7=IRAC3_1.2ResMos&cutouttbl8=IRAC4_1.2ResMos
   GLIMPSE [mission] (includes GLIMPSE I, II and 3D) data are searched at location of source "16h 38m 06.53s -45d 52m 55.3s Equ J2000" [locstr]; size of search is 25 arcsec (units). The minimum allowed cutout size is 1 arcsec (min_size) and the maximum allowed cutout size is 599 arcsec (max_size). The number of Cutouts metadata tables is 8 (ntable_cutouts); each of the metadata table names are as follows: cutouttbl1=IRAC1_0.6ResMos, cutouttbl2=IRAC2_0.6ResMos, cutouttbl3=IRAC3_0.6ResMos, cutouttbl4=IRAC4_0.6ResMos, cutouttbl5=IRAC1_1.2ResMos, cutouttbl6=IRAC2_1.2ResMos, cutouttbl7=IRAC3_1.2ResMos, cutouttbl8=IRAC4_1.2ResMos. The mode is not set (HTTP output).
   
   GLIMPSE (XML results)
   nph-cutouts?mission=GLIMPSE&min_size=1&max_size=599&units=arcsec&locstr=+16h+38m+06.53s+-45d+52m+55.3s+Equ+J2000&sizeX=25&ntable_cutouts=8&cutouttbl1=IRAC1_0.6ResMos&cutouttbl2=IRAC2_0.6ResMos&cutouttbl3=IRAC3_0.6ResMos&cutouttbl4=IRAC4_0.6ResMos&cutouttbl5=IRAC1_1.2ResMos&cutouttbl6=IRAC2_1.2ResMos&cutouttbl7=IRAC3_1.2ResMos&cutouttbl8=IRAC4_1.2ResMos&mode=PI
   The same parameters apply as above but the mode is set to Program Interface (PI).
   
   
10. GOODS (HTTP results)
    /nph-cutouts?mission=SGOODS&min_size=1&max_size=600&units=arcsec&locstr=COMBO-17+30561&sizeX=15&ntable_cutouts=4&cutouttbl1=Spitzer_IRAC_DR3&cutouttbl2=Spitzer_MIPS_DR3&cutouttbl3=Spitzer_IRAC_DR2&cutouttbl4=Ancillary_Opical
    GOODS (mission) data are searched at location of source "COMBO-17 30561" (locstr); size of search is 0.15 (sizeX) arcsec (units). The minimum allowed cutout size is 1 arcsec (min_size) and the maximum allowed cutout size is 600 arcsec (max_size). The number of Cutouts metadata tables is 4 (ntable_cutouts); each of the metadata table names are as follows: cutouttbl1=Spitzer_IRAC_DR3, cutouttbl2=Spitzer_MIPS_DR3,cutouttbl3=Spitzer_IRAC_DR2, cutouttbl4=Ancillary_Opical. The mode is not set (HTTP output).
    
    GOODS (XML results)
    /nph-cutouts?mission=SGOODS&min_size=1&max_size=600&units=arcsec&locstr=COMBO-17+30561&sizeX=15&ntable_cutouts=4&cutouttbl1=Spitzer_IRAC_DR3&cutouttbl2=Spitzer_MIPS_DR3&cutouttbl3=Spitzer_IRAC_DR2&cutouttbl4=Ancillary_Opical&mode=PI
    The same parameters apply as above but the mode is set to Program Interface (PI).
    
    
11. IGA (HTTP results)
    nph-cutouts?mission=IGA&min_size=756&max_size=7200&units=deg&locstr=M+16&sizeX=0.25&ntable_cutouts=4&cutouttbl1=IGA_band3_iter1&cutouttbl2=IGA_band4_iter1&cutouttbl3=IGA_band3_iter20&cutouttbl4=IGA_band4_iter20
    IGA (mission) data are searched at location of source "M 16" (locstr); size of search is 0.25 (sizeX) degrees (units). The minimum allowed cutout size is 756 degrees (min_size) and the maximum allowed cutout size is 7200 degrees (max_size). The number of Cutouts metadata tables is 4 (ntable_cutouts); each of the metadata table names are as follows: cutouttbl1=IGA_band3_iter1, cutouttbl2=IGA_band4_iter1,cutouttbl3=IGA_band3_iter20, cutouttbl4=IGA_band4_iter20. The mode is not set (HTTP output).
    
    IGA (XML results)
    nph-cutouts?mission=IGA&min_size=756&max_size=7200&units=deg&locstr=M+16&sizeX=0.25&ntable_cutouts=4&cutouttbl1=IGA_band3_iter1&cutouttbl2=IGA_band4_iter1&cutouttbl3=IGA_band3_iter20&cutouttbl4=IGA_band4_iter20&mode=PI
    The same parameters apply as above but the mode is set to Program Interface (PI).
    Note, the XML output results of this example are discussed in the XML Output section below.
    
    
12. IRIS (HTTP results)
    nph-cutouts?mission=IRIS&min_size=756&max_size=7200&units=deg&locstr=335.762875+59.146226+eq&sizeX=0.25&ntable_cutouts=4&cutouttbl1=IRIS_band1&cutouttbl2=IRIS_band2&cutouttbl3=IRIS_band3&cutouttbl4=IRIS_band4
    IRIS (mission) data are searched at location of source "335.762875 59.146226 eq" (locstr); size of search is 0.25 (sizeX) degrees (units). The minimum allowed cutout size is 756 degrees (min_size) and the maximum allowed cutout size is 7200 degrees (max_size). The number of Cutouts metadata tables is 4 (ntable_cutouts); each of the metadata table names are as follows: cutouttbl1=IRIS_band1, cutouttbl2=IRIS_band2,cutouttbl3=IRIS_band3, cutouttbl4=IRIS_band4. The mode is not set (HTTP output).
    
    IRIS (XML results)
    nph-cutouts?mission=IRIS&min_size=756&max_size=7200&units=deg&locstr=335.762875+59.146226+eq&sizeX=0.25&ntable_cutouts=4&cutouttbl1=IRIS_band1&cutouttbl2=IRIS_band2&cutouttbl3=IRIS_band3&cutouttbl4=IRIS_band4&mode=PI
    The same parameters apply as above but the mode is set to Program Interface (PI).
    
    
13. IRTS (HTTP results)
    nph-cutouts?mission=IRTS&min_size=756&max_size=14400&units=deg&locstr=47.09669+-1.71325+ga&sizeX=0.5&ntable_cutouts=6&cutouttbl1=IRTS_FILM_155um&cutouttbl2=IRTS_FILM_CII&cutouttbl3=IRTS_FIRP_250um&cutouttbl4=IRTS_FIRP_400um&cutouttbl5=IRTS_FIRP_700um&cutouttbl6=IRTS_MIRS_7_7um
    IRTS (mission) data are searched at location of source "47.09669 -1.71325 ga" (locstr); size of search is 0.5 (sizeX) degrees (units). The minimum allowed cutout size is 756 degrees (min_size) and the maximum allowed cutout size is 14400 degrees (max_size). The number of Cutouts metadata tables is 6 (ntable_cutouts); each of the metadata table names are as follows: cutouttbl1=IRTS_FILM_155um, cutouttbl2=IRTS_FILM_CII,cutouttbl3=IRTS_FIRP_250um, cutouttbl4=IRTS_FIRP_400um, cutouttbl5=IRTS_FIRP_700um, cutouttbl6=IRTS_MIRS_7_7um. The mode is not set (HTTP output)
    
    IRTS (XML results)
    nph-cutouts?mission=IRTS&min_size=756&max_size=14400&units=deg&locstr=47.09669+-1.71325+ga&sizeX=0.5&ntable_cutouts=6&cutouttbl1=IRTS_FILM_155um&cutouttbl2=IRTS_FILM_CII&cutouttbl3=IRTS_FIRP_250um&cutouttbl4=IRTS_FIRP_400um&cutouttbl5=IRTS_FIRP_700um&cutouttbl6=IRTS_MIRS_7_7um&mode=PI
    The same parameters apply as above but the mode is set to Program Interface (PI).
    
    
14. ISSA (HTTP results)
    nph-cutouts?mission=ISSA&min_size=756&max_size=7200&units=deg&locstr=22h+23m+03.09s++59d+08m+46.4s+Equ+J2000&sizeX=0.25&ntable_cutouts=4&cutouttbl1=ISSA_band1&cutouttbl2=ISSA_band2&cutouttbl3=ISSA_band3&cutouttbl4=ISSA_band4
    ISSA (mission) data are searched at location of source "22h 23m 03.09s +59d 08m 46.4s Equ J2000" (locstr); size of search is 0.25 (sizeX) degrees (units). The minimum allowed cutout size is 756 degrees (min_size) and the maximum allowed cutout size is 7200 degrees (max_size). The number of Cutouts metadata tables is 4 (ntable_cutouts); each of the metadata table names are as follows: cutouttbl1=ISSA_band1, cutouttbl2=ISSA_band2,cutouttbl3=ISSA_band3, cutouttbl4=ISSA_band4. The mode is not set (HTTP output)
    
    ISSA (XML results)
    nph-cutouts?mission=ISSA&min_size=756&max_size=7200&units=deg&locstr=22h+23m+03.09s++59d+08m+46.4s+Equ+J2000&sizeX=0.25&ntable_cutouts=4&cutouttbl1=ISSA_band1&cutouttbl2=ISSA_band2&cutouttbl3=ISSA_band3&cutouttbl4=ISSA_band4&mode=PI
    The same parameters apply as above but the mode is set to Program Interface (PI).
    
    
15. LGA (HTTP results)
    nph-cutouts?mission=LGA&min_size=1&max_size=3600&units=arcmin&locstr=188.86008++14.49636+eq&sizeX=4.0&ntable_cutouts=3&cutouttbl1=LGA_J_band&cutouttbl2=LGA_H_band&cutouttbl3=LGA_K_band
    LGA (mission) data are searched at location of source "188.86008 +14.49636 eq" (locstr); size of search is 4.0 (sizeX) arcmin (units). The minimum allowed cutout size is 1 arcmin (min_size) and the maximum allowed cutout size is 3600 arcmin (max_size). The number of Cutouts metadata tables is 3 (ntable_cutouts); each of the metadata table names are as follows: cutouttbl1=LGA_J_band, cutouttbl2=LGA_H_band,cutouttbl3=LGA_K_band. The mode is not set (HTTP output)
    
    LGA (XML results)
    nph-cutouts?mission=LGA&min_size=1&max_size=3600&units=arcmin&locstr=188.86008++14.49636+eq&sizeX=4.0&ntable_cutouts=3&cutouttbl1=LGA_J_band&cutouttbl2=LGA_H_band&cutouttbl3=LGA_K_band&mode=PI
    The same parameters apply as above but the mode is set to Program Interface (PI).
    
    
16. LH (HTTP results)
    nph-cutouts?mission=LH&min_size=1&max_size=3600&units=arcmin&locstr=NGC+3353&sizeX=4.0&ntable_cutouts=3&cutouttbl1=LH_J_band&cutouttbl2=LH_H_band&cutouttbl3=LH_K_band
    LH (mission) data are searched at location of source "NGC 3353" (locstr); size of search is 4.0 (sizeX) arcmin (units). The minimum allowed cutout size is 1 arcmin (min_size) and the maximum allowed cutout size is 3600 arcmin(max_size). The number of Cutouts metadata tables is 3 (ntable_cutouts); each of the metadata table names are as follows: cutouttbl1=LH_J_band, cutouttbl2=LH_H_band,cutouttbl3=LH_K_band. The mode is not set (HTTP output)
    
    LH (XML results)
    nph-cutouts?mission=LH&min_size=1&max_size=3600&units=arcmin&locstr=NGC+3353&sizeX=4.0&ntable_cutouts=3&cutouttbl1=LH_J_band&cutouttbl2=LH_H_band&cutouttbl3=LH_K_band&mode=PI
    The same parameters apply as above but the mode is set to Program Interface (PI).
    
    
17. MIGA (HTTP results)
    nph-cutouts?mission=MIGA&min_size=756&max_size=7200&units=deg&locstr=22h+23m+03.09s++59d+08m+46.4s+Equ+J2000&sizeX=0.25&ntable_cutouts=4&cutouttbl1=MIGA_band1_iter1&cutouttbl2=MIGA_band2_iter1&cutouttbl3=MIGA_band1_iter20&cutouttbl4=MIGA_band2_iter20
    MIGA (mission) data are searched at location of source "22h 23m 03.09s +59d 08m 46.4s Equ J2000" (locstr); size of search is 0.25 (sizeX) degrees (units). The minimum allowed cutout size is 756 degrees (min_size) and the maximum allowed cutout size is 7200 degrees (max_size). The number of Cutouts metadata tables is 4 (ntable_cutouts); each of the metadata table names are as follows: cutouttbl1=MIGA_band1_iter1, cutouttbl2=MIGA_band2_iter1,cutouttbl3=MIGA_band1_iter20, cutouttbl4=MIGA_band2_iter20. The mode is not set (HTTP output)
    
    MIGA (XML results)
    nph-cutouts?mission=MIGA&min_size=756&max_size=7200&units=deg&locstr=22h+23m+03.09s++59d+08m+46.4s+Equ+J2000&sizeX=0.25&ntable_cutouts=4&cutouttbl1=MIGA_band1_iter1&cutouttbl2=MIGA_band2_iter1&cutouttbl3=MIGA_band1_iter20&cutouttbl4=MIGA_band2_iter20&mode=PI
    The same parameters apply as above but the mode is set to Program Interface (PI).
    
    
18. MIPSGAL (HTTP results)
    nph-cutouts?mission=MIPSGAL&min_size=756&max_size=7200&units=deg&locstr=NGC+6631++&sizeX=0.25&ntable_cutouts=1&cutouttbl1=mipsgal_cutouts
    MIPSGAL (mission) data are searched at location of source "NGC 6631" (locstr); size of search is 0.25 (sizeX) degrees (units). The minimum allowed cutout size is 765 degrees (min_size) and the maximum allowed cutout size is 7200 degrees (max_size). The number of Cutouts metadata tables is 1 (ntable_cutouts); the metadata table name is: cutouttbl1=mipsgal_cutouts. The mode is not set (HTTP output)
    
    MIPSGAL (XML results)
    nph-cutouts?mission=MIPSGAL&min_size=756&max_size=7200&units=deg&locstr=NGC+6631++&sizeX=0.25&ntable_cutouts=1&cutouttbl1=mipsgal_cutouts&mode=PI
    The same parameters apply as above but the mode is set to Program Interface (PI).
    
    
19. MSX (HTTP results)
    nph-cutouts?mission=MSX&min_size=756&max_size=7200&units=deg&locstr=46.5377+-0.2518+ga&sizeX=0.25&ntable_cutouts=5&cutouttbl1=MSX_bandA&cutouttbl2=MSX_bandC&cutouttbl3=MSX_bandD&cutouttbl4=MSX_bandE&cutouttbl5=MSX_mosaics
    MSX (mission) data are searched at location of source "46.5377 -0.2518 ga" (locstr); size of search is 0.25 (sizeX) degrees (units). The minimum allowed cutout size is 765 degrees (min_size) and the maximum allowed cutout size is 7200 degrees (max_size). The number of Cutouts metadata tables is 5 (ntable_cutouts); each of the metadata table names are as follows: cutouttbl1=MSX_bandA, cutouttbl2=MSX_bandC,cutouttbl3=MSX_bandD, cutouttbl4=MSX_bandE, cutouttbl5=MSX_mosaics. The mode is not set (HTTP output)
    
    MSX (XML results)
    nph-cutouts?mission=MSX&min_size=756&max_size=7200&units=deg&locstr=46.5377+-0.2518+ga&sizeX=0.25&ntable_cutouts=5&cutouttbl1=MSX_bandA&cutouttbl2=MSX_bandC&cutouttbl3=MSX_bandD&cutouttbl4=MSX_bandE&cutouttbl5=MSX_mosaics&mode=PI
    The same parameters apply as above but the mode is set to Program Interface (PI).
    
    
20. SAGE (HTTP results)
    nph-cutouts?mission=SAGE&min_size=756&max_size=7200&units=deg&locstr=NGC+2070&sizeX=0.25&ntable_cutouts=3&cutouttbl1=mips24&cutouttbl2=mips70&cutouttbl3=mips160
    SAGE (mission) data are searched at location of source "NGC 2070" (locstr); size of search is 0.25 (sizeX) degrees (units). The minimum allowed cutout size is 756 arcsec (min_size) and the maximum allowed cutout size is 7200 arcsec (max_size). The number of Cutouts metadata tables is 3 (ntable_cutouts); each of the metadata table names are as follows: cutouttbl1=mips24, cutouttbl2=mips70, cutouttbl3=mips160. The mode is not set (HTTP output)
    
    SAGE (XML results)
    nph-cutouts?mission=SAGE&min_size=756&max_size=7200&units=deg&locstr=NGC+2070&sizeX=0.25&ntable_cutouts=3&cutouttbl1=mips24&cutouttbl2=mips70&cutouttbl3=mips160&mode=PI
    The same parameters apply as above but the mode is set to Program Interface (PI).
    
    
21. SWIRE (HTTP results)
    nph-cutouts?mission=SWIRE&min_size=1&max_size=600&units=arcsec&locstr=241.51621+55.42525+eq&sizeX=25&ntable_cutouts=4&cutouttbl1=SWIRE_Spitzer_IRAC&cutouttbl2=SWIRE_Spitzer_MIPS&cutouttbl3=SWIRE_Anc_Optical&cutouttbl4=SWIRE_Anc_ISO
    SWIRE (mission) data are searched at location of source "241.51621 55.42525 eq" (locstr); size of search is 25 (sizeX) arcsec (units). The minimum allowed cutout size is 1 arcsec (min_size) and the maximum allowed cutout size is 600 arcsec (max_size). The number of Cutouts metadata tables is 4 (ntable_cutouts); each of the metadata table names are as follows: cutouttbl1=SWIRE_Spitzer_IRAC, cutouttbl2=SWIRE_Spitzer_MIPS,cutouttbl3=SWIRE_Anc_Optical, cutouttbl4=SWIRE_Anc_ISO. The mode is not set (HTTP output)
    
    SWIRE (XML results)
    nph-cutouts?mission=SWIRE&min_size=1&max_size=600&units=arcsec&locstr=241.51621+55.42525+eq&sizeX=25&ntable_cutouts=4&cutouttbl1=SWIRE_Spitzer_IRAC&cutouttbl2=SWIRE_Spitzer_MIPS&cutouttbl3=SWIRE_Anc_Optical&cutouttbl4=SWIRE_Anc_ISO&mode=PI
    The same parameters apply as above but the mode is set to Program Interface (PI).
    
    
22. Taurus (HTTP results)
    nph-cutouts?mission=Taurus&min_size=756&max_size=7200&units=deg&locstr=68.74+26.205+eq&sizeX=0.21&cutouttbl1=irac_ch1&cutouttbl2=irac_ch2&cutouttbl3=irac_ch3&cutouttbl4=irac_ch4&cutouttbl5=mips_24_E1&cutouttbl6=mips_24_E2&cutouttbl7=mips_70&cutouttbl8=mips_160&ntable_cutouts=8
    Taurus (mission) data are searched at location "68.74 +26.205 eq" (locstr); size of search is 0.21 (sizeX) degrees (units). The minimum allowed cutout size is 756 arcsec (min_size) and the maximum allowed cutout size is 7200 arcsec (max_size). The number of Cutouts metadata tables is 8 (ntable_cutouts); each of the metadata table names are as follows: cutouttbl1=irac_ch1, cutouttbl2=irac_ch2, cutouttbl3=irac_ch3, cutouttbl4=irac_ch4, cutouttbl5=mips_24_E1, cutouttbl6=mips_24_E2, cutouttbl7=mips_70, cutouttbl8=mips_160. The mode is not set (HTTP output)
    
    Taurus (XML results)
    nph-cutouts?mission=Taurus&min_size=756&max_size=7200&units=deg&locstr=68.74+26.205+eq&sizeX=0.21&cutouttbl1=irac_ch1&cutouttbl2=irac_ch2&cutouttbl3=irac_ch3&cutouttbl4=irac_ch4&cutouttbl5=mips_24_E1&cutouttbl6=mips_24_E2&cutouttbl7=mips_70&cutouttbl8=mips_160&ntable_cutouts=8&mode=PI
    The same parameters apply as above but the mode is set to Program Interface (PI).
    
    

Normally, when you run a web application the return is HTML text which is rendered in a browser and contains links to download additional data files. However, HTML is notoriously difficult to parse, so in program mode we instead return a simple XML document. This document can be rendered in a browser but the normal use pattern is as follows: have your program make an HTTP request using the above parameters; retrieving the XML result into a file (or memory); parse it; extract links to the desired final data files; and use these links (again from your program) to retrieve the data.

The interaction above can be done in a variety of ways, ranging from simple scripting (using programs like 'wget') to integrated URL-access and XML-parsing in JAVA, PERL, Python, etc. Our XML is simple enough that if you do not have XML-parsing tools simple pattern checking (manually built code or tools like PERL) should suffice.

The returned XML "inventory" contains two types of information: counts (e.g. how many Images were found) and links (URLs you can use to download data files from a temporary workspace). Some of these data files are 'wget' scripts provided as a convenience for people who want to use that mechanism for bulk data downloads.

Below we give example XML output for three of the use cases above. The first block is from Example 11 above (a normal return), the second is an example error return (using a bogus coordinate locstr value of "bla") and the third is an example of a notication that no sources were found for a valid position. After these examples, we will enumerate all the tags that might be returned by a successful query. These examples vary only in the input constraints; their XML outputs are similar in layout with varying number of result images, catalog sources and spectra; when none are found the result tags are skipped.

Output from Example 11:

    <?xml version="1.0"?>
    <result status="ok">
      <description>
        <collection> IGA  </collection>
        <ra> 274.700730  </ra>
        <dec> -13.807230  </dec>
        <regSize> 0.250000  </regSize>
        <units> degrees  </units>
      </description>
      <summary>
        <resultHtml>
	  https://irsa.ipac.caltech.edu:443/workspace/TMP_AAAylaqUG/Cutouts/MESSIER_016.v0001/index.html
        </resultHtml>
        <counts>
          <cutoutsN> 8  </cutoutsN>
          <skipN>  0  </skipN>
        </counts>
        <downloadScript>
          <fits>
            https://irsa.ipac.caltech.edu:443/workspace/TMP_AAAylaqUG/Cutouts/MESSIER_016.v0001/wget_fits_cutouts.bat
          </fits>
          <jpg>
            https://irsa.ipac.caltech.edu:443/workspace/TMP_AAAylaqUG/Cutouts/MESSIER_016.v0001/wget_jpg_cutouts.bat
          </jpg>
        </downloadScript>
      </summary>
      <images>
        <counts> 8  <counts>
        <metadata>
            https://irsa.ipac.caltech.edu:443/workspace/TMP_AAAylaqUG/Cutouts/MESSIER_016.v0001/result.tbl
        </metadata>
        <metadataHTML>
            https://irsa.ipac.caltech.edu:443/workspace/TMP_AAAylaqUG/Cutouts/MESSIER_016.v0001/result.html
        </metadataHTML>
        <cutouts>
           <fits> 
            https://irsa.ipac.caltech.edu:443/workspace/TMP_AAAylaqUG/Cutouts/MESSIER_016.v0001/results/IGA_band3_iter1/0001_274.70073000_-13.80723000_IGA_img_p0662g017+00_b3_1.fits
           </fits>
           <jpg>
            https://irsa.ipac.caltech.edu:443/workspace/TMP_AAAylaqUG/Cutouts/MESSIER_016.v0001/results/IGA_band3_iter1/0001_274.70073000_-13.80723000_IGA_img_p0662g017+00_b3_1.jpg
           </jpg>
           <fits>
            https://irsa.ipac.caltech.edu:443/workspace/TMP_AAAylaqUG/Cutouts/MESSIER_016.v0001/results/IGA_band3_iter1/0001_274.70073000_-13.80723000_IGA_img_p0662g017+01_b3_1.fits
           </fits>
           <jpg>
            https://irsa.ipac.caltech.edu:443/workspace/TMP_AAAylaqUG/Cutouts/MESSIER_016.v0001/results/IGA_band3_iter1/0001_274.70073000_-13.80723000_IGA_img_p0662g017+01_b3_1.jpg
           </jpg>

           Note: The above only lists 2 of the 8 image cutouts.  Six more fits/jpg image cutouts were removed from the list, to keep the example compact.

        </cutouts>

      </images>
    </result> 
  

 
    <?xml version="1.0"?>
    <result status="error">
      <message>
         Coordinate lookup error:  Either no location string given, or position table was used without selecting 'Multiple Positions' button.  Please try again.
      </message>
    </result>
  

The structure of the XML file is straightforward and is fully illustrated by the above examples; we do not feel it necessary to provide formal schema information. We may add information to the XML as needed, though we will make every effort not to change the existing tag structure in the process.