/[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 2692 by bernhard, Fri Sep 15 08:04:01 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      pyRXP      0.9    http://www.reportlab.org/pyrxp.html
48         only for the automatic tests to validate Thuban's XML files.
49    
50    
51  Installation  Installation
52  ------------  ------------
53    
54  Building Thuban:  Building Thuban (this compiles the extension modules but leaves them in
55    a directory under build/):
56    
57     python setup.py build     python setup.py build
58    
# Line 40  script, run Line 75  script, run
75     python setup.py --help     python setup.py --help
76    
77    
78    If you build from CVS and want to have translated menus, dialogs etc.
79    you have to build the message catalogs manually before you run setup.py.
80    See po/README for more information.
81    
82    
83    Build Troubleshooting
84    ---------------------
85    
86    When building Thuban, you might have problems because of a missing file
87    wx/wxPython/wxPython.h.  This file is part of wxPython and may be
88    packaged in a separate package.  Unfortunately, on some systems this
89    file is not packaged at all.  On those systems you can try a work-around
90    built into Thuban, by passing the --use-wx-python-swig-hack to the
91    build_ext command.  This can be done on the command line for the build
92    command like this:
93    
94       python setup.py  build_ext --use-wx-python-swig-hack  build
95    
96    You can also use it with the install_local command:
97    
98       python setup.py  build_ext --use-wx-python-swig-hack  install_local
99    
100    Note, that this work-around relies on some wxPython internals and may
101    cease to work at some point.  We tested it with wxPython 2.4 and
102    wxPython 2.5.
103    
104    
105  License  License
106  -------  -------
107    
108  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).  
   
109    
110    However, some of the extension modules in the extension subdirectory are
111    licensed under other Free Software licenses.
112    See the respective README files for details.
Legend:
Removed from v.2  
changed lines
  Added in v.2692
[email protected]
 ViewVC Help
Powered by ViewVC 1.1.26