Package uk.ac.starlink.ttools.cone
Class UrlMocCoverage
java.lang.Object
uk.ac.starlink.ttools.cone.MocCoverage
uk.ac.starlink.ttools.cone.UrlMocCoverage
- All Implemented Interfaces:
Coverage
MOC coverage implementation which reads a MOC from a given URL.
MOCs are cached by URL, so the same one won't be read twice.
Note: MOCs are cached indefinitely per service, beware that this constitutes a potential memory leak. Some smarter caching scheme may be introduced if this causes problems.
- Since:
- 9 Jun 2014
- Author:
- Mark Taylor
-
Nested Class Summary
Nested classes/interfaces inherited from interface uk.ac.starlink.ttools.cone.Coverage
Coverage.Amount
-
Field Summary
Fields -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionprotected cds.moc.HealpixMoc
Constructs the MOC which will define this object's coverage.static cds.moc.HealpixImpl
Returns the HEALPix implementation used for MOC service queries.static UrlMocCoverage
getServiceMoc
(URL serviceUrl, int nside) Returns an instance which gives coverage for a data service with a given access URL.static UrlMocCoverage
getVizierMoc
(String vizierId, int nside) Returns an instance which gives coverage for a named Vizier table.static void
setDefaultHealpixImpl
(cds.moc.HealpixImpl hpi) Sets the HEALPix implementation used for MOC service queries.Methods inherited from class uk.ac.starlink.ttools.cone.MocCoverage
discOverlaps, getAmount, getMoc, initCoverage
-
Field Details
-
FOOT_SERVICE_URL
Footprint service base URL provided by CDS.- See Also:
-
-
Constructor Details
-
UrlMocCoverage
Constructor.- Parameters:
mocUrl
- URL of MOC file
-
-
Method Details
-
createMoc
Description copied from class:MocCoverage
Constructs the MOC which will define this object's coverage. This method, which may be time-consuming, will be called a maximum of once by theMocCoverage.initCoverage()
method ofMocCoverage
, and should not be called by anyone else.- Specified by:
createMoc
in classMocCoverage
- Returns:
- new MOC defining footprint
- Throws:
IOException
-
getServiceMoc
Returns an instance which gives coverage for a data service with a given access URL. This queries the CDS service for MOCs, which at time of writing has information for all the various VizieR cone search services, plus a few other registered cone search services (UKIDSS etc).- Parameters:
serviceUrl
- URL of cone search servicenside
- requiested HEALPix nside for MOC, or -1 for default
-
getVizierMoc
Returns an instance which gives coverage for a named Vizier table. The name may be a vizier table name (like "V/139/sdss9") or alias as used by the CDS Xmatch service (like "SDSS DR9").- Parameters:
vizierId
- vizier table name or aliasnside
- requiested HEALPix nside for MOC, or -1 for default
-
getDefaultHealpixImpl
public static cds.moc.HealpixImpl getDefaultHealpixImpl()Returns the HEALPix implementation used for MOC service queries.- Returns:
- indexing implementation
-
setDefaultHealpixImpl
public static void setDefaultHealpixImpl(cds.moc.HealpixImpl hpi) Sets the HEALPix implementation used for MOC service queries.- Parameters:
hpi
- indexing implementation
-