Package uk.ac.starlink.ttools.func
Class Coverage
- java.lang.Object
-
- uk.ac.starlink.ttools.func.Coverage
-
public class Coverage extends java.lang.Object
Functions related to coverage and footprints.One coverage standard is Multi-Order Coverage maps, described at http://www.ivoa.net/Documents/MOC/. MOC positions are always defined in ICRS equatorial coordinates.
MOC locations may be given as either the filename or the URL of a MOC FITS file. Alternatively, they may be the identifier of a VizieR table, for instance "
V/139/sdss9
" (SDSS DR9). A list of all the MOCs available from VizieR can currently be found at http://alasky.u-strasbg.fr/footprints/tables/vizier/. You can search for VizieR table identifiers from the VizieR web page (http://vizier.u-strasbg.fr/); note you must use the table identifier (like "V/139/sdss9
") and not the catalogue identifier (like "V/139
").- Since:
- 29 May 2012
- Author:
- Mark Taylor
-
-
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method Description static boolean
inMoc(java.lang.String mocLocation, double ra, double dec)
Indicates whether a given sky position falls strictly within a given MOC (Multi-Order Coverage map).static boolean
nearMoc(java.lang.String mocLocation, double ra, double dec, double distanceDeg)
Indicates whether a given sky position either falls within, or is within a certain distance of the edge of, a given MOC (Multi-Order Coverage map).
-
-
-
Method Detail
-
inMoc
public static boolean inMoc(java.lang.String mocLocation, double ra, double dec)
Indicates whether a given sky position falls strictly within a given MOC (Multi-Order Coverage map). If the givenmocLocation
value does not represent a MOC (for instance no file exists or the file is not in MOC format) a warning will be issued the first time it's referenced, and the result will be false.- Parameters:
mocLocation
- location of a FITS MOC file: a filename, a URL, or a VizieR table namera
- ICRS right ascension in degreesdec
- ICRS declination in degrees- Returns:
- true iff the given position falls within the given MOC
-
nearMoc
public static boolean nearMoc(java.lang.String mocLocation, double ra, double dec, double distanceDeg)
Indicates whether a given sky position either falls within, or is within a certain distance of the edge of, a given MOC (Multi-Order Coverage map). If the givenmocLocation
value does not represent a MOC (for instance no file exists or the file is not in MOC format) a warning will be issued the first time it's referenced, and the result will be false.- Parameters:
mocLocation
- location of a FITS MOC file: a filename, a URL, or a VizieR table namera
- ICRS right ascension in degreesdec
- ICRS declination in degreesdistanceDeg
- permitted distance from MOC boundary in degrees- Returns:
- true iff the given position is within
distance
degrees of the given MOC
-
-