Herschel Footprint Tools

rest web service

Use the REST service to access the footprint database programatically from your data processing and plotting scripts. Certain functions can return data in various formats (json, xml, ascii), while others support ascii only. We suggest using the command-line tool curl for testing. The service base URL is: http://herschel.vo.elte.hu/Api/Observations

operations

GET http://herschel.vo.elte.hu/Api/Observations?findby=eq&inst={inst}&ra={ra}&dec={dec}&start={start}&end={end}

Finds observations by J2000 equatorial coordinates.

inst: A comma separated list of instrument identifiers.
ra: Right ascension, J2000, degrees.
dec: Declination, J2000, degrees.
start: Start of search interval, fine time.
end: End of search interval, fine time.

GET http://herschel.vo.elte.hu/Api/Observations?findby=intersect&inst={inst}&region={region}&start={start}&end={end}

Finds observations by an intersecting region.

inst: A comma separated list of instrument identifiers.
region: A region description string, see documentation.
start: Start of search interval, fine time.
end: End of search interval, fine time.

GET http://herschel.vo.elte.hu/Api/Observations/{inst}/{obsID}

Returns the details of a single observation by obsID.

inst: An instrument identifier.
obsID: Observation ID.

GET http://herschel.vo.elte.hu/Api/Observations/{inst}/{obsID}/Footprint

Returns the footprint of an observation.

inst: An instrument identifier.
obsID: Observation ID.

GET http://herschel.vo.elte.hu/Api/Observations/{inst}/{obsID}/Footprint/Outline

Returns the outline of the footprint of an observation.

inst: An instrument identifier.
obsID: Observation ID.

GET http://herschel.vo.elte.hu/Api/Observations/{inst}/{obsID}/Footprint/Outline/Points?res={resolution}

Returns the arc endpoints of the outline of the footprint of an observation.

inst: An instrument identifier.
obsID: Observation ID.
resolution: Resolution in arc sec to interpolate small circle arcs

GET http://herschel.vo.elte.hu/Api/Observations/{inst}/{obsID}/Footprint/Outline/Reduced?limit={limit}

Returns the reduced outline of the footprint of an observation.

inst: An instrument identifier.
obsID: Observation ID.
limit: Limit of the reduction algorithm, arc sec.

GET http://herschel.vo.elte.hu/Api/Observations/{inst}/{obsID}/Footprint/Outline/Reduced/Points?res={resolution}&limit={limit}

Returns the arc endpoints of the reduced outline of the footprint of an observation.

inst: An instrument identifier.
obsID: Observation ID.
resolution: Resolution in arc sec to interpolate small circle arcs
limit: Limit of the reduction algorithm, arc sec.

GET http://herschel.vo.elte.hu/Api/Observations/{inst}/{obsID}/Footprint/ConvexHull

Returns the convex hull of the footprint of an observation.

inst: An instrument identifier.
obsID: Observation ID.

GET http://herschel.vo.elte.hu/Api/Observations/{inst}/{obsID}/Footprint/ConvexHull/Outline

Returns the outline of the convex hull of the footprint of an observation.

inst: An instrument identifier.
obsID: Observation ID.

GET http://herschel.vo.elte.hu/Api/Observations/{inst}/{obsID}/Footprint/ConvexHull/Outline/Points?res={resolution}

Returns the arc endpoints of the outline of the convex hull of the footprint of an observation.

inst: An instrument identifier.
obsID: Observation ID.
resolution: Resolution in arc sec to interpolate small circle arcs