JTS Warped

What is JTS Warped?

JTS Warped is a small group of classes designed to complement the Java Topology Suite (JTS). The main feature of this first release of JTS Warped is the source code in the net.surveyos.sourceforge.jtswarped.angles package. This package contains code that adds basic angle and direction functionality to JTS. It would be useful for things like calculating view sheds, processing terrestrial/conventional surveying data, and creating parallel lines. The code in this package can be combined with the classes in net.surveyos.sourceforge.jtswarped.coordinategeometry package to allow JTS to be used as a fully-functional coordinate geometry package.

What are the goals of JTS Warped?

The primary goal of JTS is to add the ability to work with angles and directions (bearings and azimuths) to JTS. A secondary goal of the library is to provide a home for other code related to JTS, but not included in the main JTS library. I hope to include things like CoordinateFilter implementations, SpatialIndex implementations, and code that allows construction/manipulations of spatial relationships in future releases of JTS Warped.

Why is it important?

There are no existing open source Java libraries that allow for the creation and manipulation of angles and directions, an important component of traditional surveying measurements, and the integration of angles and directions with traditional two-dimensional plane geometry. JTS is a great Java programming library for two-dimensional plane geometry, and JTS Warped will hopefully make it even better. It will also allow OpenJUMP to more easily work with angle and directions via user-developed plug-ins.

Source Code

You can view the JTS Warped source code here: http://surveyos.svn.sourceforge.net/viewvc/surveyos/java/main/jts_warped/

The same source code is accessible from the SurveyOS Project SVN reposiitory at SourceForge:

You can download a zip file of the current release’s source code here:


The Javadoc API documentation for JTS Warped is here:


There is an article in Volume 10 of the OSGeo Journal on JTS Warped here: