[QGIS Commit] r9864 - docs/trunk/english_us/user_guide
svn_qgis at osgeo.org
svn_qgis at osgeo.org
Fri Dec 19 13:35:53 EST 2008
Author: dassau
Date: 2008-12-19 13:35:52 -0500 (Fri, 19 Dec 2008)
New Revision: 9864
Modified:
docs/trunk/english_us/user_guide/working_with_raster.tex
docs/trunk/english_us/user_guide/working_with_vector.tex
Log:
updated and reviewed working with raster
more updates for working with vector
Modified: docs/trunk/english_us/user_guide/working_with_raster.tex
===================================================================
--- docs/trunk/english_us/user_guide/working_with_raster.tex 2008-12-19 16:05:43 UTC (rev 9863)
+++ docs/trunk/english_us/user_guide/working_with_raster.tex 2008-12-19 18:35:52 UTC (rev 9864)
@@ -5,30 +5,9 @@
% when the revision of a section has been finalized,
% comment out the following line:
-\updatedisclaimer
+%\updatedisclaimer
-QGIS supports a number of raster data formats. This section describes how to
-work with raster data in QGIS.
-
-\subsection{What is raster data?}\label{label_whatsraster}
-\index{raster layers!definition}
-
-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 or satellite imagery and modelled data such as an elevation
-matrix.
-
-Unlike vector data, raster data typically do not have an associated database
-record for each cell.
-
-In GIS, a raster layer would have georeferencing 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 overlaid with it. QGIS makes use of georeferenced
-rasters to properly display the data.\index{raster layers!georeferenced}
-
-\subsection{Raster formats supported in QGIS}\label{label_rastformats}
+This Section describes how to visualize and set raster layer properties.
QGIS supports a number of different raster formats. Currently tested formats
include:\index{raster layers!data formats}
@@ -45,62 +24,73 @@
Because the raster implementation in QGIS is based on the GDAL library, other
raster formats implemented in GDAL are also likely to work, but have not yet
-been tested. See Appendix \ref{appdx_gdal} for more
-details.\index{raster layers!GDAL implementation}
+been tested. You find more details in Appendix \ref{appdx_gdal}
+\index{raster layers!GDAL implementation} or at
+\url{http://www.gdal.org/formats_list.html}. If you want to load GRASS raster
+data, please refer to Section~\ref{sec:load_grassdata}.
+
+\subsection{What is raster data?}\label{label_whatsraster}
+\index{raster layers!definition}
+
+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 or satellite imagery and modelled data such as an elevation
+matrix.
+
+Unlike vector data, raster data typically do not have an associated database
+record for each cell. They are geocoded by it's pixel resolution and the x/y
+coordinate of a corner pixel of the raster layer. This allows QGIS to position
+the cata correctly in the map canvas.
+
+QGIS makes use of georeference information inside the raster layer (e.g. GeoTiff)
+or in an appropriate world file to properly display the data.\index{raster layers!georeferenced}
\subsection{Loading raster data in QGIS}\label{label_loadraster}
Raster layers are loaded either by clicking on the
\toolbtntwo{mActionAddRasterLayer}{Load Raster} icon or by
-selecting the \mainmenuopt{View}>\dropmenuopttwo{mActionAddRasterLayer}{Add Raster Layer} menu option. More than one
-layer can be loaded at the same time by holding down the
-\keystroke{Control} or \keystroke{Shift} key
-and clicking on multiple items in the dialog \dialog{Open a GDAL Supported
-Raster Data Source}.\index{raster layers!loading}
+selecting the \mainmenuopt{View}>\dropmenuopttwo{mActionAddRasterLayer}{Add Raster Layer}
+menu option. More than one layer can be loaded at the same time by holding down the
+\keystroke{Control} or \keystroke{Shift} key and clicking on multiple items
+in the dialog \dialog{Open a GDAL Supported Raster Data Source}.\index{raster layers!loading}
-Please refer to section \ref{sec:load_grassdata} if you intend to load GRASS rasterdata.
-
-\subsection{Raster Properties Dialog}\label{label_rasterprop}
+Once a raster layer is loaded in the map legend you can click on the name with the
+right mouse button to select and activate layer specific features or to open
+a dialog to set raster properties for the layer.
-To view and set the \dropmenuopt{properties} for a raster layer, right click on the layer
-name. This displays the raster layer context menu that includes a number of
-items that allow you to:\index{raster layers!context menu}
+\minisec{Right mouse button menu for raster layers}
-\begin{figure}[ht]
- \begin{center}
- \caption{Raster context menu \nixcaption}\label{fig:raster_contextmenu}\smallskip
- \includegraphics[clip=true, width=5cm]{rasterContext}
- \end{center}
-\end{figure}
-
\begin{itemize}
-\item \toolbtntwo{mActionZoomFullExtent}{Zoom to the full extent} of the raster
-\item Zoom to the best scale of the raster
-\item Show the raster in the map overview window
-\item \toolbtntwo{mActionRemoveLayer}{Remove layer} from the map
-\item Open the raster layers properties
-\item Rename the layer
-\item Add a layer group
-\item \toolbtntwo{mActionExpandTree}{Expand legend tree view}
-\item \toolbtntwo{mActionCollapseTree}{Collapse legend tree view}
-\item Show file groups
+\item \dropmenuopt{Zoom to layer extent}
+\item \dropmenuopt{Zoom to best scale (100\%)}
+\item \dropmenuopt{Show in overview}
+\item \dropmenuopt{Remove}
+\item \dropmenuopt{Properties}
+\item \dropmenuopt{Rename}
+\item \dropmenuopt{Add Group}
+\item \dropmenuopt{Expand all}
+\item \dropmenuopt{Collapse all}
+\item \dropmenuopt{Show file groups}
\end{itemize}
+
+\subsection{Raster Properties Dialog}\label{label_rasterprop}
-Choose \dropmenuopt{Properties} from the context menu to open the
-\button{Raster Layer Properties}
-dialog for the layer.\index{raster layers!properties}
+To view and set the properties for a raster layer, double click
+on the layer name in the map legend or right click on the layer name and choose
+\dropmenuopt{Properties} from the context menu:\index{raster layers!context menu}
+Figure \ref{fig:raster_properties} shows the \dialog{Raster Layer Properties} dialog.
+There are several tabs on the dialog:
-Figure \ref{fig:raster_properties} shows the \dialog{Raster Layer
-Properties} dialog. There are several
-tabs on the dialog:
\begin{itemize}
- \item \tab{Symbology},
- \item \tab{Transparency},
- \item \tab{Colormap},
- \item \tab{General},
- \item \tab{Metadata},
- \item \tab{Pyramids}
- \item and \tab{Histogram}.
+ \item \tab{Symbology}
+ \item \tab{Transparency}
+ \item \tab{Colormap}
+ \item \tab{General}
+ \item \tab{Metadata}
+ \item \tab{Pyramids}
+ \item \tab{Histogram}
\end{itemize}
\begin{figure}[h]
@@ -125,9 +115,10 @@
\minisec{Single band gray}
This selection offers you two possibilites to choose. At first you can
-select which band you like to use for rendering. The second option offers
-a selection of available colortables for rendering.
+select which band you like to use for rendering.
+The second option offers a selection of available colortables for rendering.
+
The following settings are available through the dropdownbox
\selectstring{color map}{Grayscale}, where grayscale is the default
setting.
@@ -149,7 +140,6 @@
negative impact on the rendering of the raster. This option is only available
for pseudocolor images.
-
\minisec{Three band color}
This selection offers you a wide range of options to modify the appereance
@@ -157,41 +147,9 @@
standard RGB-order to something else.
Also scaling of colors are available.
-Note that the scaling of you custom min and max values for each band is
-only available if your dataset has three bands to do so.
+Note that customizing min and max values for each band is only available
+if your dataset has three bands or more.
-% SH: Not applyable anymore
-%%%QGIS supports three forms of raster layers:\index{raster layers!supported channels}
-%%%
-%%%\begin{itemize}
-%%%\item Single Band Grayscale Rasters
-%%%\item Palette Based RGB Rasters
-%%%\item Multiband RGB Rasters
-%%%\end{itemize}
-%%%
-%%%From these three basic layer types, eight forms of symbolised raster display
-%%%can be used:\index{raster layers!rendering interpretation}
-%%%
-%%%\begin{itemize}
-%%%\item Single Band Grayscale
-%%%\item Single Band Pseudocolor
-%%%\item Paletted Grayscale (where only the red, green or blue component of the
-%%%image is displayed)
-%%%\item Paletted Pseudocolor (where only the red, green or blue component of the
-%%%image is displayed, but using a pseudocolor algorithm)
-%%%\item Paletted RGB
-%%%\item Multiband Grayscale (using only one of the bands to display the image)
-%%%\item Multiband Pseudocolor (using only one of the bands shown in
-%%%pseudocolor)
-%%%\item Multiband RGB (using any combination of three bands)
-%%%\end{itemize}
-
-\smallskip
-
-QGIS can invert the colors in a given layer so that light colors become dark
-(and dark colors become light). Use the \checkbox{Invert Color Map} checkbox to
-enable / disable this behavior.\index{raster layers!icolor map inversion}
-
\begin{Tip}\caption{\textsc{Viewing a Single Band of a Multiband Raster}}
\qgistip{If you want to view a single band (for example Red) of a multiband
image, you might think you would set the Green and Blue bands to ``Not
@@ -325,16 +283,19 @@
\subsubsection{Histogram Tab}\label{label_histogram}
-The histogram tab allows you to view the distribution\index{raster layers!histogram}
+The \tab{Histogram} tab allows you to view the distribution\index{raster layers!histogram}
of the bands or colors in your raster. You must first generate the raster statistics
by clicking the \button{Refresh} button. You can choose which bands to display by
selecting them in the list box at the bottom left of the tab. Two different
chart types are allowed:
+
\begin{itemize}
-\item Barcharts and
-\item Linegraphs.
+\item Bar chart
+\item Line graph
\end{itemize}
+You can define the number of chart columns to use and decide wether you want
+to \checkbox{Allow approximation} or display \checkbox{out of range} values
Once you view the histogram, you'll notice that the band statistics have been
populated on the \tab{metadata} tab.\index{raster layers!metadata)}
Modified: docs/trunk/english_us/user_guide/working_with_vector.tex
===================================================================
--- docs/trunk/english_us/user_guide/working_with_vector.tex 2008-12-19 16:05:43 UTC (rev 9863)
+++ docs/trunk/english_us/user_guide/working_with_vector.tex 2008-12-19 18:35:52 UTC (rev 9864)
@@ -13,7 +13,7 @@
\index{shapefiles}\index{ESRI!shapefiles}\index{SHP files}
MapInfo MIF (interchange format)\index{MIF files}\index{MapInfo!MIF files}
and MapInfo TAB (native format).\index{TAB files}\index{MapInfo!TAB files}
-A list of OGR supported formats in Appendix~\ref{appdx_ogr}.
+You find a list of OGR supported vector formats in Appendix~\ref{appdx_ogr}.
QGIS also supports PostGIS\index{PostGIS}\index{PostgreSQL!PostGIS} layers
in a PostgreSQL database using the PostgreSQL data provider plugin.
More information about the QGIS-commit
mailing list