GeoTools

OSGeo

Table Of Contents

Previous topic

Java2D Shape

Next topic

Repository

This Page

WKT Parser

The gt-main module supports a “well known text” geometry parser that is able to produce ISO 19107 Geometry instances. This page documents the use of the parser, and provides a little bit of background on the state of ISO 19107 support in GeoTools.

ISO 19107 Geometry

The gt-opengis project provides interfaces for ISO Geometry interfaces, we make use of them day in and day out for transforming DirectPositions as described in the referencing module.

ISO 19107 also defines TransfineSet of which GeoTools has two implementations:

  • unsupported/jts-wrapper
  • unsupported/geometry

As indicated by their unsupported status neither has past our QA checks at this time.

  • What about JTS Topology Suite?

    As mentioned in the introduction GeoTools makes use JTS Topology Suite (a representation of the Simple Features for SQL specification) rather than ISO Geometry.

    Although the entire library is not using ISO Geometry yet; this does not prevent you from going there in your own application. Just be sure to include one of the module mentioned above before you start.

  • What is TransfiniteSet

    A TransfiniteSet is the same thing as a JTS Geometry near as I can tell.

    From email - thanks Sunburned Surveyor and Bryce:

    I’m a little confused about the purpose of TransfiniteSet. Either this class is a little too abstract for my purposes or I need more explanation in the Javadoc comments. :]

    I don’t think so. TransfiniteSet is JTS. It just uses some different terminology (from set theory). A circle is what? The set of all points exactly radius “r” from a center point. If you ask circle.contains(pointA), you’ll get a “true” if and only iff “pointA” is exactly circle.radius away from circle.center.

    A curve is the set of all points which lie along the curve. “Is pointA on the curve?” is exactly the same as asking curve.contains(pointA)? Same thing different words.

    19107 was written by math geeks.

ISO Geometry from WKT

  1. Start with a Factory

    The first step to creating a Geometry is to acquire a GeometryFactory:

    GeometryFactory
    CoordinateReferenceSystem crs = CRS.decode("EPSG:4326");
    Precision precision = new PrecisionModel();
    
    GeometryFactory geometryFactory = new GeometryFactoryImpl( crs );

    As you can see in the above example you need to already know your CoordinateReferenceSystem and Precision before creating a GeometryFactory. You can create and use several GeometryFactory instances at the same time if you need to work in several projections.

    There is one problem here - the GeometryFactory is only good for making Geometry. And to make a Geometry you need Coordinates, and primitives and ...

  2. Start with Several Factories

    So I lied to you. You actually need a few more bits of the puzzle before we can accomplish anything.

    GeometryFactory and friends:

    PositionFactory positionFactory = new PositionFactoryImpl(...);
    CoordinateFactory coordinateFactory = new CoordinateFactoryImpl(...);
    PrimitiveFactory primitiveFactory = new PrimitiveFactoryImpl(...);
    ComplexFactory complexFactory = new ComplexFactoryImpl(...);
    AggregateFactory aggregtateFactory = new AggregateFactoryImpl(...);
    
    WKTParser parser = new WKTParser( geometryFactory, primitiveFactory, positionFactory, aggregateFactory);
    
    Point point = (Point) parser.parse( "POINT (80 340)" );
  1. But wait!

    • Where do all these Impls come from?
    • What do they take as parameters?
    • eek!

    The answer is that the factory situation is starting to get so complex that we need to use a good tool to sort it out.

  2. Use a Good Tool to Sort out the Factories

    Using a container such as a PicoContainer, we can teach it about all the factories and dependencies and it will figure out what to use when you create a factory.:

    PicoContainer and dependencies...
    // create pico container
    DefaultPicoContainer container = new DefaultPicoContainer();
    
    // Teach Container about Factory Implementations we want to use
    container.registerComponentImplementation(PositionFactoryImpl.class);
    container.registerComponentImplementation(FeatGeomFactoryImpl.class);
    container.registerComponentImplementation(AggregateFactoryImpl.class);
    container.registerComponentImplementation(ComplexFactoryImpl.class);
    container.registerComponentImplementation(GeometryFactoryImpl.class);
    container.registerComponentImplementation(PrimitiveFactoryImpl.class);
    
    // Teach Container about other dependencies needed
    CoordinateReferenceSystem crs = DefaultGeographicCRS.WGS84;
    container.registerComponentInstance( crs );
    Precision pr = new PrecisionModel();
    container.registerComponentInstance( pr );
    
    // Now we can ask for factories and the container will figure out what dependencies that factory needs and do the work for you
    PositionFactoryImpl pf = (PositionFactoryImpl ) container.getComponentInstanceOfType( PositionFactory.class );
    
    // create something with the factory
    DirectPosition dp = pf.createDirectPosition(new double[]{280,560});
  3. Well Known Text Geometry Parser

    The SFSQL specification defines a Well Known Text (WKT) format for representing the kind of simple (Point, Line, Polygon) geometry constructs covered by the simple feature for SQL specification.

    We have a parser that will use a GeometryFactory to produce the ISO Geometry constructs for you. It will also parse some extra geometry types.

    WKT ISO Geometry
    POINT org.opengis.geometry.primitive.Point
    LINESTRING org.opengis.geometry.primitive.Curve
    LINEARRING org.opengis.geometry.primitive.Curve
    POLYGON org.opengis.geometry.primitive.Surface
    MULTIPOINT org.opengis.geometry.coordinate.aggregate.MultiPoint
    MULTILINESTRING org.opengis.geometry.aggregate.MultiPrimitive
    MULTIPOLYGON org.opengis.geometry.aggregate.MultiPrimitive
    GEOMETRYCOLLECTION org.opengis.geometry.aggregate.MultiPrimitive