[QGIS Commit] r9793 - docs/trunk/english_us/user_guide
svn_qgis at osgeo.org
svn_qgis at osgeo.org
Sun Dec 14 05:45:16 EST 2008
Author: dassau
Date: 2008-12-14 05:45:16 -0500 (Sun, 14 Dec 2008)
New Revision: 9793
Modified:
docs/trunk/english_us/user_guide/plugins_ftools.tex
Log:
finished and reviewed ftool section
Modified: docs/trunk/english_us/user_guide/plugins_ftools.tex
===================================================================
--- docs/trunk/english_us/user_guide/plugins_ftools.tex 2008-12-14 09:31:10 UTC (rev 9792)
+++ docs/trunk/english_us/user_guide/plugins_ftools.tex 2008-12-14 10:45:16 UTC (rev 9793)
@@ -2,7 +2,7 @@
% when the revision of a section has been finalized,
% comment out the following line:
-\updatedisclaimer
+%\updatedisclaimer
The goal of the fTools python plugin is to provide a one-stop resource for
many common vector-based GIS tasks, without the need for additional software,
@@ -12,11 +12,12 @@
\minisec{Install the fTools Plugin}
To use the functionalities in QGIS, you must install the fTool python plugin
-with the Python Plugin Installer (see Section \ref{sec:external_plugins}) and
-then select and load it with the Plugin Manager. Therefore click the menu
-\mainmenuopt{Plugins} > \mainmenuopt{Manage Plugins}, select
-\dropmenuopt{fTools} and click \button{OK}. A new menu \mainmenuopt{Tools}
-occurs in the main menu and provides following tools:
+with the \mainmenuopt{Fetch Python Plugins} Installer from Carson Farmers
+Repository (see Section \ref{sec:external_plugins}). Then select and load it
+with the Plugin Manager. Therefore click the menu \mainmenuopt{Plugins} >
+\mainmenuopt{Manage Plugins}, select \dropmenuopt{fTools} and click
+\button{OK}. A new menu \mainmenuopt{Tools} occurs in the menu bar with
+following features:
\minisec{Analysis tools}
@@ -59,12 +60,19 @@
\caption{fTool sampling tools}\label{tab:ftool_sampling}\medskip
\begin{tabular}{|p{0.3in}|p{1.3in}|p{4.6in}|}
\hline \textbf{Icon} & \textbf{Tool} & \textbf{Purpose} \\
- \hline \includegraphics[width=0.7cm]{random} & Random selection & Randomly select n number of features, or n percentage of features \\
- \hline \includegraphics[width=0.7cm]{selectsubset} & Random selection within subsets & Randomly select features within subsets based on a unique ID field. \\
- \hline \includegraphics[width=0.7cm]{randompoints} & Random points & Generate pseudo-random points over a given input layer. \\
- \hline \includegraphics[width=0.7cm]{regularpoints} & Regular points & Generate a regular grid of points over a specified region and export them as a point shapefile. \\
- \hline \includegraphics[width=0.7cm]{vectorgrid} & Vector grid & Generate a line or polygon grid based on user specified grid spacing. \\
- \hline \includegraphics[width=0.7cm]{selectlocation} & Select by location & Select features based on their location relative to another layer to form a new selection, or add or subtract from the current selection. \\
+ \hline \includegraphics[width=0.7cm]{random} & Random selection & Randomly
+select n number of features, or n percentage of features \\
+ \hline \includegraphics[width=0.7cm]{selectsubset} & Random selection within
+subsets & Randomly select features within subsets based on a unique ID field. \\
+ \hline \includegraphics[width=0.7cm]{randompoints} & Random points & Generate
+pseudo-random points over a given input layer. \\
+ \hline \includegraphics[width=0.7cm]{regularpoints} & Regular points & Generate
+a regular grid of points over a specified region and export them as a point shapefile. \\
+ \hline \includegraphics[width=0.7cm]{vectorgrid} & Vector grid & Generate a
+line or polygon grid based on user specified grid spacing. \\
+ \hline \includegraphics[width=0.7cm]{selectlocation} & Select by location &
+Select features based on their location relative to another layer to form a
+new selection, or add or subtract from the current selection. \\
\hline
\end{tabular}
\end{table}
@@ -76,33 +84,56 @@
\caption{fTool geoprocessing tools}\label{tab:ftool_geoprocessing}\medskip
\begin{tabular}{|p{0.3in}|p{0.8in}|p{5.1in}|}
\hline \textbf{Icon} & \textbf{Tool} & \textbf{Purpose} \\
- \hline \includegraphics[width=0.7cm]{multiconvex} & Convex hull & Create minimum convex hull(s) for an input layer, or based on an ID field. \\
- \hline \includegraphics[width=0.7cm]{dynamicbuffer} & Buffer & Create buffer(s) around features based on distance, or distance field. \\
- \hline \includegraphics[width=0.7cm]{intersect} & Intersect & Overlay layers such that output contains areas where both layers intersect. \\
- \hline \includegraphics[width=0.7cm]{union} & Union & Overlay layers such that output contains all intersecting and non-intersecting areas of input layers. \\
- \hline \includegraphics[width=0.7cm]{symdiff} & Symetrical difference & Overlay layers such that output contains those areas of the input and difference layers that do not intersect. \\
- \hline \includegraphics[width=0.7cm]{clip} & Clip & Overlay layers such that output contains those areas of the input layer that intersect the clip layer. \\
- \hline \includegraphics[width=0.7cm]{erase} & Difference & Overlay layers such that output contains those areas of the input layer that do not intersect the clip layer. \\
- \hline \includegraphics[width=0.7cm]{dissolve} & Dissolve & Merge features based on input field. All features with indentical input values are combined to form one single feature. \\
+ \hline \includegraphics[width=0.7cm]{multiconvex} & Convex hull & Create
+minimum convex hull(s) for an input layer, or based on an ID field. \\
+ \hline \includegraphics[width=0.7cm]{dynamicbuffer} & Buffer & Create
+buffer(s) around features based on distance, or distance field. \\
+ \hline \includegraphics[width=0.7cm]{intersect} & Intersect & Overlay
+layers such that output contains areas where both layers intersect. \\
+ \hline \includegraphics[width=0.7cm]{union} & Union & Overlay layers such
+that output contains intersecting and non-intersecting areas. \\
+ \hline \includegraphics[width=0.7cm]{symdiff} & Symetrical difference &
+Overlay layers such that output contains those areas of the input and
+difference layers that do not intersect. \\
+ \hline \includegraphics[width=0.7cm]{clip} & Clip & Overlay layers such
+that output contains areas that intersect the clip layer. \\
+ \hline \includegraphics[width=0.7cm]{erase} & Difference & Overlay layers
+such that output contains areas not intersecting the clip layer. \\
+ \hline \includegraphics[width=0.7cm]{dissolve} & Dissolve & Merge features
+based on input field. All features with indentical input values are combined
+to form one single feature. \\
\hline
\end{tabular}
\end{table}
+\newpage
+
\minisec{Geometry tools}
\begin{table}[ht]\index{Geometry tools}
\centering
\caption{fTool geometry tools}\label{tab:ftool_geometry}\medskip
- \begin{tabular}{|p{0.3in}|p{1.2in}|p{4.7in}|}
+ \begin{tabular}{|p{0.3in}|p{1.2in}|p{4.8in}|}
\hline \textbf{Icon} & \textbf{Tool} & \textbf{Purpose} \\
- \hline \includegraphics[width=0.7cm]{checkgeometry} & Check geometry validity & Check polygon geometries for self-intersections, closed-holes and polygons, and correct node ordering. \\
- \hline \includegraphics[width=0.7cm]{calcgeom} & Export/Add geometry columns & Add vector layer geometry info to point (XCOORD, YCOORD), line (LENGTH), or polygon (AREA, PERIMETER) layer. \\
- \hline \includegraphics[width=0.7cm]{centroids} & Polygon centroids & Calculate the true centroids, or 'center of mass' for each polygon in an input polygon layer. \\
- \hline \includegraphics[width=0.7cm]{simplify} & Simplify geometries & Simplify (generalise) line or polygon vector layers using (a modified) Douglas-Peucker algorithm. \\
- \hline \includegraphics[width=0.7cm]{multitosingle} & Multipart to singleparts & Convert multipart features to multiple singlepart features. Creates simple polygons and lines. \\
- \hline \includegraphics[width=0.7cm]{singletomulti} & Singleparts to multipart & Merge multiple features to a single multipart feature based on a unique ID field. \\
- \hline \includegraphics[width=0.7cm]{polystolines} & Polygons to lines & Convert polygon features to line features. Multipart polygons are converted to multiple singlepart lines. \\
- \hline \includegraphics[width=0.7cm]{extractnodes} & Extract nodes & Extract nodes from line and polygon vector layers and output them as points. \\
+ \hline \includegraphics[width=0.7cm]{checkgeometry} & Check geometry &
+Check polygons for intersections, closed-holes, and fix node ordering. \\
+ \hline \includegraphics[width=0.7cm]{calcgeom} & Export/Add geometry
+columns & Add vector layer geometry info to point (XCOORD, YCOORD),
+line (LENGTH), or polygon (AREA, PERIMETER) layer. \\
+ \hline \includegraphics[width=0.7cm]{centroids} & Polygon centroids &
+Calculate the true centroids for each polygon in an input polygon layer. \\
+ \hline \includegraphics[width=0.7cm]{simplify} & Simplify geometry &
+Generalise lines or polygons with a modified Douglas-Peucker algorithm. \\
+ \hline \includegraphics[width=0.7cm]{multitosingle} & Multipart to
+singleparts & Convert multipart features to multiple singlepart features.
+Creates simple polygons and lines. \\
+ \hline \includegraphics[width=0.7cm]{singletomulti} & Singleparts to
+multipart & Merge multiple features to a single multipart feature based
+on a unique ID field. \\
+ \hline \includegraphics[width=0.7cm]{polystolines} & Polygons to lines
+& Convert polygons to lines, multipart polygons to multiple singlepart lines. \\
+ \hline \includegraphics[width=0.7cm]{extractnodes} & Extract nodes &
+Extract nodes from line and polygon layers and output them as points. \\
\hline
\end{tabular}
\end{table}
@@ -112,13 +143,22 @@
\begin{table}[ht]\index{Data management tools}
\centering
\caption{fTool data management tools}\label{tab:fTool_data_management}\medskip
- \begin{tabular}{|p{0.3in}|p{1.2in}|p{4.7in}|}
+ \begin{tabular}{|p{0.3in}|p{1.3in}|p{4.6in}|}
\hline \textbf{Icon} & \textbf{Tool} & \textbf{Purpose} \\
- \hline \includegraphics[width=0.7cm]{project} & Export to new projection & Based on input CRS, project features to new CRS and export as new shapefile. \\
- \hline \includegraphics[width=0.7cm]{define} & Define current projection & Specify the CRS for shapefiles whose CRS has not been defined. \\
- \hline \includegraphics[width=0.7cm]{joinattr} & Join attributes & Join additional attributes to vector layer attribute table and output results to a new shapefile. Additional attributes can be from a vector layer or stand-alone dbf table. \\
- \hline \includegraphics[width=0.7cm]{spatialjoin} & Join attributes by location & Join additional attributes to vector layer based on spatial relationship. Attributes from one vector layer are appended to the attribute table of another layer and exported as a shapefile \\
- \hline \includegraphics[width=0.7cm]{vectorsplit} & Split vector layer & Split input vector layer into multiple separate vector layers based on input field. \\
+ \hline \includegraphics[width=0.7cm]{project} & Export to projection &
+Project features to new CRS and export as new shapefile. \\
+ \hline \includegraphics[width=0.7cm]{define} & Define projection &
+Specify the CRS for shapefiles whose CRS has not been defined. \\
+ \hline \includegraphics[width=0.7cm]{joinattr} & Join attributes & Join
+additional attributes to vector layer attribute table and output results
+to a new shapefile. Additional attributes can be from a vector layer or
+stand-alone dbf table. \\
+ \hline \includegraphics[width=0.7cm]{spatialjoin} & Join attributes by
+location & Join additional attributes to vector layer based on spatial
+relationship. Attributes from one vector layer are appended to the attribute
+table of another layer and exported as a shapefile \\
+ \hline \includegraphics[width=0.7cm]{vectorsplit} & Split vector layer &
+Split input layer into multiple separate layers based on input field. \\
\hline
\end{tabular}
\end{table}
More information about the QGIS-commit
mailing list