-
+
+
+
This documentation describes the Quantum GIS (QGIS) application. - Further information on QGIS is available at - http://qgis.org. -
- + Further information on QGIS is available at + http://qgis.org. + +
+Whats new in Version 0.2+ | + | |
| + |
+New features+ | + | |
| + |
+New Core Plugins+ | + | |
| + |
+New Contributed Plugins+ | + | |
| + |
+Known Issues+ | + | |
| + |
The following documents are available:
- +All documents are available in PDF format in the qgis share/doc subdirectory. If you have the Adobe PDF plugin for your browser, you can display the PDF version by clicking on the PDF link in the upper right corner of each document.
- +
+
This document briefly describes how to build QGIS from the source distribution. - The information below is for version 0.1 Moroz of QGIS.
+ The information below is for version 0.2 Pumpkin of QGIS.QGIS requires that a number of libraries be installed on your system:
- +Each of these requirements are discussed below. Note that the information given below is abstracted from the installation documentation for each of the @@ -208,16 +214,16 @@ libraries. See the install information for each library to get detailed instructions.
In the documentation below, the file names used are examples.
- +If you are building QGIS without PostgreSQL, skip to the section on Installing GDAL/OGR.
- - + +QGIS uses the latest features of PostgreSQL. For this reason, version 7.4.x is recommended with QGIS version 0.1. If you choose to add PostgreSQL, you must also install PostGIS and the GEOS library (see below). -
- + + +QGIS uses the latest features of PostgreSQL. For this reason, version 7.4.x is recommended with QGIS version 0.2. If you choose to add PostgreSQL, you must also install PostGIS and the GEOS library (see below). +
+cd postgresql-7.4.1
./configure --prefix=/usr/local/pgsql- +
./configure --prefix=/usr/local/pgsql+
make install
psql test @@ -318,13 +324,13 @@ If you are building QGIS without PostgreSQL, skip to the sectio \q- +
To install GEOS:
- +The GDAL and OGR libraries provide support for raster and vector data formats. QGIS makes use of both of these libraries (which come bundled in one distribution). Note: A Linux binary of GDAL is available at http://www.remotesensing.org/gdal. If you choose to install the binary you will also need to download and unpack the source tree since QGIS needs the header files in order to compile.
- +To install GDAL/OGR from source:
@@ -479,7 +485,7 @@ To install GDAL/OGR from source:tar xfvz /../path/../gdal-x.x.x.tar.gz@@ -523,9 +529,9 @@ make install
If you've had problems during the installation, refer to this manual, where the whole process is described with some more detail: http://www.remotesensing.org/gdal/gdal_building.html
- +Qt 3.1.2 or higher is required in order to compile QGIS. You may already have Qt on your system. If so, check to see if you have version 3.1.2 or later. If not already installed, you will have to install the Qt development package for your distribution. If you are not able to install the required Qt packages, you will have to build from source. To install Qt from source:
@@ -549,24 +555,24 @@ To install Qt from source:./configure -thread- +
- After you have installed the required libraries, you are ready to build QGIS. Download and untar the QGIS distribution and change to the QGIS source directory. You have two options for building and installing QGIS: Quick and Dirty and the right way. -
- + After you have installed the required libraries, you are ready to build QGIS. Download and untar the QGIS distribution and change to the QGIS source directory. You have two options for building and installing QGIS: Quick and Dirty and the right way. + +If you don't need PostgreSQL support and have installed GDAL , - you can configure and build QGIS by changing to the distribution directory - and typing: -
+ you can configure and build QGIS by changing to the distribution directory + and typing: +./configure make make install
See the next section for the full configuration instructions.
- +- To see the configure options available, change the the QGIS - directory and enter: -
+ To see the configure options available, change the the QGIS + directory and enter: +./configure --help
Among other options, there are three that are important to - the success of the build:
+ the success of the build:
--with-qtdir=DIR Qt installation directory default=$QTDIR
--with-gdal=path/gdal-config Full path to 'gdal-config' script,
e.g. '--with-gdal=/usr/local/bin/gdal-config'
--with-pg=path/pg_config PostgreSQL (PostGIS) Support
(full path to pg_config)
-
+
The configure script will detect Qt, unless it is installed in a - non-standard location. Setting the QTDIR environment variable will - make ensure that the detection succeeds. You can also specify the - path using the --with-qtdir option. -
+ non-standard location. Setting the QTDIR environment variable will + make ensure that the detection succeeds. You can also specify the + path using the --with-qtdir option. +- If the gdal-config script is in the PATH, configure will automatically - detect and configure GDAL support. If not in the path, you can specify - the full path to gdal-config using the --with-gdal option. For example:
+ If the gdal-config script is in the PATH, configure will automatically + detect and configure GDAL support. If not in the path, you can specify + the full path to gdal-config using the --with-gdal option. For example:- + ./configure --with-gdal=/usr/mystuff/bin/gdal-config - +
- If the pg_config script is in the PATH, configure will automatically - detect and configure PostgreSQL support. If not, you can use the - --with-pg option to specify the full path to pg_config. For example:
+ If the pg_config script is in the PATH, configure will automatically + detect and configure PostgreSQL support. If not, you can use the + --with-pg option to specify the full path to pg_config. For example:- + ./configure --with-pg=/usr/local/psql/bin/pg_config - +
./configure --prefix=/usr/local/qgis - --with-gdal=/usr/local/gdal/bin/gdal-config - --with-pg=/usr/local/psql/bin/pg_config + --with-gdal=/usr/local/gdal/bin/gdal-config + --with-pg=/usr/local/psql/bin/pg_config
This will configure QGIS to use both GDAL and PostgreSQL. QGIS will be installed in /usr/local/qgis.
Once properly configured simply issue the following commands: -
+make make install
-
+
-
-
+
+
by Gary E. Sherman, Tim Sutton
diff --git a/doc/install.pdf b/doc/install.pdf index 96075fe8533..879228f33c8 100644 --- a/doc/install.pdf +++ b/doc/install.pdf @@ -8,7 +8,7 @@ endobj << /Length 2098 /Filter [ /ASCII85Decode /FlateDecode ] >> stream -Gat=,a`?,q&A@B[GdOMfL`jMc[k*Q_;orP_X6)1/"!p5WCIHS4&m>&,Bl$1)U*:mY3G(4tNQ+>hHoINg5DEL[M!rSh'4:Z?9RLbATq2epW0[fsb^:&CWAgljJ$-NB5
+
Quantum GIS (QGIS) is designed to be a Geographic Information System (GIS) built for Linux/Unix. QGIS currently offers basic support for vector, raster, and database formats.
This section gives you a quick overview of running QGIS and examining data - available on the QGIS web page. -
- + available on the QGIS web page. + +Installation of QGIS is documented in the Installation Guide. -
- + +If you do not have any GIS data, you can obtain a dataset for Alaska (which will be used as the - basis for the examples and screenshots provided in this document) from the - the QGIS web site + basis for the examples and screenshots provided in this document) from the + the QGIS web site
- +- Assuming the QGIS is installed in the PATH, you can start QGIS by typing: - qgis.
+ Assuming the QGIS is installed in the PATH, you can start QGIS by typing: + qgis.- In addition, you can start QGIS by specifying one or more datafiles on the commandline. For example, - assuming you are in your data directory, you could start QGIS with two shapefiles and a raster file set to - load on startup: -
+ In addition, you can start QGIS by specifying one or more datafiles on the commandline. For example, + assuming you are in your data directory, you could start QGIS with two shapefiles and a raster file set to + load on startup: +qgis ak_shade.tif alaska.shp majrivers.shp
@@ -316,9 +322,9 @@ built for Linux/Unix. QGIS currently offers basic support for vector, raster, an
- When QGIS starts, an empty window is displayed as shown below.
- 
-
+
The QGIS main window is divided into five areas:
These five parts of the main QGIS are described in more detail in the following sections
The menu bar provides access to various QGIS features using a standard windows - heirachical menu.
+ heirachical menu.The File Menu:
- Open a previously saved project.
- Save the current project.
- Save project under a new file name.
- Export your current project as a mapserver
- map file. Note that not all mapserver features are available in the exported mapfile.
- Exit the QGIS application. - Exit the QGIS application.
+
The View Menu:
- Add one or more layers
- stored in a PostgreSQL/Postgis geodatabase to the map view.
- Add one or more layers
- stored on disk as shapefiles to the map view.
- Add one or more raster layers
- to the map view. The Tools Menu:
-
- This opens a dialog
- that allows you to manage (load and unload) which plugins are used in QGIS.
- This option connects
- over the internet to the QGIS server to find out what the latest available version is. No
- personal data is sent to the QGIS server.
- Global configuration options
- for the QGIS application.The Help Menu:
-
- This opens the help documentation
- you are reading right now!.
- Clicking this menu option will
- take you to the QGIS internet home page using your preferred browser.
- This will take you to the Sourceforge.net
- project page for QGIS. 
- Click here to find out some useful information
- about the current version of QGIS you are using. If you want to frighten yourself silly, take a
- look at the Contributors tab to see all the hardworking elves behind the QGIS effort. QGIS has toolbars that provide quick access to commonly used functions. These are:
- Start a new QGIS project. If you
- already have a project ope, you will be asked if you would like to save the existing one first. - Open a previously saved project. - Save the current project. - Save project under a new file name. - Add one or more layers
- stored in a PostgreSQL/Postgis geodatabase to the map view. - Add one or more layers
- stored on disk as shapefiles to the map view. - Add one or more raster layers
- to the map view. 
- Reload the current map view (refreshes display)
- Zoom in the map display by dragging a rectangle
- Zoom out of the map display by dragging a rectangle.
- Dragging a small rectangle will zoom out a long way, dragging a large rectangle will zoom out a little way.
- Zoom out until all features in all map layers
- are visible.
- Zoom to fit all selected features in the
- map view.
- Pan in the map display area.
- Zoom to last extents.
- Show information about a feature (applies only to vector data).
- Select features in the map display (applies only to vector data).
- Show the attribute table for the selected layer (applies only to vector data). - Show the attribute table for the selected layer (applies only to vector data).
+
The map legend area is used to set the visibility and z-ordering of layers. - Z-ordering means that layers listed nearer the top of the legend are drawn over - layers listed lower down in the legend. The checkbox in each legend entry can be useed - to show/hire that layer.
+ Z-ordering means that layers listed nearer the top of the legend are drawn over + layers listed lower down in the legend. The checkbox in each legend entry can be useed + to show/hire that layer.This is the 'business end' of QGIS - maps are displayed in this area! The map - displayed in this window will depend on the vector and raster layers you have chosen - to load (see sections that follow for more info on this). The map view can be panned (shifting - to focus of the map display to another region), zoomed in and out, and supports various other - actions as described in the toolbar description above.
+ displayed in this window will depend on the vector and raster layers you have chosen + to load (see sections that follow for more info on this). The map view can be panned (shifting + to focus of the map display to another region), zoomed in and out, and supports various other + actions as described in the toolbar description above.The map view and the legend are tightly bound to each other - the maps in view - reflect changes you make in the legend area.
+ reflect changes you make in the legend area.The status bar shows you your current position in map coordinate (e.g. meters or decimal - degress) as the mouse pointer is moved accross the map view.
- + degress) as the mouse pointer is moved accross the map view. +To load one or more shapefiles, click on the Add Layer button
- .
.
The Select one or more layers to add dialog box will be displayed.
- 
Navigate to the directory where the shapefiles reside. Select one or - more files and click ok to load them.
+ more files and click ok to load them.When QGIS loads a layer, it assigns a random color to it as shown - below.
+ below.
-
- Obviously QGIS's choice of colors is not very pleasing in this case. -
- + Obviously QGIS's choice of colors is not very pleasing in this case. + +- To make the layer more appealing, open the Layer Properties - dialog by right-clicking on a layer name - in the table of contents (left side of the QGIS window) and - selecting Properties. -
+ To make the layer more appealing, open the Layer Properties + dialog by right-clicking on a layer name + in the table of contents (left side of the QGIS window) and + selecting Properties. +If you like, change the display name of the layer by editing - the Display name field.
+ the Display name field.
-
+
-
Click on the Legend - tab to display the current symbols used for the layer
+ tab to display the current symbols used for the layer
Click on the Outline color and Fill color - and select a new color from the color chooser. You can also change the - line width if desired.
+ and select a new color from the color chooser. You can also change the + line width if desired.
-
+
-
After making the changes, click Ok to apply the changes to - the layer. Note that the alaska layer has been renamed to Alaska and the - color has been changed to a light green:
+ the layer. Note that the alaska layer has been renamed to Alaska and the + color has been changed to a light green:
-
+
-
QGIS provides a useful tool ( - the 'identify' tool) that allows you to click on a vector feature (
- point, line or polygon) and view information about that feautre. The information displayed is
- retrieved from the Postgres database (in the case of Postgis layers) or from the .dbf file
- associated with the shapefile you are insecting.
Raster data in GIS are matrices of discrete cells that represent features on, above or below the earth's surface. Each - cell in the raster grid is the same size, and cells are usually rectangular (in QGIS they will always be rectangular. - Typical raster datasets include 'remote sensing' data (such as aerial photography and satellite imagery) and modelled data - (such as an elevation matrix).
+ cell in the raster grid is the same size, and cells are usually rectangular (in QGIS they will always be rectangular. + Typical raster datasets include 'remote sensing' data (such as aerial photography and satellite imagery) and modelled data + (such as an elevation matrix).Raster data typically do not have an associated database record for each cell (unlike in vector data where it is normal - for each feature to have an associated database record).
+ for each feature to have an associated database record).In GIS, a raster layer would have geopositioning data associated with it which will allow it to be positioned - correctly in the map display to allow other vector and raster data to be overlayed with it. QGIS, can read this - geopositioning data to facilitate properly displaying map overlays.
- + correctly in the map display to allow other vector and raster data to be overlayed with it. QGIS, can read this + geopositioning data to facilitate properly displaying map overlays. +QGIS supports a number of different raster formats. Currently tested formats include:
Because the raster implmentation in QGIS is based on the GDAL abstraction library, orther raster formats implemented - in GDAL are also likely to work, but have not yet been tested. See - the GDAL Raster Formats page for more details.
- + in GDAL are also likely to work, but have not yet been tested. See + the GDAL Raster Formats page for more details. +Raster layers are loaded either by clicking on the icon
- or by selecting the View->Add Raster Layer menu option. More than one layer can be loaded at the same time
- by holding down the Control key and clicking on multiple items in the file dialog.
Symbolisation of raster layers is achieved by right clicking on a raster layer legend entry and choosing 'properties': - on the popup menu that appears:
+ on the popup menu that appears:
-
+
-
On the properties dialog for rasters you will see there are three tabs:
-
+
-
The legend tab displays basic information aboug the selected raster - including its - dimensions (in pixels) and its display name in the legend.
+ dimensions (in pixels) and its display name in the legend.
-
+
-
QGIS supports three forms of raster layer:
From these three basic layer types, eight forms of symbolised raster display can be used:
QGIS has the capability to invert the colours in a given layer so that light - colors become dark (and dark colors become light). Use the 'Invert Color Map' checkbox - to enable / disable this behaviour.
+ colors become dark (and dark colors become light). Use the 'Invert Color Map' checkbox + to enable / disable this behaviour.QGIS has the capability to display each raster layer at varying transparency levels. Use - the transparency slider to indicate to what extent the underlying layers (if any) should - be visible though the current raster layer.
+ the transparency slider to indicate to what extent the underlying layers (if any) should + be visible though the current raster layer.QGIS has the capability to restrict the data displayed to show only cells whose values are - within a given number of standard diviations of the mean for the layer. This is useful - when you have one or two cells with abnormally high values in a raster grid that are having a - negative impact on the rendering of the raster. This option is only available for pseudocolor - images.
+ within a given number of standard diviations of the mean for the layer. This is useful + when you have one or two cells with abnormally high values in a raster grid that are having a + negative impact on the rendering of the raster. This option is only available for pseudocolor + images.
-
+
-
This tab displays statistics about each band in the current raster layer. Statistics are - gathered on a 'need to know' basis, so it may well be that a given layer's statistics have - not yet been collected.
+ gathered on a 'need to know' basis, so it may well be that a given layer's statistics have + not yet been collected.Statistics for a layer are gathered when pseudocolor rendering is selected and the 'apply' - button is pressed.
+ button is pressed.If you are a KDE user, you can create a mime type that associates GIS files with QGIS. This is useful - because it allows you to click on a shapefile (for example) in konqueror and the file will be loaded in a - new instance of QGIS. -
- + +If you are a KDE user, you can create a mime type that associates GIS files with QGIS. This is useful + because it allows you to click on a shapefile (for example) in konqueror and the file will be loaded in a + new instance of QGIS. +
+ +- - + +
- -Hosting for the QGIS project is generously provided by Sourceforge. -
- + +
-
+
-
+
Please see the Help->About->Contributors for a list of people who have donated their time to the QGIS project.
- -by Gary Sherman, Tim Sutton
diff --git a/doc/userguide.pdf b/doc/userguide.pdf index 1313e953e82..b04f3a253a2 100644 --- a/doc/userguide.pdf +++ b/doc/userguide.pdf @@ -5,10 +5,10 @@ /Producer (FOP 0.20.5) >> endobj 5 0 obj -<< /Length 1836 /Filter [ /ASCII85Decode /FlateDecode ] +<< /Length 1826 /Filter [ /ASCII85Decode /FlateDecode ] >> stream -Gat=,>Bed\&:WeDpb=q0'p^E.qUVMm-[XQa)sG"Pp-BO(ZtjJmb9ZGXhiTR*9H_-J-]L!.7Pgh.S'g_F2B%)=*6*j$ba'L*r(0A\PE)U%_E[>(7M]s0GX:E7f$9mH5:6-R2pOK#7e"OEcUsLH26#+m^2a-mB"p3XC![b>=S'Fl`0@[\rfC]fMVOY>$+5]3S$,7`r;66nfo1u[j?