Doc/manual/thuban-manual.xml

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE book
        PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
        "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
<!-- $Revision$ -->
<book>
  <bookinfo>
    <title>Thuban Manual</title>
    <author>
      <firstname>Jonathan</firstname><surname>Coles</surname>
    </author>
    <author>
      <firstname>Jan-Oliver</firstname><surname>Wagner</surname>
    </author>
    <copyright>
      <year>2003</year>
      <holder>Intevation GmbH</holder>
    </copyright>
  </bookinfo>

  <chapter><title>Introduction</title>
    <para>
    Thuban is a Free Software Geographic Information Systems (GIS) viewer.
    It is being developed because there is currently 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 
    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
    geographic data and then explore that data through navigation and
    manipulation of how it is drawn. The results can then be saved or printed.
    </para>
    <para>
    Thuban arranges a session in a hierarchy. A session contains a map which
    consists of layers. Each layer represents one kind of data set. For 
    instance, there may be a layer for roads and another layer for buildings. 
    These layers can either be vector shapes or images.
    </para>

        <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 
        <ulink url="http://thuban.intevation.org/download.html">
        Thuban Download site
        </ulink>.
        </para>
        </section>

        <section><title>The Main Window</title>
        <para>
        <screenshot>
        <screeninfo>The Main Window</screeninfo>
        <mediaobject>
        <imageobject> <imagedata fileref="../images/1_2_mainwindow.png" format="PNG"/> </imageobject>
        <imageobject> <imagedata fileref="./images/1_2_mainwindow.ps" format="EPS"/> </imageobject>
        <textobject><phrase>The Main Window</phrase></textobject>
        <caption><para>The Main Window</para></caption>
        </mediaobject>
        </screenshot>
        </para>

        <para>
        The map window shows the current state of the map and is where
        the user can interact with the map using the tools. 
        </para>

        <para>
        The legend on the left displays a list of the current layers and 
        any visible classification groups. In the example, each shape layer 
        has a default classification which specifies how the shapes in each 
        layer are drawn. Layers that are higher in the list appear 
        ``closer'' to the user. The legend can be closed by clicking on the 
        small X in the upper right-hand region of the legend. 
        To open it again, use
        <menuchoice>
        <guimenu>Map</guimenu>
        <guimenuitem>Legend</guimenuitem>
        </menuchoice>.
        The legend is also dockable, which means that it can be detached 
        from the main window by clicking on the small button next to the 
        close button. It can be attached by clicking the same button
        again.
        </para>
        <para>
        The status bar displays different information depending on the
        current context. If the user is selecting an item from the menu
        then the status bar will display a short help message indicating
        what each menu item is for. If the user has a tool selected then
        the position of the cursor on the map is displayed.
        </para>
        <para>
        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,
        and Label. Each of the tools will be explained in further detail later
        in the manual.
        </para>
        </section>

  </chapter>

  <chapter><title>Session Management</title>

        <section><title>Starting a New Session</title>
        <para>
        A new session can be started from 
        <menuchoice>
        <guimenu>File</guimenu>
        <guimenuitem>New Session</guimenuitem>
        </menuchoice>.

        If a session is already loaded and has been modified without
        being saved a prompt will ask if the current session should
        be saved.

        </para>
        </section>

        <section><title>Opening a Session</title>
        <para>
        A session can be opened from 
        <menuchoice>
        <guimenu>File</guimenu>
        <guimenuitem>Open Session</guimenuitem>
        </menuchoice>.

        If a session is already loaded and has been modified without
        being saved a prompt will ask if the current session should
        be saved.
        </para>
        </section>

        <section><title>Saving a Session</title>
        <para>
        A session can be saved from 
        <menuchoice>
        <guimenu>File</guimenu>
        <guimenuitem>Save Session</guimenuitem>
        </menuchoice>.

        </para>
        </section>

        <section><title>The Session Info-Tree</title>
        <para>
                (primarily for developers)
        </para>
        </section>
  </chapter>

  <chapter><title>Map Management</title>
    <para>
    The map consists of a number of layers where each layer represents a
    different type of data set. By interacting with the map the user can
    visually explore the data. 
    </para>

        <section><title>Adding and Removing Layers</title>
        <para>
        There are two types of layers that can use added to a map: shape layers
        and image layers. Shape layers are stored in Shapefile format, a
        standard file format for storing geographic objects. Normally, these
        files have the extension ``.shp''. Associated with
        the object information is a database file which stores attributes for
        each shape in the Shapefile. This file, stored in DB2 format, usually
        has the extension ``.dbf''. Both files should have the same base name.
        For example, if there is a Shapefile named roads.shp there should
        also be a file roads.dbf.
        </para>
        <para>
        Shape layers can be added to the map with
        <menuchoice>
        <guimenu>Map</guimenu>
        <guimenuitem>Add Layer</guimenuitem>
        </menuchoice>.
        Thuban will load all files with the same base name, so it doesn't
        matter if the Shapefile or database file is selected.
        </para>

        <para>
        Image layers can be added to the map with
        <menuchoice>
        <guimenu>Map</guimenu>
        <guimenuitem>Add Image Layer</guimenuitem>
        </menuchoice>.
        It is important to select a valid image file that has geographic
        data associated with it. This can be embedded in the file itself, 
        or in another file. If geographic information cannot be found, Thuban 
        will report an error.
        </para>
        </section>

        <section><title>Navigation</title>
        <para>
        The map can be explored by using the navigation tools available on 
        the tool bar, or from the 
        <menuchoice><guimenu>Map</guimenu></menuchoice> menu. 
        </para>
        <para>
        The ZoomIn tool 
        <inlinemediaobject>
        <imageobject> 
        <imagedata fileref="../images/3_2_zoomin.png" format="PNG"/> 
        </imageobject>
        <textobject> <phrase>ZoomIn Tool</phrase> </textobject>
        </inlinemediaobject>
        can be used to enlarge 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 lets the user select a region
        to be enlarged to fit the window.
        </para>
        <para>
        The ZoomOut tool 
        <inlinemediaobject>
        <imageobject> 
        <imagedata fileref="../images/3_2_zoomout.png" format="PNG"/> 
        </imageobject>
        <textobject> <phrase>ZoomOut Tool</phrase> </textobject>
        </inlinemediaobject>
        shrinks the map so that a larger region is visible. A single click
        reduces the magnification by a factor of two. Clicking and dragging
        selects a box such that the current contents of the window will be
        scaled to fit into that box.
        </para>
        <para>
        The Pan tool 
        <inlinemediaobject>
        <imageobject> 
        <imagedata fileref="../images/3_2_pan.png" format="PNG"/> 
        </imageobject>
        <textobject> <phrase>Pan Tool</phrase> </textobject>
        </inlinemediaobject>
        allows the user to move the map around by clicking and dragging.
        </para>
        <para>
        The Full Extent tool 
        <inlinemediaobject>
        <imageobject> 
        <imagedata fileref="../images/3_2_fullextent.png" format="PNG"/> 
        </imageobject>
        <textobject> <phrase>Full Extent Tool</phrase> </textobject>
        </inlinemediaobject>
        rescales the viewable region so that the entire map is visible.
        </para>
        <para>
        The Full Layer Extent tool 
        <inlinemediaobject>
        <imageobject> 
        <imagedata fileref="../images/3_2_fulllayerextent.png" format="PNG"/> 
        </imageobject>
        <textobject> <phrase>Full Layer Extent Tool</phrase> </textobject>
        </inlinemediaobject>
        rescales the viewable region so that the currently selected
        layer fits within the window. If no layer is selected this button 
        will be disabled.
        </para>
        <para>
        The Full Shape Extent tool 
        <inlinemediaobject>
        <imageobject> 
        <imagedata fileref="../images/3_2_fullshapeextent.png" format="PNG"/> 
        </imageobject>
        <textobject> <phrase>Full Shape Extent Tool</phrase> </textobject>
        </inlinemediaobject>
        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.
        </para>
        </section>

        <section><title>Object Identification</title>
        <para>
        Objects on the map can be identified using the Identify tool
        <inlinemediaobject>
        <imageobject> 
        <imagedata fileref="../images/3_3_identify.png" format="PNG"/> 
        </imageobject>
        <textobject> <phrase>Identify Tool</phrase> </textobject>
        </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. 
        </para>
        </section>

        <section><title>Object Labelling</title>
        <para>
        Objects can be labelled using the Label tool
        <inlinemediaobject>
        <imageobject> 
        <imagedata fileref="../images/3_3_label.png" format="PNG"/> 
        </imageobject>
        <textobject> <phrase>Label Tool</phrase> </textobject>
        </inlinemediaobject>.
        Clicking on an object selects that object and opens a dialog which
        displays the table attributes for that object. An attribute can
        be selected to be the label on the map. Using this tool for an
        object that already has a label will remove the label.
        </para>
        </section>

        <section><title>The Legend</title>
        <para>
        The Legend provides an overview of the layers in the map. Layers
        that appear higher in the legend will appear ``closer'' to the user.
        If a layer supports classification (currently, only shape layers 
        have this feature) then the classification groups will be shown
        below each layer. The properties for each group are also displayed
        with a small graphic. Polygon layers appear as rectangles, lines
        appear as curved lines, and points appear as circles. 
        </para>
        <para>
        Along the top of the legend is a toolbar which allows quick access
        to some of the layer manipulation options under
        <menuchoice> <guimenu>Map</guimenu> </menuchoice>. 

        Double-clicking on a layer or a group of a layer will open the 
        properties dialog for that layer.
        </para>
        </section>

        <section><title>Printing</title>
        <para>
        The map can be printed using 
        <menuchoice>
        <guimenu>Map</guimenu>
        <guimenuitem>Print</guimenuitem>
        </menuchoice>. A standard printing dialog will open allowing the
        user to configure the printer.
        </para>
        </section>
  </chapter>

  <chapter><title>Layer Management</title>
    <para>
    </para>

        <section><title>Types of Layers</title>
        <para>
        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
        file format supported by GDAL. The images must have a geographic
        coordinate data either embedded within the file, or in a seperate
        file that is in the same directory as the image file used for the
        layer. GeoTIFF files work very well with Thuban and were designed
        specifically to be image layers in GIS programs.
        </para>
        </section>

        <section><title>Properties</title>
        <para>
        Each shape in a shape layer can have various properties which control 
        how it is drawn on the map. Polygons and points can be drawn with an
        outline color and a fill color, while lines have only a line color.
        </para>
        </section>

        <section><title>Visibility</title>
        <para>
        Sometimes it is not desirable to view all layers at the same time.
        Some layers may take a long time to draw and so while navigating
        around the map the user may not want to wait for the map to redraw
        each time the map is changed. Each layer can be independently
        turned on or off using the 
        <menuchoice>
        <guimenu>Layer</guimenu>
        <guimenuitem>Show</guimenuitem>
        </menuchoice>
        or
        <menuchoice>
        <guimenu>Layer</guimenu>
        <guimenuitem>Hide</guimenuitem>
        </menuchoice> options respectively.
        </para>
        </section>

        <section><title>Sequence</title>
        <para>
        </para>
        </section>

        <section><title>Duplication</title>
        <para>
        Layers and all their properties, including classifications, can
        be duplicated using 
        <menuchoice>
        <guimenu>Layer</guimenu>
        <guimenuitem>Duplicate</guimenuitem>
        </menuchoice>. Duplicating a layer is useful if the user wishes
        to model a layer in several different ways. Even though the layers
        overlap by carefully selecting the shape properties it is possible
        to display several pieces of information at once. For example, one
        copy of a roads layer may be classified on a length property and
        another copy may be classified on a type property. if the length
        property was expressed with color and the type property expressed
        with line thickness then it would be possible to view both
        classifications by placing the type property copy over the 
        length property copy.
        </para>
        </section>

  </chapter>

  <chapter><title>Layer Classifications</title>
    <para>
    </para>

        <section><title>Adding and Removing Classes</title>
        <para>
        </para>
        </section>

        <section><title>Symbols</title>
        <para>
        </para>
        </section>

        <section><title>Generating Classes</title>
        <para>
        </para>
        </section>
  </chapter>

  <chapter><title>Projection Management</title>
    <para>
    </para>
  </chapter>

  <chapter><title>Table Management</title>
    <para>
    </para>
  </chapter>

  <chapter><title>Trouble Shooting</title>
    <para>
    </para>
  </chapter>

  <appendix><title>Supported Data Sources</title>
    <para>
    </para>
  </appendix>

  <appendix><title>Supported Projections</title>
    <para>
    </para>
  </appendix>

</book>
1	<?xml version="1.0" encoding="ISO-8859-1"?>
2	<!DOCTYPE book
3	PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
4	"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
5	<!-- $Revision$ -->
6	<book>
7	<bookinfo>
8	<title>Thuban Manual</title>
9	<author>
10	<firstname>Jonathan</firstname><surname>Coles</surname>
11	</author>
12	<author>
13	<firstname>Jan-Oliver</firstname><surname>Wagner</surname>
14	</author>
15	<copyright>
16	<year>2003</year>
17	<holder>Intevation GmbH</holder>
18	</copyright>
19	</bookinfo>
20
21	<chapter><title>Introduction</title>
22	<para>
23	Thuban is a Free Software Geographic Information Systems (GIS) viewer.
24	It is being developed because there is currently no simple interactive
25	viewer for geographic information available as Free Software. Thuban is
26	written in Python and C++ and uses the wxWindows library allowing it to
27	run on many different platforms, including GNU/Linux and Windows.
28	</para>
29	<para>
30	GIS viewers are a necessary tool as they allow one to get a visual
31	impression of the positional relationship of the information that may not
32	be apparent from simple inspection of the data values themselves.
33	Thuban allows the user to create a session that displays
34	geographic data and then explore that data through navigation and
35	manipulation of how it is drawn. The results can then be saved or printed.
36	</para>
37	<para>
38	Thuban arranges a session in a hierarchy. A session contains a map which
39	consists of layers. Each layer represents one kind of data set. For
40	instance, there may be a layer for roads and another layer for buildings.
41	These layers can either be vector shapes or images.
42	</para>
43
44	<section><title>Installation</title>
45	<para>
46	Thuban is actively supported under Debian Testing (sarge), RedHat 7.2,
47	and Windows 2000. All the necessary files can be found on the
48	<ulink url="http://thuban.intevation.org/download.html">
49	Thuban Download site
50	</ulink>.
51	</para>
52	</section>
53
54	<section><title>The Main Window</title>
55	<para>
56	<screenshot>
57	<screeninfo>The Main Window</screeninfo>
58	<mediaobject>
59	<imageobject> <imagedata fileref="../images/1_2_mainwindow.png" format="PNG"/> </imageobject>
60	<imageobject> <imagedata fileref="./images/1_2_mainwindow.ps" format="EPS"/> </imageobject>
61	<textobject><phrase>The Main Window</phrase></textobject>
62	<caption><para>The Main Window</para></caption>
63	</mediaobject>
64	</screenshot>
65	</para>
66
67	<para>
68	The map window shows the current state of the map and is where
69	the user can interact with the map using the tools.
70	</para>
71
72	<para>
73	The legend on the left displays a list of the current layers and
74	any visible classification groups. In the example, each shape layer
75	has a default classification which specifies how the shapes in each
76	layer are drawn. Layers that are higher in the list appear
77	``closer'' to the user. The legend can be closed by clicking on the
78	small X in the upper right-hand region of the legend.
79	To open it again, use
80	<menuchoice>
81	<guimenu>Map</guimenu>
82	<guimenuitem>Legend</guimenuitem>
83	</menuchoice>.
84	The legend is also dockable, which means that it can be detached
85	from the main window by clicking on the small button next to the
86	close button. It can be attached by clicking the same button
87	again.
88	</para>
89	<para>
90	The status bar displays different information depending on the
91	current context. If the user is selecting an item from the menu
92	then the status bar will display a short help message indicating
93	what each menu item is for. If the user has a tool selected then
94	the position of the cursor on the map is displayed.
95	</para>
96	<para>
97	The tool bar provides quick access to the commonly needed tools.
98	By hovering over each button the user can see a short messages
99	describing what the tool does. The tools provided are Zoom In, Zoom
100	Out, Pan, Full Extent, Full Layer Extent, Full Shape Extent, Indentify,
101	and Label. Each of the tools will be explained in further detail later
102	in the manual.
103	</para>
104	</section>
105
106	</chapter>
107
108	<chapter><title>Session Management</title>
109
110	<section><title>Starting a New Session</title>
111	<para>
112	A new session can be started from
113	<menuchoice>
114	<guimenu>File</guimenu>
115	<guimenuitem>New Session</guimenuitem>
116	</menuchoice>.
117
118	If a session is already loaded and has been modified without
119	being saved a prompt will ask if the current session should
120	be saved.
121
122	</para>
123	</section>
124
125	<section><title>Opening a Session</title>
126	<para>
127	A session can be opened from
128	<menuchoice>
129	<guimenu>File</guimenu>
130	<guimenuitem>Open Session</guimenuitem>
131	</menuchoice>.
132
133	If a session is already loaded and has been modified without
134	being saved a prompt will ask if the current session should
135	be saved.
136	</para>
137	</section>
138
139	<section><title>Saving a Session</title>
140	<para>
141	A session can be saved from
142	<menuchoice>
143	<guimenu>File</guimenu>
144	<guimenuitem>Save Session</guimenuitem>
145	</menuchoice>.
146
147	</para>
148	</section>
149
150	<section><title>The Session Info-Tree</title>
151	<para>
152	(primarily for developers)
153	</para>
154	</section>
155	</chapter>
156
157	<chapter><title>Map Management</title>
158	<para>
159	The map consists of a number of layers where each layer represents a
160	different type of data set. By interacting with the map the user can
161	visually explore the data.
162	</para>
163
164	<section><title>Adding and Removing Layers</title>
165	<para>
166	There are two types of layers that can use added to a map: shape layers
167	and image layers. Shape layers are stored in Shapefile format, a
168	standard file format for storing geographic objects. Normally, these
169	files have the extension ``.shp''. Associated with
170	the object information is a database file which stores attributes for
171	each shape in the Shapefile. This file, stored in DB2 format, usually
172	has the extension ``.dbf''. Both files should have the same base name.
173	For example, if there is a Shapefile named roads.shp there should
174	also be a file roads.dbf.
175	</para>
176	<para>
177	Shape layers can be added to the map with
178	<menuchoice>
179	<guimenu>Map</guimenu>
180	<guimenuitem>Add Layer</guimenuitem>
181	</menuchoice>.
182	Thuban will load all files with the same base name, so it doesn't
183	matter if the Shapefile or database file is selected.
184	</para>
185
186	<para>
187	Image layers can be added to the map with
188	<menuchoice>
189	<guimenu>Map</guimenu>
190	<guimenuitem>Add Image Layer</guimenuitem>
191	</menuchoice>.
192	It is important to select a valid image file that has geographic
193	data associated with it. This can be embedded in the file itself,
194	or in another file. If geographic information cannot be found, Thuban
195	will report an error.
196	</para>
197	</section>
198
199	<section><title>Navigation</title>
200	<para>
201	The map can be explored by using the navigation tools available on
202	the tool bar, or from the
203	<menuchoice><guimenu>Map</guimenu></menuchoice> menu.
204	</para>
205	<para>
206	The ZoomIn tool
207	<inlinemediaobject>
208	<imageobject>
209	<imagedata fileref="../images/3_2_zoomin.png" format="PNG"/>
210	</imageobject>
211	<textobject> <phrase>ZoomIn Tool</phrase> </textobject>
212	</inlinemediaobject>
213	can be used to enlarge a region of the map. Clicking once on the map
214	will double the magnification and center the map on the point that
215	was clicked. Clicking and dragging lets the user select a region
216	to be enlarged to fit the window.
217	</para>
218	<para>
219	The ZoomOut tool
220	<inlinemediaobject>
221	<imageobject>
222	<imagedata fileref="../images/3_2_zoomout.png" format="PNG"/>
223	</imageobject>
224	<textobject> <phrase>ZoomOut Tool</phrase> </textobject>
225	</inlinemediaobject>
226	shrinks the map so that a larger region is visible. A single click
227	reduces the magnification by a factor of two. Clicking and dragging
228	selects a box such that the current contents of the window will be
229	scaled to fit into that box.
230	</para>
231	<para>
232	The Pan tool
233	<inlinemediaobject>
234	<imageobject>
235	<imagedata fileref="../images/3_2_pan.png" format="PNG"/>
236	</imageobject>
237	<textobject> <phrase>Pan Tool</phrase> </textobject>
238	</inlinemediaobject>
239	allows the user to move the map around by clicking and dragging.
240	</para>
241	<para>
242	The Full Extent tool
243	<inlinemediaobject>
244	<imageobject>
245	<imagedata fileref="../images/3_2_fullextent.png" format="PNG"/>
246	</imageobject>
247	<textobject> <phrase>Full Extent Tool</phrase> </textobject>
248	</inlinemediaobject>
249	rescales the viewable region so that the entire map is visible.
250	</para>
251	<para>
252	The Full Layer Extent tool
253	<inlinemediaobject>
254	<imageobject>
255	<imagedata fileref="../images/3_2_fulllayerextent.png" format="PNG"/>
256	</imageobject>
257	<textobject> <phrase>Full Layer Extent Tool</phrase> </textobject>
258	</inlinemediaobject>
259	rescales the viewable region so that the currently selected
260	layer fits within the window. If no layer is selected this button
261	will be disabled.
262	</para>
263	<para>
264	The Full Shape Extent tool
265	<inlinemediaobject>
266	<imageobject>
267	<imagedata fileref="../images/3_2_fullshapeextent.png" format="PNG"/>
268	</imageobject>
269	<textobject> <phrase>Full Shape Extent Tool</phrase> </textobject>
270	</inlinemediaobject>
271	rescales the viewable region so that the currently selected
272	shape fits within the window. If the shape is a point, it is
273	centered and the map is zoomed all the way in. If no shape is
274	selected this button will be disabled.
275	</para>
276	</section>
277
278	<section><title>Object Identification</title>
279	<para>
280	Objects on the map can be identified using the Identify tool
281	<inlinemediaobject>
282	<imageobject>
283	<imagedata fileref="../images/3_3_identify.png" format="PNG"/>
284	</imageobject>
285	<textobject> <phrase>Identify Tool</phrase> </textobject>
286	</inlinemediaobject>.
287	Clicking on an object selects that object and opens a dialog which
288	shows all the table attributes for that object. Any current selection
289	is lost.
290	</para>
291	</section>
292
293	<section><title>Object Labelling</title>
294	<para>
295	Objects can be labelled using the Label tool
296	<inlinemediaobject>
297	<imageobject>
298	<imagedata fileref="../images/3_3_label.png" format="PNG"/>
299	</imageobject>
300	<textobject> <phrase>Label Tool</phrase> </textobject>
301	</inlinemediaobject>.
302	Clicking on an object selects that object and opens a dialog which
303	displays the table attributes for that object. An attribute can
304	be selected to be the label on the map. Using this tool for an
305	object that already has a label will remove the label.
306	</para>
307	</section>
308
309	<section><title>The Legend</title>
310	<para>
311	The Legend provides an overview of the layers in the map. Layers
312	that appear higher in the legend will appear ``closer'' to the user.
313	If a layer supports classification (currently, only shape layers
314	have this feature) then the classification groups will be shown
315	below each layer. The properties for each group are also displayed
316	with a small graphic. Polygon layers appear as rectangles, lines
317	appear as curved lines, and points appear as circles.
318	</para>
319	<para>
320	Along the top of the legend is a toolbar which allows quick access
321	to some of the layer manipulation options under
322	<menuchoice> <guimenu>Map</guimenu> </menuchoice>.
323
324	Double-clicking on a layer or a group of a layer will open the
325	properties dialog for that layer.
326	</para>
327	</section>
328
329	<section><title>Printing</title>
330	<para>
331	The map can be printed using
332	<menuchoice>
333	<guimenu>Map</guimenu>
334	<guimenuitem>Print</guimenuitem>
335	</menuchoice>. A standard printing dialog will open allowing the
336	user to configure the printer.
337	</para>
338	</section>
339	</chapter>
340
341	<chapter><title>Layer Management</title>
342	<para>
343	</para>
344
345	<section><title>Types of Layers</title>
346	<para>
347	There are two types of layers supported by Thuban: shape layers and
348	image layers. Shape layers consist of vector based shapes with
349	geo-referenced coordinates. There are three types of supported
350	shapes: polygons, lines, and points. Image layers can be any image
351	file format supported by GDAL. The images must have a geographic
352	coordinate data either embedded within the file, or in a seperate
353	file that is in the same directory as the image file used for the
354	layer. GeoTIFF files work very well with Thuban and were designed
355	specifically to be image layers in GIS programs.
356	</para>
357	</section>
358
359	<section><title>Properties</title>
360	<para>
361	Each shape in a shape layer can have various properties which control
362	how it is drawn on the map. Polygons and points can be drawn with an
363	outline color and a fill color, while lines have only a line color.
364	</para>
365	</section>
366
367	<section><title>Visibility</title>
368	<para>
369	Sometimes it is not desirable to view all layers at the same time.
370	Some layers may take a long time to draw and so while navigating
371	around the map the user may not want to wait for the map to redraw
372	each time the map is changed. Each layer can be independently
373	turned on or off using the
374	<menuchoice>
375	<guimenu>Layer</guimenu>
376	<guimenuitem>Show</guimenuitem>
377	</menuchoice>
378	or
379	<menuchoice>
380	<guimenu>Layer</guimenu>
381	<guimenuitem>Hide</guimenuitem>
382	</menuchoice> options respectively.
383	</para>
384	</section>
385
386	<section><title>Sequence</title>
387	<para>
388	</para>
389	</section>
390
391	<section><title>Duplication</title>
392	<para>
393	Layers and all their properties, including classifications, can
394	be duplicated using
395	<menuchoice>
396	<guimenu>Layer</guimenu>
397	<guimenuitem>Duplicate</guimenuitem>
398	</menuchoice>. Duplicating a layer is useful if the user wishes
399	to model a layer in several different ways. Even though the layers
400	overlap by carefully selecting the shape properties it is possible
401	to display several pieces of information at once. For example, one
402	copy of a roads layer may be classified on a length property and
403	another copy may be classified on a type property. if the length
404	property was expressed with color and the type property expressed
405	with line thickness then it would be possible to view both
406	classifications by placing the type property copy over the
407	length property copy.
408	</para>
409	</section>
410
411	</chapter>
412
413	<chapter><title>Layer Classifications</title>
414	<para>
415	</para>
416
417	<section><title>Adding and Removing Classes</title>
418	<para>
419	</para>
420	</section>
421
422	<section><title>Symbols</title>
423	<para>
424	</para>
425	</section>
426
427	<section><title>Generating Classes</title>
428	<para>
429	</para>
430	</section>
431	</chapter>
432
433	<chapter><title>Projection Management</title>
434	<para>
435	</para>
436	</chapter>
437
438	<chapter><title>Table Management</title>
439	<para>
440	</para>
441	</chapter>
442
443	<chapter><title>Trouble Shooting</title>
444	<para>
445	</para>
446	</chapter>
447
448	<appendix><title>Supported Data Sources</title>
449	<para>
450	</para>
451	</appendix>
452
453	<appendix><title>Supported Projections</title>
454	<para>
455	</para>
456	</appendix>
457
458	</book>
Name	Value
svn:eol-style	native
svn:keywords	Author Date Id Revision