Status of GeoTools

2

About your Presenters
Andrea Aime Jody Garnett
(PMC) (PMC)

GeoSolutions LISAsoft
GeoServer/GeoTools core A great system integration
developers, raster data company helping our
management, map rendering, customers make effective use
spatial data processing of open source spatial.

3

About your Presenters
Justin Deolivera Jody Garnett
(PMC) (PMC)

OpenGeo LISAsoft
Bringing the best open source A great system integration
geospatial software to company helping our
organisations around the customers make effective use
world. of open source spatial.

4

GeoTools - the Java GIS Toolkit

5

Development Community
261 Andrea Aime (GeoServer, JAITools) - GeoSolutions
261 Jody Garnett (GeoTools, uDig) - Lisasoft
167 Simone Giannecchini (GeoServer, JAITools) - GeoSolutions
123 Justin Deoliveira (GeoServer, GeoScript) - OpenGeo
114 Michael Bedward (JAITools) - Australia
66 danieleromagnoli (GeoServer) - GeoSolutions
54 bencaradocdavies - CSIRO
51 NielsCharlier - CSIRO
38 sbrunner ? 2010 Stats tracking commits
32 moovida (uDig, JGrass) - Hydrologis
28 ang05a - CSIRO
25 groldan - (GeoServer) - OpenGeo
17 mpazos - Axios
30 committers
15 victortey - CSIRO
13 mcr - ?
10 organisations
9 kengu - Norwegian Uni of Tech & Science
8 ischneider - OpenGeo
7 ianturton - University of Leeds Healthy project with a broad base of support
7 jesseeichar - CampToCamp
7 lmoran - Consultant actively improving GeoTools
6 afabiani - GeoSolutions
6 rbraam - ?
4 xiangtanlin - ?
3 LeeBreisacher - ?
3 lendholt - ?
2 alfonx (AtlasStyler) - WikiSquare
2 pieterdg - ?
2 tdipisa - GeoSolutions
1 atrofast - Ingres
1 mleslie - Lisasoft

6

Stats

geotools-devel:
386 members total

geotools-gt2-users:
889 members total

Created vs resolved tickets (click here for update )

8

GeoTools 8
What is in a Name?
- sed/GeoTools 2.8.0/GeoTools 8.0/

What does this mean?
- not very much - business as usual
- confidence in our community
- continue our commitment to stability
- evolution handled with continuous small changes

Documentation

(what I did last summer)

12

Code Examples - Before (Wiki)
private synchronized static FeatureSource
buildMemoryFeatureSource(FeatureCollection coll, String typename,
FeatureType currentFeatureType, AttributeType newTypes[]){

FeatureType ftState=null;
MemoryDataStore MStore=null;
try {
MStore = new MemoryDataStore();
//---- current attributes
AttributeType currentTypes[] = currentFeatureType.getAttributeTypes();

//---- new array of attributes = current array+ new attributes
Compile?
AttributeType typesNew[] = new What Version?
AttributeType[currentTypes.length+newTypes.length];
When?
for(int i=0;i<currentTypes.length;i++){
typesNew[i] = currentTypes[i];
}
for(int i=0;i<newTypes.length;i++){
All very good
}
typesNew[currentTypes.length+i] = newTypes[i]; questions with no clear
answer.
ftState = FeatureTypeFactory.newFeatureType(typesNew, typename);
MStore.createSchema(ftState);

Iterator iterator = coll.iterator();
FeatureCollection newColl = FeatureCollections.newCollection();
Feature feature, newFeature;
Object[] objs;
try {
for( int count=0; iterator.hasNext(); count++) {
feature = (Feature) iterator.next();

13

Code Examples - After (Sphinx)
private synchronized static FeatureSource
buildMemoryFeatureSource(FeatureCollection coll, String typename,
FeatureType currentFeatureType, AttributeType newTypes[]){

FeatureType ftState=null;
MemoryDataStore MStore=null;
try {
MStore = new MemoryDataStore();
//---- current attributes
AttributeType currentTypes[] = currentFeatureType.getAttributeTypes();

//---- new array of attributes = current array+ new attributes
AttributeType typesNew[] = new
Pulled Live from
AttributeType[currentTypes.length+newTypes.length]; Source!
for(int i=0;i<currentTypes.length;i++){
typesNew[i] = currentTypes[i];
} GeoTools Version at
for(int i=0;i<newTypes.length;i++){
typesNew[currentTypes.length+i] = newTypes[i];
the Top of the Page!
}

ftState = FeatureTypeFactory.newFeatureType(typesNew, typename);
MStore.createSchema(ftState);

Iterator iterator = coll.iterator();
FeatureCollection newColl = FeatureCollections.newCollection();
Feature feature, newFeature;
Object[] objs;
try {
for( int count=0; iterator.hasNext(); count++) {
feature = (Feature) iterator.next();

13

Code Examples - After (Sphinx)
SimpleFeatureSource alter(SimpleFeatureCollection collection, String typename,
 SimpleFeatureType featureType, final List<AttributeDescriptor> newTypes) {

 try {

 // Create target schema
 SimpleFeatureTypeBuilder buildType = new SimpleFeatureTypeBuilder();
 buildType.init(featureType);
 buildType.setName(typename);
 buildType.addAll(newTypes);

 final SimpleFeatureType schema = buildType.buildFeatureType();
 // Configure memory datastore
 final MemoryDataStore memory = new MemoryDataStore();
Pulled Live from
 memory.createSchema(schema);

Source!
 collection.accepts(new FeatureVisitor() {
 public void visit(Feature feature) {
 SimpleFeatureBuilder builder = new SimpleFeatureBuilder(schema);

GeoTools Version at
 builder.init((SimpleFeature) feature); the Top of the Page!
 for (AttributeDescriptor descriptor : newTypes) {
 builder.add(DataUtilities.defaultValue(descriptor));
 }

 SimpleFeature newFeature = builder.buildFeature(feature.getIdentifier().getID());
 memory.addFeature(newFeature);
 }
 }, null);

 return memory.getFeatureSource(typename);

 } catch (Exception e) {
 e.printStackTrace();
 }

14

Code Examples - Example

Used for both Java
code examples and
also configuration files
such as maven
pom.xml.

15

Diagrams - Before (Visio)

16

Diagrams - After (Inkscape)

18

Class Diagrams - After (Object Aid)

Advanced Tutorials

Function
Finally a nice quick guide to how to create a function!

AbstractDataStore Tutorial - Property DataStore
The classic updated for GeoTools 8.

ContentDataStore Tutorial - CSVDataStore
The new kid on the block; leaner; meaner and ready.

Welcome
Introduction for different developer communities.

Update
Have not used GeoTools in a while? Guide to updating.

25

Documentation Highlights
Details
- 291 “Pages”
- longest page is 36 pages printed out on paper
- Over 100,000 words
- Written from Feb through to May
- Accounts for every page of the wiki

New features
- Extensive FAQ
- whole project javadocs
- module by module reference
- plugins organised by module

Referencing

(do you know where your data is?)

27

Referencing
• Ellipsoids, datum, map projections
• Embedded EPSG database, over 5000 supported codes
(gt-epsg-hsql module)
• Reprojection utilities
Geometry g = ...;
CoordinateReferenceSystem wgs84 = CRS.decode("EPSG:4326");

CoordinateReferenceSystem utm32n = CRS.decode("EPSG:32632");
Geometry gtx = JTS.transform(g);
...
SimpleFetureCollection fc = featureSource.getFeature();
SimpleFeatureCollection fcTx =
new ReprojectingFeatureCollection(fc, utm32n);

28

Projections
Old projections New Projections

Aitoff
Albers Equal A.
Mollweide
CassiniSoldner
Cylindrical Equidist. Robinson
Krovak
Lambert Conf.
Mercator
Oblique Mercator Eckert IV

Orthogonal
Polyconic
Winkel Tripel
Stereographic
Transverse Mercator
Equidistant conic

Vector Plugins
Both direction and magnitude!

30

Vector Data Sources
• Application schema* • JDBC
• ArcSDE o DB2
• Aggregating * o H2 spatial
• CouchDb * o MySQL
• CSV * o Postgis
• DXF * o Oracle
• Excel o SQL Server
• Edigeo o Spatialite *
• PreGeneralized o Teradata *
• SimpleFeatureService *
• Shapefile (directory of)
• WFS

name* = new entry
name = “unsupported”

31

JDBC DataStore "NG"
• JDBC stores:
– common base
– over 200 ready to use tests,
just prepare the test data and
run
– Parametric SQL views: define
a new data source as a raw
query
select ST_Union(the_geom) as geom
from countries
where REGION = %region%
– Extensions for native joins

32

Application schema
– Complex feature support
– Recent development by CSIRO
– Feature chaining, polymorphism
– Better performance (native DBMS joins), memory use
– Usable as vector data source, GML encoding,
rendering

Raster Formats

pixel power

34

Raster Data Sources
• ArcGrid • imageio-ext based
• ArcSDE o AIG
• GeoTiff o DTED
• GRASS * o ECW
• GTopo30 o EnviHdr
• Image Mosaic o ErdasImg
• Image Mosaic JDBC * o EsriHdr
• Image Pyramid o JP2 (ECW, MrSid)
• Image + World file o MrSID
• JP2 direct Kakadu o NITF*
• Matlab o RPFTOC
• Non georef. Image collection *

name * = new entry
name = unsupported land

Rendering

Gotta see it to believe it

39

Layers
• FeatureLayer:
any vector + Style
(shapefile, spatial db, WFS, ...)

• GridCoverageLayer:
in memory raster grid

• GridReaderLayer:
dynamic raster read from disk
(leverage overviews and tiling)

• WMSLayer:
get maps from a WMS server

• DirectLayer: (new feature!)
roll your own custom paint method

40

StyleBuilder
• Style API is inspired by SLD 1.0 and SE 1.1:
– a style is a complex, deep object graph
• StyleBuilder provides a set of hierarchical
builders
• Build a style easily, just pick the portion you need

Style style = new StrokeBuilder().color(Color.BLUE)
.width(3).dashArray(5, 2)
.buildStyle();

41

StyleBuilder
• StyleBuilder allows you to freely mix CQL
expressions
• Provides “literate” methods allowing you to
define your style using your IDE autocomplete

fts = new FeatureTypeStyleBuilder();
fts.rule().filter("pop < 200000")
.polygon().fill().colorHex("#66FF66");
fts.rule().filter("pop between 200000 and 500000")
.polygon().fill().colorHex("#33CC33");
fts.rule().filter("pop > 500000")
.polygon().fill().colorHex("#009900");
Style style = fts.buildStyle();

42

Showing the Map Part 1
• To start we get the data and create a Style

FileDataStore store = FileDataStoreFinder.getDataStore(file);
SimpleFeatureSource featureSource = store.getFeatureSource();

Style style = SLD.createSimpleStyle(featureSource.getSchema());

43

Showing the Map Part 2
• Create Map and use JMapFrame to display
MapContent map = new MapContent();
map.setTitle("Quickstart");
Layer layer = new FeatureLayer(featureSource, style);
map.addLayer(layer);

JMapFrame.showMap(map);

44

Pluggable Mark Factory TTF

<WellKnownName>ttf://Wingdings#0xF054</WellKnownName>
<Fill>
<CssParameter name="fill">#000088</CssParameter>
</Fill>

45

Pluggable Mark Factory Slash
<Fill>
 <GraphicFill>
 <Graphic>
 
 <WellKnownName>shape://slash</WellKnownName>
 <Stroke>
 <CssParameter name="stroke">0xAAAAAA</CssParameter>
 </Stroke>
 
 <Size>16</Size>
 </Graphic>
</GraphicFill>
</Fill>

46

Pluggable Mark Factories Interface
public interface MarkFactory {
public java.awt.Shape getShape(
Graphics2D graphics,
Expression symbolUrl,
Feature feature) throws Exception;
}

org.geotools.renderer.style.WellKnownMarkFactory
org.geotools.renderer.style.TTFMarkFactory
org.geotools.renderer.style.ShapeMarkFactory

http://docs.geotools.org/latest/userguide/library/render/icon.html

47

Geometry transform Arrow Head
Similar to SE 1.1 transformations, but open-ended, pluggable, add your own
transformation today!
<PointSymbolizer>
 <Geometry>
 <ogc:Function name="endPoint">
 <ogc:PropertyName>the_geom</ogc:PropertyName>
 </ogc:Function>
 </Geometry>
 <Graphic>
 
 <WellKnownName>shape://arrow</WellKnownName>
 <Fill/>
 <Stroke/>
 
 <Rotation>
 <ogc:Function name="endAngle">
 </ogc:Function>
 </Rotation>
 </Graphic>
</PointSymbolizer>

48

Geometry transform Drop Shadow
<Geometry>
 <ogc:Function name="offset">
 <ogc:Literal>0.00004</ogc:Literal>
 <ogc:Literal>‐0.00004</ogc:Literal>
</ogc:Function>
<Geometry>

Geometry transform Implementation
Based on functions, a pluggable extension point
public class FilterFunction_offset extends FunctionExpressionImpl
                                   implements GeometryTransformation {
...
public Object evaluate(Object feature) {
        Geometry geom = getExpression(0).evaluate(feature, Geometry.class);
        Double offsetX = getExpression(1).evaluate(feature, Double.class);
        if(offsetX == null) offsetX = 0d;
        Double offsetY = getExpression(2).evaluate(feature, Double.class);
        if(offsetY == null) offsetY = 0d;

        if (geom != null) {
            Geometry offseted = (Geometry) geom.clone();
            offseted.apply(
               new OffsetOrdinateFilter(offsetX, offsetY));
            return offseted;
        } else {
            return null;
        }
    }
...
}

50

Rendering Transform Wind Map
<FeatureTypeStyle>
 <Transformation>
 <ogc:Function name="gs:RasterAsPointCollection">
 <ogc:Function name="parameter">
 <ogc:Literal>data</ogc:Literal> u v
 </ogc:Function>
 </ogc:Function>
</Transformation> ...

Transform data before rendering. Contour extraction, wind
maps, geometry clustering. Pluggable, add your function!

Rendering Transform Contour Extract
<FeatureTypeStyle>
 <Transformation>
 <ogc:Function name="gs:Contour">
 <ogc:Literal>data</ogc:Literal>
 </ogc:Function>
 <ogc:Literal>levels</ogc:Literal>
 <ogc:Literal>1100</ogc:Literal>
 <ogc:Literal>1200</ogc:Literal> ....
 </ogc:Function>
 </ogc:Function>
</Transformation>

XML

(what could be as fun as rendering?
not xml)

XML

Technology sax dom encode Supports
GeoTools SAX SAX DOM Filter, GML, SLD

GeoTools DOM DOM Filter, GML, SLD

GeoTools Transform XML Filter, GML, SLD

JAXB SAX DOM n/a

XDO SAX DOM XML Filter, GML, SLD, WMS, WFS1.0, XSD
(Schema Assisted
Generation 1)

GTXML SAX DOM XML Filter, GML, SLD, WMS, WFS1.0, WFS 1.1, WPS, XSD,
(Schema Assisted and more...
Generation 2)

54

Schema Assisted Parsing
GeoTools Specific Technology; makes use of the schema
information to minimise the code you need to write.
You teach GeoTools how to “bind” a object once; and it will
work in any schema that uses those objects.

55

Schema Assisted Encoding
The same approach is used when encoding objects;
basically using the schema as a cheat sheet to sort out what
to emit next.

Extensions
high value functionality built on top of GeoTools

57

Brewer
Wraps up the ColorBrewer for Java Developers; generating
a normal Style you can use in GeoTools; or export to other
applications.

FeatureTypeStyle style = StyleGenerator.createFeatureTypeStyle(
            groups,
            ff.propertName(“population”),
            colors,
            "Generated Style",
            schema.getGeometryDescriptor(),
            StyleGenerator.ELSEMODE_IGNORE,
            0.95,
            stroke);

58

Graph
Because getting there is half the fun.
BasicLineGraphGenerator graphGen = new BasicLineGraphGenerator();
for ( MultiLineString line : lines ) {
  graphGen.add( line );
}
Graph graph = graphGen.getGraph();

EdgeWeigter weighter = new EdgeWeighter() {
   public double getWeight(Edge e) {
      SimpleFeature feature = (SimpleFeature) e.getObject();
      Geometry geometry = (Geometry) feature.getDefaultGeometry();
      return gometry.getLength();
   }
};

DijkstraShortestPathFinder pf =
new DijkstraShortestPathFinder( graph, start, weighter );
pf.calculate();
Path path = pf.getPath( destination );

Process

Close to graduating
(Maybe at the Code Sprint?)

Process

Annotation Based
No more filling in massive data structures; GeoTools will
generate based on annotations against a static method.

Bridge Functions and Process
Used for rendering transformations; allowing you much
greater control of geometry prior to display.

Massive influx of High Quality Processes
The full range of processes defined by GeoServer have
been back ported resulting in some of the best examples of
how to use GeoTools.

WPS Client
Still unsupported ... nothing to see here

61

Process Annotation Example
Tutorial Coming soon!
@DescribeProcess(title = "Buffer", description = "Buffers a geometry using distance")
@DescribeResult(description = "The buffered geometry")
static public Geometry buffer(
    @DescribeParameter(name = "geom", description = "The geometry to be buffered")
    Geometry geom,
    @DescribeParameter(name = "distance",
                        description = "The distance (same unit of measure as the geometry)")
    double distance) {
        return geom.buffer(distance);
}

Application Schema
Graduated this year!

63

Application Schema
AuScope has completed their work on Application Schema.
This is an interesting module that is able to take information
from several DataStores and "map" the values into the
correct shape for publication against an application schema.

This is used when the data format used cannot be generated
and must exactly match that provided by a standards body
or expert community.

Thanks to Ben and the AuScope team for their dedication on
this very challenging problem.

Teradata DataStore

Created and Graduated this year!

65

Terradata DataStore
A great bit of work from Jesse Eichar from Camptocamp.

This module went from a unsupported module through to
supported status in record time - excellent work Jesse!

EFeature
Mapping between Eclipse Modelling Framework
and GeoTools Feature Model.

67

EFeature
• Kenneth Gulbrandsoy has been an amazingly
active addition to the GeoTools community.
Kenneth is a PHD student from Norwegian
University of Technology and Science.
• EFeature datastore allows teams to leverage
their Java objects into the GeoTools dynamic
feature system
• Adding Spatial capabilities to EMF models
– 98% finished
– Goal is to make it a supported plugin in GeoTools
– Docs are comming soon

Grass Raster reader
Created and Graduated this year!

69

Grass Raster Reader
Andrea Antonello has pulled together support for the
GRASS raster format and donated it to the GeoTools library
(going through the effort to match our quality assurance and
documentation standards).

Temporal
Merged into gt-main as core feature

71

Temporal
The temporal module has provided an enhanced range of
time and time range operations.
Justin has gathered this up into the gt-main module as one
of the cornerstones for WFS 2.0 Filter support.

after = ff.after(ff.property("date"),ff.literal(temporalInstant));

within = ff.toverlaps( ff.property("constructed_date"),
ff.literal(period));

Query Improvements
What is Justin up to?

73

Query Improvements
Join
Justin has sorted out how Joins will be represented - finally!
Function
Between Jody and Justin Functions now have excellent runtime
documentation. Arguments are now listed by name; with specific
type information.
Filter Evaluation over a Collection
Niels (AuScope) has sorted out this one allowing you to control
how many matches are required (one, any, all) when comparing
groups of values.
Temporal
As mentioned temporal filter support has been added; seriously
increasing the number of operations available.

Swing and SWT
(Getting your GUI on)

75

Swing
The much loved gt-swing module has been used for years
to make the GeoTools tutorials visual. At long last, it is
looking to graduate to supported status.

Michael Bedward has been a
star contributor this year
cleaning up the code base,
making it testable, all the
while answering questions
on the email list.

76

Swing
• Major clean up of the internals!
• JMapPane rewritten
– Ported to Layer, FeatureLayer, RasterLayer etc...
– DirectLayer support for Animation / map decorations
– Nice clean background rendering
• Ability to add new InfoTool classes via plugin
• Support for Internationalisation
• Supported Status?
– Docs and Test Coverage improving by the day

• Coming Soon: Concurrent rendering

77

SWT
A new addition to the project is a port of the gt-swing code to
an easy to use component for SWT.

Andrea Antonello (HydroloGIS) was responsible for this work
and it looks like gt-swing and gt-swt will be able to share the
same data models as time progresses.

What is Past?
Reflections on departed modules

79

Recently Dropped
JDBCDataStore
The initial proof of concept JDBC datastore created in 2003 has
finally been replaced. We had a good 2 year deprecation cycle to
allow migration.
GeoAPI
The "opengis" interfaces have been folded back into the library
allowing us to take responsibility, improve javadocs and dive into
filter improvements for WFS 2.0 work.
Assorted Spring Cleaning
Simone was kind enough to clean out orphaned and empty
modules from out "unsupported" pile.

What is Next?
Ideas on the future of GeoTools

81

Future Plans
Geometry Curves and 3D
Tisham Dhar (CSIRO) is evaluating several alternatives.
GeoTools has components of ISO 19107 provided by
SYS Technologies and the of University Fachhochschule
Koeln.
WFS 2.0 Query
Justin DeOlivera (OpenGeo) is in the middle of a
major update to DataStore query functionality

82

Future RnD Ideas
OSGi Bundles
Branch started to explore this topic with contributors from several
projects.
Android
Jody had a chance to look at what it would take to port GoeTools
to Andriod. If you are interested in doing the work talk to us at the
Code Sprint.
3D
A number of teams hook GeoTools to 3D engines each year.
Indeed Oliver Gottwald plans to do so this year; anyone want to
do it as part of the community?
MIL2525B
Another classic we revisit each year - any takers?

Upstream Projects
Thanks! We don't Do this alone

84

Upstream Projects
JTS Topology Suite (JTS)
Provides the excellent Geometry support we enjoy in
GeoTools. Thanks Martin!
imageio-ext
Provides geospatial raster formats to the Java Advanced
Imaging project we use for coverages. Thanks Simone and
GeoSolutions.
jaitools
Another extension to Java Advanced Imaging this time
thanks to Michael Bedward. Really fun for processing and
generating rasters.

Open Development
Is so much more than open source

Get Involved - Open Development
GeoTools provides clear “time boxed” procedures allowing you
to plan your community involvement.

Contribute
Clean patch + test + description = contribution

Request for Change
Open RFC procedure, time boxed allowing commit
three days after submitting (we have to meet deadlines as
well).

Release
Public release process - make a release to match your
projects schedule and deadlines.

Procedures are in place just add developers (or money).

Get Involved - Unsupported Area
Unsupported is a scratch pad used to work on new ideas.

Easy Commit Access
Send email and read the developers guide; a PMC member
will help you with the paper work.

Unsupported does not mean unloved
You get commit access to your module, and your work
deployed to maven nightly, and published each release.

Formal review only when Ready
Ask for a QA / Docs check at any time and graduate to a
formal supported part of the library.

State of GeoTools

Any Questions? Any time?

Status of GeoTools

Empfohlen

Empfohlen

Weitere ähnliche Inhalte

Mehr von Jody Garnett

Mehr von Jody Garnett (20)

Kürzlich hochgeladen

Kürzlich hochgeladen (20)

Status of GeoTools

Hinweis der Redaktion