GeoTools 2.5-RC1

Thank you for downloading GeoTools 2.5-RC1. This release was created on: August 22nd, 2008

This release contains only a subset of the current GeoTools codebase. The full GeoTools codebase is made up of over 30 modules; Only the modules which are considered to be stable will be included in this release.

For this release the following modules comprise the geotools library:


api
coverage
cql
data
jdbc
legacy
main
metadata
referencing
render
sample-data
xml

The following modules plug-ins that add functionality to the geotools library:

 arcgrid
 arcsde
 db2
 epsg-access
 epsg-extension
 epsg-hsql
 epsg-postgresql
 epsg-wkt
 geotiff
 gtopo30
 image
 imagemosaic
 imagepyramid
 pom.xml
 postgis
 property
 referencing3D
 shapefile
 wfs
 wms
These optional jars typically provide support for specific data formats or sources, or provide specific additional functionality.

The following modules are extensions that build interesting functionality ontop of the geotools library:

brewer
graph
openoffice
shapefile-renderer
validation
widgets-swing
xsd

The following modules are unsupported experiments made available for early feedback and testing:

caching
community-schemas
coverageio
coverageio-hdf
coverageio-netcdf
coveragetools
directory
epsg-oracle
example
geomedia
geometry
geometryless
gml
gml3
gpx
h2
hsql
imageio-ext-gdal
imagemosaic-jdbc
jts-wrapper
mappane
mif
mysql
notifying-collections
ogc
ogr
oracle-spatial
postgis-versioned
process
repository
sql-datastore
temporal
tiger
tile
vpf
widgets-swing-pending
wps
xml-gpx

For more information, and documentation on the geotools library please see our Community Wiki or the User Guide.

The following demos are also available as part of our documentation:
coverage-use
example
introduction
libraryJTS
mappane-use
referencing
svgsupport
xml-po

You can find out more about each of the major modules by going to:

NOTE

The details contained in the rest of this file are provided as a quick start reference. For full details on requirements and build process please see the Developers' Guide.

REQUIREMENTS

To use the geotools libraries you will need:

The JAI and the JAI I/O Tools are standard extensions to Java created by SUN. They have versions specific to different platforms so we cannot distribute them as part of the release.

You can obtain the latest versions of both of these here. Detailed instructions can be found here.

ORACLE REQUIREMENTS

In order to use the Oracle module, you need the Oracle JDBC driver from Oracle. Unlike most external libraries used in GeoTools, we cannot redistribute this jar.

However, you can obtain them from the Oracle website, free of charge, after registering: - http://otn.oracle.com/software/tech/java/sqlj_jdbc/content.html Please see the developers guide for more information.

BUILDING

In order to build GeoTools you will need a copy of Maven 2. Maven is a project management tool from the Apache group.

At the time of writing, the build process was known to work with the Maven 2.0.8 release.

Once you have maven installed, you can perform a full build by moving to the geotools folder and typing:

mvn install

Please read the Developers Guide for more information about maven:

GETTING INVOLVED

If you are interested in the future development of GeoTools then feel free to join the geotools-devel mailing list and join in the weekly IRC sessions.

We welcome contributions of new modules as well as keen developers who want to work on the project as a whole.

For more general queries, the gt2-users mailing list is available.

You can find out more about the mailing lists and recent news by going to the GeoTools Homepage and by reading the GeoTools Guide.

Good luck and many thanks for your interest in GeoTools,

The GeoTools Project Management Committee, Open Source Geospatial Foundation