public class TLcdCartesianAdvancedBinaryTopology extends Object implements ILcd2DAdvancedBinaryTopology
ILcd2DAdvancedBinaryTopology for 2D Cartesian geometry.
This implementation currently supports instances of the following interfaces:
Geodesic geometry is supported by this implementation. Geodesic lines are treated as straight lines.
The current implementation caches (intermediate) results for ILcdShape instances which implement the ILcdCache interface.
When performing repeated checks with the same shape or shapes, it is generally more efficient to reuse the same ILcd2DAdvancedBinaryTopology object,
instead of creating a new instance for every check.
| Constructor and Description |
|---|
TLcdCartesianAdvancedBinaryTopology()
Default constructor for TLcdCartesianAdvancedBinaryTopology
|
TLcdCartesianAdvancedBinaryTopology(double aTolerance)
Constructor for TLcdCartesianAdvancedBinaryTopology allowing to specify a tolerance.
|
| Modifier and Type | Method and Description |
|---|---|
boolean |
checkTopology(ILcdShape aShape1,
ILcdShape aShape2,
ILcdIntersectionMatrixPattern aMatrixPattern)
Checks whether the two given shapes satisfy the binary topology relation defined by the given
matrix pattern.
|
ILcdIntersectionMatrix |
computeIntersectionMatrix(ILcdShape aShape1,
ILcdShape aShape2)
Computes the intersection matrix of the two given shapes.
|
double |
getTolerance()
Returns the tolerance value used in the binary topology computations when checking the equality
of two points.
|
void |
setTolerance(double aTolerance)
Sets the tolerance value used in the binary topology computations when checking the equality of
two points.
|
public TLcdCartesianAdvancedBinaryTopology()
public TLcdCartesianAdvancedBinaryTopology(double aTolerance)
Constructor for TLcdCartesianAdvancedBinaryTopology allowing to specify a tolerance.
In some cases, the result obtained when checking the topological relation between two shapes depends on the accuracy of the data used to represent both shapes.
For example, you would expect that neighboring countries touch but not overlap. However, if the contours of the polygons used to represent both countries slightly cross at the common border (due to small errors in the data), the calculations would lead to the opposite result.
This constructor allow you to set a tolerance value which is taken into account in the topology calculations. Points that lie within this tolerance value from each other are considered to be coincident.
aTolerance - tolerance value used to determine the equality of two points in the topology
calculations of two shapes. This value is expressed in model coordinate units
of these shapes.public ILcdIntersectionMatrix computeIntersectionMatrix(ILcdShape aShape1, ILcdShape aShape2)
ILcd2DAdvancedBinaryTopologycomputeIntersectionMatrix in interface ILcd2DAdvancedBinaryTopologyaShape1 - the first shapeaShape2 - the second shapepublic boolean checkTopology(ILcdShape aShape1, ILcdShape aShape2, ILcdIntersectionMatrixPattern aMatrixPattern)
ILcd2DAdvancedBinaryTopologycheckTopology in interface ILcd2DAdvancedBinaryTopologyaShape1 - the first shapeaShape2 - the second shapeaMatrixPattern - the matrix pattern defining the binary topology relation to be checkedtrue if the binary topology relation defined by
aMatrixPattern holds true for aShape1 and
aShape2, false otherwise.public double getTolerance()
public void setTolerance(double aTolerance)
aTolerance - the tolerance value used in the binary topology computations.