/[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 1510 by jonathan, Tue Jul 29 14:48:41 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. The following list of files that Thuban requires          and Windows 2000. Thuban depends on the following packages. These
52          can be found on the          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          <variablelist>          <itemizedlist>
57          <varlistentry>              <listitem><para>Python 2.2.1 (<literal>http://www.python.org</literal>)</para></listitem>
58          <term>Debian Testing (sarge)</term>              <listitem><para>wxWindows 2.4 (<literal>http://www.wxwindows.org</literal>)</para></listitem>
59          <listitem>              <listitem><para>wxPython 2.4 (<literal>http://www.wxpython.org</literal>)</para></listitem>
60              <para>Thuban-0.8.1-1-debian.i386.rpm</para>              <listitem><para>proj 4.4.5 Projection Library (<literal>http://www.remotesensing.org/proj/</literal>)</para></listitem>
61              <para>GTK 1.2.3</para>              <listitem><para>GDAL 1.1.8 (<literal>http://www.remotesensing.org/gdal/</literal>)</para></listitem>
62              <para>Python 2.2.1</para>              <listitem><para>SQLite 2.8.3 (<literal>http://www.hwaci.com/sw/sqlite/</literal>)</para></listitem>
63              <para>Python 2.2 XML Base Tools</para>              <listitem><para>PySQLite 0.4.3 (<literal>http://pysqlite.sourceforge.net</literal>)</para></listitem>
64              <para>wxWindows 2.4</para>              </itemizedlist>
             <para>wxWindows 2.4 Python Bindings</para>  
             <para>proj 4.4.5 Projection Library</para>  
             <para>SQLite Python Bindings 0.4.3</para>  
             <para>GDAL 1.1.8</para>  
         </listitem>  
         </varlistentry>  
         <varlistentry>  
         <term>RedHat 7.2</term>  
         <listitem>  
             <para>Thuban-0.8.1-1.i386.rpm</para>  
             <para>Python 2.2.1</para>  
             <para>wxPython 2.4 for Python 2.2 with wxGTK</para>  
             <para>proj 4.4.5 Projection Library</para>  
             <para>SQLite 2.8.3</para>  
             <para>PySQLite 0.4.3</para>  
             <para>GDAL 1.1.8</para>  
         </listitem>  
         </varlistentry>  
         <varlistentry>  
         <term>Windows 2000</term>  
         <listitem>  
             <para>Thuban-0.8.1-0.exe</para>  
             <para>Python 2.2.1</para>  
             <para>wxWindows 2.4 for Python 2.2</para>  
             <para>SQLite Python Libraries</para>  
             <para>GDAL for Thuban</para>  
         </listitem>  
         </varlistentry>  
         </variablelist>  
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 198  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 287  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 303  Line 272 
272          was clicked. Clicking and dragging selects a region that will be          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 319  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 332  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 345  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 360  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 379  Line 358 
358          in a tableview (see below).          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 447  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 459  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 472  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 486  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 499  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 513  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 526  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 540  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>          <para>
541          Along the bottom of the legend is the scalebar. The scalebar          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          will be available if there are any layers and the  map has a
# Line 619  Line 615 
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 735  Line 727 
727          changes will not be applied to the map.          changes will not be applied to the map.
728          </para>          </para>
729          <para>          <para>
730          <screenshot>          <figure>
731          <screeninfo>Properties Window</screeninfo>          <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 809  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 836  Line 824 
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          <screenshot>          <figure>
838          <screeninfo>Custom Color Scheme</screeninfo>          <title>Custom Color Scheme</title>
839          <mediaobject>          <mediaobject>
840          <imageobject><imagedata fileref="../images/5_2_custom_ramp.png" format="PNG" scale="&imgscale;"/></imageobject>          <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>          <imageobject><imagedata fileref="./images/5_2_custom_ramp.eps" format="EPS" scale="&imgscale;"/></imageobject>
         <textobject><phrase>Custom Color Scheme</phrase></textobject>  
         <caption><para>Custom Color Scheme</para></caption>  
842          </mediaobject>          </mediaobject>
843          </screenshot>          </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 859  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          <screenshot>          <figure>
854          <screeninfo>Unique Values</screeninfo>          <title>Unique Values</title>
855          <mediaobject>          <mediaobject>
856          <imageobject><imagedata fileref="../images/5_2_unique_values.png" format="PNG" scale="&imgscale;"/></imageobject>          <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>          <imageobject><imagedata fileref="./images/5_2_unique_values.eps" format="EPS" scale="&imgscale;"/></imageobject>
         <textobject><phrase>Unique Values</phrase></textobject>  
         <caption><para>Unique Values Classification</para></caption>  
858          </mediaobject>          </mediaobject>
859          </screenshot>          </figure>
860          </para>          </para>
861          <para>          <para>
862          The Uniform Distribution option creates a user specified number of          The Uniform Distribution option creates a user specified number of
# Line 876  Line 865 
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          <screenshot>          <figure>
869          <screeninfo>Uniform Distribution</screeninfo>          <title>Uniform Distribution</title>
870          <mediaobject>          <mediaobject>
871          <imageobject><imagedata fileref="../images/5_2_uniform_dist.png" format="PNG" scale="&imgscale;"/></imageobject>          <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>          <imageobject><imagedata fileref="./images/5_2_uniform_dist.eps" format="EPS" scale="&imgscale;"/></imageobject>
         <textobject><phrase>Uniform Distribution</phrase></textobject>  
         <caption><para>Uniform Distribution Classification</para></caption>  
873          </mediaobject>          </mediaobject>
874          </screenshot>          </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
# Line 892  Line 879 
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          <screenshot>          <figure>
883          <screeninfo>Quantiles</screeninfo>          <title>Quantiles</title>
884          <mediaobject>          <mediaobject>
885          <imageobject><imagedata fileref="../images/5_2_quantiles.png" format="PNG" scale="&imgscale;"/></imageobject>          <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>          <imageobject><imagedata fileref="./images/5_2_quantiles.eps" format="EPS" scale="&imgscale;"/></imageobject>
         <textobject><phrase>Quantiles</phrase></textobject>  
         <caption><para>Quantiles Classification</para></caption>  
887          </mediaobject>          </mediaobject>
888          </screenshot>          </figure>
889          </para>          </para>
890          </section>          </section>
891    </chapter>    </chapter>
# Line 922  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 1000  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
# Line 1129  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 1222  Line 1201 
1201      Here are a few problems that users have encountered when first using Thuban.      Here are a few problems that users have encountered when first using Thuban.
1202      </para>      </para>
1203      <para>      <para>
     <variablelist>  
1204    
1205      <varlistentry>      <itemizedlist>
     <term>After adding two or more layers nothing is 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 layers' 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 1262  Line 1236 
1236      compiler.      compiler.
1237      </para>      </para>
1238      </listitem>      </listitem>
1239      </varlistentry>      </itemizedlist>
     </variablelist>  
1240      </para>      </para>
1241      <para>      <para>
1242      If an error occurs Thuban will display a dialog indicating the error      If an error occurs Thuban will display a dialog indicating the error
# Line 1274  Line 1247 
1247      More information about the system is available from      More information about the system is available from
1248      <menuchoice><guimenu>Help</guimenu><guimenuitem>About</guimenuitem></menuchoice> box.      <menuchoice><guimenu>Help</guimenu><guimenuitem>About</guimenuitem></menuchoice> box.
1249      This should also be included in the bug report.      This should also be included in the bug report.
1250      <screenshot>      <figure>
1251      <screeninfo>Error Dialog</screeninfo>      <title>Error Dialog</title>
1252      <mediaobject>      <mediaobject>
1253      <imageobject><imagedata fileref="../images/8_int_error.png" format="PNG" scale="&imgscale;"/></imageobject>      <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>      <imageobject><imagedata fileref="./images/8_int_error.eps" format="EPS" scale="&imgscale;"/></imageobject>
     <textobject><phrase>Error Dialog</phrase></textobject>  
     <caption><para>Error Dialog</para></caption>  
1255      </mediaobject>      </mediaobject>
1256      </screenshot>      </figure>
1257      </para>      </para>
1258    
1259    </chapter>    </chapter>
# Line 1319  Line 1290 
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 1329  Line 1316 
1316      to create custom projections. Thuban comes with predefined      to create custom projections. Thuban comes with predefined
1317      projections which are available through the Projections dialog.      projections which are available through the Projections dialog.
1318      </para>      </para>
1319      <variablelist>      <itemizedlist>
1320      <varlistentry>      <listitem>
1321          <term>Geographic</term>          <para>Geographic</para>
1322          <listitem><para><literal>Ellipsoid</literal></para>          <itemizedlist>
1323          <para><literal>Source Data</literal>: either Degrees or Radians          <listitem><para><literal>Ellipsoid</literal></para></listitem>
1324            <listitem><para>
1325                    <literal>Source Data</literal>: either Degrees or Radians
1326                  </para></listitem>                  </para></listitem>
1327      </varlistentry>          </itemizedlist>
1328      <varlistentry>      </listitem>
1329          <term>Lambert Conic Conformal</term>      <listitem>
1330          <listitem><para><literal>Ellipsoid</literal></para>          <para>Lambert Conic Conformal</para>
1331          <para><literal>Latitude of 1st standard parallel</literal></para>      <itemizedlist>
1332          <para><literal>Latitude of 2nd standard parallel</literal></para>          <listitem><para><literal>Ellipsoid</literal></para></listitem>
1333          <para><literal>Central Meridian</literal></para>          <listitem><para><literal>Latitude of 1st standard parallel</literal></para></listitem>
1334          <para><literal>Latitude of Origin</literal></para>          <listitem><para><literal>Latitude of 2nd standard parallel</literal></para></listitem>
1335          <para><literal>False Easting</literal> (meters)</para>          <listitem><para><literal>Central Meridian</literal></para></listitem>
1336          <para><literal>False Northing</literal> (meters)</para></listitem>          <listitem><para><literal>Latitude of Origin</literal></para></listitem>
1337      </varlistentry>          <listitem><para><literal>False Easting</literal> (meters)</para></listitem>
1338      <varlistentry>          <listitem><para><literal>False Northing</literal> (meters)</para></listitem>
1339          <term>Transverse Mercator</term>      </itemizedlist>
1340          <listitem><para><literal>Ellipsoid</literal></para>      </listitem>
1341          <para><literal>Latitude</literal>of origin</para>      <listitem>
1342          <para><literal>Longitude</literal>at central meridian</para>          <para>Transverse Mercator</para>
1343          <para><literal>Scale Factor</literal>at central meridian</para>      <itemizedlist>
1344          <para><literal>False Easting</literal> (meters)</para>          <listitem><para><literal>Ellipsoid</literal></para></listitem>
1345          <para><literal>False Northing</literal> (meters)</para></listitem>          <listitem><para><literal>Latitude</literal>of origin</para></listitem>
1346      </varlistentry>          <listitem><para><literal>Longitude</literal>at central meridian</para></listitem>
1347      <varlistentry>          <listitem><para><literal>Scale Factor</literal>at central meridian</para></listitem>
1348          <term>Universal Transverse Mercator</term>          <listitem><para><literal>False Easting</literal> (meters)</para></listitem>
1349          <listitem><para><literal>Ellipsoid</literal></para>          <listitem><para><literal>False Northing</literal> (meters)</para></listitem>
1350          <para><literal>Zone</literal>      </itemizedlist>
1351                  (can be guessed appling the Propose button)</para>      </listitem>
1352          <para><literal>Southern Hemisphere</literal> flag</para></listitem>      <listitem>
1353      </varlistentry>          <para>Universal Transverse Mercator</para>
1354      </variablelist>      <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>      <para>
1364      Thuban comes with a sample set of map projections for various      Thuban comes with a sample set of map projections for various
1365      European countries. Apart from the basic projection they differ      European countries. Apart from the basic projection they differ
1366      especially in their parameterization:      especially in their parameterization:
1367      </para>      </para>
1368      <variablelist>      <itemizedlist>
1369      <varlistentry><term>Belgium Datum 1972 (Lambert Conic Conformal)</term>      <listitem><para>Belgium Datum 1972 (Lambert Conic Conformal)</para>
1370          <listitem><para></para></listitem>      </listitem>
     </varlistentry>  
1371    
1372      <varlistentry><term>Gauss-Boaga Zone 1 (Italy, Transverse Mercartor)</term>      <listitem><para>Gauss-Boaga Zone 1 (Italy, Transverse Mercartor)</para>
1373          <listitem><para></para></listitem>      </listitem>
     </varlistentry>  
1374    
1375      <varlistentry><term>Gauss-Krueger Zone 2 (Germany, Transverse Mercartor)      <listitem><para>Gauss-Krueger Zone 2 (Germany, Transverse Mercartor)
1376      </term>      </para>
1377          <listitem><para></para></listitem>      </listitem>
     </varlistentry>  
1378    
1379      <varlistentry><term>Reseau Geodesique Francaise      <listitem><para>Reseau Geodesique Francaise
1380      (France, Lambert Conic Conformal)</term>      (France, Lambert Conic Conformal)</para>
1381          <listitem><para></para></listitem>      </listitem>
     </varlistentry>  
1382    
1383      <varlistentry><term>UK National Grid (United Kingdom, Transverse Mercartor)      <listitem><para>UK National Grid (United Kingdom, Transverse Mercartor)
1384      </term>      </para>
1385          <listitem><para></para></listitem>      </listitem>
1386      </varlistentry>      </itemizedlist>
     </variablelist>  
1387    
1388      <para>      <para>
1389      Thuban uses the comprehensive PROJ library for projections. PROJ provides      Thuban uses the comprehensive PROJ library for projections. PROJ provides
Legend:
Removed from v.1510  
changed lines
  Added in v.1533
[email protected]
 ViewVC Help
Powered by ViewVC 1.1.26