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

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

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

revision 1478 by frank, Thu Jul 24 17:00:25 2003 UTC revision 1544 by jan, Mon Aug 4 15:22:48 2003 UTC
# Line 1  Line 1 
1  <?xml version="1.0" encoding="ISO-8859-1"?>  <?xml version="1.0" encoding="ISO-8859-1"?>
2  <!DOCTYPE book  <!DOCTYPE book
3          PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"          PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
4          "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">          "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
5        [<!ENTITY imgscale "70">]>
6  <!-- $Revision$ -->  <!-- $Revision$ -->
7  <book>  <book>
8    <bookinfo>    <bookinfo>
# Line 23  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 47  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"/> </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"/> </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 100  Line 115 
115          The tool bar provides quick access to the commonly needed tools.          The tool bar provides quick access to the commonly needed tools.
116          By hovering over each button the user can see a short messages          By hovering over each button the user can see a short messages
117          describing what the tool does. The tools provided are Zoom In, Zoom          describing what the tool does. The tools provided are Zoom In, Zoom
118          Out, Pan, Full Extent, Full Layer Extent, Full Shape Extent, Indentify,          Out, Pan, Full Extent, Full Layer Extent, Full Shape Extent, Identify,
119          and Label. Each of the tools will be explained in further detail later          and Label. Each of the tools will be explained in further detail later
120          in the manual.          in the manual.
121          </para>          </para>
# Line 116  Line 131 
131          <menuchoice>          <menuchoice>
132          <guimenu>File</guimenu>          <guimenu>File</guimenu>
133          <guimenuitem>New Session</guimenuitem>          <guimenuitem>New Session</guimenuitem>
134          </menuchoice>.          </menuchoice>.
   
135          If a session is already loaded and has been modified without          If a session is already loaded and has been modified without
136          being saved a prompt will ask if the current session should          being saved a prompt will ask if the current session should
137          be saved.          be saved. A new session consists of an empty map with no
138            layers and no tables.
139          </para>          </para>
140          </section>          </section>
141    
# Line 131  Line 145 
145          <menuchoice>          <menuchoice>
146          <guimenu>File</guimenu>          <guimenu>File</guimenu>
147          <guimenuitem>Open Session</guimenuitem>          <guimenuitem>Open Session</guimenuitem>
148          </menuchoice>.          </menuchoice>. A dialog box will open allowing the user to browse
149            for a Thuban Session file. Thuban session files end with
150            <varname>.thuban</varname>. Selecting a file a clicking
151            <guibutton>OK</guibutton> will load the session into Thuban.
152    
153          If a session is already loaded and has been modified without          If a session is already loaded and has been modified without
154          being saved a prompt will ask if the current session should          being saved a prompt will ask if the current session should
# Line 145  Line 162 
162          <menuchoice>          <menuchoice>
163          <guimenu>File</guimenu>          <guimenu>File</guimenu>
164          <guimenuitem>Save Session</guimenuitem>          <guimenuitem>Save Session</guimenuitem>
165          </menuchoice>.          </menuchoice>. A dialog box will open allowing the user to browse
166            the file system and select a place to save the session. Thuban
167            sessions should be saved under a name ending in
168            <varname>.thuban</varname>. If the file already exists the user
169            will be prompted to save under a different name or overwrite the
170            existing file.
171          </para>          </para>
172          </section>          </section>
173    
174          <section><title>The Session Info-Tree</title>          <section><title>The Session Info-Tree</title>
175            <para>
176            <figure>
177            <title>Session Info Tree</title>
178            <mediaobject>
179            <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>
181            </mediaobject>
182            </figure>
183            </para>
184          <para>          <para>
185                  (primarily for developers)          The session info-tree is primarily intended for developers working
186            with Thuban. It displays many of the internal values for the session,
187            map, and layers. It can be opened from
188            <menuchoice>
189            <guimenu>File</guimenu>
190            <guimenuitem>Session Tree</guimenuitem>
191            </menuchoice>.
192          </para>          </para>
193          </section>          </section>
194    </chapter>    </chapter>
# Line 163  Line 199 
199      different type of data set. By interacting with the map the user can      different type of data set. By interacting with the map the user can
200      visually explore the data.      visually explore the data.
201      </para>      </para>
202        <para>
203        The map can have a name that will appear in the Thuban title bar.
204        The map name can be changed using
205        <menuchoice>
206        <guimenu>Map</guimenu>
207        <guimenuitem>Rename</guimenuitem>
208        </menuchoice>.
209        </para>
210        <para>
211        <inlinemediaobject>
212        <imageobject>
213        <imagedata fileref="../images/3_rename_map.png" format="PNG" scale="&imgscale;"/>
214        </imageobject>
215        <imageobject>
216        <imagedata fileref="./images/3_rename_map.eps" format="EPS" scale="&imgscale;"/>
217        </imageobject>
218        <textobject> <phrase>Rename Map</phrase> </textobject>
219        </inlinemediaobject>
220        </para>
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. Normally, these          standard file format for storing geographic objects. These
227          files have the extension ``.shp''. Associated with          files have the extension ``.shp''. Associated with
228          the object information is a database file which stores attributes for          the shape file is a database file which stores attributes for
229          each shape in the Shapefile. This file, stored in DB2 format, usually          each shape in the shape file. This file, in dBase format,
230          has the extension ``.dbf''. Both files should have the same base name.          has the extension ``.dbf''. Both files must have the same base name.
231          For example, if there is a Shapefile named roads.shp there should          For example, if there is a shape file named roads.shp there must
232          also be a file roads.dbf.          also be a file roads.dbf.
233          </para>          </para>
234          <para>          <para>
# Line 183  Line 238 
238          <guimenuitem>Add Layer</guimenuitem>          <guimenuitem>Add Layer</guimenuitem>
239          </menuchoice>.          </menuchoice>.
240          Thuban will load all files with the same base name, so it doesn't          Thuban will load all files with the same base name, so it doesn't
241          matter if the Shapefile or database file is selected.          matter if the shape file or database file is selected.
242          </para>          </para>
243    
244          <para>          <para>
# Line 193  Line 248 
248          <guimenuitem>Add Image Layer</guimenuitem>          <guimenuitem>Add Image Layer</guimenuitem>
249          </menuchoice>.          </menuchoice>.
250          It is important to select a valid image file that has geographic          It is important to select a valid image file that has geographic
251          data associated with it. This can be embedded in the file itself,          data associated with it. The data can be embedded in the file itself,
252          or in another file. If geographic information cannot be found, Thuban          or in another file. If geographic information cannot be found, Thuban
253          will report an error.          will report an error.
254          </para>          </para>
# Line 202  Line 257 
257          <section><title>Navigation</title>          <section><title>Navigation</title>
258          <para>          <para>
259          The map can be explored by using the navigation tools available on          The map can be explored by using the navigation tools available on
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>
268          <imageobject>          <imageobject>
269          <imagedata fileref="../images/3_2_zoomin.png" format="PNG"/>          <imagedata fileref="../images/3_2_zoomin.png" format="PNG" scale="&imgscale;"/>
270          </imageobject>          </imageobject>
271          <imageobject>          <imageobject>
272          <imagedata fileref="./images/3_2_zoomin.eps" format="EPS"/>          <imagedata fileref="./images/3_2_zoomin.eps" format="EPS" scale="&imgscale;"/>
273          </imageobject>          </imageobject>
274          <textobject> <phrase>ZoomIn Tool</phrase> </textobject>          <textobject> <phrase>ZoomIn Tool</phrase> </textobject>
275          </inlinemediaobject>          </inlinemediaobject>
276          can be used to enlarge 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 lets the user select a region          was clicked. Clicking and dragging selects a region that will be
279          to be 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>
286          <imageobject>          <imageobject>
287          <imagedata fileref="../images/3_2_zoomout.png" format="PNG"/>          <imagedata fileref="../images/3_2_zoomout.png" format="PNG" scale="&imgscale;"/>
288          </imageobject>          </imageobject>
289          <imageobject>          <imageobject>
290          <imagedata fileref="./images/3_2_zoomout.eps" format="EPS"/>          <imagedata fileref="./images/3_2_zoomout.eps" format="EPS" scale="&imgscale;"/>
291          </imageobject>          </imageobject>
292          <textobject> <phrase>ZoomOut Tool</phrase> </textobject>          <textobject> <phrase>ZoomOut Tool</phrase> </textobject>
293          </inlinemediaobject>          </inlinemediaobject>
# Line 237  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>
304          <imageobject>          <imageobject>
305          <imagedata fileref="../images/3_2_pan.png" format="PNG"/>          <imagedata fileref="../images/3_2_pan.png" format="PNG" scale="&imgscale;"/>
306          </imageobject>          </imageobject>
307          <imageobject>          <imageobject>
308          <imagedata fileref="./images/3_2_pan.eps" format="EPS"/>          <imagedata fileref="./images/3_2_pan.eps" format="EPS" scale="&imgscale;"/>
309          </imageobject>          </imageobject>
310          <textobject> <phrase>Pan Tool</phrase> </textobject>          <textobject> <phrase>Pan Tool</phrase> </textobject>
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>
319          <imageobject>          <imageobject>
320          <imagedata fileref="../images/3_2_fullextent.png" format="PNG"/>          <imagedata fileref="../images/3_2_fullextent.png" format="PNG" scale="&imgscale;"/>
321          </imageobject>          </imageobject>
322          <imageobject>          <imageobject>
323          <imagedata fileref="./images/3_2_fullextent.eps" format="EPS"/>          <imagedata fileref="./images/3_2_fullextent.eps" format="EPS" scale="&imgscale;"/>
324          </imageobject>          </imageobject>
325          <textobject> <phrase>Full Extent Tool</phrase> </textobject>          <textobject> <phrase>Full Extent Tool</phrase> </textobject>
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>
334          <imageobject>          <imageobject>
335          <imagedata fileref="../images/3_2_fulllayerextent.png" format="PNG"/>          <imagedata fileref="../images/3_2_fulllayerextent.png" format="PNG" scale="&imgscale;"/>
336          </imageobject>          </imageobject>
337          <imageobject>          <imageobject>
338          <imagedata fileref="./images/3_2_fulllayerextent.eps" format="EPS"/>          <imagedata fileref="./images/3_2_fulllayerextent.eps" format="EPS" scale="&imgscale;"/>
339          </imageobject>          </imageobject>
340          <textobject> <phrase>Full Layer Extent Tool</phrase> </textobject>          <textobject> <phrase>Full Layer Extent Tool</phrase> </textobject>
341          </inlinemediaobject>          </inlinemediaobject>
# Line 278  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>
351          <imageobject>          <imageobject>
352          <imagedata fileref="../images/3_2_fullshapeextent.png" format="PNG"/>          <imagedata fileref="../images/3_2_fullshapeextent.png" format="PNG" scale="&imgscale;"/>
353          </imageobject>          </imageobject>
354          <imageobject>          <imageobject>
355          <imagedata fileref="./images/3_2_fullshapeextent.eps" format="EPS"/>          <imagedata fileref="./images/3_2_fullshapeextent.eps" format="EPS" scale="&imgscale;"/>
356          </imageobject>          </imageobject>
357          <textobject> <phrase>Full Shape Extent Tool</phrase> </textobject>          <textobject> <phrase>Full Shape Extent Tool</phrase> </textobject>
358          </inlinemediaobject>          </inlinemediaobject>
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 301  Line 373 
373          Objects on the map can be identified using the Identify tool          Objects on the map can be identified using the Identify tool
374          <inlinemediaobject>          <inlinemediaobject>
375          <imageobject>          <imageobject>
376          <imagedata fileref="../images/3_3_identify.png" format="PNG"/>          <imagedata fileref="../images/3_3_identify.png" format="PNG" scale="&imgscale;"/>
377          </imageobject>          </imageobject>
378          <imageobject>          <imageobject>
379          <imagedata fileref="./images/3_3_identify.eps" format="EPS"/>          <imagedata fileref="./images/3_3_identify.eps" format="EPS" scale="&imgscale;"/>
380          </imageobject>          </imageobject>
381          <textobject> <phrase>Identify Tool</phrase> </textobject>          <textobject> <phrase>Identify Tool</phrase> </textobject>
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    
390          <section><title>Object Labelling</title>          <section><title>Object Labeling</title>
391          <para>          <para>
392          Objects can be labelled using the Label tool          Objects can be labeled using the Label tool
393          <inlinemediaobject>          <inlinemediaobject>
394          <imageobject>          <imageobject>
395          <imagedata fileref="../images/3_3_label.png" format="PNG"/>          <imagedata fileref="../images/3_3_label.png" format="PNG" scale="&imgscale;"/>
396          </imageobject>          </imageobject>
397          <imageobject>          <imageobject>
398          <imagedata fileref="./images/3_3_label.eps" format="EPS"/>          <imagedata fileref="./images/3_3_label.eps" format="EPS" scale="&imgscale;"/>
399          </imageobject>          </imageobject>
400          <textobject> <phrase>Label Tool</phrase> </textobject>          <textobject> <phrase>Label Tool</phrase> </textobject>
401          </inlinemediaobject>.          </inlinemediaobject>.
402          Clicking on an object selects that object and opens a dialog which          Clicking on an object selects that object and opens a dialog which
403          displays the table attributes for that object. An attribute can          displays the table attributes for that object. An attribute can
404          be selected to be the label on the map. Using this tool for an          be selected to be the label on the map. The label will be placed
405          object that already has a label will remove the label.          at the center of the shape. Clicking on an object that already has
406            a label will remove the label.
407          </para>          </para>
408          </section>          </section>
409    
410          <section><title>The Legend</title>          <section><title>The Legend</title>
411            <para>
412            <inlinemediaobject>
413            <imageobject>
414            <imagedata fileref="../images/3_5_legend.png" format="PNG" scale="&imgscale;"/>
415            </imageobject>
416            <imageobject>
417            <imagedata fileref="./images/3_5_legend.eps" format="EPS" scale="&imgscale;"/>
418            </imageobject>
419            <textobject> <phrase>Legend</phrase> </textobject>
420            </inlinemediaobject>
421            </para>
422          <para>          <para>
423          The Legend provides an overview of the layers in the map. Layers          The Legend provides an overview of the layers in the map. Layers
424          that appear higher in the legend will appear ``closer'' to the user.          that appear higher in the legend will appear ``closer'' to the user.
# Line 346  Line 431 
431          <para>          <para>
432          Along the top of the legend is a toolbar which allows quick access          Along the top of the legend is a toolbar which allows quick access
433          to some of the layer manipulation options under          to some of the layer manipulation options under
434          <menuchoice> <guimenu>Map</guimenu> </menuchoice>.          <menuchoice><guimenu>Map</guimenu></menuchoice>.
435            </para>
436    
437            <itemizedlist>
438            <listitem>
439            <para>
440            The Move Layer to Top tool
441            <inlinemediaobject>
442            <imageobject>
443            <imagedata fileref="../images/3_5_totop.png" format="PNG" scale="&imgscale;"/>
444            </imageobject>
445            <imageobject>
446            <imagedata fileref="./images/3_5_totop.eps" format="EPS" scale="&imgscale;"/>
447            </imageobject>
448            <textobject> <phrase>Move Layer to Top</phrase> </textobject>
449            </inlinemediaobject> raises the selected layer to the top of the map.
450            </para>
451            </listitem>
452            <listitem>
453    
454            <para>
455            The Move Layer Up tool
456            <inlinemediaobject>
457            <imageobject>
458            <imagedata fileref="../images/3_5_moveup.png" format="PNG" scale="&imgscale;"/>
459            </imageobject>
460            <imageobject>
461            <imagedata fileref="./images/3_5_moveup.eps" format="EPS" scale="&imgscale;"/>
462            </imageobject>
463            <textobject> <phrase>Move Layer Up</phrase> </textobject>
464            </inlinemediaobject> raises the selected layer one level.
465            </para>
466            </listitem>
467            <listitem>
468    
469            <para>
470            The Move Layer Down tool
471            <inlinemediaobject>
472            <imageobject>
473            <imagedata fileref="../images/3_5_movedown.png" format="PNG" scale="&imgscale;"/>
474            </imageobject>
475            <imageobject>
476            <imagedata fileref="./images/3_5_movedown.eps" format="EPS" scale="&imgscale;"/>
477            </imageobject>
478            <textobject> <phrase>Move Layer Down</phrase> </textobject>
479            </inlinemediaobject> lowers the selected layer one level.
480            </para>
481    
482            </listitem>
483            <listitem>
484            <para>
485            The Move Layer to Bottom tool
486            <inlinemediaobject>
487            <imageobject>
488            <imagedata fileref="../images/3_5_tobottom.png" format="PNG" scale="&imgscale;"/>
489            </imageobject>
490            <imageobject>
491            <imagedata fileref="./images/3_5_tobottom.eps" format="EPS" scale="&imgscale;"/>
492            </imageobject>
493            <textobject> <phrase>Move Layer to Bottom</phrase> </textobject>
494            </inlinemediaobject> lowers the selected layer to the bottom of the map.
495            </para>
496    
497            </listitem>
498            <listitem>
499            <para>
500            The Visible tool
501            <inlinemediaobject>
502            <imageobject>
503            <imagedata fileref="../images/3_5_visible.png" format="PNG" scale="&imgscale;"/>
504            </imageobject>
505            <imageobject>
506            <imagedata fileref="./images/3_5_visible.eps" format="EPS" scale="&imgscale;"/>
507            </imageobject>
508            <textobject> <phrase>Visible</phrase> </textobject>
509            </inlinemediaobject> shows the selected layer in the map if it was
510            hidden.
511            </para>
512    
513            </listitem>
514            <listitem>
515            <para>
516            The Invisible tool
517            <inlinemediaobject>
518            <imageobject>
519            <imagedata fileref="../images/3_5_invisible.png" format="PNG" scale="&imgscale;"/>
520            </imageobject>
521            <imageobject>
522            <imagedata fileref="./images/3_5_invisible.eps" format="EPS" scale="&imgscale;"/>
523            </imageobject>
524            <textobject> <phrase>Invisible</phrase> </textobject>
525            </inlinemediaobject> hides the selected layer in the map.
526            </para>
527    
528            </listitem>
529            <listitem>
530            <para>
531            The Properties tool
532            <inlinemediaobject>
533            <imageobject>
534            <imagedata fileref="../images/3_5_props.png" format="PNG" scale="&imgscale;"/>
535            </imageobject>
536            <imageobject>
537            <imagedata fileref="./images/3_5_props.eps" format="EPS" scale="&imgscale;"/>
538            </imageobject>
539            <textobject> <phrase>Properties</phrase> </textobject>
540            </inlinemediaobject> opens the layer's properties dialog box.
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>
552    
553            <section><title>Exporting</title>
554            <para>
555            Under Windows, maps can be exported in Enhanced Metafile format
556            (<varname>.wmf</varname>)
557            from
558            <menuchoice>
559            <guimenu>Map</guimenu>
560            <guimenuitem>Export</guimenuitem>
561            </menuchoice> for use in reports, presentations, or further
562            modification. The current map view, legend, and, if available,
563            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>
567          </section>          </section>
568    
569          <section><title>Printing</title>          <section><title>Printing</title>
# Line 359  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.          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.
579          </para>          </para>
580          </section>          </section>
581    
582    </chapter>    </chapter>
583    
584    <chapter><title>Layer Management</title>    <chapter><title>Layer Management</title>
# Line 374  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 GDAL. The images must have geographic          file format supported by the Geo-spatial Data Abstraction Library
595          coordinate data either embedded within the file, or in a seperate          (GDAL). The images must have geographic
596            coordinate data either embedded within the file or in a separate
597          file that is in the same directory as the image file. GeoTIFF files          file that is in the same directory as the image file. GeoTIFF files
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>
610          <para>          <para>
611          Each shape in a shape layer can have various properties which control          To view the properties for a layer it must first be selected in the
612          how it is drawn on the map. Polygons and points can be drawn with an          legend. The menu option
613          outline color and a fill color, while lines have only a line color.          <menuchoice>
614            <guimenu>Layer</guimenu>
615            <guimenuitem>Properties</guimenuitem>
616            </menuchoice> opens a dialog that displays a layer's properties.
617            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
619            of shape (polygon, arc, point) the classification table will be
620            shown. Image layers have no other properties other than title
621            and type.
622            </para>
623            <para>
624            <figure>
625            <title>Properties Window</title>
626            <mediaobject>
627            <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>
629            </mediaobject>
630            </figure>
631            </para>
632            <para>
633            <figure>
634            <title>Properties Window</title>
635            <mediaobject>
636            <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>
638            </mediaobject>
639            </figure>
640          </para>          </para>
641          </section>          </section>
642    
# Line 396  Line 645 
645          Sometimes it is not desirable to view all layers at the same time.          Sometimes it is not desirable to view all layers at the same time.
646          Some layers may take a long time to draw and so while navigating          Some layers may take a long time to draw and so while navigating
647          around the map the user may not want to wait for the map to redraw          around the map the user may not want to wait for the map to redraw
648          each time the map is changed. Each layer can be independently          all the layers each time the map is changed. Each layer can be
649          turned on or off using the          independently turned on or off using the
650          <menuchoice>          <menuchoice>
651          <guimenu>Layer</guimenu>          <guimenu>Layer</guimenu>
652          <guimenuitem>Show</guimenuitem>          <guimenuitem>Show</guimenuitem>
# Line 410  Line 659 
659          </para>          </para>
660          </section>          </section>
661    
         <section><title>Sequence</title>  
         <para>  
         </para>  
         </section>  
   
662          <section><title>Duplication</title>          <section><title>Duplication</title>
663          <para>          <para>
664          Layers and all their properties, including classifications, can          Layers and all their properties, including classifications, can
# Line 424  Line 668 
668          <guimenuitem>Duplicate</guimenuitem>          <guimenuitem>Duplicate</guimenuitem>
669          </menuchoice>. Duplicating a layer is useful if the user wishes          </menuchoice>. Duplicating a layer is useful if the user wishes
670          to model a layer in several different ways. Even though the layers          to model a layer in several different ways. Even though the layers
671          overlap by carefully selecting the shape properties it is possible          overlap, by carefully selecting the shape properties it is possible
672          to display several pieces of information at once. For example, one          to display several pieces of information at once. For example, one
673          copy of a roads layer may be classified on a length property and          copy of a roads layer may be classified on a length property and
674          another copy may be classified on a type property. if the length          another copy may be classified on a type property. If the length
675          property was expressed with color and the type property expressed          property was expressed with color and the type property expressed
676          with line thickness then it would be possible to view both          with line thickness then it would be possible to view both
677          classifications by placing the type property copy over the          classifications by placing the type property copy over the
# Line 445  Line 689 
689      cannot be classified.      cannot be classified.
690      </para>      </para>
691      <para>      <para>
692      A classification consists of a number of groups, with each group      A classification consists of a number of groups, each group
693      having a value or range of values to match against, and symbol      having a value or range of values to match against, and symbol
694      properties which control how a shape is drawn on the map. The user      properties which control how a shape is drawn on the map. The user
695      selects which field in the table is used by the classification and      selects which field in the table is used by the classification and
# Line 458  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.      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 476  Line 721 
721          button.          button.
722          </para>          </para>
723          <para>          <para>
724            To apply the changes to the map the user can click
725            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>
739            <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>
741            </mediaobject>
742            </figure>
743            </para>
744            <para>
745          The order of the groups in the classification is significant          The order of the groups in the classification is significant
746          except for the DEFAULT group, which remains at the top. When shapes          except for the DEFAULT group, which remains at the top. When shapes
747          are matched against groups the matching begins at the first group          are matched against groups the matching begins at the first group
748          other than the DEFAULT group so that groups higher in the list will          after the DEFAULT group so that groups higher in the list will
749          be checked first. Matching for a          be checked first. Matching for a
750          given shape will stop at the first group that matches. The user can          given shape will stop at the first group that matches. The user can
751          use <guibutton>Move Up</guibutton> and <guibutton>Move Down</guibutton>          use <guibutton>Move Up</guibutton> and <guibutton>Move Down</guibutton>
752          to change the order of the groups. The DEFAULT group will always          to change the order of the groups. The DEFAULT group will always
753          match a shape that hasn't matched another group.          match a shape that hasn't matched another group.
754          </para>          </para>
755          <para>              <section><title>Visible</title>
756          The Value column of the classification table is the value that will              <para>
757          be matched when the map is being drawn. The type of data that can              The Visible column has check-boxes that determine whether a
758          entered into this field depends on the type of data of the              classification group will be displayed in the legend. This is
759          classification field.              useful if the user knows that the groups completely cover
760          </para>              the data set and don't want the DEFAULT group to be displayed
761          <para>              in the legend and on a printout.
762          If the field is of type Text, anything entered              </para>
763          into the field is valid. The text will be compared literally to the          </section>
764          value of the shape attribute, including case sensitivity.              <section><title>Symbols</title>
765          If the type is Integer, then any valid integer may be entered. In              <para>
766          addition, with special syntax, a range of values can be entered.              Each type of shape has its own type of symbol. Thuban supports three
767          A range from <varname>start</varname> to <varname>end</varname>              types of shapes: polygons, lines, and points. Polygons and points
768          inclusive is specifed like this: <literal>[start;end]</literal>.              have outline and fill color, while lines have only line color. Each
769          The exclusive range is specified like this:              group has associated symbol properties. To edit the symbol
770          <literal>]start;end[</literal>. Ranges can include infinity like              properties for a group the user can double click on the Symbol
771          this: <literal>[-oo;oo]</literal>. Field types can also be of type              column or select a group and click the
772          Decimal. They represent any rational number and can be used in ranges              <guibutton>Edit Symbol</guibutton> button.
773          as well.              </para>
774          </para>              </section>
775          </section>          <section><title>Value</title>
776                <para>
777          <section><title>Symbols</title>              The Value column of the classification table is the value that will
778          <para>              be matched when the map is being drawn. The type of data that can
779          Each type of shape has its own type of symbol. Thuban supports three              entered into this field depends on the type of data of the
780          types of shapes: polygons, lines, and points. Polygons and points have              classification field.
781          outline and fill color, while lines have only line color. Each group              </para>
782          has associated symbol properties. To edit the symbol properties for a              <para>
783          group the user can double click on the Symbol column or select a              If the field is of type Text, anything entered
784          group and click the <guibutton>Edit Symbol</guibutton> button.              into the field is valid. The text will be compared literally to the
785          </para>              value of the shape attribute, including case sensitivity.
786                If the type is Integer, then any valid integer may be entered. In
787                addition, with special syntax, a range of values can be entered.
788                A range from <varname>start</varname> to <varname>end</varname>
789                inclusive is specified like this: <literal>[start;end]</literal>.
790                The exclusive range is specified like this:
791                <literal>]start;end[</literal>. Ranges can include infinity like
792                this: <literal>[-oo;oo]</literal>. Field types can also be of type
793                Decimal. They represent any rational number and can be used in
794                ranges as well.
795                </para>
796                </section>
797                <section><title>Label</title>
798                <para>
799                By default, the text that is displayed for a group in the legend
800                is the value for that group. The label can substitute a more
801                descriptive term in the legend.
802                </para>
803            </section>
804          </section>          </section>
805    
806          <section><title>Generating Classes</title>          <section><title>Generating Classes</title>
807          <para>          <para>
808            <figure>
809            <title>Generate Class</title>
810            <mediaobject>
811            <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>
813            </mediaobject>
814            </figure>
815            </para>
816            <para>
817          Creating a classification by hand can be tedious.          Creating a classification by hand can be tedious.
818          Thuban, therefore, provides a means of generating an entire          Thuban, therefore, provides a means of generating an entire
819          classification at once while still giving the user control over          classification at once while still giving the user control over
820          how it appears. Clicking <guibutton>Generate Class</guibutton>          how it appears. Clicking <guibutton>Generate Class</guibutton>
821          opens the <varname>Generate Classification</varname> dialog.          opens the <varname>Generate Classification</varname> dialog.
822          Under the <varname>Generate</varname> pulldown 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 they 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 551  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 items          The Quantiles option generates ranges based on the number of items
884          in the input set. For example, by specifying 5 groups Thuban will          in the table. For example, by specifying five groups Thuban will
885          generate 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          grouping, 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 574  Line 900 
900      <para>      <para>
901      Projections control how the geographic data is displayed on the screen.      Projections control how the geographic data is displayed on the screen.
902      If multiple layers are loaded into Thuban where the geographic data      If multiple layers are loaded into Thuban where the geographic data
903      is in a different projection system, then the user must tell Thuban      is in a different projection system, then the user must specify a
904      which projection each layer has. The user must also tell Thuban which      projection for each layer. The user must also tell Thuban which
905      projection the map is in. This can be the same as the layers or a different      projection the map is in. This can be the same as the layers or a different
906      projection in which case the layers are reprojected into that space.      projection in which case the layers are reprojected into that space.
907      The map projection can be set using      The map projection can be set using
# Line 587  Line 913 
913      <guimenu>Layer</guimenu>      <guimenu>Layer</guimenu>
914      <guimenuitem>Projection</guimenuitem>      <guimenuitem>Projection</guimenuitem>
915      </menuchoice>.      </menuchoice>.
916        <figure>
917        <title>Projection Window</title>
918        <mediaobject>
919        <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>
921        </mediaobject>
922        </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
926      user can create new projections and make them available to all      user can create new projections and make them available to all
927      future Thuban sessions. They may also be exported and imported so      future Thuban sessions. They may also be exported and imported so
928      that custom projections can be distributed to others.      that custom projections can be distributed.
929      </para>      </para>
930          <section><title>Selecting a Projection</title>          <section><title>Selecting a Projection</title>
931          <para>          <para>
932          The available projections are listed on the left. If the layer          The available projections are listed on the left. If the layer
933          or map already has a projection it will be initially highlighted          or map already has a projection it will initially be highlighted
934          and will end with <varname>(current)</varname>. Selecting          and will end with <varname>(current)</varname>. Selecting
935          <varname>None</varname> will cause Thuban to use the data as          <varname>&lt;None&gt;</varname> will cause Thuban to use the data as
936          it appears in the source file and will not use a projection.          it appears in the source file and will not use a projection.
937          </para>          </para>
938      </section>      </section>
# Line 608  Line 941 
941          Whenever a projection is selected from the list its properties          Whenever a projection is selected from the list its properties
942          are displayed on the right. These properties can be changed          are displayed on the right. These properties can be changed
943          and the changes saved to the selected projection using          and the changes saved to the selected projection using
944          the <guibutton>Update</guibutton>. Only a projection that comes          <guibutton>Update</guibutton>. Only a projection that comes
945          from a file can be updated, so if the current layer's projection          from a file can be updated, so if the current layer's projection
946          is selectd, <guibutton>Update</guibutton> will be disabled.          is selected, <guibutton>Update</guibutton> will be disabled.
947          The <guibutton>Add to List</guibutton> adds the projection to the          <guibutton>Add to List</guibutton> adds the projection to the
948          list of available projections as a new entry, and thus make it          list of available projections as a new entry, and thus makes it
949          available to future Thuban sessions. Clicking <guibutton>New</guibutton>          available to future Thuban sessions. Clicking <guibutton>New</guibutton>
950          will create an entirely new, empty projection. The          will create an entirely new, empty projection. The
951          <guibutton>Remove</guibutton> button will permanantly 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>
969          The projections that appear in the list of available projections          The projections that appear in the list of available projections
970          can be exported to another file that the user chooses. By selecting          can be exported to another file that the user chooses. By selecting
971          one or more projections and clicking <guibutton>Export</guibutton>          one or more projections and clicking <guibutton>Export</guibutton>
972          the user will be able to select a file to store those projections.          the user will be able to select a file in which to store those
973            projections.
974          The file can then be distributed to other Thuban users. To import          The file can then be distributed to other Thuban users. To import
975          a projection file the user can click <guibutton>Import</guibutton>.          a projection file the user can click <guibutton>Import</guibutton>.
976          The imported projections are added to the list and are then available          The imported projections are added to the list and are then available
977          to the current session and any future Thuban session.          to the current session and any future Thuban sessions.
978          </para>          </para>
979      </section>      </section>
980    </chapter>    </chapter>
981    
982    <chapter><title>Table Management</title>    <chapter><title>Table Management</title>
983      <para>      <para>
984              Thuban distinguishes two different types of tables: Attribute tables      Thuban distinguishes two different types of tables: Attribute tables
985              (which belong to a layer) and usual data tables. Both provide in      (which belong to a layer) and normal data tables. Both provide
986          general the same functionality with the difference that actions on an          the same general functionality with the difference that actions on an
987              attribute table might also effect the map display.      attribute table might also effect the map display.
988      </para>      </para>
989    
990      <section><title>Table View</title>      <section><title>Table View</title>
991        <para>          <para>
992            <figure>
993            <title>Table View</title>
994            <mediaobject>
995            <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>
997            </mediaobject>
998            </figure>
999            </para>
1000            <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 into 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>
1006          The title bar identifies the table with it's name.          The title bar identifies the table with its name.
1007        </para>          </para>
1008        <para>          <para>
1009          The functions box let the user perform simple analysis on the data          The selections box let the user perform simple analysis on the data
1010          based on comparisons: First choice must be a field identifier of the          based on comparisons: The first choice must be a field identifier of
1011          table, the second choice determines the type of comparison. The third          the table, the second choice determines the type of comparison. The
1012          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_habitants <  bike_per_habitants" (note that the field names          <literal>cars_per_inhabitant < bikes_per_inhabitant</literal>
1017          are only explanatory, the currently considered 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
1022          selection to a previous set. The default is that a selection replaces          selection to a previous set. The default is that a selection replaces
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>
1030          The contents of a table can be exported into a file, either dbase          The contents of a table can be exported into a file, either dBase
1031          format (DBF) or comma seperated values (CSV). The 'Export' button          format (DBF) or comma separated values (CSV). The
1032            <guibutton>Export</guibutton> button
1033          raises a file dialog to specify a path and file name, the export type          raises a file dialog to specify a path and file name, the export type
1034          is determined by the file extension (either .dbf or .csv).          is determined by the file extension (either .dbf or .csv).
1035    
1036          The 'Export Selection' button works similar but exports only the          The <guibutton>Export Selection</guibutton> button works similarly
1037          selected records.          but exports only the selected records.
1038    
1039          The 'Close' button closes the table view. In difference to the          The <guibutton>Close</guibutton> button closes the table view window.
1040          menu item 'Close' just the dialog is closed, the table is still loaded          This is different from the menu item
1041          in Thuban.          <menuchoice>
1042        </para>          <guimenu>Table</guimenu>
1043        <para>          <guimenuitem>Close</guimenuitem>
1044            </menuchoice> which unloads the table from Thuban.
1045            </para>
1046            <para>
1047          The status bar displays some statistics about the table and optional          The status bar displays some statistics about the table and optional
1048          selection results.          selection results.
1049        </para>          </para>
1050      </section>      </section>
1051    
1052      <section><title>General Functionality (Menu Table)</title>      <section><title>General Functionality (Menu Table)</title>
1053        <para>          <para>
1054          The general functions affect all tables open in Thuban. Attribute          The general functions affect all tables open in Thuban. Attribute
1055          tables are considered as here as usual data tables (with the exception          tables are considered here as normal data tables (with the exception
1056          that they cannot be closed).          that they cannot be closed).
       </para>  
       <section><title>Open</title>  
         <para>  
           The 'Open' item raises a file dialog to let you select a  
           dbase file from the file system to be loaded into Thuban read-only.  
           On OK the selected file is loaded and a table view is opened.  
         </para>  
       </section>  
   
       <section><title>Close</title>  
         <para>  
           The 'Close' item raises a dialog listing the currently open  
           data tables (loaded via the 'Open' functionality'). You can select  
           tables which are dereferenced on confirmation. Since tables are  
           opened read-only the contents of the tables are not affected.  
   
           A still open table view is closed as well.  
   
           Tables used in a join can not be closed.  
         </para>  
       </section>  
   
       <section><title>Rename</title>  
         <para>  
           Changes the table title.  
         </para>  
       </section>  
   
       <section><title>Show</title>  
         <para>  
           The 'Show' item raises a list of available tables (explicitly loaded,           attribute tables, results of a join). Selected tables are show in  
           tables views on 'OK'.            
         </para>  
       </section>  
   
       <section><title>Join</title>  
         <para>  
           The 'Join' item raises a dialog to specify the two tables to be  
           joined. The join results in a new table named 'Join of "left table"  
           and "right table"'.  
   
           The dialog let you select the two tables to be joined and the two  
           fields the join has to be performed on. By default the new  
           table contains only those records which are mathced by the join.  
   
           If you want to preserve the records of the left table you can perform  
           an outer join. The fields from the right table for records not  
           matched by the join are filled with <varname>None</varname> in this  
           case.  
1057          </para>          </para>
1058        </section>          <section><title>Open</title>
1059                <para>
1060                The
1061                <menuchoice>
1062                <guimenu>Table</guimenu>
1063                <guimenuitem>Open</guimenuitem>
1064                </menuchoice>
1065                item raises a file dialog to let you select a
1066                dBase file from the file system to be loaded into Thuban read-only.
1067                On <guibutton>OK</guibutton> the selected file is loaded and a
1068                table view is opened.
1069                </para>
1070            </section>
1071    
1072            <section><title>Close</title>
1073                <para>
1074                The
1075                <menuchoice>
1076                <guimenu>Table</guimenu>
1077                <guimenuitem>Close</guimenuitem>
1078                </menuchoice>
1079                item raises a dialog listing the currently open
1080                data tables
1081                (loaded via
1082                <menuchoice>
1083                <guimenu>Table</guimenu>
1084                <guimenuitem>Open</guimenuitem>
1085                </menuchoice>). Selected tables are dereferenced on confirmation.
1086                Since tables are opened read-only the contents of the tables are
1087                not affected.
1088    
1089                Any open views of the tables are closed as well.
1090    
1091                Tables used in a join cannot be closed.
1092                </para>
1093            </section>
1094    
1095            <section><title>Rename</title>
1096                <para>
1097                <menuchoice>
1098                <guimenu>Table</guimenu>
1099                <guimenuitem>Rename</guimenuitem>
1100                </menuchoice> changes the table title.
1101                </para>
1102            </section>
1103    
1104            <section><title>Show</title>
1105                <para>
1106                The
1107                <menuchoice>
1108                <guimenu>Table</guimenu>
1109                <guimenuitem>Show</guimenuitem>
1110                </menuchoice>
1111                item raises a list of available tables (explicitly
1112                loaded, attribute tables, results of a join). Selected tables are
1113                show in tables views on <guibutton>OK</guibutton>.
1114                </para>
1115            </section>
1116    
1117            <section><title>Join</title>
1118                <para>
1119                <figure>
1120                <title>Join Tables</title>
1121                <mediaobject>
1122                <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>
1124                </mediaobject>
1125                </figure>
1126                </para>
1127                <para>
1128                The
1129                <menuchoice>
1130                <guimenu>Table</guimenu>
1131                <guimenuitem>Join</guimenuitem>
1132                </menuchoice>
1133                item raises a dialog to specify the two tables to be
1134                joined. The join results in a new table named 'Join of "left table"
1135                and "right table"'.
1136    
1137                The dialog lets you select the two tables to be joined and the two
1138                fields the join has to be performed on. By default, the new
1139                table contains only those records which are matched by the join.
1140    
1141                If you want to preserve the records of the left table you can
1142                perform an outer join. The fields from the right table for records
1143                not matched by the join are filled with <varname>None</varname> in
1144                this case.
1145                </para>
1146            </section>
1147    
1148      </section>      </section>
1149      <section><title>Attribute Tables</title>      <section><title>Attribute Tables</title>
     <para>  
             To clearly separate between both types, Thuban provides functionality  
             regarding the attribute tables under the Layer menu.  
     </para>  
   
       <section><title>Show Table</title>  
         <para>  
           Opens the attribute table of the currently active layer in a table  
           view.  
   
           In addition to the functionality described above selections  
           affect also the map display: objects related to selected records  
           are highlighted.  
         </para>  
       </section>  
   
       <section><title>Join Table</title>  
1150          <para>          <para>
1151             In difference to the join described above the join results not in a              To clearly separate between both types of tables (data and
1152            attribute), Thuban provides functionality regarding the attribute
1153            tables under the <menuchoice><guimenu>Layer</guimenu></menuchoice> menu.
1154            </para>
1155    
1156            <section><title>Show Table</title>
1157                <para>
1158                <menuchoice>
1159                <guimenu>Layer</guimenu>
1160                <guimenuitem>Show Table</guimenuitem>
1161                </menuchoice>
1162                opens the attribute table of the currently active layer in a table
1163                view.
1164    
1165                In addition to the functionality described above selections
1166                affect also the map display: objects related to selected records
1167                are highlighted.
1168                </para>
1169            </section>
1170    
1171            <section><title>Join Table</title>
1172                <para>
1173                Unlike the join described above, the join does not result in a
1174              new table. The attribute table of the currently active layer is the              new table. The attribute table of the currently active layer is the
1175              left table and other tables are join to this table. Results of the              left table and other tables are joined to this table. The results of
1176              join in turn are available for classifications.              the join are available for classification.
1177    
1178              As a consequence of the above the join cannot result in less              As a consequence, the join cannot result in fewer
1179              records than the source attribute table. You are warned if the              records than the source attribute table. The user is warned if the
1180              right table does not fulfill this constraint. Use an outer join              right table does not fulfill this constraint. An outer join must be
1181              in such cases.              used in such cases.
1182          </para>              </para>
1183        </section>          </section>
1184    
1185        <section><title>Unjoin Table</title>          <section><title>Unjoin Table</title>
1186          <para>              <para>
1187              As said above, a usual table can not be closed while still used in              As said above, a normal table cannot be closed while it is still
1188              a join. While the join table resulting from a join of usual tables              used in a join. While the joined table resulting from a join of
1189              can be simply closed (and therewith dereferences the source tables)              normal tables can be simply closed (and thereby dereferencing
1190              this is not possible for attribute tables.              the source tables), this is not possible for attribute tables.
1191    
1192              Hence joins on attribute tables must be solved explicitely. This is              Hence joins on attribute tables must be solved explicitly. This is
1193              what the 'Unjoin' item is used for: The last join for the currently              what the
1194                <menuchoice>
1195                <guimenu>Layer</guimenu>
1196                <guimenuitem>Unjoin Table</guimenuitem>
1197                </menuchoice>
1198                item is used for: The last join for the currently
1199              active layer is solved.              active layer is solved.
1200          </para>              </para>
1201        </section>          </section>
   
1202      </section>      </section>
1203    </chapter>    </chapter>
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>
1209        <para>
1210    
1211        <itemizedlist>
1212        <listitem>
1213        <para>After adding two or more layers nothing is drawn in the map window.
1214        </para>
1215        <para>
1216        This is probably because the layers have different projections. Projections
1217        must be set on all layers and on the map itself if the layers' projections
1218        are different.
1219        </para>
1220        </listitem>
1221    
1222        <listitem>
1223        <para>Thuban crashes on startup with the error
1224            <literal>NameError: global name 'False' is not defined</literal>.
1225        </para>
1226        <para>
1227        <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.
1229        </para>
1230        </listitem>
1231    
1232        <listitem>
1233        <para>After compiling Thuban, Thuban crashes with an error similar to
1234            <literal>
1235            ImportError: /usr/local//lib/thuban/Thuban/../Lib/wxproj.so: undefined symbol: __gxx_personality_v0
1236            </literal>
1237        </para>
1238        <para>
1239        Thuban depends on the wxWindows library. If Thuban is compiled with an
1240        incompatible version of the compiler than wxWindows was compiled with
1241        this error may occur. Try compiling with a different version of the
1242        compiler.
1243        </para>
1244        </listitem>
1245        </itemizedlist>
1246        </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>      </para>
1264    
1265    </chapter>    </chapter>
1266    
1267    <appendix><title>Supported Data Sources</title>    <appendix><title>Supported Data Sources</title>
# Line 806  Line 1270 
1270      <variablelist>      <variablelist>
1271      <varlistentry>      <varlistentry>
1272      <term>Shapefile</term>      <term>Shapefile</term>
1273      <listitem><para></para></listitem>      <listitem>
1274            <para>
1275            The Shapefile format has become a standard format for saving
1276            geographic vector information. It supports polygons, lines, and
1277            points.
1278            
1279            <ulink url="http://www.esri.com/library/whitepapers/pdfs/shapefile.pdf">
1280            Technical Specification.
1281            </ulink>  
1282            </para>
1283        </listitem>
1284      </varlistentry>      </varlistentry>
1285    
1286      <varlistentry>      <varlistentry>
1287      <term>DB2 file</term>      <term>dBase file</term>
1288      <listitem><para></para></listitem>      <listitem>
1289            <para>
1290            dBase files are used to store the attributes for each layer. This
1291            is closely associated with the Shapefile format. For detailed
1292            specifications on the correct format of a dBase file used with
1293            Thuban please see the Technical Specification for the Shapefile
1294            format above.
1295            </para>
1296        </listitem>
1297        </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>      </varlistentry>
1314    
1315      </variablelist>      </variablelist>
# Line 819  Line 1317 
1317    
1318    <appendix><title>Supported Projections</title>    <appendix><title>Supported Projections</title>
1319      <para>      <para>
1320        The following types of projections are directly support by
1321        Thuban. The specific values for each are provided by the user
1322        to create custom projections. Thuban comes with predefined
1323        projections which are available through the Projections dialog.
1324        </para>
1325        <itemizedlist>
1326        <listitem>
1327            <para>Geographic</para>
1328            <itemizedlist>
1329            <listitem><para><literal>Ellipsoid</literal></para></listitem>
1330            <listitem><para>
1331                    <literal>Source Data</literal>: either Degrees or Radians
1332                    </para></listitem>
1333            </itemizedlist>
1334        </listitem>
1335        <listitem>
1336            <para>Lambert Conic Conformal</para>
1337        <itemizedlist>
1338            <listitem><para><literal>Ellipsoid</literal></para></listitem>
1339            <listitem><para><literal>Latitude of 1st standard parallel</literal></para></listitem>
1340            <listitem><para><literal>Latitude of 2nd standard parallel</literal></para></listitem>
1341            <listitem><para><literal>Central Meridian</literal></para></listitem>
1342            <listitem><para><literal>Latitude of Origin</literal></para></listitem>
1343            <listitem><para><literal>False Easting</literal> (meters)</para></listitem>
1344            <listitem><para><literal>False Northing</literal> (meters)</para></listitem>
1345        </itemizedlist>
1346        </listitem>
1347        <listitem>
1348            <para>Transverse Mercator</para>
1349        <itemizedlist>
1350            <listitem><para><literal>Ellipsoid</literal></para></listitem>
1351            <listitem><para><literal>Latitude</literal>of origin</para></listitem>
1352            <listitem><para><literal>Longitude</literal>at central meridian</para></listitem>
1353            <listitem><para><literal>Scale Factor</literal>at central meridian</para></listitem>
1354            <listitem><para><literal>False Easting</literal> (meters)</para></listitem>
1355            <listitem><para><literal>False Northing</literal> (meters)</para></listitem>
1356        </itemizedlist>
1357        </listitem>
1358        <listitem>
1359            <para>Universal Transverse Mercator</para>
1360        <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>
1370        Thuban comes with a sample set of map projections for various
1371        European countries. Apart from the basic projection they differ
1372        especially in their parameterization:
1373        </para>
1374        <itemizedlist>
1375        <listitem><para>Belgium Datum 1972 (Lambert Conic Conformal)</para>
1376        </listitem>
1377    
1378        <listitem><para>Gauss-Boaga Zone 1 (Italy, Transverse Mercartor)</para>
1379        </listitem>
1380    
1381        <listitem><para>Gauss-Krueger Zone 2 (Germany, Transverse Mercartor)
1382        </para>
1383        </listitem>
1384    
1385        <listitem><para>Reseau Geodesique Francaise
1386        (France, Lambert Conic Conformal)</para>
1387        </listitem>
1388    
1389        <listitem><para>UK National Grid (United Kingdom, Transverse Mercartor)
1390        </para>
1391        </listitem>
1392        </itemizedlist>
1393    
1394        <para>
1395        Thuban uses the comprehensive PROJ library for projections. PROJ provides
1396        more than the four commonly used projections described above. If needed
1397        Thuban can be easily extended to a new projection covered by PROJ.
1398      </para>      </para>
     <variablelist>  
     <varlistentry>  
     <term>Geographic</term>  
     <listitem><para>Geographic</para></listitem>  
     </varlistentry>  
     <varlistentry>  
     <term>Lambert Conic Conformal</term>  
     <listitem><para>Lambert Conic Conformal</para></listitem>  
     </varlistentry>  
     <varlistentry>  
     <term>Transverse Mercator</term>  
     <listitem><para>Transverse Mercator</para></listitem>  
     </varlistentry>  
     <varlistentry>  
     <term>Universal Transverse Mercator</term>  
     <listitem><para>Universal Transverse Mercator</para></listitem>  
     </varlistentry>  
     </variablelist>  
1399    </appendix>    </appendix>
1400    
1401  </book>  </book>
1402    
Legend:
Removed from v.1478  
changed lines
  Added in v.1544
[email protected]
 ViewVC Help
Powered by ViewVC 1.1.26