/[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 1530 by jonathan, Thu Jul 31 09:57:25 2003 UTC revision 1532 by frank, Thu Jul 31 10:58:24 2003 UTC
# Line 56  Line 56 
56          <variablelist>          <variablelist>
57          <varlistentry>          <varlistentry>
58          <term>Debian Testing (sarge)</term>          <term>Debian Testing (sarge)</term>
59          <listitem>          <listitem>
60              <para>Thuban-0.8.1-1-debian.i386.rpm</para>          <itemizedlist>
61              <para>GTK 1.2.3</para>              <listitem><para>Thuban-0.8.1-1-debian.i386.rpm</para></listitem>
62              <para>Python 2.2.1</para>              <listitem><para>GTK 1.2.3</para></listitem>
63              <para>Python 2.2 XML Base Tools</para>              <listitem><para>Python 2.2.1</para></listitem>
64              <para>wxWindows 2.4</para>              <listitem><para>Python 2.2 XML Base Tools</para></listitem>
65              <para>wxWindows 2.4 Python Bindings</para>              <listitem><para>wxWindows 2.4</para></listitem>
66              <para>proj 4.4.5 Projection Library</para>              <listitem><para>wxWindows 2.4 Python Bindings</para></listitem>
67              <para>SQLite Python Bindings 0.4.3</para>              <listitem><para>proj 4.4.5 Projection Library</para></listitem>
68              <para>GDAL 1.1.8</para>              <listitem><para>SQLite Python Bindings 0.4.3</para></listitem>
69                <listitem><para>GDAL 1.1.8</para></listitem>
70            </itemizedlist>
71          </listitem>          </listitem>
72          </varlistentry>          </varlistentry>
73          <varlistentry>          <varlistentry>
74          <term>RedHat 7.2</term>          <term>RedHat 7.2</term>
75          <listitem>          <listitem>
76              <para>Thuban-0.8.1-1.i386.rpm</para>          <itemizedlist>
77              <para>Python 2.2.1</para>              <listitem><para>Thuban-0.8.1-1.i386.rpm</para></listitem>
78              <para>wxPython 2.4 for Python 2.2 with wxGTK</para>              <listitem><para>Python 2.2.1</para></listitem>
79              <para>proj 4.4.5 Projection Library</para>              <listitem><para>wxPython 2.4 for Python 2.2 with wxGTK</para></listitem>
80              <para>SQLite 2.8.3</para>              <listitem><para>proj 4.4.5 Projection Library</para></listitem>
81              <para>PySQLite 0.4.3</para>              <listitem><para>SQLite 2.8.3</para></listitem>
82              <para>GDAL 1.1.8</para>              <listitem><para>PySQLite 0.4.3</para></listitem>
83                <listitem><para>GDAL 1.1.8</para></listitem>
84            </itemizedlist>
85          </listitem>          </listitem>
86          </varlistentry>          </varlistentry>
87          <varlistentry>          <varlistentry>
88          <term>Windows 2000</term>          <term>Windows 2000</term>
89          <listitem>          <listitem>
90              <para>Thuban-0.8.1-0.exe</para>          <itemizedlist>
91              <para>Python 2.2.1</para>              <listitem><para>Thuban-0.8.1-0.exe</para></listitem>
92              <para>wxWindows 2.4 for Python 2.2</para>              <listitem><para>Python 2.2.1</para></listitem>
93              <para>SQLite Python Libraries</para>              <listitem><para>wxWindows 2.4 for Python 2.2</para></listitem>
94              <para>GDAL for Thuban</para>              <listitem><para>SQLite Python Libraries</para></listitem>
95                <listitem><para>GDAL for Thuban</para></listitem>
96            </itemizedlist>
97          </listitem>          </listitem>
98          </varlistentry>          </varlistentry>
99          </variablelist>          </variablelist>
# Line 96  Line 102 
102    
103          <section><title>The Main Window</title>          <section><title>The Main Window</title>
104          <para>          <para>
105          <screenshot>          <figure>
106          <screeninfo>The Main Window</screeninfo>          <title>The Main Window</title>
107          <mediaobject>          <mediaobject>
108          <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>
109          <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>  
110          </mediaobject>          </mediaobject>
111          </screenshot>          </figure>
112          </para>          </para>
113    
114          <para>          <para>
# Line 198  Line 202 
202    
203          <section><title>The Session Info-Tree</title>          <section><title>The Session Info-Tree</title>
204          <para>          <para>
205          <screenshot>          <figure>
206          <screeninfo>Session Info Tree</screeninfo>          <title>Session Info Tree</title>
207          <mediaobject>          <mediaobject>
208          <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>
209          <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>  
210          </mediaobject>          </mediaobject>
211          </screenshot>          </figure>
212          </para>          </para>
213          <para>          <para>
214          The session info-tree is primarily intended for developers working          The session info-tree is primarily intended for developers working
# Line 287  Line 289 
289          the tool bar or from the          the tool bar or from the
290          <menuchoice><guimenu>Map</guimenu></menuchoice> menu.          <menuchoice><guimenu>Map</guimenu></menuchoice> menu.
291          </para>          </para>
292            <itemizedlist>
293            <listitem>
294          <para>          <para>
295          The ZoomIn tool          The ZoomIn tool
296          <inlinemediaobject>          <inlinemediaobject>
# Line 303  Line 307 
307          was clicked. Clicking and dragging selects a region that will be          was clicked. Clicking and dragging selects a region that will be
308          enlarged to fit the window.          enlarged to fit the window.
309          </para>          </para>
310            </listitem>
311            <listitem>
312          <para>          <para>
313          The ZoomOut tool          The ZoomOut tool
314          <inlinemediaobject>          <inlinemediaobject>
# Line 319  Line 325 
325          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
326          scaled to fit into that box.          scaled to fit into that box.
327          </para>          </para>
328            </listitem>
329            <listitem>
330          <para>          <para>
331          The Pan tool          The Pan tool
332          <inlinemediaobject>          <inlinemediaobject>
# Line 332  Line 340 
340          </inlinemediaobject>          </inlinemediaobject>
341          allows the user to move the map around by clicking and dragging.          allows the user to move the map around by clicking and dragging.
342          </para>          </para>
343            </listitem>
344            <listitem>
345          <para>          <para>
346          The Full Extent tool          The Full Extent tool
347          <inlinemediaobject>          <inlinemediaobject>
# Line 345  Line 355 
355          </inlinemediaobject>          </inlinemediaobject>
356          rescales the viewable region so that the entire map is visible.          rescales the viewable region so that the entire map is visible.
357          </para>          </para>
358            </listitem>
359            <listitem>
360          <para>          <para>
361          The Full Layer Extent tool          The Full Layer Extent tool
362          <inlinemediaobject>          <inlinemediaobject>
# Line 360  Line 372 
372          layer fits within the window. If no layer is selected this button          layer fits within the window. If no layer is selected this button
373          will be disabled.          will be disabled.
374          </para>          </para>
375            </listitem>
376            <listitem>
377          <para>          <para>
378          The Full Shape Extent tool          The Full Shape Extent tool
379          <inlinemediaobject>          <inlinemediaobject>
# Line 379  Line 393 
393          in a tableview (see below).          in a tableview (see below).
394    
395          </para>          </para>
396            </listitem>
397            </itemizedlist>
398          </section>          </section>
399    
400          <section><title>Object Identification</title>          <section><title>Object Identification</title>
# Line 447  Line 463 
463          <menuchoice><guimenu>Map</guimenu></menuchoice>.          <menuchoice><guimenu>Map</guimenu></menuchoice>.
464          </para>          </para>
465    
466            <itemizedlist>
467            <listitem>
468          <para>          <para>
469          The Move Layer to Top tool          The Move Layer to Top tool
470          <inlinemediaobject>          <inlinemediaobject>
# Line 459  Line 477 
477          <textobject> <phrase>Move Layer to Top</phrase> </textobject>          <textobject> <phrase>Move Layer to Top</phrase> </textobject>
478          </inlinemediaobject> raises the selected layer to the top of the map.          </inlinemediaobject> raises the selected layer to the top of the map.
479          </para>          </para>
480            </listitem>
481            <listitem>
482    
483          <para>          <para>
484          The Move Layer Up tool          The Move Layer Up tool
# Line 472  Line 492 
492          <textobject> <phrase>Move Layer Up</phrase> </textobject>          <textobject> <phrase>Move Layer Up</phrase> </textobject>
493          </inlinemediaobject> raises the selected layer one level.          </inlinemediaobject> raises the selected layer one level.
494          </para>          </para>
495            </listitem>
496            <listitem>
497    
498          <para>          <para>
499          The Move Layer Down tool          The Move Layer Down tool
# Line 486  Line 508 
508          </inlinemediaobject> lowers the selected layer one level.          </inlinemediaobject> lowers the selected layer one level.
509          </para>          </para>
510    
511            </listitem>
512            <listitem>
513          <para>          <para>
514          The Move Layer to Bottom tool          The Move Layer to Bottom tool
515          <inlinemediaobject>          <inlinemediaobject>
# Line 499  Line 523 
523          </inlinemediaobject> lowers the selected layer to the bottom of the map.          </inlinemediaobject> lowers the selected layer to the bottom of the map.
524          </para>          </para>
525    
526            </listitem>
527            <listitem>
528          <para>          <para>
529          The Visible tool          The Visible tool
530          <inlinemediaobject>          <inlinemediaobject>
# Line 513  Line 539 
539          hidden.          hidden.
540          </para>          </para>
541    
542            </listitem>
543            <listitem>
544          <para>          <para>
545          The Invisible tool          The Invisible tool
546          <inlinemediaobject>          <inlinemediaobject>
# Line 526  Line 554 
554          </inlinemediaobject> hides the selected layer in the map.          </inlinemediaobject> hides the selected layer in the map.
555          </para>          </para>
556    
557            </listitem>
558            <listitem>
559          <para>          <para>
560          The Properties tool          The Properties tool
561          <inlinemediaobject>          <inlinemediaobject>
# Line 540  Line 570 
570          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
571          properties dialog for that layer.          properties dialog for that layer.
572          </para>          </para>
573            </listitem>
574            </itemizedlist>
575          <para>          <para>
576          Along the bottom of the legend is the scalebar. The scalebar          Along the bottom of the legend is the scalebar. The scalebar
577          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 650 
650          and type.          and type.
651          </para>          </para>
652          <para>          <para>
653          <screenshot>          <figure>
654          <screeninfo>Properties Window</screeninfo>          <title>Properties Window</title>
655          <mediaobject>          <mediaobject>
656          <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>
657          <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>  
658          </mediaobject>          </mediaobject>
659          </screenshot>          </figure>
660          </para>          </para>
661          <para>          <para>
662          <screenshot>          <figure>
663          <screeninfo>Properties Window</screeninfo>          <title>Properties Window</title>
664          <mediaobject>          <mediaobject>
665          <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>
666          <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>  
667          </mediaobject>          </mediaobject>
668          </screenshot>          </figure>
669          </para>          </para>
670          </section>          </section>
671    
# Line 735  Line 762 
762          changes will not be applied to the map.          changes will not be applied to the map.
763          </para>          </para>
764          <para>          <para>
765          <screenshot>          <figure>
766          <screeninfo>Properties Window</screeninfo>          <title>Properties Window</title>
767          <mediaobject>          <mediaobject>
768          <imageobject><imagedata fileref="../images/5_classification.png" format="PNG" scale="&imgscale;"/></imageobject>          <imageobject><imagedata fileref="../images/5_classification.png" format="PNG" scale="&imgscale;"/></imageobject>
769          <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>  
770          </mediaobject>          </mediaobject>
771          </screenshot>          </figure>
772          </para>          </para>
773          <para>          <para>
774          The order of the groups in the classification is significant          The order of the groups in the classification is significant
# Line 809  Line 834 
834    
835          <section><title>Generating Classes</title>          <section><title>Generating Classes</title>
836          <para>          <para>
837          <screenshot>          <figure>
838          <screeninfo>Generate Class</screeninfo>          <title>Generate Class</title>
839          <mediaobject>          <mediaobject>
840          <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>
841          <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>  
842          </mediaobject>          </mediaobject>
843          </screenshot>          </figure>
844          </para>          </para>
845          <para>          <para>
846          Creating a classification by hand can be tedious.          Creating a classification by hand can be tedious.
# Line 846  Line 869 
869          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
870          properties of the last group. Thuban will interpolate between these          properties of the last group. Thuban will interpolate between these
871          two properties to generate the other groups.          two properties to generate the other groups.
872          <screenshot>          <figure>
873          <screeninfo>Custom Color Scheme</screeninfo>          <title>Custom Color Scheme</title>
874          <mediaobject>          <mediaobject>
875          <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>
876          <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>  
877          </mediaobject>          </mediaobject>
878          </screenshot>          </figure>
879          </para>          </para>
880          <para>          <para>
881          The Unique Values option lets the user select specific values that          The Unique Values option lets the user select specific values that
# Line 864  Line 885 
885          right. Each list can be sorted or reversed for easier searching.          right. Each list can be sorted or reversed for easier searching.
886          The classification that is generated will be in the same order as          The classification that is generated will be in the same order as
887          the list on the right.          the list on the right.
888          <screenshot>          <figure>
889          <screeninfo>Unique Values</screeninfo>          <title>Unique Values</title>
890          <mediaobject>          <mediaobject>
891          <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>
892          <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>  
893          </mediaobject>          </mediaobject>
894          </screenshot>          </figure>
895          </para>          </para>
896          <para>          <para>
897          The Uniform Distribution option creates a user specified number of          The Uniform Distribution option creates a user specified number of
# Line 881  Line 900 
900          table by clicking <guibutton>Retrieve From Table</guibutton>. The          table by clicking <guibutton>Retrieve From Table</guibutton>. The
901          stepping is how large each interval is. Adjusting this value will          stepping is how large each interval is. Adjusting this value will
902          automatically recalculate how many groups is appropriate.          automatically recalculate how many groups is appropriate.
903          <screenshot>          <figure>
904          <screeninfo>Uniform Distribution</screeninfo>          <title>Uniform Distribution</title>
905          <mediaobject>          <mediaobject>
906          <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>
907          <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>  
908          </mediaobject>          </mediaobject>
909          </screenshot>          </figure>
910          </para>          </para>
911          <para>          <para>
912          The Quantiles option generates ranges based on the number of items          The Quantiles option generates ranges based on the number of items
# Line 897  Line 914 
914          generate five groups with appropriate ranges such that 20% of the table          generate five groups with appropriate ranges such that 20% of the table
915          data is in each group. If it is impossible to generate exact          data is in each group. If it is impossible to generate exact
916          groupings, Thuban will issue a warning but allow the user to continue.          groupings, Thuban will issue a warning but allow the user to continue.
917          <screenshot>          <figure>
918          <screeninfo>Quantiles</screeninfo>          <title>Quantiles</title>
919          <mediaobject>          <mediaobject>
920          <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>
921          <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>  
922          </mediaobject>          </mediaobject>
923          </screenshot>          </figure>
924          </para>          </para>
925          </section>          </section>
926    </chapter>    </chapter>
# Line 927  Line 942 
942      <guimenu>Layer</guimenu>      <guimenu>Layer</guimenu>
943      <guimenuitem>Projection</guimenuitem>      <guimenuitem>Projection</guimenuitem>
944      </menuchoice>.      </menuchoice>.
945      <screenshot>      <figure>
946      <screeninfo>Projection Window</screeninfo>      <title>Projection Window</title>
947      <mediaobject>      <mediaobject>
948      <imageobject><imagedata fileref="../images/6_projection.png" format="PNG" scale="&imgscale;"/></imageobject>      <imageobject><imagedata fileref="../images/6_projection.png" format="PNG" scale="&imgscale;"/></imageobject>
949      <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>  
950      </mediaobject>      </mediaobject>
951      </screenshot>      </figure>
952      </para>      </para>
953      <para>      <para>
954      Thuban is distributed with a sample collection of projections. The      Thuban is distributed with a sample collection of projections. The
# Line 1005  Line 1018 
1018    
1019      <section><title>Table View</title>      <section><title>Table View</title>
1020          <para>          <para>
1021          <screenshot>          <figure>
1022          <screeninfo>Table View</screeninfo>          <title>Table View</title>
1023          <mediaobject>          <mediaobject>
1024          <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>
1025          <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>  
1026          </mediaobject>          </mediaobject>
1027          </screenshot>          </figure>
1028          </para>          </para>
1029          <para>          <para>
1030          Thuban provides a standard dialog to display table contents, the          Thuban provides a standard dialog to display table contents, the
# Line 1134  Line 1145 
1145    
1146          <section><title>Join</title>          <section><title>Join</title>
1147              <para>              <para>
1148              <screenshot>              <figure>
1149              <screeninfo>Join Tables</screeninfo>              <title>Join Tables</title>
1150              <mediaobject>              <mediaobject>
1151              <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>
1152              <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>  
1153              </mediaobject>              </mediaobject>
1154              </screenshot>              </figure>
1155              </para>              </para>
1156              <para>              <para>
1157              The              The
# Line 1227  Line 1236 
1236      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.
1237      </para>      </para>
1238      <para>      <para>
     <variablelist>  
1239    
1240      <varlistentry>      <itemizedlist>
     <term>After adding two or more layers nothing is drawn in the map window.  
     </term>  
1241      <listitem>      <listitem>
1242        <para>After adding two or more layers nothing is drawn in the map window.
1243        </para>
1244      <para>      <para>
1245      This is probably because the layers have different projections. Projections      This is probably because the layers have different projections. Projections
1246      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
1247      are different.      are different.
1248      </para>      </para>
1249      </listitem>      </listitem>
     </varlistentry>  
1250    
     <varlistentry>  
     <term>Thuban crashes on startup with the error  
         <literal>NameError: global name 'False' is not defined</literal>.  
     </term>  
1251      <listitem>      <listitem>
1252        <para>Thuban crashes on startup with the error
1253            <literal>NameError: global name 'False' is not defined</literal>.
1254        </para>
1255      <para>      <para>
1256      <varname>True</varname> and <varname>False</varname> were only introduced      <varname>True</varname> and <varname>False</varname> were only introduced
1257      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.
1258      </para>      </para>
1259      </listitem>      </listitem>
     </varlistentry>  
1260    
1261      <varlistentry>      <listitem>
1262      <term>After compiling Thuban, Thuban crashes with an error similar to      <para>After compiling Thuban, Thuban crashes with an error similar to
1263          <literal>          <literal>
1264          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
1265          </literal>          </literal>
1266      </term>      </para>
     <listitem>  
1267      <para>      <para>
1268      Thuban depends on the wxWindows library. If Thuban is compiled with an      Thuban depends on the wxWindows library. If Thuban is compiled with an
1269      incompatible version of the compiler than wxWindows was compiled with      incompatible version of the compiler than wxWindows was compiled with
# Line 1267  Line 1271 
1271      compiler.      compiler.
1272      </para>      </para>
1273      </listitem>      </listitem>
1274      </varlistentry>      </itemizedlist>
     </variablelist>  
1275      </para>      </para>
1276      <para>      <para>
1277      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 1279  Line 1282 
1282      More information about the system is available from      More information about the system is available from
1283      <menuchoice><guimenu>Help</guimenu><guimenuitem>About</guimenuitem></menuchoice> box.      <menuchoice><guimenu>Help</guimenu><guimenuitem>About</guimenuitem></menuchoice> box.
1284      This should also be included in the bug report.      This should also be included in the bug report.
1285      <screenshot>      <figure>
1286      <screeninfo>Error Dialog</screeninfo>      <title>Error Dialog</title>
1287      <mediaobject>      <mediaobject>
1288      <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>
1289      <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>  
1290      </mediaobject>      </mediaobject>
1291      </screenshot>      </figure>
1292      </para>      </para>
1293    
1294    </chapter>    </chapter>
# Line 1324  Line 1325 
1325      </listitem>      </listitem>
1326      </varlistentry>      </varlistentry>
1327    
1328        <varlistentry>
1329        <term>Raster files</term>
1330        <listitem>
1331            <para>
1332            Binding the GDAL library Thuban supports numerous raster file formats,
1333            see <ulink url="http://www.remotesensing.org/gdal/formats_list.html">
1334            GDAL format list</ulink> for details.</para>
1335    
1336            <para>Most commonly used is the <emphasis>TIFF/GeoTIFF</emphasis>
1337            format: Raster maps are provided as TIFF images, with an additional
1338            "world file" storing the geographic reference (usually with an
1339            extension ".tfw".
1340            </para>
1341        </listitem>
1342        </varlistentry>
1343    
1344      </variablelist>      </variablelist>
1345    </appendix>    </appendix>
1346    
# Line 1334  Line 1351 
1351      to create custom projections. Thuban comes with predefined      to create custom projections. Thuban comes with predefined
1352      projections which are available through the Projections dialog.      projections which are available through the Projections dialog.
1353      </para>      </para>
1354      <variablelist>      <itemizedlist>
1355      <varlistentry>      <listitem>
1356          <term>Geographic</term>          <para>Geographic</para>
1357          <listitem><para><literal>Ellipsoid</literal></para>          <itemizedlist>
1358          <para><literal>Source Data</literal>: either Degrees or Radians          <listitem><para><literal>Ellipsoid</literal></para></listitem>
1359            <listitem><para>
1360                    <literal>Source Data</literal>: either Degrees or Radians
1361                  </para></listitem>                  </para></listitem>
1362      </varlistentry>          </itemizedlist>
1363      <varlistentry>      </listitem>
1364          <term>Lambert Conic Conformal</term>      <listitem>
1365          <listitem><para><literal>Ellipsoid</literal></para>          <para>Lambert Conic Conformal</para>
1366          <para><literal>Latitude of 1st standard parallel</literal></para>      <itemizedlist>
1367          <para><literal>Latitude of 2nd standard parallel</literal></para>          <listitem><para><literal>Ellipsoid</literal></para></listitem>
1368          <para><literal>Central Meridian</literal></para>          <listitem><para><literal>Latitude of 1st standard parallel</literal></para></listitem>
1369          <para><literal>Latitude of Origin</literal></para>          <listitem><para><literal>Latitude of 2nd standard parallel</literal></para></listitem>
1370          <para><literal>False Easting</literal> (meters)</para>          <listitem><para><literal>Central Meridian</literal></para></listitem>
1371          <para><literal>False Northing</literal> (meters)</para></listitem>          <listitem><para><literal>Latitude of Origin</literal></para></listitem>
1372      </varlistentry>          <listitem><para><literal>False Easting</literal> (meters)</para></listitem>
1373      <varlistentry>          <listitem><para><literal>False Northing</literal> (meters)</para></listitem>
1374          <term>Transverse Mercator</term>      </itemizedlist>
1375          <listitem><para><literal>Ellipsoid</literal></para>      </listitem>
1376          <para><literal>Latitude</literal>of origin</para>      <listitem>
1377          <para><literal>Longitude</literal>at central meridian</para>          <para>Transverse Mercator</para>
1378          <para><literal>Scale Factor</literal>at central meridian</para>      <itemizedlist>
1379          <para><literal>False Easting</literal> (meters)</para>          <listitem><para><literal>Ellipsoid</literal></para></listitem>
1380          <para><literal>False Northing</literal> (meters)</para></listitem>          <listitem><para><literal>Latitude</literal>of origin</para></listitem>
1381      </varlistentry>          <listitem><para><literal>Longitude</literal>at central meridian</para></listitem>
1382      <varlistentry>          <listitem><para><literal>Scale Factor</literal>at central meridian</para></listitem>
1383          <term>Universal Transverse Mercator</term>          <listitem><para><literal>False Easting</literal> (meters)</para></listitem>
1384          <listitem><para><literal>Ellipsoid</literal></para>          <listitem><para><literal>False Northing</literal> (meters)</para></listitem>
1385          <para><literal>Zone</literal>      </itemizedlist>
1386                  (can be guessed appling the Propose button)</para>      </listitem>
1387          <para><literal>Southern Hemisphere</literal> flag</para></listitem>      <listitem>
1388      </varlistentry>          <para>Universal Transverse Mercator</para>
1389      </variablelist>      <itemizedlist>
1390            <listitem><para><literal>Ellipsoid</literal></para></listitem>
1391            <listitem><para><literal>Zone</literal>
1392                    (can be guessed appling the Propose button)</para></listitem>
1393            <listitem><para><literal>Southern Hemisphere</literal> flag</para></listitem>
1394        </itemizedlist>
1395        </listitem>
1396        </itemizedlist>
1397            
1398      <para>      <para>
1399      Thuban comes with a sample set of map projections for various      Thuban comes with a sample set of map projections for various
1400      European countries. Apart from the basic projection they differ      European countries. Apart from the basic projection they differ
1401      especially in their parameterization:      especially in their parameterization:
1402      </para>      </para>
1403      <variablelist>      <itemizedlist>
1404      <varlistentry><term>Belgium Datum 1972 (Lambert Conic Conformal)</term>      <listitem><para>Belgium Datum 1972 (Lambert Conic Conformal)</para>
1405          <listitem><para></para></listitem>      </listitem>
     </varlistentry>  
1406    
1407      <varlistentry><term>Gauss-Boaga Zone 1 (Italy, Transverse Mercartor)</term>      <listitem><para>Gauss-Boaga Zone 1 (Italy, Transverse Mercartor)</para>
1408          <listitem><para></para></listitem>      </listitem>
     </varlistentry>  
1409    
1410      <varlistentry><term>Gauss-Krueger Zone 2 (Germany, Transverse Mercartor)      <listitem><para>Gauss-Krueger Zone 2 (Germany, Transverse Mercartor)
1411      </term>      </para>
1412          <listitem><para></para></listitem>      </listitem>
     </varlistentry>  
1413    
1414      <varlistentry><term>Reseau Geodesique Francaise      <listitem><para>Reseau Geodesique Francaise
1415      (France, Lambert Conic Conformal)</term>      (France, Lambert Conic Conformal)</para>
1416          <listitem><para></para></listitem>      </listitem>
     </varlistentry>  
1417    
1418      <varlistentry><term>UK National Grid (United Kingdom, Transverse Mercartor)      <listitem><para>UK National Grid (United Kingdom, Transverse Mercartor)
1419      </term>      </para>
1420          <listitem><para></para></listitem>      </listitem>
1421      </varlistentry>      </itemizedlist>
     </variablelist>  
1422    
1423      <para>      <para>
1424      Thuban uses the comprehensive PROJ library for projections. PROJ provides      Thuban uses the comprehensive PROJ library for projections. PROJ provides
Legend:
Removed from v.1530  
changed lines
  Added in v.1532
[email protected]
 ViewVC Help
Powered by ViewVC 1.1.26