/[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 1473 by jonathan, Thu Jul 24 09:05:11 2003 UTC revision 1478 by frank, Thu Jul 24 17:00:25 2003 UTC
# Line 12  Line 12 
12      <author>      <author>
13        <firstname>Jan-Oliver</firstname><surname>Wagner</surname>        <firstname>Jan-Oliver</firstname><surname>Wagner</surname>
14      </author>      </author>
15        <author>
16          <firstname>Frank</firstname><surname>Koormann</surname>
17        </author>
18      <copyright>      <copyright>
19        <year>2003</year>        <year>2003</year>
20        <holder>Intevation GmbH</holder>        <holder>Intevation GmbH</holder>
# Line 569  Line 572 
572    
573    <chapter><title>Projection Management</title>    <chapter><title>Projection Management</title>
574      <para>      <para>
575      </para>      Projections control how the geographic data is displayed on the screen.
576          <section><title>Selecting a Projection</title><para/></section>      If multiple layers are loaded into Thuban where the geographic data
577          <section><title>Creating a Projection</title><para/></section>      is in a different projection system, then the user must tell Thuban
578          <section><title>Editing a Projection</title><para/></section>      which projection each layer has. The user must also tell Thuban which
579          <section><title>Importing/Exporting Projections</title><para/></section>      projection the map is in. This can be the same as the layers or a different
580        projection in which case the layers are reprojected into that space.
581        The map projection can be set using
582        <menuchoice>
583        <guimenu>Map</guimenu>
584        <guimenuitem>Projection</guimenuitem>
585        </menuchoice> and the layer projection can be set using
586        <menuchoice>
587        <guimenu>Layer</guimenu>
588        <guimenuitem>Projection</guimenuitem>
589        </menuchoice>.
590        </para>
591        <para>
592        Thuban is distributed with a sample collection of projections. The
593        user can create new projections and make them available to all
594        future Thuban sessions. They may also be exported and imported so
595        that custom projections can be distributed to others.
596        </para>
597            <section><title>Selecting a Projection</title>
598            <para>
599            The available projections are listed on the left. If the layer
600            or map already has a projection it will be initially highlighted
601            and will end with <varname>(current)</varname>. Selecting
602            <varname>None</varname> will cause Thuban to use the data as
603            it appears in the source file and will not use a projection.
604            </para>
605        </section>
606            <section><title>Editing a Projection</title>
607            <para>
608            Whenever a projection is selected from the list its properties
609            are displayed on the right. These properties can be changed
610            and the changes saved to the selected projection using
611            the <guibutton>Update</guibutton>. Only a projection that comes
612            from a file can be updated, so if the current layer's projection
613            is selectd, <guibutton>Update</guibutton> will be disabled.
614            The <guibutton>Add to List</guibutton> adds the projection to the
615            list of available projections as a new entry, and thus make it
616            available to future Thuban sessions. Clicking <guibutton>New</guibutton>
617            will create an entirely new, empty projection. The
618            <guibutton>Remove</guibutton> button will permanantly remove a
619            projection from the list of available projections.
620            </para>
621        </section>
622            <section><title>Importing/Exporting Projections</title>
623            <para>
624            The projections that appear in the list of available projections
625            can be exported to another file that the user chooses. By selecting
626            one or more projections and clicking <guibutton>Export</guibutton>
627            the user will be able to select a file to store those projections.
628            The file can then be distributed to other Thuban users. To import
629            a projection file the user can click <guibutton>Import</guibutton>.
630            The imported projections are added to the list and are then available
631            to the current session and any future Thuban session.
632            </para>
633        </section>
634    </chapter>    </chapter>
635    
636    <chapter><title>Table Management</title>    <chapter><title>Table Management</title>
637      <para>      <para>
638      </para>              Thuban distinguishes two different types of tables: Attribute tables
639                (which belong to a layer) and usual data tables. Both provide in
640            general the same functionality with the difference that actions on an
641                attribute table might also effect the map display.
642        </para>
643    
644        <section><title>Table View</title>
645          <para>
646            Thuban provides a standard dialog to display table contents, the
647            Table View. The view falls into five sections: The title, selections,
648            the table grid, export functions and the status bar.
649          </para>
650          <para>
651            The title bar identifies the table with it's name.
652          </para>
653          <para>
654            The functions box let the user perform simple analysis on the data
655            based on comparisons: First choice must be a field identifier of the
656            table, the second choice determines the type of comparison. The third
657            choice can be either a specific value (interpreted as numerical
658            or string depending on the type of the first field) or a second field
659            identifier. Thus you can perform analysis like selecting all
660            records where "population > 10000" or
661            "cars_per_habitants <  bike_per_habitants" (note that the field names
662            are only explanatory, the currently considered dbase files allow only
663            11 character field names).
664            
665            Selections can be combined, either by applying a selection only on
666            a previously selected set of records or by adding the results of a
667            selection to a previous set. The default is that a selection replaces
668            earlier results.
669          </para>
670          <para>
671            The table grid shows the contents of the table (a record per column),
672            with highlighted selection results. Columns and rows can be resized.
673          </para>
674          <para>
675            The contents of a table can be exported into a file, either dbase
676            format (DBF) or comma seperated values (CSV). The 'Export' button
677            raises a file dialog to specify a path and file name, the export type
678            is determined by the file extension (either .dbf or .csv).
679    
680            The 'Export Selection' button works similar but exports only the
681            selected records.
682    
683            The 'Close' button closes the table view. In difference to the
684            menu item 'Close' just the dialog is closed, the table is still loaded
685            in Thuban.
686          </para>
687          <para>
688            The status bar displays some statistics about the table and optional
689            selection results.
690          </para>
691        </section>
692    
693        <section><title>General Functionality (Menu Table)</title>
694          <para>
695            The general functions affect all tables open in Thuban. Attribute
696            tables are considered as here as usual data tables (with the exception
697            that they cannot be closed).
698          </para>
699          <section><title>Open</title>
700            <para>
701              The 'Open' item raises a file dialog to let you select a
702              dbase file from the file system to be loaded into Thuban read-only.
703              On OK the selected file is loaded and a table view is opened.
704            </para>
705          </section>
706    
707          <section><title>Close</title>
708            <para>
709              The 'Close' item raises a dialog listing the currently open
710              data tables (loaded via the 'Open' functionality'). You can select
711              tables which are dereferenced on confirmation. Since tables are
712              opened read-only the contents of the tables are not affected.
713    
714              A still open table view is closed as well.
715    
716              Tables used in a join can not be closed.
717            </para>
718          </section>
719    
720          <section><title>Rename</title>
721            <para>
722              Changes the table title.
723            </para>
724          </section>
725    
726          <section><title>Show</title>
727            <para>
728              The 'Show' item raises a list of available tables (explicitly loaded,           attribute tables, results of a join). Selected tables are show in
729              tables views on 'OK'.          
730            </para>
731          </section>
732    
733          <section><title>Join</title>
734            <para>
735              The 'Join' item raises a dialog to specify the two tables to be
736              joined. The join results in a new table named 'Join of "left table"
737              and "right table"'.
738    
739              The dialog let you select the two tables to be joined and the two
740              fields the join has to be performed on. By default the new
741              table contains only those records which are mathced by the join.
742    
743              If you want to preserve the records of the left table you can perform
744              an outer join. The fields from the right table for records not
745              matched by the join are filled with <varname>None</varname> in this
746              case.
747            </para>
748          </section>
749    
750        </section>
751        <section><title>Attribute Tables</title>
752        <para>
753                To clearly separate between both types, Thuban provides functionality
754                regarding the attribute tables under the Layer menu.
755        </para>
756    
757          <section><title>Show Table</title>
758            <para>
759              Opens the attribute table of the currently active layer in a table
760              view.
761    
762              In addition to the functionality described above selections
763              affect also the map display: objects related to selected records
764              are highlighted.
765            </para>
766          </section>
767    
768          <section><title>Join Table</title>
769            <para>
770               In difference to the join described above the join results not in a
771                new table. The attribute table of the currently active layer is the
772                left table and other tables are join to this table. Results of the
773                join in turn are available for classifications.
774    
775                As a consequence of the above the join cannot result in less
776                records than the source attribute table. You are warned if the
777                right table does not fulfill this constraint. Use an outer join
778                in such cases.
779            </para>
780          </section>
781    
782          <section><title>Unjoin Table</title>
783            <para>
784                As said above, a usual table can not be closed while still used in
785                a join. While the join table resulting from a join of usual tables
786                can be simply closed (and therewith dereferences the source tables)
787                this is not possible for attribute tables.
788    
789                Hence joins on attribute tables must be solved explicitely. This is
790                what the 'Unjoin' item is used for: The last join for the currently
791                active layer is solved.
792            </para>
793          </section>
794    
795        </section>
796    </chapter>    </chapter>
797    
798    <chapter><title>Trouble Shooting</title>    <chapter><title>Trouble Shooting</title>
# Line 589  Line 803 
803    <appendix><title>Supported Data Sources</title>    <appendix><title>Supported Data Sources</title>
804      <para>      <para>
805      </para>      </para>
806        <variablelist>
807        <varlistentry>
808        <term>Shapefile</term>
809        <listitem><para></para></listitem>
810        </varlistentry>
811    
812        <varlistentry>
813        <term>DB2 file</term>
814        <listitem><para></para></listitem>
815        </varlistentry>
816    
817        </variablelist>
818    </appendix>    </appendix>
819    
820    <appendix><title>Supported Projections</title>    <appendix><title>Supported Projections</title>
821      <para>      <para>
822      </para>      </para>
823        <variablelist>
824        <varlistentry>
825        <term>Geographic</term>
826        <listitem><para>Geographic</para></listitem>
827        </varlistentry>
828        <varlistentry>
829        <term>Lambert Conic Conformal</term>
830        <listitem><para>Lambert Conic Conformal</para></listitem>
831        </varlistentry>
832        <varlistentry>
833        <term>Transverse Mercator</term>
834        <listitem><para>Transverse Mercator</para></listitem>
835        </varlistentry>
836        <varlistentry>
837        <term>Universal Transverse Mercator</term>
838        <listitem><para>Universal Transverse Mercator</para></listitem>
839        </varlistentry>
840        </variablelist>
841    </appendix>    </appendix>
842    
843  </book>  </book>

Legend:
Removed from v.1473  
changed lines
  Added in v.1478

[email protected]
ViewVC Help
Powered by ViewVC 1.1.26