1 |
jschuengel |
2241 |
|
2 |
|
|
UMN MapServer Extension for Thuban |
3 |
|
|
=================================== |
4 |
|
|
|
5 |
|
|
*** ATTENTION: *** |
6 |
|
|
|
7 |
|
|
The installation instructions here are detailed, so I hope everybody |
8 |
|
|
can install the extension. People who are experienced will know |
9 |
|
|
most of the commands, but everybody should be able to use |
10 |
|
|
this extension. |
11 |
|
|
|
12 |
|
|
|
13 |
|
|
|
14 |
|
|
Summary |
15 |
|
|
-------------------- |
16 |
|
|
|
17 |
|
|
This extension for Thuban allows you to handle UMN MapServer .map-files. |
18 |
|
|
|
19 |
|
|
|
20 |
|
|
|
21 |
|
|
Requirements |
22 |
|
|
-------------------- |
23 |
|
|
|
24 |
|
|
To use the UMN MapServer extension you need: |
25 |
|
|
|
26 |
|
|
UMN MapServer python-mapscript |
27 |
|
|
|
28 |
|
|
The extension was tested with UMN MapServer 4.0 and 4.2, |
29 |
|
|
older versions may not work. |
30 |
|
|
|
31 |
|
|
|
32 |
|
|
|
33 |
|
|
Installation |
34 |
|
|
-------------------- |
35 |
|
|
|
36 |
|
|
1. You need to build and install python-mapscript if you haven't installed yet. |
37 |
|
|
|
38 |
|
|
Download the UMN MapServer (http://mapserver.gis.umn.edu/dload.html) |
39 |
|
|
or use one on your system. The mapscript is included in the source package. |
40 |
|
|
|
41 |
jschuengel |
2254 |
Unpack and compile the UMN MapServer and use the following optional parameters: |
42 |
|
|
|
43 |
|
|
proj: include projection support |
44 |
|
|
gdal: include raster support |
45 |
|
|
tiff: include tiff support |
46 |
|
|
|
47 |
jschuengel |
2248 |
In some cases gdal is not necessary and mapscript can install without gdal support. |
48 |
jschuengel |
2241 |
A detailed install instruction can be found on the UMN MapServer Homepage. |
49 |
jschuengel |
2248 |
(http://mapserver.gis.umn.edu) |
50 |
jschuengel |
2241 |
|
51 |
|
|
Go to the directory where the UMN MapServer source code tar-ball exists: |
52 |
|
|
|
53 |
|
|
tar -zxf mapserver-4.2.0.tar.gz |
54 |
|
|
|
55 |
|
|
Go to the new created directory: |
56 |
|
|
|
57 |
|
|
cd mapserver-4.2.0 |
58 |
|
|
|
59 |
|
|
Configure an make the UMN MapServer |
60 |
|
|
|
61 |
jschuengel |
2254 |
./configure --with-gdal --with-proj --with-tiff |
62 |
jschuengel |
2241 |
make |
63 |
|
|
|
64 |
|
|
Now we can compile and install the python mapscript |
65 |
|
|
|
66 |
|
|
cd mapscript/python/ |
67 |
|
|
python setup.py build |
68 |
|
|
|
69 |
jschuengel |
2248 |
Some warnings are ok during the build of python mapscript |
70 |
jschuengel |
2241 |
|
71 |
|
|
At last we musst install mapscript as root. |
72 |
|
|
|
73 |
|
|
python setup.py install |
74 |
|
|
|
75 |
jschuengel |
2261 |
2. Add the umn_mapserver extension import statements to ~/.thuban/thubanstart.py |
76 |
jschuengel |
2241 |
if you run thuban directly from the source directory the statement is: |
77 |
|
|
|
78 |
|
|
import Extensions.umn_mapserver.mf_import |
79 |
jschuengel |
2261 |
import Extensions.umn_mapserver.mf_export |
80 |
|
|
import Extensions.umn_mapserver.mf_handle |
81 |
jschuengel |
2241 |
|
82 |
|
|
More about how to use an extension |
83 |
|
|
see README in thuban/Examples/simple_extensions. |
84 |
|
|
|
85 |
|
|
3. Start Thuban and use the extension. |
86 |
|
|
|
87 |
|
|
|
88 |
|
|
|
89 |
|
|
Usage |
90 |
|
|
-------------------- |
91 |
|
|
|
92 |
|
|
The usage of the extension is very intuitive, so you will see what you can do |
93 |
|
|
while you are using the extension ;) |