1 |
|
|
2 |
Thuban - a geographic data viewer |
Thuban - a Geographic Data Viewer |
3 |
================================= |
================================= |
4 |
|
|
5 |
Thuban is an interactive viewer for geographic data. It is written in |
$Date$ |
6 |
Python using the wxWindows toolkit for portability. It runs on Unix-like |
$Revision$ |
|
systems and on Windows. |
|
7 |
|
|
8 |
|
Thuban is an interactive viewer for geographic data. |
9 |
|
Python and the wxWidgets framework ensure great portability. |
10 |
|
Thuban is Free Software and runs on GNU/Linux, Windows |
11 |
|
and several other operating systems. |
12 |
|
|
13 |
|
Homepage: https://thuban.intevation.org |
14 |
|
Development infrastructure: https://wald.intevation.org/projects/thuban/ |
15 |
|
|
16 |
About the Name |
About the Name |
17 |
-------------- |
-------------- |
20 |
About 4000 years ago it was the north star. |
About 4000 years ago it was the north star. |
21 |
|
|
22 |
|
|
23 |
|
Requirements |
24 |
|
------------ |
25 |
|
|
26 |
|
Thuban requires the following software to be installed: |
27 |
|
|
28 |
|
Python 2.2.1 http://www.python.org |
29 |
|
wxWidgets 2.6.3.2 http://www.wxwidgets.org (formerly known as wxWindows) |
30 |
|
wxPython 2.6.3.2 http://www.wxpython.org |
31 |
|
proj 4.4.5 http://www.remotesensing.org/proj/ |
32 |
|
SQLite 2.8.3 http://sqlite.org/ |
33 |
|
PySQLite 0.4.3 http://pysqlite.org/ |
34 |
|
|
35 |
|
The versions given are the lowest versions that are known to work. for |
36 |
|
proj, sqlite and pysqlite somewhat older versions probably work as well. |
37 |
|
Note that the wxPython version must be the same as the wxWidgets version |
38 |
|
(Some wxPython binary packages already contain the right wxWidgets version) |
39 |
|
|
40 |
|
Optional software: |
41 |
|
|
42 |
|
GDAL 1.3.2 http://www.remotesensing.org/gdal/ |
43 |
|
for raster image (geo-tiff) support |
44 |
|
|
45 |
|
psycopg 1.0.x http://initd.org/software/psycopg |
46 |
|
for postgis connections. Newer version probably also work |
47 |
|
|
48 |
|
RXP 1.2.x http://www.cogsci.ed.ac.uk/~richard/rxp.html |
49 |
|
usually comes directly with pyRXP. |
50 |
|
pyRXP 0.9 http://www.reportlab.org/pyrxp.html |
51 |
|
only for the automatic tests to validate Thuban's XML files. |
52 |
|
|
53 |
|
|
54 |
Installation |
Installation |
55 |
------------ |
------------ |
56 |
|
|
57 |
Building Thuban: |
Building Thuban (this compiles the extension modules but leaves them in |
58 |
|
a directory under build/): |
59 |
|
|
60 |
python setup.py build |
python setup.py build |
61 |
|
|
78 |
python setup.py --help |
python setup.py --help |
79 |
|
|
80 |
|
|
81 |
|
If you build from SVN and want to have translated menus, dialogs etc. |
82 |
|
you have to build the message catalogs manually before you run setup.py. |
83 |
|
See po/README for more information. |
84 |
|
|
85 |
|
|
86 |
|
Build Troubleshooting |
87 |
|
--------------------- |
88 |
|
|
89 |
|
When building Thuban, you might have problems because of a missing file |
90 |
|
wx/wxPython/wxPython.h. This file is part of wxPython and may be |
91 |
|
packaged in a separate package. Unfortunately, on some systems this |
92 |
|
file is not packaged at all. On those systems you can try a work-around |
93 |
|
built into Thuban, by passing the --use-wx-python-swig-hack to the |
94 |
|
build_ext command. This can be done on the command line for the build |
95 |
|
command like this: |
96 |
|
|
97 |
|
python setup.py build_ext --use-wx-python-swig-hack build |
98 |
|
|
99 |
|
You can also use it with the install_local command: |
100 |
|
|
101 |
|
python setup.py build_ext --use-wx-python-swig-hack install_local |
102 |
|
|
103 |
|
Note, that this work-around relies on some wxPython internals and may |
104 |
|
cease to work at some point. We tested it with wxPython 2.6. |
105 |
|
|
106 |
|
|
107 |
License |
License |
108 |
------- |
------- |
109 |
|
|
110 |
Thuban is licensed under the terms of the GNU General Public License |
Thuban is licensed under the terms of the |
111 |
(GPL). |
GNU General Public License (GPL) version 2 or later. |
|
|
|
112 |
|
|
113 |
|
However, some of the extension modules in the extension subdirectory are |
114 |
|
licensed under other Free Software licenses. |
115 |
|
See the respective README files for details. |