/[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 1491 by jonathan, Tue Jul 29 08:25:59 2003 UTC revision 1533 by jonathan, Thu Jul 31 12:43:27 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. Thuban depends on the following packages. These
52            packages can also 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            <itemizedlist>
57                <listitem><para>Python 2.2.1 (<literal>http://www.python.org</literal>)</para></listitem>
58                <listitem><para>wxWindows 2.4 (<literal>http://www.wxwindows.org</literal>)</para></listitem>
59                <listitem><para>wxPython 2.4 (<literal>http://www.wxpython.org</literal>)</para></listitem>
60                <listitem><para>proj 4.4.5 Projection Library (<literal>http://www.remotesensing.org/proj/</literal>)</para></listitem>
61                <listitem><para>GDAL 1.1.8 (<literal>http://www.remotesensing.org/gdal/</literal>)</para></listitem>
62                <listitem><para>SQLite 2.8.3 (<literal>http://www.hwaci.com/sw/sqlite/</literal>)</para></listitem>
63                <listitem><para>PySQLite 0.4.3 (<literal>http://pysqlite.sourceforge.net</literal>)</para></listitem>
64                </itemizedlist>
65          </para>          </para>
66          </section>          </section>
67    
68          <section><title>The Main Window</title>          <section><title>The Main Window</title>
69          <para>          <para>
70          <screenshot>          <figure>
71          <screeninfo>The Main Window</screeninfo>          <title>The Main Window</title>
72          <mediaobject>          <mediaobject>
73          <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>
74          <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>  
75          </mediaobject>          </mediaobject>
76          </screenshot>          </figure>
77          </para>          </para>
78    
79          <para>          <para>
# Line 101  Line 109 
109          The tool bar provides quick access to the commonly needed tools.          The tool bar provides quick access to the commonly needed tools.
110          By hovering over each button the user can see a short messages          By hovering over each button the user can see a short messages
111          describing what the tool does. The tools provided are Zoom In, Zoom          describing what the tool does. The tools provided are Zoom In, Zoom
112          Out, Pan, Full Extent, Full Layer Extent, Full Shape Extent, Indentify,          Out, Pan, Full Extent, Full Layer Extent, Full Shape Extent, Identify,
113          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
114          in the manual.          in the manual.
115          </para>          </para>
# Line 149  Line 157 
157          <guimenu>File</guimenu>          <guimenu>File</guimenu>
158          <guimenuitem>Save Session</guimenuitem>          <guimenuitem>Save Session</guimenuitem>
159          </menuchoice>. A dialog box will open allowing the user to browse          </menuchoice>. A dialog box will open allowing the user to browse
160          the filesystem and select a place to save the session. Thuban          the file system and select a place to save the session. Thuban
161          sessions should be saved under a name ending in          sessions should be saved under a name ending in
162          <varname>.thuban</varname>. If the file already exists the user          <varname>.thuban</varname>. If the file already exists the user
163          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 167 
167    
168          <section><title>The Session Info-Tree</title>          <section><title>The Session Info-Tree</title>
169          <para>          <para>
170          <screenshot>          <figure>
171          <screeninfo>Session Info Tree</screeninfo>          <title>Session Info Tree</title>
172          <mediaobject>          <mediaobject>
173          <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>
174          <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>  
175          </mediaobject>          </mediaobject>
176          </screenshot>          </figure>
177          </para>          </para>
178          <para>          <para>
179          The session info-tree is primarily intended for developers working          The session info-tree is primarily intended for developers working
# Line 209  Line 215 
215    
216          <section><title>Adding and Removing Layers</title>          <section><title>Adding and Removing Layers</title>
217          <para>          <para>
218          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
219          and image layers. Shape layers are stored in Shapefile format, a          and image layers. Shape layers are stored in Shapefile format, a
220          standard file format for storing geographic objects. These          standard file format for storing geographic objects. These
221          files have the extension ``.shp''. Associated with          files have the extension ``.shp''. Associated with
222          the shape file is a database file which stores attributes for          the shape file is a database file which stores attributes for
223          each shape in the shape file. This file, in dBASE format,          each shape in the shape file. This file, in dBase format,
224          has the extension ``.dbf''. Both files must have the same base name.          has the extension ``.dbf''. Both files must have the same base name.
225          For example, if there is a shape file named roads.shp there must          For example, if there is a shape file named roads.shp there must
226          also be a file roads.dbf.          also be a file roads.dbf.
# Line 248  Line 254 
254          the tool bar or from the          the tool bar or from the
255          <menuchoice><guimenu>Map</guimenu></menuchoice> menu.          <menuchoice><guimenu>Map</guimenu></menuchoice> menu.
256          </para>          </para>
257            <itemizedlist>
258            <listitem>
259          <para>          <para>
260          The ZoomIn tool          The ZoomIn tool
261          <inlinemediaobject>          <inlinemediaobject>
# Line 261  Line 269 
269          </inlinemediaobject>          </inlinemediaobject>
270          enlarges a region of the map. Clicking once on the map          enlarges a region of the map. Clicking once on the map
271          will double the magnification and center the map on the point that          will double the magnification and center the map on the point that
272          was clicked. Clicking and dragging selects a region that will          was clicked. Clicking and dragging selects a region that will be
273          enlarged to fit the window.          enlarged to fit the window.
274          </para>          </para>
275            </listitem>
276            <listitem>
277          <para>          <para>
278          The ZoomOut tool          The ZoomOut tool
279          <inlinemediaobject>          <inlinemediaobject>
# Line 280  Line 290 
290          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
291          scaled to fit into that box.          scaled to fit into that box.
292          </para>          </para>
293            </listitem>
294            <listitem>
295          <para>          <para>
296          The Pan tool          The Pan tool
297          <inlinemediaobject>          <inlinemediaobject>
# Line 293  Line 305 
305          </inlinemediaobject>          </inlinemediaobject>
306          allows the user to move the map around by clicking and dragging.          allows the user to move the map around by clicking and dragging.
307          </para>          </para>
308            </listitem>
309            <listitem>
310          <para>          <para>
311          The Full Extent tool          The Full Extent tool
312          <inlinemediaobject>          <inlinemediaobject>
# Line 306  Line 320 
320          </inlinemediaobject>          </inlinemediaobject>
321          rescales the viewable region so that the entire map is visible.          rescales the viewable region so that the entire map is visible.
322          </para>          </para>
323            </listitem>
324            <listitem>
325          <para>          <para>
326          The Full Layer Extent tool          The Full Layer Extent tool
327          <inlinemediaobject>          <inlinemediaobject>
# Line 321  Line 337 
337          layer fits within the window. If no layer is selected this button          layer fits within the window. If no layer is selected this button
338          will be disabled.          will be disabled.
339          </para>          </para>
340            </listitem>
341            <listitem>
342          <para>          <para>
343          The Full Shape Extent tool          The Full Shape Extent tool
344          <inlinemediaobject>          <inlinemediaobject>
# Line 335  Line 353 
353          rescales the viewable region so that the currently selected          rescales the viewable region so that the currently selected
354          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
355          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
356          selected this button will be disabled.          selected this button will be disabled. This feature is especially
357            helpful when identifying an object related to a selected record
358            in a tableview (see below).
359    
360          </para>          </para>
361            </listitem>
362            </itemizedlist>
363          </section>          </section>
364    
365          <section><title>Object Identification</title>          <section><title>Object Identification</title>
# Line 353  Line 376 
376          </inlinemediaobject>.          </inlinemediaobject>.
377          Clicking on an object selects that object and opens a dialog which          Clicking on an object selects that object and opens a dialog which
378          shows all the table attributes for that object. Any current selection          shows all the table attributes for that object. Any current selection
379          is lost.          is lost. Objects on the map are typically shapes and this document
380            will often refer to objects as shapes.
381          </para>          </para>
382          </section>          </section>
383    
384          <section><title>Object Labelling</title>          <section><title>Object Labeling</title>
385          <para>          <para>
386          Objects can be labelled using the Label tool          Objects can be labeled using the Label tool
387          <inlinemediaobject>          <inlinemediaobject>
388          <imageobject>          <imageobject>
389          <imagedata fileref="../images/3_3_label.png" format="PNG" scale="&imgscale;"/>          <imagedata fileref="../images/3_3_label.png" format="PNG" scale="&imgscale;"/>
# Line 404  Line 428 
428          <menuchoice><guimenu>Map</guimenu></menuchoice>.          <menuchoice><guimenu>Map</guimenu></menuchoice>.
429          </para>          </para>
430    
431            <itemizedlist>
432            <listitem>
433          <para>          <para>
434          The Move Layer to Top tool          The Move Layer to Top tool
435          <inlinemediaobject>          <inlinemediaobject>
# Line 416  Line 442 
442          <textobject> <phrase>Move Layer to Top</phrase> </textobject>          <textobject> <phrase>Move Layer to Top</phrase> </textobject>
443          </inlinemediaobject> raises the selected layer to the top of the map.          </inlinemediaobject> raises the selected layer to the top of the map.
444          </para>          </para>
445            </listitem>
446            <listitem>
447    
448          <para>          <para>
449          The Move Layer Up tool          The Move Layer Up tool
# Line 429  Line 457 
457          <textobject> <phrase>Move Layer Up</phrase> </textobject>          <textobject> <phrase>Move Layer Up</phrase> </textobject>
458          </inlinemediaobject> raises the selected layer one level.          </inlinemediaobject> raises the selected layer one level.
459          </para>          </para>
460            </listitem>
461            <listitem>
462    
463          <para>          <para>
464          The Move Layer Down tool          The Move Layer Down tool
# Line 443  Line 473 
473          </inlinemediaobject> lowers the selected layer one level.          </inlinemediaobject> lowers the selected layer one level.
474          </para>          </para>
475    
476            </listitem>
477            <listitem>
478          <para>          <para>
479          The Move Layer to Bottom tool          The Move Layer to Bottom tool
480          <inlinemediaobject>          <inlinemediaobject>
# Line 456  Line 488 
488          </inlinemediaobject> lowers the selected layer to the bottom of the map.          </inlinemediaobject> lowers the selected layer to the bottom of the map.
489          </para>          </para>
490    
491            </listitem>
492            <listitem>
493          <para>          <para>
494          The Visible tool          The Visible tool
495          <inlinemediaobject>          <inlinemediaobject>
# Line 470  Line 504 
504          hidden.          hidden.
505          </para>          </para>
506    
507            </listitem>
508            <listitem>
509          <para>          <para>
510          The Invisible tool          The Invisible tool
511          <inlinemediaobject>          <inlinemediaobject>
# Line 483  Line 519 
519          </inlinemediaobject> hides the selected layer in the map.          </inlinemediaobject> hides the selected layer in the map.
520          </para>          </para>
521    
522            </listitem>
523            <listitem>
524          <para>          <para>
525          The Properties tool          The Properties tool
526          <inlinemediaobject>          <inlinemediaobject>
# Line 497  Line 535 
535          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
536          properties dialog for that layer.          properties dialog for that layer.
537          </para>          </para>
538            </listitem>
539            </itemizedlist>
540            <para>
541            Along the bottom of the legend is the scalebar. The scalebar
542            will be available if there are any layers and the  map has a
543            projection set.
544            </para>
545          </section>          </section>
546    
547          <section><title>Exporting</title>          <section><title>Exporting</title>
# Line 507  Line 552 
552          <menuchoice>          <menuchoice>
553          <guimenu>Map</guimenu>          <guimenu>Map</guimenu>
554          <guimenuitem>Export</guimenuitem>          <guimenuitem>Export</guimenuitem>
555          </menuchoice>. Under other platforms this option is not available.          </menuchoice> for use in reports, presentations, or further
556          Clicking this menu item open a file selection dialog that lets the          modification. The current map view, legend, and, if available,
557          user select a location to export the map.          scalebar are exported. Under other platforms this option is not
558            available. Clicking this menu item open a file selection dialog
559            that lets the user select a location to export the map.
560          </para>          </para>
561          </section>          </section>
562    
# Line 519  Line 566 
566          <menuchoice>          <menuchoice>
567          <guimenu>Map</guimenu>          <guimenu>Map</guimenu>
568          <guimenuitem>Print</guimenuitem>          <guimenuitem>Print</guimenuitem>
569          </menuchoice>. A standard printing dialog will open allowing the          </menuchoice>. The current map view, legend, and, if available,
570          user to configure the printer. This dialog will differ depending          scalebar are printed. A standard printing dialog will open allowing
571            the user to configure the printer. This dialog will differ depending
572          on which platform Thuban is running.          on which platform Thuban is running.
573          </para>          </para>
574          </section>          </section>
# Line 536  Line 584 
584          There are two types of layers supported by Thuban: shape layers and          There are two types of layers supported by Thuban: shape layers and
585          image layers. Shape layers consist of vector based shapes with          image layers. Shape layers consist of vector based shapes with
586          geo-referenced coordinates. There are three types of supported          geo-referenced coordinates. There are three types of supported
587          shapes: polygons, lines, and points. Image layers can be any image          shapes: polygons, lines (arc), and points. Image layers can be any image
588          file format supported by the Geospatial Data Abstraction Library          file format supported by the Geo-spatial Data Abstraction Library
589          (GDAL). The images must have geographic          (GDAL). The images must have geographic
590          coordinate data either embedded within the file or in a seperate          coordinate data either embedded within the file or in a separate
591          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
592          work very well with Thuban and were designed specifically to be image          work very well with Thuban and were designed specifically to be image
593          layers in GIS programs.          layers in GIS programs.
594          </para>          </para>
595            <para>
596            All actions in the
597            <menuchoice>
598            <guimenu>Layer</guimenu>
599            </menuchoice> menu act on the currently selected layer in the legend.
600            </para>
601          </section>          </section>
602    
603          <section><title>Properties</title>          <section><title>Properties</title>
# Line 554  Line 608 
608          <guimenu>Layer</guimenu>          <guimenu>Layer</guimenu>
609          <guimenuitem>Properties</guimenuitem>          <guimenuitem>Properties</guimenuitem>
610          </menuchoice> opens a dialog that displays a layer's properties.          </menuchoice> opens a dialog that displays a layer's properties.
611          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
612          provided. The type of layer is also shows. If the type is a type          provided. The type of layer is also shows. If the type is a type
613          of shape (polygon, arc, point) the classification table will be          of shape (polygon, arc, point) the classification table will be
614          shown. Image layers have no other properties other than title          shown. Image layers have no other properties other than title
615          and type.          and type.
616          </para>          </para>
617          <para>          <para>
618          <screenshot>          <figure>
619          <screeninfo>Properties Window</screeninfo>          <title>Properties Window</title>
620          <mediaobject>          <mediaobject>
621          <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>
622          <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>  
623          </mediaobject>          </mediaobject>
624          </screenshot>          </figure>
625          </para>          </para>
626          <para>          <para>
627          <screenshot>          <figure>
628          <screeninfo>Properties Window</screeninfo>          <title>Properties Window</title>
629          <mediaobject>          <mediaobject>
630          <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>
631          <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>  
632          </mediaobject>          </mediaobject>
633          </screenshot>          </figure>
634          </para>          </para>
635          </section>          </section>
636    
# Line 646  Line 696 
696      <para>      <para>
697      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
698      map, a default classification is created with the DEFAULT group. This      map, a default classification is created with the DEFAULT group. This
699      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
700      attributes, will match this group if no other group matches.      layer, regardless of its attributes, will match this group if no other
701        group matches.
702      </para>      </para>
703    
704          <section><title>Editing Classifications</title>          <section><title>Editing Classifications</title>
# Line 664  Line 715 
715          button.          button.
716          </para>          </para>
717          <para>          <para>
718          <screenshot>          To apply the changes to the map the user can click
719          <screeninfo>Properties Window</screeninfo>          either <guibutton>Try</guibutton> or <guibutton>OK</guibutton>.
720            <guibutton>Try</guibutton> will not close the dialog box, allowing
721            the user to see how the classification changes the map.
722            <guibutton>Revert</guibutton> will undo the last classification applied
723            to the map. <guibutton>OK</guibutton> will commit the changes and
724            close the dialog. The user will be unable to undo the changes.
725            <guibutton>Close</guibutton> simply closes the dialog box. If any
726            changes have not been applied with <guibutton>Try</guibutton> the
727            changes will not be applied to the map.
728            </para>
729            <para>
730            <figure>
731            <title>Properties Window</title>
732          <mediaobject>          <mediaobject>
733          <imageobject><imagedata fileref="../images/5_classification.png" format="PNG" scale="&imgscale;"/></imageobject>          <imageobject><imagedata fileref="../images/5_classification.png" format="PNG" scale="&imgscale;"/></imageobject>
734          <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>  
735          </mediaobject>          </mediaobject>
736          </screenshot>          </figure>
737          </para>          </para>
738          <para>          <para>
739          The order of the groups in the classification is significant          The order of the groups in the classification is significant
# Line 687  Line 748 
748          </para>          </para>
749              <section><title>Visible</title>              <section><title>Visible</title>
750              <para>              <para>
751              The Visible column has checkboxes that determine whether a              The Visible column has check-boxes that determine whether a
752              classification group will be displayed in the legend. This is              classification group will be displayed in the legend. This is
753              useful if the user knows that the groups completely cover              useful if the user knows that the groups completely cover
754              the data set and don't want the DEFAULT group to be displayed              the data set and don't want the DEFAULT group to be displayed
# Line 719  Line 780 
780              If the type is Integer, then any valid integer may be entered. In              If the type is Integer, then any valid integer may be entered. In
781              addition, with special syntax, a range of values can be entered.              addition, with special syntax, a range of values can be entered.
782              A range from <varname>start</varname> to <varname>end</varname>              A range from <varname>start</varname> to <varname>end</varname>
783              inclusive is specifed like this: <literal>[start;end]</literal>.              inclusive is specified like this: <literal>[start;end]</literal>.
784              The exclusive range is specified like this:              The exclusive range is specified like this:
785              <literal>]start;end[</literal>. Ranges can include infinity like              <literal>]start;end[</literal>. Ranges can include infinity like
786              this: <literal>[-oo;oo]</literal>. Field types can also be of type              this: <literal>[-oo;oo]</literal>. Field types can also be of type
# Line 738  Line 799 
799    
800          <section><title>Generating Classes</title>          <section><title>Generating Classes</title>
801          <para>          <para>
802          <screenshot>          <figure>
803          <screeninfo>Generate Class</screeninfo>          <title>Generate Class</title>
804          <mediaobject>          <mediaobject>
805          <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>
806          <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>  
807          </mediaobject>          </mediaobject>
808          </screenshot>          </figure>
809          </para>          </para>
810          <para>          <para>
811          Creating a classification by hand can be tedious.          Creating a classification by hand can be tedious.
# Line 754  Line 813 
813          classification at once while still giving the user control over          classification at once while still giving the user control over
814          how it appears. Clicking <guibutton>Generate Class</guibutton>          how it appears. Clicking <guibutton>Generate Class</guibutton>
815          opens the <varname>Generate Classification</varname> dialog.          opens the <varname>Generate Classification</varname> dialog.
816          Under the <varname>Generate</varname> pulldown there are at most          Under the <varname>Generate</varname> pull down there are at most
817          three different ways to generate classifications:          three different ways to generate classifications:
818          Unique Values, Unique Distribution, and Quantiles. Some options          Unique Values, Uniform Distribution, and Quantiles. Some options
819          may not be available if the data type for the field does not          may not be available if the data type for the field does not
820          support them. For instance, <varname>Unique Distribution</varname>          support them. For instance, <varname>Uniform Distribution</varname>
821          doesn't make sense for a Text field.          doesn't make sense for a Text field.
822          </para>          </para>
823          <para>          <para>
824          For every way of generating a classification, a color scheme must          For every way of generating a classification, a color scheme must
825          be selected. Thuban provides several different color schemes that          be selected. Thuban provides several different color schemes that
826          affect how the group properties change over the classification.          affect how the group properties change over the classification.
827            It may be desirable that only certain properties change over the
828            classification. If the shape type is a polygon or a point then
829            the <guibutton>Fix Border Color</guibutton> option will be available.
830            This allows the user to select a border color for all classification
831            groups.
832          It is also possible to create a custom color scheme. Selecting          It is also possible to create a custom color scheme. Selecting
833          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
834          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
835          properties of the last group. Thuban will interpolate between these          properties of the last group. Thuban will interpolate between these
836          two properties to generate the other groups.          two properties to generate the other groups.
837            <figure>
838            <title>Custom Color Scheme</title>
839            <mediaobject>
840            <imageobject><imagedata fileref="../images/5_2_custom_ramp.png" format="PNG" scale="&imgscale;"/></imageobject>
841            <imageobject><imagedata fileref="./images/5_2_custom_ramp.eps" format="EPS" scale="&imgscale;"/></imageobject>
842            </mediaobject>
843            </figure>
844          </para>          </para>
845          <para>          <para>
846          The Unique Values option lets the user select specific values that          The Unique Values option lets the user select specific values that
# Line 779  Line 850 
850          right. Each list can be sorted or reversed for easier searching.          right. Each list can be sorted or reversed for easier searching.
851          The classification that is generated will be in the same order as          The classification that is generated will be in the same order as
852          the list on the right.          the list on the right.
853            <figure>
854            <title>Unique Values</title>
855            <mediaobject>
856            <imageobject><imagedata fileref="../images/5_2_unique_values.png" format="PNG" scale="&imgscale;"/></imageobject>
857            <imageobject><imagedata fileref="./images/5_2_unique_values.eps" format="EPS" scale="&imgscale;"/></imageobject>
858            </mediaobject>
859            </figure>
860          </para>          </para>
861          <para>          <para>
862          The Unique Distribution option creates a user specified number of          The Uniform Distribution option creates a user specified number of
863          groups of ranges such that each range covers equal intervals. The          groups of ranges such that each range covers equal intervals. The
864          minimum and maximum values can automatically be retrieved from the          minimum and maximum values can automatically be retrieved from the
865          table by clicking <guibutton>Retrieve From Table</guibutton>. The          table by clicking <guibutton>Retrieve From Table</guibutton>. The
866          stepping is how large each interval is. Adjusting this value will          stepping is how large each interval is. Adjusting this value will
867          automatically recalculate how many groups is appropriate.          automatically recalculate how many groups is appropriate.
868            <figure>
869            <title>Uniform Distribution</title>
870            <mediaobject>
871            <imageobject><imagedata fileref="../images/5_2_uniform_dist.png" format="PNG" scale="&imgscale;"/></imageobject>
872            <imageobject><imagedata fileref="./images/5_2_uniform_dist.eps" format="EPS" scale="&imgscale;"/></imageobject>
873            </mediaobject>
874            </figure>
875          </para>          </para>
876          <para>          <para>
877          The Quantiles option generates ranges based on the number of items          The Quantiles option generates ranges based on the number of items
878          in the input set. For example, by specifying five groups Thuban will          in the table. For example, by specifying five groups Thuban will
879          generate five groups with appropriate ranges such that 20% of the table          generate five groups with appropriate ranges such that 20% of the table
880          data is in each group. If it is impossible to generate exact          data is in each group. If it is impossible to generate exact
881          groupings, Thuban will issue a warning but allow the user to continue.          groupings, Thuban will issue a warning but allow the user to continue.
882            <figure>
883            <title>Quantiles</title>
884            <mediaobject>
885            <imageobject><imagedata fileref="../images/5_2_quantiles.png" format="PNG" scale="&imgscale;"/></imageobject>
886            <imageobject><imagedata fileref="./images/5_2_quantiles.eps" format="EPS" scale="&imgscale;"/></imageobject>
887            </mediaobject>
888            </figure>
889          </para>          </para>
890          </section>          </section>
891    </chapter>    </chapter>
# Line 815  Line 907 
907      <guimenu>Layer</guimenu>      <guimenu>Layer</guimenu>
908      <guimenuitem>Projection</guimenuitem>      <guimenuitem>Projection</guimenuitem>
909      </menuchoice>.      </menuchoice>.
910      <screenshot>      <figure>
911      <screeninfo>Projection Window</screeninfo>      <title>Projection Window</title>
912      <mediaobject>      <mediaobject>
913      <imageobject><imagedata fileref="../images/6_projection.png" format="PNG" scale="&imgscale;"/></imageobject>      <imageobject><imagedata fileref="../images/6_projection.png" format="PNG" scale="&imgscale;"/></imageobject>
914      <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>  
915      </mediaobject>      </mediaobject>
916      </screenshot>      </figure>
917      </para>      </para>
918      <para>      <para>
919      Thuban is distributed with a sample collection of projections. The      Thuban is distributed with a sample collection of projections. The
# Line 852  Line 942 
942          list of available projections as a new entry, and thus makes it          list of available projections as a new entry, and thus makes it
943          available to future Thuban sessions. Clicking <guibutton>New</guibutton>          available to future Thuban sessions. Clicking <guibutton>New</guibutton>
944          will create an entirely new, empty projection. The          will create an entirely new, empty projection. The
945          <guibutton>Remove</guibutton> button will permanantly remove a          <guibutton>Remove</guibutton> button will permanently remove a
946          projection from the list of available projections.          projection from the list of available projections.
947          </para>          </para>
948            <para>
949            To apply the selected projection to the map the user can click
950            either <guibutton>Try</guibutton> or <guibutton>OK</guibutton>.
951            <guibutton>Try</guibutton> will not close the dialog box, allowing
952            the user to see how the projeciton changes the map.
953            <guibutton>Revert</guibutton> will undo the last projection applied
954            to the map. <guibutton>OK</guibutton> will commit the changes and
955            close the dialog. The user will be unable to undo the changes.
956            <guibutton>Close</guibutton> simply closes the dialog box. If no
957            selection has been applied with <guibutton>Try</guibutton> the
958            selection will not be applied to the map.
959            </para>
960      </section>      </section>
961          <section><title>Importing/Exporting Projections</title>          <section><title>Importing/Exporting Projections</title>
962          <para>          <para>
# Line 881  Line 983 
983    
984      <section><title>Table View</title>      <section><title>Table View</title>
985          <para>          <para>
986          <screenshot>          <figure>
987          <screeninfo>Table View</screeninfo>          <title>Table View</title>
988          <mediaobject>          <mediaobject>
989          <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>
990          <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>  
991          </mediaobject>          </mediaobject>
992          </screenshot>          </figure>
993          </para>          </para>
994          <para>          <para>
995          Thuban provides a standard dialog to display table contents, the          Thuban provides a standard dialog to display table contents, the
996          Table View. The view falls has five sections: The title, selections,          Table View. The view has five sections: The title, selections,
997          the table grid, export functions, and the status bar.          the table grid, export functions, and the status bar.
998          </para>          </para>
999          <para>          <para>
# Line 906  Line 1006 
1006          third choice can be either a specific value (interpreted as numerical          third choice can be either a specific value (interpreted as numerical
1007          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
1008          identifier. Thus you can perform analysis like selecting all          identifier. Thus you can perform analysis like selecting all
1009          records where "population > 10000" or          records where <literal>population > 10000</literal> or
1010          "cars_per_inhabitant <  bikes_per_inhabitant" (note that the field names          <literal>cars_per_inhabitant < bikes_per_inhabitant</literal>
1011          are only explanatory, the dBASE files allow only          (note that the field names are only explanatory, the dBase files
1012          11 character field names).          allow only 11 character field names).
1013                
1014          Selections can be combined either by applying a selection only on          Selections can be combined either by applying a selection only on
1015          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
# Line 917  Line 1017 
1017          earlier results.          earlier results.
1018          </para>          </para>
1019          <para>          <para>
1020          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),
1021          with highlighted selection results. Columns and rows can be resized.          with highlighted selection results. Columns and rows can be resized.
1022          </para>          </para>
1023          <para>          <para>
1024          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
1025          format (DBF) or comma seperated values (CSV). The          format (DBF) or comma separated values (CSV). The
1026          <guibutton>Export</guibutton> button          <guibutton>Export</guibutton> button
1027          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
1028          is determined by the file extension (either .dbf or .csv).          is determined by the file extension (either .dbf or .csv).
# Line 957  Line 1057 
1057              <guimenuitem>Open</guimenuitem>              <guimenuitem>Open</guimenuitem>
1058              </menuchoice>              </menuchoice>
1059              item raises a file dialog to let you select a              item raises a file dialog to let you select a
1060              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.
1061              On <guibutton>OK</guibutton> the selected file is loaded and a              On <guibutton>OK</guibutton> the selected file is loaded and a
1062              table view is opened.              table view is opened.
1063              </para>              </para>
# Line 1010  Line 1110 
1110    
1111          <section><title>Join</title>          <section><title>Join</title>
1112              <para>              <para>
1113              <screenshot>              <figure>
1114              <screeninfo>Join Tables</screeninfo>              <title>Join Tables</title>
1115              <mediaobject>              <mediaobject>
1116              <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>
1117              <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>  
1118              </mediaobject>              </mediaobject>
1119              </screenshot>              </figure>
1120              </para>              </para>
1121              <para>              <para>
1122              The              The
# Line 1044  Line 1142 
1142      </section>      </section>
1143      <section><title>Attribute Tables</title>      <section><title>Attribute Tables</title>
1144          <para>          <para>
1145              To clearly separate between both types, Thuban provides              To clearly separate between both types of tables (data and
1146          functionality regarding the attribute tables under the Layer menu.          attribute), Thuban provides functionality regarding the attribute
1147            tables under the <menuchoice><guimenu>Layer</guimenu></menuchoice> menu.
1148          </para>          </para>
1149    
1150          <section><title>Show Table</title>          <section><title>Show Table</title>
# Line 1084  Line 1183 
1183              normal tables can be simply closed (and thereby dereferencing              normal tables can be simply closed (and thereby dereferencing
1184              the source tables), this is not possible for attribute tables.              the source tables), this is not possible for attribute tables.
1185    
1186              Hence joins on attribute tables must be solved explicitely. This is              Hence joins on attribute tables must be solved explicitly. This is
1187              what the              what the
1188              <menuchoice>              <menuchoice>
1189              <guimenu>Layer</guimenu>              <guimenu>Layer</guimenu>
# Line 1099  Line 1198 
1198    
1199    <chapter><title>Trouble Shooting</title>    <chapter><title>Trouble Shooting</title>
1200      <para>      <para>
1201        Here are a few problems that users have encountered when first using Thuban.
1202      </para>      </para>
1203      <variablelist>      <para>
1204    
1205      <varlistentry>      <itemizedlist>
     <term>After adding two or more layers nothing is being drawn in the  
     map window.  
     </term>  
1206      <listitem>      <listitem>
1207        <para>After adding two or more layers nothing is drawn in the map window.
1208        </para>
1209      <para>      <para>
1210      This is probably because the layers have different projections. Projections      This is probably because the layers have different projections. Projections
1211      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
1212      are different.      are different.
1213      </para>      </para>
1214      </listitem>      </listitem>
     </varlistentry>  
1215    
     <varlistentry>  
     <term>Thuban crashes on startup with the error  
         <literal>NameError: global name 'False' is not defined</literal>.  
     </term>  
1216      <listitem>      <listitem>
1217        <para>Thuban crashes on startup with the error
1218            <literal>NameError: global name 'False' is not defined</literal>.
1219        </para>
1220      <para>      <para>
1221      <varname>True</varname> and <varname>False</varname> were only introduced      <varname>True</varname> and <varname>False</varname> were only introduced
1222      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.
1223      </para>      </para>
1224      </listitem>      </listitem>
     </varlistentry>  
1225    
1226      <varlistentry>      <listitem>
1227      <term>After compiling Thuban, Thuban crashes with an error similar to      <para>After compiling Thuban, Thuban crashes with an error similar to
1228          <literal>          <literal>
1229          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
1230          </literal>          </literal>
1231      </term>      </para>
     <listitem>  
1232      <para>      <para>
1233      Thuban depends on the wxWindows library. If Thuban is compiled with an      Thuban depends on the wxWindows library. If Thuban is compiled with an
1234      incompatible version of the compiler than wxWindows was compiled with      incompatible version of the compiler than wxWindows was compiled with
# Line 1141  Line 1236 
1236      compiler.      compiler.
1237      </para>      </para>
1238      </listitem>      </listitem>
1239      </varlistentry>      </itemizedlist>
1240      </variablelist>      </para>
1241        <para>
1242        If an error occurs Thuban will display a dialog indicating the error
1243        before closing. The text should be copied and reported to the
1244        <ulink url="http://thuban.intevation.org/bugtracker.html">
1245        Intevation bugtracker
1246        </ulink>.
1247        More information about the system is available from
1248        <menuchoice><guimenu>Help</guimenu><guimenuitem>About</guimenuitem></menuchoice> box.
1249        This should also be included in the bug report.
1250        <figure>
1251        <title>Error Dialog</title>
1252        <mediaobject>
1253        <imageobject><imagedata fileref="../images/8_int_error.png" format="PNG" scale="&imgscale;"/></imageobject>
1254        <imageobject><imagedata fileref="./images/8_int_error.eps" format="EPS" scale="&imgscale;"/></imageobject>
1255        </mediaobject>
1256        </figure>
1257        </para>
1258    
1259    </chapter>    </chapter>
1260    
# Line 1166  Line 1278 
1278      </varlistentry>      </varlistentry>
1279    
1280      <varlistentry>      <varlistentry>
1281      <term>dBASE file</term>      <term>dBase file</term>
1282      <listitem>      <listitem>
1283          <para>          <para>
1284          dBASE files are used to store the attributes for each layer. This          dBase files are used to store the attributes for each layer. This
1285          is closely associated with the Shapefile format. For detailed          is closely associated with the Shapefile format. For detailed
1286          specifications on the correct format of a dBASE file used with          specifications on the correct format of a dBase file used with
1287          Thuban please see the Technical Specification for the Shapefile          Thuban please see the Technical Specification for the Shapefile
1288          format above.          format above.
1289          </para>          </para>
1290      </listitem>      </listitem>
1291      </varlistentry>      </varlistentry>
1292    
1293        <varlistentry>
1294        <term>Raster files</term>
1295        <listitem>
1296            <para>
1297            Binding the GDAL library Thuban supports numerous raster file formats,
1298            see <ulink url="http://www.remotesensing.org/gdal/formats_list.html">
1299            GDAL format list</ulink> for details.</para>
1300    
1301            <para>Most commonly used is the <emphasis>TIFF/GeoTIFF</emphasis>
1302            format: Raster maps are provided as TIFF images, with an additional
1303            "world file" storing the geographic reference (usually with an
1304            extension ".tfw".
1305            </para>
1306        </listitem>
1307        </varlistentry>
1308    
1309      </variablelist>      </variablelist>
1310    </appendix>    </appendix>
1311    
# Line 1186  Line 1314 
1314      The following types of projections are directly support by      The following types of projections are directly support by
1315      Thuban. The specific values for each are provided by the user      Thuban. The specific values for each are provided by the user
1316      to create custom projections. Thuban comes with predefined      to create custom projections. Thuban comes with predefined
1317      projections and are available through the Projections dialog.      projections which are available through the Projections dialog.
1318        </para>
1319        <itemizedlist>
1320        <listitem>
1321            <para>Geographic</para>
1322            <itemizedlist>
1323            <listitem><para><literal>Ellipsoid</literal></para></listitem>
1324            <listitem><para>
1325                    <literal>Source Data</literal>: either Degrees or Radians
1326                    </para></listitem>
1327            </itemizedlist>
1328        </listitem>
1329        <listitem>
1330            <para>Lambert Conic Conformal</para>
1331        <itemizedlist>
1332            <listitem><para><literal>Ellipsoid</literal></para></listitem>
1333            <listitem><para><literal>Latitude of 1st standard parallel</literal></para></listitem>
1334            <listitem><para><literal>Latitude of 2nd standard parallel</literal></para></listitem>
1335            <listitem><para><literal>Central Meridian</literal></para></listitem>
1336            <listitem><para><literal>Latitude of Origin</literal></para></listitem>
1337            <listitem><para><literal>False Easting</literal> (meters)</para></listitem>
1338            <listitem><para><literal>False Northing</literal> (meters)</para></listitem>
1339        </itemizedlist>
1340        </listitem>
1341        <listitem>
1342            <para>Transverse Mercator</para>
1343        <itemizedlist>
1344            <listitem><para><literal>Ellipsoid</literal></para></listitem>
1345            <listitem><para><literal>Latitude</literal>of origin</para></listitem>
1346            <listitem><para><literal>Longitude</literal>at central meridian</para></listitem>
1347            <listitem><para><literal>Scale Factor</literal>at central meridian</para></listitem>
1348            <listitem><para><literal>False Easting</literal> (meters)</para></listitem>
1349            <listitem><para><literal>False Northing</literal> (meters)</para></listitem>
1350        </itemizedlist>
1351        </listitem>
1352        <listitem>
1353            <para>Universal Transverse Mercator</para>
1354        <itemizedlist>
1355            <listitem><para><literal>Ellipsoid</literal></para></listitem>
1356            <listitem><para><literal>Zone</literal>
1357                    (can be guessed appling the Propose button)</para></listitem>
1358            <listitem><para><literal>Southern Hemisphere</literal> flag</para></listitem>
1359        </itemizedlist>
1360        </listitem>
1361        </itemizedlist>
1362        
1363        <para>
1364        Thuban comes with a sample set of map projections for various
1365        European countries. Apart from the basic projection they differ
1366        especially in their parameterization:
1367        </para>
1368        <itemizedlist>
1369        <listitem><para>Belgium Datum 1972 (Lambert Conic Conformal)</para>
1370        </listitem>
1371    
1372        <listitem><para>Gauss-Boaga Zone 1 (Italy, Transverse Mercartor)</para>
1373        </listitem>
1374    
1375        <listitem><para>Gauss-Krueger Zone 2 (Germany, Transverse Mercartor)
1376        </para>
1377        </listitem>
1378    
1379        <listitem><para>Reseau Geodesique Francaise
1380        (France, Lambert Conic Conformal)</para>
1381        </listitem>
1382    
1383        <listitem><para>UK National Grid (United Kingdom, Transverse Mercartor)
1384        </para>
1385        </listitem>
1386        </itemizedlist>
1387    
1388        <para>
1389        Thuban uses the comprehensive PROJ library for projections. PROJ provides
1390        more than the four commonly used projections described above. If needed
1391        Thuban can be easily extended to a new projection covered by PROJ.
1392      </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>  
1393    </appendix>    </appendix>
1394    
1395  </book>  </book>
1396    
Legend:
Removed from v.1491  
changed lines
  Added in v.1533
[email protected]
 ViewVC Help
Powered by ViewVC 1.1.26