Class IntersectsFunction

All Implemented Interfaces:
ADQLObject, ADQLOperand

public class IntersectsFunction extends GeometryFunction

It represents the INTERSECTS function of the ADQL language.

This numeric function determines if two geometry values overlap. This is most commonly used to express a "shape-vs-shape" intersection test.

Example:
INTERSECTS(CIRCLE('ICRS GEOCENTER', 25.4, -20.0, 1), BOX('ICRS GEOCENTER', 20.0, -15.0, 10, 10)) = 1
In this example the function determines whether the circle of one degree radius centered in a position (25.4, -20.0) degrees and defined according to the ICRS coordinate system with GEOCENTER reference position overlaps with a box of ten degrees centered in a position (20.0, -15.0) in degrees and defined according to the same coordinate system.

Warning:

  • The INTERSECTS function returns 1 (true) if the two arguments overlap and 0 (false) otherwise.
  • Since the two argument geometries may be expressed in different coordinate systems, the function is responsible for converting one (or both). If it can not do so, it SHOULD throw an error message, to be defined by the service making use of ADQL.

Version:
1.4 (06/2015)
Author:
Grégory Mantelet (CDS;ARI)