JTS Utility Class
-----------------
The JTS Utility class is used to smooth out some of the common
JTS Geometry activities.
Reference:
* http://docs.geotools.org/stable/javadocs/org/geotools/geometry/jts/JTS.html
* :doc:`/tutorial/geometry/geometrycrs` (tutorial)
Distance
^^^^^^^^
There is a helper method allowing you to calculate the real-world distance between two points:
.. literalinclude:: /../src/main/java/org/geotools/jts/JTSExamples.java
:language: java
:start-after: // orthodromicDistance start
:end-before: // orthodromicDistance end
Internally this method makes use of GeodeticCalculator which offers a more general purpose solution
able to take the distance between any two points (even if they are provided in different
coordiante reference systems).
Transform
^^^^^^^^^
You can make use of *MathTransform** directly - it has methods for feeding **DirectPosition** instances in one at a time, transforming, and returning a modified **DirectPosition**.
The problem is our JTS Geometry instances are built out of **Coordinate** instances rather than using **DirectPosition**.
The **JTS** utility class defines a helper method for this common activity::
import org.geotools.geometry.jts.JTS;
import org.geotools.referencing.CRS;
CoordinateReferenceSystem sourceCRS = CRS.decode("EPSG:4326");
CoordinateReferenceSystem targetCRS = CRS.decode("EPSG:23032");
MathTransform transform = CRS.findMathTransform(sourceCRS, targetCRS);
Geometry targetGeometry = JTS.transform( sourceGeometry, transform);
As a quick example, you can make use of an affine transformation to perform simple transformations such as rotation and scale.::
Coordinate ancorPoint = geometry.getCentroid(); // or some other point
AffineTransform affineTransform = AffineTransform.getRotateInstance(angleRad, ancorPoint.x, ancorPoint.y);
MathTransform mathTransform = new AffineTransform2D(affineTransform);
Geometry rotatedPoint = JTS.transform(geometry, mathTransform);
The same approach works with a JTS Coordinate::
// by default it can make a new Coordinate for the result
Coordinate targetCoordinate = JTS.transform( coordinate, null, transform );
// or make use of an existing destination coordinate (to save memory)
JTS.transform( coordinate, destination, transform );
// or modify a coordinate in place
JTS.transform( coordinate, coordinate, transform );
And also a JTS Envelope, although this case is a bit special in that you get a chance to specify how many points along the edge of the boundary are sampled. If you specify 5, five points along the top, bottom, left and right edges will be transformed - giving you a chance to better account for the curvature of the earth.:
.. literalinclude:: /../src/main/java/org/geotools/api/APIExamples.java
:language: java
:start-after: // transformEnvelope start
:end-before: // transformEnvelope end
Finally the common target of DefaultGeographicCRS.WGS84 is given its own method (to quickly
transform to geographic bounds)::
Envelope geographicBounds = JTS.toGeographic( envelope, dataCRS );
Finally there is a very fast method for performing a transform directly on an array of doubles::
JTS.xform( transform, sourceArray, destinationArray );
Convert
^^^^^^^
There are a number of methods to help convert JTS Geometry to some of the ISO Geometry ideas used
by the referencing module.
Quickly convert from a JTS Envelope to the ISO Geometry Envelope (with a provided CoordinateReferenceSystem)::
Envelope envelope = geometry.getEnvelopeInternal();
// create with supplied crs
Envelope2D bounds = JTS.getEnvelope2D( envelope, crs );
// Check geometry.getUserData() for srsName or CoordinateReferenceSystem
ReferencedEnvelope bounds = JTS.toEnvelope( geometry );
Here are also a large number of methods to help you create a geometry from a range of sources::
// Convert a normal JTS Envelope
Polygon polygon = JTS.toGeometry( envelope );
// The methods take an optional GeometryFactory
Polygon polygon2 = JTS.toGeometry( envelope, geometryFactory );
// Or from ISO Geometry BoundingBox (such as ReferencedEnvelope)
Polygon polygon3 = JTS.toGeometry( bounds );
// Or from a Java2D Shape
Geometry geometry = JTS.toGeometry( shape );
Smooth
^^^^^^
A recent addition is the use of splines to "smooth" a geometry into a single curve that contains
all the points.::
// The amount of smoothing can be set between 0.0 and 1.0
Geometry geometry = JTS.smooth( geometry, 0.4 );