Module:

Geometry

Module Maintainer:

Graham Davis, Sanjay Dominik Jena

Status:

(star)(star)(star)(star)(red star)

Email Help:

Geotools-gt2-users@lists.sourceforge.net

Volunteer:

geotools-devel@lists.sourceforge.net

IP Review:

review.txt

The Geometry module provides an implementation of OGC Feature Geometry Abstract Specification (ISO 19107) (a.k.a. Topic 1 - Feature Geometry).

Description

This project is:

For more information on this module please contact:

Gold Star Quality Assurance Check

(star) IP Check: review.txt added, all headers are in place
(star) Releasable: no blocking issues, etc..
(star) Quality Assurance: 50.1% test coverage reported by clover
(star) Stability: No planned API changes
(red star) Supported: Documentation available, module maintainer watches user list, answers email.

Module Goals

This implementation is a project of Prof. Dr. Jackson Roehrig and Sanjay Dominik Jena of the University of Applied Sciences Cologne, Germany (Fachhochschule Köln).

We are implementing the Geometry of the ISO19107 with the following goals and limitations:

As there aren´t existing too many approaches for a 19107 GeoAPI implementation yet, this implementation will serve as a test of the capability of the GeoAPI (in fact for TC211 too, since GeoAPI is partially derived from the TC211 specs) as well. Thus, we will report a list of suggestions to GeoAPI / GeoTools in order to contribute a part to the improvement of the GeoAPI by "Best Practise".

Project Reports

Project reports:

Future

Adrian Custer is looking into the larger problems of making ISO19107 Geometry implementation that can respond to the CoordianteReferenceSystem definition by delegating to a range of operations. This module uses linear solutions (ie 2D space) for operations such as buffer and intersects; when working with geometries defined by great circles on a sphere a different implementation should be used.

In more simple terms; we need to have a double dispatch using both Geometry and CRS in order to determine the correct operation to execute.

For more information:

IP Review

IP review is underway - known issue:

Module Status

This module is now supported, user documentation is available here: Geometry Plugin.

Outstanding Issues

Issues pertaining to GeoTools Geometry implementations:

Potentially relevant issues pertaining to the GeoAPI interfaces implemented by this code:

Testing and Conformance

The JTS XML tests have been imported, and a test suite has been created to run them. The following is the current status of which tests pass/fail and their associated bugs:

Status

XML File

Failing Tests

Related Bug

(tick)

LineTests.xml

0/5

 

(tick)

PolygonTests.xml

0/6

 

(tick)

PolygonWithHoleTests.xml

0/6

 

(tick)

SimplePolygonTest.xml

0/6

 

(tick)

TestBoundary.xml

0/12

 

(tick)

TestCentroid.xml

0/19

 

(tick)

TestConvexHull-big.xml

0/1

 

(tick)

TestConvexHull.xml

0/12

 

(tick)

TestDisjoint.xml

0/7

 

(tick)

TestFunctionAA.xml

0/48

 

(tick)

TestFunctionAAPrec.xml

0/77

 

(tick)

TestFunctionLA.xml

0/36

 

(tick)

TestFunctionLAPrec.xml

0/6

 

(tick)

TestFunctionLL.xml

0/39

 

(tick)

TestFunctionLLPrec.xml

0/2

 

(tick)

TestFunctionPA.xml

0/13

 

(tick)

TestFunctionPL.xml

0/27

 

(tick)

TestFunctionPLPrec.xml

0/1

 

(tick)

TestFunctionPP.xml

0/37

 

(tick)

TestInteriorPoint.xml

0/7

 

(tick)

TestRectanglePredicate.xml

0/23

 

(tick)

TestRelateAA-big.xml

0/2

 

(tick)

TestRelateAA.xml

0/107

 

(tick)

TestRelateAA_general.xml

0/12

 

(tick)

TestRelateAC.xml

0/1

 

(tick)

TestRelateAC_general.xml

0/1

 

(tick)

TestRelateLA.xml

0/77

 

(tick)

TestRelateLA_general.xml

0/11

 

(tick)

TestRelateLC.xml

0/4

 

(tick)

TestRelateLC_general.xml

0/4

 

(tick)

TestRelateLL.xml

0/144

 

(tick)

TestRelateLL_general.xml

0/20

 

(tick)

TestRelatePA.xml

0/42

 

(tick)

TestRelatePA_general.xml

0/6

 

(tick)

TestRelatePL.xml

0/98

 

(tick)

TestRelatePL_general.xml

0/8

 

(tick)

TestRelatePP.xml

0/13

 

(tick)

TestRelatePP_general.xml

0/4

 

(tick)

TestWithinDistance.xml

0/22

 

 

Totals:

0/966