/[thuban]/branches/WIP-pyshapelib-bramz/Doc/manual/thuban-manual.xml
ViewVC logotype

Diff of /branches/WIP-pyshapelib-bramz/Doc/manual/thuban-manual.xml

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

revision 1478 by frank, Thu Jul 24 17:00:25 2003 UTC revision 1530 by jonathan, Thu Jul 31 09:57:25 2003 UTC
# Line 1  Line 1 
1  <?xml version="1.0" encoding="ISO-8859-1"?>  <?xml version="1.0" encoding="ISO-8859-1"?>
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">]>
6  <!-- $Revision$ -->  <!-- $Revision$ -->
7  <book>  <book>
8    <bookinfo>    <bookinfo>
# Line 47  Line 48 
48          <section><title>Installation</title>          <section><title>Installation</title>
49          <para>          <para>
50          Thuban is actively supported under Debian Testing (sarge), RedHat 7.2,          Thuban is actively supported under Debian Testing (sarge), RedHat 7.2,
51          and Windows 2000. All the necessary files can be found on the          and Windows 2000. The following list of files that Thuban requires
52            can be found on the
53          <ulink url="http://thuban.intevation.org/download.html">          <ulink url="http://thuban.intevation.org/download.html">
54          Thuban Download site          Thuban Download site
55          </ulink>.          </ulink>.
56            <variablelist>
57            <varlistentry>
58            <term>Debian Testing (sarge)</term>
59            <listitem>
60                <para>Thuban-0.8.1-1-debian.i386.rpm</para>
61                <para>GTK 1.2.3</para>
62                <para>Python 2.2.1</para>
63                <para>Python 2.2 XML Base Tools</para>
64                <para>wxWindows 2.4</para>
65                <para>wxWindows 2.4 Python Bindings</para>
66                <para>proj 4.4.5 Projection Library</para>
67                <para>SQLite Python Bindings 0.4.3</para>
68                <para>GDAL 1.1.8</para>
69            </listitem>
70            </varlistentry>
71            <varlistentry>
72            <term>RedHat 7.2</term>
73            <listitem>
74                <para>Thuban-0.8.1-1.i386.rpm</para>
75                <para>Python 2.2.1</para>
76                <para>wxPython 2.4 for Python 2.2 with wxGTK</para>
77                <para>proj 4.4.5 Projection Library</para>
78                <para>SQLite 2.8.3</para>
79                <para>PySQLite 0.4.3</para>
80                <para>GDAL 1.1.8</para>
81            </listitem>
82            </varlistentry>
83            <varlistentry>
84            <term>Windows 2000</term>
85            <listitem>
86                <para>Thuban-0.8.1-0.exe</para>
87                <para>Python 2.2.1</para>
88                <para>wxWindows 2.4 for Python 2.2</para>
89                <para>SQLite Python Libraries</para>
90                <para>GDAL for Thuban</para>
91            </listitem>
92            </varlistentry>
93            </variablelist>
94          </para>          </para>
95          </section>          </section>
96    
# Line 59  Line 99 
99          <screenshot>          <screenshot>
100          <screeninfo>The Main Window</screeninfo>          <screeninfo>The Main Window</screeninfo>
101          <mediaobject>          <mediaobject>
102          <imageobject> <imagedata fileref="../images/1_2_mainwindow.png" format="PNG"/> </imageobject>          <imageobject> <imagedata fileref="../images/1_2_mainwindow.png" format="PNG" scale="&imgscale;"/> </imageobject>
103          <imageobject> <imagedata fileref="./images/1_2_mainwindow.ps" format="EPS"/> </imageobject>          <imageobject> <imagedata fileref="./images/1_2_mainwindow.ps" format="EPS" scale="&imgscale;"/> </imageobject>
104          <textobject><phrase>The Main Window</phrase></textobject>          <textobject><phrase>The Main Window</phrase></textobject>
105          <caption><para>The Main Window</para></caption>          <caption><para>The Main Window</para></caption>
106          </mediaobject>          </mediaobject>
# Line 100  Line 140 
140          The tool bar provides quick access to the commonly needed tools.          The tool bar provides quick access to the commonly needed tools.
141          By hovering over each button the user can see a short messages          By hovering over each button the user can see a short messages
142          describing what the tool does. The tools provided are Zoom In, Zoom          describing what the tool does. The tools provided are Zoom In, Zoom
143          Out, Pan, Full Extent, Full Layer Extent, Full Shape Extent, Indentify,          Out, Pan, Full Extent, Full Layer Extent, Full Shape Extent, Identify,
144          and Label. Each of the tools will be explained in further detail later          and Label. Each of the tools will be explained in further detail later
145          in the manual.          in the manual.
146          </para>          </para>
# Line 116  Line 156 
156          <menuchoice>          <menuchoice>
157          <guimenu>File</guimenu>          <guimenu>File</guimenu>
158          <guimenuitem>New Session</guimenuitem>          <guimenuitem>New Session</guimenuitem>
159          </menuchoice>.          </menuchoice>.
   
160          If a session is already loaded and has been modified without          If a session is already loaded and has been modified without
161          being saved a prompt will ask if the current session should          being saved a prompt will ask if the current session should
162          be saved.          be saved. A new session consists of an empty map with no
163            layers and no tables.
164          </para>          </para>
165          </section>          </section>
166    
# Line 131  Line 170 
170          <menuchoice>          <menuchoice>
171          <guimenu>File</guimenu>          <guimenu>File</guimenu>
172          <guimenuitem>Open Session</guimenuitem>          <guimenuitem>Open Session</guimenuitem>
173          </menuchoice>.          </menuchoice>. A dialog box will open allowing the user to browse
174            for a Thuban Session file. Thuban session files end with
175            <varname>.thuban</varname>. Selecting a file a clicking
176            <guibutton>OK</guibutton> will load the session into Thuban.
177    
178          If a session is already loaded and has been modified without          If a session is already loaded and has been modified without
179          being saved a prompt will ask if the current session should          being saved a prompt will ask if the current session should
# Line 145  Line 187 
187          <menuchoice>          <menuchoice>
188          <guimenu>File</guimenu>          <guimenu>File</guimenu>
189          <guimenuitem>Save Session</guimenuitem>          <guimenuitem>Save Session</guimenuitem>
190          </menuchoice>.          </menuchoice>. A dialog box will open allowing the user to browse
191            the file system and select a place to save the session. Thuban
192            sessions should be saved under a name ending in
193            <varname>.thuban</varname>. If the file already exists the user
194            will be prompted to save under a different name or overwrite the
195            existing file.
196          </para>          </para>
197          </section>          </section>
198    
199          <section><title>The Session Info-Tree</title>          <section><title>The Session Info-Tree</title>
200            <para>
201            <screenshot>
202            <screeninfo>Session Info Tree</screeninfo>
203            <mediaobject>
204            <imageobject><imagedata fileref="../images/2_4_session_tree.png" format="PNG" scale="&imgscale;"/></imageobject>
205            <imageobject><imagedata fileref="./images/2_4_session_tree.eps" format="EPS" scale="&imgscale;"/></imageobject>
206            <textobject><phrase>Session Info Tree</phrase></textobject>
207            <caption><para>Session Info Tree</para></caption>
208            </mediaobject>
209            </screenshot>
210            </para>
211          <para>          <para>
212                  (primarily for developers)          The session info-tree is primarily intended for developers working
213            with Thuban. It displays many of the internal values for the session,
214            map, and layers. It can be opened from
215            <menuchoice>
216            <guimenu>File</guimenu>
217            <guimenuitem>Session Tree</guimenuitem>
218            </menuchoice>.
219          </para>          </para>
220          </section>          </section>
221    </chapter>    </chapter>
# Line 163  Line 226 
226      different type of data set. By interacting with the map the user can      different type of data set. By interacting with the map the user can
227      visually explore the data.      visually explore the data.
228      </para>      </para>
229        <para>
230        The map can have a name that will appear in the Thuban title bar.
231        The map name can be changed using
232        <menuchoice>
233        <guimenu>Map</guimenu>
234        <guimenuitem>Rename</guimenuitem>
235        </menuchoice>.
236        </para>
237        <para>
238        <inlinemediaobject>
239        <imageobject>
240        <imagedata fileref="../images/3_rename_map.png" format="PNG" scale="&imgscale;"/>
241        </imageobject>
242        <imageobject>
243        <imagedata fileref="./images/3_rename_map.eps" format="EPS" scale="&imgscale;"/>
244        </imageobject>
245        <textobject> <phrase>Rename Map</phrase> </textobject>
246        </inlinemediaobject>
247        </para>
248    
249          <section><title>Adding and Removing Layers</title>          <section><title>Adding and Removing Layers</title>
250          <para>          <para>
251          There are two types of layers that can use added to a map: shape layers          There are two types of layers that can be added to a map: shape layers
252          and image layers. Shape layers are stored in Shapefile format, a          and image layers. Shape layers are stored in Shapefile format, a
253          standard file format for storing geographic objects. Normally, these          standard file format for storing geographic objects. These
254          files have the extension ``.shp''. Associated with          files have the extension ``.shp''. Associated with
255          the object information is a database file which stores attributes for          the shape file is a database file which stores attributes for
256          each shape in the Shapefile. This file, stored in DB2 format, usually          each shape in the shape file. This file, in dBase format,
257          has the extension ``.dbf''. Both files should have the same base name.          has the extension ``.dbf''. Both files must have the same base name.
258          For example, if there is a Shapefile named roads.shp there should          For example, if there is a shape file named roads.shp there must
259          also be a file roads.dbf.          also be a file roads.dbf.
260          </para>          </para>
261          <para>          <para>
# Line 183  Line 265 
265          <guimenuitem>Add Layer</guimenuitem>          <guimenuitem>Add Layer</guimenuitem>
266          </menuchoice>.          </menuchoice>.
267          Thuban will load all files with the same base name, so it doesn't          Thuban will load all files with the same base name, so it doesn't
268          matter if the Shapefile or database file is selected.          matter if the shape file or database file is selected.
269          </para>          </para>
270    
271          <para>          <para>
# Line 193  Line 275 
275          <guimenuitem>Add Image Layer</guimenuitem>          <guimenuitem>Add Image Layer</guimenuitem>
276          </menuchoice>.          </menuchoice>.
277          It is important to select a valid image file that has geographic          It is important to select a valid image file that has geographic
278          data associated with it. This can be embedded in the file itself,          data associated with it. The data can be embedded in the file itself,
279          or in another file. If geographic information cannot be found, Thuban          or in another file. If geographic information cannot be found, Thuban
280          will report an error.          will report an error.
281          </para>          </para>
# Line 202  Line 284 
284          <section><title>Navigation</title>          <section><title>Navigation</title>
285          <para>          <para>
286          The map can be explored by using the navigation tools available on          The map can be explored by using the navigation tools available on
287          the tool bar, or from the          the tool bar or from the
288          <menuchoice><guimenu>Map</guimenu></menuchoice> menu.          <menuchoice><guimenu>Map</guimenu></menuchoice> menu.
289          </para>          </para>
290          <para>          <para>
291          The ZoomIn tool          The ZoomIn tool
292          <inlinemediaobject>          <inlinemediaobject>
293          <imageobject>          <imageobject>
294          <imagedata fileref="../images/3_2_zoomin.png" format="PNG"/>          <imagedata fileref="../images/3_2_zoomin.png" format="PNG" scale="&imgscale;"/>
295          </imageobject>          </imageobject>
296          <imageobject>          <imageobject>
297          <imagedata fileref="./images/3_2_zoomin.eps" format="EPS"/>          <imagedata fileref="./images/3_2_zoomin.eps" format="EPS" scale="&imgscale;"/>
298          </imageobject>          </imageobject>
299          <textobject> <phrase>ZoomIn Tool</phrase> </textobject>          <textobject> <phrase>ZoomIn Tool</phrase> </textobject>
300          </inlinemediaobject>          </inlinemediaobject>
301          can be used to enlarge a region of the map. Clicking once on the map          enlarges a region of the map. Clicking once on the map
302          will double the magnification and center the map on the point that          will double the magnification and center the map on the point that
303          was clicked. Clicking and dragging lets the user select a region          was clicked. Clicking and dragging selects a region that will be
304          to be enlarged to fit the window.          enlarged to fit the window.
305          </para>          </para>
306          <para>          <para>
307          The ZoomOut tool          The ZoomOut tool
308          <inlinemediaobject>          <inlinemediaobject>
309          <imageobject>          <imageobject>
310          <imagedata fileref="../images/3_2_zoomout.png" format="PNG"/>          <imagedata fileref="../images/3_2_zoomout.png" format="PNG" scale="&imgscale;"/>
311          </imageobject>          </imageobject>
312          <imageobject>          <imageobject>
313          <imagedata fileref="./images/3_2_zoomout.eps" format="EPS"/>          <imagedata fileref="./images/3_2_zoomout.eps" format="EPS" scale="&imgscale;"/>
314          </imageobject>          </imageobject>
315          <textobject> <phrase>ZoomOut Tool</phrase> </textobject>          <textobject> <phrase>ZoomOut Tool</phrase> </textobject>
316          </inlinemediaobject>          </inlinemediaobject>
# Line 241  Line 323 
323          The Pan tool          The Pan tool
324          <inlinemediaobject>          <inlinemediaobject>
325          <imageobject>          <imageobject>
326          <imagedata fileref="../images/3_2_pan.png" format="PNG"/>          <imagedata fileref="../images/3_2_pan.png" format="PNG" scale="&imgscale;"/>
327          </imageobject>          </imageobject>
328          <imageobject>          <imageobject>
329          <imagedata fileref="./images/3_2_pan.eps" format="EPS"/>          <imagedata fileref="./images/3_2_pan.eps" format="EPS" scale="&imgscale;"/>
330          </imageobject>          </imageobject>
331          <textobject> <phrase>Pan Tool</phrase> </textobject>          <textobject> <phrase>Pan Tool</phrase> </textobject>
332          </inlinemediaobject>          </inlinemediaobject>
# Line 254  Line 336 
336          The Full Extent tool          The Full Extent tool
337          <inlinemediaobject>          <inlinemediaobject>
338          <imageobject>          <imageobject>
339          <imagedata fileref="../images/3_2_fullextent.png" format="PNG"/>          <imagedata fileref="../images/3_2_fullextent.png" format="PNG" scale="&imgscale;"/>
340          </imageobject>          </imageobject>
341          <imageobject>          <imageobject>
342          <imagedata fileref="./images/3_2_fullextent.eps" format="EPS"/>          <imagedata fileref="./images/3_2_fullextent.eps" format="EPS" scale="&imgscale;"/>
343          </imageobject>          </imageobject>
344          <textobject> <phrase>Full Extent Tool</phrase> </textobject>          <textobject> <phrase>Full Extent Tool</phrase> </textobject>
345          </inlinemediaobject>          </inlinemediaobject>
# Line 267  Line 349 
349          The Full Layer Extent tool          The Full Layer Extent tool
350          <inlinemediaobject>          <inlinemediaobject>
351          <imageobject>          <imageobject>
352          <imagedata fileref="../images/3_2_fulllayerextent.png" format="PNG"/>          <imagedata fileref="../images/3_2_fulllayerextent.png" format="PNG" scale="&imgscale;"/>
353          </imageobject>          </imageobject>
354          <imageobject>          <imageobject>
355          <imagedata fileref="./images/3_2_fulllayerextent.eps" format="EPS"/>          <imagedata fileref="./images/3_2_fulllayerextent.eps" format="EPS" scale="&imgscale;"/>
356          </imageobject>          </imageobject>
357          <textobject> <phrase>Full Layer Extent Tool</phrase> </textobject>          <textobject> <phrase>Full Layer Extent Tool</phrase> </textobject>
358          </inlinemediaobject>          </inlinemediaobject>
# Line 282  Line 364 
364          The Full Shape Extent tool          The Full Shape Extent tool
365          <inlinemediaobject>          <inlinemediaobject>
366          <imageobject>          <imageobject>
367          <imagedata fileref="../images/3_2_fullshapeextent.png" format="PNG"/>          <imagedata fileref="../images/3_2_fullshapeextent.png" format="PNG" scale="&imgscale;"/>
368          </imageobject>          </imageobject>
369          <imageobject>          <imageobject>
370          <imagedata fileref="./images/3_2_fullshapeextent.eps" format="EPS"/>          <imagedata fileref="./images/3_2_fullshapeextent.eps" format="EPS" scale="&imgscale;"/>
371          </imageobject>          </imageobject>
372          <textobject> <phrase>Full Shape Extent Tool</phrase> </textobject>          <textobject> <phrase>Full Shape Extent Tool</phrase> </textobject>
373          </inlinemediaobject>          </inlinemediaobject>
374          rescales the viewable region so that the currently selected          rescales the viewable region so that the currently selected
375          shape fits within the window. If the shape is a point, it is          shape fits within the window. If the shape is a point, it is
376          centered and the map is zoomed all the way in. If no shape is          centered and the map is zoomed all the way in. If no shape is
377          selected this button will be disabled.          selected this button will be disabled. This feature is especially
378            helpful when identifying an object related to a selected record
379            in a tableview (see below).
380    
381          </para>          </para>
382          </section>          </section>
383    
# Line 301  Line 386 
386          Objects on the map can be identified using the Identify tool          Objects on the map can be identified using the Identify tool
387          <inlinemediaobject>          <inlinemediaobject>
388          <imageobject>          <imageobject>
389          <imagedata fileref="../images/3_3_identify.png" format="PNG"/>          <imagedata fileref="../images/3_3_identify.png" format="PNG" scale="&imgscale;"/>
390          </imageobject>          </imageobject>
391          <imageobject>          <imageobject>
392          <imagedata fileref="./images/3_3_identify.eps" format="EPS"/>          <imagedata fileref="./images/3_3_identify.eps" format="EPS" scale="&imgscale;"/>
393          </imageobject>          </imageobject>
394          <textobject> <phrase>Identify Tool</phrase> </textobject>          <textobject> <phrase>Identify Tool</phrase> </textobject>
395          </inlinemediaobject>.          </inlinemediaobject>.
396          Clicking on an object selects that object and opens a dialog which          Clicking on an object selects that object and opens a dialog which
397          shows all the table attributes for that object. Any current selection          shows all the table attributes for that object. Any current selection
398          is lost.          is lost. Objects on the map are typically shapes and this document
399            will often refer to objects as shapes.
400          </para>          </para>
401          </section>          </section>
402    
403          <section><title>Object Labelling</title>          <section><title>Object Labeling</title>
404          <para>          <para>
405          Objects can be labelled using the Label tool          Objects can be labeled using the Label tool
406          <inlinemediaobject>          <inlinemediaobject>
407          <imageobject>          <imageobject>
408          <imagedata fileref="../images/3_3_label.png" format="PNG"/>          <imagedata fileref="../images/3_3_label.png" format="PNG" scale="&imgscale;"/>
409          </imageobject>          </imageobject>
410          <imageobject>          <imageobject>
411          <imagedata fileref="./images/3_3_label.eps" format="EPS"/>          <imagedata fileref="./images/3_3_label.eps" format="EPS" scale="&imgscale;"/>
412          </imageobject>          </imageobject>
413          <textobject> <phrase>Label Tool</phrase> </textobject>          <textobject> <phrase>Label Tool</phrase> </textobject>
414          </inlinemediaobject>.          </inlinemediaobject>.
415          Clicking on an object selects that object and opens a dialog which          Clicking on an object selects that object and opens a dialog which
416          displays the table attributes for that object. An attribute can          displays the table attributes for that object. An attribute can
417          be selected to be the label on the map. Using this tool for an          be selected to be the label on the map. The label will be placed
418          object that already has a label will remove the label.          at the center of the shape. Clicking on an object that already has
419            a label will remove the label.
420          </para>          </para>
421          </section>          </section>
422    
423          <section><title>The Legend</title>          <section><title>The Legend</title>
424            <para>
425            <inlinemediaobject>
426            <imageobject>
427            <imagedata fileref="../images/3_5_legend.png" format="PNG" scale="&imgscale;"/>
428            </imageobject>
429            <imageobject>
430            <imagedata fileref="./images/3_5_legend.eps" format="EPS" scale="&imgscale;"/>
431            </imageobject>
432            <textobject> <phrase>Legend</phrase> </textobject>
433            </inlinemediaobject>
434            </para>
435          <para>          <para>
436          The Legend provides an overview of the layers in the map. Layers          The Legend provides an overview of the layers in the map. Layers
437          that appear higher in the legend will appear ``closer'' to the user.          that appear higher in the legend will appear ``closer'' to the user.
# Line 346  Line 444 
444          <para>          <para>
445          Along the top of the legend is a toolbar which allows quick access          Along the top of the legend is a toolbar which allows quick access
446          to some of the layer manipulation options under          to some of the layer manipulation options under
447          <menuchoice> <guimenu>Map</guimenu> </menuchoice>.          <menuchoice><guimenu>Map</guimenu></menuchoice>.
448            </para>
449    
450            <para>
451            The Move Layer to Top tool
452            <inlinemediaobject>
453            <imageobject>
454            <imagedata fileref="../images/3_5_totop.png" format="PNG" scale="&imgscale;"/>
455            </imageobject>
456            <imageobject>
457            <imagedata fileref="./images/3_5_totop.eps" format="EPS" scale="&imgscale;"/>
458            </imageobject>
459            <textobject> <phrase>Move Layer to Top</phrase> </textobject>
460            </inlinemediaobject> raises the selected layer to the top of the map.
461            </para>
462    
463            <para>
464            The Move Layer Up tool
465            <inlinemediaobject>
466            <imageobject>
467            <imagedata fileref="../images/3_5_moveup.png" format="PNG" scale="&imgscale;"/>
468            </imageobject>
469            <imageobject>
470            <imagedata fileref="./images/3_5_moveup.eps" format="EPS" scale="&imgscale;"/>
471            </imageobject>
472            <textobject> <phrase>Move Layer Up</phrase> </textobject>
473            </inlinemediaobject> raises the selected layer one level.
474            </para>
475    
476            <para>
477            The Move Layer Down tool
478            <inlinemediaobject>
479            <imageobject>
480            <imagedata fileref="../images/3_5_movedown.png" format="PNG" scale="&imgscale;"/>
481            </imageobject>
482            <imageobject>
483            <imagedata fileref="./images/3_5_movedown.eps" format="EPS" scale="&imgscale;"/>
484            </imageobject>
485            <textobject> <phrase>Move Layer Down</phrase> </textobject>
486            </inlinemediaobject> lowers the selected layer one level.
487            </para>
488    
489            <para>
490            The Move Layer to Bottom tool
491            <inlinemediaobject>
492            <imageobject>
493            <imagedata fileref="../images/3_5_tobottom.png" format="PNG" scale="&imgscale;"/>
494            </imageobject>
495            <imageobject>
496            <imagedata fileref="./images/3_5_tobottom.eps" format="EPS" scale="&imgscale;"/>
497            </imageobject>
498            <textobject> <phrase>Move Layer to Bottom</phrase> </textobject>
499            </inlinemediaobject> lowers the selected layer to the bottom of the map.
500            </para>
501    
502            <para>
503            The Visible tool
504            <inlinemediaobject>
505            <imageobject>
506            <imagedata fileref="../images/3_5_visible.png" format="PNG" scale="&imgscale;"/>
507            </imageobject>
508            <imageobject>
509            <imagedata fileref="./images/3_5_visible.eps" format="EPS" scale="&imgscale;"/>
510            </imageobject>
511            <textobject> <phrase>Visible</phrase> </textobject>
512            </inlinemediaobject> shows the selected layer in the map if it was
513            hidden.
514            </para>
515    
516            <para>
517            The Invisible tool
518            <inlinemediaobject>
519            <imageobject>
520            <imagedata fileref="../images/3_5_invisible.png" format="PNG" scale="&imgscale;"/>
521            </imageobject>
522            <imageobject>
523            <imagedata fileref="./images/3_5_invisible.eps" format="EPS" scale="&imgscale;"/>
524            </imageobject>
525            <textobject> <phrase>Invisible</phrase> </textobject>
526            </inlinemediaobject> hides the selected layer in the map.
527            </para>
528    
529            <para>
530            The Properties tool
531            <inlinemediaobject>
532            <imageobject>
533            <imagedata fileref="../images/3_5_props.png" format="PNG" scale="&imgscale;"/>
534            </imageobject>
535            <imageobject>
536            <imagedata fileref="./images/3_5_props.eps" format="EPS" scale="&imgscale;"/>
537            </imageobject>
538            <textobject> <phrase>Properties</phrase> </textobject>
539            </inlinemediaobject> opens the layer's properties dialog box.
540          Double-clicking on a layer or a group of a layer will open the          Double-clicking on a layer or a group of a layer will open the
541          properties dialog for that layer.          properties dialog for that layer.
542          </para>          </para>
543    
544            <para>
545            Along the bottom of the legend is the scalebar. The scalebar
546            will be available if there are any layers and the  map has a
547            projection set.
548            </para>
549            </section>
550    
551            <section><title>Exporting</title>
552            <para>
553            Under Windows, maps can be exported in Enhanced Metafile format
554            (<varname>.wmf</varname>)
555            from
556            <menuchoice>
557            <guimenu>Map</guimenu>
558            <guimenuitem>Export</guimenuitem>
559            </menuchoice> for use in reports, presentations, or further
560            modification. The current map view, legend, and, if available,
561            scalebar are exported. Under other platforms this option is not
562            available. Clicking this menu item open a file selection dialog
563            that lets the user select a location to export the map.
564            </para>
565          </section>          </section>
566    
567          <section><title>Printing</title>          <section><title>Printing</title>
# Line 359  Line 570 
570          <menuchoice>          <menuchoice>
571          <guimenu>Map</guimenu>          <guimenu>Map</guimenu>
572          <guimenuitem>Print</guimenuitem>          <guimenuitem>Print</guimenuitem>
573          </menuchoice>. A standard printing dialog will open allowing the          </menuchoice>. The current map view, legend, and, if available,
574          user to configure the printer.          scalebar are printed. A standard printing dialog will open allowing
575            the user to configure the printer. This dialog will differ depending
576            on which platform Thuban is running.
577          </para>          </para>
578          </section>          </section>
579    
580    </chapter>    </chapter>
581    
582    <chapter><title>Layer Management</title>    <chapter><title>Layer Management</title>
# Line 374  Line 588 
588          There are two types of layers supported by Thuban: shape layers and          There are two types of layers supported by Thuban: shape layers and
589          image layers. Shape layers consist of vector based shapes with          image layers. Shape layers consist of vector based shapes with
590          geo-referenced coordinates. There are three types of supported          geo-referenced coordinates. There are three types of supported
591          shapes: polygons, lines, and points. Image layers can be any image          shapes: polygons, lines (arc), and points. Image layers can be any image
592          file format supported by GDAL. The images must have geographic          file format supported by the Geo-spatial Data Abstraction Library
593          coordinate data either embedded within the file, or in a seperate          (GDAL). The images must have geographic
594            coordinate data either embedded within the file or in a separate
595          file that is in the same directory as the image file. GeoTIFF files          file that is in the same directory as the image file. GeoTIFF files
596          work very well with Thuban and were designed specifically to be image          work very well with Thuban and were designed specifically to be image
597          layers in GIS programs.          layers in GIS programs.
598          </para>          </para>
599            <para>
600            All actions in the
601            <menuchoice>
602            <guimenu>Layer</guimenu>
603            </menuchoice> menu act on the currently selected layer in the legend.
604            </para>
605          </section>          </section>
606    
607          <section><title>Properties</title>          <section><title>Properties</title>
608          <para>          <para>
609          Each shape in a shape layer can have various properties which control          To view the properties for a layer it must first be selected in the
610          how it is drawn on the map. Polygons and points can be drawn with an          legend. The menu option
611          outline color and a fill color, while lines have only a line color.          <menuchoice>
612            <guimenu>Layer</guimenu>
613            <guimenuitem>Properties</guimenuitem>
614            </menuchoice> opens a dialog that displays a layer's properties.
615            All layers have a title which can be modified in the text field
616            provided. The type of layer is also shows. If the type is a type
617            of shape (polygon, arc, point) the classification table will be
618            shown. Image layers have no other properties other than title
619            and type.
620            </para>
621            <para>
622            <screenshot>
623            <screeninfo>Properties Window</screeninfo>
624            <mediaobject>
625            <imageobject><imagedata fileref="../images/4_2_layer_properties.png" format="PNG" scale="&imgscale;"/></imageobject>
626            <imageobject><imagedata fileref="./images/4_2_layer_properties.eps" format="EPS" scale="&imgscale;"/></imageobject>
627            <textobject><phrase>Properties Window</phrase></textobject>
628            <caption><para>The Properties Window for a Shape Layer</para></caption>
629            </mediaobject>
630            </screenshot>
631            </para>
632            <para>
633            <screenshot>
634            <screeninfo>Properties Window</screeninfo>
635            <mediaobject>
636            <imageobject><imagedata fileref="../images/4_2_raster_layer_properties.png" format="PNG" scale="&imgscale;"/></imageobject>
637            <imageobject><imagedata fileref="./images/4_2_raster_layer_properties.eps" format="EPS" scale="&imgscale;"/></imageobject>
638            <textobject><phrase>Properties Window</phrase></textobject>
639            <caption><para>The Properties Window for an Image Layer</para></caption>
640            </mediaobject>
641            </screenshot>
642          </para>          </para>
643          </section>          </section>
644    
# Line 396  Line 647 
647          Sometimes it is not desirable to view all layers at the same time.          Sometimes it is not desirable to view all layers at the same time.
648          Some layers may take a long time to draw and so while navigating          Some layers may take a long time to draw and so while navigating
649          around the map the user may not want to wait for the map to redraw          around the map the user may not want to wait for the map to redraw
650          each time the map is changed. Each layer can be independently          all the layers each time the map is changed. Each layer can be
651          turned on or off using the          independently turned on or off using the
652          <menuchoice>          <menuchoice>
653          <guimenu>Layer</guimenu>          <guimenu>Layer</guimenu>
654          <guimenuitem>Show</guimenuitem>          <guimenuitem>Show</guimenuitem>
# Line 410  Line 661 
661          </para>          </para>
662          </section>          </section>
663    
         <section><title>Sequence</title>  
         <para>  
         </para>  
         </section>  
   
664          <section><title>Duplication</title>          <section><title>Duplication</title>
665          <para>          <para>
666          Layers and all their properties, including classifications, can          Layers and all their properties, including classifications, can
# Line 424  Line 670 
670          <guimenuitem>Duplicate</guimenuitem>          <guimenuitem>Duplicate</guimenuitem>
671          </menuchoice>. Duplicating a layer is useful if the user wishes          </menuchoice>. Duplicating a layer is useful if the user wishes
672          to model a layer in several different ways. Even though the layers          to model a layer in several different ways. Even though the layers
673          overlap by carefully selecting the shape properties it is possible          overlap, by carefully selecting the shape properties it is possible
674          to display several pieces of information at once. For example, one          to display several pieces of information at once. For example, one
675          copy of a roads layer may be classified on a length property and          copy of a roads layer may be classified on a length property and
676          another copy may be classified on a type property. if the length          another copy may be classified on a type property. If the length
677          property was expressed with color and the type property expressed          property was expressed with color and the type property expressed
678          with line thickness then it would be possible to view both          with line thickness then it would be possible to view both
679          classifications by placing the type property copy over the          classifications by placing the type property copy over the
# Line 445  Line 691 
691      cannot be classified.      cannot be classified.
692      </para>      </para>
693      <para>      <para>
694      A classification consists of a number of groups, with each group      A classification consists of a number of groups, each group
695      having a value or range of values to match against, and symbol      having a value or range of values to match against, and symbol
696      properties which control how a shape is drawn on the map. The user      properties which control how a shape is drawn on the map. The user
697      selects which field in the table is used by the classification and      selects which field in the table is used by the classification and
# Line 458  Line 704 
704      <para>      <para>
705      A layer always has a classification. When a new layer is added to the      A layer always has a classification. When a new layer is added to the
706      map, a default classification is created with the DEFAULT group. This      map, a default classification is created with the DEFAULT group. This
707      group cannot be removed. Every shape in the layer, regardless of its      group cannot be removed but can be hidden (see below). Every shape in the
708      attributes, will match this group.      layer, regardless of its attributes, will match this group if no other
709        group matches.
710      </para>      </para>
711    
712          <section><title>Editing Classifications</title>          <section><title>Editing Classifications</title>
# Line 476  Line 723 
723          button.          button.
724          </para>          </para>
725          <para>          <para>
726            To apply the changes to the map the user can click
727            either <guibutton>Try</guibutton> or <guibutton>OK</guibutton>.
728            <guibutton>Try</guibutton> will not close the dialog box, allowing
729            the user to see how the classification changes the map.
730            <guibutton>Revert</guibutton> will undo the last classification applied
731            to the map. <guibutton>OK</guibutton> will commit the changes and
732            close the dialog. The user will be unable to undo the changes.
733            <guibutton>Close</guibutton> simply closes the dialog box. If any
734            changes have not been applied with <guibutton>Try</guibutton> the
735            changes will not be applied to the map.
736            </para>
737            <para>
738            <screenshot>
739            <screeninfo>Properties Window</screeninfo>
740            <mediaobject>
741            <imageobject><imagedata fileref="../images/5_classification.png" format="PNG" scale="&imgscale;"/></imageobject>
742            <imageobject><imagedata fileref="./images/5_classification.eps" format="EPS" scale="&imgscale;"/></imageobject>
743            <textobject><phrase>Properties Window</phrase></textobject>
744            <caption><para>The Properties Window with Classifications</para></caption>
745            </mediaobject>
746            </screenshot>
747            </para>
748            <para>
749          The order of the groups in the classification is significant          The order of the groups in the classification is significant
750          except for the DEFAULT group, which remains at the top. When shapes          except for the DEFAULT group, which remains at the top. When shapes
751          are matched against groups the matching begins at the first group          are matched against groups the matching begins at the first group
752          other than the DEFAULT group so that groups higher in the list will          after the DEFAULT group so that groups higher in the list will
753          be checked first. Matching for a          be checked first. Matching for a
754          given shape will stop at the first group that matches. The user can          given shape will stop at the first group that matches. The user can
755          use <guibutton>Move Up</guibutton> and <guibutton>Move Down</guibutton>          use <guibutton>Move Up</guibutton> and <guibutton>Move Down</guibutton>
756          to change the order of the groups. The DEFAULT group will always          to change the order of the groups. The DEFAULT group will always
757          match a shape that hasn't matched another group.          match a shape that hasn't matched another group.
758          </para>          </para>
759          <para>              <section><title>Visible</title>
760          The Value column of the classification table is the value that will              <para>
761          be matched when the map is being drawn. The type of data that can              The Visible column has check-boxes that determine whether a
762          entered into this field depends on the type of data of the              classification group will be displayed in the legend. This is
763          classification field.              useful if the user knows that the groups completely cover
764          </para>              the data set and don't want the DEFAULT group to be displayed
765          <para>              in the legend and on a printout.
766          If the field is of type Text, anything entered              </para>
767          into the field is valid. The text will be compared literally to the          </section>
768          value of the shape attribute, including case sensitivity.              <section><title>Symbols</title>
769          If the type is Integer, then any valid integer may be entered. In              <para>
770          addition, with special syntax, a range of values can be entered.              Each type of shape has its own type of symbol. Thuban supports three
771          A range from <varname>start</varname> to <varname>end</varname>              types of shapes: polygons, lines, and points. Polygons and points
772          inclusive is specifed like this: <literal>[start;end]</literal>.              have outline and fill color, while lines have only line color. Each
773          The exclusive range is specified like this:              group has associated symbol properties. To edit the symbol
774          <literal>]start;end[</literal>. Ranges can include infinity like              properties for a group the user can double click on the Symbol
775          this: <literal>[-oo;oo]</literal>. Field types can also be of type              column or select a group and click the
776          Decimal. They represent any rational number and can be used in ranges              <guibutton>Edit Symbol</guibutton> button.
777          as well.              </para>
778          </para>              </section>
779          </section>          <section><title>Value</title>
780                <para>
781          <section><title>Symbols</title>              The Value column of the classification table is the value that will
782          <para>              be matched when the map is being drawn. The type of data that can
783          Each type of shape has its own type of symbol. Thuban supports three              entered into this field depends on the type of data of the
784          types of shapes: polygons, lines, and points. Polygons and points have              classification field.
785          outline and fill color, while lines have only line color. Each group              </para>
786          has associated symbol properties. To edit the symbol properties for a              <para>
787          group the user can double click on the Symbol column or select a              If the field is of type Text, anything entered
788          group and click the <guibutton>Edit Symbol</guibutton> button.              into the field is valid. The text will be compared literally to the
789          </para>              value of the shape attribute, including case sensitivity.
790                If the type is Integer, then any valid integer may be entered. In
791                addition, with special syntax, a range of values can be entered.
792                A range from <varname>start</varname> to <varname>end</varname>
793                inclusive is specified like this: <literal>[start;end]</literal>.
794                The exclusive range is specified like this:
795                <literal>]start;end[</literal>. Ranges can include infinity like
796                this: <literal>[-oo;oo]</literal>. Field types can also be of type
797                Decimal. They represent any rational number and can be used in
798                ranges as well.
799                </para>
800                </section>
801                <section><title>Label</title>
802                <para>
803                By default, the text that is displayed for a group in the legend
804                is the value for that group. The label can substitute a more
805                descriptive term in the legend.
806                </para>
807            </section>
808          </section>          </section>
809    
810          <section><title>Generating Classes</title>          <section><title>Generating Classes</title>
811          <para>          <para>
812            <screenshot>
813            <screeninfo>Generate Class</screeninfo>
814            <mediaobject>
815            <imageobject><imagedata fileref="../images/5_3_genclass.png" format="PNG" scale="&imgscale;"/></imageobject>
816            <imageobject><imagedata fileref="./images/5_3_genclass.eps" format="EPS" scale="&imgscale;"/></imageobject>
817            <textobject><phrase>Generate Class</phrase></textobject>
818            <caption><para>The Generate Classifications Dialog</para></caption>
819            </mediaobject>
820            </screenshot>
821            </para>
822            <para>
823          Creating a classification by hand can be tedious.          Creating a classification by hand can be tedious.
824          Thuban, therefore, provides a means of generating an entire          Thuban, therefore, provides a means of generating an entire
825          classification at once while still giving the user control over          classification at once while still giving the user control over
826          how it appears. Clicking <guibutton>Generate Class</guibutton>          how it appears. Clicking <guibutton>Generate Class</guibutton>
827          opens the <varname>Generate Classification</varname> dialog.          opens the <varname>Generate Classification</varname> dialog.
828          Under the <varname>Generate</varname> pulldown there are at most          Under the <varname>Generate</varname> pull down there are at most
829          three different ways to generate classifications:          three different ways to generate classifications:
830          Unique Values, Unique Distribution, and Quantiles. Some options          Unique Values, Uniform Distribution, and Quantiles. Some options
831          may not be available if they data type for the field does not          may not be available if the data type for the field does not
832          support them. For instance, <varname>Unique Distribution</varname>          support them. For instance, <varname>Uniform Distribution</varname>
833          doesn't make sense for a Text field.          doesn't make sense for a Text field.
834          </para>          </para>
835          <para>          <para>
836          For every way of generating a classification, a color scheme must          For every way of generating a classification, a color scheme must
837          be selected. Thuban provides several different color schemes that          be selected. Thuban provides several different color schemes that
838          affect how the group properties change over the classification.          affect how the group properties change over the classification.
839            It may be desirable that only certain properties change over the
840            classification. If the shape type is a polygon or a point then
841            the <guibutton>Fix Border Color</guibutton> option will be available.
842            This allows the user to select a border color for all classification
843            groups.
844          It is also possible to create a custom color scheme. Selecting          It is also possible to create a custom color scheme. Selecting
845          this option will display two symbols: the one of the left has the          this option will display two symbols: the one of the left has the
846          properties of the first group and the one on the right has the          properties of the first group and the one on the right has the
847          properties of the last group. Thuban will interpolate between these          properties of the last group. Thuban will interpolate between these
848          two properties to generate the other groups.          two properties to generate the other groups.
849            <screenshot>
850            <screeninfo>Custom Color Scheme</screeninfo>
851            <mediaobject>
852            <imageobject><imagedata fileref="../images/5_2_custom_ramp.png" format="PNG" scale="&imgscale;"/></imageobject>
853            <imageobject><imagedata fileref="./images/5_2_custom_ramp.eps" format="EPS" scale="&imgscale;"/></imageobject>
854            <textobject><phrase>Custom Color Scheme</phrase></textobject>
855            <caption><para>Custom Color Scheme</para></caption>
856            </mediaobject>
857            </screenshot>
858          </para>          </para>
859          <para>          <para>
860          The Unique Values option lets the user select specific values that          The Unique Values option lets the user select specific values that
# Line 551  Line 864 
864          right. Each list can be sorted or reversed for easier searching.          right. Each list can be sorted or reversed for easier searching.
865          The classification that is generated will be in the same order as          The classification that is generated will be in the same order as
866          the list on the right.          the list on the right.
867            <screenshot>
868            <screeninfo>Unique Values</screeninfo>
869            <mediaobject>
870            <imageobject><imagedata fileref="../images/5_2_unique_values.png" format="PNG" scale="&imgscale;"/></imageobject>
871            <imageobject><imagedata fileref="./images/5_2_unique_values.eps" format="EPS" scale="&imgscale;"/></imageobject>
872            <textobject><phrase>Unique Values</phrase></textobject>
873            <caption><para>Unique Values Classification</para></caption>
874            </mediaobject>
875            </screenshot>
876          </para>          </para>
877          <para>          <para>
878          The Unique Distribution option creates a user specified number of          The Uniform Distribution option creates a user specified number of
879          groups of ranges such that each range covers equal intervals. The          groups of ranges such that each range covers equal intervals. The
880          minimum and maximum values can automatically be retrieved from the          minimum and maximum values can automatically be retrieved from the
881          table by clicking <guibutton>Retrieve From Table</guibutton>. The          table by clicking <guibutton>Retrieve From Table</guibutton>. The
882          stepping is how large each interval is. Adjusting this value will          stepping is how large each interval is. Adjusting this value will
883          automatically recalculate how many groups is appropriate.          automatically recalculate how many groups is appropriate.
884            <screenshot>
885            <screeninfo>Uniform Distribution</screeninfo>
886            <mediaobject>
887            <imageobject><imagedata fileref="../images/5_2_uniform_dist.png" format="PNG" scale="&imgscale;"/></imageobject>
888            <imageobject><imagedata fileref="./images/5_2_uniform_dist.eps" format="EPS" scale="&imgscale;"/></imageobject>
889            <textobject><phrase>Uniform Distribution</phrase></textobject>
890            <caption><para>Uniform Distribution Classification</para></caption>
891            </mediaobject>
892            </screenshot>
893          </para>          </para>
894          <para>          <para>
895          The Quantiles option generates ranges based on the number items          The Quantiles option generates ranges based on the number of items
896          in the input set. For example, by specifying 5 groups Thuban will          in the table. For example, by specifying five groups Thuban will
897          generate groups with appropriate ranges such that 20% of the table          generate five groups with appropriate ranges such that 20% of the table
898          data is in each group. If it is impossible to generate exact          data is in each group. If it is impossible to generate exact
899          grouping, Thuban will issue a warning but allow the user to continue.          groupings, Thuban will issue a warning but allow the user to continue.
900            <screenshot>
901            <screeninfo>Quantiles</screeninfo>
902            <mediaobject>
903            <imageobject><imagedata fileref="../images/5_2_quantiles.png" format="PNG" scale="&imgscale;"/></imageobject>
904            <imageobject><imagedata fileref="./images/5_2_quantiles.eps" format="EPS" scale="&imgscale;"/></imageobject>
905            <textobject><phrase>Quantiles</phrase></textobject>
906            <caption><para>Quantiles Classification</para></caption>
907            </mediaobject>
908            </screenshot>
909          </para>          </para>
910          </section>          </section>
911    </chapter>    </chapter>
# Line 574  Line 914 
914      <para>      <para>
915      Projections control how the geographic data is displayed on the screen.      Projections control how the geographic data is displayed on the screen.
916      If multiple layers are loaded into Thuban where the geographic data      If multiple layers are loaded into Thuban where the geographic data
917      is in a different projection system, then the user must tell Thuban      is in a different projection system, then the user must specify a
918      which projection each layer has. The user must also tell Thuban which      projection for each layer. The user must also tell Thuban which
919      projection the map is in. This can be the same as the layers or a different      projection the map is in. This can be the same as the layers or a different
920      projection in which case the layers are reprojected into that space.      projection in which case the layers are reprojected into that space.
921      The map projection can be set using      The map projection can be set using
# Line 587  Line 927 
927      <guimenu>Layer</guimenu>      <guimenu>Layer</guimenu>
928      <guimenuitem>Projection</guimenuitem>      <guimenuitem>Projection</guimenuitem>
929      </menuchoice>.      </menuchoice>.
930        <screenshot>
931        <screeninfo>Projection Window</screeninfo>
932        <mediaobject>
933        <imageobject><imagedata fileref="../images/6_projection.png" format="PNG" scale="&imgscale;"/></imageobject>
934        <imageobject><imagedata fileref="./images/6_projection.eps" format="EPS" scale="&imgscale;"/></imageobject>
935        <textobject><phrase>Projection Window</phrase></textobject>
936        <caption><para>The Projection Window</para></caption>
937        </mediaobject>
938        </screenshot>
939      </para>      </para>
940      <para>      <para>
941      Thuban is distributed with a sample collection of projections. The      Thuban is distributed with a sample collection of projections. The
942      user can create new projections and make them available to all      user can create new projections and make them available to all
943      future Thuban sessions. They may also be exported and imported so      future Thuban sessions. They may also be exported and imported so
944      that custom projections can be distributed to others.      that custom projections can be distributed.
945      </para>      </para>
946          <section><title>Selecting a Projection</title>          <section><title>Selecting a Projection</title>
947          <para>          <para>
948          The available projections are listed on the left. If the layer          The available projections are listed on the left. If the layer
949          or map already has a projection it will be initially highlighted          or map already has a projection it will initially be highlighted
950          and will end with <varname>(current)</varname>. Selecting          and will end with <varname>(current)</varname>. Selecting
951          <varname>None</varname> will cause Thuban to use the data as          <varname>&lt;None&gt;</varname> will cause Thuban to use the data as
952          it appears in the source file and will not use a projection.          it appears in the source file and will not use a projection.
953          </para>          </para>
954      </section>      </section>
# Line 608  Line 957 
957          Whenever a projection is selected from the list its properties          Whenever a projection is selected from the list its properties
958          are displayed on the right. These properties can be changed          are displayed on the right. These properties can be changed
959          and the changes saved to the selected projection using          and the changes saved to the selected projection using
960          the <guibutton>Update</guibutton>. Only a projection that comes          <guibutton>Update</guibutton>. Only a projection that comes
961          from a file can be updated, so if the current layer's projection          from a file can be updated, so if the current layer's projection
962          is selectd, <guibutton>Update</guibutton> will be disabled.          is selected, <guibutton>Update</guibutton> will be disabled.
963          The <guibutton>Add to List</guibutton> adds the projection to the          <guibutton>Add to List</guibutton> adds the projection to the
964          list of available projections as a new entry, and thus make it          list of available projections as a new entry, and thus makes it
965          available to future Thuban sessions. Clicking <guibutton>New</guibutton>          available to future Thuban sessions. Clicking <guibutton>New</guibutton>
966          will create an entirely new, empty projection. The          will create an entirely new, empty projection. The
967          <guibutton>Remove</guibutton> button will permanantly remove a          <guibutton>Remove</guibutton> button will permanently remove a
968          projection from the list of available projections.          projection from the list of available projections.
969          </para>          </para>
970            <para>
971            To apply the selected projection to the map the user can click
972            either <guibutton>Try</guibutton> or <guibutton>OK</guibutton>.
973            <guibutton>Try</guibutton> will not close the dialog box, allowing
974            the user to see how the projeciton changes the map.
975            <guibutton>Revert</guibutton> will undo the last projection applied
976            to the map. <guibutton>OK</guibutton> will commit the changes and
977            close the dialog. The user will be unable to undo the changes.
978            <guibutton>Close</guibutton> simply closes the dialog box. If no
979            selection has been applied with <guibutton>Try</guibutton> the
980            selection will not be applied to the map.
981            </para>
982      </section>      </section>
983          <section><title>Importing/Exporting Projections</title>          <section><title>Importing/Exporting Projections</title>
984          <para>          <para>
985          The projections that appear in the list of available projections          The projections that appear in the list of available projections
986          can be exported to another file that the user chooses. By selecting          can be exported to another file that the user chooses. By selecting
987          one or more projections and clicking <guibutton>Export</guibutton>          one or more projections and clicking <guibutton>Export</guibutton>
988          the user will be able to select a file to store those projections.          the user will be able to select a file in which to store those
989            projections.
990          The file can then be distributed to other Thuban users. To import          The file can then be distributed to other Thuban users. To import
991          a projection file the user can click <guibutton>Import</guibutton>.          a projection file the user can click <guibutton>Import</guibutton>.
992          The imported projections are added to the list and are then available          The imported projections are added to the list and are then available
993          to the current session and any future Thuban session.          to the current session and any future Thuban sessions.
994          </para>          </para>
995      </section>      </section>
996    </chapter>    </chapter>
997    
998    <chapter><title>Table Management</title>    <chapter><title>Table Management</title>
999      <para>      <para>
1000              Thuban distinguishes two different types of tables: Attribute tables      Thuban distinguishes two different types of tables: Attribute tables
1001              (which belong to a layer) and usual data tables. Both provide in      (which belong to a layer) and normal data tables. Both provide
1002          general the same functionality with the difference that actions on an          the same general functionality with the difference that actions on an
1003              attribute table might also effect the map display.      attribute table might also effect the map display.
1004      </para>      </para>
1005    
1006      <section><title>Table View</title>      <section><title>Table View</title>
1007        <para>          <para>
1008            <screenshot>
1009            <screeninfo>Table View</screeninfo>
1010            <mediaobject>
1011            <imageobject><imagedata fileref="../images/7_1_table_view.png" format="PNG" scale="&imgscale;"/></imageobject>
1012            <imageobject><imagedata fileref="./images/7_1_table_view.eps" format="EPS" scale="&imgscale;"/></imageobject>
1013            <textobject><phrase>Table View</phrase></textobject>
1014            <caption><para>The Table View</para></caption>
1015            </mediaobject>
1016            </screenshot>
1017            </para>
1018            <para>
1019          Thuban provides a standard dialog to display table contents, the          Thuban provides a standard dialog to display table contents, the
1020          Table View. The view falls into five sections: The title, selections,          Table View. The view has five sections: The title, selections,
1021          the table grid, export functions and the status bar.          the table grid, export functions, and the status bar.
1022        </para>          </para>
1023        <para>          <para>
1024          The title bar identifies the table with it's name.          The title bar identifies the table with its name.
1025        </para>          </para>
1026        <para>          <para>
1027          The functions box let the user perform simple analysis on the data          The selections box let the user perform simple analysis on the data
1028          based on comparisons: First choice must be a field identifier of the          based on comparisons: The first choice must be a field identifier of
1029          table, the second choice determines the type of comparison. The third          the table, the second choice determines the type of comparison. The
1030          choice can be either a specific value (interpreted as numerical          third choice can be either a specific value (interpreted as numerical
1031          or string depending on the type of the first field) or a second field          or string depending on the type of the first field) or a second field
1032          identifier. Thus you can perform analysis like selecting all          identifier. Thus you can perform analysis like selecting all
1033          records where "population > 10000" or          records where <literal>population > 10000</literal> or
1034          "cars_per_habitants <  bike_per_habitants" (note that the field names          <literal>cars_per_inhabitant < bikes_per_inhabitant</literal>
1035          are only explanatory, the currently considered dbase files allow only          (note that the field names are only explanatory, the dBase files
1036          11 character field names).          allow only 11 character field names).
1037                  
1038          Selections can be combined, either by applying a selection only on          Selections can be combined either by applying a selection only on
1039          a previously selected set of records or by adding the results of a          a previously selected set of records or by adding the results of a
1040          selection to a previous set. The default is that a selection replaces          selection to a previous set. The default is that a selection replaces
1041          earlier results.          earlier results.
1042        </para>          </para>
1043        <para>          <para>
1044          The table grid shows the contents of the table (a record per column),          The table grid shows the contents of the table (one record per row),
1045          with highlighted selection results. Columns and rows can be resized.          with highlighted selection results. Columns and rows can be resized.
1046        </para>          </para>
1047        <para>          <para>
1048          The contents of a table can be exported into a file, either dbase          The contents of a table can be exported into a file, either dBase
1049          format (DBF) or comma seperated values (CSV). The 'Export' button          format (DBF) or comma separated values (CSV). The
1050            <guibutton>Export</guibutton> button
1051          raises a file dialog to specify a path and file name, the export type          raises a file dialog to specify a path and file name, the export type
1052          is determined by the file extension (either .dbf or .csv).          is determined by the file extension (either .dbf or .csv).
1053    
1054          The 'Export Selection' button works similar but exports only the          The <guibutton>Export Selection</guibutton> button works similarly
1055          selected records.          but exports only the selected records.
1056    
1057          The 'Close' button closes the table view. In difference to the          The <guibutton>Close</guibutton> button closes the table view window.
1058          menu item 'Close' just the dialog is closed, the table is still loaded          This is different from the menu item
1059          in Thuban.          <menuchoice>
1060        </para>          <guimenu>Table</guimenu>
1061        <para>          <guimenuitem>Close</guimenuitem>
1062            </menuchoice> which unloads the table from Thuban.
1063            </para>
1064            <para>
1065          The status bar displays some statistics about the table and optional          The status bar displays some statistics about the table and optional
1066          selection results.          selection results.
1067        </para>          </para>
1068      </section>      </section>
1069    
1070      <section><title>General Functionality (Menu Table)</title>      <section><title>General Functionality (Menu Table)</title>
1071        <para>          <para>
1072          The general functions affect all tables open in Thuban. Attribute          The general functions affect all tables open in Thuban. Attribute
1073          tables are considered as here as usual data tables (with the exception          tables are considered here as normal data tables (with the exception
1074          that they cannot be closed).          that they cannot be closed).
       </para>  
       <section><title>Open</title>  
         <para>  
           The 'Open' item raises a file dialog to let you select a  
           dbase file from the file system to be loaded into Thuban read-only.  
           On OK the selected file is loaded and a table view is opened.  
         </para>  
       </section>  
   
       <section><title>Close</title>  
         <para>  
           The 'Close' item raises a dialog listing the currently open  
           data tables (loaded via the 'Open' functionality'). You can select  
           tables which are dereferenced on confirmation. Since tables are  
           opened read-only the contents of the tables are not affected.  
   
           A still open table view is closed as well.  
   
           Tables used in a join can not be closed.  
         </para>  
       </section>  
   
       <section><title>Rename</title>  
         <para>  
           Changes the table title.  
1075          </para>          </para>
1076        </section>          <section><title>Open</title>
1077                <para>
1078        <section><title>Show</title>              The
1079          <para>              <menuchoice>
1080            The 'Show' item raises a list of available tables (explicitly loaded,           attribute tables, results of a join). Selected tables are show in              <guimenu>Table</guimenu>
1081            tables views on 'OK'.                        <guimenuitem>Open</guimenuitem>
1082          </para>              </menuchoice>
1083        </section>              item raises a file dialog to let you select a
1084                dBase file from the file system to be loaded into Thuban read-only.
1085        <section><title>Join</title>              On <guibutton>OK</guibutton> the selected file is loaded and a
1086          <para>              table view is opened.
1087            The 'Join' item raises a dialog to specify the two tables to be              </para>
1088            joined. The join results in a new table named 'Join of "left table"          </section>
1089            and "right table"'.  
1090            <section><title>Close</title>
1091            The dialog let you select the two tables to be joined and the two              <para>
1092            fields the join has to be performed on. By default the new              The
1093            table contains only those records which are mathced by the join.              <menuchoice>
1094                <guimenu>Table</guimenu>
1095            If you want to preserve the records of the left table you can perform              <guimenuitem>Close</guimenuitem>
1096            an outer join. The fields from the right table for records not              </menuchoice>
1097            matched by the join are filled with <varname>None</varname> in this              item raises a dialog listing the currently open
1098            case.              data tables
1099          </para>              (loaded via
1100        </section>              <menuchoice>
1101                <guimenu>Table</guimenu>
1102                <guimenuitem>Open</guimenuitem>
1103                </menuchoice>). Selected tables are dereferenced on confirmation.
1104                Since tables are opened read-only the contents of the tables are
1105                not affected.
1106    
1107                Any open views of the tables are closed as well.
1108    
1109                Tables used in a join cannot be closed.
1110                </para>
1111            </section>
1112    
1113            <section><title>Rename</title>
1114                <para>
1115                <menuchoice>
1116                <guimenu>Table</guimenu>
1117                <guimenuitem>Rename</guimenuitem>
1118                </menuchoice> changes the table title.
1119                </para>
1120            </section>
1121    
1122            <section><title>Show</title>
1123                <para>
1124                The
1125                <menuchoice>
1126                <guimenu>Table</guimenu>
1127                <guimenuitem>Show</guimenuitem>
1128                </menuchoice>
1129                item raises a list of available tables (explicitly
1130                loaded, attribute tables, results of a join). Selected tables are
1131                show in tables views on <guibutton>OK</guibutton>.
1132                </para>
1133            </section>
1134    
1135            <section><title>Join</title>
1136                <para>
1137                <screenshot>
1138                <screeninfo>Join Tables</screeninfo>
1139                <mediaobject>
1140                <imageobject><imagedata fileref="../images/7_2_5_join.png" format="PNG" scale="&imgscale;"/></imageobject>
1141                <imageobject><imagedata fileref="./images/7_2_5_join.eps" format="EPS" scale="&imgscale;"/></imageobject>
1142                <textobject><phrase>Join Tables</phrase></textobject>
1143                <caption><para>The Join Tables Dialog</para></caption>
1144                </mediaobject>
1145                </screenshot>
1146                </para>
1147                <para>
1148                The
1149                <menuchoice>
1150                <guimenu>Table</guimenu>
1151                <guimenuitem>Join</guimenuitem>
1152                </menuchoice>
1153                item raises a dialog to specify the two tables to be
1154                joined. The join results in a new table named 'Join of "left table"
1155                and "right table"'.
1156    
1157                The dialog lets you select the two tables to be joined and the two
1158                fields the join has to be performed on. By default, the new
1159                table contains only those records which are matched by the join.
1160    
1161                If you want to preserve the records of the left table you can
1162                perform an outer join. The fields from the right table for records
1163                not matched by the join are filled with <varname>None</varname> in
1164                this case.
1165                </para>
1166            </section>
1167    
1168      </section>      </section>
1169      <section><title>Attribute Tables</title>      <section><title>Attribute Tables</title>
     <para>  
             To clearly separate between both types, Thuban provides functionality  
             regarding the attribute tables under the Layer menu.  
     </para>  
   
       <section><title>Show Table</title>  
         <para>  
           Opens the attribute table of the currently active layer in a table  
           view.  
   
           In addition to the functionality described above selections  
           affect also the map display: objects related to selected records  
           are highlighted.  
         </para>  
       </section>  
   
       <section><title>Join Table</title>  
1170          <para>          <para>
1171             In difference to the join described above the join results not in a              To clearly separate between both types of tables (data and
1172            attribute), Thuban provides functionality regarding the attribute
1173            tables under the <menuchoice><guimenu>Layer</guimenu></menuchoice> menu.
1174            </para>
1175    
1176            <section><title>Show Table</title>
1177                <para>
1178                <menuchoice>
1179                <guimenu>Layer</guimenu>
1180                <guimenuitem>Show Table</guimenuitem>
1181                </menuchoice>
1182                opens the attribute table of the currently active layer in a table
1183                view.
1184    
1185                In addition to the functionality described above selections
1186                affect also the map display: objects related to selected records
1187                are highlighted.
1188                </para>
1189            </section>
1190    
1191            <section><title>Join Table</title>
1192                <para>
1193                Unlike the join described above, the join does not result in a
1194              new table. The attribute table of the currently active layer is the              new table. The attribute table of the currently active layer is the
1195              left table and other tables are join to this table. Results of the              left table and other tables are joined to this table. The results of
1196              join in turn are available for classifications.              the join are available for classification.
1197    
1198              As a consequence of the above the join cannot result in less              As a consequence, the join cannot result in fewer
1199              records than the source attribute table. You are warned if the              records than the source attribute table. The user is warned if the
1200              right table does not fulfill this constraint. Use an outer join              right table does not fulfill this constraint. An outer join must be
1201              in such cases.              used in such cases.
1202          </para>              </para>
1203        </section>          </section>
1204    
1205        <section><title>Unjoin Table</title>          <section><title>Unjoin Table</title>
1206          <para>              <para>
1207              As said above, a usual table can not be closed while still used in              As said above, a normal table cannot be closed while it is still
1208              a join. While the join table resulting from a join of usual tables              used in a join. While the joined table resulting from a join of
1209              can be simply closed (and therewith dereferences the source tables)              normal tables can be simply closed (and thereby dereferencing
1210              this is not possible for attribute tables.              the source tables), this is not possible for attribute tables.
1211    
1212              Hence joins on attribute tables must be solved explicitely. This is              Hence joins on attribute tables must be solved explicitly. This is
1213              what the 'Unjoin' item is used for: The last join for the currently              what the
1214                <menuchoice>
1215                <guimenu>Layer</guimenu>
1216                <guimenuitem>Unjoin Table</guimenuitem>
1217                </menuchoice>
1218                item is used for: The last join for the currently
1219              active layer is solved.              active layer is solved.
1220          </para>              </para>
1221        </section>          </section>
   
1222      </section>      </section>
1223    </chapter>    </chapter>
1224    
1225    <chapter><title>Trouble Shooting</title>    <chapter><title>Trouble Shooting</title>
1226      <para>      <para>
1227        Here are a few problems that users have encountered when first using Thuban.
1228      </para>      </para>
1229        <para>
1230        <variablelist>
1231    
1232        <varlistentry>
1233        <term>After adding two or more layers nothing is drawn in the map window.
1234        </term>
1235        <listitem>
1236        <para>
1237        This is probably because the layers have different projections. Projections
1238        must be set on all layers and on the map itself if the layers' projections
1239        are different.
1240        </para>
1241        </listitem>
1242        </varlistentry>
1243    
1244        <varlistentry>
1245        <term>Thuban crashes on startup with the error
1246            <literal>NameError: global name 'False' is not defined</literal>.
1247        </term>
1248        <listitem>
1249        <para>
1250        <varname>True</varname> and <varname>False</varname> were only introduced
1251        in Python 2.2.1. Thuban depends on at least Python 2.2.1.
1252        </para>
1253        </listitem>
1254        </varlistentry>
1255    
1256        <varlistentry>
1257        <term>After compiling Thuban, Thuban crashes with an error similar to
1258            <literal>
1259            ImportError: /usr/local//lib/thuban/Thuban/../Lib/wxproj.so: undefined symbol: __gxx_personality_v0
1260            </literal>
1261        </term>
1262        <listitem>
1263        <para>
1264        Thuban depends on the wxWindows library. If Thuban is compiled with an
1265        incompatible version of the compiler than wxWindows was compiled with
1266        this error may occur. Try compiling with a different version of the
1267        compiler.
1268        </para>
1269        </listitem>
1270        </varlistentry>
1271        </variablelist>
1272        </para>
1273        <para>
1274        If an error occurs Thuban will display a dialog indicating the error
1275        before closing. The text should be copied and reported to the
1276        <ulink url="http://thuban.intevation.org/bugtracker.html">
1277        Intevation bugtracker
1278        </ulink>.
1279        More information about the system is available from
1280        <menuchoice><guimenu>Help</guimenu><guimenuitem>About</guimenuitem></menuchoice> box.
1281        This should also be included in the bug report.
1282        <screenshot>
1283        <screeninfo>Error Dialog</screeninfo>
1284        <mediaobject>
1285        <imageobject><imagedata fileref="../images/8_int_error.png" format="PNG" scale="&imgscale;"/></imageobject>
1286        <imageobject><imagedata fileref="./images/8_int_error.eps" format="EPS" scale="&imgscale;"/></imageobject>
1287        <textobject><phrase>Error Dialog</phrase></textobject>
1288        <caption><para>Error Dialog</para></caption>
1289        </mediaobject>
1290        </screenshot>
1291        </para>
1292    
1293    </chapter>    </chapter>
1294    
1295    <appendix><title>Supported Data Sources</title>    <appendix><title>Supported Data Sources</title>
# Line 806  Line 1298 
1298      <variablelist>      <variablelist>
1299      <varlistentry>      <varlistentry>
1300      <term>Shapefile</term>      <term>Shapefile</term>
1301      <listitem><para></para></listitem>      <listitem>
1302            <para>
1303            The Shapefile format has become a standard format for saving
1304            geographic vector information. It supports polygons, lines, and
1305            points.
1306            
1307            <ulink url="http://www.esri.com/library/whitepapers/pdfs/shapefile.pdf">
1308            Technical Specification.
1309            </ulink>  
1310            </para>
1311        </listitem>
1312      </varlistentry>      </varlistentry>
1313    
1314      <varlistentry>      <varlistentry>
1315      <term>DB2 file</term>      <term>dBase file</term>
1316      <listitem><para></para></listitem>      <listitem>
1317            <para>
1318            dBase files are used to store the attributes for each layer. This
1319            is closely associated with the Shapefile format. For detailed
1320            specifications on the correct format of a dBase file used with
1321            Thuban please see the Technical Specification for the Shapefile
1322            format above.
1323            </para>
1324        </listitem>
1325      </varlistentry>      </varlistentry>
1326    
1327      </variablelist>      </variablelist>
# Line 819  Line 1329 
1329    
1330    <appendix><title>Supported Projections</title>    <appendix><title>Supported Projections</title>
1331      <para>      <para>
1332        The following types of projections are directly support by
1333        Thuban. The specific values for each are provided by the user
1334        to create custom projections. Thuban comes with predefined
1335        projections which are available through the Projections dialog.
1336      </para>      </para>
1337      <variablelist>      <variablelist>
1338      <varlistentry>      <varlistentry>
1339      <term>Geographic</term>          <term>Geographic</term>
1340      <listitem><para>Geographic</para></listitem>          <listitem><para><literal>Ellipsoid</literal></para>
1341            <para><literal>Source Data</literal>: either Degrees or Radians
1342                    </para></listitem>
1343      </varlistentry>      </varlistentry>
1344      <varlistentry>      <varlistentry>
1345      <term>Lambert Conic Conformal</term>          <term>Lambert Conic Conformal</term>
1346      <listitem><para>Lambert Conic Conformal</para></listitem>          <listitem><para><literal>Ellipsoid</literal></para>
1347            <para><literal>Latitude of 1st standard parallel</literal></para>
1348            <para><literal>Latitude of 2nd standard parallel</literal></para>
1349            <para><literal>Central Meridian</literal></para>
1350            <para><literal>Latitude of Origin</literal></para>
1351            <para><literal>False Easting</literal> (meters)</para>
1352            <para><literal>False Northing</literal> (meters)</para></listitem>
1353      </varlistentry>      </varlistentry>
1354      <varlistentry>      <varlistentry>
1355      <term>Transverse Mercator</term>          <term>Transverse Mercator</term>
1356      <listitem><para>Transverse Mercator</para></listitem>          <listitem><para><literal>Ellipsoid</literal></para>
1357            <para><literal>Latitude</literal>of origin</para>
1358            <para><literal>Longitude</literal>at central meridian</para>
1359            <para><literal>Scale Factor</literal>at central meridian</para>
1360            <para><literal>False Easting</literal> (meters)</para>
1361            <para><literal>False Northing</literal> (meters)</para></listitem>
1362      </varlistentry>      </varlistentry>
1363      <varlistentry>      <varlistentry>
1364      <term>Universal Transverse Mercator</term>          <term>Universal Transverse Mercator</term>
1365      <listitem><para>Universal Transverse Mercator</para></listitem>          <listitem><para><literal>Ellipsoid</literal></para>
1366            <para><literal>Zone</literal>
1367                    (can be guessed appling the Propose button)</para>
1368            <para><literal>Southern Hemisphere</literal> flag</para></listitem>
1369      </varlistentry>      </varlistentry>
1370      </variablelist>      </variablelist>
1371        
1372        <para>
1373        Thuban comes with a sample set of map projections for various
1374        European countries. Apart from the basic projection they differ
1375        especially in their parameterization:
1376        </para>
1377        <variablelist>
1378        <varlistentry><term>Belgium Datum 1972 (Lambert Conic Conformal)</term>
1379            <listitem><para></para></listitem>
1380        </varlistentry>
1381    
1382        <varlistentry><term>Gauss-Boaga Zone 1 (Italy, Transverse Mercartor)</term>
1383            <listitem><para></para></listitem>
1384        </varlistentry>
1385    
1386        <varlistentry><term>Gauss-Krueger Zone 2 (Germany, Transverse Mercartor)
1387        </term>
1388            <listitem><para></para></listitem>
1389        </varlistentry>
1390    
1391        <varlistentry><term>Reseau Geodesique Francaise
1392        (France, Lambert Conic Conformal)</term>
1393            <listitem><para></para></listitem>
1394        </varlistentry>
1395    
1396        <varlistentry><term>UK National Grid (United Kingdom, Transverse Mercartor)
1397        </term>
1398            <listitem><para></para></listitem>
1399        </varlistentry>
1400        </variablelist>
1401    
1402        <para>
1403        Thuban uses the comprehensive PROJ library for projections. PROJ provides
1404        more than the four commonly used projections described above. If needed
1405        Thuban can be easily extended to a new projection covered by PROJ.
1406        </para>
1407    </appendix>    </appendix>
1408    
1409  </book>  </book>
1410    
Legend:
Removed from v.1478  
changed lines
  Added in v.1530
[email protected]
 ViewVC Help
Powered by ViewVC 1.1.26