GeoScript

Table Of Contents

This Page

Developing with GeoScript

This section describes how to set up a GeoScript development environment.

Install Jython

Jython version 2.5.1 or greater is required for GeoScript.

  • Install Jython

    For the remainder of the document the Jython installation root will be referred to as JYTHON_HOME.

Install setuptools

  1. Downlaod ez_setup.py

  2. Execute ez_setup.py with the jython command:

    $ <JYTHON_HOME>/bin/jython ez_setup.py
    
Upon success <JYTYON_HOME>/bin/easy_install will be created.

Install virtualenv

Note

Creating a virtualenv for GeoScript is not neccessary but is highly recomended.

  1. Using easy_install installed in the previous section easy install the virtualenv library:

    $ <JYTHON_HOME>/bin/easy_install virtualenv
    
  2. Create a new virtualenv named geoscript:

    $ <JYTHON_HOME>/bin/virtualenv geoscript
    
  3. Activate the geoscript virtualenv:

    $ source geoscript/bin/activate
    

Obtain Source Code

The GeoScript sources are stored in a git repository hosted at github.

  1. Install git

  2. Clone the geoscript git repository:

    (geoscript)$ git clone git://github.com/jdeolive/geoscript-py.git
    

Obtain GeoTools Libraries

GeoScript requires the GeoTools libraries to function. There are a number of ways to obtain them.

Maven

If `Apache Maven <>`_ is installed on the system execute the following command from the root of the local git repository:

$ mvn install

Upon success the required GeoTools libraries will be located in the jars directory.

Ant

If `Apache Ant <>`_ is installed on the system execute the ant comand from the root of the local git repository:

$ ant

Upon success the required GeoTools libraries will be located in the jars directory.

Download

If neither of the above methods are appealing:

  1. Download the latest GeoTools 2.6 release
  2. Unpack the zip archive
  3. Copy geotools-2.6.?/*.jar into the jars directory

Setup the CLASSPATH

Once the GeoTools libraries are located in the jars directory source the classpath file located in the root the local git repository:

$ source classpath

Install nose

Running GeoScript unit tests requires the nose library.

  • Easy install nose:

    (geoscript)$ easy_install nose
    

Install sphinx

Writing GeoScript documentation requires the sphinx library.

  • Easy install sphinx:

    (geoscript)$ easy_install sphinx