Page History

Introduction

Apache SIS(TM) is a spatial framework that enables better representation of representation of coordinates for searching, data clustering, archiving, or any other relevant other relevant spatial needs.

Downloading SIS

The project home page is http://incubatorsis.apache.org/sis^{Image Removed}

http://incubator.apache.org/sis/download.html^{Image Removed}

apache-sis-src.tar.gz

Building SIS

.

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 'Download apache-sis-src.tar.gz zip' archive and run the following command commands to unpack it to a local folder, for example as follows:

tar xzvf apache-sis-src.tar.gz -C mkdir /usr/local/src
mkdir /usr/local/src/sis-site
unzip apache-sis-src.zip

You can also check out the source latest code from the SIS Subversion repository as follows:

...

. See http://

...

sis.apache.org/

...

source.html.

SIS is based on Java 5 6 and uses the Maven 2 <http://maven.apache.org/> build system. To build SIS, use the following command in the top source directory: Apache Maven (version 3) build system. Once you have obtained the source files, to build SIS, run the following command from within the top source directory (e.g. /usr/local/src/sis):

    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
file (WAR) that you can use to try out SIS features. You can run it on top of Apache Tomcat like this:. 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:

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.

Shut down Tomcat if it's already running:

$TOMCAT_HOME/bin/shutdown.sh

...

Copy the SIS web application from the SIS build directory to the Tomcat web applications directory. The SIS web application can be found in the 'sis-webapp/target' directory within your SIS source directory. The web applications directory for Tomcat 7 is by default '$TOMCAT_HOME/webapps'. For example, the following command will copy the SIS web application directory to the Tomcat webapps directory and rename it to 'sis'.

cp -R /usr/local/src/sis-site/sis-webapp/target/sis-webapp

...

 /$TOMCAT_HOME/webapps/sis

Create the following directories to store data returned from SIS queries. These can be created anywhere you like. The example below creates them within the SIS webapp directory:

mkdir $TOMCAT_HOME/webapps/sis/qtree
mkdir $TOMCAT_HOME/webapps/sis/geodata

Edit the '$TOMCAT_HOME/webapps/sis/WEB-INF/web.xml' file and add references to your data directories as follows:

<context-param>
  <param-name>org.apache.sis.services.config.qIndexPath</param-name>
  <param-value>/$TOMCAT_HOME/webapps/sis/qtree</param-value>
</context-param>

<context-param>
  <param-name>org.apache.sis.services.config.

...

geodataPath</param-name>
  <param-value>/$TOMCAT_HOME/webapps/sis/geodata</param-value>
</context-param>

Modify the parameter for 'sis-location-config.xml,
org.apache.sis.services.config.qIndexPath to /usr/local/sis/qtree,
orgfilePath' to point to the location of your 'sis-location-config.xml' file. By default, this is located in the 'WEB-INF/classes' directory of the SIS web application:

<context-param>
  <param-name>org.apache.sis.services.config.

...

filePath</param-name>
  <param-value>/$TOMCAT_HOME/webapps/sis/WEB-INF/classes/sis-location-config.xml</param-value>
</context-param>

You can use the 'geodata)
cp -R /path/to/apache-sis-X.Y-src/sis-webapp/src/main/resources/sis-location-config.xml ./
edit ' file to configure the RSS feeds that SIS will process. Feeds can be added by inserting their URLs into the 'sis-location-config.xml (add or delete GeoRSS URLs)
ln -s /usr/local/sis/sis.xml /usr/local/tomcat/conf/Catalina/localhost/sis.xml
/usr/local/tomcat/' file between <url> ... </url> tags, as in the following example:

<url>http://earthquake.usgs.gov/earthquakes/catalogs/shakerss.xml</url>

After making the above changes to the SIS web application configuration files, restart Tomcat with the following command:

$TOMCAT_HOME/bin/startup.sh

Running on Jetty

Jetty is now supported too (as of 02/11/2012). Simply build the project at the root level

mvn clean install

Then browse to the sis-webapp directory. To run the built-in Jetty server, type the command:

mvn jetty:run

Demonstration

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 Visit http://localhost:8080/sis/demo.jsp and checkout the demo!
Try some queries:

Bounding Box:
0, 50, 50, 100

.

On loading the page, you should see the Apache SIS logo, a simple form and a map. Use the form to enter some queries and return results from RSS feeds to SIS on the map. Below are two example queries to try:

Bounding Box:

Lower Left: Latitude: 0, Longitude: 50
Upper Right: Latitude: 50, Longitude: 100

Point Radius:

Latitude: 0
Longitude: 80
Radius: 400km

...

Mailing Lists

Discussion about SIS takes place on the following mailing lists:

• sis-user@incubator.apache.org - about using SIS
• sis-dev@incubator.apache.org - about developing SIS

...

• sis-commits@incubator.apache.org - notifications on all code changes for SIS

The mailing lists are open to anyone and publicly archived.

You can subscribe the mailing lists by sending a message to sis-<LIST>subscribe@incubator.apache.org (for example sis-user-subscribe@incubator.apache.org).  To unsubscribe, send a message to sis<LIST>unsubscribe@incubator.apache.org.  For more instructions, send a message to sis<LIST>-help@incubator.apache.org.

Issue Tracker

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