Thuban - a Geographic Data Viewer
=================================

$Date$
$Revision$

Thuban is an interactive viewer for geographic data. It is written in
Python using the wxWindows toolkit for portability. It runs on Unix-like
systems and on Windows.


About the Name
--------------

Thuban is the name of a star in the constellation Draco (The Dragon).
About 4000 years ago it was the north star.


Requirements
------------

Thuban requires the following software to be installed:

  Python     2.2.1    http://www.python.org
  wxWindows  2.4.0.4  http://www.wxwindows.org
  wxPython   2.4.0.4  http://www.wxpython.org
  proj       4.4.5    http://www.remotesensing.org/proj/
  SQLite     2.8.3    http://www.hwaci.com/sw/sqlite/
  PySQLite   0.4.3    http://pysqlite.sourceforge.net

The versions given are the lowest versions that are known to work. for
proj, sqlite and pysqlite somewhat older versions probably work as well.
Note that the wxPython version must be the same as the wxWindows version
(Some wxPython binary packages already contain the right wxWindows
version)

Optional software:

  GDAL       1.1.8  http://www.remotesensing.org/gdal/
     for raster image (geo-tiff) support

  psycopg    1.0.x  http://initd.org/software/psycopg
     for postgis connections. Newer version probably also work


Installation
------------

Building Thuban (this compiles the extension modules but leaves them in
a directory under build/):

   python setup.py build


To setup Thuban to run directly from the source directory:

   python setup.py install_local

You can run this without running build first.


To install Thuban:

   python setup.py install


for general information about the command line options of the setup.py
script, run

   python setup.py --help


If you build from CVS and want to have translated menus, dialogs etc.
you have to build the message catalogs manually before you run setup.py.
See po/README for more information.


License
-------

Thuban is licensed under the terms of the GNU General Public License
(GPL).

However, some of the extension modules in the extension subdirectory are
licensed under other free licenses. See the respective README files for
more details.