=================================================
Welcome to Apache SIS <http://incubator.apache.org/sis/>
=================================================

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

Apache SIS is an effort undergoing incubation at The Apache Software Foundation (ASF), 
sponsored by the Apache Incubator PMC. Incubation is required of all newly accepted 
projects until a further review indicates that the infrastructure, communications, 
and decision making process have stabilized in a manner consistent with other successful 
ASF projects. While incubation status is not necessarily a reflection of the completeness 
or stability of the code, it does indicate that the project has yet to be fully endorsed 
by the ASF.

SIS is a project of the Apache Software Foundation <http://www.apache.org/>.

Apache SIS, SIS, Apache, the Apache feather logo, and the Apache SIS
project logo are trademarks of The Apache Software Foundation.

Getting Started
===============

SIS is based on Java 5 and uses the Maven 2 <http://maven.apache.org/>
build system. To build SIS, use the following command in this directory:

    mvn clean install


Tomcat Server (See much simpler Jetty integration below)
===============
The build consists of a number of components, including a web-based application
file (WAR) you can use to try out SISfeatures. You can run it on top of Apache Tomcat like this:

    /usr/local/tomcat/bin/shutdown.sh
    mkdir /usr/local/sis
    cd /usr/local/sis
    cp -R /path/to/apache-sis-X.Y-src/sis-webapp/target/sis-webapp-X.Y.war ./
    cp -R /path/to/apache-sis-X.Y-src/sis-webapp/src/main/webapp/META-INF/context.xml ./sis.xml
    edit sis.xml (set the docBase to /usr/local/sis/sis-webapp-X.Y.war and the property 
          org.apache.sis.services.config.filePath to /usr/local/sis/sis-location-config.xml, 
          org.apache.sis.services.config.qIndexPath to /usr/local/sis/qtree, 
          org.apache.sis.services.config.geodataPath to /usr/local/sis/geodata)
    cp -R /path/to/apache-sis-X.Y-src/sis-webapp/src/main/resources/sis-location-config.xml ./
    edit 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/bin/startup.sh
    Visit http://localhost:8080/sis/demo.jsp and checkout the demo!    
    Try some queries:
    
    Bounding Box:
      0, 50, 50, 100
      
    Point Radius:
      0, 80, 400km
   
Jetty Server
===============
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
	
Visit http://localhost:8080/sis-webapp/demp.jsp and run the same queries as noted above.

    Bounding Box:
      0, 50, 50, 100
      
    Point Raidus:
      0, 80, 400km

License (see also LICENSE.txt)
==============================

Collective work: Copyright 2010 The Apache Software Foundation.

Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements.  See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License.  You may obtain a copy of the License at

     http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Apache SIS includes a number of subcomponents with separate copyright
notices and license terms. Your use of these subcomponents is subject to
the terms and conditions of the licenses listed in the LICENSE.txt file.


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

Notification on all code changes are sent to the following mailing list:

    sis-commits@incubator.apache.org

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@...).
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 new feature, please visit the SIS issue tracker at
https://issues.apache.org/jira/browse/SIS There you can also find the
latest information on known issues and recent bug fixes and enhancements.