Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Introduction

Apache SIS is a spatial framework that enables better representation of coordinates for searching, data clustering, archiving, or any other relevant spatial needs. The project home page is http://sis.apache.org.

This page describe the steps for running the 'webapp' module, which still in early draft. This page does not describe other modules like coordinate by referencing, metadata, NetCDF or Shapefile storage.

Downloading & Building SIS

The latest released source code can be obtained by visiting the downloads page. You can download the 'apache-sis-src.zip' archive and run the following commands to unpack it to a local folder, for example as follows:

...

Code Block
mvn clean install

Eclipse or NetBeans Integration

See http://sis.apache.org/source.html#ide.

Running The SIS Web Application

The build consists of a number of components, including a web-based application that you can use to try out SIS features. Below are some instructions on how to set up the web application on various different servers.

Running on Jetty

Jetty is now supported as of 11th February 2012. After building SIS, navigate to the sis-webapp directory. To run the built-in Jetty server, run the following command:

Code Block
mvn jetty:run

Running on Tomcat

There are several different versions of Apache Tomcat available, each with different requirements for installing web applications. For more details, please refer to the documentation for the specific version of Tomcat that you're running. Below is a set of instructions for a very simple installation on Tomcat 7. In the following examples, please replace $TOMCAT_HOME with the location of your Tomcat 7 installation.

...

Code Block
$TOMCAT_HOME/bin/startup.sh

Demonstration

A demonstration is included with the SIS webapp. The 'demo.jsp' file can be found in the sis-webapp top level folder. It can be accessed via a web browser by navigating to http:////demo.jsp, where <host> is the address of your chosen server and <webapp> is the name of the top level SIS webapp directory, for example http://localhost:8080/sis/demo.jsp.

...

Code Block
Point Radius:

Latitude: 0
Longitude: 80
Radius: 400km

Mailing Lists

Discussion about SIS takes place on the following mailing lists:

...

The mailing lists are open to anyone and publicly archived.

Issue Tracker

If you encounter errors in SIS or want to suggest an improvement or a new feature, please visit the SIS issue tracker. There you can also find the latest information on known issues and recent bug fixes and enhancements.