/[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 1507 by frank, Tue Jul 29 14:30:19 2003 UTC revision 1544 by jan, Mon Aug 4 15:22:48 2003 UTC
# Line 24  Line 24 
24    
25    <chapter><title>Introduction</title>    <chapter><title>Introduction</title>
26      <para>      <para>
27      Thuban is a Free Software Geographic Information Systems (GIS) viewer.      Thuban is an interactive geographic data viewer.
28      It is being developed because there is currently no simple interactive      It has been developed because there was no simple interactive
29      viewer for geographic information available as Free Software. Thuban is      viewer for geographic information available as Free Software. Thuban is
30      written in Python and C++ and uses the wxWindows library allowing it to      written in Python and C++ and uses the wxWindows library allowing it to
31      run on many different platforms, including GNU/Linux and Windows.      run on many different platforms, including GNU/Linux and Windows.
32      </para>      </para>
33      <para>      <para>
34      GIS viewers are a necessary tool as they allow one to get a visual      Geographic data viewers are a necessary tool as they allow one to
35            get a visual
36      impression of the positional relationship of the information that may not      impression of the positional relationship of the information that may not
37      be apparent from simple inspection of the data values themselves.      be apparent from simple inspection of the data values themselves.
38      Thuban allows the user to create a session that displays      Thuban allows the user to create a session that displays
# Line 48  Line 49 
49          <section><title>Installation</title>          <section><title>Installation</title>
50          <para>          <para>
51          Thuban is actively supported under Debian Testing (sarge), RedHat 7.2,          Thuban is actively supported under Debian Testing (sarge), RedHat 7.2,
52          and Windows 2000. All the necessary files can be found on the          and Windows 2000. Thuban depends on the following packages. These
53            packages can also be found on the
54          <ulink url="http://thuban.intevation.org/download.html">          <ulink url="http://thuban.intevation.org/download.html">
55          Thuban Download site          Thuban Download site
56          </ulink>.          </ulink>.
57          </para>          <itemizedlist>
58                <listitem><para>Python 2.2.1 (<literal>http://www.python.org</literal>)</para></listitem>
59                <listitem><para>wxWindows 2.4 (<literal>http://www.wxwindows.org</literal>)</para></listitem>
60                <listitem><para>wxPython 2.4 (<literal>http://www.wxpython.org</literal>)</para></listitem>
61                <listitem><para>proj 4.4.5 Projection Library (<literal>http://www.remotesensing.org/proj/</literal>)</para></listitem>
62                <listitem><para>GDAL 1.1.8 (<literal>http://www.remotesensing.org/gdal/</literal>)</para></listitem>
63                <listitem><para>SQLite 2.8.3 (<literal>http://www.hwaci.com/sw/sqlite/</literal>)</para></listitem>
64                <listitem><para>PySQLite 0.4.3 (<literal>http://pysqlite.sourceforge.net</literal>)</para></listitem>
65                </itemizedlist>
66            </para>
67                    <para>
68                    Along with the source codes, the download page also offers
69                    full installation packages for Debian, Windows and RPM-based systems
70                    (Mandrake, RedHat, SuSE, etc).
71                    </para>
72          </section>          </section>
73    
74          <section><title>The Main Window</title>          <section><title>The Main Window</title>
75          <para>          <para>
76          <screenshot>          <figure>
77          <screeninfo>The Main Window</screeninfo>          <title>The Main Window</title>
78          <mediaobject>          <mediaobject>
79          <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>
80          <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>  
81          </mediaobject>          </mediaobject>
82          </screenshot>          </figure>
83          </para>          </para>
84    
85          <para>          <para>
# Line 159  Line 173 
173    
174          <section><title>The Session Info-Tree</title>          <section><title>The Session Info-Tree</title>
175          <para>          <para>
176          <screenshot>          <figure>
177          <screeninfo>Session Info Tree</screeninfo>          <title>Session Info Tree</title>
178          <mediaobject>          <mediaobject>
179          <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>
180          <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>  
181          </mediaobject>          </mediaobject>
182          </screenshot>          </figure>
183          </para>          </para>
184          <para>          <para>
185          The session info-tree is primarily intended for developers working          The session info-tree is primarily intended for developers working
# Line 209  Line 221 
221    
222          <section><title>Adding and Removing Layers</title>          <section><title>Adding and Removing Layers</title>
223          <para>          <para>
224          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
225          and image layers. Shape layers are stored in Shapefile format, a          and image layers. Shape layers are stored in Shapefile format, a
226          standard file format for storing geographic objects. These          standard file format for storing geographic objects. These
227          files have the extension ``.shp''. Associated with          files have the extension ``.shp''. Associated with
# Line 248  Line 260 
260          the tool bar or from the          the tool bar or from the
261          <menuchoice><guimenu>Map</guimenu></menuchoice> menu.          <menuchoice><guimenu>Map</guimenu></menuchoice> menu.
262          </para>          </para>
263            <itemizedlist>
264            <listitem>
265          <para>          <para>
266          The ZoomIn tool          The ZoomIn tool
267          <inlinemediaobject>          <inlinemediaobject>
# Line 261  Line 275 
275          </inlinemediaobject>          </inlinemediaobject>
276          enlarges a region of the map. Clicking once on the map          enlarges a region of the map. Clicking once on the map
277          will double the magnification and center the map on the point that          will double the magnification and center the map on the point that
278          was clicked. Clicking and dragging selects a region that will          was clicked. Clicking and dragging selects a region that will be
279          enlarged to fit the window.          enlarged to fit the window.
280          </para>          </para>
281            </listitem>
282            <listitem>
283          <para>          <para>
284          The ZoomOut tool          The ZoomOut tool
285          <inlinemediaobject>          <inlinemediaobject>
# Line 280  Line 296 
296          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
297          scaled to fit into that box.          scaled to fit into that box.
298          </para>          </para>
299            </listitem>
300            <listitem>
301          <para>          <para>
302          The Pan tool          The Pan tool
303          <inlinemediaobject>          <inlinemediaobject>
# Line 293  Line 311 
311          </inlinemediaobject>          </inlinemediaobject>
312          allows the user to move the map around by clicking and dragging.          allows the user to move the map around by clicking and dragging.
313          </para>          </para>
314            </listitem>
315            <listitem>
316          <para>          <para>
317          The Full Extent tool          The Full Extent tool
318          <inlinemediaobject>          <inlinemediaobject>
# Line 306  Line 326 
326          </inlinemediaobject>          </inlinemediaobject>
327          rescales the viewable region so that the entire map is visible.          rescales the viewable region so that the entire map is visible.
328          </para>          </para>
329            </listitem>
330            <listitem>
331          <para>          <para>
332          The Full Layer Extent tool          The Full Layer Extent tool
333          <inlinemediaobject>          <inlinemediaobject>
# Line 321  Line 343 
343          layer fits within the window. If no layer is selected this button          layer fits within the window. If no layer is selected this button
344          will be disabled.          will be disabled.
345          </para>          </para>
346            </listitem>
347            <listitem>
348          <para>          <para>
349          The Full Shape Extent tool          The Full Shape Extent tool
350          <inlinemediaobject>          <inlinemediaobject>
# Line 335  Line 359 
359          rescales the viewable region so that the currently selected          rescales the viewable region so that the currently selected
360          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
361          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
362          selected this button will be disabled.          selected this button will be disabled. This feature is especially
363            helpful when identifying an object related to a selected record
364            in a tableview (see below).
365    
366          </para>          </para>
367            </listitem>
368            </itemizedlist>
369          </section>          </section>
370    
371          <section><title>Object Identification</title>          <section><title>Object Identification</title>
# Line 353  Line 382 
382          </inlinemediaobject>.          </inlinemediaobject>.
383          Clicking on an object selects that object and opens a dialog which          Clicking on an object selects that object and opens a dialog which
384          shows all the table attributes for that object. Any current selection          shows all the table attributes for that object. Any current selection
385          is lost.          is lost. Objects on the map are typically shapes and this document
386            will often refer to objects as shapes.
387          </para>          </para>
388          </section>          </section>
389    
# Line 404  Line 434 
434          <menuchoice><guimenu>Map</guimenu></menuchoice>.          <menuchoice><guimenu>Map</guimenu></menuchoice>.
435          </para>          </para>
436    
437            <itemizedlist>
438            <listitem>
439          <para>          <para>
440          The Move Layer to Top tool          The Move Layer to Top tool
441          <inlinemediaobject>          <inlinemediaobject>
# Line 416  Line 448 
448          <textobject> <phrase>Move Layer to Top</phrase> </textobject>          <textobject> <phrase>Move Layer to Top</phrase> </textobject>
449          </inlinemediaobject> raises the selected layer to the top of the map.          </inlinemediaobject> raises the selected layer to the top of the map.
450          </para>          </para>
451            </listitem>
452            <listitem>
453    
454          <para>          <para>
455          The Move Layer Up tool          The Move Layer Up tool
# Line 429  Line 463 
463          <textobject> <phrase>Move Layer Up</phrase> </textobject>          <textobject> <phrase>Move Layer Up</phrase> </textobject>
464          </inlinemediaobject> raises the selected layer one level.          </inlinemediaobject> raises the selected layer one level.
465          </para>          </para>
466            </listitem>
467            <listitem>
468    
469          <para>          <para>
470          The Move Layer Down tool          The Move Layer Down tool
# Line 443  Line 479 
479          </inlinemediaobject> lowers the selected layer one level.          </inlinemediaobject> lowers the selected layer one level.
480          </para>          </para>
481    
482            </listitem>
483            <listitem>
484          <para>          <para>
485          The Move Layer to Bottom tool          The Move Layer to Bottom tool
486          <inlinemediaobject>          <inlinemediaobject>
# Line 456  Line 494 
494          </inlinemediaobject> lowers the selected layer to the bottom of the map.          </inlinemediaobject> lowers the selected layer to the bottom of the map.
495          </para>          </para>
496    
497            </listitem>
498            <listitem>
499          <para>          <para>
500          The Visible tool          The Visible tool
501          <inlinemediaobject>          <inlinemediaobject>
# Line 470  Line 510 
510          hidden.          hidden.
511          </para>          </para>
512    
513            </listitem>
514            <listitem>
515          <para>          <para>
516          The Invisible tool          The Invisible tool
517          <inlinemediaobject>          <inlinemediaobject>
# Line 483  Line 525 
525          </inlinemediaobject> hides the selected layer in the map.          </inlinemediaobject> hides the selected layer in the map.
526          </para>          </para>
527    
528            </listitem>
529            <listitem>
530          <para>          <para>
531          The Properties tool          The Properties tool
532          <inlinemediaobject>          <inlinemediaobject>
# Line 497  Line 541 
541          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
542          properties dialog for that layer.          properties dialog for that layer.
543          </para>          </para>
544            </listitem>
545            </itemizedlist>
546            <para>
547            Along the bottom of the legend is the scalebar. The scalebar
548            will be available if there are any layers and the  map has a
549            projection set.
550            </para>
551          </section>          </section>
552    
553          <section><title>Exporting</title>          <section><title>Exporting</title>
# Line 507  Line 558 
558          <menuchoice>          <menuchoice>
559          <guimenu>Map</guimenu>          <guimenu>Map</guimenu>
560          <guimenuitem>Export</guimenuitem>          <guimenuitem>Export</guimenuitem>
561          </menuchoice>. Under other platforms this option is not available.          </menuchoice> for use in reports, presentations, or further
562          Clicking this menu item open a file selection dialog that lets the          modification. The current map view, legend, and, if available,
563          user select a location to export the map.          scalebar are exported. Under other platforms this option is not
564            available. Clicking this menu item open a file selection dialog
565            that lets the user select a location to export the map.
566          </para>          </para>
567          </section>          </section>
568    
# Line 519  Line 572 
572          <menuchoice>          <menuchoice>
573          <guimenu>Map</guimenu>          <guimenu>Map</guimenu>
574          <guimenuitem>Print</guimenuitem>          <guimenuitem>Print</guimenuitem>
575          </menuchoice>. A standard printing dialog will open allowing the          </menuchoice>. The current map view, legend, and, if available,
576          user to configure the printer. This dialog will differ depending          scalebar are printed. A standard printing dialog will open allowing
577            the user to configure the printer. This dialog will differ depending
578          on which platform Thuban is running.          on which platform Thuban is running.
579          </para>          </para>
580          </section>          </section>
# Line 536  Line 590 
590          There are two types of layers supported by Thuban: shape layers and          There are two types of layers supported by Thuban: shape layers and
591          image layers. Shape layers consist of vector based shapes with          image layers. Shape layers consist of vector based shapes with
592          geo-referenced coordinates. There are three types of supported          geo-referenced coordinates. There are three types of supported
593          shapes: polygons, lines, and points. Image layers can be any image          shapes: polygons, lines (arc), and points. Image layers can be any image
594          file format supported by the Geo-spatial Data Abstraction Library          file format supported by the Geo-spatial Data Abstraction Library
595          (GDAL). The images must have geographic          (GDAL). The images must have geographic
596          coordinate data either embedded within the file or in a separate          coordinate data either embedded within the file or in a separate
# Line 544  Line 598 
598          work very well with Thuban and were designed specifically to be image          work very well with Thuban and were designed specifically to be image
599          layers in GIS programs.          layers in GIS programs.
600          </para>          </para>
601            <para>
602            All actions in the
603            <menuchoice>
604            <guimenu>Layer</guimenu>
605            </menuchoice> menu act on the currently selected layer in the legend.
606            </para>
607          </section>          </section>
608    
609          <section><title>Properties</title>          <section><title>Properties</title>
# Line 554  Line 614 
614          <guimenu>Layer</guimenu>          <guimenu>Layer</guimenu>
615          <guimenuitem>Properties</guimenuitem>          <guimenuitem>Properties</guimenuitem>
616          </menuchoice> opens a dialog that displays a layer's properties.          </menuchoice> opens a dialog that displays a layer's properties.
617          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
618          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
619          of shape (polygon, arc, point) the classification table will be          of shape (polygon, arc, point) the classification table will be
620          shown. Image layers have no other properties other than title          shown. Image layers have no other properties other than title
621          and type.          and type.
622          </para>          </para>
623          <para>          <para>
624          <screenshot>          <figure>
625          <screeninfo>Properties Window</screeninfo>          <title>Properties Window</title>
626          <mediaobject>          <mediaobject>
627          <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>
628          <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>  
629          </mediaobject>          </mediaobject>
630          </screenshot>          </figure>
631          </para>          </para>
632          <para>          <para>
633          <screenshot>          <figure>
634          <screeninfo>Properties Window</screeninfo>          <title>Properties Window</title>
635          <mediaobject>          <mediaobject>
636          <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>
637          <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>  
638          </mediaobject>          </mediaobject>
639          </screenshot>          </figure>
640          </para>          </para>
641          </section>          </section>
642    
# Line 646  Line 702 
702      <para>      <para>
703      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
704      map, a default classification is created with the DEFAULT group. This      map, a default classification is created with the DEFAULT group. This
705      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
706      attributes, will match this group if no other group matches.      layer, regardless of its attributes, will match this group if no other
707        group matches.
708      </para>      </para>
709    
710          <section><title>Editing Classifications</title>          <section><title>Editing Classifications</title>
# Line 664  Line 721 
721          button.          button.
722          </para>          </para>
723          <para>          <para>
724          <screenshot>          To apply the changes to the map the user can click
725          <screeninfo>Properties Window</screeninfo>          either <guibutton>Try</guibutton> or <guibutton>OK</guibutton>.
726            <guibutton>Try</guibutton> will not close the dialog box, allowing
727            the user to see how the classification changes the map.
728            <guibutton>Revert</guibutton> will undo the last classification applied
729            to the map. <guibutton>OK</guibutton> will commit the changes and
730            close the dialog. The user will be unable to undo the changes.
731            <guibutton>Close</guibutton> simply closes the dialog box. If any
732            changes have not been applied with <guibutton>Try</guibutton> the
733            changes will not be applied to the map.
734            </para>
735            <para>
736            <figure>
737            <title>Properties Window</title>
738          <mediaobject>          <mediaobject>
739          <imageobject><imagedata fileref="../images/5_classification.png" format="PNG" scale="&imgscale;"/></imageobject>          <imageobject><imagedata fileref="../images/5_classification.png" format="PNG" scale="&imgscale;"/></imageobject>
740          <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>  
741          </mediaobject>          </mediaobject>
742          </screenshot>          </figure>
743          </para>          </para>
744          <para>          <para>
745          The order of the groups in the classification is significant          The order of the groups in the classification is significant
# Line 738  Line 805 
805    
806          <section><title>Generating Classes</title>          <section><title>Generating Classes</title>
807          <para>          <para>
808          <screenshot>          <figure>
809          <screeninfo>Generate Class</screeninfo>          <title>Generate Class</title>
810          <mediaobject>          <mediaobject>
811          <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>
812          <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>  
813          </mediaobject>          </mediaobject>
814          </screenshot>          </figure>
815          </para>          </para>
816          <para>          <para>
817          Creating a classification by hand can be tedious.          Creating a classification by hand can be tedious.
# Line 756  Line 821 
821          opens the <varname>Generate Classification</varname> dialog.          opens the <varname>Generate Classification</varname> dialog.
822          Under the <varname>Generate</varname> pull down there are at most          Under the <varname>Generate</varname> pull down there are at most
823          three different ways to generate classifications:          three different ways to generate classifications:
824          Unique Values, Unique Distribution, and Quantiles. Some options          Unique Values, Uniform Distribution, and Quantiles. Some options
825          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
826          support them. For instance, <varname>Unique Distribution</varname>          support them. For instance, <varname>Uniform Distribution</varname>
827          doesn't make sense for a Text field.          doesn't make sense for a Text field.
828          </para>          </para>
829          <para>          <para>
830          For every way of generating a classification, a color scheme must          For every way of generating a classification, a color scheme must
831          be selected. Thuban provides several different color schemes that          be selected. Thuban provides several different color schemes that
832          affect how the group properties change over the classification.          affect how the group properties change over the classification.
833            It may be desirable that only certain properties change over the
834            classification. If the shape type is a polygon or a point then
835            the <guibutton>Fix Border Color</guibutton> option will be available.
836            This allows the user to select a border color for all classification
837            groups.
838          It is also possible to create a custom color scheme. Selecting          It is also possible to create a custom color scheme. Selecting
839          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
840          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
841          properties of the last group. Thuban will interpolate between these          properties of the last group. Thuban will interpolate between these
842          two properties to generate the other groups.          two properties to generate the other groups.
843            <figure>
844            <title>Custom Color Scheme</title>
845            <mediaobject>
846            <imageobject><imagedata fileref="../images/5_2_custom_ramp.png" format="PNG" scale="&imgscale;"/></imageobject>
847            <imageobject><imagedata fileref="./images/5_2_custom_ramp.eps" format="EPS" scale="&imgscale;"/></imageobject>
848            </mediaobject>
849            </figure>
850          </para>          </para>
851          <para>          <para>
852          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 856 
856          right. Each list can be sorted or reversed for easier searching.          right. Each list can be sorted or reversed for easier searching.
857          The classification that is generated will be in the same order as          The classification that is generated will be in the same order as
858          the list on the right.          the list on the right.
859            <figure>
860            <title>Unique Values</title>
861            <mediaobject>
862            <imageobject><imagedata fileref="../images/5_2_unique_values.png" format="PNG" scale="&imgscale;"/></imageobject>
863            <imageobject><imagedata fileref="./images/5_2_unique_values.eps" format="EPS" scale="&imgscale;"/></imageobject>
864            </mediaobject>
865            </figure>
866          </para>          </para>
867          <para>          <para>
868          The Unique Distribution option creates a user specified number of          The Uniform Distribution option creates a user specified number of
869          groups of ranges such that each range covers equal intervals. The          groups of ranges such that each range covers equal intervals. The
870          minimum and maximum values can automatically be retrieved from the          minimum and maximum values can automatically be retrieved from the
871          table by clicking <guibutton>Retrieve From Table</guibutton>. The          table by clicking <guibutton>Retrieve From Table</guibutton>. The
872          stepping is how large each interval is. Adjusting this value will          stepping is how large each interval is. Adjusting this value will
873          automatically recalculate how many groups is appropriate.          automatically recalculate how many groups is appropriate.
874            <figure>
875            <title>Uniform Distribution</title>
876            <mediaobject>
877            <imageobject><imagedata fileref="../images/5_2_uniform_dist.png" format="PNG" scale="&imgscale;"/></imageobject>
878            <imageobject><imagedata fileref="./images/5_2_uniform_dist.eps" format="EPS" scale="&imgscale;"/></imageobject>
879            </mediaobject>
880            </figure>
881          </para>          </para>
882          <para>          <para>
883          The Quantiles option generates ranges based on the number of items          The Quantiles option generates ranges based on the number of items
884          in the input set. For example, by specifying five groups Thuban will          in the table. For example, by specifying five groups Thuban will
885          generate five groups with appropriate ranges such that 20% of the table          generate five groups with appropriate ranges such that 20% of the table
886          data is in each group. If it is impossible to generate exact          data is in each group. If it is impossible to generate exact
887          groupings, Thuban will issue a warning but allow the user to continue.          groupings, Thuban will issue a warning but allow the user to continue.
888            <figure>
889            <title>Quantiles</title>
890            <mediaobject>
891            <imageobject><imagedata fileref="../images/5_2_quantiles.png" format="PNG" scale="&imgscale;"/></imageobject>
892            <imageobject><imagedata fileref="./images/5_2_quantiles.eps" format="EPS" scale="&imgscale;"/></imageobject>
893            </mediaobject>
894            </figure>
895          </para>          </para>
896          </section>          </section>
897    </chapter>    </chapter>
# Line 815  Line 913 
913      <guimenu>Layer</guimenu>      <guimenu>Layer</guimenu>
914      <guimenuitem>Projection</guimenuitem>      <guimenuitem>Projection</guimenuitem>
915      </menuchoice>.      </menuchoice>.
916      <screenshot>      <figure>
917      <screeninfo>Projection Window</screeninfo>      <title>Projection Window</title>
918      <mediaobject>      <mediaobject>
919      <imageobject><imagedata fileref="../images/6_projection.png" format="PNG" scale="&imgscale;"/></imageobject>      <imageobject><imagedata fileref="../images/6_projection.png" format="PNG" scale="&imgscale;"/></imageobject>
920      <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>  
921      </mediaobject>      </mediaobject>
922      </screenshot>      </figure>
923      </para>      </para>
924      <para>      <para>
925      Thuban is distributed with a sample collection of projections. The      Thuban is distributed with a sample collection of projections. The
# Line 855  Line 951 
951          <guibutton>Remove</guibutton> button will permanently remove a          <guibutton>Remove</guibutton> button will permanently remove a
952          projection from the list of available projections.          projection from the list of available projections.
953          </para>          </para>
954            <para>
955            To apply the selected projection to the map the user can click
956            either <guibutton>Try</guibutton> or <guibutton>OK</guibutton>.
957            <guibutton>Try</guibutton> will not close the dialog box, allowing
958            the user to see how the projeciton changes the map.
959            <guibutton>Revert</guibutton> will undo the last projection applied
960            to the map. <guibutton>OK</guibutton> will commit the changes and
961            close the dialog. The user will be unable to undo the changes.
962            <guibutton>Close</guibutton> simply closes the dialog box. If no
963            selection has been applied with <guibutton>Try</guibutton> the
964            selection will not be applied to the map.
965            </para>
966      </section>      </section>
967          <section><title>Importing/Exporting Projections</title>          <section><title>Importing/Exporting Projections</title>
968          <para>          <para>
# Line 881  Line 989 
989    
990      <section><title>Table View</title>      <section><title>Table View</title>
991          <para>          <para>
992          <screenshot>          <figure>
993          <screeninfo>Table View</screeninfo>          <title>Table View</title>
994          <mediaobject>          <mediaobject>
995          <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>
996          <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>  
997          </mediaobject>          </mediaobject>
998          </screenshot>          </figure>
999          </para>          </para>
1000          <para>          <para>
1001          Thuban provides a standard dialog to display table contents, the          Thuban provides a standard dialog to display table contents, the
1002          Table View. The view falls has five sections: The title, selections,          Table View. The view has five sections: The title, selections,
1003          the table grid, export functions, and the status bar.          the table grid, export functions, and the status bar.
1004          </para>          </para>
1005          <para>          <para>
# Line 906  Line 1012 
1012          third choice can be either a specific value (interpreted as numerical          third choice can be either a specific value (interpreted as numerical
1013          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
1014          identifier. Thus you can perform analysis like selecting all          identifier. Thus you can perform analysis like selecting all
1015          records where "population > 10000" or          records where <literal>population > 10000</literal> or
1016          "cars_per_inhabitant <  bikes_per_inhabitant" (note that the field names          <literal>cars_per_inhabitant < bikes_per_inhabitant</literal>
1017          are only explanatory, the dBase files allow only          (note that the field names are only explanatory, the dBase files
1018          11 character field names).          allow only 11 character field names).
1019                
1020          Selections can be combined either by applying a selection only on          Selections can be combined either by applying a selection only on
1021          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 1023 
1023          earlier results.          earlier results.
1024          </para>          </para>
1025          <para>          <para>
1026          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),
1027          with highlighted selection results. Columns and rows can be resized.          with highlighted selection results. Columns and rows can be resized.
1028          </para>          </para>
1029          <para>          <para>
# Line 1010  Line 1116 
1116    
1117          <section><title>Join</title>          <section><title>Join</title>
1118              <para>              <para>
1119              <screenshot>              <figure>
1120              <screeninfo>Join Tables</screeninfo>              <title>Join Tables</title>
1121              <mediaobject>              <mediaobject>
1122              <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>
1123              <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>  
1124              </mediaobject>              </mediaobject>
1125              </screenshot>              </figure>
1126              </para>              </para>
1127              <para>              <para>
1128              The              The
# Line 1044  Line 1148 
1148      </section>      </section>
1149      <section><title>Attribute Tables</title>      <section><title>Attribute Tables</title>
1150          <para>          <para>
1151              To clearly separate between both types, Thuban provides              To clearly separate between both types of tables (data and
1152          functionality regarding the attribute tables under the Layer menu.          attribute), Thuban provides functionality regarding the attribute
1153            tables under the <menuchoice><guimenu>Layer</guimenu></menuchoice> menu.
1154          </para>          </para>
1155    
1156          <section><title>Show Table</title>          <section><title>Show Table</title>
# Line 1099  Line 1204 
1204    
1205    <chapter><title>Trouble Shooting</title>    <chapter><title>Trouble Shooting</title>
1206      <para>      <para>
1207        Here are a few problems that users have encountered when first using Thuban.
1208      </para>      </para>
1209      <variablelist>      <para>
1210    
1211      <varlistentry>      <itemizedlist>
     <term>After adding two or more layers nothing is being drawn in the  
     map window.  
     </term>  
1212      <listitem>      <listitem>
1213        <para>After adding two or more layers nothing is drawn in the map window.
1214        </para>
1215      <para>      <para>
1216      This is probably because the layers have different projections. Projections      This is probably because the layers have different projections. Projections
1217      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
1218      are different.      are different.
1219      </para>      </para>
1220      </listitem>      </listitem>
     </varlistentry>  
1221    
     <varlistentry>  
     <term>Thuban crashes on startup with the error  
         <literal>NameError: global name 'False' is not defined</literal>.  
     </term>  
1222      <listitem>      <listitem>
1223        <para>Thuban crashes on startup with the error
1224            <literal>NameError: global name 'False' is not defined</literal>.
1225        </para>
1226      <para>      <para>
1227      <varname>True</varname> and <varname>False</varname> were only introduced      <varname>True</varname> and <varname>False</varname> were only introduced
1228      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.
1229      </para>      </para>
1230      </listitem>      </listitem>
     </varlistentry>  
1231    
1232      <varlistentry>      <listitem>
1233      <term>After compiling Thuban, Thuban crashes with an error similar to      <para>After compiling Thuban, Thuban crashes with an error similar to
1234          <literal>          <literal>
1235          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
1236          </literal>          </literal>
1237      </term>      </para>
     <listitem>  
1238      <para>      <para>
1239      Thuban depends on the wxWindows library. If Thuban is compiled with an      Thuban depends on the wxWindows library. If Thuban is compiled with an
1240      incompatible version of the compiler than wxWindows was compiled with      incompatible version of the compiler than wxWindows was compiled with
# Line 1141  Line 1242 
1242      compiler.      compiler.
1243      </para>      </para>
1244      </listitem>      </listitem>
1245      </varlistentry>      </itemizedlist>
1246      </variablelist>      </para>
1247        <para>
1248        If an error occurs Thuban will display a dialog indicating the error
1249        before closing. The text should be copied and reported to the
1250        <ulink url="http://thuban.intevation.org/bugtracker.html">
1251        Intevation bugtracker
1252        </ulink>.
1253        More information about the system is available from
1254        <menuchoice><guimenu>Help</guimenu><guimenuitem>About</guimenuitem></menuchoice> box.
1255        This should also be included in the bug report.
1256        <figure>
1257        <title>Error Dialog</title>
1258        <mediaobject>
1259        <imageobject><imagedata fileref="../images/8_int_error.png" format="PNG" scale="&imgscale;"/></imageobject>
1260        <imageobject><imagedata fileref="./images/8_int_error.eps" format="EPS" scale="&imgscale;"/></imageobject>
1261        </mediaobject>
1262        </figure>
1263        </para>
1264    
1265    </chapter>    </chapter>
1266    
# Line 1178  Line 1296 
1296      </listitem>      </listitem>
1297      </varlistentry>      </varlistentry>
1298    
1299        <varlistentry>
1300        <term>Raster files</term>
1301        <listitem>
1302            <para>
1303            Binding the GDAL library Thuban supports numerous raster file formats,
1304            see <ulink url="http://www.remotesensing.org/gdal/formats_list.html">
1305            GDAL format list</ulink> for details.</para>
1306    
1307            <para>Most commonly used is the <emphasis>TIFF/GeoTIFF</emphasis>
1308            format: Raster maps are provided as TIFF images, with an additional
1309            "world file" storing the geographic reference (usually with an
1310            extension ".tfw").
1311            </para>
1312        </listitem>
1313        </varlistentry>
1314    
1315      </variablelist>      </variablelist>
1316    </appendix>    </appendix>
1317    
# Line 1188  Line 1322 
1322      to create custom projections. Thuban comes with predefined      to create custom projections. Thuban comes with predefined
1323      projections which are available through the Projections dialog.      projections which are available through the Projections dialog.
1324      </para>      </para>
1325      <variablelist>      <itemizedlist>
1326      <varlistentry>      <listitem>
1327          <term>Geographic</term>          <para>Geographic</para>
1328          <listitem><para><literal>Ellipsoid</literal></para>          <itemizedlist>
1329          <para><literal>Source Data</literal>: either Degrees or Radians          <listitem><para><literal>Ellipsoid</literal></para></listitem>
1330            <listitem><para>
1331                    <literal>Source Data</literal>: either Degrees or Radians
1332                  </para></listitem>                  </para></listitem>
1333      </varlistentry>          </itemizedlist>
1334      <varlistentry>      </listitem>
1335          <term>Lambert Conic Conformal</term>      <listitem>
1336          <listitem><para><literal>Ellipsoid</literal></para>          <para>Lambert Conic Conformal</para>
1337          <para><literal>Latitude of 1st standard parallel</literal></para>      <itemizedlist>
1338          <para><literal>Latitude of 2nd standard parallel</literal></para>          <listitem><para><literal>Ellipsoid</literal></para></listitem>
1339          <para><literal>Central Meridian</literal></para>          <listitem><para><literal>Latitude of 1st standard parallel</literal></para></listitem>
1340          <para><literal>Latitude of Origin</literal></para>          <listitem><para><literal>Latitude of 2nd standard parallel</literal></para></listitem>
1341          <para><literal>False Easting</literal> (meters)</para>          <listitem><para><literal>Central Meridian</literal></para></listitem>
1342          <para><literal>False Northing</literal> (meters)</para></listitem>          <listitem><para><literal>Latitude of Origin</literal></para></listitem>
1343      </varlistentry>          <listitem><para><literal>False Easting</literal> (meters)</para></listitem>
1344      <varlistentry>          <listitem><para><literal>False Northing</literal> (meters)</para></listitem>
1345          <term>Transverse Mercator</term>      </itemizedlist>
1346          <listitem><para><literal>Ellipsoid</literal></para>      </listitem>
1347          <para><literal>Latitude</literal>of origin</para>      <listitem>
1348          <para><literal>Longitude</literal>at central meridian</para>          <para>Transverse Mercator</para>
1349          <para><literal>Scale Factor</literal>at central meridian</para>      <itemizedlist>
1350          <para><literal>False Easting</literal> (meters)</para>          <listitem><para><literal>Ellipsoid</literal></para></listitem>
1351          <para><literal>False Northing</literal> (meters)</para></listitem>          <listitem><para><literal>Latitude</literal>of origin</para></listitem>
1352      </varlistentry>          <listitem><para><literal>Longitude</literal>at central meridian</para></listitem>
1353      <varlistentry>          <listitem><para><literal>Scale Factor</literal>at central meridian</para></listitem>
1354          <term>Universal Transverse Mercator</term>          <listitem><para><literal>False Easting</literal> (meters)</para></listitem>
1355          <listitem><para><literal>Ellipsoid</literal></para>          <listitem><para><literal>False Northing</literal> (meters)</para></listitem>
1356          <para><literal>Zone</literal>      </itemizedlist>
1357                  (can be guessed appling the Propose button)</para>      </listitem>
1358          <para><literal>Southern Hemisphere</literal> flag</para></listitem>      <listitem>
1359      </varlistentry>          <para>Universal Transverse Mercator</para>
1360      </variablelist>      <itemizedlist>
1361            <listitem><para><literal>Ellipsoid</literal></para></listitem>
1362            <listitem><para><literal>Zone</literal>
1363                    (can be guessed appling the Propose button)</para></listitem>
1364            <listitem><para><literal>Southern Hemisphere</literal> flag</para></listitem>
1365        </itemizedlist>
1366        </listitem>
1367        </itemizedlist>
1368            
1369      <para>      <para>
1370      Thuban comes with a sample set of map projections for various      Thuban comes with a sample set of map projections for various
1371      European countries. Apart from the basic projection they differ      European countries. Apart from the basic projection they differ
1372      especially in their parameterization:      especially in their parameterization:
1373      </para>      </para>
1374      <variablelist>      <itemizedlist>
1375      <varlistentry><term>Belgium Datum 1972 (Lambert Conic Conformal)</term>      <listitem><para>Belgium Datum 1972 (Lambert Conic Conformal)</para>
1376          <listitem><para></para></listitem>      </listitem>
     </varlistentry>  
1377    
1378      <varlistentry><term>Gauss-Boaga Zone 1 (Italy, Transverse Mercartor)</term>      <listitem><para>Gauss-Boaga Zone 1 (Italy, Transverse Mercartor)</para>
1379          <listitem><para></para></listitem>      </listitem>
     </varlistentry>  
1380    
1381      <varlistentry><term>Gauss-Krueger Zone 2 (Germany, Transverse Mercartor)      <listitem><para>Gauss-Krueger Zone 2 (Germany, Transverse Mercartor)
1382      </term>      </para>
1383          <listitem><para></para></listitem>      </listitem>
     </varlistentry>  
1384    
1385      <varlistentry><term>Reseau Geodesique Francaise      <listitem><para>Reseau Geodesique Francaise
1386      (France, Lambert Conic Conformal)</term>      (France, Lambert Conic Conformal)</para>
1387          <listitem><para></para></listitem>      </listitem>
     </varlistentry>  
1388    
1389      <varlistentry><term>UK National Grid (United Kingdom, Transverse Mercartor)      <listitem><para>UK National Grid (United Kingdom, Transverse Mercartor)
1390      </term>      </para>
1391          <listitem><para></para></listitem>      </listitem>
1392      </varlistentry>      </itemizedlist>
     </variablelist>  
1393    
1394      <para>      <para>
1395      Thuban uses the comprehensive PROJ library for projections. PROJ provides      Thuban uses the comprehensive PROJ library for projections. PROJ provides
Legend:
Removed from v.1507  
changed lines
  Added in v.1544
[email protected]
 ViewVC Help
Powered by ViewVC 1.1.26