Installation¶
Todo
this chapter should be completely rewritten
Expected contents:
Supported platforms (with details on platforms actually used for testing).
Requirements (update the Requirements section of README.txt and add more details).
for each platform: * summarize installation modes: binary, all’in one binary, source * for each installation mode:
- actual requirements
- download links (??)
- installation procedure
- note
Introduction¶
GSDView (Geo-Spatial Data Viewer) is a lightweight viewer for geo-spatial data and products. It is written in python and Qt4 and it is mainly intended to be a graphical front-end for the GDAL library and tools. GSDView is modular and has a simple plug-in architecture.
At the moment GSDView is at a very early development stage.
Requirements¶
In order to run GSDView you should have the following software installed:
- Python 2.5 or higher
- PyQt 4.5.2 or higher
- numpy 1.2.1 or higher
- gdal 1.5.4 or higher
- scipy 0.6.0 or higher
- Enthought Traits and TraitsBackendQt 3.1.0 ot higher
- Enthought Enable 3.1.0 ot higher (QA plugin)
- Enthought Chaco 3.1.0 ot higher (QA plugin)
- PyQwt 5.1.0 or higher (recommended)
Hint
Ubuntu and Debian users can resolve almost all dependencies by running the following command as superuser:
#
# apt-get python-qt4 python-qwt5-qt4 python-gdal gdal-bin python-numpy python-scipy
#
On Debian Sid Traits library is also packaged now:
#
# apt-get python-traitsbackendqt python-traitsgui python-traits python-chaco
#
Installation¶
Decompress the distribution package:
$ tar xvfz gsdview-X.YY.tar.gz
From the package directory run the following command as superuser:
# python setup.py install
You can also install GSDView in a custom location:
# python setup.py install --prefix=<PATH_TO_INSTALL_DIR>
Of course in this case you have to update the the PATH and PYTHONPATH environment variables in order to include the install locations.
How to run GSDView¶
The command for starting GSDView is:
$ gsdviewer
If you have all dependencies installed you can also run GSDView without installation by simply running the following command in the package root:
$ python gsdviewer
WindowsTM users can run GSDView without installation by double-clicking on gsdviewer.pyw file. If it doesn’t exist you can get it by making a copy of the gsdviewer file and renaming it gsdviewer.pyw.
