Running Geotoolkit.org

Geotk requires Java 7. If the coverage or display modules are also used, then Geotk requires also the Java Advanced Imaging library. Note that this library is pre-installed on MacOS X.

While not mandatory, the referencing module works better with a connection to an EPSG database. The database will be created automatically if the sis-epsg.jar file is available on the classpath, together with one of the following dependencies:

  • derby.jar
  • hdsldb.jar

By default, the database is created in a Geotoolkit.org sub-directory in the user application directory. This is always a sub-directory of the user home directory, but the complete path is platform-dependent ("Application Data" on Windows, "Library" on MacOS, the home directory on Linux). The directory can be changed by running the graphical application provided in the geotk-setup module.

The above-cited Setup application can also create the EPSG database on PostgreSQL, using connection parameters which must be explicitly specified.

Maven configuration

Because modules beyond metadata and referencing are not yet deployed on Maven Central, projects need to declare the Geotk repository in order to use them. The example below uses the Coverage I/O services:

<repositories>
  <repository>
    <id>geotoolkit</id>
    <name>Geotoolkit.org repository</name>
    <url>http://maven.geotoolkit.org</url>
  </repository>
</repositories>

<dependencies>
  <dependency>
    <groupId>org.geotoolkit</groupId>
    <artifactId>geotk-coverageio</artifactId>
    <version>4.0-M4</version>
  </dependency>
  <dependency>
    <groupId>org.apache.sis.non-free</groupId>
    <artifactId>sis-epsg</artifactId>
    <version>${sis.version}</version>
    <scope>runtime</scope>
  </dependency>
  <dependency>
    <groupId>org.apache.derby</groupId>
    <artifactId>derby</artifactId>
    <version>10.8.2.2</version>
    <scope>runtime</scope>
  </dependency>
</dependencies>