public class PolygonFunction extends GeometryFunction
It represents the POLYGON function of the ADQL language.
This function expresses a region on the sky with sides denoted by great circles passing through specified coordinates. It corresponds semantically to the STC Polygon region. The arguments specify the coordinate system and three or more sets of 2-D coordinates.
The polygon is a list of vertices in a single coordinate system, with each vertex connected to the next along a great circle and the last vertex implicitly connected to the first vertex.
Example:
POLYGON('ICRS GEOCENTER', 10.0, -10.5, 20.0, 20.5, 30.0, 30.5)
In this example the function expresses a triangle, whose vertices are (10.0, -10.5), (20.0, 20.5) and (30.0, 30.5) in degrees
according to the STC coordinate system with GEOCENTER reference position.
GeometryFunction.GeometryValue<F extends GeometryFunction>
ADQLFunction.ParameterIterator
Modifier and Type | Field and Description |
---|---|
protected java.util.Vector<ADQLOperand> |
coordinates
The coordinates of vertices.
|
coordSys
Constructor and Description |
---|
PolygonFunction(ADQLOperand coordSystem,
ADQLOperand[] coords)
Builds a polygon function with at least 3 2-D coordinates (that is to say, the array must contain at least 6 operands).
|
PolygonFunction(ADQLOperand coordSystem,
java.util.Collection<? extends ADQLOperand> coords)
Builds a polygon function with at least 3 2-D coordinates (that is to say, the vector must contain at least 6 operands).
|
PolygonFunction(PolygonFunction toCopy)
Builds a POLYGON function by copying the given one.
|
Modifier and Type | Method and Description |
---|---|
ADQLObject |
getCopy()
Gets a (deep) copy of this ADQL object.
|
java.lang.String |
getName()
Gets the name of this object in ADQL.
|
int |
getNbParameters()
Gets the number of parameters this function has.
|
ADQLOperand |
getParameter(int index)
Gets the index-th parameter.
|
ADQLOperand[] |
getParameters()
Gets the list of all parameters of this function.
|
boolean |
isGeometry()
Tell whether this operand is a geometrical region or not.
|
boolean |
isNumeric()
Tell whether this operand is numeric or not.
|
boolean |
isString()
Tell whether this operand is a string or not.
|
ADQLOperand |
setParameter(int index,
ADQLOperand replacer)
Replaces the index-th parameter by the given one.
|
getCoordinateSystem, setCoordinateSystem
adqlIterator, getPosition, paramIterator, setPosition, toADQL
protected java.util.Vector<ADQLOperand> coordinates
public PolygonFunction(ADQLOperand coordSystem, ADQLOperand[] coords) throws java.lang.UnsupportedOperationException, java.lang.NullPointerException, java.lang.Exception
coordSystem
- A string operand which corresponds to a valid coordinate system.coords
- An array of at least 3 2-D coordinates (length>=6).java.lang.UnsupportedOperationException
- If this function is not associated with a coordinate system.java.lang.NullPointerException
- If one of the parameters is null.java.lang.Exception
- If there is another error.public PolygonFunction(ADQLOperand coordSystem, java.util.Collection<? extends ADQLOperand> coords) throws java.lang.UnsupportedOperationException, java.lang.NullPointerException, java.lang.Exception
coordSystem
- A string operand which corresponds to a valid coordinate system.coords
- A vector of at least 3 2-D coordinates (size()>=6).java.lang.UnsupportedOperationException
- If this function is not associated with a coordinate system.java.lang.NullPointerException
- If one of the parameters is null.java.lang.Exception
- If there is another error.public PolygonFunction(PolygonFunction toCopy) throws java.lang.Exception
toCopy
- The POLYGON function to copy.java.lang.Exception
- If there is an error during the copy.public ADQLObject getCopy() throws java.lang.Exception
ADQLObject
java.lang.Exception
- If there is any error during the copy.public java.lang.String getName()
ADQLObject
public boolean isNumeric()
ADQLOperand
public boolean isString()
ADQLOperand
public boolean isGeometry()
ADQLOperand
public ADQLOperand[] getParameters()
ADQLFunction
getParameters
in class ADQLFunction
public int getNbParameters()
ADQLFunction
getNbParameters
in class ADQLFunction
public ADQLOperand getParameter(int index) throws java.lang.ArrayIndexOutOfBoundsException
ADQLFunction
getParameter
in class ADQLFunction
index
- Parameter number.java.lang.ArrayIndexOutOfBoundsException
- If the index is incorrect (index < 0 || index >= getNbParameters()).public ADQLOperand setParameter(int index, ADQLOperand replacer) throws java.lang.ArrayIndexOutOfBoundsException, java.lang.NullPointerException, java.lang.Exception
ADQLFunction
setParameter
in class ADQLFunction
index
- Index of the parameter to replace.replacer
- The replacer.java.lang.ArrayIndexOutOfBoundsException
- If the index is incorrect (index < 0 || index >= getNbParameters()).java.lang.NullPointerException
- If a required parameter must be replaced by a NULL object.java.lang.Exception
- If another error occurs.