/[thuban]/branches/WIP-pyshapelib-bramz/README
ViewVC logotype

Diff of /branches/WIP-pyshapelib-bramz/README

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 2 by bh, Fri Aug 17 12:15:16 2001 UTC revision 2695 by bernhard, Fri Sep 15 14:09:17 2006 UTC
# Line 1  Line 1 
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$
7  systems and on Windows.  
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    
14  About the Name  About the Name
# Line 14  Thuban is the name of a star in the cons Line 18  Thuban is the name of a star in the cons
18  About 4000 years ago it was the north star.  About 4000 years ago it was the north star.
19    
20    
21    Requirements
22    ------------
23    
24    Thuban requires the following software to be installed:
25    
26      Python     2.2.1    http://www.python.org
27      wxWidgets  2.4.0.4  http://www.wxwidgets.org (formerly known as wxWindows)
28      wxPython   2.4.0.4  http://www.wxpython.org
29      proj       4.4.5    http://www.remotesensing.org/proj/
30      SQLite     2.8.3    http://sqlite.org/
31      PySQLite   0.4.3    http://pysqlite.org/
32    
33    The versions given are the lowest versions that are known to work. for
34    proj, sqlite and pysqlite somewhat older versions probably work as well.
35    Note that the wxPython version must be the same as the wxWidgets version
36    (Some wxPython binary packages already contain the right wxWidgets version)
37    
38    Optional software:
39    
40      GDAL       1.2.5  http://www.remotesensing.org/gdal/
41         for raster image (geo-tiff) support
42    
43      psycopg    1.0.x  http://initd.org/software/psycopg
44         for postgis connections. Newer version probably also work
45    
46      RXP        1.2.x  http://www.cogsci.ed.ac.uk/~richard/rxp.html
47         usually comes directly with pyRXP.
48      pyRXP      0.9    http://www.reportlab.org/pyrxp.html
49         only for the automatic tests to validate Thuban's XML files.
50    
51    
52  Installation  Installation
53  ------------  ------------
54    
55  Building Thuban:  Building Thuban (this compiles the extension modules but leaves them in
56    a directory under build/):
57    
58     python setup.py build     python setup.py build
59    
# Line 40  script, run Line 76  script, run
76     python setup.py --help     python setup.py --help
77    
78    
79    If you build from CVS and want to have translated menus, dialogs etc.
80    you have to build the message catalogs manually before you run setup.py.
81    See po/README for more information.
82    
83    
84    Build Troubleshooting
85    ---------------------
86    
87    When building Thuban, you might have problems because of a missing file
88    wx/wxPython/wxPython.h.  This file is part of wxPython and may be
89    packaged in a separate package.  Unfortunately, on some systems this
90    file is not packaged at all.  On those systems you can try a work-around
91    built into Thuban, by passing the --use-wx-python-swig-hack to the
92    build_ext command.  This can be done on the command line for the build
93    command like this:
94    
95       python setup.py  build_ext --use-wx-python-swig-hack  build
96    
97    You can also use it with the install_local command:
98    
99       python setup.py  build_ext --use-wx-python-swig-hack  install_local
100    
101    Note, that this work-around relies on some wxPython internals and may
102    cease to work at some point.  We tested it with wxPython 2.4 and
103    wxPython 2.5.
104    
105    
106  License  License
107  -------  -------
108    
109  Thuban is licensed under the terms of the GNU General Public License  Thuban is licensed under the terms of the GNU General Public License (GPL).
 (GPL).  
   
110    
111    However, some of the extension modules in the extension subdirectory are
112    licensed under other Free Software licenses.
113    See the respective README files for details.
Legend:
Removed from v.2  
changed lines
  Added in v.2695
[email protected]
 ViewVC Help
Powered by ViewVC 1.1.26