GeoTools @RELEASE@

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

This release contains only a subset of the current GeoTools code base. The full GeoTools code base contains additional unsupported modules covering experiments with a range of additional data formats. Only the modules which are considered to be stable have been included in this release.

For more information, and documentation on the GeoTools library please see the GeoTools User Guide.

The user guide includes the following tutorials to introduce you to GeoTools development:

Welcome to GeoTools development!


For full details on requirements and build process please see the Developers' Guide (the following is provided as a quick reference only).


To use the GeoTools libraries you will need:

GeoTools will benefit from the inclusion of Java Advanced Imaging (JAI) and the Java Image IO (JIO) extensions in your JRE. In addition some formats require the ImageIO-Ext additions which explicitly support raster formats such as MRSID and ECW. Detailed instructions on configuring your JDK with these optional extensions can be found in our developers guide here.

Oracle (Optional)

In order to use the gt-oracle or gt-jdbc-oracle modules, 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:

Please see the developers guide for detailed instructions.

Building (Optional)

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.2.1 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 (Recommended)

The gt2-users mailing list is provided for general inquiries, with additional support options are available in the user guide.

If you are interested in the future development of GeoTools then feel free to join the geotools-devel mailing list. We welcome contributions of new modules as well as keen developers who want to work on the project as a whole.

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

Good luck and many thanks for your interest in GeoTools,

The GeoTools Project Management Committee, Open Source Geospatial Foundation