2 |
<!DOCTYPE book |
<!DOCTYPE book |
3 |
PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" |
PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" |
4 |
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" |
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" |
5 |
[<!ENTITY imgscale "70">]> |
[<!ENTITY imgscale "60">]> |
6 |
<!-- $Revision$ --> |
<!-- $Revision$ --> |
7 |
<book> |
<book> |
8 |
<bookinfo> |
<bookinfo> |
19 |
</author> |
</author> |
20 |
</authorgroup> |
</authorgroup> |
21 |
<copyright> |
<copyright> |
22 |
<year>2003</year> |
<year>2003, 2004</year> |
23 |
<holder>Intevation GmbH</holder> |
<holder>Intevation GmbH</holder> |
24 |
</copyright> |
</copyright> |
25 |
<revhistory> |
<revhistory> |
26 |
<!-- comment this first revision out when releasing a real version --> |
<!-- comment this first revision out when releasing a real version --> |
|
<!-- |
|
27 |
<revision> |
<revision> |
28 |
<revnumber>CVS version $Id$</revnumber> |
<revnumber>CVS version $Id$</revnumber> |
29 |
<date></date> |
<date></date> |
30 |
<revremark>Under development.</revremark> |
<revremark>Under development.</revremark> |
31 |
</revision> |
</revision> |
32 |
--> |
<revision> |
33 |
|
<revnumber>1.0.0</revnumber> |
34 |
|
<date>22-Jan-2004</date> |
35 |
|
<revremark> |
36 |
|
Corresponds to Thuban 1.0.0. |
37 |
|
New: Installation instructions for Win32. |
38 |
|
</revremark> |
39 |
|
</revision> |
40 |
|
<revision> |
41 |
|
<revnumber>1.0pre3</revnumber> |
42 |
|
<date>04-Dec-2003</date> |
43 |
|
<revremark> |
44 |
|
Corresponds to Thuban 1.0rc1. |
45 |
|
New: I18n, right button legend menu, EPSG projectons, |
46 |
|
PostGIS support. |
47 |
|
</revremark> |
48 |
|
</revision> |
49 |
<revision> |
<revision> |
50 |
<revnumber>1.0pre2</revnumber> |
<revnumber>1.0pre2</revnumber> |
51 |
<date>29-Aug-2003</date> |
<date>29-Aug-2003</date> |
66 |
<chapter><title>Introduction</title> |
<chapter><title>Introduction</title> |
67 |
<para> |
<para> |
68 |
Thuban is an interactive geographic data viewer. |
Thuban is an interactive geographic data viewer. |
69 |
It has been developed because there was no simple interactive |
Its development had been started because there was no simple interactive |
70 |
viewer for geographic information available as Free Software. Thuban is |
viewer for geographic information available as Free Software. Thuban is |
71 |
written in Python and C++ and uses the wxWindows library allowing it to |
written mainly in Python and uses the wxWidgets (former wxWindows) |
72 |
|
library allowing it to |
73 |
run on many different platforms, including GNU/Linux and Windows. |
run on many different platforms, including GNU/Linux and Windows. |
74 |
</para> |
</para> |
75 |
<para> |
<para> |
83 |
</para> |
</para> |
84 |
<para> |
<para> |
85 |
Thuban arranges a session in a hierarchy. A session contains a map which |
Thuban arranges a session in a hierarchy. A session contains a map which |
86 |
consists of layers. Each layer represents one kind of data set. For |
consists of layers. Each layer represents a data set. For |
87 |
instance, there may be a layer for roads and another layer for buildings. |
instance, there may be a layer for roads and another layer for buildings. |
88 |
These layers can either be vector shapes or images. |
These layers can either be vector shapes or images. |
89 |
</para> |
</para> |
96 |
<ulink url="http://thuban.intevation.org/download.html"> |
<ulink url="http://thuban.intevation.org/download.html"> |
97 |
Thuban Download site |
Thuban Download site |
98 |
</ulink>. |
</ulink>. |
99 |
|
</para> |
100 |
|
<para> |
101 |
|
Required: |
102 |
<itemizedlist> |
<itemizedlist> |
103 |
<listitem><para>Python 2.2.1 (<literal>http://www.python.org</literal>)</para></listitem> |
<listitem><para>Python 2.2.1 |
104 |
<listitem><para>wxWindows 2.4 (<literal>http://www.wxwindows.org</literal>)</para></listitem> |
(<literal>http://www.python.org</literal>) |
105 |
<listitem><para>wxPython 2.4 (<literal>http://www.wxpython.org</literal>)</para></listitem> |
</para></listitem> |
106 |
<listitem><para>proj 4.4.5 Projection Library (<literal>http://www.remotesensing.org/proj/</literal>)</para></listitem> |
<listitem><para>wxWindows 2.4 |
107 |
<listitem><para>GDAL 1.1.8 (<literal>http://www.remotesensing.org/gdal/</literal>)</para></listitem> |
(<literal>http://www.wxwindows.org</literal>) |
108 |
<listitem><para>SQLite 2.8.3 (<literal>http://www.hwaci.com/sw/sqlite/</literal>)</para></listitem> |
</para></listitem> |
109 |
<listitem><para>PySQLite 0.4.3 (<literal>http://pysqlite.sourceforge.net</literal>)</para></listitem> |
<listitem><para>wxPython 2.4 |
110 |
|
(<literal>http://www.wxpython.org</literal>) |
111 |
|
</para></listitem> |
112 |
|
<listitem><para>proj 4.4.5 Projection Library |
113 |
|
(<literal>http://www.remotesensing.org/proj/</literal>) |
114 |
|
</para></listitem> |
115 |
|
<listitem><para>SQLite 2.8.3 |
116 |
|
<literal>http://www.hwaci.com/sw/sqlite/</literal>) |
117 |
|
</para></listitem> |
118 |
|
<listitem><para>PySQLite 0.4.3 |
119 |
|
(<literal>http://pysqlite.sourceforge.net</literal>) |
120 |
|
</para></listitem> |
121 |
|
</itemizedlist> |
122 |
|
</para> |
123 |
|
<para> |
124 |
|
Optional: |
125 |
|
<itemizedlist> |
126 |
|
<listitem><para>GDAL 1.1.8 |
127 |
|
(<literal>http://www.remotesensing.org/gdal/</literal>) |
128 |
|
</para></listitem> |
129 |
|
<listitem><para>psycopg 1.0.8 |
130 |
|
(<literal>http://initd.org/software/psycopg</literal>) |
131 |
|
</para></listitem> |
132 |
</itemizedlist> |
</itemizedlist> |
133 |
</para> |
</para> |
134 |
<para> |
<para> |
135 |
Along with the source codes, the download page also offers |
Along with the source codes, the download page also offers full |
136 |
full installation packages for Debian, Windows and RPM-based systems |
installation packages for Debian, Windows and RPM-based systems |
137 |
(Mandrake, RedHat, SuSE, etc). |
(Mandrake, RedHat, SuSE, etc). |
138 |
</para> |
</para> |
139 |
<section><title>RPM-based GNU/Linux Systems</title> |
<section><title>RPM-based GNU/Linux Systems</title> |
140 |
<section><title>Installing Binary Packages</title> |
<section><title>Installing Binary Packages</title> |
141 |
<para> |
<para> |
142 |
The most wide-spread RPM-based GNU/Linux Systems are RedHat, |
The most wide-spread RPM-based GNU/Linux |
143 |
Mandrake and SuSE. The documentation of these distributions |
Systems are RedHat, Mandrake and SuSE. |
144 |
should contain information about how to install third-party |
The documentation of these distributions |
145 |
RPM packages. Nonetheless, a short summary is provided here. |
should contain information about how to |
146 |
|
install third-party RPM packages. |
147 |
|
Nonetheless, a short summary is provided here. |
148 |
</para> |
</para> |
149 |
<para> |
<para> |
150 |
RPM packages can be installed applying several tools. |
RPM packages can be installed applying several |
151 |
The most basic one is the command line program "rpm". |
tools. The most basic one is the command line |
152 |
The hardware architecture is identified in the name |
program "rpm". The hardware architecture is |
153 |
of RPM packages, eg. 'i386' for most Intel/AMD architectures. |
identified in the name of RPM packages, eg. |
154 |
If you have a different hardware architecture, where no |
'i386' for most Intel/AMD architectures. |
155 |
binary RPM packages are provided, you must rebuild binary |
If you have a different hardware architecture, |
156 |
packages from the RPM source packages first (see below). |
where no binary RPM packages are provided, |
157 |
|
you must rebuild binary packages from the |
158 |
|
RPM source packages first (see below). |
159 |
Typical rpm commands look like: |
Typical rpm commands look like: |
160 |
|
|
161 |
<programlisting> |
<programlisting> |
162 |
rpm --install Thuban-0.9.0-1.i386.rpm |
rpm --install Thuban-0.9.0-1.i386.rpm |
163 |
</programlisting> |
</programlisting> |
164 |
|
|
165 |
Depending on what you already have installed on your |
Depending on what you already have installed |
166 |
system, you are informed that some packages are |
on your system, you are informed that some |
167 |
required, but not installed. You need to install them |
packages are required, but not installed. |
168 |
first. Either they are provided by your GNU/Linux distributor |
You need to install them first. Either they |
169 |
or available somewhere on the Internet. |
are provided by your GNU/Linux distributor |
170 |
The more essential and special ones are provided together |
or available somewhere on the Internet. |
171 |
with the Thuban package. |
The more essential and special ones are |
172 |
|
provided together with the Thuban package. |
173 |
</para> |
</para> |
174 |
|
|
175 |
<para> |
<para> |
284 |
<ulink url="http://www.rpm.org/">homepage of RPM</ulink>. |
<ulink url="http://www.rpm.org/">homepage of RPM</ulink>. |
285 |
</para> |
</para> |
286 |
</section> |
</section> |
287 |
</section> |
</section> <!-- Intro - Installation - RPM--> |
288 |
|
|
289 |
|
<section><title>Win32 Systems</title> |
290 |
|
<para> |
291 |
|
A common installation package of Thuban for Win32 |
292 |
|
systems is available from the Thuban website download |
293 |
|
section. This installation package is configured for |
294 |
|
displaying file based vector data (Shapefiles). For the |
295 |
|
display of raster data or the connection to spatial |
296 |
|
databases additional steps are needed. |
297 |
|
</para> |
298 |
|
<para> |
299 |
|
The required Python packages are listed and linked on |
300 |
|
the download page as well. If you don't have Python |
301 |
|
installed already, download the packages for Python, |
302 |
|
wxPython for Python and the SQLite Python Libraries as |
303 |
|
well as the Thuban package. Install all four packages |
304 |
|
in the order: Python, wxPython, SQLite, Thuban. Follow |
305 |
|
the installation instructions provided by the seperate |
306 |
|
setups. The Thuban installation package will add an |
307 |
|
entry in the menu folder you configured. |
308 |
|
</para> |
309 |
|
<section><title>Raster Data: Installation of GDAL</title> |
310 |
|
<para> |
311 |
|
Enabling the raster data features of Thuban is |
312 |
|
straight forward. For the examples we assume that |
313 |
|
Thuban has been installed under |
314 |
|
<literal>C:\Thuban</literal>: |
315 |
|
<itemizedlist> |
316 |
|
<listitem> |
317 |
|
<para> |
318 |
|
Download the zip-archive <ulink |
319 |
|
url="ftp://intevation.de/thuban/win2k/gdal-win2k.zip" |
320 |
|
>gdal-win2k</ulink>. |
321 |
|
</para></listitem> |
322 |
|
<listitem><para>Extract the archive (e.g. with |
323 |
|
<ulink |
324 |
|
url="http://www.info-zip.org/pub/infozip/WiZ.html" |
325 |
|
>WiZ (InfoZip)</ulink>) into the |
326 |
|
<literal>C:\Thuban\Lib</literal> |
327 |
|
directory of your Thuban installation. |
328 |
|
</para> |
329 |
|
</listitem> |
330 |
|
<listitem> |
331 |
|
<para> |
332 |
|
Extent the <varname>PYTHONPATH</varname> |
333 |
|
environment variable (in your Windows Control Panel) |
334 |
|
to make the new libraries available for Thuban. |
335 |
|
<programlisting> |
336 |
|
%PYTHONPATH%;C:\Thuban\Lib\gdal;C:\Thuban\Lib\gdal\pymod |
337 |
|
</programlisting> |
338 |
|
</para> |
339 |
|
</listitem> |
340 |
|
<listitem> |
341 |
|
<para> |
342 |
|
Extent also the <varname>PATH</varname> |
343 |
|
environment variable accordingly: |
344 |
|
<programlisting> |
345 |
|
%PATH%;C:\Thuban\Lib\gdal |
346 |
|
</programlisting> |
347 |
|
</para> |
348 |
|
</listitem> |
349 |
|
</itemizedlist> |
350 |
|
After this installation steps Thuban is ready to |
351 |
|
display raster data (e.g. the |
352 |
|
<literal>island.tif</literal> from the Iceland Demo |
353 |
|
data set. |
354 |
|
</para> |
355 |
|
</section> <!-- Win32: GDAL--> |
356 |
|
|
357 |
|
<section><title>Working with PostGIS: Installation of PsycoPG</title> |
358 |
|
<para> |
359 |
|
To access PostgreSQL/PostGIS spatial databases with |
360 |
|
Thuban you have to install the PsycoPG package for |
361 |
|
Windows: |
362 |
|
<itemizedlist> |
363 |
|
<listitem> |
364 |
|
<para> |
365 |
|
Download the zip-archive |
366 |
|
<ulink |
367 |
|
url="http://stickpeople.com/projects/python/win-psycopg/win-psycopg22.zip" |
368 |
|
>win-psycopg22.zip</ulink>. |
369 |
|
</para> |
370 |
|
</listitem> |
371 |
|
<listitem> |
372 |
|
<para> |
373 |
|
Extract the zip-archive into a directory either already |
374 |
|
in your <varname>PYTHONPATH</varname> or extent your |
375 |
|
<varname>PYTHONPATH</varname> variable to the directory |
376 |
|
you have extracted the archive to. |
377 |
|
</para> |
378 |
|
</listitem> |
379 |
|
</itemizedlist> |
380 |
|
For installation and maintenance of spatial databases |
381 |
|
we refer to the <ulink |
382 |
|
url="http://postgis.refractions.net" |
383 |
|
>PostGIS Homepage</ulink>. |
384 |
|
</para> |
385 |
|
</section> <!-- Win32: PsycoPG--> |
386 |
|
|
387 |
|
</section> <!-- Intro - Installation - Win32 --> |
388 |
</section> |
</section> |
389 |
|
|
390 |
|
<section><title>Internationalization</title> |
391 |
|
<para> |
392 |
|
Thuban is implemented with internationalization support. So far Thuban |
393 |
|
is translated by volunteers to the following languages (apart from its |
394 |
|
main language: English): |
395 |
|
<itemizedlist> |
396 |
|
<listitem><para>French</para></listitem> |
397 |
|
<listitem><para>German</para></listitem> |
398 |
|
<listitem><para>Italian</para></listitem> |
399 |
|
<listitem><para>Portuguese (Brazilian)</para></listitem> |
400 |
|
<listitem><para>Russian</para></listitem> |
401 |
|
<listitem><para>Spanish</para></listitem> |
402 |
|
</itemizedlist> |
403 |
|
</para> |
404 |
|
|
405 |
|
<para> |
406 |
|
To use internationalization under POSIX systems (like GNU/Linux) |
407 |
|
you have to set the environment variable LC_ALL accordingly (e.g. |
408 |
|
LC_ALL=fr_FR for the french language support). Please check your |
409 |
|
systems documentation for details and supported settings. |
410 |
|
Specifiying LC_ALL on the command line while launching thuban |
411 |
|
allows appication specific language settings: |
412 |
|
</para> |
413 |
|
<programlisting> |
414 |
|
LC_ALL=fr_FR thuban.py |
415 |
|
</programlisting> |
416 |
|
|
417 |
|
<para> |
418 |
|
MS Windows users have to specify the language to be used via the control |
419 |
|
bar (which effects all applications). |
420 |
|
</para> |
421 |
|
</section> |
422 |
|
|
423 |
<section><title>The Main Window</title> |
<section><title>The Main Window</title> |
424 |
<para> |
<para> |
425 |
<figure> |
<figure> |
570 |
|
|
571 |
<section><title>Adding and Removing Layers</title> |
<section><title>Adding and Removing Layers</title> |
572 |
<para> |
<para> |
573 |
There are two types of layers that can be added to a map: Shape layers |
There are three types of layers that can be added to a map: |
574 |
|
Shape layers, database layers |
575 |
and image layers. Shape layers are stored in Shapefile format, a |
and image layers. Shape layers are stored in Shapefile format, a |
576 |
widely used file format for storing geographic objects. These |
widely used file format for storing geographic objects. These |
577 |
files have the extension ``.shp''. Associated with |
files have the extension ``.shp''. Associated with |
581 |
For example, if there is a shape file named roads.shp there must |
For example, if there is a shape file named roads.shp there must |
582 |
also be a file roads.dbf. |
also be a file roads.dbf. |
583 |
</para> |
</para> |
584 |
<para> |
<itemizedlist> |
585 |
|
<listitem> |
586 |
|
<para> |
587 |
Shape layers can be added to the map with |
Shape layers can be added to the map with |
588 |
<menuchoice> |
<menuchoice> |
589 |
<guimenu>Map</guimenu> |
<guimenu>Map</guimenu> |
599 |
Use the shift-button together with the left mouse button to extend |
Use the shift-button together with the left mouse button to extend |
600 |
the selection. |
the selection. |
601 |
</para> |
</para> |
602 |
|
</listitem> |
603 |
|
|
604 |
|
<listitem> |
605 |
|
<para>Database layers can be added to the map with |
606 |
|
<menuchoice> |
607 |
|
<guimenu>Map</guimenu> |
608 |
|
<guimenuitem>Add Database Layer</guimenuitem> |
609 |
|
</menuchoice>. |
610 |
|
A dialog with two is list is opened. The left list displays all |
611 |
|
database connections currently open for the session. You can retrieve |
612 |
|
a list of available layers from the selected database which is |
613 |
|
displayed on the right hand. From this list one layer can be selected, |
614 |
|
the dialog is closed afterwards. |
615 |
|
</para> |
616 |
|
<para> |
617 |
|
See appendix ``Working with PostGIS'' for details. |
618 |
|
</para> |
619 |
|
</listitem> |
620 |
|
|
621 |
|
<listitem> |
622 |
<para> |
<para> |
623 |
Image layers can be added to the map with |
Image layers can be added to the map with |
624 |
<menuchoice> |
<menuchoice> |
630 |
or in another file. If geographic information cannot be found, Thuban |
or in another file. If geographic information cannot be found, Thuban |
631 |
will report an error. |
will report an error. |
632 |
</para> |
</para> |
633 |
|
</listitem> |
634 |
|
</itemizedlist> |
635 |
</section> |
</section> |
636 |
|
|
637 |
<section><title>Navigation</title> |
<section><title>Navigation</title> |
923 |
</para> |
</para> |
924 |
</listitem> |
</listitem> |
925 |
</itemizedlist> |
</itemizedlist> |
926 |
|
|
927 |
|
<para> |
928 |
|
The most used layer related actions are also available from a |
929 |
|
popup menu. It is raised when a layer is clicked with the right mouse |
930 |
|
button. |
931 |
|
</para> |
932 |
|
|
933 |
|
<para> |
934 |
|
<figure> |
935 |
|
<title>Layer Popup Menu</title> |
936 |
|
<mediaobject> |
937 |
|
<imageobject><imagedata fileref="../images/3_5_popup_menu.png" format="PNG" scale="&imgscale;"/></imageobject> |
938 |
|
<imageobject><imagedata fileref="./images/3_5_popup_menu.eps" format="EPS" scale="&imgscale;"/></imageobject> |
939 |
|
</mediaobject> |
940 |
|
</figure> |
941 |
|
</para> |
942 |
|
|
943 |
<para> |
<para> |
944 |
Along the bottom of the legend is the scalebar. The scalebar |
Along the bottom of the legend is the scalebar. The scalebar |
945 |
will be available if there are any layers and the map has a |
will be available if there are any layers and the map has a |
984 |
|
|
985 |
<section><title>Types of Layers</title> |
<section><title>Types of Layers</title> |
986 |
<para> |
<para> |
987 |
There are two types of layers supported by Thuban: shape layers and |
There are three types of layers supported by Thuban: shape layers, |
988 |
|
database layers and |
989 |
image layers. Shape layers consist of vector based shapes with |
image layers. Shape layers consist of vector based shapes with |
990 |
geo-referenced coordinates. There are three types of supported |
geo-referenced coordinates. There are three types of supported |
991 |
shapes: polygons, lines (arc), and points. Image layers can be any image |
shapes: polygons, lines (arc), and points. Database layers are similar |
992 |
|
to shape layers but loaded from a database instead of the file system. |
993 |
|
Image layers can be any image |
994 |
file format supported by the Geo-spatial Data Abstraction Library |
file format supported by the Geo-spatial Data Abstraction Library |
995 |
(GDAL). The images must have geographic |
(GDAL). The images must have geographic |
996 |
coordinate data either embedded within the file or in a separate |
coordinate data either embedded within the file or in a separate |
1322 |
</figure> |
</figure> |
1323 |
</para> |
</para> |
1324 |
<para> |
<para> |
1325 |
Thuban is distributed with a sample collection of projections. The |
Thuban is distributed with a sample collection of projections and the |
1326 |
|
set of coordinate systems as used by the EPSG |
1327 |
|
(European Petroleum Survey Group). This quite large set is only displayed |
1328 |
|
if activated by the according checkbox. The set falls into two parts: |
1329 |
|
deprecated lists all projections which are no longer part of the |
1330 |
|
EPSG data base. |
1331 |
|
</para> |
1332 |
|
<para> |
1333 |
|
The |
1334 |
user can create new projections and make them available to all |
user can create new projections and make them available to all |
1335 |
future Thuban sessions. They may also be exported and imported so |
future Thuban sessions. They may also be exported and imported so |
1336 |
that custom projections can be distributed. |
that custom projections can be distributed. |
1834 |
helptext = _('Welcome everyone on this planet'))) |
helptext = _('Welcome everyone on this planet'))) |
1835 |
|
|
1836 |
# find the extensions menu (create it anew if not found) |
# find the extensions menu (create it anew if not found) |
1837 |
extensions_menu = main_menu.find_menu('extensions') |
extensions_menu = main_menu.FindOrInsertMenu('extensions', _('E&xtensions')) |
|
if extensions_menu is None: |
|
|
extensions_menu = main_menu.InsertMenu('extensions', _('E&xtensions')) |
|
1838 |
|
|
1839 |
# finally bind the new command with an entry in the extensions menu |
# finally bind the new command with an entry in the extensions menu |
1840 |
extensions_menu.InsertItem('hello_world') |
extensions_menu.InsertItem('hello_world') |
2006 |
</varlistentry> |
</varlistentry> |
2007 |
|
|
2008 |
<varlistentry> |
<varlistentry> |
2009 |
|
<term>PostGIS</term> |
2010 |
|
<listitem> |
2011 |
|
<para> |
2012 |
|
PostGIS adds support for geographic objects to the PostgreSQL |
2013 |
|
object-relational database. Different layer types (as for Shapefiles) |
2014 |
|
are supported. <ulink url="http://postgis.refractions.net">PostGIS |
2015 |
|
Homepage</ulink> |
2016 |
|
</para> |
2017 |
|
</listitem> |
2018 |
|
</varlistentry> |
2019 |
|
|
2020 |
|
<varlistentry> |
2021 |
<term>Raster files</term> |
<term>Raster files</term> |
2022 |
<listitem> |
<listitem> |
2023 |
<para> |
<para> |
2036 |
</variablelist> |
</variablelist> |
2037 |
</appendix> |
</appendix> |
2038 |
|
|
2039 |
|
<appendix><title>Working with PostGIS</title> |
2040 |
|
<para> |
2041 |
|
This section focusses on the use of PostGIS in the Thuban framework. For |
2042 |
|
installation and maintenance of spatial databases we refer to the |
2043 |
|
<ulink url="http://postgis.refractions.net">PostGIS Homepage</ulink>. |
2044 |
|
The Thuban PostGIS support requires the |
2045 |
|
<ulink url="http://initd.org/software/psycopg">psycopg module</ulink>. |
2046 |
|
</para> |
2047 |
|
|
2048 |
|
<para> |
2049 |
|
Working with PostGIS Databases is seperated into two steps: |
2050 |
|
<itemizedlist> |
2051 |
|
<listitem><para>Opening a Database Connection</para></listitem> |
2052 |
|
<listitem><para>Loading a Data Layer</para></listitem> |
2053 |
|
</itemizedlist> |
2054 |
|
</para> |
2055 |
|
<section><title>Opening a Database Connection</title> |
2056 |
|
<para> |
2057 |
|
Before a data layer can be loaded from a PostGIS database a |
2058 |
|
connection with the database has to be established. |
2059 |
|
<menuchoice> |
2060 |
|
<guimenu>Session</guimenu> |
2061 |
|
<guimenuitem>Database Connections ...</guimenuitem> |
2062 |
|
</menuchoice> opens a dialog for database connection |
2063 |
|
management. In the dialog new connections can be added |
2064 |
|
and existing ones can be removed. Removing a database |
2065 |
|
connection is not possible if the map still displays a |
2066 |
|
layer provided by this database connection. |
2067 |
|
</para> |
2068 |
|
<figure> |
2069 |
|
<title>Database Management Dialog</title> |
2070 |
|
<mediaobject> |
2071 |
|
<imageobject><imagedata fileref="../images/app_postgis_db_management.png" format="PNG" scale="&imgscale;"/></imageobject> |
2072 |
|
<imageobject><imagedata fileref="./images/app_postgis_db_management.eps" format="EPS" scale="&imgscale;"/></imageobject> |
2073 |
|
</mediaobject> |
2074 |
|
</figure> |
2075 |
|
|
2076 |
|
<para> |
2077 |
|
To add a new database connection to the session a dialog is |
2078 |
|
opened to specify the relevant connection data. Enter all |
2079 |
|
data relevant for your connection. If the connection fails |
2080 |
|
the dialog remains open and provides some hints on the failure. |
2081 |
|
</para> |
2082 |
|
<figure> |
2083 |
|
<title>Add Database Dialog</title> |
2084 |
|
<mediaobject> |
2085 |
|
<imageobject><imagedata fileref="../images/app_postgis_db_add.png" format="PNG" scale="&imgscale;"/></imageobject> |
2086 |
|
<imageobject><imagedata fileref="./images/app_postgis_db_add.eps" format="EPS" scale="&imgscale;"/></imageobject> |
2087 |
|
</mediaobject> |
2088 |
|
</figure> |
2089 |
|
|
2090 |
|
<para> |
2091 |
|
It is important to note that information on database connections are |
2092 |
|
also stored with the session. Passwords are NOT stored. If you load a |
2093 |
|
session with database connections you are asked to enter these |
2094 |
|
passwords again where required. |
2095 |
|
</para> |
2096 |
|
|
2097 |
|
</section> |
2098 |
|
|
2099 |
|
<section><title>Loading a Data Layer</title> |
2100 |
|
<para> |
2101 |
|
Data layers as part of a map are loaded with the |
2102 |
|
<menuchoice> |
2103 |
|
<guimenu>Map</guimenu> |
2104 |
|
<guimenuitem>Add Database Layer ...</guimenuitem> |
2105 |
|
</menuchoice> menu item. A dialog is raised displaying two choice |
2106 |
|
lists. In the left list all connected databases are shown. |
2107 |
|
Highlighting |
2108 |
|
one of these and issuing a retrieval results in a list of available |
2109 |
|
layer tables from that database. After selection of a |
2110 |
|
layer the dialog is closed. |
2111 |
|
</para> |
2112 |
|
<figure> |
2113 |
|
<title>Add Database Dialog</title> |
2114 |
|
<mediaobject> |
2115 |
|
<imageobject><imagedata fileref="../images/app_postgis_add_layer.png" format="PNG" scale="&imgscale;"/></imageobject> |
2116 |
|
<imageobject><imagedata fileref="./images/app_postgis_add_layer.eps" format="EPS" scale="&imgscale;"/></imageobject> |
2117 |
|
</mediaobject> |
2118 |
|
</figure> |
2119 |
|
|
2120 |
|
</section> |
2121 |
|
|
2122 |
|
</appendix> |
2123 |
|
|
2124 |
<appendix><title>Supported Projections</title> |
<appendix><title>Supported Projections</title> |
2125 |
<para> |
<para> |
2126 |
The following types of projections are directly support by |
The following types of projections are directly support by |