GeoTools 2.5-M0

Thank you for downloading GeoTools @VERSION@. This release was created on: @DATE@

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
main
metadata
pom.xml
referencing
render
sample-data
xml

The following modules comprise the plug-ins,extensions, and demos:
arcgrid           
arcsde           
db2             
epsg-access      
epsg-extension    
epsg-hsql
epsg-postgresql
epsg-wkt
geometry
geotiff
gtopo30
image
imagemosaic
imagepyramid
pom.xml
postgis
referencing3D
shapefile
wfs
wms
brewer
graph
openoffice
pom.xml
shapefile-renderer
validation
widgets-swing
coverage
data
example
introduction
libraryJTS
mappane
pom.xml
property
referencing
svgsupport
xml-po

The following modules comprise the unsupported modules:

coverageio
coverageio-hdf
coverageio-netcdf
directory
epsg-oracle
gml
gml3
go
gpx
jts-wrapper
mappane
mif
mysql
ndplugin
notifying-collections
ogr
oracle-spatial
pom.xml
postgis-versioned
tiger
tile
vpf
xml-filter
xml-gml2
xml-gml3
xml-gpx
xml-sld
xml-xsd

These optional jars typically provide support for specific data formats or sources, or provide specific additional functionality.

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

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.5 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