/[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 1475 by jonathan, Thu Jul 24 11:19:51 2003 UTC revision 1490 by jonathan, Mon Jul 28 12:59:47 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 12  Line 13 
13      <author>      <author>
14        <firstname>Jan-Oliver</firstname><surname>Wagner</surname>        <firstname>Jan-Oliver</firstname><surname>Wagner</surname>
15      </author>      </author>
16        <author>
17          <firstname>Frank</firstname><surname>Koormann</surname>
18        </author>
19      <copyright>      <copyright>
20        <year>2003</year>        <year>2003</year>
21        <holder>Intevation GmbH</holder>        <holder>Intevation GmbH</holder>
# Line 56  Line 60 
60          <screenshot>          <screenshot>
61          <screeninfo>The Main Window</screeninfo>          <screeninfo>The Main Window</screeninfo>
62          <mediaobject>          <mediaobject>
63          <imageobject> <imagedata fileref="../images/1_2_mainwindow.png" format="PNG"/> </imageobject>          <imageobject> <imagedata fileref="../images/1_2_mainwindow.png" format="PNG" scale="&imgscale;"/> </imageobject>
64          <imageobject> <imagedata fileref="./images/1_2_mainwindow.ps" format="EPS"/> </imageobject>          <imageobject> <imagedata fileref="./images/1_2_mainwindow.ps" format="EPS" scale="&imgscale;"/> </imageobject>
65          <textobject><phrase>The Main Window</phrase></textobject>          <textobject><phrase>The Main Window</phrase></textobject>
66          <caption><para>The Main Window</para></caption>          <caption><para>The Main Window</para></caption>
67          </mediaobject>          </mediaobject>
# Line 113  Line 117 
117          <menuchoice>          <menuchoice>
118          <guimenu>File</guimenu>          <guimenu>File</guimenu>
119          <guimenuitem>New Session</guimenuitem>          <guimenuitem>New Session</guimenuitem>
120          </menuchoice>.          </menuchoice>.
   
121          If a session is already loaded and has been modified without          If a session is already loaded and has been modified without
122          being saved a prompt will ask if the current session should          being saved a prompt will ask if the current session should
123          be saved.          be saved. A new session consists of an empty map with no
124            layers and no tables.
125          </para>          </para>
126          </section>          </section>
127    
# Line 128  Line 131 
131          <menuchoice>          <menuchoice>
132          <guimenu>File</guimenu>          <guimenu>File</guimenu>
133          <guimenuitem>Open Session</guimenuitem>          <guimenuitem>Open Session</guimenuitem>
134          </menuchoice>.          </menuchoice>. A dialog box will open allowing the user to browse
135            for a Thuban Session file. Thuban session files end with
136            <varname>.thuban</varname>. Selecting a file a clicking
137            <guibutton>OK</guibutton> will load the session into Thuban.
138    
139          If a session is already loaded and has been modified without          If a session is already loaded and has been modified without
140          being saved a prompt will ask if the current session should          being saved a prompt will ask if the current session should
# Line 142  Line 148 
148          <menuchoice>          <menuchoice>
149          <guimenu>File</guimenu>          <guimenu>File</guimenu>
150          <guimenuitem>Save Session</guimenuitem>          <guimenuitem>Save Session</guimenuitem>
151          </menuchoice>.          </menuchoice>. A dialog box will open allowing the user to browse
152            the filesystem and select a place to save the session. Thuban
153            sessions should be saved under a name ending in
154            <varname>.thuban</varname>. If the file already exists the user
155            will be prompted to save under a different name or overwrite the
156            existing file.
157          </para>          </para>
158          </section>          </section>
159    
160          <section><title>The Session Info-Tree</title>          <section><title>The Session Info-Tree</title>
161            <para>
162            <screenshot>
163            <screeninfo>Session Info Tree</screeninfo>
164            <mediaobject>
165            <imageobject><imagedata fileref="../images/2_4_session_tree.png" format="PNG" scale="&imgscale;"/></imageobject>
166            <imageobject><imagedata fileref="./images/2_4_session_tree.eps" format="EPS" scale="&imgscale;"/></imageobject>
167            <textobject><phrase>Session Info Tree</phrase></textobject>
168            <caption><para>Session Info Tree</para></caption>
169            </mediaobject>
170            </screenshot>
171            </para>
172          <para>          <para>
173                  (primarily for developers)          The session info-tree is primarily intended for developers working
174            with Thuban. It displays many of the internal values for the session,
175            map, and layers. It can be opened from
176            <menuchoice>
177            <guimenu>File</guimenu>
178            <guimenuitem>Session Tree</guimenuitem>
179            </menuchoice>.
180          </para>          </para>
181          </section>          </section>
182    </chapter>    </chapter>
# Line 160  Line 187 
187      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
188      visually explore the data.      visually explore the data.
189      </para>      </para>
190        <para>
191        The map can have a name that will appear in the Thuban title bar.
192        The map name can be changed using
193        <menuchoice>
194        <guimenu>Map</guimenu>
195        <guimenuitem>Rename</guimenuitem>
196        </menuchoice>.
197        </para>
198        <para>
199        <inlinemediaobject>
200        <imageobject>
201        <imagedata fileref="../images/3_rename_map.png" format="PNG" scale="&imgscale;"/>
202        </imageobject>
203        <imageobject>
204        <imagedata fileref="./images/3_rename_map.eps" format="EPS" scale="&imgscale;"/>
205        </imageobject>
206        <textobject> <phrase>Rename Map</phrase> </textobject>
207        </inlinemediaobject>
208        </para>
209    
210          <section><title>Adding and Removing Layers</title>          <section><title>Adding and Removing Layers</title>
211          <para>          <para>
# Line 168  Line 214 
214          standard file format for storing geographic objects. Normally, these          standard file format for storing geographic objects. Normally, these
215          files have the extension ``.shp''. Associated with          files have the extension ``.shp''. Associated with
216          the object information is a database file which stores attributes for          the object information is a database file which stores attributes for
217          each shape in the Shapefile. This file, stored in DB2 format, usually          each shape in the Shapefile. This file, stored in dBASE format, usually
218          has the extension ``.dbf''. Both files should have the same base name.          has the extension ``.dbf''. Both files should have the same base name.
219          For example, if there is a Shapefile named roads.shp there should          For example, if there is a Shapefile named roads.shp there should
220          also be a file roads.dbf.          also be a file roads.dbf.
# Line 206  Line 252 
252          The ZoomIn tool          The ZoomIn tool
253          <inlinemediaobject>          <inlinemediaobject>
254          <imageobject>          <imageobject>
255          <imagedata fileref="../images/3_2_zoomin.png" format="PNG"/>          <imagedata fileref="../images/3_2_zoomin.png" format="PNG" scale="&imgscale;"/>
256          </imageobject>          </imageobject>
257          <imageobject>          <imageobject>
258          <imagedata fileref="./images/3_2_zoomin.eps" format="EPS"/>          <imagedata fileref="./images/3_2_zoomin.eps" format="EPS" scale="&imgscale;"/>
259          </imageobject>          </imageobject>
260          <textobject> <phrase>ZoomIn Tool</phrase> </textobject>          <textobject> <phrase>ZoomIn Tool</phrase> </textobject>
261          </inlinemediaobject>          </inlinemediaobject>
# Line 222  Line 268 
268          The ZoomOut tool          The ZoomOut tool
269          <inlinemediaobject>          <inlinemediaobject>
270          <imageobject>          <imageobject>
271          <imagedata fileref="../images/3_2_zoomout.png" format="PNG"/>          <imagedata fileref="../images/3_2_zoomout.png" format="PNG" scale="&imgscale;"/>
272          </imageobject>          </imageobject>
273          <imageobject>          <imageobject>
274          <imagedata fileref="./images/3_2_zoomout.eps" format="EPS"/>          <imagedata fileref="./images/3_2_zoomout.eps" format="EPS" scale="&imgscale;"/>
275          </imageobject>          </imageobject>
276          <textobject> <phrase>ZoomOut Tool</phrase> </textobject>          <textobject> <phrase>ZoomOut Tool</phrase> </textobject>
277          </inlinemediaobject>          </inlinemediaobject>
# Line 238  Line 284 
284          The Pan tool          The Pan tool
285          <inlinemediaobject>          <inlinemediaobject>
286          <imageobject>          <imageobject>
287          <imagedata fileref="../images/3_2_pan.png" format="PNG"/>          <imagedata fileref="../images/3_2_pan.png" format="PNG" scale="&imgscale;"/>
288          </imageobject>          </imageobject>
289          <imageobject>          <imageobject>
290          <imagedata fileref="./images/3_2_pan.eps" format="EPS"/>          <imagedata fileref="./images/3_2_pan.eps" format="EPS" scale="&imgscale;"/>
291          </imageobject>          </imageobject>
292          <textobject> <phrase>Pan Tool</phrase> </textobject>          <textobject> <phrase>Pan Tool</phrase> </textobject>
293          </inlinemediaobject>          </inlinemediaobject>
# Line 251  Line 297 
297          The Full Extent tool          The Full Extent tool
298          <inlinemediaobject>          <inlinemediaobject>
299          <imageobject>          <imageobject>
300          <imagedata fileref="../images/3_2_fullextent.png" format="PNG"/>          <imagedata fileref="../images/3_2_fullextent.png" format="PNG" scale="&imgscale;"/>
301          </imageobject>          </imageobject>
302          <imageobject>          <imageobject>
303          <imagedata fileref="./images/3_2_fullextent.eps" format="EPS"/>          <imagedata fileref="./images/3_2_fullextent.eps" format="EPS" scale="&imgscale;"/>
304          </imageobject>          </imageobject>
305          <textobject> <phrase>Full Extent Tool</phrase> </textobject>          <textobject> <phrase>Full Extent Tool</phrase> </textobject>
306          </inlinemediaobject>          </inlinemediaobject>
# Line 264  Line 310 
310          The Full Layer Extent tool          The Full Layer Extent tool
311          <inlinemediaobject>          <inlinemediaobject>
312          <imageobject>          <imageobject>
313          <imagedata fileref="../images/3_2_fulllayerextent.png" format="PNG"/>          <imagedata fileref="../images/3_2_fulllayerextent.png" format="PNG" scale="&imgscale;"/>
314          </imageobject>          </imageobject>
315          <imageobject>          <imageobject>
316          <imagedata fileref="./images/3_2_fulllayerextent.eps" format="EPS"/>          <imagedata fileref="./images/3_2_fulllayerextent.eps" format="EPS" scale="&imgscale;"/>
317          </imageobject>          </imageobject>
318          <textobject> <phrase>Full Layer Extent Tool</phrase> </textobject>          <textobject> <phrase>Full Layer Extent Tool</phrase> </textobject>
319          </inlinemediaobject>          </inlinemediaobject>
# Line 279  Line 325 
325          The Full Shape Extent tool          The Full Shape Extent tool
326          <inlinemediaobject>          <inlinemediaobject>
327          <imageobject>          <imageobject>
328          <imagedata fileref="../images/3_2_fullshapeextent.png" format="PNG"/>          <imagedata fileref="../images/3_2_fullshapeextent.png" format="PNG" scale="&imgscale;"/>
329          </imageobject>          </imageobject>
330          <imageobject>          <imageobject>
331          <imagedata fileref="./images/3_2_fullshapeextent.eps" format="EPS"/>          <imagedata fileref="./images/3_2_fullshapeextent.eps" format="EPS" scale="&imgscale;"/>
332          </imageobject>          </imageobject>
333          <textobject> <phrase>Full Shape Extent Tool</phrase> </textobject>          <textobject> <phrase>Full Shape Extent Tool</phrase> </textobject>
334          </inlinemediaobject>          </inlinemediaobject>
# Line 298  Line 344 
344          Objects on the map can be identified using the Identify tool          Objects on the map can be identified using the Identify tool
345          <inlinemediaobject>          <inlinemediaobject>
346          <imageobject>          <imageobject>
347          <imagedata fileref="../images/3_3_identify.png" format="PNG"/>          <imagedata fileref="../images/3_3_identify.png" format="PNG" scale="&imgscale;"/>
348          </imageobject>          </imageobject>
349          <imageobject>          <imageobject>
350          <imagedata fileref="./images/3_3_identify.eps" format="EPS"/>          <imagedata fileref="./images/3_3_identify.eps" format="EPS" scale="&imgscale;"/>
351          </imageobject>          </imageobject>
352          <textobject> <phrase>Identify Tool</phrase> </textobject>          <textobject> <phrase>Identify Tool</phrase> </textobject>
353          </inlinemediaobject>.          </inlinemediaobject>.
# Line 316  Line 362 
362          Objects can be labelled using the Label tool          Objects can be labelled using the Label tool
363          <inlinemediaobject>          <inlinemediaobject>
364          <imageobject>          <imageobject>
365          <imagedata fileref="../images/3_3_label.png" format="PNG"/>          <imagedata fileref="../images/3_3_label.png" format="PNG" scale="&imgscale;"/>
366          </imageobject>          </imageobject>
367          <imageobject>          <imageobject>
368          <imagedata fileref="./images/3_3_label.eps" format="EPS"/>          <imagedata fileref="./images/3_3_label.eps" format="EPS" scale="&imgscale;"/>
369          </imageobject>          </imageobject>
370          <textobject> <phrase>Label Tool</phrase> </textobject>          <textobject> <phrase>Label Tool</phrase> </textobject>
371          </inlinemediaobject>.          </inlinemediaobject>.
# Line 331  Line 377 
377          </section>          </section>
378    
379          <section><title>The Legend</title>          <section><title>The Legend</title>
380            <para>
381            <inlinemediaobject>
382            <imageobject>
383            <imagedata fileref="../images/3_5_legend.png" format="PNG" scale="&imgscale;"/>
384            </imageobject>
385            <imageobject>
386            <imagedata fileref="./images/3_5_legend.eps" format="EPS" scale="&imgscale;"/>
387            </imageobject>
388            <textobject> <phrase>Legend</phrase> </textobject>
389            </inlinemediaobject>
390            </para>
391          <para>          <para>
392          The Legend provides an overview of the layers in the map. Layers          The Legend provides an overview of the layers in the map. Layers
393          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 350  Line 407 
407          </para>          </para>
408          </section>          </section>
409    
410            <section><title>Exporting</title>
411            <para>
412            Under Windows, maps can be exported in Enhanced Metafile format
413            (<varname>.wmf</varname>)
414            from
415            <menuchoice>
416            <guimenu>Map</guimenu>
417            <guimenuitem>Export</guimenuitem>
418            </menuchoice>. Under other platforms this option is not available.
419            Clicking this menu item open a file selection dialog that lets the
420            user select a location to export the map.
421            </para>
422            </section>
423    
424          <section><title>Printing</title>          <section><title>Printing</title>
425          <para>          <para>
426          The map can be printed using          The map can be printed using
# Line 357  Line 428 
428          <guimenu>Map</guimenu>          <guimenu>Map</guimenu>
429          <guimenuitem>Print</guimenuitem>          <guimenuitem>Print</guimenuitem>
430          </menuchoice>. A standard printing dialog will open allowing the          </menuchoice>. A standard printing dialog will open allowing the
431          user to configure the printer.          user to configure the printer. This dialog will differ depending
432            on which platform Thuban is running.
433          </para>          </para>
434          </section>          </section>
435    
436    </chapter>    </chapter>
437    
438    <chapter><title>Layer Management</title>    <chapter><title>Layer Management</title>
# Line 382  Line 455 
455    
456          <section><title>Properties</title>          <section><title>Properties</title>
457          <para>          <para>
458          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
459          how it is drawn on the map. Polygons and points can be drawn with an          legend. The menu option
460          outline color and a fill color, while lines have only a line color.          <menuchoice>
461            <guimenu>Layer</guimenu>
462            <guimenuitem>Properties</guimenuitem>
463            </menuchoice> opens a dialog that displays a layer's properties.
464            All layers have a title and it can be modified in the text field
465            provided. The type of layer is also shows. If the type is type
466            of shape (polygon, arc, point) the classification table will be
467            shown. Image layers have no other properties other than title
468            and type.
469            </para>
470            <para>
471            <screenshot>
472            <screeninfo>Properties Window</screeninfo>
473            <mediaobject>
474            <imageobject><imagedata fileref="../images/4_2_layer_properties.png" format="PNG" scale="&imgscale;"/></imageobject>
475            <imageobject><imagedata fileref="./images/4_2_layer_properties.eps" format="EPS" scale="&imgscale;"/></imageobject>
476            <textobject><phrase>Properties Window</phrase></textobject>
477            <caption><para>The Properties Window for a Shape Layer</para></caption>
478            </mediaobject>
479            </screenshot>
480            </para>
481            <para>
482            <screenshot>
483            <screeninfo>Properties Window</screeninfo>
484            <mediaobject>
485            <imageobject><imagedata fileref="../images/4_2_raster_layer_properties.png" format="PNG" scale="&imgscale;"/></imageobject>
486            <imageobject><imagedata fileref="./images/4_2_raster_layer_properties.eps" format="EPS" scale="&imgscale;"/></imageobject>
487            <textobject><phrase>Properties Window</phrase></textobject>
488            <caption><para>The Properties Window for an Image Layer</para></caption>
489            </mediaobject>
490            </screenshot>
491          </para>          </para>
492          </section>          </section>
493    
# Line 407  Line 510 
510          </para>          </para>
511          </section>          </section>
512    
         <section><title>Sequence</title>  
         <para>  
         </para>  
         </section>  
   
513          <section><title>Duplication</title>          <section><title>Duplication</title>
514          <para>          <para>
515          Layers and all their properties, including classifications, can          Layers and all their properties, including classifications, can
# Line 473  Line 571 
571          button.          button.
572          </para>          </para>
573          <para>          <para>
574            <screenshot>
575            <screeninfo>Properties Window</screeninfo>
576            <mediaobject>
577            <imageobject><imagedata fileref="../images/5_classification.png" format="PNG" scale="&imgscale;"/></imageobject>
578            <imageobject><imagedata fileref="./images/5_classification.eps" format="EPS" scale="&imgscale;"/></imageobject>
579            <textobject><phrase>Properties Window</phrase></textobject>
580            <caption><para>The Properties Window with Classifications</para></caption>
581            </mediaobject>
582            </screenshot>
583            </para>
584            <para>
585          The order of the groups in the classification is significant          The order of the groups in the classification is significant
586          except for the DEFAULT group, which remains at the top. When shapes          except for the DEFAULT group, which remains at the top. When shapes
587          are matched against groups the matching begins at the first group          are matched against groups the matching begins at the first group
# Line 518  Line 627 
627    
628          <section><title>Generating Classes</title>          <section><title>Generating Classes</title>
629          <para>          <para>
630            <screenshot>
631            <screeninfo>Generate Class</screeninfo>
632            <mediaobject>
633            <imageobject><imagedata fileref="../images/5_3_genclass.png" format="PNG" scale="&imgscale;"/></imageobject>
634            <imageobject><imagedata fileref="./images/5_3_genclass.eps" format="EPS" scale="&imgscale;"/></imageobject>
635            <textobject><phrase>Generate Class</phrase></textobject>
636            <caption><para>The Generate Classifications Dialog</para></caption>
637            </mediaobject>
638            </screenshot>
639            </para>
640            <para>
641          Creating a classification by hand can be tedious.          Creating a classification by hand can be tedious.
642          Thuban, therefore, provides a means of generating an entire          Thuban, therefore, provides a means of generating an entire
643          classification at once while still giving the user control over          classification at once while still giving the user control over
# Line 584  Line 704 
704      <guimenu>Layer</guimenu>      <guimenu>Layer</guimenu>
705      <guimenuitem>Projection</guimenuitem>      <guimenuitem>Projection</guimenuitem>
706      </menuchoice>.      </menuchoice>.
707        <screenshot>
708        <screeninfo>Projection Window</screeninfo>
709        <mediaobject>
710        <imageobject><imagedata fileref="../images/6_projection.png" format="PNG" scale="&imgscale;"/></imageobject>
711        <imageobject><imagedata fileref="./images/6_projection.eps" format="EPS" scale="&imgscale;"/></imageobject>
712        <textobject><phrase>Projection Window</phrase></textobject>
713        <caption><para>The Projection Window</para></caption>
714        </mediaobject>
715        </screenshot>
716      </para>      </para>
717      <para>      <para>
718      Thuban is distributed with a sample collection of projections. The      Thuban is distributed with a sample collection of projections. The
# Line 596  Line 725 
725          The available projections are listed on the left. If the layer          The available projections are listed on the left. If the layer
726          or map already has a projection it will be initially highlighted          or map already has a projection it will be initially highlighted
727          and will end with <varname>(current)</varname>. Selecting          and will end with <varname>(current)</varname>. Selecting
728          <varname>None</varname>will cause Thuban to use the data as          <varname>&lt;None&gt;</varname> will cause Thuban to use the data as
729          it appears in the source file and will not use a projection.          it appears in the source file and will not use a projection.
730          </para>          </para>
731      </section>      </section>
# Line 632  Line 761 
761    
762    <chapter><title>Table Management</title>    <chapter><title>Table Management</title>
763      <para>      <para>
764        Thuban distinguishes two different types of tables: Attribute tables
765        (which belong to a layer) and usual data tables. Both provide in
766            general the same functionality with the difference that actions on an
767        attribute table might also effect the map display.
768      </para>      </para>
769    
770        <section><title>Table View</title>
771            <para>
772            <screenshot>
773            <screeninfo>Table View</screeninfo>
774            <mediaobject>
775            <imageobject><imagedata fileref="../images/7_1_table_view.png" format="PNG" scale="&imgscale;"/></imageobject>
776            <imageobject><imagedata fileref="./images/7_1_table_view.eps" format="EPS" scale="&imgscale;"/></imageobject>
777            <textobject><phrase>Table View</phrase></textobject>
778            <caption><para>The Table View</para></caption>
779            </mediaobject>
780            </screenshot>
781            </para>
782            <para>
783            Thuban provides a standard dialog to display table contents, the
784            Table View. The view falls into five sections: The title, selections,
785            the table grid, export functions and the status bar.
786            </para>
787            <para>
788            The title bar identifies the table with it's name.
789            </para>
790            <para>
791            The functions box let the user perform simple analysis on the data
792            based on comparisons: First choice must be a field identifier of the
793            table, the second choice determines the type of comparison. The third
794            choice can be either a specific value (interpreted as numerical
795            or string depending on the type of the first field) or a second field
796            identifier. Thus you can perform analysis like selecting all
797            records where "population > 10000" or
798            "cars_per_habitants <  bike_per_habitants" (note that the field names
799            are only explanatory, the currently considered dBASE files allow only
800            11 character field names).
801          
802            Selections can be combined, either by applying a selection only on
803            a previously selected set of records or by adding the results of a
804            selection to a previous set. The default is that a selection replaces
805            earlier results.
806            </para>
807            <para>
808            The table grid shows the contents of the table (a record per column),
809            with highlighted selection results. Columns and rows can be resized.
810            </para>
811            <para>
812            The contents of a table can be exported into a file, either dBASE
813            format (DBF) or comma seperated values (CSV). The
814            <guibutton>Export</guibutton> button
815            raises a file dialog to specify a path and file name, the export type
816            is determined by the file extension (either .dbf or .csv).
817    
818            The <guibutton>Export Selection</guibutton> button works similarly
819            but exports only the selected records.
820    
821            The <guibutton>Close</guibutton> button closes the table view window.
822            This is different from the menu item
823            <menuchoice>
824            <guimenu>Table</guimenu>
825            <guimenuitem>Close</guimenuitem>
826            </menuchoice> which unloads the table from Thuban.
827            </para>
828            <para>
829            The status bar displays some statistics about the table and optional
830            selection results.
831            </para>
832        </section>
833    
834        <section><title>General Functionality (Menu Table)</title>
835            <para>
836            The general functions affect all tables open in Thuban. Attribute
837            tables are considered here as usual data tables (with the exception
838            that they cannot be closed).
839            </para>
840            <section><title>Open</title>
841                <para>
842                The
843                <menuchoice>
844                <guimenu>Table</guimenu>
845                <guimenuitem>Open</guimenuitem>
846                </menuchoice>
847                item raises a file dialog to let you select a
848                dBASE file from the file system to be loaded into Thuban read-only.
849                On OK the selected file is loaded and a table view is opened.
850                </para>
851            </section>
852    
853            <section><title>Close</title>
854                <para>
855                The
856                <menuchoice>
857                <guimenu>Table</guimenu>
858                <guimenuitem>Close</guimenuitem>
859                </menuchoice>
860                item raises a dialog listing the currently open
861                data tables
862                (loaded via
863                <menuchoice>
864                <guimenu>Table</guimenu>
865                <guimenuitem>Open</guimenuitem>
866                </menuchoice>). Selected tables are dereferenced on confirmation.
867                Since tables are opened read-only the contents of the tables are
868                not affected.
869    
870                A still open table view is closed as well.
871    
872                Tables used in a join cannot be closed.
873                </para>
874            </section>
875    
876            <section><title>Rename</title>
877                <para>
878                <menuchoice>
879                <guimenu>Table</guimenu>
880                <guimenuitem>Rename</guimenuitem>
881                </menuchoice> changes the table title.
882                </para>
883            </section>
884    
885            <section><title>Show</title>
886                <para>
887                The
888                <menuchoice>
889                <guimenu>Table</guimenu>
890                <guimenuitem>Show</guimenuitem>
891                </menuchoice>
892                item raises a list of available tables (explicitly
893                loaded, attribute tables, results of a join). Selected tables are
894                show in tables views on <guibutton>OK</guibutton>
895                </para>
896            </section>
897    
898            <section><title>Join</title>
899                <para>
900                <screenshot>
901                <screeninfo>Join Tables</screeninfo>
902                <mediaobject>
903                <imageobject><imagedata fileref="../images/7_2_5_join.png" format="PNG" scale="&imgscale;"/></imageobject>
904                <imageobject><imagedata fileref="./images/7_2_5_join.eps" format="EPS" scale="&imgscale;"/></imageobject>
905                <textobject><phrase>Join Tables</phrase></textobject>
906                <caption><para>The Join Tables Dialog</para></caption>
907                </mediaobject>
908                </screenshot>
909                </para>
910                <para>
911                The
912                <menuchoice>
913                <guimenu>Table</guimenu>
914                <guimenuitem>Join</guimenuitem>
915                </menuchoice>
916                item raises a dialog to specify the two tables to be
917                joined. The join results in a new table named 'Join of "left table"
918                and "right table"'.
919    
920                The dialog let you select the two tables to be joined and the two
921                fields the join has to be performed on. By default the new
922                table contains only those records which are mathced by the join.
923    
924                If you want to preserve the records of the left table you can
925                perform an outer join. The fields from the right table for records
926                not matched by the join are filled with <varname>None</varname> in
927                this case.
928                </para>
929            </section>
930    
931        </section>
932        <section><title>Attribute Tables</title>
933            <para>
934                To clearly separate between both types, Thuban provides
935            functionality regarding the attribute tables under the Layer menu.
936            </para>
937    
938            <section><title>Show Table</title>
939                <para>
940                <menuchoice>
941                <guimenu>Layer</guimenu>
942                <guimenuitem>Show Table</guimenuitem>
943                </menuchoice>
944                opens the attribute table of the currently active layer in a table
945                view.
946    
947                In addition to the functionality described above selections
948                affect also the map display: objects related to selected records
949                are highlighted.
950                </para>
951            </section>
952    
953            <section><title>Join Table</title>
954                <para>
955                In difference to the join described above the join results not in a
956                new table. The attribute table of the currently active layer is the
957                left table and other tables are joined to this table. The results of
958                the join are available for classifications.
959    
960                As a consequence, the join cannot result in fewer
961                records than the source attribute table. The user is warned if the
962                right table does not fulfill this constraint. An outer join must be
963                used in such cases.
964                </para>
965            </section>
966    
967            <section><title>Unjoin Table</title>
968                <para>
969                As said above, a normal table cannot be closed while it is still
970                used in a join. While the joined table resulting from a join of
971                normal tables can be simply closed (and thereby dereferencing
972                the source tables), this is not possible for attribute tables.
973    
974                Hence joins on attribute tables must be solved explicitely. This is
975                what the
976                <menuchoice>
977                <guimenu>Layer</guimenu>
978                <guimenuitem>Unjoin Table</guimenuitem>
979                </menuchoice>
980                item is used for: The last join for the currently
981                active layer is solved.
982                </para>
983            </section>
984        </section>
985    </chapter>    </chapter>
986    
987    <chapter><title>Trouble Shooting</title>    <chapter><title>Trouble Shooting</title>
988      <para>      <para>
989      </para>      </para>
990        <variablelist>
991    
992        <varlistentry>
993        <term>After adding two or more layers nothing is being drawn in the
994        map window.
995        </term>
996        <listitem>
997        <para>
998        This is probably because the layers have different projections. Projections
999        must be set on all layers and on the map itself if the layer's projections
1000        are different.
1001        </para>
1002        </listitem>
1003        </varlistentry>
1004    
1005        <varlistentry>
1006        <term>Thuban crashes on startup with the error
1007            <literal>NameError: global name 'False' is not defined</literal>.
1008        </term>
1009        <listitem>
1010        <para>
1011        <varname>True</varname> and <varname>False</varname> were only introduced
1012        in Python 2.2.1. Thuban depends on at least Python 2.2.1.
1013        </para>
1014        </listitem>
1015        </varlistentry>
1016    
1017        <varlistentry>
1018        <term>After compiling Thuban, Thuban crashes with an error similar to
1019            <literal>
1020            ImportError: /usr/local//lib/thuban/Thuban/../Lib/wxproj.so: undefined symbol: __gxx_personality_v0
1021            </literal>
1022        </term>
1023        <listitem>
1024        <para>
1025        Thuban depends on the wxWindows library. If Thuban is compiled with an
1026        incompatible version of the compiler that wxWindows was compiled with
1027        this error may occur. Try compiling with a different version of the
1028        compilere
1029        </para>
1030        </listitem>
1031        </varlistentry>
1032        </variablelist>
1033    
1034    </chapter>    </chapter>
1035    
1036    <appendix><title>Supported Data Sources</title>    <appendix><title>Supported Data Sources</title>
# Line 646  Line 1039 
1039      <variablelist>      <variablelist>
1040      <varlistentry>      <varlistentry>
1041      <term>Shapefile</term>      <term>Shapefile</term>
1042      <listitem><para></para></listitem>      <listitem>
1043            <para>
1044            The Shapefile format has become a standard format for saving
1045            geographic vector information. It supports polygons, lines, and
1046            points.
1047            
1048            <ulink url="http://www.esri.com/library/whitepapers/pdfs/shapefile.pdf">
1049            Technical Specification.
1050            </ulink>  
1051            </para>
1052        </listitem>
1053      </varlistentry>      </varlistentry>
1054    
1055      <varlistentry>      <varlistentry>
1056      <term>DB2 file</term>      <term>dBASE file</term>
1057      <listitem><para></para></listitem>      <listitem>
1058            <para>
1059            dBASE files are used to store the attributes for each layer. This
1060            is closely associated with the Shapefile format. For detailed
1061            specifications on the correct format of a dBASE file used with
1062            Thuban please see the Technical Specification for the Shapefile
1063            format above.
1064            </para>
1065        </listitem>
1066      </varlistentry>      </varlistentry>
1067    
1068      </variablelist>      </variablelist>
# Line 659  Line 1070 
1070    
1071    <appendix><title>Supported Projections</title>    <appendix><title>Supported Projections</title>
1072      <para>      <para>
1073        The following types of projections are directly support by
1074        Thuban. The specific values for each are provided by the user
1075        to create custom projections. Thuban comes with predefined
1076        projections and are available through the Projections dialog.
1077      </para>      </para>
1078      <variablelist>      <variablelist>
1079      <varlistentry>      <varlistentry>
1080      <term>Geographic</term>      <term>Geographic</term>
1081      <listitem><para>Geographic</para></listitem>      <listitem><para></para></listitem>
1082      </varlistentry>      </varlistentry>
1083      <varlistentry>      <varlistentry>
1084      <term>Lambert Conic Conformal</term>      <term>Lambert Conic Conformal</term>
1085      <listitem><para>Lambert Conic Conformal</para></listitem>      <listitem><para></para></listitem>
1086      </varlistentry>      </varlistentry>
1087      <varlistentry>      <varlistentry>
1088      <term>Transverse Mercator</term>      <term>Transverse Mercator</term>
1089      <listitem><para>Transverse Mercator</para></listitem>      <listitem><para></para></listitem>
1090      </varlistentry>      </varlistentry>
1091      <varlistentry>      <varlistentry>
1092      <term>Universal Transverse Mercator</term>      <term>Universal Transverse Mercator</term>
1093      <listitem><para>Universal Transverse Mercator</para></listitem>      <listitem><para></para></listitem>
1094      </varlistentry>      </varlistentry>
1095      </variablelist>      </variablelist>
1096    </appendix>    </appendix>
Legend:
Removed from v.1475  
changed lines
  Added in v.1490
[email protected]
 ViewVC Help
Powered by ViewVC 1.1.26