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 Type	Method and Description
String	createExpression(TableCloud cloud) Returns an algebraic (JEL) expression that tests whether a point from a given point cloud is contained within this figure.
String	getAdql() Returns some ADQL text that represents this figure.
Area	getArea() Returns a drawable shape representing the area defined by this figure on its plotting surface.
String	getExpression() Returns a generic algebraic (JEL-like) expression for determining inclusion in this figure.
Point[]	getVertices() Returns the array of vertices defining this figure.
void	paintPath(Graphics2D g) Paints the path defined by this figure's points.

Method Detail

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

void paintPath(Graphics2D g)

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

String createExpression(TableCloud cloud)

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