Class 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).
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • 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 given mocLocation 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 name
        ra - ICRS right ascension in degrees
        dec - 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 given mocLocation 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 name
        ra - ICRS right ascension in degrees
        dec - ICRS declination in degrees
        distanceDeg - permitted distance from MOC boundary in degrees
        Returns:
        true iff the given position is within distance degrees of the given MOC