/[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 1490 by jonathan, Mon Jul 28 12:59:47 2003 UTC revision 1507 by frank, Tue Jul 29 14:30:19 2003 UTC
# Line 101  Line 101 
101          The tool bar provides quick access to the commonly needed tools.          The tool bar provides quick access to the commonly needed tools.
102          By hovering over each button the user can see a short messages          By hovering over each button the user can see a short messages
103          describing what the tool does. The tools provided are Zoom In, Zoom          describing what the tool does. The tools provided are Zoom In, Zoom
104          Out, Pan, Full Extent, Full Layer Extent, Full Shape Extent, Indentify,          Out, Pan, Full Extent, Full Layer Extent, Full Shape Extent, Identify,
105          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
106          in the manual.          in the manual.
107          </para>          </para>
# Line 149  Line 149 
149          <guimenu>File</guimenu>          <guimenu>File</guimenu>
150          <guimenuitem>Save Session</guimenuitem>          <guimenuitem>Save Session</guimenuitem>
151          </menuchoice>. A dialog box will open allowing the user to browse          </menuchoice>. A dialog box will open allowing the user to browse
152          the filesystem and select a place to save the session. Thuban          the file system and select a place to save the session. Thuban
153          sessions should be saved under a name ending in          sessions should be saved under a name ending in
154          <varname>.thuban</varname>. If the file already exists the user          <varname>.thuban</varname>. If the file already exists the user
155          will be prompted to save under a different name or overwrite the          will be prompted to save under a different name or overwrite the
# Line 211  Line 211 
211          <para>          <para>
212          There are two types of layers that can use added to a map: shape layers          There are two types of layers that can use added to a map: shape layers
213          and image layers. Shape layers are stored in Shapefile format, a          and image layers. Shape layers are stored in Shapefile format, a
214          standard file format for storing geographic objects. Normally, these          standard file format for storing geographic objects. These
215          files have the extension ``.shp''. Associated with          files have the extension ``.shp''. Associated with
216          the object information is a database file which stores attributes for          the shape file is a database file which stores attributes for
217          each shape in the Shapefile. This file, stored in dBASE format, usually          each shape in the shape file. This file, in dBase format,
218          has the extension ``.dbf''. Both files should have the same base name.          has the extension ``.dbf''. Both files must have the same base name.
219          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
220          also be a file roads.dbf.          also be a file roads.dbf.
221          </para>          </para>
222          <para>          <para>
# Line 226  Line 226 
226          <guimenuitem>Add Layer</guimenuitem>          <guimenuitem>Add Layer</guimenuitem>
227          </menuchoice>.          </menuchoice>.
228          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
229          matter if the Shapefile or database file is selected.          matter if the shape file or database file is selected.
230          </para>          </para>
231    
232          <para>          <para>
# Line 236  Line 236 
236          <guimenuitem>Add Image Layer</guimenuitem>          <guimenuitem>Add Image Layer</guimenuitem>
237          </menuchoice>.          </menuchoice>.
238          It is important to select a valid image file that has geographic          It is important to select a valid image file that has geographic
239          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,
240          or in another file. If geographic information cannot be found, Thuban          or in another file. If geographic information cannot be found, Thuban
241          will report an error.          will report an error.
242          </para>          </para>
# Line 245  Line 245 
245          <section><title>Navigation</title>          <section><title>Navigation</title>
246          <para>          <para>
247          The map can be explored by using the navigation tools available on          The map can be explored by using the navigation tools available on
248          the tool bar, or from the          the tool bar or from the
249          <menuchoice><guimenu>Map</guimenu></menuchoice> menu.          <menuchoice><guimenu>Map</guimenu></menuchoice> menu.
250          </para>          </para>
251          <para>          <para>
# Line 259  Line 259 
259          </imageobject>          </imageobject>
260          <textobject> <phrase>ZoomIn Tool</phrase> </textobject>          <textobject> <phrase>ZoomIn Tool</phrase> </textobject>
261          </inlinemediaobject>          </inlinemediaobject>
262          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
263          will double the magnification and center the map on the point that          will double the magnification and center the map on the point that
264          was clicked. Clicking and dragging lets the user select a region          was clicked. Clicking and dragging selects a region that will
265          to be enlarged to fit the window.          enlarged to fit the window.
266          </para>          </para>
267          <para>          <para>
268          The ZoomOut tool          The ZoomOut tool
# Line 357  Line 357 
357          </para>          </para>
358          </section>          </section>
359    
360          <section><title>Object Labelling</title>          <section><title>Object Labeling</title>
361          <para>          <para>
362          Objects can be labelled using the Label tool          Objects can be labeled using the Label tool
363          <inlinemediaobject>          <inlinemediaobject>
364          <imageobject>          <imageobject>
365          <imagedata fileref="../images/3_3_label.png" format="PNG" scale="&imgscale;"/>          <imagedata fileref="../images/3_3_label.png" format="PNG" scale="&imgscale;"/>
# Line 371  Line 371 
371          </inlinemediaobject>.          </inlinemediaobject>.
372          Clicking on an object selects that object and opens a dialog which          Clicking on an object selects that object and opens a dialog which
373          displays the table attributes for that object. An attribute can          displays the table attributes for that object. An attribute can
374          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
375          object that already has a label will remove the label.          at the center of the shape. Clicking on an object that already has
376            a label will remove the label.
377          </para>          </para>
378          </section>          </section>
379    
# Line 400  Line 401 
401          <para>          <para>
402          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
403          to some of the layer manipulation options under          to some of the layer manipulation options under
404          <menuchoice> <guimenu>Map</guimenu> </menuchoice>.          <menuchoice><guimenu>Map</guimenu></menuchoice>.
405            </para>
406    
407            <para>
408            The Move Layer to Top tool
409            <inlinemediaobject>
410            <imageobject>
411            <imagedata fileref="../images/3_5_totop.png" format="PNG" scale="&imgscale;"/>
412            </imageobject>
413            <imageobject>
414            <imagedata fileref="./images/3_5_totop.eps" format="EPS" scale="&imgscale;"/>
415            </imageobject>
416            <textobject> <phrase>Move Layer to Top</phrase> </textobject>
417            </inlinemediaobject> raises the selected layer to the top of the map.
418            </para>
419    
420            <para>
421            The Move Layer Up tool
422            <inlinemediaobject>
423            <imageobject>
424            <imagedata fileref="../images/3_5_moveup.png" format="PNG" scale="&imgscale;"/>
425            </imageobject>
426            <imageobject>
427            <imagedata fileref="./images/3_5_moveup.eps" format="EPS" scale="&imgscale;"/>
428            </imageobject>
429            <textobject> <phrase>Move Layer Up</phrase> </textobject>
430            </inlinemediaobject> raises the selected layer one level.
431            </para>
432    
433            <para>
434            The Move Layer Down tool
435            <inlinemediaobject>
436            <imageobject>
437            <imagedata fileref="../images/3_5_movedown.png" format="PNG" scale="&imgscale;"/>
438            </imageobject>
439            <imageobject>
440            <imagedata fileref="./images/3_5_movedown.eps" format="EPS" scale="&imgscale;"/>
441            </imageobject>
442            <textobject> <phrase>Move Layer Down</phrase> </textobject>
443            </inlinemediaobject> lowers the selected layer one level.
444            </para>
445    
446            <para>
447            The Move Layer to Bottom tool
448            <inlinemediaobject>
449            <imageobject>
450            <imagedata fileref="../images/3_5_tobottom.png" format="PNG" scale="&imgscale;"/>
451            </imageobject>
452            <imageobject>
453            <imagedata fileref="./images/3_5_tobottom.eps" format="EPS" scale="&imgscale;"/>
454            </imageobject>
455            <textobject> <phrase>Move Layer to Bottom</phrase> </textobject>
456            </inlinemediaobject> lowers the selected layer to the bottom of the map.
457            </para>
458    
459            <para>
460            The Visible tool
461            <inlinemediaobject>
462            <imageobject>
463            <imagedata fileref="../images/3_5_visible.png" format="PNG" scale="&imgscale;"/>
464            </imageobject>
465            <imageobject>
466            <imagedata fileref="./images/3_5_visible.eps" format="EPS" scale="&imgscale;"/>
467            </imageobject>
468            <textobject> <phrase>Visible</phrase> </textobject>
469            </inlinemediaobject> shows the selected layer in the map if it was
470            hidden.
471            </para>
472    
473            <para>
474            The Invisible tool
475            <inlinemediaobject>
476            <imageobject>
477            <imagedata fileref="../images/3_5_invisible.png" format="PNG" scale="&imgscale;"/>
478            </imageobject>
479            <imageobject>
480            <imagedata fileref="./images/3_5_invisible.eps" format="EPS" scale="&imgscale;"/>
481            </imageobject>
482            <textobject> <phrase>Invisible</phrase> </textobject>
483            </inlinemediaobject> hides the selected layer in the map.
484            </para>
485    
486            <para>
487            The Properties tool
488            <inlinemediaobject>
489            <imageobject>
490            <imagedata fileref="../images/3_5_props.png" format="PNG" scale="&imgscale;"/>
491            </imageobject>
492            <imageobject>
493            <imagedata fileref="./images/3_5_props.eps" format="EPS" scale="&imgscale;"/>
494            </imageobject>
495            <textobject> <phrase>Properties</phrase> </textobject>
496            </inlinemediaobject> opens the layer's properties dialog box.
497          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
498          properties dialog for that layer.          properties dialog for that layer.
499          </para>          </para>
# Line 445  Line 537 
537          image layers. Shape layers consist of vector based shapes with          image layers. Shape layers consist of vector based shapes with
538          geo-referenced coordinates. There are three types of supported          geo-referenced coordinates. There are three types of supported
539          shapes: polygons, lines, and points. Image layers can be any image          shapes: polygons, lines, and points. Image layers can be any image
540          file format supported by GDAL. The images must have geographic          file format supported by the Geo-spatial Data Abstraction Library
541          coordinate data either embedded within the file, or in a seperate          (GDAL). The images must have geographic
542            coordinate data either embedded within the file or in a separate
543          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
544          work very well with Thuban and were designed specifically to be image          work very well with Thuban and were designed specifically to be image
545          layers in GIS programs.          layers in GIS programs.
# Line 462  Line 555 
555          <guimenuitem>Properties</guimenuitem>          <guimenuitem>Properties</guimenuitem>
556          </menuchoice> opens a dialog that displays a layer's properties.          </menuchoice> opens a dialog that displays a layer's properties.
557          All layers have a title and it can be modified in the text field          All layers have a title and it can be modified in the text field
558          provided. The type of layer is also shows. If the type is type          provided. The type of layer is also shows. If the type is a type
559          of shape (polygon, arc, point) the classification table will be          of shape (polygon, arc, point) the classification table will be
560          shown. Image layers have no other properties other than title          shown. Image layers have no other properties other than title
561          and type.          and type.
# Line 496  Line 589 
589          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.
590          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
591          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
592          each time the map is changed. Each layer can be independently          all the layers each time the map is changed. Each layer can be
593          turned on or off using the          independently turned on or off using the
594          <menuchoice>          <menuchoice>
595          <guimenu>Layer</guimenu>          <guimenu>Layer</guimenu>
596          <guimenuitem>Show</guimenuitem>          <guimenuitem>Show</guimenuitem>
# Line 519  Line 612 
612          <guimenuitem>Duplicate</guimenuitem>          <guimenuitem>Duplicate</guimenuitem>
613          </menuchoice>. Duplicating a layer is useful if the user wishes          </menuchoice>. Duplicating a layer is useful if the user wishes
614          to model a layer in several different ways. Even though the layers          to model a layer in several different ways. Even though the layers
615          overlap by carefully selecting the shape properties it is possible          overlap, by carefully selecting the shape properties it is possible
616          to display several pieces of information at once. For example, one          to display several pieces of information at once. For example, one
617          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
618          another copy may be classified on a type property. if the length          another copy may be classified on a type property. If the length
619          property was expressed with color and the type property expressed          property was expressed with color and the type property expressed
620          with line thickness then it would be possible to view both          with line thickness then it would be possible to view both
621          classifications by placing the type property copy over the          classifications by placing the type property copy over the
# Line 540  Line 633 
633      cannot be classified.      cannot be classified.
634      </para>      </para>
635      <para>      <para>
636      A classification consists of a number of groups, with each group      A classification consists of a number of groups, each group
637      having a value or range of values to match against, and symbol      having a value or range of values to match against, and symbol
638      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
639      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 554  Line 647 
647      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
648      map, a default classification is created with the DEFAULT group. This      map, a default classification is created with the DEFAULT group. This
649      group cannot be removed. Every shape in the layer, regardless of its      group cannot be removed. Every shape in the layer, regardless of its
650      attributes, will match this group.      attributes, will match this group if no other group matches.
651      </para>      </para>
652    
653          <section><title>Editing Classifications</title>          <section><title>Editing Classifications</title>
# Line 585  Line 678 
678          The order of the groups in the classification is significant          The order of the groups in the classification is significant
679          except for the DEFAULT group, which remains at the top. When shapes          except for the DEFAULT group, which remains at the top. When shapes
680          are matched against groups the matching begins at the first group          are matched against groups the matching begins at the first group
681          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
682          be checked first. Matching for a          be checked first. Matching for a
683          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
684          use <guibutton>Move Up</guibutton> and <guibutton>Move Down</guibutton>          use <guibutton>Move Up</guibutton> and <guibutton>Move Down</guibutton>
685          to change the order of the groups. The DEFAULT group will always          to change the order of the groups. The DEFAULT group will always
686          match a shape that hasn't matched another group.          match a shape that hasn't matched another group.
687          </para>          </para>
688          <para>              <section><title>Visible</title>
689          The Value column of the classification table is the value that will              <para>
690          be matched when the map is being drawn. The type of data that can              The Visible column has check-boxes that determine whether a
691          entered into this field depends on the type of data of the              classification group will be displayed in the legend. This is
692          classification field.              useful if the user knows that the groups completely cover
693          </para>              the data set and don't want the DEFAULT group to be displayed
694          <para>              in the legend and on a printout.
695          If the field is of type Text, anything entered              </para>
696          into the field is valid. The text will be compared literally to the          </section>
697          value of the shape attribute, including case sensitivity.              <section><title>Symbols</title>
698          If the type is Integer, then any valid integer may be entered. In              <para>
699          addition, with special syntax, a range of values can be entered.              Each type of shape has its own type of symbol. Thuban supports three
700          A range from <varname>start</varname> to <varname>end</varname>              types of shapes: polygons, lines, and points. Polygons and points
701          inclusive is specifed like this: <literal>[start;end]</literal>.              have outline and fill color, while lines have only line color. Each
702          The exclusive range is specified like this:              group has associated symbol properties. To edit the symbol
703          <literal>]start;end[</literal>. Ranges can include infinity like              properties for a group the user can double click on the Symbol
704          this: <literal>[-oo;oo]</literal>. Field types can also be of type              column or select a group and click the
705          Decimal. They represent any rational number and can be used in ranges              <guibutton>Edit Symbol</guibutton> button.
706          as well.              </para>
707          </para>              </section>
708          </section>          <section><title>Value</title>
709                <para>
710          <section><title>Symbols</title>              The Value column of the classification table is the value that will
711          <para>              be matched when the map is being drawn. The type of data that can
712          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
713          types of shapes: polygons, lines, and points. Polygons and points have              classification field.
714          outline and fill color, while lines have only line color. Each group              </para>
715          has associated symbol properties. To edit the symbol properties for a              <para>
716          group the user can double click on the Symbol column or select a              If the field is of type Text, anything entered
717          group and click the <guibutton>Edit Symbol</guibutton> button.              into the field is valid. The text will be compared literally to the
718          </para>              value of the shape attribute, including case sensitivity.
719                If the type is Integer, then any valid integer may be entered. In
720                addition, with special syntax, a range of values can be entered.
721                A range from <varname>start</varname> to <varname>end</varname>
722                inclusive is specified like this: <literal>[start;end]</literal>.
723                The exclusive range is specified like this:
724                <literal>]start;end[</literal>. Ranges can include infinity like
725                this: <literal>[-oo;oo]</literal>. Field types can also be of type
726                Decimal. They represent any rational number and can be used in
727                ranges as well.
728                </para>
729                </section>
730                <section><title>Label</title>
731                <para>
732                By default, the text that is displayed for a group in the legend
733                is the value for that group. The label can substitute a more
734                descriptive term in the legend.
735                </para>
736            </section>
737          </section>          </section>
738    
739          <section><title>Generating Classes</title>          <section><title>Generating Classes</title>
# Line 643  Line 754 
754          classification at once while still giving the user control over          classification at once while still giving the user control over
755          how it appears. Clicking <guibutton>Generate Class</guibutton>          how it appears. Clicking <guibutton>Generate Class</guibutton>
756          opens the <varname>Generate Classification</varname> dialog.          opens the <varname>Generate Classification</varname> dialog.
757          Under the <varname>Generate</varname> pulldown there are at most          Under the <varname>Generate</varname> pull down there are at most
758          three different ways to generate classifications:          three different ways to generate classifications:
759          Unique Values, Unique Distribution, and Quantiles. Some options          Unique Values, Unique Distribution, and Quantiles. Some options
760          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
761          support them. For instance, <varname>Unique Distribution</varname>          support them. For instance, <varname>Unique Distribution</varname>
762          doesn't make sense for a Text field.          doesn't make sense for a Text field.
763          </para>          </para>
# Line 678  Line 789 
789          automatically recalculate how many groups is appropriate.          automatically recalculate how many groups is appropriate.
790          </para>          </para>
791          <para>          <para>
792          The Quantiles option generates ranges based on the number items          The Quantiles option generates ranges based on the number of items
793          in the input set. For example, by specifying 5 groups Thuban will          in the input set. For example, by specifying five groups Thuban will
794          generate groups with appropriate ranges such that 20% of the table          generate five groups with appropriate ranges such that 20% of the table
795          data is in each group. If it is impossible to generate exact          data is in each group. If it is impossible to generate exact
796          grouping, Thuban will issue a warning but allow the user to continue.          groupings, Thuban will issue a warning but allow the user to continue.
797          </para>          </para>
798          </section>          </section>
799    </chapter>    </chapter>
# Line 691  Line 802 
802      <para>      <para>
803      Projections control how the geographic data is displayed on the screen.      Projections control how the geographic data is displayed on the screen.
804      If multiple layers are loaded into Thuban where the geographic data      If multiple layers are loaded into Thuban where the geographic data
805      is in a different projection system, then the user must tell Thuban      is in a different projection system, then the user must specify a
806      which projection each layer has. The user must also tell Thuban which      projection for each layer. The user must also tell Thuban which
807      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
808      projection in which case the layers are reprojected into that space.      projection in which case the layers are reprojected into that space.
809      The map projection can be set using      The map projection can be set using
# Line 718  Line 829 
829      Thuban is distributed with a sample collection of projections. The      Thuban is distributed with a sample collection of projections. The
830      user can create new projections and make them available to all      user can create new projections and make them available to all
831      future Thuban sessions. They may also be exported and imported so      future Thuban sessions. They may also be exported and imported so
832      that custom projections can be distributed to others.      that custom projections can be distributed.
833      </para>      </para>
834          <section><title>Selecting a Projection</title>          <section><title>Selecting a Projection</title>
835          <para>          <para>
836          The available projections are listed on the left. If the layer          The available projections are listed on the left. If the layer
837          or map already has a projection it will be initially highlighted          or map already has a projection it will initially be highlighted
838          and will end with <varname>(current)</varname>. Selecting          and will end with <varname>(current)</varname>. Selecting
839          <varname>&lt;None&gt;</varname> will cause Thuban to use the data as          <varname>&lt;None&gt;</varname> will cause Thuban to use the data as
840          it appears in the source file and will not use a projection.          it appears in the source file and will not use a projection.
# Line 734  Line 845 
845          Whenever a projection is selected from the list its properties          Whenever a projection is selected from the list its properties
846          are displayed on the right. These properties can be changed          are displayed on the right. These properties can be changed
847          and the changes saved to the selected projection using          and the changes saved to the selected projection using
848          the <guibutton>Update</guibutton>. Only a projection that comes          <guibutton>Update</guibutton>. Only a projection that comes
849          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
850          is selectd, <guibutton>Update</guibutton> will be disabled.          is selected, <guibutton>Update</guibutton> will be disabled.
851          The <guibutton>Add to List</guibutton> adds the projection to the          <guibutton>Add to List</guibutton> adds the projection to the
852          list of available projections as a new entry, and thus make it          list of available projections as a new entry, and thus makes it
853          available to future Thuban sessions. Clicking <guibutton>New</guibutton>          available to future Thuban sessions. Clicking <guibutton>New</guibutton>
854          will create an entirely new, empty projection. The          will create an entirely new, empty projection. The
855          <guibutton>Remove</guibutton> button will permanantly remove a          <guibutton>Remove</guibutton> button will permanently remove a
856          projection from the list of available projections.          projection from the list of available projections.
857          </para>          </para>
858      </section>      </section>
# Line 750  Line 861 
861          The projections that appear in the list of available projections          The projections that appear in the list of available projections
862          can be exported to another file that the user chooses. By selecting          can be exported to another file that the user chooses. By selecting
863          one or more projections and clicking <guibutton>Export</guibutton>          one or more projections and clicking <guibutton>Export</guibutton>
864          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
865            projections.
866          The file can then be distributed to other Thuban users. To import          The file can then be distributed to other Thuban users. To import
867          a projection file the user can click <guibutton>Import</guibutton>.          a projection file the user can click <guibutton>Import</guibutton>.
868          The imported projections are added to the list and are then available          The imported projections are added to the list and are then available
869          to the current session and any future Thuban session.          to the current session and any future Thuban sessions.
870          </para>          </para>
871      </section>      </section>
872    </chapter>    </chapter>
# Line 762  Line 874 
874    <chapter><title>Table Management</title>    <chapter><title>Table Management</title>
875      <para>      <para>
876      Thuban distinguishes two different types of tables: Attribute tables      Thuban distinguishes two different types of tables: Attribute tables
877      (which belong to a layer) and usual data tables. Both provide in      (which belong to a layer) and normal data tables. Both provide
878          general the same functionality with the difference that actions on an          the same general functionality with the difference that actions on an
879      attribute table might also effect the map display.      attribute table might also effect the map display.
880      </para>      </para>
881    
# Line 781  Line 893 
893          </para>          </para>
894          <para>          <para>
895          Thuban provides a standard dialog to display table contents, the          Thuban provides a standard dialog to display table contents, the
896          Table View. The view falls into five sections: The title, selections,          Table View. The view falls has five sections: The title, selections,
897          the table grid, export functions and the status bar.          the table grid, export functions, and the status bar.
898          </para>          </para>
899          <para>          <para>
900          The title bar identifies the table with it's name.          The title bar identifies the table with its name.
901          </para>          </para>
902          <para>          <para>
903          The functions box let the user perform simple analysis on the data          The selections box let the user perform simple analysis on the data
904          based on comparisons: First choice must be a field identifier of the          based on comparisons: The first choice must be a field identifier of
905          table, the second choice determines the type of comparison. The third          the table, the second choice determines the type of comparison. The
906          choice can be either a specific value (interpreted as numerical          third choice can be either a specific value (interpreted as numerical
907          or string depending on the type of the first field) or a second field          or string depending on the type of the first field) or a second field
908          identifier. Thus you can perform analysis like selecting all          identifier. Thus you can perform analysis like selecting all
909          records where "population > 10000" or          records where "population > 10000" or
910          "cars_per_habitants <  bike_per_habitants" (note that the field names          "cars_per_inhabitant <  bikes_per_inhabitant" (note that the field names
911          are only explanatory, the currently considered dBASE files allow only          are only explanatory, the dBase files allow only
912          11 character field names).          11 character field names).
913                
914          Selections can be combined, either by applying a selection only on          Selections can be combined either by applying a selection only on
915          a previously selected set of records or by adding the results of a          a previously selected set of records or by adding the results of a
916          selection to a previous set. The default is that a selection replaces          selection to a previous set. The default is that a selection replaces
917          earlier results.          earlier results.
# Line 809  Line 921 
921          with highlighted selection results. Columns and rows can be resized.          with highlighted selection results. Columns and rows can be resized.
922          </para>          </para>
923          <para>          <para>
924          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
925          format (DBF) or comma seperated values (CSV). The          format (DBF) or comma separated values (CSV). The
926          <guibutton>Export</guibutton> button          <guibutton>Export</guibutton> button
927          raises a file dialog to specify a path and file name, the export type          raises a file dialog to specify a path and file name, the export type
928          is determined by the file extension (either .dbf or .csv).          is determined by the file extension (either .dbf or .csv).
# Line 834  Line 946 
946      <section><title>General Functionality (Menu Table)</title>      <section><title>General Functionality (Menu Table)</title>
947          <para>          <para>
948          The general functions affect all tables open in Thuban. Attribute          The general functions affect all tables open in Thuban. Attribute
949          tables are considered here as usual data tables (with the exception          tables are considered here as normal data tables (with the exception
950          that they cannot be closed).          that they cannot be closed).
951          </para>          </para>
952          <section><title>Open</title>          <section><title>Open</title>
# Line 845  Line 957 
957              <guimenuitem>Open</guimenuitem>              <guimenuitem>Open</guimenuitem>
958              </menuchoice>              </menuchoice>
959              item raises a file dialog to let you select a              item raises a file dialog to let you select a
960              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.
961              On OK the selected file is loaded and a table view is opened.              On <guibutton>OK</guibutton> the selected file is loaded and a
962                table view is opened.
963              </para>              </para>
964          </section>          </section>
965    
# Line 867  Line 980 
980              Since tables are opened read-only the contents of the tables are              Since tables are opened read-only the contents of the tables are
981              not affected.              not affected.
982    
983              A still open table view is closed as well.              Any open views of the tables are closed as well.
984    
985              Tables used in a join cannot be closed.              Tables used in a join cannot be closed.
986              </para>              </para>
# Line 891  Line 1004 
1004              </menuchoice>              </menuchoice>
1005              item raises a list of available tables (explicitly              item raises a list of available tables (explicitly
1006              loaded, attribute tables, results of a join). Selected tables are              loaded, attribute tables, results of a join). Selected tables are
1007              show in tables views on <guibutton>OK</guibutton>              show in tables views on <guibutton>OK</guibutton>.
1008              </para>              </para>
1009          </section>          </section>
1010    
# Line 917  Line 1030 
1030              joined. The join results in a new table named 'Join of "left table"              joined. The join results in a new table named 'Join of "left table"
1031              and "right table"'.              and "right table"'.
1032    
1033              The dialog let you select the two tables to be joined and the two              The dialog lets you select the two tables to be joined and the two
1034              fields the join has to be performed on. By default the new              fields the join has to be performed on. By default, the new
1035              table contains only those records which are mathced by the join.              table contains only those records which are matched by the join.
1036    
1037              If you want to preserve the records of the left table you can              If you want to preserve the records of the left table you can
1038              perform an outer join. The fields from the right table for records              perform an outer join. The fields from the right table for records
# Line 952  Line 1065 
1065    
1066          <section><title>Join Table</title>          <section><title>Join Table</title>
1067              <para>              <para>
1068              In difference to the join described above the join results not in a              Unlike the join described above, the join does not result in a
1069              new table. The attribute table of the currently active layer is the              new table. The attribute table of the currently active layer is the
1070              left table and other tables are joined to this table. The results of              left table and other tables are joined to this table. The results of
1071              the join are available for classifications.              the join are available for classification.
1072    
1073              As a consequence, the join cannot result in fewer              As a consequence, the join cannot result in fewer
1074              records than the source attribute table. The user is warned if the              records than the source attribute table. The user is warned if the
# Line 971  Line 1084 
1084              normal tables can be simply closed (and thereby dereferencing              normal tables can be simply closed (and thereby dereferencing
1085              the source tables), this is not possible for attribute tables.              the source tables), this is not possible for attribute tables.
1086    
1087              Hence joins on attribute tables must be solved explicitely. This is              Hence joins on attribute tables must be solved explicitly. This is
1088              what the              what the
1089              <menuchoice>              <menuchoice>
1090              <guimenu>Layer</guimenu>              <guimenu>Layer</guimenu>
# Line 1023  Line 1136 
1136      <listitem>      <listitem>
1137      <para>      <para>
1138      Thuban depends on the wxWindows library. If Thuban is compiled with an      Thuban depends on the wxWindows library. If Thuban is compiled with an
1139      incompatible version of the compiler that wxWindows was compiled with      incompatible version of the compiler than wxWindows was compiled with
1140      this error may occur. Try compiling with a different version of the      this error may occur. Try compiling with a different version of the
1141      compilere      compiler.
1142      </para>      </para>
1143      </listitem>      </listitem>
1144      </varlistentry>      </varlistentry>
# Line 1053  Line 1166 
1166      </varlistentry>      </varlistentry>
1167    
1168      <varlistentry>      <varlistentry>
1169      <term>dBASE file</term>      <term>dBase file</term>
1170      <listitem>      <listitem>
1171          <para>          <para>
1172          dBASE files are used to store the attributes for each layer. This          dBase files are used to store the attributes for each layer. This
1173          is closely associated with the Shapefile format. For detailed          is closely associated with the Shapefile format. For detailed
1174          specifications on the correct format of a dBASE file used with          specifications on the correct format of a dBase file used with
1175          Thuban please see the Technical Specification for the Shapefile          Thuban please see the Technical Specification for the Shapefile
1176          format above.          format above.
1177          </para>          </para>
# Line 1073  Line 1186 
1186      The following types of projections are directly support by      The following types of projections are directly support by
1187      Thuban. The specific values for each are provided by the user      Thuban. The specific values for each are provided by the user
1188      to create custom projections. Thuban comes with predefined      to create custom projections. Thuban comes with predefined
1189      projections and are available through the Projections dialog.      projections which are available through the Projections dialog.
1190      </para>      </para>
1191      <variablelist>      <variablelist>
1192      <varlistentry>      <varlistentry>
1193      <term>Geographic</term>          <term>Geographic</term>
1194      <listitem><para></para></listitem>          <listitem><para><literal>Ellipsoid</literal></para>
1195            <para><literal>Source Data</literal>: either Degrees or Radians
1196                    </para></listitem>
1197      </varlistentry>      </varlistentry>
1198      <varlistentry>      <varlistentry>
1199      <term>Lambert Conic Conformal</term>          <term>Lambert Conic Conformal</term>
1200      <listitem><para></para></listitem>          <listitem><para><literal>Ellipsoid</literal></para>
1201            <para><literal>Latitude of 1st standard parallel</literal></para>
1202            <para><literal>Latitude of 2nd standard parallel</literal></para>
1203            <para><literal>Central Meridian</literal></para>
1204            <para><literal>Latitude of Origin</literal></para>
1205            <para><literal>False Easting</literal> (meters)</para>
1206            <para><literal>False Northing</literal> (meters)</para></listitem>
1207      </varlistentry>      </varlistentry>
1208      <varlistentry>      <varlistentry>
1209      <term>Transverse Mercator</term>          <term>Transverse Mercator</term>
1210      <listitem><para></para></listitem>          <listitem><para><literal>Ellipsoid</literal></para>
1211            <para><literal>Latitude</literal>of origin</para>
1212            <para><literal>Longitude</literal>at central meridian</para>
1213            <para><literal>Scale Factor</literal>at central meridian</para>
1214            <para><literal>False Easting</literal> (meters)</para>
1215            <para><literal>False Northing</literal> (meters)</para></listitem>
1216      </varlistentry>      </varlistentry>
1217      <varlistentry>      <varlistentry>
1218      <term>Universal Transverse Mercator</term>          <term>Universal Transverse Mercator</term>
1219      <listitem><para></para></listitem>          <listitem><para><literal>Ellipsoid</literal></para>
1220            <para><literal>Zone</literal>
1221                    (can be guessed appling the Propose button)</para>
1222            <para><literal>Southern Hemisphere</literal> flag</para></listitem>
1223        </varlistentry>
1224        </variablelist>
1225        
1226        <para>
1227        Thuban comes with a sample set of map projections for various
1228        European countries. Apart from the basic projection they differ
1229        especially in their parameterization:
1230        </para>
1231        <variablelist>
1232        <varlistentry><term>Belgium Datum 1972 (Lambert Conic Conformal)</term>
1233            <listitem><para></para></listitem>
1234        </varlistentry>
1235    
1236        <varlistentry><term>Gauss-Boaga Zone 1 (Italy, Transverse Mercartor)</term>
1237            <listitem><para></para></listitem>
1238        </varlistentry>
1239    
1240        <varlistentry><term>Gauss-Krueger Zone 2 (Germany, Transverse Mercartor)
1241        </term>
1242            <listitem><para></para></listitem>
1243        </varlistentry>
1244    
1245        <varlistentry><term>Reseau Geodesique Francaise
1246        (France, Lambert Conic Conformal)</term>
1247            <listitem><para></para></listitem>
1248        </varlistentry>
1249    
1250        <varlistentry><term>UK National Grid (United Kingdom, Transverse Mercartor)
1251        </term>
1252            <listitem><para></para></listitem>
1253      </varlistentry>      </varlistentry>
1254      </variablelist>      </variablelist>
1255    
1256        <para>
1257        Thuban uses the comprehensive PROJ library for projections. PROJ provides
1258        more than the four commonly used projections described above. If needed
1259        Thuban can be easily extended to a new projection covered by PROJ.
1260        </para>
1261    </appendix>    </appendix>
1262    
1263  </book>  </book>
1264    
Legend:
Removed from v.1490  
changed lines
  Added in v.1507
[email protected]
 ViewVC Help
Powered by ViewVC 1.1.26