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

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

Parent Directory | Revision Log | View Patch Patch

-revision 1491 by jonathan,
Tue Jul 29 08:25:59 2003 UTC
+revision 1544 by jan,
Mon Aug  4 15:22:48 2003 UTC
 Line 24
    <chapter><title>Introduction</title>
      <para>
-     Thuban is a Free Software Geographic Information Systems (GIS) viewer.
+     Thuban is an interactive geographic data viewer.
-     It is being developed because there is currently no simple interactive
+     It has been developed because there was no simple interactive
      viewer for geographic information available as Free Software. Thuban is
      written in Python and C++ and uses the wxWindows library allowing it to
      run on many different platforms, including GNU/Linux and Windows.
      </para>
      <para>
-     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
+         get a visual
      impression of the positional relationship of the information that may not
      be apparent from simple inspection of the data values themselves.
      Thuban allows the user to create a session that displays
-Line 48
+Line 49
          <section><title>Installation</title>
          <para>
          Thuban is actively supported under Debian Testing (sarge), RedHat 7.2,
-         and Windows 2000. All the necessary files can be found on the
+         and Windows 2000. Thuban depends on the following packages. These
+         packages can also be found on the
          <ulink url="http://thuban.intevation.org/download.html">
          Thuban Download site
          </ulink>.
-         </para>
+         <itemizedlist>
+             <listitem><para>Python 2.2.1 (<literal>http://www.python.org</literal>)</para></listitem>
+             <listitem><para>wxWindows 2.4 (<literal>http://www.wxwindows.org</literal>)</para></listitem>
+             <listitem><para>wxPython 2.4 (<literal>http://www.wxpython.org</literal>)</para></listitem>
+             <listitem><para>proj 4.4.5 Projection Library (<literal>http://www.remotesensing.org/proj/</literal>)</para></listitem>
+             <listitem><para>GDAL 1.1.8 (<literal>http://www.remotesensing.org/gdal/</literal>)</para></listitem>
+             <listitem><para>SQLite 2.8.3 (<literal>http://www.hwaci.com/sw/sqlite/</literal>)</para></listitem>
+             <listitem><para>PySQLite 0.4.3 (<literal>http://pysqlite.sourceforge.net</literal>)</para></listitem>
+             </itemizedlist>
+         </para>
+                 <para>
+                 Along with the source codes, the download page also offers
+                 full installation packages for Debian, Windows and RPM-based systems
+                 (Mandrake, RedHat, SuSE, etc).
+                 </para>
          </section>
          <section><title>The Main Window</title>
          <para>
-         <screenshot>
+         <figure>
-         <screeninfo>The Main Window</screeninfo>
+         <title>The Main Window</title>
          <mediaobject>
          <imageobject> <imagedata fileref="../images/1_2_mainwindow.png" format="PNG" scale="&imgscale;"/> </imageobject>
          <imageobject> <imagedata fileref="./images/1_2_mainwindow.ps" format="EPS" scale="&imgscale;"/> </imageobject>
-         <textobject><phrase>The Main Window</phrase></textobject>
-         <caption><para>The Main Window</para></caption>
          </mediaobject>
-         </screenshot>
+         </figure>
          </para>
          <para>
-Line 101
+Line 115
          The tool bar provides quick access to the commonly needed tools.
          By hovering over each button the user can see a short messages
          describing what the tool does. The tools provided are Zoom In, Zoom
-         Out, Pan, Full Extent, Full Layer Extent, Full Shape Extent, Indentify,
+         Out, Pan, Full Extent, Full Layer Extent, Full Shape Extent, Identify,
          and Label. Each of the tools will be explained in further detail later
          in the manual.
          </para>
-Line 149
+Line 163
          <guimenu>File</guimenu>
          <guimenuitem>Save Session</guimenuitem>
          </menuchoice>. A dialog box will open allowing the user to browse
-         the filesystem and select a place to save the session. Thuban
+         the file system and select a place to save the session. Thuban
          sessions should be saved under a name ending in
          <varname>.thuban</varname>. If the file already exists the user
          will be prompted to save under a different name or overwrite the
-Line 159
+Line 173
          <section><title>The Session Info-Tree</title>
          <para>
-         <screenshot>
+         <figure>
-         <screeninfo>Session Info Tree</screeninfo>
+         <title>Session Info Tree</title>
          <mediaobject>
          <imageobject><imagedata fileref="../images/2_4_session_tree.png" format="PNG" scale="&imgscale;"/></imageobject>
          <imageobject><imagedata fileref="./images/2_4_session_tree.eps" format="EPS" scale="&imgscale;"/></imageobject>
-         <textobject><phrase>Session Info Tree</phrase></textobject>
-         <caption><para>Session Info Tree</para></caption>
          </mediaobject>
-         </screenshot>
+         </figure>
          </para>
          <para>
          The session info-tree is primarily intended for developers working
-Line 209
+Line 221
          <section><title>Adding and Removing Layers</title>
          <para>
-         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
          and image layers. Shape layers are stored in Shapefile format, a
          standard file format for storing geographic objects. These
          files have the extension ``.shp''. Associated with
          the shape file is a database file which stores attributes for
-         each shape in the shape file. This file, in dBASE format,
+         each shape in the shape file. This file, in dBase format,
          has the extension ``.dbf''. Both files must have the same base name.
          For example, if there is a shape file named roads.shp there must
          also be a file roads.dbf.
-Line 248
+Line 260
          the tool bar or from the
          <menuchoice><guimenu>Map</guimenu></menuchoice> menu.
          </para>
+         <itemizedlist>
+         <listitem>
          <para>
          The ZoomIn tool
          <inlinemediaobject>
-Line 261
+Line 275
          </inlinemediaobject>
          enlarges a region of the map. Clicking once on the map
          will double the magnification and center the map on the point that
-         was clicked. Clicking and dragging selects a region that will
+         was clicked. Clicking and dragging selects a region that will be
          enlarged to fit the window.
          </para>
+         </listitem>
+         <listitem>
          <para>
          The ZoomOut tool
          <inlinemediaobject>
-Line 280
+Line 296
          selects a box such that the current contents of the window will be
          scaled to fit into that box.
          </para>
+         </listitem>
+         <listitem>
          <para>
          The Pan tool
          <inlinemediaobject>
-Line 293
+Line 311
          </inlinemediaobject>
          allows the user to move the map around by clicking and dragging.
          </para>
+         </listitem>
+         <listitem>
          <para>
          The Full Extent tool
          <inlinemediaobject>
-Line 306
+Line 326
          </inlinemediaobject>
          rescales the viewable region so that the entire map is visible.
          </para>
+         </listitem>
+         <listitem>
          <para>
          The Full Layer Extent tool
          <inlinemediaobject>
-Line 321
+Line 343
          layer fits within the window. If no layer is selected this button
          will be disabled.
          </para>
+         </listitem>
+         <listitem>
          <para>
          The Full Shape Extent tool
          <inlinemediaobject>
-Line 335
+Line 359
          rescales the viewable region so that the currently selected
          shape fits within the window. If the shape is a point, it is
          centered and the map is zoomed all the way in. If no shape is
-         selected this button will be disabled.
+         selected this button will be disabled. This feature is especially
+         helpful when identifying an object related to a selected record
+         in a tableview (see below).
          </para>
+         </listitem>
+         </itemizedlist>
          </section>
          <section><title>Object Identification</title>
-Line 353
+Line 382
          </inlinemediaobject>.
          Clicking on an object selects that object and opens a dialog which
          shows all the table attributes for that object. Any current selection
-         is lost.
+         is lost. Objects on the map are typically shapes and this document
+         will often refer to objects as shapes.
          </para>
          </section>
-         <section><title>Object Labelling</title>
+         <section><title>Object Labeling</title>
          <para>
-         Objects can be labelled using the Label tool
+         Objects can be labeled using the Label tool
          <inlinemediaobject>
          <imageobject>
          <imagedata fileref="../images/3_3_label.png" format="PNG" scale="&imgscale;"/>
-Line 404
+Line 434
          <menuchoice><guimenu>Map</guimenu></menuchoice>.
          </para>
+         <itemizedlist>
+         <listitem>
          <para>
          The Move Layer to Top tool
          <inlinemediaobject>
-Line 416
+Line 448
          <textobject> <phrase>Move Layer to Top</phrase> </textobject>
          </inlinemediaobject> raises the selected layer to the top of the map.
          </para>
+         </listitem>
+         <listitem>
          <para>
          The Move Layer Up tool
-Line 429
+Line 463
          <textobject> <phrase>Move Layer Up</phrase> </textobject>
          </inlinemediaobject> raises the selected layer one level.
          </para>
+         </listitem>
+         <listitem>
          <para>
          The Move Layer Down tool
-Line 443
+Line 479
          </inlinemediaobject> lowers the selected layer one level.
          </para>
+         </listitem>
+         <listitem>
          <para>
          The Move Layer to Bottom tool
          <inlinemediaobject>
-Line 456
+Line 494
          </inlinemediaobject> lowers the selected layer to the bottom of the map.
          </para>
+         </listitem>
+         <listitem>
          <para>
          The Visible tool
          <inlinemediaobject>
-Line 470
+Line 510
          hidden.
          </para>
+         </listitem>
+         <listitem>
          <para>
          The Invisible tool
          <inlinemediaobject>
-Line 483
+Line 525
          </inlinemediaobject> hides the selected layer in the map.
          </para>
+         </listitem>
+         <listitem>
          <para>
          The Properties tool
          <inlinemediaobject>
-Line 497
+Line 541
          Double-clicking on a layer or a group of a layer will open the
          properties dialog for that layer.
          </para>
+         </listitem>
+         </itemizedlist>
+         <para>
+         Along the bottom of the legend is the scalebar. The scalebar
+         will be available if there are any layers and the  map has a
+         projection set.
+         </para>
          </section>
          <section><title>Exporting</title>
-Line 507
+Line 558
          <menuchoice>
          <guimenu>Map</guimenu>
          <guimenuitem>Export</guimenuitem>
-         </menuchoice>. Under other platforms this option is not available.
+         </menuchoice> for use in reports, presentations, or further
-         Clicking this menu item open a file selection dialog that lets the
+         modification. The current map view, legend, and, if available,
-         user select a location to export the map.
+         scalebar are exported. Under other platforms this option is not
+         available. Clicking this menu item open a file selection dialog
+         that lets the user select a location to export the map.
          </para>
          </section>
-Line 519
+Line 572
          <menuchoice>
          <guimenu>Map</guimenu>
          <guimenuitem>Print</guimenuitem>
-         </menuchoice>. A standard printing dialog will open allowing the
+         </menuchoice>. The current map view, legend, and, if available,
-         user to configure the printer. This dialog will differ depending
+         scalebar are printed. A standard printing dialog will open allowing
+         the user to configure the printer. This dialog will differ depending
          on which platform Thuban is running.
          </para>
          </section>
-Line 536
+Line 590
          There are two types of layers supported by Thuban: shape layers and
          image layers. Shape layers consist of vector based shapes with
          geo-referenced coordinates. There are three types of supported
-         shapes: polygons, lines, and points. Image layers can be any image
+         shapes: polygons, lines (arc), and points. Image layers can be any image
-         file format supported by the Geospatial Data Abstraction Library
+         file format supported by the Geo-spatial Data Abstraction Library
          (GDAL). The images must have geographic
-         coordinate data either embedded within the file or in a seperate
+         coordinate data either embedded within the file or in a separate
          file that is in the same directory as the image file. GeoTIFF files
          work very well with Thuban and were designed specifically to be image
          layers in GIS programs.
          </para>
+         <para>
+         All actions in the
+         <menuchoice>
+         <guimenu>Layer</guimenu>
+         </menuchoice> menu act on the currently selected layer in the legend.
+         </para>
          </section>
          <section><title>Properties</title>
-Line 554
+Line 614
          <guimenu>Layer</guimenu>
          <guimenuitem>Properties</guimenuitem>
          </menuchoice> opens a dialog that displays a layer's properties.
-         All layers have a title and it can be modified in the text field
+         All layers have a title which can be modified in the text field
          provided. The type of layer is also shows. If the type is a type
          of shape (polygon, arc, point) the classification table will be
          shown. Image layers have no other properties other than title
          and type.
          </para>
          <para>
-         <screenshot>
+         <figure>
-         <screeninfo>Properties Window</screeninfo>
+         <title>Properties Window</title>
          <mediaobject>
          <imageobject><imagedata fileref="../images/4_2_layer_properties.png" format="PNG" scale="&imgscale;"/></imageobject>
          <imageobject><imagedata fileref="./images/4_2_layer_properties.eps" format="EPS" scale="&imgscale;"/></imageobject>
-         <textobject><phrase>Properties Window</phrase></textobject>
-         <caption><para>The Properties Window for a Shape Layer</para></caption>
          </mediaobject>
-         </screenshot>
+         </figure>
          </para>
          <para>
-         <screenshot>
+         <figure>
-         <screeninfo>Properties Window</screeninfo>
+         <title>Properties Window</title>
          <mediaobject>
          <imageobject><imagedata fileref="../images/4_2_raster_layer_properties.png" format="PNG" scale="&imgscale;"/></imageobject>
          <imageobject><imagedata fileref="./images/4_2_raster_layer_properties.eps" format="EPS" scale="&imgscale;"/></imageobject>
-         <textobject><phrase>Properties Window</phrase></textobject>
-         <caption><para>The Properties Window for an Image Layer</para></caption>
          </mediaobject>
-         </screenshot>
+         </figure>
          </para>
          </section>
-Line 646
+Line 702
      <para>
      A layer always has a classification. When a new layer is added to the
      map, a default classification is created with the DEFAULT group. This
-     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
-     attributes, will match this group if no other group matches.
+     layer, regardless of its attributes, will match this group if no other
+     group matches.
      </para>
          <section><title>Editing Classifications</title>
-Line 664
+Line 721
          button.
          </para>
          <para>
-         <screenshot>
+         To apply the changes to the map the user can click
-         <screeninfo>Properties Window</screeninfo>
+         either <guibutton>Try</guibutton> or <guibutton>OK</guibutton>.
+         <guibutton>Try</guibutton> will not close the dialog box, allowing
+         the user to see how the classification changes the map.
+         <guibutton>Revert</guibutton> will undo the last classification applied
+         to the map. <guibutton>OK</guibutton> will commit the changes and
+         close the dialog. The user will be unable to undo the changes.
+         <guibutton>Close</guibutton> simply closes the dialog box. If any
+         changes have not been applied with <guibutton>Try</guibutton> the
+         changes will not be applied to the map.
+         </para>
+         <para>
+         <figure>
+         <title>Properties Window</title>
          <mediaobject>
          <imageobject><imagedata fileref="../images/5_classification.png" format="PNG" scale="&imgscale;"/></imageobject>
          <imageobject><imagedata fileref="./images/5_classification.eps" format="EPS" scale="&imgscale;"/></imageobject>
-         <textobject><phrase>Properties Window</phrase></textobject>
-         <caption><para>The Properties Window with Classifications</para></caption>
          </mediaobject>
-         </screenshot>
+         </figure>
          </para>
          <para>
          The order of the groups in the classification is significant
-Line 687
+Line 754
          </para>
              <section><title>Visible</title>
              <para>
-             The Visible column has checkboxes that determine whether a
+             The Visible column has check-boxes that determine whether a
              classification group will be displayed in the legend. This is
              useful if the user knows that the groups completely cover
              the data set and don't want the DEFAULT group to be displayed
-Line 719
+Line 786
              If the type is Integer, then any valid integer may be entered. In
              addition, with special syntax, a range of values can be entered.
              A range from <varname>start</varname> to <varname>end</varname>
-             inclusive is specifed like this: <literal>[start;end]</literal>.
+             inclusive is specified like this: <literal>[start;end]</literal>.
              The exclusive range is specified like this:
              <literal>]start;end[</literal>. Ranges can include infinity like
              this: <literal>[-oo;oo]</literal>. Field types can also be of type
-Line 738
+Line 805
          <section><title>Generating Classes</title>
          <para>
-         <screenshot>
+         <figure>
-         <screeninfo>Generate Class</screeninfo>
+         <title>Generate Class</title>
          <mediaobject>
          <imageobject><imagedata fileref="../images/5_3_genclass.png" format="PNG" scale="&imgscale;"/></imageobject>
          <imageobject><imagedata fileref="./images/5_3_genclass.eps" format="EPS" scale="&imgscale;"/></imageobject>
-         <textobject><phrase>Generate Class</phrase></textobject>
-         <caption><para>The Generate Classifications Dialog</para></caption>
          </mediaobject>
-         </screenshot>
+         </figure>
          </para>
          <para>
          Creating a classification by hand can be tedious.
-Line 754
+Line 819
          classification at once while still giving the user control over
          how it appears. Clicking <guibutton>Generate Class</guibutton>
          opens the <varname>Generate Classification</varname> dialog.
-         Under the <varname>Generate</varname> pulldown there are at most
+         Under the <varname>Generate</varname> pull down there are at most
          three different ways to generate classifications:
-         Unique Values, Unique Distribution, and Quantiles. Some options
+         Unique Values, Uniform Distribution, and Quantiles. Some options
          may not be available if the data type for the field does not
-         support them. For instance, <varname>Unique Distribution</varname>
+         support them. For instance, <varname>Uniform Distribution</varname>
          doesn't make sense for a Text field.
          </para>
          <para>
          For every way of generating a classification, a color scheme must
          be selected. Thuban provides several different color schemes that
          affect how the group properties change over the classification.
+         It may be desirable that only certain properties change over the
+         classification. If the shape type is a polygon or a point then
+         the <guibutton>Fix Border Color</guibutton> option will be available.
+         This allows the user to select a border color for all classification
+         groups.
          It is also possible to create a custom color scheme. Selecting
          this option will display two symbols: the one of the left has the
          properties of the first group and the one on the right has the
          properties of the last group. Thuban will interpolate between these
          two properties to generate the other groups.
+         <figure>
+         <title>Custom Color Scheme</title>
+         <mediaobject>
+         <imageobject><imagedata fileref="../images/5_2_custom_ramp.png" format="PNG" scale="&imgscale;"/></imageobject>
+         <imageobject><imagedata fileref="./images/5_2_custom_ramp.eps" format="EPS" scale="&imgscale;"/></imageobject>
+         </mediaobject>
+         </figure>
          </para>
          <para>
          The Unique Values option lets the user select specific values that
-Line 779
+Line 856
          right. Each list can be sorted or reversed for easier searching.
          The classification that is generated will be in the same order as
          the list on the right.
+         <figure>
+         <title>Unique Values</title>
+         <mediaobject>
+         <imageobject><imagedata fileref="../images/5_2_unique_values.png" format="PNG" scale="&imgscale;"/></imageobject>
+         <imageobject><imagedata fileref="./images/5_2_unique_values.eps" format="EPS" scale="&imgscale;"/></imageobject>
+         </mediaobject>
+         </figure>
          </para>
          <para>
-         The Unique Distribution option creates a user specified number of
+         The Uniform Distribution option creates a user specified number of
          groups of ranges such that each range covers equal intervals. The
          minimum and maximum values can automatically be retrieved from the
          table by clicking <guibutton>Retrieve From Table</guibutton>. The
          stepping is how large each interval is. Adjusting this value will
          automatically recalculate how many groups is appropriate.
+         <figure>
+         <title>Uniform Distribution</title>
+         <mediaobject>
+         <imageobject><imagedata fileref="../images/5_2_uniform_dist.png" format="PNG" scale="&imgscale;"/></imageobject>
+         <imageobject><imagedata fileref="./images/5_2_uniform_dist.eps" format="EPS" scale="&imgscale;"/></imageobject>
+         </mediaobject>
+         </figure>
          </para>
          <para>
          The Quantiles option generates ranges based on the number of items
-         in the input set. For example, by specifying five groups Thuban will
+         in the table. For example, by specifying five groups Thuban will
          generate five groups with appropriate ranges such that 20% of the table
          data is in each group. If it is impossible to generate exact
          groupings, Thuban will issue a warning but allow the user to continue.
+         <figure>
+         <title>Quantiles</title>
+         <mediaobject>
+         <imageobject><imagedata fileref="../images/5_2_quantiles.png" format="PNG" scale="&imgscale;"/></imageobject>
+         <imageobject><imagedata fileref="./images/5_2_quantiles.eps" format="EPS" scale="&imgscale;"/></imageobject>
+         </mediaobject>
+         </figure>
          </para>
          </section>
    </chapter>
-Line 815
+Line 913
      <guimenu>Layer</guimenu>
      <guimenuitem>Projection</guimenuitem>
      </menuchoice>.
-     <screenshot>
+     <figure>
-     <screeninfo>Projection Window</screeninfo>
+     <title>Projection Window</title>
      <mediaobject>
      <imageobject><imagedata fileref="../images/6_projection.png" format="PNG" scale="&imgscale;"/></imageobject>
      <imageobject><imagedata fileref="./images/6_projection.eps" format="EPS" scale="&imgscale;"/></imageobject>
-     <textobject><phrase>Projection Window</phrase></textobject>
-     <caption><para>The Projection Window</para></caption>
      </mediaobject>
-     </screenshot>
+     </figure>
      </para>
      <para>
      Thuban is distributed with a sample collection of projections. The
-Line 852
+Line 948
          list of available projections as a new entry, and thus makes it
          available to future Thuban sessions. Clicking <guibutton>New</guibutton>
          will create an entirely new, empty projection. The
-         <guibutton>Remove</guibutton> button will permanantly remove a
+         <guibutton>Remove</guibutton> button will permanently remove a
          projection from the list of available projections.
          </para>
+         <para>
+         To apply the selected projection to the map the user can click
+         either <guibutton>Try</guibutton> or <guibutton>OK</guibutton>.
+         <guibutton>Try</guibutton> will not close the dialog box, allowing
+         the user to see how the projeciton changes the map.
+         <guibutton>Revert</guibutton> will undo the last projection applied
+         to the map. <guibutton>OK</guibutton> will commit the changes and
+         close the dialog. The user will be unable to undo the changes.
+         <guibutton>Close</guibutton> simply closes the dialog box. If no
+         selection has been applied with <guibutton>Try</guibutton> the
+         selection will not be applied to the map.
+         </para>
      </section>
          <section><title>Importing/Exporting Projections</title>
          <para>
-Line 881
+Line 989
      <section><title>Table View</title>
          <para>
-         <screenshot>
+         <figure>
-         <screeninfo>Table View</screeninfo>
+         <title>Table View</title>
          <mediaobject>
          <imageobject><imagedata fileref="../images/7_1_table_view.png" format="PNG" scale="&imgscale;"/></imageobject>
          <imageobject><imagedata fileref="./images/7_1_table_view.eps" format="EPS" scale="&imgscale;"/></imageobject>
-         <textobject><phrase>Table View</phrase></textobject>
-         <caption><para>The Table View</para></caption>
          </mediaobject>
-         </screenshot>
+         </figure>
          </para>
          <para>
          Thuban provides a standard dialog to display table contents, the
-         Table View. The view falls has five sections: The title, selections,
+         Table View. The view has five sections: The title, selections,
          the table grid, export functions, and the status bar.
          </para>
          <para>
-Line 906
+Line 1012
          third choice can be either a specific value (interpreted as numerical
          or string depending on the type of the first field) or a second field
          identifier. Thus you can perform analysis like selecting all
-         records where "population > 10000" or
+         records where <literal>population > 10000</literal> or
-         "cars_per_inhabitant <  bikes_per_inhabitant" (note that the field names
+         <literal>cars_per_inhabitant < bikes_per_inhabitant</literal>
-         are only explanatory, the dBASE files allow only
+         (note that the field names are only explanatory, the dBase files
-character field names).
+         allow only 11 character field names).
          Selections can be combined either by applying a selection only on
          a previously selected set of records or by adding the results of a
-Line 917
+Line 1023
          earlier results.
          </para>
          <para>
-         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),
          with highlighted selection results. Columns and rows can be resized.
          </para>
          <para>
-         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
-         format (DBF) or comma seperated values (CSV). The
+         format (DBF) or comma separated values (CSV). The
          <guibutton>Export</guibutton> button
          raises a file dialog to specify a path and file name, the export type
          is determined by the file extension (either .dbf or .csv).
-Line 957
+Line 1063
              <guimenuitem>Open</guimenuitem>
              </menuchoice>
              item raises a file dialog to let you select a
-             dBASE file from the file system to be loaded into Thuban read-only.
+             dBase file from the file system to be loaded into Thuban read-only.
              On <guibutton>OK</guibutton> the selected file is loaded and a
              table view is opened.
              </para>
-Line 1010
+Line 1116
          <section><title>Join</title>
              <para>
-             <screenshot>
+             <figure>
-             <screeninfo>Join Tables</screeninfo>
+             <title>Join Tables</title>
              <mediaobject>
              <imageobject><imagedata fileref="../images/7_2_5_join.png" format="PNG" scale="&imgscale;"/></imageobject>
              <imageobject><imagedata fileref="./images/7_2_5_join.eps" format="EPS" scale="&imgscale;"/></imageobject>
-             <textobject><phrase>Join Tables</phrase></textobject>
-             <caption><para>The Join Tables Dialog</para></caption>
              </mediaobject>
-             </screenshot>
+             </figure>
              </para>
              <para>
              The
-Line 1044
+Line 1148
      </section>
      <section><title>Attribute Tables</title>
          <para>
-             To clearly separate between both types, Thuban provides
+             To clearly separate between both types of tables (data and
-         functionality regarding the attribute tables under the Layer menu.
+         attribute), Thuban provides functionality regarding the attribute
+         tables under the <menuchoice><guimenu>Layer</guimenu></menuchoice> menu.
          </para>
          <section><title>Show Table</title>
-Line 1084
+Line 1189
              normal tables can be simply closed (and thereby dereferencing
              the source tables), this is not possible for attribute tables.
-             Hence joins on attribute tables must be solved explicitely. This is
+             Hence joins on attribute tables must be solved explicitly. This is
              what the
              <menuchoice>
              <guimenu>Layer</guimenu>
-Line 1099
+Line 1204
    <chapter><title>Trouble Shooting</title>
      <para>
+     Here are a few problems that users have encountered when first using Thuban.
      </para>
-     <variablelist>
+     <para>
-     <varlistentry>
+     <itemizedlist>
-     <term>After adding two or more layers nothing is being drawn in the
-     map window.
-     </term>
      <listitem>
+     <para>After adding two or more layers nothing is drawn in the map window.
+     </para>
      <para>
      This is probably because the layers have different projections. Projections
-     must be set on all layers and on the map itself if the layer's projections
+     must be set on all layers and on the map itself if the layers' projections
      are different.
      </para>
      </listitem>
-     </varlistentry>
-     <varlistentry>
-     <term>Thuban crashes on startup with the error
-         <literal>NameError: global name 'False' is not defined</literal>.
-     </term>
      <listitem>
+     <para>Thuban crashes on startup with the error
+         <literal>NameError: global name 'False' is not defined</literal>.
+     </para>
      <para>
      <varname>True</varname> and <varname>False</varname> were only introduced
      in Python 2.2.1. Thuban depends on at least Python 2.2.1.
      </para>
      </listitem>
-     </varlistentry>
-     <varlistentry>
+     <listitem>
-     <term>After compiling Thuban, Thuban crashes with an error similar to
+     <para>After compiling Thuban, Thuban crashes with an error similar to
          <literal>
          ImportError: /usr/local//lib/thuban/Thuban/../Lib/wxproj.so: undefined symbol: __gxx_personality_v0
          </literal>
-     </term>
+     </para>
-     <listitem>
      <para>
      Thuban depends on the wxWindows library. If Thuban is compiled with an
      incompatible version of the compiler than wxWindows was compiled with
-Line 1141
+Line 1242
      compiler.
      </para>
      </listitem>
-     </varlistentry>
+     </itemizedlist>
-     </variablelist>
+     </para>
+     <para>
+     If an error occurs Thuban will display a dialog indicating the error
+     before closing. The text should be copied and reported to the
+     <ulink url="http://thuban.intevation.org/bugtracker.html">
+     Intevation bugtracker
+     </ulink>.
+     More information about the system is available from
+     <menuchoice><guimenu>Help</guimenu><guimenuitem>About</guimenuitem></menuchoice> box.
+     This should also be included in the bug report.
+     <figure>
+     <title>Error Dialog</title>
+     <mediaobject>
+     <imageobject><imagedata fileref="../images/8_int_error.png" format="PNG" scale="&imgscale;"/></imageobject>
+     <imageobject><imagedata fileref="./images/8_int_error.eps" format="EPS" scale="&imgscale;"/></imageobject>
+     </mediaobject>
+     </figure>
+     </para>
    </chapter>
-Line 1166
+Line 1284
      </varlistentry>
      <varlistentry>
-     <term>dBASE file</term>
+     <term>dBase file</term>
      <listitem>
          <para>
-         dBASE files are used to store the attributes for each layer. This
+         dBase files are used to store the attributes for each layer. This
          is closely associated with the Shapefile format. For detailed
-         specifications on the correct format of a dBASE file used with
+         specifications on the correct format of a dBase file used with
          Thuban please see the Technical Specification for the Shapefile
          format above.
          </para>
      </listitem>
      </varlistentry>
+     <varlistentry>
+     <term>Raster files</term>
+     <listitem>
+         <para>
+         Binding the GDAL library Thuban supports numerous raster file formats,
+         see <ulink url="http://www.remotesensing.org/gdal/formats_list.html">
+         GDAL format list</ulink> for details.</para>
+         <para>Most commonly used is the <emphasis>TIFF/GeoTIFF</emphasis>
+         format: Raster maps are provided as TIFF images, with an additional
+         "world file" storing the geographic reference (usually with an
+         extension ".tfw").
+         </para>
+     </listitem>
+     </varlistentry>
      </variablelist>
    </appendix>
-Line 1186
+Line 1320
      The following types of projections are directly support by
      Thuban. The specific values for each are provided by the user
      to create custom projections. Thuban comes with predefined
-     projections and are available through the Projections dialog.
+     projections which are available through the Projections dialog.
+     </para>
+     <itemizedlist>
+     <listitem>
+         <para>Geographic</para>
+         <itemizedlist>
+         <listitem><para><literal>Ellipsoid</literal></para></listitem>
+         <listitem><para>
+                 <literal>Source Data</literal>: either Degrees or Radians
+                 </para></listitem>
+         </itemizedlist>
+     </listitem>
+     <listitem>
+         <para>Lambert Conic Conformal</para>
+     <itemizedlist>
+         <listitem><para><literal>Ellipsoid</literal></para></listitem>
+         <listitem><para><literal>Latitude of 1st standard parallel</literal></para></listitem>
+         <listitem><para><literal>Latitude of 2nd standard parallel</literal></para></listitem>
+         <listitem><para><literal>Central Meridian</literal></para></listitem>
+         <listitem><para><literal>Latitude of Origin</literal></para></listitem>
+         <listitem><para><literal>False Easting</literal> (meters)</para></listitem>
+         <listitem><para><literal>False Northing</literal> (meters)</para></listitem>
+     </itemizedlist>
+     </listitem>
+     <listitem>
+         <para>Transverse Mercator</para>
+     <itemizedlist>
+         <listitem><para><literal>Ellipsoid</literal></para></listitem>
+         <listitem><para><literal>Latitude</literal>of origin</para></listitem>
+         <listitem><para><literal>Longitude</literal>at central meridian</para></listitem>
+         <listitem><para><literal>Scale Factor</literal>at central meridian</para></listitem>
+         <listitem><para><literal>False Easting</literal> (meters)</para></listitem>
+         <listitem><para><literal>False Northing</literal> (meters)</para></listitem>
+     </itemizedlist>
+     </listitem>
+     <listitem>
+         <para>Universal Transverse Mercator</para>
+     <itemizedlist>
+         <listitem><para><literal>Ellipsoid</literal></para></listitem>
+         <listitem><para><literal>Zone</literal>
+                 (can be guessed appling the Propose button)</para></listitem>
+         <listitem><para><literal>Southern Hemisphere</literal> flag</para></listitem>
+     </itemizedlist>
+     </listitem>
+     </itemizedlist>
+     <para>
+     Thuban comes with a sample set of map projections for various
+     European countries. Apart from the basic projection they differ
+     especially in their parameterization:
+     </para>
+     <itemizedlist>
+     <listitem><para>Belgium Datum 1972 (Lambert Conic Conformal)</para>
+     </listitem>
+     <listitem><para>Gauss-Boaga Zone 1 (Italy, Transverse Mercartor)</para>
+     </listitem>
+     <listitem><para>Gauss-Krueger Zone 2 (Germany, Transverse Mercartor)
+     </para>
+     </listitem>
+     <listitem><para>Reseau Geodesique Francaise
+     (France, Lambert Conic Conformal)</para>
+     </listitem>
+     <listitem><para>UK National Grid (United Kingdom, Transverse Mercartor)
+     </para>
+     </listitem>
+     </itemizedlist>
+     <para>
+     Thuban uses the comprehensive PROJ library for projections. PROJ provides
+     more than the four commonly used projections described above. If needed
+     Thuban can be easily extended to a new projection covered by PROJ.
      </para>
-     <variablelist>
-     <varlistentry>
-     <term>Geographic</term>
-     <listitem><para></para></listitem>
-     </varlistentry>
-     <varlistentry>
-     <term>Lambert Conic Conformal</term>
-     <listitem><para></para></listitem>
-     </varlistentry>
-     <varlistentry>
-     <term>Transverse Mercator</term>
-     <listitem><para></para></listitem>
-     </varlistentry>
-     <varlistentry>
-     <term>Universal Transverse Mercator</term>
-     <listitem><para></para></listitem>
-     </varlistentry>
-     </variablelist>
    </appendix>
  </book>

 Legend:



Removed from v.1491
 


changed lines


 
Added in v.1544
 Legend:



Removed from v.1491
 


changed lines


 
Added in v.1544
-Removed from v.1491
+Added in v.1544

[email protected]	ViewVC Help
Powered by ViewVC 1.1.26