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

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

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

revision 1478 by frank, Thu Jul 24 17:00:25 2003 UTC revision 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 59  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 116  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 131  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 145  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 163  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 171  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 209  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 225  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 241  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 254  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 267  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 282  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 301  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 319  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 334  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 353  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 360  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 385  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 410  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 476  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 521  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 587  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 599  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 635  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      Thuban distinguishes two different types of tables: Attribute tables
765              (which belong to a layer) and usual data tables. Both provide in      (which belong to a layer) and usual data tables. Both provide in
766          general the same functionality with the difference that actions on an          general the same functionality with the difference that actions on an
767              attribute table might also effect the map display.      attribute table might also effect the map display.
768      </para>      </para>
769    
770      <section><title>Table View</title>      <section><title>Table View</title>
771        <para>          <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          Thuban provides a standard dialog to display table contents, the
784          Table View. The view falls into five sections: The title, selections,          Table View. The view falls into five sections: The title, selections,
785          the table grid, export functions and the status bar.          the table grid, export functions and the status bar.
786        </para>          </para>
787        <para>          <para>
788          The title bar identifies the table with it's name.          The title bar identifies the table with it's name.
789        </para>          </para>
790        <para>          <para>
791          The functions box let the user perform simple analysis on the data          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          based on comparisons: First choice must be a field identifier of the
793          table, the second choice determines the type of comparison. The third          table, the second choice determines the type of comparison. The third
# Line 659  Line 796 
796          identifier. Thus you can perform analysis like selecting all          identifier. Thus you can perform analysis like selecting all
797          records where "population > 10000" or          records where "population > 10000" or
798          "cars_per_habitants <  bike_per_habitants" (note that the field names          "cars_per_habitants <  bike_per_habitants" (note that the field names
799          are only explanatory, the currently considered dbase files allow only          are only explanatory, the currently considered dBASE files allow only
800          11 character field names).          11 character field names).
801                  
802          Selections can be combined, either by applying a selection only on          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          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          selection to a previous set. The default is that a selection replaces
805          earlier results.          earlier results.
806        </para>          </para>
807        <para>          <para>
808          The table grid shows the contents of the table (a record per column),          The table grid shows the contents of the table (a record per column),
809          with highlighted selection results. Columns and rows can be resized.          with highlighted selection results. Columns and rows can be resized.
810        </para>          </para>
811        <para>          <para>
812          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
813          format (DBF) or comma seperated values (CSV). The 'Export' button          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          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).          is determined by the file extension (either .dbf or .csv).
817    
818          The 'Export Selection' button works similar but exports only the          The <guibutton>Export Selection</guibutton> button works similarly
819          selected records.          but exports only the selected records.
820    
821          The 'Close' button closes the table view. In difference to the          The <guibutton>Close</guibutton> button closes the table view window.
822          menu item 'Close' just the dialog is closed, the table is still loaded          This is different from the menu item
823          in Thuban.          <menuchoice>
824        </para>          <guimenu>Table</guimenu>
825        <para>          <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          The status bar displays some statistics about the table and optional
830          selection results.          selection results.
831        </para>          </para>
832      </section>      </section>
833    
834      <section><title>General Functionality (Menu Table)</title>      <section><title>General Functionality (Menu Table)</title>
835        <para>          <para>
836          The general functions affect all tables open in Thuban. Attribute          The general functions affect all tables open in Thuban. Attribute
837          tables are considered as here as usual data tables (with the exception          tables are considered here as usual data tables (with the exception
838          that they cannot be closed).          that they cannot be closed).
       </para>  
       <section><title>Open</title>  
         <para>  
           The 'Open' item raises a file dialog to let you select a  
           dbase file from the file system to be loaded into Thuban read-only.  
           On OK the selected file is loaded and a table view is opened.  
         </para>  
       </section>  
   
       <section><title>Close</title>  
         <para>  
           The 'Close' item raises a dialog listing the currently open  
           data tables (loaded via the 'Open' functionality'). You can select  
           tables which are dereferenced on confirmation. Since tables are  
           opened read-only the contents of the tables are not affected.  
   
           A still open table view is closed as well.  
   
           Tables used in a join can not be closed.  
         </para>  
       </section>  
   
       <section><title>Rename</title>  
         <para>  
           Changes the table title.  
839          </para>          </para>
840        </section>          <section><title>Open</title>
841                <para>
842        <section><title>Show</title>              The
843          <para>              <menuchoice>
844            The 'Show' item raises a list of available tables (explicitly loaded,           attribute tables, results of a join). Selected tables are show in              <guimenu>Table</guimenu>
845            tables views on 'OK'.                        <guimenuitem>Open</guimenuitem>
846          </para>              </menuchoice>
847        </section>              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        <section><title>Join</title>              On OK the selected file is loaded and a table view is opened.
850          <para>              </para>
851            The 'Join' item raises a dialog to specify the two tables to be          </section>
852            joined. The join results in a new table named 'Join of "left table"  
853            and "right table"'.          <section><title>Close</title>
854                <para>
855            The dialog let you select the two tables to be joined and the two              The
856            fields the join has to be performed on. By default the new              <menuchoice>
857            table contains only those records which are mathced by the join.              <guimenu>Table</guimenu>
858                <guimenuitem>Close</guimenuitem>
859            If you want to preserve the records of the left table you can perform              </menuchoice>
860            an outer join. The fields from the right table for records not              item raises a dialog listing the currently open
861            matched by the join are filled with <varname>None</varname> in this              data tables
862            case.              (loaded via
863          </para>              <menuchoice>
864        </section>              <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>      </section>
932      <section><title>Attribute Tables</title>      <section><title>Attribute Tables</title>
     <para>  
             To clearly separate between both types, Thuban provides functionality  
             regarding the attribute tables under the Layer menu.  
     </para>  
   
       <section><title>Show Table</title>  
933          <para>          <para>
934            Opens the attribute table of the currently active layer in a table              To clearly separate between both types, Thuban provides
935            view.          functionality regarding the attribute tables under the Layer menu.
   
           In addition to the functionality described above selections  
           affect also the map display: objects related to selected records  
           are highlighted.  
936          </para>          </para>
       </section>  
937    
938        <section><title>Join Table</title>          <section><title>Show Table</title>
939          <para>              <para>
940             In difference to the join described above the join results not in a              <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              new table. The attribute table of the currently active layer is the
957              left table and other tables are join to this table. Results of the              left table and other tables are joined to this table. The results of
958              join in turn are available for classifications.              the join are available for classifications.
959    
960              As a consequence of the above the join cannot result in less              As a consequence, the join cannot result in fewer
961              records than the source attribute table. You are warned if the              records than the source attribute table. The user is warned if the
962              right table does not fulfill this constraint. Use an outer join              right table does not fulfill this constraint. An outer join must be
963              in such cases.              used in such cases.
964          </para>              </para>
965        </section>          </section>
966    
967        <section><title>Unjoin Table</title>          <section><title>Unjoin Table</title>
968          <para>              <para>
969              As said above, a usual table can not be closed while still used in              As said above, a normal table cannot be closed while it is still
970              a join. While the join table resulting from a join of usual tables              used in a join. While the joined table resulting from a join of
971              can be simply closed (and therewith dereferences the source tables)              normal tables can be simply closed (and thereby dereferencing
972              this is not possible for attribute tables.              the source tables), this is not possible for attribute tables.
973    
974              Hence joins on attribute tables must be solved explicitely. This is              Hence joins on attribute tables must be solved explicitely. This is
975              what the 'Unjoin' item is used for: The last join for the currently              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.              active layer is solved.
982          </para>              </para>
983        </section>          </section>
   
984      </section>      </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 806  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 819  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.1478  
changed lines
  Added in v.1490
[email protected]
 ViewVC Help
Powered by ViewVC 1.1.26