/[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 1490 by jonathan, Mon Jul 28 12:59:47 2003 UTC revision 1532 by frank, Thu Jul 31 10:58:24 2003 UTC
# Line 48  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            <itemizedlist>
61                <listitem><para>Thuban-0.8.1-1-debian.i386.rpm</para></listitem>
62                <listitem><para>GTK 1.2.3</para></listitem>
63                <listitem><para>Python 2.2.1</para></listitem>
64                <listitem><para>Python 2.2 XML Base Tools</para></listitem>
65                <listitem><para>wxWindows 2.4</para></listitem>
66                <listitem><para>wxWindows 2.4 Python Bindings</para></listitem>
67                <listitem><para>proj 4.4.5 Projection Library</para></listitem>
68                <listitem><para>SQLite Python Bindings 0.4.3</para></listitem>
69                <listitem><para>GDAL 1.1.8</para></listitem>
70            </itemizedlist>
71            </listitem>
72            </varlistentry>
73            <varlistentry>
74            <term>RedHat 7.2</term>
75            <listitem>
76            <itemizedlist>
77                <listitem><para>Thuban-0.8.1-1.i386.rpm</para></listitem>
78                <listitem><para>Python 2.2.1</para></listitem>
79                <listitem><para>wxPython 2.4 for Python 2.2 with wxGTK</para></listitem>
80                <listitem><para>proj 4.4.5 Projection Library</para></listitem>
81                <listitem><para>SQLite 2.8.3</para></listitem>
82                <listitem><para>PySQLite 0.4.3</para></listitem>
83                <listitem><para>GDAL 1.1.8</para></listitem>
84            </itemizedlist>
85            </listitem>
86            </varlistentry>
87            <varlistentry>
88            <term>Windows 2000</term>
89            <listitem>
90            <itemizedlist>
91                <listitem><para>Thuban-0.8.1-0.exe</para></listitem>
92                <listitem><para>Python 2.2.1</para></listitem>
93                <listitem><para>wxWindows 2.4 for Python 2.2</para></listitem>
94                <listitem><para>SQLite Python Libraries</para></listitem>
95                <listitem><para>GDAL for Thuban</para></listitem>
96            </itemizedlist>
97            </listitem>
98            </varlistentry>
99            </variablelist>
100          </para>          </para>
101          </section>          </section>
102    
103          <section><title>The Main Window</title>          <section><title>The Main Window</title>
104          <para>          <para>
105          <screenshot>          <figure>
106          <screeninfo>The Main Window</screeninfo>          <title>The Main Window</title>
107          <mediaobject>          <mediaobject>
108          <imageobject> <imagedata fileref="../images/1_2_mainwindow.png" format="PNG" scale="&imgscale;"/> </imageobject>          <imageobject> <imagedata fileref="../images/1_2_mainwindow.png" format="PNG" scale="&imgscale;"/> </imageobject>
109          <imageobject> <imagedata fileref="./images/1_2_mainwindow.ps" format="EPS" scale="&imgscale;"/> </imageobject>          <imageobject> <imagedata fileref="./images/1_2_mainwindow.ps" format="EPS" scale="&imgscale;"/> </imageobject>
         <textobject><phrase>The Main Window</phrase></textobject>  
         <caption><para>The Main Window</para></caption>  
110          </mediaobject>          </mediaobject>
111          </screenshot>          </figure>
112          </para>          </para>
113    
114          <para>          <para>
# Line 101  Line 144 
144          The tool bar provides quick access to the commonly needed tools.          The tool bar provides quick access to the commonly needed tools.
145          By hovering over each button the user can see a short messages          By hovering over each button the user can see a short messages
146          describing what the tool does. The tools provided are Zoom In, Zoom          describing what the tool does. The tools provided are Zoom In, Zoom
147          Out, Pan, Full Extent, Full Layer Extent, Full Shape Extent, Indentify,          Out, Pan, Full Extent, Full Layer Extent, Full Shape Extent, Identify,
148          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
149          in the manual.          in the manual.
150          </para>          </para>
# Line 149  Line 192 
192          <guimenu>File</guimenu>          <guimenu>File</guimenu>
193          <guimenuitem>Save Session</guimenuitem>          <guimenuitem>Save Session</guimenuitem>
194          </menuchoice>. A dialog box will open allowing the user to browse          </menuchoice>. A dialog box will open allowing the user to browse
195          the filesystem and select a place to save the session. Thuban          the file system and select a place to save the session. Thuban
196          sessions should be saved under a name ending in          sessions should be saved under a name ending in
197          <varname>.thuban</varname>. If the file already exists the user          <varname>.thuban</varname>. If the file already exists the user
198          will be prompted to save under a different name or overwrite the          will be prompted to save under a different name or overwrite the
# Line 159  Line 202 
202    
203          <section><title>The Session Info-Tree</title>          <section><title>The Session Info-Tree</title>
204          <para>          <para>
205          <screenshot>          <figure>
206          <screeninfo>Session Info Tree</screeninfo>          <title>Session Info Tree</title>
207          <mediaobject>          <mediaobject>
208          <imageobject><imagedata fileref="../images/2_4_session_tree.png" format="PNG" scale="&imgscale;"/></imageobject>          <imageobject><imagedata fileref="../images/2_4_session_tree.png" format="PNG" scale="&imgscale;"/></imageobject>
209          <imageobject><imagedata fileref="./images/2_4_session_tree.eps" format="EPS" scale="&imgscale;"/></imageobject>          <imageobject><imagedata fileref="./images/2_4_session_tree.eps" format="EPS" scale="&imgscale;"/></imageobject>
         <textobject><phrase>Session Info Tree</phrase></textobject>  
         <caption><para>Session Info Tree</para></caption>  
210          </mediaobject>          </mediaobject>
211          </screenshot>          </figure>
212          </para>          </para>
213          <para>          <para>
214          The session info-tree is primarily intended for developers working          The session info-tree is primarily intended for developers working
# Line 209  Line 250 
250    
251          <section><title>Adding and Removing Layers</title>          <section><title>Adding and Removing Layers</title>
252          <para>          <para>
253          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
254          and image layers. Shape layers are stored in Shapefile format, a          and image layers. Shape layers are stored in Shapefile format, a
255          standard file format for storing geographic objects. Normally, these          standard file format for storing geographic objects. These
256          files have the extension ``.shp''. Associated with          files have the extension ``.shp''. Associated with
257          the object information is a database file which stores attributes for          the shape file is a database file which stores attributes for
258          each shape in the Shapefile. This file, stored in dBASE format, usually          each shape in the shape file. This file, in dBase format,
259          has the extension ``.dbf''. Both files should have the same base name.          has the extension ``.dbf''. Both files must have the same base name.
260          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
261          also be a file roads.dbf.          also be a file roads.dbf.
262          </para>          </para>
263          <para>          <para>
# Line 226  Line 267 
267          <guimenuitem>Add Layer</guimenuitem>          <guimenuitem>Add Layer</guimenuitem>
268          </menuchoice>.          </menuchoice>.
269          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
270          matter if the Shapefile or database file is selected.          matter if the shape file or database file is selected.
271          </para>          </para>
272    
273          <para>          <para>
# Line 236  Line 277 
277          <guimenuitem>Add Image Layer</guimenuitem>          <guimenuitem>Add Image Layer</guimenuitem>
278          </menuchoice>.          </menuchoice>.
279          It is important to select a valid image file that has geographic          It is important to select a valid image file that has geographic
280          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,
281          or in another file. If geographic information cannot be found, Thuban          or in another file. If geographic information cannot be found, Thuban
282          will report an error.          will report an error.
283          </para>          </para>
# Line 245  Line 286 
286          <section><title>Navigation</title>          <section><title>Navigation</title>
287          <para>          <para>
288          The map can be explored by using the navigation tools available on          The map can be explored by using the navigation tools available on
289          the tool bar, or from the          the tool bar or from the
290          <menuchoice><guimenu>Map</guimenu></menuchoice> menu.          <menuchoice><guimenu>Map</guimenu></menuchoice> menu.
291          </para>          </para>
292            <itemizedlist>
293            <listitem>
294          <para>          <para>
295          The ZoomIn tool          The ZoomIn tool
296          <inlinemediaobject>          <inlinemediaobject>
# Line 259  Line 302 
302          </imageobject>          </imageobject>
303          <textobject> <phrase>ZoomIn Tool</phrase> </textobject>          <textobject> <phrase>ZoomIn Tool</phrase> </textobject>
304          </inlinemediaobject>          </inlinemediaobject>
305          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
306          will double the magnification and center the map on the point that          will double the magnification and center the map on the point that
307          was clicked. Clicking and dragging lets the user select a region          was clicked. Clicking and dragging selects a region that will be
308          to be enlarged to fit the window.          enlarged to fit the window.
309          </para>          </para>
310            </listitem>
311            <listitem>
312          <para>          <para>
313          The ZoomOut tool          The ZoomOut tool
314          <inlinemediaobject>          <inlinemediaobject>
# Line 280  Line 325 
325          selects a box such that the current contents of the window will be          selects a box such that the current contents of the window will be
326          scaled to fit into that box.          scaled to fit into that box.
327          </para>          </para>
328            </listitem>
329            <listitem>
330          <para>          <para>
331          The Pan tool          The Pan tool
332          <inlinemediaobject>          <inlinemediaobject>
# Line 293  Line 340 
340          </inlinemediaobject>          </inlinemediaobject>
341          allows the user to move the map around by clicking and dragging.          allows the user to move the map around by clicking and dragging.
342          </para>          </para>
343            </listitem>
344            <listitem>
345          <para>          <para>
346          The Full Extent tool          The Full Extent tool
347          <inlinemediaobject>          <inlinemediaobject>
# Line 306  Line 355 
355          </inlinemediaobject>          </inlinemediaobject>
356          rescales the viewable region so that the entire map is visible.          rescales the viewable region so that the entire map is visible.
357          </para>          </para>
358            </listitem>
359            <listitem>
360          <para>          <para>
361          The Full Layer Extent tool          The Full Layer Extent tool
362          <inlinemediaobject>          <inlinemediaobject>
# Line 321  Line 372 
372          layer fits within the window. If no layer is selected this button          layer fits within the window. If no layer is selected this button
373          will be disabled.          will be disabled.
374          </para>          </para>
375            </listitem>
376            <listitem>
377          <para>          <para>
378          The Full Shape Extent tool          The Full Shape Extent tool
379          <inlinemediaobject>          <inlinemediaobject>
# Line 335  Line 388 
388          rescales the viewable region so that the currently selected          rescales the viewable region so that the currently selected
389          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
390          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
391          selected this button will be disabled.          selected this button will be disabled. This feature is especially
392            helpful when identifying an object related to a selected record
393            in a tableview (see below).
394    
395          </para>          </para>
396            </listitem>
397            </itemizedlist>
398          </section>          </section>
399    
400          <section><title>Object Identification</title>          <section><title>Object Identification</title>
# Line 353  Line 411 
411          </inlinemediaobject>.          </inlinemediaobject>.
412          Clicking on an object selects that object and opens a dialog which          Clicking on an object selects that object and opens a dialog which
413          shows all the table attributes for that object. Any current selection          shows all the table attributes for that object. Any current selection
414          is lost.          is lost. Objects on the map are typically shapes and this document
415            will often refer to objects as shapes.
416          </para>          </para>
417          </section>          </section>
418    
419          <section><title>Object Labelling</title>          <section><title>Object Labeling</title>
420          <para>          <para>
421          Objects can be labelled using the Label tool          Objects can be labeled using the Label tool
422          <inlinemediaobject>          <inlinemediaobject>
423          <imageobject>          <imageobject>
424          <imagedata fileref="../images/3_3_label.png" format="PNG" scale="&imgscale;"/>          <imagedata fileref="../images/3_3_label.png" format="PNG" scale="&imgscale;"/>
# Line 371  Line 430 
430          </inlinemediaobject>.          </inlinemediaobject>.
431          Clicking on an object selects that object and opens a dialog which          Clicking on an object selects that object and opens a dialog which
432          displays the table attributes for that object. An attribute can          displays the table attributes for that object. An attribute can
433          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
434          object that already has a label will remove the label.          at the center of the shape. Clicking on an object that already has
435            a label will remove the label.
436          </para>          </para>
437          </section>          </section>
438    
# Line 400  Line 460 
460          <para>          <para>
461          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
462          to some of the layer manipulation options under          to some of the layer manipulation options under
463          <menuchoice> <guimenu>Map</guimenu> </menuchoice>.          <menuchoice><guimenu>Map</guimenu></menuchoice>.
464            </para>
465    
466            <itemizedlist>
467            <listitem>
468            <para>
469            The Move Layer to Top tool
470            <inlinemediaobject>
471            <imageobject>
472            <imagedata fileref="../images/3_5_totop.png" format="PNG" scale="&imgscale;"/>
473            </imageobject>
474            <imageobject>
475            <imagedata fileref="./images/3_5_totop.eps" format="EPS" scale="&imgscale;"/>
476            </imageobject>
477            <textobject> <phrase>Move Layer to Top</phrase> </textobject>
478            </inlinemediaobject> raises the selected layer to the top of the map.
479            </para>
480            </listitem>
481            <listitem>
482    
483            <para>
484            The Move Layer Up tool
485            <inlinemediaobject>
486            <imageobject>
487            <imagedata fileref="../images/3_5_moveup.png" format="PNG" scale="&imgscale;"/>
488            </imageobject>
489            <imageobject>
490            <imagedata fileref="./images/3_5_moveup.eps" format="EPS" scale="&imgscale;"/>
491            </imageobject>
492            <textobject> <phrase>Move Layer Up</phrase> </textobject>
493            </inlinemediaobject> raises the selected layer one level.
494            </para>
495            </listitem>
496            <listitem>
497    
498            <para>
499            The Move Layer Down tool
500            <inlinemediaobject>
501            <imageobject>
502            <imagedata fileref="../images/3_5_movedown.png" format="PNG" scale="&imgscale;"/>
503            </imageobject>
504            <imageobject>
505            <imagedata fileref="./images/3_5_movedown.eps" format="EPS" scale="&imgscale;"/>
506            </imageobject>
507            <textobject> <phrase>Move Layer Down</phrase> </textobject>
508            </inlinemediaobject> lowers the selected layer one level.
509            </para>
510    
511            </listitem>
512            <listitem>
513            <para>
514            The Move Layer to Bottom tool
515            <inlinemediaobject>
516            <imageobject>
517            <imagedata fileref="../images/3_5_tobottom.png" format="PNG" scale="&imgscale;"/>
518            </imageobject>
519            <imageobject>
520            <imagedata fileref="./images/3_5_tobottom.eps" format="EPS" scale="&imgscale;"/>
521            </imageobject>
522            <textobject> <phrase>Move Layer to Bottom</phrase> </textobject>
523            </inlinemediaobject> lowers the selected layer to the bottom of the map.
524            </para>
525    
526            </listitem>
527            <listitem>
528            <para>
529            The Visible tool
530            <inlinemediaobject>
531            <imageobject>
532            <imagedata fileref="../images/3_5_visible.png" format="PNG" scale="&imgscale;"/>
533            </imageobject>
534            <imageobject>
535            <imagedata fileref="./images/3_5_visible.eps" format="EPS" scale="&imgscale;"/>
536            </imageobject>
537            <textobject> <phrase>Visible</phrase> </textobject>
538            </inlinemediaobject> shows the selected layer in the map if it was
539            hidden.
540            </para>
541    
542            </listitem>
543            <listitem>
544            <para>
545            The Invisible tool
546            <inlinemediaobject>
547            <imageobject>
548            <imagedata fileref="../images/3_5_invisible.png" format="PNG" scale="&imgscale;"/>
549            </imageobject>
550            <imageobject>
551            <imagedata fileref="./images/3_5_invisible.eps" format="EPS" scale="&imgscale;"/>
552            </imageobject>
553            <textobject> <phrase>Invisible</phrase> </textobject>
554            </inlinemediaobject> hides the selected layer in the map.
555            </para>
556    
557            </listitem>
558            <listitem>
559            <para>
560            The Properties tool
561            <inlinemediaobject>
562            <imageobject>
563            <imagedata fileref="../images/3_5_props.png" format="PNG" scale="&imgscale;"/>
564            </imageobject>
565            <imageobject>
566            <imagedata fileref="./images/3_5_props.eps" format="EPS" scale="&imgscale;"/>
567            </imageobject>
568            <textobject> <phrase>Properties</phrase> </textobject>
569            </inlinemediaobject> opens the layer's properties dialog box.
570          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
571          properties dialog for that layer.          properties dialog for that layer.
572          </para>          </para>
573            </listitem>
574            </itemizedlist>
575            <para>
576            Along the bottom of the legend is the scalebar. The scalebar
577            will be available if there are any layers and the  map has a
578            projection set.
579            </para>
580          </section>          </section>
581    
582          <section><title>Exporting</title>          <section><title>Exporting</title>
# Line 415  Line 587 
587          <menuchoice>          <menuchoice>
588          <guimenu>Map</guimenu>          <guimenu>Map</guimenu>
589          <guimenuitem>Export</guimenuitem>          <guimenuitem>Export</guimenuitem>
590          </menuchoice>. Under other platforms this option is not available.          </menuchoice> for use in reports, presentations, or further
591          Clicking this menu item open a file selection dialog that lets the          modification. The current map view, legend, and, if available,
592          user select a location to export the map.          scalebar are exported. Under other platforms this option is not
593            available. Clicking this menu item open a file selection dialog
594            that lets the user select a location to export the map.
595          </para>          </para>
596          </section>          </section>
597    
# Line 427  Line 601 
601          <menuchoice>          <menuchoice>
602          <guimenu>Map</guimenu>          <guimenu>Map</guimenu>
603          <guimenuitem>Print</guimenuitem>          <guimenuitem>Print</guimenuitem>
604          </menuchoice>. A standard printing dialog will open allowing the          </menuchoice>. The current map view, legend, and, if available,
605          user to configure the printer. This dialog will differ depending          scalebar are printed. A standard printing dialog will open allowing
606            the user to configure the printer. This dialog will differ depending
607          on which platform Thuban is running.          on which platform Thuban is running.
608          </para>          </para>
609          </section>          </section>
# Line 444  Line 619 
619          There are two types of layers supported by Thuban: shape layers and          There are two types of layers supported by Thuban: shape layers and
620          image layers. Shape layers consist of vector based shapes with          image layers. Shape layers consist of vector based shapes with
621          geo-referenced coordinates. There are three types of supported          geo-referenced coordinates. There are three types of supported
622          shapes: polygons, lines, and points. Image layers can be any image          shapes: polygons, lines (arc), and points. Image layers can be any image
623          file format supported by GDAL. The images must have geographic          file format supported by the Geo-spatial Data Abstraction Library
624          coordinate data either embedded within the file, or in a seperate          (GDAL). The images must have geographic
625            coordinate data either embedded within the file or in a separate
626          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
627          work very well with Thuban and were designed specifically to be image          work very well with Thuban and were designed specifically to be image
628          layers in GIS programs.          layers in GIS programs.
629          </para>          </para>
630            <para>
631            All actions in the
632            <menuchoice>
633            <guimenu>Layer</guimenu>
634            </menuchoice> menu act on the currently selected layer in the legend.
635            </para>
636          </section>          </section>
637    
638          <section><title>Properties</title>          <section><title>Properties</title>
# Line 461  Line 643 
643          <guimenu>Layer</guimenu>          <guimenu>Layer</guimenu>
644          <guimenuitem>Properties</guimenuitem>          <guimenuitem>Properties</guimenuitem>
645          </menuchoice> opens a dialog that displays a layer's properties.          </menuchoice> opens a dialog that displays a layer's properties.
646          All layers have a title and it can be modified in the text field          All layers have a title which can be modified in the text field
647          provided. The type of layer is also shows. If the type is type          provided. The type of layer is also shows. If the type is a type
648          of shape (polygon, arc, point) the classification table will be          of shape (polygon, arc, point) the classification table will be
649          shown. Image layers have no other properties other than title          shown. Image layers have no other properties other than title
650          and type.          and type.
651          </para>          </para>
652          <para>          <para>
653          <screenshot>          <figure>
654          <screeninfo>Properties Window</screeninfo>          <title>Properties Window</title>
655          <mediaobject>          <mediaobject>
656          <imageobject><imagedata fileref="../images/4_2_layer_properties.png" format="PNG" scale="&imgscale;"/></imageobject>          <imageobject><imagedata fileref="../images/4_2_layer_properties.png" format="PNG" scale="&imgscale;"/></imageobject>
657          <imageobject><imagedata fileref="./images/4_2_layer_properties.eps" format="EPS" scale="&imgscale;"/></imageobject>          <imageobject><imagedata fileref="./images/4_2_layer_properties.eps" format="EPS" scale="&imgscale;"/></imageobject>
         <textobject><phrase>Properties Window</phrase></textobject>  
         <caption><para>The Properties Window for a Shape Layer</para></caption>  
658          </mediaobject>          </mediaobject>
659          </screenshot>          </figure>
660          </para>          </para>
661          <para>          <para>
662          <screenshot>          <figure>
663          <screeninfo>Properties Window</screeninfo>          <title>Properties Window</title>
664          <mediaobject>          <mediaobject>
665          <imageobject><imagedata fileref="../images/4_2_raster_layer_properties.png" format="PNG" scale="&imgscale;"/></imageobject>          <imageobject><imagedata fileref="../images/4_2_raster_layer_properties.png" format="PNG" scale="&imgscale;"/></imageobject>
666          <imageobject><imagedata fileref="./images/4_2_raster_layer_properties.eps" format="EPS" scale="&imgscale;"/></imageobject>          <imageobject><imagedata fileref="./images/4_2_raster_layer_properties.eps" format="EPS" scale="&imgscale;"/></imageobject>
         <textobject><phrase>Properties Window</phrase></textobject>  
         <caption><para>The Properties Window for an Image Layer</para></caption>  
667          </mediaobject>          </mediaobject>
668          </screenshot>          </figure>
669          </para>          </para>
670          </section>          </section>
671    
# Line 496  Line 674 
674          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.
675          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
676          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
677          each time the map is changed. Each layer can be independently          all the layers each time the map is changed. Each layer can be
678          turned on or off using the          independently turned on or off using the
679          <menuchoice>          <menuchoice>
680          <guimenu>Layer</guimenu>          <guimenu>Layer</guimenu>
681          <guimenuitem>Show</guimenuitem>          <guimenuitem>Show</guimenuitem>
# Line 519  Line 697 
697          <guimenuitem>Duplicate</guimenuitem>          <guimenuitem>Duplicate</guimenuitem>
698          </menuchoice>. Duplicating a layer is useful if the user wishes          </menuchoice>. Duplicating a layer is useful if the user wishes
699          to model a layer in several different ways. Even though the layers          to model a layer in several different ways. Even though the layers
700          overlap by carefully selecting the shape properties it is possible          overlap, by carefully selecting the shape properties it is possible
701          to display several pieces of information at once. For example, one          to display several pieces of information at once. For example, one
702          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
703          another copy may be classified on a type property. if the length          another copy may be classified on a type property. If the length
704          property was expressed with color and the type property expressed          property was expressed with color and the type property expressed
705          with line thickness then it would be possible to view both          with line thickness then it would be possible to view both
706          classifications by placing the type property copy over the          classifications by placing the type property copy over the
# Line 540  Line 718 
718      cannot be classified.      cannot be classified.
719      </para>      </para>
720      <para>      <para>
721      A classification consists of a number of groups, with each group      A classification consists of a number of groups, each group
722      having a value or range of values to match against, and symbol      having a value or range of values to match against, and symbol
723      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
724      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 553  Line 731 
731      <para>      <para>
732      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
733      map, a default classification is created with the DEFAULT group. This      map, a default classification is created with the DEFAULT group. This
734      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
735      attributes, will match this group.      layer, regardless of its attributes, will match this group if no other
736        group matches.
737      </para>      </para>
738    
739          <section><title>Editing Classifications</title>          <section><title>Editing Classifications</title>
# Line 571  Line 750 
750          button.          button.
751          </para>          </para>
752          <para>          <para>
753          <screenshot>          To apply the changes to the map the user can click
754          <screeninfo>Properties Window</screeninfo>          either <guibutton>Try</guibutton> or <guibutton>OK</guibutton>.
755            <guibutton>Try</guibutton> will not close the dialog box, allowing
756            the user to see how the classification changes the map.
757            <guibutton>Revert</guibutton> will undo the last classification applied
758            to the map. <guibutton>OK</guibutton> will commit the changes and
759            close the dialog. The user will be unable to undo the changes.
760            <guibutton>Close</guibutton> simply closes the dialog box. If any
761            changes have not been applied with <guibutton>Try</guibutton> the
762            changes will not be applied to the map.
763            </para>
764            <para>
765            <figure>
766            <title>Properties Window</title>
767          <mediaobject>          <mediaobject>
768          <imageobject><imagedata fileref="../images/5_classification.png" format="PNG" scale="&imgscale;"/></imageobject>          <imageobject><imagedata fileref="../images/5_classification.png" format="PNG" scale="&imgscale;"/></imageobject>
769          <imageobject><imagedata fileref="./images/5_classification.eps" format="EPS" scale="&imgscale;"/></imageobject>          <imageobject><imagedata fileref="./images/5_classification.eps" format="EPS" scale="&imgscale;"/></imageobject>
         <textobject><phrase>Properties Window</phrase></textobject>  
         <caption><para>The Properties Window with Classifications</para></caption>  
770          </mediaobject>          </mediaobject>
771          </screenshot>          </figure>
772          </para>          </para>
773          <para>          <para>
774          The order of the groups in the classification is significant          The order of the groups in the classification is significant
775          except for the DEFAULT group, which remains at the top. When shapes          except for the DEFAULT group, which remains at the top. When shapes
776          are matched against groups the matching begins at the first group          are matched against groups the matching begins at the first group
777          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
778          be checked first. Matching for a          be checked first. Matching for a
779          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
780          use <guibutton>Move Up</guibutton> and <guibutton>Move Down</guibutton>          use <guibutton>Move Up</guibutton> and <guibutton>Move Down</guibutton>
781          to change the order of the groups. The DEFAULT group will always          to change the order of the groups. The DEFAULT group will always
782          match a shape that hasn't matched another group.          match a shape that hasn't matched another group.
783          </para>          </para>
784          <para>              <section><title>Visible</title>
785          The Value column of the classification table is the value that will              <para>
786          be matched when the map is being drawn. The type of data that can              The Visible column has check-boxes that determine whether a
787          entered into this field depends on the type of data of the              classification group will be displayed in the legend. This is
788          classification field.              useful if the user knows that the groups completely cover
789          </para>              the data set and don't want the DEFAULT group to be displayed
790          <para>              in the legend and on a printout.
791          If the field is of type Text, anything entered              </para>
792          into the field is valid. The text will be compared literally to the          </section>
793          value of the shape attribute, including case sensitivity.              <section><title>Symbols</title>
794          If the type is Integer, then any valid integer may be entered. In              <para>
795          addition, with special syntax, a range of values can be entered.              Each type of shape has its own type of symbol. Thuban supports three
796          A range from <varname>start</varname> to <varname>end</varname>              types of shapes: polygons, lines, and points. Polygons and points
797          inclusive is specifed like this: <literal>[start;end]</literal>.              have outline and fill color, while lines have only line color. Each
798          The exclusive range is specified like this:              group has associated symbol properties. To edit the symbol
799          <literal>]start;end[</literal>. Ranges can include infinity like              properties for a group the user can double click on the Symbol
800          this: <literal>[-oo;oo]</literal>. Field types can also be of type              column or select a group and click the
801          Decimal. They represent any rational number and can be used in ranges              <guibutton>Edit Symbol</guibutton> button.
802          as well.              </para>
803          </para>              </section>
804          </section>          <section><title>Value</title>
805                <para>
806          <section><title>Symbols</title>              The Value column of the classification table is the value that will
807          <para>              be matched when the map is being drawn. The type of data that can
808          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
809          types of shapes: polygons, lines, and points. Polygons and points have              classification field.
810          outline and fill color, while lines have only line color. Each group              </para>
811          has associated symbol properties. To edit the symbol properties for a              <para>
812          group the user can double click on the Symbol column or select a              If the field is of type Text, anything entered
813          group and click the <guibutton>Edit Symbol</guibutton> button.              into the field is valid. The text will be compared literally to the
814          </para>              value of the shape attribute, including case sensitivity.
815                If the type is Integer, then any valid integer may be entered. In
816                addition, with special syntax, a range of values can be entered.
817                A range from <varname>start</varname> to <varname>end</varname>
818                inclusive is specified like this: <literal>[start;end]</literal>.
819                The exclusive range is specified like this:
820                <literal>]start;end[</literal>. Ranges can include infinity like
821                this: <literal>[-oo;oo]</literal>. Field types can also be of type
822                Decimal. They represent any rational number and can be used in
823                ranges as well.
824                </para>
825                </section>
826                <section><title>Label</title>
827                <para>
828                By default, the text that is displayed for a group in the legend
829                is the value for that group. The label can substitute a more
830                descriptive term in the legend.
831                </para>
832            </section>
833          </section>          </section>
834    
835          <section><title>Generating Classes</title>          <section><title>Generating Classes</title>
836          <para>          <para>
837          <screenshot>          <figure>
838          <screeninfo>Generate Class</screeninfo>          <title>Generate Class</title>
839          <mediaobject>          <mediaobject>
840          <imageobject><imagedata fileref="../images/5_3_genclass.png" format="PNG" scale="&imgscale;"/></imageobject>          <imageobject><imagedata fileref="../images/5_3_genclass.png" format="PNG" scale="&imgscale;"/></imageobject>
841          <imageobject><imagedata fileref="./images/5_3_genclass.eps" format="EPS" scale="&imgscale;"/></imageobject>          <imageobject><imagedata fileref="./images/5_3_genclass.eps" format="EPS" scale="&imgscale;"/></imageobject>
         <textobject><phrase>Generate Class</phrase></textobject>  
         <caption><para>The Generate Classifications Dialog</para></caption>  
842          </mediaobject>          </mediaobject>
843          </screenshot>          </figure>
844          </para>          </para>
845          <para>          <para>
846          Creating a classification by hand can be tedious.          Creating a classification by hand can be tedious.
# Line 643  Line 848 
848          classification at once while still giving the user control over          classification at once while still giving the user control over
849          how it appears. Clicking <guibutton>Generate Class</guibutton>          how it appears. Clicking <guibutton>Generate Class</guibutton>
850          opens the <varname>Generate Classification</varname> dialog.          opens the <varname>Generate Classification</varname> dialog.
851          Under the <varname>Generate</varname> pulldown there are at most          Under the <varname>Generate</varname> pull down there are at most
852          three different ways to generate classifications:          three different ways to generate classifications:
853          Unique Values, Unique Distribution, and Quantiles. Some options          Unique Values, Uniform Distribution, and Quantiles. Some options
854          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
855          support them. For instance, <varname>Unique Distribution</varname>          support them. For instance, <varname>Uniform Distribution</varname>
856          doesn't make sense for a Text field.          doesn't make sense for a Text field.
857          </para>          </para>
858          <para>          <para>
859          For every way of generating a classification, a color scheme must          For every way of generating a classification, a color scheme must
860          be selected. Thuban provides several different color schemes that          be selected. Thuban provides several different color schemes that
861          affect how the group properties change over the classification.          affect how the group properties change over the classification.
862            It may be desirable that only certain properties change over the
863            classification. If the shape type is a polygon or a point then
864            the <guibutton>Fix Border Color</guibutton> option will be available.
865            This allows the user to select a border color for all classification
866            groups.
867          It is also possible to create a custom color scheme. Selecting          It is also possible to create a custom color scheme. Selecting
868          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
869          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
870          properties of the last group. Thuban will interpolate between these          properties of the last group. Thuban will interpolate between these
871          two properties to generate the other groups.          two properties to generate the other groups.
872            <figure>
873            <title>Custom Color Scheme</title>
874            <mediaobject>
875            <imageobject><imagedata fileref="../images/5_2_custom_ramp.png" format="PNG" scale="&imgscale;"/></imageobject>
876            <imageobject><imagedata fileref="./images/5_2_custom_ramp.eps" format="EPS" scale="&imgscale;"/></imageobject>
877            </mediaobject>
878            </figure>
879          </para>          </para>
880          <para>          <para>
881          The Unique Values option lets the user select specific values that          The Unique Values option lets the user select specific values that
# Line 668  Line 885 
885          right. Each list can be sorted or reversed for easier searching.          right. Each list can be sorted or reversed for easier searching.
886          The classification that is generated will be in the same order as          The classification that is generated will be in the same order as
887          the list on the right.          the list on the right.
888            <figure>
889            <title>Unique Values</title>
890            <mediaobject>
891            <imageobject><imagedata fileref="../images/5_2_unique_values.png" format="PNG" scale="&imgscale;"/></imageobject>
892            <imageobject><imagedata fileref="./images/5_2_unique_values.eps" format="EPS" scale="&imgscale;"/></imageobject>
893            </mediaobject>
894            </figure>
895          </para>          </para>
896          <para>          <para>
897          The Unique Distribution option creates a user specified number of          The Uniform Distribution option creates a user specified number of
898          groups of ranges such that each range covers equal intervals. The          groups of ranges such that each range covers equal intervals. The
899          minimum and maximum values can automatically be retrieved from the          minimum and maximum values can automatically be retrieved from the
900          table by clicking <guibutton>Retrieve From Table</guibutton>. The          table by clicking <guibutton>Retrieve From Table</guibutton>. The
901          stepping is how large each interval is. Adjusting this value will          stepping is how large each interval is. Adjusting this value will
902          automatically recalculate how many groups is appropriate.          automatically recalculate how many groups is appropriate.
903            <figure>
904            <title>Uniform Distribution</title>
905            <mediaobject>
906            <imageobject><imagedata fileref="../images/5_2_uniform_dist.png" format="PNG" scale="&imgscale;"/></imageobject>
907            <imageobject><imagedata fileref="./images/5_2_uniform_dist.eps" format="EPS" scale="&imgscale;"/></imageobject>
908            </mediaobject>
909            </figure>
910          </para>          </para>
911          <para>          <para>
912          The Quantiles option generates ranges based on the number items          The Quantiles option generates ranges based on the number of items
913          in the input set. For example, by specifying 5 groups Thuban will          in the table. For example, by specifying five groups Thuban will
914          generate groups with appropriate ranges such that 20% of the table          generate five groups with appropriate ranges such that 20% of the table
915          data is in each group. If it is impossible to generate exact          data is in each group. If it is impossible to generate exact
916          grouping, Thuban will issue a warning but allow the user to continue.          groupings, Thuban will issue a warning but allow the user to continue.
917            <figure>
918            <title>Quantiles</title>
919            <mediaobject>
920            <imageobject><imagedata fileref="../images/5_2_quantiles.png" format="PNG" scale="&imgscale;"/></imageobject>
921            <imageobject><imagedata fileref="./images/5_2_quantiles.eps" format="EPS" scale="&imgscale;"/></imageobject>
922            </mediaobject>
923            </figure>
924          </para>          </para>
925          </section>          </section>
926    </chapter>    </chapter>
# Line 691  Line 929 
929      <para>      <para>
930      Projections control how the geographic data is displayed on the screen.      Projections control how the geographic data is displayed on the screen.
931      If multiple layers are loaded into Thuban where the geographic data      If multiple layers are loaded into Thuban where the geographic data
932      is in a different projection system, then the user must tell Thuban      is in a different projection system, then the user must specify a
933      which projection each layer has. The user must also tell Thuban which      projection for each layer. The user must also tell Thuban which
934      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
935      projection in which case the layers are reprojected into that space.      projection in which case the layers are reprojected into that space.
936      The map projection can be set using      The map projection can be set using
# Line 704  Line 942 
942      <guimenu>Layer</guimenu>      <guimenu>Layer</guimenu>
943      <guimenuitem>Projection</guimenuitem>      <guimenuitem>Projection</guimenuitem>
944      </menuchoice>.      </menuchoice>.
945      <screenshot>      <figure>
946      <screeninfo>Projection Window</screeninfo>      <title>Projection Window</title>
947      <mediaobject>      <mediaobject>
948      <imageobject><imagedata fileref="../images/6_projection.png" format="PNG" scale="&imgscale;"/></imageobject>      <imageobject><imagedata fileref="../images/6_projection.png" format="PNG" scale="&imgscale;"/></imageobject>
949      <imageobject><imagedata fileref="./images/6_projection.eps" format="EPS" scale="&imgscale;"/></imageobject>      <imageobject><imagedata fileref="./images/6_projection.eps" format="EPS" scale="&imgscale;"/></imageobject>
     <textobject><phrase>Projection Window</phrase></textobject>  
     <caption><para>The Projection Window</para></caption>  
950      </mediaobject>      </mediaobject>
951      </screenshot>      </figure>
952      </para>      </para>
953      <para>      <para>
954      Thuban is distributed with a sample collection of projections. The      Thuban is distributed with a sample collection of projections. The
955      user can create new projections and make them available to all      user can create new projections and make them available to all
956      future Thuban sessions. They may also be exported and imported so      future Thuban sessions. They may also be exported and imported so
957      that custom projections can be distributed to others.      that custom projections can be distributed.
958      </para>      </para>
959          <section><title>Selecting a Projection</title>          <section><title>Selecting a Projection</title>
960          <para>          <para>
961          The available projections are listed on the left. If the layer          The available projections are listed on the left. If the layer
962          or map already has a projection it will be initially highlighted          or map already has a projection it will initially be highlighted
963          and will end with <varname>(current)</varname>. Selecting          and will end with <varname>(current)</varname>. Selecting
964          <varname>&lt;None&gt;</varname> will cause Thuban to use the data as          <varname>&lt;None&gt;</varname> will cause Thuban to use the data as
965          it appears in the source file and will not use a projection.          it appears in the source file and will not use a projection.
# Line 734  Line 970 
970          Whenever a projection is selected from the list its properties          Whenever a projection is selected from the list its properties
971          are displayed on the right. These properties can be changed          are displayed on the right. These properties can be changed
972          and the changes saved to the selected projection using          and the changes saved to the selected projection using
973          the <guibutton>Update</guibutton>. Only a projection that comes          <guibutton>Update</guibutton>. Only a projection that comes
974          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
975          is selectd, <guibutton>Update</guibutton> will be disabled.          is selected, <guibutton>Update</guibutton> will be disabled.
976          The <guibutton>Add to List</guibutton> adds the projection to the          <guibutton>Add to List</guibutton> adds the projection to the
977          list of available projections as a new entry, and thus make it          list of available projections as a new entry, and thus makes it
978          available to future Thuban sessions. Clicking <guibutton>New</guibutton>          available to future Thuban sessions. Clicking <guibutton>New</guibutton>
979          will create an entirely new, empty projection. The          will create an entirely new, empty projection. The
980          <guibutton>Remove</guibutton> button will permanantly remove a          <guibutton>Remove</guibutton> button will permanently remove a
981          projection from the list of available projections.          projection from the list of available projections.
982          </para>          </para>
983            <para>
984            To apply the selected projection to the map the user can click
985            either <guibutton>Try</guibutton> or <guibutton>OK</guibutton>.
986            <guibutton>Try</guibutton> will not close the dialog box, allowing
987            the user to see how the projeciton changes the map.
988            <guibutton>Revert</guibutton> will undo the last projection applied
989            to the map. <guibutton>OK</guibutton> will commit the changes and
990            close the dialog. The user will be unable to undo the changes.
991            <guibutton>Close</guibutton> simply closes the dialog box. If no
992            selection has been applied with <guibutton>Try</guibutton> the
993            selection will not be applied to the map.
994            </para>
995      </section>      </section>
996          <section><title>Importing/Exporting Projections</title>          <section><title>Importing/Exporting Projections</title>
997          <para>          <para>
998          The projections that appear in the list of available projections          The projections that appear in the list of available projections
999          can be exported to another file that the user chooses. By selecting          can be exported to another file that the user chooses. By selecting
1000          one or more projections and clicking <guibutton>Export</guibutton>          one or more projections and clicking <guibutton>Export</guibutton>
1001          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
1002            projections.
1003          The file can then be distributed to other Thuban users. To import          The file can then be distributed to other Thuban users. To import
1004          a projection file the user can click <guibutton>Import</guibutton>.          a projection file the user can click <guibutton>Import</guibutton>.
1005          The imported projections are added to the list and are then available          The imported projections are added to the list and are then available
1006          to the current session and any future Thuban session.          to the current session and any future Thuban sessions.
1007          </para>          </para>
1008      </section>      </section>
1009    </chapter>    </chapter>
# Line 762  Line 1011 
1011    <chapter><title>Table Management</title>    <chapter><title>Table Management</title>
1012      <para>      <para>
1013      Thuban distinguishes two different types of tables: Attribute tables      Thuban distinguishes two different types of tables: Attribute tables
1014      (which belong to a layer) and usual data tables. Both provide in      (which belong to a layer) and normal data tables. Both provide
1015          general the same functionality with the difference that actions on an          the same general functionality with the difference that actions on an
1016      attribute table might also effect the map display.      attribute table might also effect the map display.
1017      </para>      </para>
1018    
1019      <section><title>Table View</title>      <section><title>Table View</title>
1020          <para>          <para>
1021          <screenshot>          <figure>
1022          <screeninfo>Table View</screeninfo>          <title>Table View</title>
1023          <mediaobject>          <mediaobject>
1024          <imageobject><imagedata fileref="../images/7_1_table_view.png" format="PNG" scale="&imgscale;"/></imageobject>          <imageobject><imagedata fileref="../images/7_1_table_view.png" format="PNG" scale="&imgscale;"/></imageobject>
1025          <imageobject><imagedata fileref="./images/7_1_table_view.eps" format="EPS" scale="&imgscale;"/></imageobject>          <imageobject><imagedata fileref="./images/7_1_table_view.eps" format="EPS" scale="&imgscale;"/></imageobject>
         <textobject><phrase>Table View</phrase></textobject>  
         <caption><para>The Table View</para></caption>  
1026          </mediaobject>          </mediaobject>
1027          </screenshot>          </figure>
1028          </para>          </para>
1029          <para>          <para>
1030          Thuban provides a standard dialog to display table contents, the          Thuban provides a standard dialog to display table contents, the
1031          Table View. The view falls into five sections: The title, selections,          Table View. The view has five sections: The title, selections,
1032          the table grid, export functions and the status bar.          the table grid, export functions, and the status bar.
1033          </para>          </para>
1034          <para>          <para>
1035          The title bar identifies the table with it's name.          The title bar identifies the table with its name.
1036          </para>          </para>
1037          <para>          <para>
1038          The functions box let the user perform simple analysis on the data          The selections box let the user perform simple analysis on the data
1039          based on comparisons: First choice must be a field identifier of the          based on comparisons: The first choice must be a field identifier of
1040          table, the second choice determines the type of comparison. The third          the table, the second choice determines the type of comparison. The
1041          choice can be either a specific value (interpreted as numerical          third choice can be either a specific value (interpreted as numerical
1042          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
1043          identifier. Thus you can perform analysis like selecting all          identifier. Thus you can perform analysis like selecting all
1044          records where "population > 10000" or          records where <literal>population > 10000</literal> or
1045          "cars_per_habitants <  bike_per_habitants" (note that the field names          <literal>cars_per_inhabitant < bikes_per_inhabitant</literal>
1046          are only explanatory, the currently considered dBASE files allow only          (note that the field names are only explanatory, the dBase files
1047          11 character field names).          allow only 11 character field names).
1048                
1049          Selections can be combined, either by applying a selection only on          Selections can be combined either by applying a selection only on
1050          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
1051          selection to a previous set. The default is that a selection replaces          selection to a previous set. The default is that a selection replaces
1052          earlier results.          earlier results.
1053          </para>          </para>
1054          <para>          <para>
1055          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),
1056          with highlighted selection results. Columns and rows can be resized.          with highlighted selection results. Columns and rows can be resized.
1057          </para>          </para>
1058          <para>          <para>
1059          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
1060          format (DBF) or comma seperated values (CSV). The          format (DBF) or comma separated values (CSV). The
1061          <guibutton>Export</guibutton> button          <guibutton>Export</guibutton> button
1062          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
1063          is determined by the file extension (either .dbf or .csv).          is determined by the file extension (either .dbf or .csv).
# Line 834  Line 1081 
1081      <section><title>General Functionality (Menu Table)</title>      <section><title>General Functionality (Menu Table)</title>
1082          <para>          <para>
1083          The general functions affect all tables open in Thuban. Attribute          The general functions affect all tables open in Thuban. Attribute
1084          tables are considered here as usual data tables (with the exception          tables are considered here as normal data tables (with the exception
1085          that they cannot be closed).          that they cannot be closed).
1086          </para>          </para>
1087          <section><title>Open</title>          <section><title>Open</title>
# Line 845  Line 1092 
1092              <guimenuitem>Open</guimenuitem>              <guimenuitem>Open</guimenuitem>
1093              </menuchoice>              </menuchoice>
1094              item raises a file dialog to let you select a              item raises a file dialog to let you select a
1095              dBASE file from the file system to be loaded into Thuban read-only.              dBase file from the file system to be loaded into Thuban read-only.
1096              On OK the selected file is loaded and a table view is opened.              On <guibutton>OK</guibutton> the selected file is loaded and a
1097                table view is opened.
1098              </para>              </para>
1099          </section>          </section>
1100    
# Line 867  Line 1115 
1115              Since tables are opened read-only the contents of the tables are              Since tables are opened read-only the contents of the tables are
1116              not affected.              not affected.
1117    
1118              A still open table view is closed as well.              Any open views of the tables are closed as well.
1119    
1120              Tables used in a join cannot be closed.              Tables used in a join cannot be closed.
1121              </para>              </para>
# Line 891  Line 1139 
1139              </menuchoice>              </menuchoice>
1140              item raises a list of available tables (explicitly              item raises a list of available tables (explicitly
1141              loaded, attribute tables, results of a join). Selected tables are              loaded, attribute tables, results of a join). Selected tables are
1142              show in tables views on <guibutton>OK</guibutton>              show in tables views on <guibutton>OK</guibutton>.
1143              </para>              </para>
1144          </section>          </section>
1145    
1146          <section><title>Join</title>          <section><title>Join</title>
1147              <para>              <para>
1148              <screenshot>              <figure>
1149              <screeninfo>Join Tables</screeninfo>              <title>Join Tables</title>
1150              <mediaobject>              <mediaobject>
1151              <imageobject><imagedata fileref="../images/7_2_5_join.png" format="PNG" scale="&imgscale;"/></imageobject>              <imageobject><imagedata fileref="../images/7_2_5_join.png" format="PNG" scale="&imgscale;"/></imageobject>
1152              <imageobject><imagedata fileref="./images/7_2_5_join.eps" format="EPS" scale="&imgscale;"/></imageobject>              <imageobject><imagedata fileref="./images/7_2_5_join.eps" format="EPS" scale="&imgscale;"/></imageobject>
             <textobject><phrase>Join Tables</phrase></textobject>  
             <caption><para>The Join Tables Dialog</para></caption>  
1153              </mediaobject>              </mediaobject>
1154              </screenshot>              </figure>
1155              </para>              </para>
1156              <para>              <para>
1157              The              The
# Line 917  Line 1163 
1163              joined. The join results in a new table named 'Join of "left table"              joined. The join results in a new table named 'Join of "left table"
1164              and "right table"'.              and "right table"'.
1165    
1166              The dialog let you select the two tables to be joined and the two              The dialog lets you select the two tables to be joined and the two
1167              fields the join has to be performed on. By default the new              fields the join has to be performed on. By default, the new
1168              table contains only those records which are mathced by the join.              table contains only those records which are matched by the join.
1169    
1170              If you want to preserve the records of the left table you can              If you want to preserve the records of the left table you can
1171              perform an outer join. The fields from the right table for records              perform an outer join. The fields from the right table for records
# Line 931  Line 1177 
1177      </section>      </section>
1178      <section><title>Attribute Tables</title>      <section><title>Attribute Tables</title>
1179          <para>          <para>
1180              To clearly separate between both types, Thuban provides              To clearly separate between both types of tables (data and
1181          functionality regarding the attribute tables under the Layer menu.          attribute), Thuban provides functionality regarding the attribute
1182            tables under the <menuchoice><guimenu>Layer</guimenu></menuchoice> menu.
1183          </para>          </para>
1184    
1185          <section><title>Show Table</title>          <section><title>Show Table</title>
# Line 952  Line 1199 
1199    
1200          <section><title>Join Table</title>          <section><title>Join Table</title>
1201              <para>              <para>
1202              In difference to the join described above the join results not in a              Unlike the join described above, the join does not result in a
1203              new table. The attribute table of the currently active layer is the              new table. The attribute table of the currently active layer is the
1204              left table and other tables are joined to this table. The results of              left table and other tables are joined to this table. The results of
1205              the join are available for classifications.              the join are available for classification.
1206    
1207              As a consequence, the join cannot result in fewer              As a consequence, the join cannot result in fewer
1208              records than the source attribute table. The user is warned if the              records than the source attribute table. The user is warned if the
# Line 971  Line 1218 
1218              normal tables can be simply closed (and thereby dereferencing              normal tables can be simply closed (and thereby dereferencing
1219              the source tables), this is not possible for attribute tables.              the source tables), this is not possible for attribute tables.
1220    
1221              Hence joins on attribute tables must be solved explicitely. This is              Hence joins on attribute tables must be solved explicitly. This is
1222              what the              what the
1223              <menuchoice>              <menuchoice>
1224              <guimenu>Layer</guimenu>              <guimenu>Layer</guimenu>
# Line 986  Line 1233 
1233    
1234    <chapter><title>Trouble Shooting</title>    <chapter><title>Trouble Shooting</title>
1235      <para>      <para>
1236        Here are a few problems that users have encountered when first using Thuban.
1237      </para>      </para>
1238      <variablelist>      <para>
1239    
1240      <varlistentry>      <itemizedlist>
     <term>After adding two or more layers nothing is being drawn in the  
     map window.  
     </term>  
1241      <listitem>      <listitem>
1242        <para>After adding two or more layers nothing is drawn in the map window.
1243        </para>
1244      <para>      <para>
1245      This is probably because the layers have different projections. Projections      This is probably because the layers have different projections. Projections
1246      must be set on all layers and on the map itself if the layer's projections      must be set on all layers and on the map itself if the layers' projections
1247      are different.      are different.
1248      </para>      </para>
1249      </listitem>      </listitem>
     </varlistentry>  
1250    
     <varlistentry>  
     <term>Thuban crashes on startup with the error  
         <literal>NameError: global name 'False' is not defined</literal>.  
     </term>  
1251      <listitem>      <listitem>
1252        <para>Thuban crashes on startup with the error
1253            <literal>NameError: global name 'False' is not defined</literal>.
1254        </para>
1255      <para>      <para>
1256      <varname>True</varname> and <varname>False</varname> were only introduced      <varname>True</varname> and <varname>False</varname> were only introduced
1257      in Python 2.2.1. Thuban depends on at least Python 2.2.1.      in Python 2.2.1. Thuban depends on at least Python 2.2.1.
1258      </para>      </para>
1259      </listitem>      </listitem>
     </varlistentry>  
1260    
1261      <varlistentry>      <listitem>
1262      <term>After compiling Thuban, Thuban crashes with an error similar to      <para>After compiling Thuban, Thuban crashes with an error similar to
1263          <literal>          <literal>
1264          ImportError: /usr/local//lib/thuban/Thuban/../Lib/wxproj.so: undefined symbol: __gxx_personality_v0          ImportError: /usr/local//lib/thuban/Thuban/../Lib/wxproj.so: undefined symbol: __gxx_personality_v0
1265          </literal>          </literal>
1266      </term>      </para>
     <listitem>  
1267      <para>      <para>
1268      Thuban depends on the wxWindows library. If Thuban is compiled with an      Thuban depends on the wxWindows library. If Thuban is compiled with an
1269      incompatible version of the compiler that wxWindows was compiled with      incompatible version of the compiler than wxWindows was compiled with
1270      this error may occur. Try compiling with a different version of the      this error may occur. Try compiling with a different version of the
1271      compilere      compiler.
1272      </para>      </para>
1273      </listitem>      </listitem>
1274      </varlistentry>      </itemizedlist>
1275      </variablelist>      </para>
1276        <para>
1277        If an error occurs Thuban will display a dialog indicating the error
1278        before closing. The text should be copied and reported to the
1279        <ulink url="http://thuban.intevation.org/bugtracker.html">
1280        Intevation bugtracker
1281        </ulink>.
1282        More information about the system is available from
1283        <menuchoice><guimenu>Help</guimenu><guimenuitem>About</guimenuitem></menuchoice> box.
1284        This should also be included in the bug report.
1285        <figure>
1286        <title>Error Dialog</title>
1287        <mediaobject>
1288        <imageobject><imagedata fileref="../images/8_int_error.png" format="PNG" scale="&imgscale;"/></imageobject>
1289        <imageobject><imagedata fileref="./images/8_int_error.eps" format="EPS" scale="&imgscale;"/></imageobject>
1290        </mediaobject>
1291        </figure>
1292        </para>
1293    
1294    </chapter>    </chapter>
1295    
# Line 1053  Line 1313 
1313      </varlistentry>      </varlistentry>
1314    
1315      <varlistentry>      <varlistentry>
1316      <term>dBASE file</term>      <term>dBase file</term>
1317      <listitem>      <listitem>
1318          <para>          <para>
1319          dBASE files are used to store the attributes for each layer. This          dBase files are used to store the attributes for each layer. This
1320          is closely associated with the Shapefile format. For detailed          is closely associated with the Shapefile format. For detailed
1321          specifications on the correct format of a dBASE file used with          specifications on the correct format of a dBase file used with
1322          Thuban please see the Technical Specification for the Shapefile          Thuban please see the Technical Specification for the Shapefile
1323          format above.          format above.
1324          </para>          </para>
1325      </listitem>      </listitem>
1326      </varlistentry>      </varlistentry>
1327    
1328        <varlistentry>
1329        <term>Raster files</term>
1330        <listitem>
1331            <para>
1332            Binding the GDAL library Thuban supports numerous raster file formats,
1333            see <ulink url="http://www.remotesensing.org/gdal/formats_list.html">
1334            GDAL format list</ulink> for details.</para>
1335    
1336            <para>Most commonly used is the <emphasis>TIFF/GeoTIFF</emphasis>
1337            format: Raster maps are provided as TIFF images, with an additional
1338            "world file" storing the geographic reference (usually with an
1339            extension ".tfw".
1340            </para>
1341        </listitem>
1342        </varlistentry>
1343    
1344      </variablelist>      </variablelist>
1345    </appendix>    </appendix>
1346    
# Line 1073  Line 1349 
1349      The following types of projections are directly support by      The following types of projections are directly support by
1350      Thuban. The specific values for each are provided by the user      Thuban. The specific values for each are provided by the user
1351      to create custom projections. Thuban comes with predefined      to create custom projections. Thuban comes with predefined
1352      projections and are available through the Projections dialog.      projections which are available through the Projections dialog.
1353        </para>
1354        <itemizedlist>
1355        <listitem>
1356            <para>Geographic</para>
1357            <itemizedlist>
1358            <listitem><para><literal>Ellipsoid</literal></para></listitem>
1359            <listitem><para>
1360                    <literal>Source Data</literal>: either Degrees or Radians
1361                    </para></listitem>
1362            </itemizedlist>
1363        </listitem>
1364        <listitem>
1365            <para>Lambert Conic Conformal</para>
1366        <itemizedlist>
1367            <listitem><para><literal>Ellipsoid</literal></para></listitem>
1368            <listitem><para><literal>Latitude of 1st standard parallel</literal></para></listitem>
1369            <listitem><para><literal>Latitude of 2nd standard parallel</literal></para></listitem>
1370            <listitem><para><literal>Central Meridian</literal></para></listitem>
1371            <listitem><para><literal>Latitude of Origin</literal></para></listitem>
1372            <listitem><para><literal>False Easting</literal> (meters)</para></listitem>
1373            <listitem><para><literal>False Northing</literal> (meters)</para></listitem>
1374        </itemizedlist>
1375        </listitem>
1376        <listitem>
1377            <para>Transverse Mercator</para>
1378        <itemizedlist>
1379            <listitem><para><literal>Ellipsoid</literal></para></listitem>
1380            <listitem><para><literal>Latitude</literal>of origin</para></listitem>
1381            <listitem><para><literal>Longitude</literal>at central meridian</para></listitem>
1382            <listitem><para><literal>Scale Factor</literal>at central meridian</para></listitem>
1383            <listitem><para><literal>False Easting</literal> (meters)</para></listitem>
1384            <listitem><para><literal>False Northing</literal> (meters)</para></listitem>
1385        </itemizedlist>
1386        </listitem>
1387        <listitem>
1388            <para>Universal Transverse Mercator</para>
1389        <itemizedlist>
1390            <listitem><para><literal>Ellipsoid</literal></para></listitem>
1391            <listitem><para><literal>Zone</literal>
1392                    (can be guessed appling the Propose button)</para></listitem>
1393            <listitem><para><literal>Southern Hemisphere</literal> flag</para></listitem>
1394        </itemizedlist>
1395        </listitem>
1396        </itemizedlist>
1397        
1398        <para>
1399        Thuban comes with a sample set of map projections for various
1400        European countries. Apart from the basic projection they differ
1401        especially in their parameterization:
1402        </para>
1403        <itemizedlist>
1404        <listitem><para>Belgium Datum 1972 (Lambert Conic Conformal)</para>
1405        </listitem>
1406    
1407        <listitem><para>Gauss-Boaga Zone 1 (Italy, Transverse Mercartor)</para>
1408        </listitem>
1409    
1410        <listitem><para>Gauss-Krueger Zone 2 (Germany, Transverse Mercartor)
1411        </para>
1412        </listitem>
1413    
1414        <listitem><para>Reseau Geodesique Francaise
1415        (France, Lambert Conic Conformal)</para>
1416        </listitem>
1417    
1418        <listitem><para>UK National Grid (United Kingdom, Transverse Mercartor)
1419        </para>
1420        </listitem>
1421        </itemizedlist>
1422    
1423        <para>
1424        Thuban uses the comprehensive PROJ library for projections. PROJ provides
1425        more than the four commonly used projections described above. If needed
1426        Thuban can be easily extended to a new projection covered by PROJ.
1427      </para>      </para>
     <variablelist>  
     <varlistentry>  
     <term>Geographic</term>  
     <listitem><para></para></listitem>  
     </varlistentry>  
     <varlistentry>  
     <term>Lambert Conic Conformal</term>  
     <listitem><para></para></listitem>  
     </varlistentry>  
     <varlistentry>  
     <term>Transverse Mercator</term>  
     <listitem><para></para></listitem>  
     </varlistentry>  
     <varlistentry>  
     <term>Universal Transverse Mercator</term>  
     <listitem><para></para></listitem>  
     </varlistentry>  
     </variablelist>  
1428    </appendix>    </appendix>
1429    
1430  </book>  </book>
1431    
Legend:
Removed from v.1490  
changed lines
  Added in v.1532
[email protected]
 ViewVC Help
Powered by ViewVC 1.1.26