Documentation for Catalog/Image webservices provided by CASG/MAST

General Catalog Access : http://gsss.stsci.edu/webservices/vo/CatalogSearch.aspx?Parameters...

Required Parameter List
1 of the following 3 queries - VO ConeSearch, BoxSearch, IDsearch

1. RA=ra(deg) &DEC=dec(deg) &SR=search radius(deg)
2. BBOX=raMin(deg),decMin(deg),raMax(deg),decMax(deg)
3. ID=catID

Optional Parameters

• FORMAT= VOTABLE(default) | HTML | KML | CSV | TSV | JSON | TEXT(limited set of catalogs)
• CATALOG=GSC23(default) | GSC11 | GSC12 | USNOB | SDSS | FIRST | 2MASS | IRAS | GALEX | GAIA | TGAS | WISE
  | CAOM_OBSCORE | CAOM_OBSPOINTING | PS1V3OBJECTS | PS1V3DETECTIONS
• FILENAME=outputname (directs output to file)
• MAXOBJ=n (limits number of entries returned by brightest magnitude)
• MAGRANGE=bright,faint (limits number of entries returned by limits)
• MINDET=n (minimum numbr of detections PanSTARRS only)

e.g.

• http://gsss.stsci.edu/webservices/vo/CatalogSearch.aspx?RA=83.633083&DEC=22.0145&SR=.01&FORMAT=html&CAT=PS1V3OBJECTS&MINDET=25&MAXOBJ=5
• http://gsss.stsci.edu/webservices/vo/CatalogSearch.aspx?CAT=PS1V3OBJECTS&ID=134410836341049171&FORMAT=HTML
• http://gsss.stsci.edu/webservices/vo/CatalogSearch.aspx?ra=10&dec=20&sr=0.05&format=html
• http://gsss.stsci.edu/webservices/vo/CatalogSearch.aspx?bbox=10,20,10.5,21&format=csv&catalog=gsc11
• http://gsss.stsci.edu/webservices/vo/CatalogSearch.aspx?id=NBQI004317

HLA Catalog Access : http://masthla.stsci.edu/HLA/Catalogs/HLAcat.aspx?Parameters

Required Parameter List

• IMAGE=hlaImageName

Optional Parameters

• FORMAT= VOTABLE(default) | HTML | KML | CSV | TSV | JSON | TEXT
• CATALOG=IMG | DAO | SEX | GRI (default is IMG or GRI depending on imageName)
• FILENAME=outputname (directs output to file)
• MAXOBJ=n (limits number of entries returned by brightest magnitude)
• MAGRANGE=bright,faint (limits number of entries returned by limits)
• MULTI=T (creates multi-wavelength catalogs from DAO|SEX - default if imageName is TOTAL)
• IGNOREFLAG=T (ignore DAOphot/SourceExtractor flags - internal only)
• IGNOREPUBLISH=T (ignore catalog published flag - internal only)

e.g.

• http://masthla.stsci.edu/HLA/Catalogs/HLAcat.aspx?IMAGE=HST_11359_01_WFC3_IR_F125W
• http://masthla.stsci.edu/HLA/Catalogs/HLAcat.aspx?IMAGE=HAG_J004526.28%2B403856.3_J8HPDCAOQ

HLA Footprint Access : http://masthla.stsci.edu/HLA/Footprints/FPCone/fpcone.aspx?Parameters

Required Parameter List

• RA=ra(deg)
• DEC=dec(deg)
• SR=search radius(deg)
• LEVEL=hla product level

e.g.

• http://masthla.stsci.edu/HLA/Footprints/FPCone/fpcone.aspx?RA=210.802&DEC=54.348&SR=0.1&level=2

HLA-APT Footprint Service : http://masthla.stsci.edu/hla/Footprints/aptfootprint/Footprints.svc/Footprints?Parameters

Required Parameter List

• POS=ra(deg),dec(deg)
• SR=search radius(deg)
• LEVEL=hla product level
• INST=HST instrument

e.g.

• http://masthla.stsci.edu/hla/Footprints/aptfootprint/Footprints.svc/Footprints?POS=210.80212500000002,54.34808333333334&SIZE=0.23333333333333334&INST=ALL&LEVEL=Best
  

DSS Image Access : http://archive.stsci.edu/cgi-bin/dss_search?Parameters

Required Parameter List

• R=ra(hh:mm:ss.s)
• D=dec(dd:mm:ss.s)
• V= phase2_gsc1 | phase2_gsc2 | poss2ukstu | poss2ukstu_red | poss2ukstu_blue | poss2ukstu_ir | dss1 | poss1_red | poss1_blue | quickv
  
• H=height (arcmin)
• W=width (arcmin)

Optional Parameters

• F=fits (default)| gif
• C=none (default) | unix | gzip
• FOV= none (default) | launch | sm93 | sm97
• V3=roll angle (deg)

e.g.

• http://archive.stsci.edu/cgi-bin/dss_search?v=phase2&r=00+42+44.31&d=%2B41+16+09.4&e=J2000&h=15.0&w=15.0&f=gif&c=none&fov=NONE&v3=

DSS Plate Finder : http://archive.stsci.edu/cgi-bin/dss_plate_finder?Parameters

Required Parameter List

• R=ra(hh:mm:ss.s)
• D=dec(dd:mm:ss.s)
• H=height (arcmin)
• W=width (arcmin)

Optional Parameters

• FORMAT= FITS(default) | GIF
• PLATE_ID=xxxx DSS plate ID
• ACTION=EXTRACT

e.g.

• http://archive.stsci.edu/cgi-bin/dss_plate_finder?ra=00:00:00.00&dec=+00:00:00.00&height=12.0&width=12.0&format=FITS&plate_id=A0HA&action=Extract

DSS JPEG Image Access : http://gsss.stsci.edu/webservices/dssjpg/dss.svc/GetImage?Parameters

Required Parameter List

• POS=ra(deg),dec(deg)
• SIZE=width(deg),height(deg) | diameter(deg)

Optional Parameters

• ISIZE= WIDTH,HEIGHT | WIDTH | 0 in pixels optional size of resulting image
• ZOOM = 1|2|4|8|16|32|64|DYNAMIC zoom level of image returned
• DRAWDEBUG= ON|OFF to display tile outlines

e.g.

• http://gsss.stsci.edu/webservices/dssjpg/dss.svc/GetImage?POS=10.7,41.3&SIZE=2

GSC1 Access - Deprecated

http://gsss.stsci.edu/webservices/GSC1/GSC1DataReturn.aspx?Parameters

RAH RAM RAS are the right ascension
DSN DD DM DS are the declination
EQ=2000 is equinox (please set to 2000 as we no longer support 1950)
SIZE - box size in arcmin
SRCH=BOX to duplicate previous behaviour (other valid option is RADIUS)
FORMAT=Plain Text to duplicate previous behaviour (other valid options are VOTABLE CSV HTML)
CAT=GSC11 to access GSC 1.1 (other valid option is GSC12)
RGNID=xxxxx and SEQID=xxxxx to access GSC by ID rather than position

e.g.

• http://gsss.stsci.edu/webservices/GSC1/GSC1DataReturn.aspx?RAH=1&RAM=1&RAS=1&DSN=+&DD=1&DM=1&DS=1&EQ=2000&SIZE=15&SRCH=BOX&FORMAT=Plain%20Text&CAT=GSC11&RGNID=&SEQID=
  

GSC2 Access - Deprecated :

http://gsss.stsci.edu/webservices/GSC2/GSC2DataReturn.aspx?

RAH RAM RAS or RA are the right ascension
DSN DD DM DS or DEC are the declination
SIZE or R2 - search size in arcmin [R1 for inner radius cut to produce annulus)
M1/M2 = bright/faint magnitude limits
N - number objects returned (sorted by mag - returns TOP n brightest objects)
CLS - classification code selected (0=stellar, 3=non-stellar)
SRCH=BOX or RADIUS (default)
FORMAT=Plain Text to duplicate previous behaviour (other valid options are VOTABLE CSV TSV HTML)
RGNID=xxxxx and SEQID=xxxxx to access GSC by ID rather than position
HSTID=xxxxxxxxxx (GSC2 ID search) or GSC1ID=xxxxxxxxxx (GSC1 ID search)

e.g.

• http://gsss.stsci.edu/webservices/GSC2/GSC2DataReturn.aspx?RAH=1&RAM=1&RAS=1&DSN=+&DD=1&DM=1&DS=1&SIZE=15
• http://gsss.stsci.edu/webservices/GSC2/GSC2DataReturn.aspx?RA=1&DEC=1&SR=0.2
• http://gsss.stsci.edu/webservices/GSC2/GSC2DataReturn.aspx?RA=1&DEC=1&R2=30
• http://gsss.stsci.edu/webservices/GSC2/GSC2DataReturn.aspx?HSTID=NB2B000108