Package uk.ac.starlink.topcat.plot2
Interface Figure
public interface Figure
Defines an area on the graphics surface, including criteria for
determining whether a given point is or is not included in it.
- Since:
- 15 Feb 2019
- Author:
- Mark Taylor
-
Method Summary
Modifier and TypeMethodDescriptioncreateExpression
(TableCloud cloud) Returns an algebraic (JEL) expression that tests whether a point from a given point cloud is contained within this figure.getAdql()
Returns some ADQL text that represents this figure.getArea()
Returns a drawable shape representing the area defined by this figure on its plotting surface.Returns a generic algebraic (JEL-like) expression for determining inclusion in this figure.Point[]
Returns the array of vertices defining this figure.void
Paints the path defined by this figure's points.
-
Method Details
-
getArea
Area getArea()Returns a drawable shape representing the area defined by this figure on its plotting surface. The shape does not necessarily extend beyond the plot surface's bounding rectangle, even though the figure may encompass a larger area. Null may be returned if this figure does not represent a non-blank area.- Returns:
- figure area, or null
-
paintPath
Paints the path defined by this figure's points. This may or may not be the actual boundary of the enclosed area, but it should convey to the user the choices they have made by selecting the vertices.- Parameters:
g
- destination graphics context
-
getVertices
Point[] getVertices()Returns the array of vertices defining this figure. This may or may not be the same as the array of points that went into defining it, since in some cases some of the points are ignored. These points may be marked visually in some way.- Returns:
- array of significant user-chosen vertices for this figure
-
getExpression
String getExpression()Returns a generic algebraic (JEL-like) expression for determining inclusion in this figure. This should represent symbolic variables (such as X, Y) rather than actually available ones. Null may be returned if this figure does not represent a non-blank area.- Returns:
- boolean JEL inclusion expression, or null
-
createExpression
Returns an algebraic (JEL) expression that tests whether a point from a given point cloud is contained within this figure. Null may be returned if this figure does not represent a non-blank area.- Parameters:
cloud
- the source of the data points- Returns:
- boolean JEL inclusion expression, or null
-
getAdql
String getAdql()Returns some ADQL text that represents this figure. It should be straightforward for the user to adapt the resulting text for use as part of an ADQL query.At present no assumptions are specified about the ADQL version etc, but a widely-applicable dialect (for instance ADQL v2.0 with geometry support) should be used where possible.
- Returns:
- ADQL representation of this figure
-