/[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 1475 by jonathan, Thu Jul 24 11:19:51 2003 UTC revision 1533 by jonathan, Thu Jul 31 12:43:27 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 12  Line 13 
13      <author>      <author>
14        <firstname>Jan-Oliver</firstname><surname>Wagner</surname>        <firstname>Jan-Oliver</firstname><surname>Wagner</surname>
15      </author>      </author>
16        <author>
17          <firstname>Frank</firstname><surname>Koormann</surname>
18        </author>
19      <copyright>      <copyright>
20        <year>2003</year>        <year>2003</year>
21        <holder>Intevation GmbH</holder>        <holder>Intevation GmbH</holder>
# Line 44  Line 48 
48          <section><title>Installation</title>          <section><title>Installation</title>
49          <para>          <para>
50          Thuban is actively supported under Debian Testing (sarge), RedHat 7.2,          Thuban is actively supported under Debian Testing (sarge), RedHat 7.2,
51          and Windows 2000. All the necessary files can be found on the          and Windows 2000. Thuban depends on the following packages. These
52            packages can also be found on the
53          <ulink url="http://thuban.intevation.org/download.html">          <ulink url="http://thuban.intevation.org/download.html">
54          Thuban Download site          Thuban Download site
55          </ulink>.          </ulink>.
56            <itemizedlist>
57                <listitem><para>Python 2.2.1 (<literal>http://www.python.org</literal>)</para></listitem>
58                <listitem><para>wxWindows 2.4 (<literal>http://www.wxwindows.org</literal>)</para></listitem>
59                <listitem><para>wxPython 2.4 (<literal>http://www.wxpython.org</literal>)</para></listitem>
60                <listitem><para>proj 4.4.5 Projection Library (<literal>http://www.remotesensing.org/proj/</literal>)</para></listitem>
61                <listitem><para>GDAL 1.1.8 (<literal>http://www.remotesensing.org/gdal/</literal>)</para></listitem>
62                <listitem><para>SQLite 2.8.3 (<literal>http://www.hwaci.com/sw/sqlite/</literal>)</para></listitem>
63                <listitem><para>PySQLite 0.4.3 (<literal>http://pysqlite.sourceforge.net</literal>)</para></listitem>
64                </itemizedlist>
65          </para>          </para>
66          </section>          </section>
67    
68          <section><title>The Main Window</title>          <section><title>The Main Window</title>
69          <para>          <para>
70          <screenshot>          <figure>
71          <screeninfo>The Main Window</screeninfo>          <title>The Main Window</title>
72          <mediaobject>          <mediaobject>
73          <imageobject> <imagedata fileref="../images/1_2_mainwindow.png" format="PNG"/> </imageobject>          <imageobject> <imagedata fileref="../images/1_2_mainwindow.png" format="PNG" scale="&imgscale;"/> </imageobject>
74          <imageobject> <imagedata fileref="./images/1_2_mainwindow.ps" format="EPS"/> </imageobject>          <imageobject> <imagedata fileref="./images/1_2_mainwindow.ps" format="EPS" scale="&imgscale;"/> </imageobject>
         <textobject><phrase>The Main Window</phrase></textobject>  
         <caption><para>The Main Window</para></caption>  
75          </mediaobject>          </mediaobject>
76          </screenshot>          </figure>
77          </para>          </para>
78    
79          <para>          <para>
# Line 97  Line 109 
109          The tool bar provides quick access to the commonly needed tools.          The tool bar provides quick access to the commonly needed tools.
110          By hovering over each button the user can see a short messages          By hovering over each button the user can see a short messages
111          describing what the tool does. The tools provided are Zoom In, Zoom          describing what the tool does. The tools provided are Zoom In, Zoom
112          Out, Pan, Full Extent, Full Layer Extent, Full Shape Extent, Indentify,          Out, Pan, Full Extent, Full Layer Extent, Full Shape Extent, Identify,
113          and Label. Each of the tools will be explained in further detail later          and Label. Each of the tools will be explained in further detail later
114          in the manual.          in the manual.
115          </para>          </para>
# Line 113  Line 125 
125          <menuchoice>          <menuchoice>
126          <guimenu>File</guimenu>          <guimenu>File</guimenu>
127          <guimenuitem>New Session</guimenuitem>          <guimenuitem>New Session</guimenuitem>
128          </menuchoice>.          </menuchoice>.
   
129          If a session is already loaded and has been modified without          If a session is already loaded and has been modified without
130          being saved a prompt will ask if the current session should          being saved a prompt will ask if the current session should
131          be saved.          be saved. A new session consists of an empty map with no
132            layers and no tables.
133          </para>          </para>
134          </section>          </section>
135    
# Line 128  Line 139 
139          <menuchoice>          <menuchoice>
140          <guimenu>File</guimenu>          <guimenu>File</guimenu>
141          <guimenuitem>Open Session</guimenuitem>          <guimenuitem>Open Session</guimenuitem>
142          </menuchoice>.          </menuchoice>. A dialog box will open allowing the user to browse
143            for a Thuban Session file. Thuban session files end with
144            <varname>.thuban</varname>. Selecting a file a clicking
145            <guibutton>OK</guibutton> will load the session into Thuban.
146    
147          If a session is already loaded and has been modified without          If a session is already loaded and has been modified without
148          being saved a prompt will ask if the current session should          being saved a prompt will ask if the current session should
# Line 142  Line 156 
156          <menuchoice>          <menuchoice>
157          <guimenu>File</guimenu>          <guimenu>File</guimenu>
158          <guimenuitem>Save Session</guimenuitem>          <guimenuitem>Save Session</guimenuitem>
159          </menuchoice>.          </menuchoice>. A dialog box will open allowing the user to browse
160            the file system and select a place to save the session. Thuban
161            sessions should be saved under a name ending in
162            <varname>.thuban</varname>. If the file already exists the user
163            will be prompted to save under a different name or overwrite the
164            existing file.
165          </para>          </para>
166          </section>          </section>
167    
168          <section><title>The Session Info-Tree</title>          <section><title>The Session Info-Tree</title>
169            <para>
170            <figure>
171            <title>Session Info Tree</title>
172            <mediaobject>
173            <imageobject><imagedata fileref="../images/2_4_session_tree.png" format="PNG" scale="&imgscale;"/></imageobject>
174            <imageobject><imagedata fileref="./images/2_4_session_tree.eps" format="EPS" scale="&imgscale;"/></imageobject>
175            </mediaobject>
176            </figure>
177            </para>
178          <para>          <para>
179                  (primarily for developers)          The session info-tree is primarily intended for developers working
180            with Thuban. It displays many of the internal values for the session,
181            map, and layers. It can be opened from
182            <menuchoice>
183            <guimenu>File</guimenu>
184            <guimenuitem>Session Tree</guimenuitem>
185            </menuchoice>.
186          </para>          </para>
187          </section>          </section>
188    </chapter>    </chapter>
# Line 160  Line 193 
193      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
194      visually explore the data.      visually explore the data.
195      </para>      </para>
196        <para>
197        The map can have a name that will appear in the Thuban title bar.
198        The map name can be changed using
199        <menuchoice>
200        <guimenu>Map</guimenu>
201        <guimenuitem>Rename</guimenuitem>
202        </menuchoice>.
203        </para>
204        <para>
205        <inlinemediaobject>
206        <imageobject>
207        <imagedata fileref="../images/3_rename_map.png" format="PNG" scale="&imgscale;"/>
208        </imageobject>
209        <imageobject>
210        <imagedata fileref="./images/3_rename_map.eps" format="EPS" scale="&imgscale;"/>
211        </imageobject>
212        <textobject> <phrase>Rename Map</phrase> </textobject>
213        </inlinemediaobject>
214        </para>
215    
216          <section><title>Adding and Removing Layers</title>          <section><title>Adding and Removing Layers</title>
217          <para>          <para>
218          There are two types of layers that can use added to a map: shape layers          There are two types of layers that can be added to a map: shape layers
219          and image layers. Shape layers are stored in Shapefile format, a          and image layers. Shape layers are stored in Shapefile format, a
220          standard file format for storing geographic objects. Normally, these          standard file format for storing geographic objects. These
221          files have the extension ``.shp''. Associated with          files have the extension ``.shp''. Associated with
222          the object information is a database file which stores attributes for          the shape file is a database file which stores attributes for
223          each shape in the Shapefile. This file, stored in DB2 format, usually          each shape in the shape file. This file, in dBase format,
224          has the extension ``.dbf''. Both files should have the same base name.          has the extension ``.dbf''. Both files must have the same base name.
225          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
226          also be a file roads.dbf.          also be a file roads.dbf.
227          </para>          </para>
228          <para>          <para>
# Line 180  Line 232 
232          <guimenuitem>Add Layer</guimenuitem>          <guimenuitem>Add Layer</guimenuitem>
233          </menuchoice>.          </menuchoice>.
234          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
235          matter if the Shapefile or database file is selected.          matter if the shape file or database file is selected.
236          </para>          </para>
237    
238          <para>          <para>
# Line 190  Line 242 
242          <guimenuitem>Add Image Layer</guimenuitem>          <guimenuitem>Add Image Layer</guimenuitem>
243          </menuchoice>.          </menuchoice>.
244          It is important to select a valid image file that has geographic          It is important to select a valid image file that has geographic
245          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,
246          or in another file. If geographic information cannot be found, Thuban          or in another file. If geographic information cannot be found, Thuban
247          will report an error.          will report an error.
248          </para>          </para>
# Line 199  Line 251 
251          <section><title>Navigation</title>          <section><title>Navigation</title>
252          <para>          <para>
253          The map can be explored by using the navigation tools available on          The map can be explored by using the navigation tools available on
254          the tool bar, or from the          the tool bar or from the
255          <menuchoice><guimenu>Map</guimenu></menuchoice> menu.          <menuchoice><guimenu>Map</guimenu></menuchoice> menu.
256          </para>          </para>
257            <itemizedlist>
258            <listitem>
259          <para>          <para>
260          The ZoomIn tool          The ZoomIn tool
261          <inlinemediaobject>          <inlinemediaobject>
262          <imageobject>          <imageobject>
263          <imagedata fileref="../images/3_2_zoomin.png" format="PNG"/>          <imagedata fileref="../images/3_2_zoomin.png" format="PNG" scale="&imgscale;"/>
264          </imageobject>          </imageobject>
265          <imageobject>          <imageobject>
266          <imagedata fileref="./images/3_2_zoomin.eps" format="EPS"/>          <imagedata fileref="./images/3_2_zoomin.eps" format="EPS" scale="&imgscale;"/>
267          </imageobject>          </imageobject>
268          <textobject> <phrase>ZoomIn Tool</phrase> </textobject>          <textobject> <phrase>ZoomIn Tool</phrase> </textobject>
269          </inlinemediaobject>          </inlinemediaobject>
270          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
271          will double the magnification and center the map on the point that          will double the magnification and center the map on the point that
272          was clicked. Clicking and dragging lets the user select a region          was clicked. Clicking and dragging selects a region that will be
273          to be enlarged to fit the window.          enlarged to fit the window.
274          </para>          </para>
275            </listitem>
276            <listitem>
277          <para>          <para>
278          The ZoomOut tool          The ZoomOut tool
279          <inlinemediaobject>          <inlinemediaobject>
280          <imageobject>          <imageobject>
281          <imagedata fileref="../images/3_2_zoomout.png" format="PNG"/>          <imagedata fileref="../images/3_2_zoomout.png" format="PNG" scale="&imgscale;"/>
282          </imageobject>          </imageobject>
283          <imageobject>          <imageobject>
284          <imagedata fileref="./images/3_2_zoomout.eps" format="EPS"/>          <imagedata fileref="./images/3_2_zoomout.eps" format="EPS" scale="&imgscale;"/>
285          </imageobject>          </imageobject>
286          <textobject> <phrase>ZoomOut Tool</phrase> </textobject>          <textobject> <phrase>ZoomOut Tool</phrase> </textobject>
287          </inlinemediaobject>          </inlinemediaobject>
# Line 234  Line 290 
290          selects a box such that the current contents of the window will be          selects a box such that the current contents of the window will be
291          scaled to fit into that box.          scaled to fit into that box.
292          </para>          </para>
293            </listitem>
294            <listitem>
295          <para>          <para>
296          The Pan tool          The Pan tool
297          <inlinemediaobject>          <inlinemediaobject>
298          <imageobject>          <imageobject>
299          <imagedata fileref="../images/3_2_pan.png" format="PNG"/>          <imagedata fileref="../images/3_2_pan.png" format="PNG" scale="&imgscale;"/>
300          </imageobject>          </imageobject>
301          <imageobject>          <imageobject>
302          <imagedata fileref="./images/3_2_pan.eps" format="EPS"/>          <imagedata fileref="./images/3_2_pan.eps" format="EPS" scale="&imgscale;"/>
303          </imageobject>          </imageobject>
304          <textobject> <phrase>Pan Tool</phrase> </textobject>          <textobject> <phrase>Pan Tool</phrase> </textobject>
305          </inlinemediaobject>          </inlinemediaobject>
306          allows the user to move the map around by clicking and dragging.          allows the user to move the map around by clicking and dragging.
307          </para>          </para>
308            </listitem>
309            <listitem>
310          <para>          <para>
311          The Full Extent tool          The Full Extent tool
312          <inlinemediaobject>          <inlinemediaobject>
313          <imageobject>          <imageobject>
314          <imagedata fileref="../images/3_2_fullextent.png" format="PNG"/>          <imagedata fileref="../images/3_2_fullextent.png" format="PNG" scale="&imgscale;"/>
315          </imageobject>          </imageobject>
316          <imageobject>          <imageobject>
317          <imagedata fileref="./images/3_2_fullextent.eps" format="EPS"/>          <imagedata fileref="./images/3_2_fullextent.eps" format="EPS" scale="&imgscale;"/>
318          </imageobject>          </imageobject>
319          <textobject> <phrase>Full Extent Tool</phrase> </textobject>          <textobject> <phrase>Full Extent Tool</phrase> </textobject>
320          </inlinemediaobject>          </inlinemediaobject>
321          rescales the viewable region so that the entire map is visible.          rescales the viewable region so that the entire map is visible.
322          </para>          </para>
323            </listitem>
324            <listitem>
325          <para>          <para>
326          The Full Layer Extent tool          The Full Layer Extent tool
327          <inlinemediaobject>          <inlinemediaobject>
328          <imageobject>          <imageobject>
329          <imagedata fileref="../images/3_2_fulllayerextent.png" format="PNG"/>          <imagedata fileref="../images/3_2_fulllayerextent.png" format="PNG" scale="&imgscale;"/>
330          </imageobject>          </imageobject>
331          <imageobject>          <imageobject>
332          <imagedata fileref="./images/3_2_fulllayerextent.eps" format="EPS"/>          <imagedata fileref="./images/3_2_fulllayerextent.eps" format="EPS" scale="&imgscale;"/>
333          </imageobject>          </imageobject>
334          <textobject> <phrase>Full Layer Extent Tool</phrase> </textobject>          <textobject> <phrase>Full Layer Extent Tool</phrase> </textobject>
335          </inlinemediaobject>          </inlinemediaobject>
# Line 275  Line 337 
337          layer fits within the window. If no layer is selected this button          layer fits within the window. If no layer is selected this button
338          will be disabled.          will be disabled.
339          </para>          </para>
340            </listitem>
341            <listitem>
342          <para>          <para>
343          The Full Shape Extent tool          The Full Shape Extent tool
344          <inlinemediaobject>          <inlinemediaobject>
345          <imageobject>          <imageobject>
346          <imagedata fileref="../images/3_2_fullshapeextent.png" format="PNG"/>          <imagedata fileref="../images/3_2_fullshapeextent.png" format="PNG" scale="&imgscale;"/>
347          </imageobject>          </imageobject>
348          <imageobject>          <imageobject>
349          <imagedata fileref="./images/3_2_fullshapeextent.eps" format="EPS"/>          <imagedata fileref="./images/3_2_fullshapeextent.eps" format="EPS" scale="&imgscale;"/>
350          </imageobject>          </imageobject>
351          <textobject> <phrase>Full Shape Extent Tool</phrase> </textobject>          <textobject> <phrase>Full Shape Extent Tool</phrase> </textobject>
352          </inlinemediaobject>          </inlinemediaobject>
353          rescales the viewable region so that the currently selected          rescales the viewable region so that the currently selected
354          shape fits within the window. If the shape is a point, it is          shape fits within the window. If the shape is a point, it is
355          centered and the map is zoomed all the way in. If no shape is          centered and the map is zoomed all the way in. If no shape is
356          selected this button will be disabled.          selected this button will be disabled. This feature is especially
357            helpful when identifying an object related to a selected record
358            in a tableview (see below).
359    
360          </para>          </para>
361            </listitem>
362            </itemizedlist>
363          </section>          </section>
364    
365          <section><title>Object Identification</title>          <section><title>Object Identification</title>
# Line 298  Line 367 
367          Objects on the map can be identified using the Identify tool          Objects on the map can be identified using the Identify tool
368          <inlinemediaobject>          <inlinemediaobject>
369          <imageobject>          <imageobject>
370          <imagedata fileref="../images/3_3_identify.png" format="PNG"/>          <imagedata fileref="../images/3_3_identify.png" format="PNG" scale="&imgscale;"/>
371          </imageobject>          </imageobject>
372          <imageobject>          <imageobject>
373          <imagedata fileref="./images/3_3_identify.eps" format="EPS"/>          <imagedata fileref="./images/3_3_identify.eps" format="EPS" scale="&imgscale;"/>
374          </imageobject>          </imageobject>
375          <textobject> <phrase>Identify Tool</phrase> </textobject>          <textobject> <phrase>Identify Tool</phrase> </textobject>
376          </inlinemediaobject>.          </inlinemediaobject>.
377          Clicking on an object selects that object and opens a dialog which          Clicking on an object selects that object and opens a dialog which
378          shows all the table attributes for that object. Any current selection          shows all the table attributes for that object. Any current selection
379          is lost.          is lost. Objects on the map are typically shapes and this document
380            will often refer to objects as shapes.
381          </para>          </para>
382          </section>          </section>
383    
384          <section><title>Object Labelling</title>          <section><title>Object Labeling</title>
385          <para>          <para>
386          Objects can be labelled using the Label tool          Objects can be labeled using the Label tool
387          <inlinemediaobject>          <inlinemediaobject>
388          <imageobject>          <imageobject>
389          <imagedata fileref="../images/3_3_label.png" format="PNG"/>          <imagedata fileref="../images/3_3_label.png" format="PNG" scale="&imgscale;"/>
390          </imageobject>          </imageobject>
391          <imageobject>          <imageobject>
392          <imagedata fileref="./images/3_3_label.eps" format="EPS"/>          <imagedata fileref="./images/3_3_label.eps" format="EPS" scale="&imgscale;"/>
393          </imageobject>          </imageobject>
394          <textobject> <phrase>Label Tool</phrase> </textobject>          <textobject> <phrase>Label Tool</phrase> </textobject>
395          </inlinemediaobject>.          </inlinemediaobject>.
396          Clicking on an object selects that object and opens a dialog which          Clicking on an object selects that object and opens a dialog which
397          displays the table attributes for that object. An attribute can          displays the table attributes for that object. An attribute can
398          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
399          object that already has a label will remove the label.          at the center of the shape. Clicking on an object that already has
400            a label will remove the label.
401          </para>          </para>
402          </section>          </section>
403    
404          <section><title>The Legend</title>          <section><title>The Legend</title>
405            <para>
406            <inlinemediaobject>
407            <imageobject>
408            <imagedata fileref="../images/3_5_legend.png" format="PNG" scale="&imgscale;"/>
409            </imageobject>
410            <imageobject>
411            <imagedata fileref="./images/3_5_legend.eps" format="EPS" scale="&imgscale;"/>
412            </imageobject>
413            <textobject> <phrase>Legend</phrase> </textobject>
414            </inlinemediaobject>
415            </para>
416          <para>          <para>
417          The Legend provides an overview of the layers in the map. Layers          The Legend provides an overview of the layers in the map. Layers
418          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 343  Line 425 
425          <para>          <para>
426          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
427          to some of the layer manipulation options under          to some of the layer manipulation options under
428          <menuchoice> <guimenu>Map</guimenu> </menuchoice>.          <menuchoice><guimenu>Map</guimenu></menuchoice>.
429            </para>
430    
431            <itemizedlist>
432            <listitem>
433            <para>
434            The Move Layer to Top tool
435            <inlinemediaobject>
436            <imageobject>
437            <imagedata fileref="../images/3_5_totop.png" format="PNG" scale="&imgscale;"/>
438            </imageobject>
439            <imageobject>
440            <imagedata fileref="./images/3_5_totop.eps" format="EPS" scale="&imgscale;"/>
441            </imageobject>
442            <textobject> <phrase>Move Layer to Top</phrase> </textobject>
443            </inlinemediaobject> raises the selected layer to the top of the map.
444            </para>
445            </listitem>
446            <listitem>
447    
448            <para>
449            The Move Layer Up tool
450            <inlinemediaobject>
451            <imageobject>
452            <imagedata fileref="../images/3_5_moveup.png" format="PNG" scale="&imgscale;"/>
453            </imageobject>
454            <imageobject>
455            <imagedata fileref="./images/3_5_moveup.eps" format="EPS" scale="&imgscale;"/>
456            </imageobject>
457            <textobject> <phrase>Move Layer Up</phrase> </textobject>
458            </inlinemediaobject> raises the selected layer one level.
459            </para>
460            </listitem>
461            <listitem>
462    
463            <para>
464            The Move Layer Down tool
465            <inlinemediaobject>
466            <imageobject>
467            <imagedata fileref="../images/3_5_movedown.png" format="PNG" scale="&imgscale;"/>
468            </imageobject>
469            <imageobject>
470            <imagedata fileref="./images/3_5_movedown.eps" format="EPS" scale="&imgscale;"/>
471            </imageobject>
472            <textobject> <phrase>Move Layer Down</phrase> </textobject>
473            </inlinemediaobject> lowers the selected layer one level.
474            </para>
475    
476            </listitem>
477            <listitem>
478            <para>
479            The Move Layer to Bottom tool
480            <inlinemediaobject>
481            <imageobject>
482            <imagedata fileref="../images/3_5_tobottom.png" format="PNG" scale="&imgscale;"/>
483            </imageobject>
484            <imageobject>
485            <imagedata fileref="./images/3_5_tobottom.eps" format="EPS" scale="&imgscale;"/>
486            </imageobject>
487            <textobject> <phrase>Move Layer to Bottom</phrase> </textobject>
488            </inlinemediaobject> lowers the selected layer to the bottom of the map.
489            </para>
490    
491            </listitem>
492            <listitem>
493            <para>
494            The Visible tool
495            <inlinemediaobject>
496            <imageobject>
497            <imagedata fileref="../images/3_5_visible.png" format="PNG" scale="&imgscale;"/>
498            </imageobject>
499            <imageobject>
500            <imagedata fileref="./images/3_5_visible.eps" format="EPS" scale="&imgscale;"/>
501            </imageobject>
502            <textobject> <phrase>Visible</phrase> </textobject>
503            </inlinemediaobject> shows the selected layer in the map if it was
504            hidden.
505            </para>
506    
507            </listitem>
508            <listitem>
509            <para>
510            The Invisible tool
511            <inlinemediaobject>
512            <imageobject>
513            <imagedata fileref="../images/3_5_invisible.png" format="PNG" scale="&imgscale;"/>
514            </imageobject>
515            <imageobject>
516            <imagedata fileref="./images/3_5_invisible.eps" format="EPS" scale="&imgscale;"/>
517            </imageobject>
518            <textobject> <phrase>Invisible</phrase> </textobject>
519            </inlinemediaobject> hides the selected layer in the map.
520            </para>
521    
522            </listitem>
523            <listitem>
524            <para>
525            The Properties tool
526            <inlinemediaobject>
527            <imageobject>
528            <imagedata fileref="../images/3_5_props.png" format="PNG" scale="&imgscale;"/>
529            </imageobject>
530            <imageobject>
531            <imagedata fileref="./images/3_5_props.eps" format="EPS" scale="&imgscale;"/>
532            </imageobject>
533            <textobject> <phrase>Properties</phrase> </textobject>
534            </inlinemediaobject> opens the layer's properties dialog box.
535          Double-clicking on a layer or a group of a layer will open the          Double-clicking on a layer or a group of a layer will open the
536          properties dialog for that layer.          properties dialog for that layer.
537          </para>          </para>
538            </listitem>
539            </itemizedlist>
540            <para>
541            Along the bottom of the legend is the scalebar. The scalebar
542            will be available if there are any layers and the  map has a
543            projection set.
544            </para>
545            </section>
546    
547            <section><title>Exporting</title>
548            <para>
549            Under Windows, maps can be exported in Enhanced Metafile format
550            (<varname>.wmf</varname>)
551            from
552            <menuchoice>
553            <guimenu>Map</guimenu>
554            <guimenuitem>Export</guimenuitem>
555            </menuchoice> for use in reports, presentations, or further
556            modification. The current map view, legend, and, if available,
557            scalebar are exported. Under other platforms this option is not
558            available. Clicking this menu item open a file selection dialog
559            that lets the user select a location to export the map.
560            </para>
561          </section>          </section>
562    
563          <section><title>Printing</title>          <section><title>Printing</title>
# Line 356  Line 566 
566          <menuchoice>          <menuchoice>
567          <guimenu>Map</guimenu>          <guimenu>Map</guimenu>
568          <guimenuitem>Print</guimenuitem>          <guimenuitem>Print</guimenuitem>
569          </menuchoice>. A standard printing dialog will open allowing the          </menuchoice>. The current map view, legend, and, if available,
570          user to configure the printer.          scalebar are printed. A standard printing dialog will open allowing
571            the user to configure the printer. This dialog will differ depending
572            on which platform Thuban is running.
573          </para>          </para>
574          </section>          </section>
575    
576    </chapter>    </chapter>
577    
578    <chapter><title>Layer Management</title>    <chapter><title>Layer Management</title>
# Line 371  Line 584 
584          There are two types of layers supported by Thuban: shape layers and          There are two types of layers supported by Thuban: shape layers and
585          image layers. Shape layers consist of vector based shapes with          image layers. Shape layers consist of vector based shapes with
586          geo-referenced coordinates. There are three types of supported          geo-referenced coordinates. There are three types of supported
587          shapes: polygons, lines, and points. Image layers can be any image          shapes: polygons, lines (arc), and points. Image layers can be any image
588          file format supported by GDAL. The images must have geographic          file format supported by the Geo-spatial Data Abstraction Library
589          coordinate data either embedded within the file, or in a seperate          (GDAL). The images must have geographic
590            coordinate data either embedded within the file or in a separate
591          file that is in the same directory as the image file. GeoTIFF files          file that is in the same directory as the image file. GeoTIFF files
592          work very well with Thuban and were designed specifically to be image          work very well with Thuban and were designed specifically to be image
593          layers in GIS programs.          layers in GIS programs.
594          </para>          </para>
595            <para>
596            All actions in the
597            <menuchoice>
598            <guimenu>Layer</guimenu>
599            </menuchoice> menu act on the currently selected layer in the legend.
600            </para>
601          </section>          </section>
602    
603          <section><title>Properties</title>          <section><title>Properties</title>
604          <para>          <para>
605          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
606          how it is drawn on the map. Polygons and points can be drawn with an          legend. The menu option
607          outline color and a fill color, while lines have only a line color.          <menuchoice>
608            <guimenu>Layer</guimenu>
609            <guimenuitem>Properties</guimenuitem>
610            </menuchoice> opens a dialog that displays a layer's properties.
611            All layers have a title which can be modified in the text field
612            provided. The type of layer is also shows. If the type is a type
613            of shape (polygon, arc, point) the classification table will be
614            shown. Image layers have no other properties other than title
615            and type.
616            </para>
617            <para>
618            <figure>
619            <title>Properties Window</title>
620            <mediaobject>
621            <imageobject><imagedata fileref="../images/4_2_layer_properties.png" format="PNG" scale="&imgscale;"/></imageobject>
622            <imageobject><imagedata fileref="./images/4_2_layer_properties.eps" format="EPS" scale="&imgscale;"/></imageobject>
623            </mediaobject>
624            </figure>
625            </para>
626            <para>
627            <figure>
628            <title>Properties Window</title>
629            <mediaobject>
630            <imageobject><imagedata fileref="../images/4_2_raster_layer_properties.png" format="PNG" scale="&imgscale;"/></imageobject>
631            <imageobject><imagedata fileref="./images/4_2_raster_layer_properties.eps" format="EPS" scale="&imgscale;"/></imageobject>
632            </mediaobject>
633            </figure>
634          </para>          </para>
635          </section>          </section>
636    
# Line 393  Line 639 
639          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.
640          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
641          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
642          each time the map is changed. Each layer can be independently          all the layers each time the map is changed. Each layer can be
643          turned on or off using the          independently turned on or off using the
644          <menuchoice>          <menuchoice>
645          <guimenu>Layer</guimenu>          <guimenu>Layer</guimenu>
646          <guimenuitem>Show</guimenuitem>          <guimenuitem>Show</guimenuitem>
# Line 407  Line 653 
653          </para>          </para>
654          </section>          </section>
655    
         <section><title>Sequence</title>  
         <para>  
         </para>  
         </section>  
   
656          <section><title>Duplication</title>          <section><title>Duplication</title>
657          <para>          <para>
658          Layers and all their properties, including classifications, can          Layers and all their properties, including classifications, can
# Line 421  Line 662 
662          <guimenuitem>Duplicate</guimenuitem>          <guimenuitem>Duplicate</guimenuitem>
663          </menuchoice>. Duplicating a layer is useful if the user wishes          </menuchoice>. Duplicating a layer is useful if the user wishes
664          to model a layer in several different ways. Even though the layers          to model a layer in several different ways. Even though the layers
665          overlap by carefully selecting the shape properties it is possible          overlap, by carefully selecting the shape properties it is possible
666          to display several pieces of information at once. For example, one          to display several pieces of information at once. For example, one
667          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
668          another copy may be classified on a type property. if the length          another copy may be classified on a type property. If the length
669          property was expressed with color and the type property expressed          property was expressed with color and the type property expressed
670          with line thickness then it would be possible to view both          with line thickness then it would be possible to view both
671          classifications by placing the type property copy over the          classifications by placing the type property copy over the
# Line 442  Line 683 
683      cannot be classified.      cannot be classified.
684      </para>      </para>
685      <para>      <para>
686      A classification consists of a number of groups, with each group      A classification consists of a number of groups, each group
687      having a value or range of values to match against, and symbol      having a value or range of values to match against, and symbol
688      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
689      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 455  Line 696 
696      <para>      <para>
697      A layer always has a classification. When a new layer is added to the      A layer always has a classification. When a new layer is added to the
698      map, a default classification is created with the DEFAULT group. This      map, a default classification is created with the DEFAULT group. This
699      group cannot be removed. Every shape in the layer, regardless of its      group cannot be removed but can be hidden (see below). Every shape in the
700      attributes, will match this group.      layer, regardless of its attributes, will match this group if no other
701        group matches.
702      </para>      </para>
703    
704          <section><title>Editing Classifications</title>          <section><title>Editing Classifications</title>
# Line 473  Line 715 
715          button.          button.
716          </para>          </para>
717          <para>          <para>
718            To apply the changes to the map the user can click
719            either <guibutton>Try</guibutton> or <guibutton>OK</guibutton>.
720            <guibutton>Try</guibutton> will not close the dialog box, allowing
721            the user to see how the classification changes the map.
722            <guibutton>Revert</guibutton> will undo the last classification applied
723            to the map. <guibutton>OK</guibutton> will commit the changes and
724            close the dialog. The user will be unable to undo the changes.
725            <guibutton>Close</guibutton> simply closes the dialog box. If any
726            changes have not been applied with <guibutton>Try</guibutton> the
727            changes will not be applied to the map.
728            </para>
729            <para>
730            <figure>
731            <title>Properties Window</title>
732            <mediaobject>
733            <imageobject><imagedata fileref="../images/5_classification.png" format="PNG" scale="&imgscale;"/></imageobject>
734            <imageobject><imagedata fileref="./images/5_classification.eps" format="EPS" scale="&imgscale;"/></imageobject>
735            </mediaobject>
736            </figure>
737            </para>
738            <para>
739          The order of the groups in the classification is significant          The order of the groups in the classification is significant
740          except for the DEFAULT group, which remains at the top. When shapes          except for the DEFAULT group, which remains at the top. When shapes
741          are matched against groups the matching begins at the first group          are matched against groups the matching begins at the first group
742          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
743          be checked first. Matching for a          be checked first. Matching for a
744          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
745          use <guibutton>Move Up</guibutton> and <guibutton>Move Down</guibutton>          use <guibutton>Move Up</guibutton> and <guibutton>Move Down</guibutton>
746          to change the order of the groups. The DEFAULT group will always          to change the order of the groups. The DEFAULT group will always
747          match a shape that hasn't matched another group.          match a shape that hasn't matched another group.
748          </para>          </para>
749          <para>              <section><title>Visible</title>
750          The Value column of the classification table is the value that will              <para>
751          be matched when the map is being drawn. The type of data that can              The Visible column has check-boxes that determine whether a
752          entered into this field depends on the type of data of the              classification group will be displayed in the legend. This is
753          classification field.              useful if the user knows that the groups completely cover
754          </para>              the data set and don't want the DEFAULT group to be displayed
755          <para>              in the legend and on a printout.
756          If the field is of type Text, anything entered              </para>
757          into the field is valid. The text will be compared literally to the          </section>
758          value of the shape attribute, including case sensitivity.              <section><title>Symbols</title>
759          If the type is Integer, then any valid integer may be entered. In              <para>
760          addition, with special syntax, a range of values can be entered.              Each type of shape has its own type of symbol. Thuban supports three
761          A range from <varname>start</varname> to <varname>end</varname>              types of shapes: polygons, lines, and points. Polygons and points
762          inclusive is specifed like this: <literal>[start;end]</literal>.              have outline and fill color, while lines have only line color. Each
763          The exclusive range is specified like this:              group has associated symbol properties. To edit the symbol
764          <literal>]start;end[</literal>. Ranges can include infinity like              properties for a group the user can double click on the Symbol
765          this: <literal>[-oo;oo]</literal>. Field types can also be of type              column or select a group and click the
766          Decimal. They represent any rational number and can be used in ranges              <guibutton>Edit Symbol</guibutton> button.
767          as well.              </para>
768          </para>              </section>
769          </section>          <section><title>Value</title>
770                <para>
771          <section><title>Symbols</title>              The Value column of the classification table is the value that will
772          <para>              be matched when the map is being drawn. The type of data that can
773          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
774          types of shapes: polygons, lines, and points. Polygons and points have              classification field.
775          outline and fill color, while lines have only line color. Each group              </para>
776          has associated symbol properties. To edit the symbol properties for a              <para>
777          group the user can double click on the Symbol column or select a              If the field is of type Text, anything entered
778          group and click the <guibutton>Edit Symbol</guibutton> button.              into the field is valid. The text will be compared literally to the
779          </para>              value of the shape attribute, including case sensitivity.
780                If the type is Integer, then any valid integer may be entered. In
781                addition, with special syntax, a range of values can be entered.
782                A range from <varname>start</varname> to <varname>end</varname>
783                inclusive is specified like this: <literal>[start;end]</literal>.
784                The exclusive range is specified like this:
785                <literal>]start;end[</literal>. Ranges can include infinity like
786                this: <literal>[-oo;oo]</literal>. Field types can also be of type
787                Decimal. They represent any rational number and can be used in
788                ranges as well.
789                </para>
790                </section>
791                <section><title>Label</title>
792                <para>
793                By default, the text that is displayed for a group in the legend
794                is the value for that group. The label can substitute a more
795                descriptive term in the legend.
796                </para>
797            </section>
798          </section>          </section>
799    
800          <section><title>Generating Classes</title>          <section><title>Generating Classes</title>
801          <para>          <para>
802            <figure>
803            <title>Generate Class</title>
804            <mediaobject>
805            <imageobject><imagedata fileref="../images/5_3_genclass.png" format="PNG" scale="&imgscale;"/></imageobject>
806            <imageobject><imagedata fileref="./images/5_3_genclass.eps" format="EPS" scale="&imgscale;"/></imageobject>
807            </mediaobject>
808            </figure>
809            </para>
810            <para>
811          Creating a classification by hand can be tedious.          Creating a classification by hand can be tedious.
812          Thuban, therefore, provides a means of generating an entire          Thuban, therefore, provides a means of generating an entire
813          classification at once while still giving the user control over          classification at once while still giving the user control over
814          how it appears. Clicking <guibutton>Generate Class</guibutton>          how it appears. Clicking <guibutton>Generate Class</guibutton>
815          opens the <varname>Generate Classification</varname> dialog.          opens the <varname>Generate Classification</varname> dialog.
816          Under the <varname>Generate</varname> pulldown there are at most          Under the <varname>Generate</varname> pull down there are at most
817          three different ways to generate classifications:          three different ways to generate classifications:
818          Unique Values, Unique Distribution, and Quantiles. Some options          Unique Values, Uniform Distribution, and Quantiles. Some options
819          may not be available if they data type for the field does not          may not be available if the data type for the field does not
820          support them. For instance, <varname>Unique Distribution</varname>          support them. For instance, <varname>Uniform Distribution</varname>
821          doesn't make sense for a Text field.          doesn't make sense for a Text field.
822          </para>          </para>
823          <para>          <para>
824          For every way of generating a classification, a color scheme must          For every way of generating a classification, a color scheme must
825          be selected. Thuban provides several different color schemes that          be selected. Thuban provides several different color schemes that
826          affect how the group properties change over the classification.          affect how the group properties change over the classification.
827            It may be desirable that only certain properties change over the
828            classification. If the shape type is a polygon or a point then
829            the <guibutton>Fix Border Color</guibutton> option will be available.
830            This allows the user to select a border color for all classification
831            groups.
832          It is also possible to create a custom color scheme. Selecting          It is also possible to create a custom color scheme. Selecting
833          this option will display two symbols: the one of the left has the          this option will display two symbols: the one of the left has the
834          properties of the first group and the one on the right has the          properties of the first group and the one on the right has the
835          properties of the last group. Thuban will interpolate between these          properties of the last group. Thuban will interpolate between these
836          two properties to generate the other groups.          two properties to generate the other groups.
837            <figure>
838            <title>Custom Color Scheme</title>
839            <mediaobject>
840            <imageobject><imagedata fileref="../images/5_2_custom_ramp.png" format="PNG" scale="&imgscale;"/></imageobject>
841            <imageobject><imagedata fileref="./images/5_2_custom_ramp.eps" format="EPS" scale="&imgscale;"/></imageobject>
842            </mediaobject>
843            </figure>
844          </para>          </para>
845          <para>          <para>
846          The Unique Values option lets the user select specific values that          The Unique Values option lets the user select specific values that
# Line 548  Line 850 
850          right. Each list can be sorted or reversed for easier searching.          right. Each list can be sorted or reversed for easier searching.
851          The classification that is generated will be in the same order as          The classification that is generated will be in the same order as
852          the list on the right.          the list on the right.
853            <figure>
854            <title>Unique Values</title>
855            <mediaobject>
856            <imageobject><imagedata fileref="../images/5_2_unique_values.png" format="PNG" scale="&imgscale;"/></imageobject>
857            <imageobject><imagedata fileref="./images/5_2_unique_values.eps" format="EPS" scale="&imgscale;"/></imageobject>
858            </mediaobject>
859            </figure>
860          </para>          </para>
861          <para>          <para>
862          The Unique Distribution option creates a user specified number of          The Uniform Distribution option creates a user specified number of
863          groups of ranges such that each range covers equal intervals. The          groups of ranges such that each range covers equal intervals. The
864          minimum and maximum values can automatically be retrieved from the          minimum and maximum values can automatically be retrieved from the
865          table by clicking <guibutton>Retrieve From Table</guibutton>. The          table by clicking <guibutton>Retrieve From Table</guibutton>. The
866          stepping is how large each interval is. Adjusting this value will          stepping is how large each interval is. Adjusting this value will
867          automatically recalculate how many groups is appropriate.          automatically recalculate how many groups is appropriate.
868            <figure>
869            <title>Uniform Distribution</title>
870            <mediaobject>
871            <imageobject><imagedata fileref="../images/5_2_uniform_dist.png" format="PNG" scale="&imgscale;"/></imageobject>
872            <imageobject><imagedata fileref="./images/5_2_uniform_dist.eps" format="EPS" scale="&imgscale;"/></imageobject>
873            </mediaobject>
874            </figure>
875          </para>          </para>
876          <para>          <para>
877          The Quantiles option generates ranges based on the number items          The Quantiles option generates ranges based on the number of items
878          in the input set. For example, by specifying 5 groups Thuban will          in the table. For example, by specifying five groups Thuban will
879          generate groups with appropriate ranges such that 20% of the table          generate five groups with appropriate ranges such that 20% of the table
880          data is in each group. If it is impossible to generate exact          data is in each group. If it is impossible to generate exact
881          grouping, Thuban will issue a warning but allow the user to continue.          groupings, Thuban will issue a warning but allow the user to continue.
882            <figure>
883            <title>Quantiles</title>
884            <mediaobject>
885            <imageobject><imagedata fileref="../images/5_2_quantiles.png" format="PNG" scale="&imgscale;"/></imageobject>
886            <imageobject><imagedata fileref="./images/5_2_quantiles.eps" format="EPS" scale="&imgscale;"/></imageobject>
887            </mediaobject>
888            </figure>
889          </para>          </para>
890          </section>          </section>
891    </chapter>    </chapter>
# Line 571  Line 894 
894      <para>      <para>
895      Projections control how the geographic data is displayed on the screen.      Projections control how the geographic data is displayed on the screen.
896      If multiple layers are loaded into Thuban where the geographic data      If multiple layers are loaded into Thuban where the geographic data
897      is in a different projection system, then the user must tell Thuban      is in a different projection system, then the user must specify a
898      which projection each layer has. The user must also tell Thuban which      projection for each layer. The user must also tell Thuban which
899      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
900      projection in which case the layers are reprojected into that space.      projection in which case the layers are reprojected into that space.
901      The map projection can be set using      The map projection can be set using
# Line 584  Line 907 
907      <guimenu>Layer</guimenu>      <guimenu>Layer</guimenu>
908      <guimenuitem>Projection</guimenuitem>      <guimenuitem>Projection</guimenuitem>
909      </menuchoice>.      </menuchoice>.
910        <figure>
911        <title>Projection Window</title>
912        <mediaobject>
913        <imageobject><imagedata fileref="../images/6_projection.png" format="PNG" scale="&imgscale;"/></imageobject>
914        <imageobject><imagedata fileref="./images/6_projection.eps" format="EPS" scale="&imgscale;"/></imageobject>
915        </mediaobject>
916        </figure>
917      </para>      </para>
918      <para>      <para>
919      Thuban is distributed with a sample collection of projections. The      Thuban is distributed with a sample collection of projections. The
920      user can create new projections and make them available to all      user can create new projections and make them available to all
921      future Thuban sessions. They may also be exported and imported so      future Thuban sessions. They may also be exported and imported so
922      that custom projections can be distributed to others.      that custom projections can be distributed.
923      </para>      </para>
924          <section><title>Selecting a Projection</title>          <section><title>Selecting a Projection</title>
925          <para>          <para>
926          The available projections are listed on the left. If the layer          The available projections are listed on the left. If the layer
927          or map already has a projection it will be initially highlighted          or map already has a projection it will initially be highlighted
928          and will end with <varname>(current)</varname>. Selecting          and will end with <varname>(current)</varname>. Selecting
929          <varname>None</varname>will cause Thuban to use the data as          <varname>&lt;None&gt;</varname> will cause Thuban to use the data as
930          it appears in the source file and will not use a projection.          it appears in the source file and will not use a projection.
931          </para>          </para>
932      </section>      </section>
# Line 605  Line 935 
935          Whenever a projection is selected from the list its properties          Whenever a projection is selected from the list its properties
936          are displayed on the right. These properties can be changed          are displayed on the right. These properties can be changed
937          and the changes saved to the selected projection using          and the changes saved to the selected projection using
938          the <guibutton>Update</guibutton>. Only a projection that comes          <guibutton>Update</guibutton>. Only a projection that comes
939          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
940          is selectd, <guibutton>Update</guibutton> will be disabled.          is selected, <guibutton>Update</guibutton> will be disabled.
941          The <guibutton>Add to List</guibutton> adds the projection to the          <guibutton>Add to List</guibutton> adds the projection to the
942          list of available projections as a new entry, and thus make it          list of available projections as a new entry, and thus makes it
943          available to future Thuban sessions. Clicking <guibutton>New</guibutton>          available to future Thuban sessions. Clicking <guibutton>New</guibutton>
944          will create an entirely new, empty projection. The          will create an entirely new, empty projection. The
945          <guibutton>Remove</guibutton> button will permanantly remove a          <guibutton>Remove</guibutton> button will permanently remove a
946          projection from the list of available projections.          projection from the list of available projections.
947          </para>          </para>
948            <para>
949            To apply the selected projection to the map the user can click
950            either <guibutton>Try</guibutton> or <guibutton>OK</guibutton>.
951            <guibutton>Try</guibutton> will not close the dialog box, allowing
952            the user to see how the projeciton changes the map.
953            <guibutton>Revert</guibutton> will undo the last projection applied
954            to the map. <guibutton>OK</guibutton> will commit the changes and
955            close the dialog. The user will be unable to undo the changes.
956            <guibutton>Close</guibutton> simply closes the dialog box. If no
957            selection has been applied with <guibutton>Try</guibutton> the
958            selection will not be applied to the map.
959            </para>
960      </section>      </section>
961          <section><title>Importing/Exporting Projections</title>          <section><title>Importing/Exporting Projections</title>
962          <para>          <para>
963          The projections that appear in the list of available projections          The projections that appear in the list of available projections
964          can be exported to another file that the user chooses. By selecting          can be exported to another file that the user chooses. By selecting
965          one or more projections and clicking <guibutton>Export</guibutton>          one or more projections and clicking <guibutton>Export</guibutton>
966          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
967            projections.
968          The file can then be distributed to other Thuban users. To import          The file can then be distributed to other Thuban users. To import
969          a projection file the user can click <guibutton>Import</guibutton>.          a projection file the user can click <guibutton>Import</guibutton>.
970          The imported projections are added to the list and are then available          The imported projections are added to the list and are then available
971          to the current session and any future Thuban session.          to the current session and any future Thuban sessions.
972          </para>          </para>
973      </section>      </section>
974    </chapter>    </chapter>
975    
976    <chapter><title>Table Management</title>    <chapter><title>Table Management</title>
977      <para>      <para>
978        Thuban distinguishes two different types of tables: Attribute tables
979        (which belong to a layer) and normal data tables. Both provide
980            the same general functionality with the difference that actions on an
981        attribute table might also effect the map display.
982      </para>      </para>
983    
984        <section><title>Table View</title>
985            <para>
986            <figure>
987            <title>Table View</title>
988            <mediaobject>
989            <imageobject><imagedata fileref="../images/7_1_table_view.png" format="PNG" scale="&imgscale;"/></imageobject>
990            <imageobject><imagedata fileref="./images/7_1_table_view.eps" format="EPS" scale="&imgscale;"/></imageobject>
991            </mediaobject>
992            </figure>
993            </para>
994            <para>
995            Thuban provides a standard dialog to display table contents, the
996            Table View. The view has five sections: The title, selections,
997            the table grid, export functions, and the status bar.
998            </para>
999            <para>
1000            The title bar identifies the table with its name.
1001            </para>
1002            <para>
1003            The selections box let the user perform simple analysis on the data
1004            based on comparisons: The first choice must be a field identifier of
1005            the table, the second choice determines the type of comparison. The
1006            third choice can be either a specific value (interpreted as numerical
1007            or string depending on the type of the first field) or a second field
1008            identifier. Thus you can perform analysis like selecting all
1009            records where <literal>population > 10000</literal> or
1010            <literal>cars_per_inhabitant < bikes_per_inhabitant</literal>
1011            (note that the field names are only explanatory, the dBase files
1012            allow only 11 character field names).
1013          
1014            Selections can be combined either by applying a selection only on
1015            a previously selected set of records or by adding the results of a
1016            selection to a previous set. The default is that a selection replaces
1017            earlier results.
1018            </para>
1019            <para>
1020            The table grid shows the contents of the table (one record per row),
1021            with highlighted selection results. Columns and rows can be resized.
1022            </para>
1023            <para>
1024            The contents of a table can be exported into a file, either dBase
1025            format (DBF) or comma separated values (CSV). The
1026            <guibutton>Export</guibutton> button
1027            raises a file dialog to specify a path and file name, the export type
1028            is determined by the file extension (either .dbf or .csv).
1029    
1030            The <guibutton>Export Selection</guibutton> button works similarly
1031            but exports only the selected records.
1032    
1033            The <guibutton>Close</guibutton> button closes the table view window.
1034            This is different from the menu item
1035            <menuchoice>
1036            <guimenu>Table</guimenu>
1037            <guimenuitem>Close</guimenuitem>
1038            </menuchoice> which unloads the table from Thuban.
1039            </para>
1040            <para>
1041            The status bar displays some statistics about the table and optional
1042            selection results.
1043            </para>
1044        </section>
1045    
1046        <section><title>General Functionality (Menu Table)</title>
1047            <para>
1048            The general functions affect all tables open in Thuban. Attribute
1049            tables are considered here as normal data tables (with the exception
1050            that they cannot be closed).
1051            </para>
1052            <section><title>Open</title>
1053                <para>
1054                The
1055                <menuchoice>
1056                <guimenu>Table</guimenu>
1057                <guimenuitem>Open</guimenuitem>
1058                </menuchoice>
1059                item raises a file dialog to let you select a
1060                dBase file from the file system to be loaded into Thuban read-only.
1061                On <guibutton>OK</guibutton> the selected file is loaded and a
1062                table view is opened.
1063                </para>
1064            </section>
1065    
1066            <section><title>Close</title>
1067                <para>
1068                The
1069                <menuchoice>
1070                <guimenu>Table</guimenu>
1071                <guimenuitem>Close</guimenuitem>
1072                </menuchoice>
1073                item raises a dialog listing the currently open
1074                data tables
1075                (loaded via
1076                <menuchoice>
1077                <guimenu>Table</guimenu>
1078                <guimenuitem>Open</guimenuitem>
1079                </menuchoice>). Selected tables are dereferenced on confirmation.
1080                Since tables are opened read-only the contents of the tables are
1081                not affected.
1082    
1083                Any open views of the tables are closed as well.
1084    
1085                Tables used in a join cannot be closed.
1086                </para>
1087            </section>
1088    
1089            <section><title>Rename</title>
1090                <para>
1091                <menuchoice>
1092                <guimenu>Table</guimenu>
1093                <guimenuitem>Rename</guimenuitem>
1094                </menuchoice> changes the table title.
1095                </para>
1096            </section>
1097    
1098            <section><title>Show</title>
1099                <para>
1100                The
1101                <menuchoice>
1102                <guimenu>Table</guimenu>
1103                <guimenuitem>Show</guimenuitem>
1104                </menuchoice>
1105                item raises a list of available tables (explicitly
1106                loaded, attribute tables, results of a join). Selected tables are
1107                show in tables views on <guibutton>OK</guibutton>.
1108                </para>
1109            </section>
1110    
1111            <section><title>Join</title>
1112                <para>
1113                <figure>
1114                <title>Join Tables</title>
1115                <mediaobject>
1116                <imageobject><imagedata fileref="../images/7_2_5_join.png" format="PNG" scale="&imgscale;"/></imageobject>
1117                <imageobject><imagedata fileref="./images/7_2_5_join.eps" format="EPS" scale="&imgscale;"/></imageobject>
1118                </mediaobject>
1119                </figure>
1120                </para>
1121                <para>
1122                The
1123                <menuchoice>
1124                <guimenu>Table</guimenu>
1125                <guimenuitem>Join</guimenuitem>
1126                </menuchoice>
1127                item raises a dialog to specify the two tables to be
1128                joined. The join results in a new table named 'Join of "left table"
1129                and "right table"'.
1130    
1131                The dialog lets you select the two tables to be joined and the two
1132                fields the join has to be performed on. By default, the new
1133                table contains only those records which are matched by the join.
1134    
1135                If you want to preserve the records of the left table you can
1136                perform an outer join. The fields from the right table for records
1137                not matched by the join are filled with <varname>None</varname> in
1138                this case.
1139                </para>
1140            </section>
1141    
1142        </section>
1143        <section><title>Attribute Tables</title>
1144            <para>
1145                To clearly separate between both types of tables (data and
1146            attribute), Thuban provides functionality regarding the attribute
1147            tables under the <menuchoice><guimenu>Layer</guimenu></menuchoice> menu.
1148            </para>
1149    
1150            <section><title>Show Table</title>
1151                <para>
1152                <menuchoice>
1153                <guimenu>Layer</guimenu>
1154                <guimenuitem>Show Table</guimenuitem>
1155                </menuchoice>
1156                opens the attribute table of the currently active layer in a table
1157                view.
1158    
1159                In addition to the functionality described above selections
1160                affect also the map display: objects related to selected records
1161                are highlighted.
1162                </para>
1163            </section>
1164    
1165            <section><title>Join Table</title>
1166                <para>
1167                Unlike the join described above, the join does not result in a
1168                new table. The attribute table of the currently active layer is the
1169                left table and other tables are joined to this table. The results of
1170                the join are available for classification.
1171    
1172                As a consequence, the join cannot result in fewer
1173                records than the source attribute table. The user is warned if the
1174                right table does not fulfill this constraint. An outer join must be
1175                used in such cases.
1176                </para>
1177            </section>
1178    
1179            <section><title>Unjoin Table</title>
1180                <para>
1181                As said above, a normal table cannot be closed while it is still
1182                used in a join. While the joined table resulting from a join of
1183                normal tables can be simply closed (and thereby dereferencing
1184                the source tables), this is not possible for attribute tables.
1185    
1186                Hence joins on attribute tables must be solved explicitly. This is
1187                what the
1188                <menuchoice>
1189                <guimenu>Layer</guimenu>
1190                <guimenuitem>Unjoin Table</guimenuitem>
1191                </menuchoice>
1192                item is used for: The last join for the currently
1193                active layer is solved.
1194                </para>
1195            </section>
1196        </section>
1197    </chapter>    </chapter>
1198    
1199    <chapter><title>Trouble Shooting</title>    <chapter><title>Trouble Shooting</title>
1200      <para>      <para>
1201        Here are a few problems that users have encountered when first using Thuban.
1202        </para>
1203        <para>
1204    
1205        <itemizedlist>
1206        <listitem>
1207        <para>After adding two or more layers nothing is drawn in the map window.
1208        </para>
1209        <para>
1210        This is probably because the layers have different projections. Projections
1211        must be set on all layers and on the map itself if the layers' projections
1212        are different.
1213      </para>      </para>
1214        </listitem>
1215    
1216        <listitem>
1217        <para>Thuban crashes on startup with the error
1218            <literal>NameError: global name 'False' is not defined</literal>.
1219        </para>
1220        <para>
1221        <varname>True</varname> and <varname>False</varname> were only introduced
1222        in Python 2.2.1. Thuban depends on at least Python 2.2.1.
1223        </para>
1224        </listitem>
1225    
1226        <listitem>
1227        <para>After compiling Thuban, Thuban crashes with an error similar to
1228            <literal>
1229            ImportError: /usr/local//lib/thuban/Thuban/../Lib/wxproj.so: undefined symbol: __gxx_personality_v0
1230            </literal>
1231        </para>
1232        <para>
1233        Thuban depends on the wxWindows library. If Thuban is compiled with an
1234        incompatible version of the compiler than wxWindows was compiled with
1235        this error may occur. Try compiling with a different version of the
1236        compiler.
1237        </para>
1238        </listitem>
1239        </itemizedlist>
1240        </para>
1241        <para>
1242        If an error occurs Thuban will display a dialog indicating the error
1243        before closing. The text should be copied and reported to the
1244        <ulink url="http://thuban.intevation.org/bugtracker.html">
1245        Intevation bugtracker
1246        </ulink>.
1247        More information about the system is available from
1248        <menuchoice><guimenu>Help</guimenu><guimenuitem>About</guimenuitem></menuchoice> box.
1249        This should also be included in the bug report.
1250        <figure>
1251        <title>Error Dialog</title>
1252        <mediaobject>
1253        <imageobject><imagedata fileref="../images/8_int_error.png" format="PNG" scale="&imgscale;"/></imageobject>
1254        <imageobject><imagedata fileref="./images/8_int_error.eps" format="EPS" scale="&imgscale;"/></imageobject>
1255        </mediaobject>
1256        </figure>
1257        </para>
1258    
1259    </chapter>    </chapter>
1260    
1261    <appendix><title>Supported Data Sources</title>    <appendix><title>Supported Data Sources</title>
# Line 646  Line 1264 
1264      <variablelist>      <variablelist>
1265      <varlistentry>      <varlistentry>
1266      <term>Shapefile</term>      <term>Shapefile</term>
1267      <listitem><para></para></listitem>      <listitem>
1268            <para>
1269            The Shapefile format has become a standard format for saving
1270            geographic vector information. It supports polygons, lines, and
1271            points.
1272            
1273            <ulink url="http://www.esri.com/library/whitepapers/pdfs/shapefile.pdf">
1274            Technical Specification.
1275            </ulink>  
1276            </para>
1277        </listitem>
1278      </varlistentry>      </varlistentry>
1279    
1280      <varlistentry>      <varlistentry>
1281      <term>DB2 file</term>      <term>dBase file</term>
1282      <listitem><para></para></listitem>      <listitem>
1283            <para>
1284            dBase files are used to store the attributes for each layer. This
1285            is closely associated with the Shapefile format. For detailed
1286            specifications on the correct format of a dBase file used with
1287            Thuban please see the Technical Specification for the Shapefile
1288            format above.
1289            </para>
1290        </listitem>
1291        </varlistentry>
1292    
1293        <varlistentry>
1294        <term>Raster files</term>
1295        <listitem>
1296            <para>
1297            Binding the GDAL library Thuban supports numerous raster file formats,
1298            see <ulink url="http://www.remotesensing.org/gdal/formats_list.html">
1299            GDAL format list</ulink> for details.</para>
1300    
1301            <para>Most commonly used is the <emphasis>TIFF/GeoTIFF</emphasis>
1302            format: Raster maps are provided as TIFF images, with an additional
1303            "world file" storing the geographic reference (usually with an
1304            extension ".tfw".
1305            </para>
1306        </listitem>
1307      </varlistentry>      </varlistentry>
1308    
1309      </variablelist>      </variablelist>
# Line 659  Line 1311 
1311    
1312    <appendix><title>Supported Projections</title>    <appendix><title>Supported Projections</title>
1313      <para>      <para>
1314        The following types of projections are directly support by
1315        Thuban. The specific values for each are provided by the user
1316        to create custom projections. Thuban comes with predefined
1317        projections which are available through the Projections dialog.
1318        </para>
1319        <itemizedlist>
1320        <listitem>
1321            <para>Geographic</para>
1322            <itemizedlist>
1323            <listitem><para><literal>Ellipsoid</literal></para></listitem>
1324            <listitem><para>
1325                    <literal>Source Data</literal>: either Degrees or Radians
1326                    </para></listitem>
1327            </itemizedlist>
1328        </listitem>
1329        <listitem>
1330            <para>Lambert Conic Conformal</para>
1331        <itemizedlist>
1332            <listitem><para><literal>Ellipsoid</literal></para></listitem>
1333            <listitem><para><literal>Latitude of 1st standard parallel</literal></para></listitem>
1334            <listitem><para><literal>Latitude of 2nd standard parallel</literal></para></listitem>
1335            <listitem><para><literal>Central Meridian</literal></para></listitem>
1336            <listitem><para><literal>Latitude of Origin</literal></para></listitem>
1337            <listitem><para><literal>False Easting</literal> (meters)</para></listitem>
1338            <listitem><para><literal>False Northing</literal> (meters)</para></listitem>
1339        </itemizedlist>
1340        </listitem>
1341        <listitem>
1342            <para>Transverse Mercator</para>
1343        <itemizedlist>
1344            <listitem><para><literal>Ellipsoid</literal></para></listitem>
1345            <listitem><para><literal>Latitude</literal>of origin</para></listitem>
1346            <listitem><para><literal>Longitude</literal>at central meridian</para></listitem>
1347            <listitem><para><literal>Scale Factor</literal>at central meridian</para></listitem>
1348            <listitem><para><literal>False Easting</literal> (meters)</para></listitem>
1349            <listitem><para><literal>False Northing</literal> (meters)</para></listitem>
1350        </itemizedlist>
1351        </listitem>
1352        <listitem>
1353            <para>Universal Transverse Mercator</para>
1354        <itemizedlist>
1355            <listitem><para><literal>Ellipsoid</literal></para></listitem>
1356            <listitem><para><literal>Zone</literal>
1357                    (can be guessed appling the Propose button)</para></listitem>
1358            <listitem><para><literal>Southern Hemisphere</literal> flag</para></listitem>
1359        </itemizedlist>
1360        </listitem>
1361        </itemizedlist>
1362        
1363        <para>
1364        Thuban comes with a sample set of map projections for various
1365        European countries. Apart from the basic projection they differ
1366        especially in their parameterization:
1367        </para>
1368        <itemizedlist>
1369        <listitem><para>Belgium Datum 1972 (Lambert Conic Conformal)</para>
1370        </listitem>
1371    
1372        <listitem><para>Gauss-Boaga Zone 1 (Italy, Transverse Mercartor)</para>
1373        </listitem>
1374    
1375        <listitem><para>Gauss-Krueger Zone 2 (Germany, Transverse Mercartor)
1376        </para>
1377        </listitem>
1378    
1379        <listitem><para>Reseau Geodesique Francaise
1380        (France, Lambert Conic Conformal)</para>
1381        </listitem>
1382    
1383        <listitem><para>UK National Grid (United Kingdom, Transverse Mercartor)
1384        </para>
1385        </listitem>
1386        </itemizedlist>
1387    
1388        <para>
1389        Thuban uses the comprehensive PROJ library for projections. PROJ provides
1390        more than the four commonly used projections described above. If needed
1391        Thuban can be easily extended to a new projection covered by PROJ.
1392      </para>      </para>
     <variablelist>  
     <varlistentry>  
     <term>Geographic</term>  
     <listitem><para>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>  
1393    </appendix>    </appendix>
1394    
1395  </book>  </book>
1396    
Legend:
Removed from v.1475  
changed lines
  Added in v.1533
[email protected]
 ViewVC Help
Powered by ViewVC 1.1.26