[QGIS Commit] r10685 - in docs/trunk/english_us/user_guide: .
working_with_vector_screenies
svn_qgis at osgeo.org
svn_qgis at osgeo.org
Thu Apr 30 02:57:19 EDT 2009
Author: cengel
Date: 2009-04-30 02:57:18 -0400 (Thu, 30 Apr 2009)
New Revision: 10685
Modified:
docs/trunk/english_us/user_guide/working_with_vector.tex
docs/trunk/english_us/user_guide/working_with_vector_screenies/editProjectSnapping.png
Log:
added subsections
edited changes for postgis sll, improved handling of postgis and pixels as
map units in chap 5
Modified: docs/trunk/english_us/user_guide/working_with_vector.tex
===================================================================
--- docs/trunk/english_us/user_guide/working_with_vector.tex 2009-04-29 10:40:04 UTC (rev 10684)
+++ docs/trunk/english_us/user_guide/working_with_vector.tex 2009-04-30 06:57:18 UTC (rev 10685)
@@ -5,7 +5,7 @@
% when the revision of a section has been finalized,
% comment out the following line:
-% \updatedisclaimer
+\updatedisclaimer
QGIS supports vector data in a number of formats, including those
@@ -20,9 +20,9 @@
Support for additional data types (eg. delimited text) is provided by
additional data provider plugins.\index{delimited text}
-This section describes how to work with two common formats:
-ESRI shapefiles and PostGIS layers. Many of the
-features available in QGIS work the same regardless of the vector data source.
+This section describes how to work with several common formats:
+ESRI shapefiles, PostGIS layers, and SpatialLite layers. Many of the
+features available in QGIS work the same, regardless of the vector data source.
This is by design and includes the identify, select, labeling and attributes
functions.
@@ -34,9 +34,9 @@
\index{ESRI!shapefiles}
\index{SHP files}
-The standard vector file format used in QGIS is the ESRI Shapefile. It's support
+The standard vector file format used in QGIS is the ESRI Shapefile. Support
is provided by the OGR Simple Feature Library (\url{http://www.gdal.org/ogr/})
-\index{OGR}. A shapefile actually consists of a minimum of three files:
+\index{OGR}. A shapefile actually consists of several files. The following three are required:
\index{shapefile!format}
\begin{itemize}
@@ -45,20 +45,19 @@
\item \filename{.shx} index file.
\end{itemize}
-Ideally it comes with another file with a \filename{.prj} suffix, that contains
-the projection information for the shapefile. There can be more files belonging
-to a shapefile dataset. To have a closer look at this we recommend the technical
-specification for the shapefile format, that can be found at \url{http://www.esri.com/library/whitepapers/pdfs/shapefile.pdf}.
+Shapefiles also can include a file with a \filename{.prj} suffix, which contains
+the projection information. While it is very useful to have a projection file, it is not mandatory. A shapefile dataset can contain additional files. For further details see the ESRI technical specification at \url{http://www.esri.com/library/whitepapers/pdfs/shapefile.pdf}.
\index{shapefile!specification}.
\subsubsection{Loading a Shapefile}\label{sec:load_shapefile}
\includegraphics[width=0.7cm]{mActionAddNonDbLayer}
To load a shapefile, start
QGIS and click on the \toolbtntwo{mActionAddNonDbLayer}{Add a vector layer}
-toolbar button\index{shapefile!loading} or simply type \keystroke{V}. This same tool can be used to
-load any of the formats supported by the OGR library.
+toolbar button\index{shapefile!loading} or simply type \keystroke{V}.
-Clicking on the tool brings up a standard open file dialog (see Figure
+This will bring up a new window (see Figure -- NEEDS TO BE ADDED). From the available options check the File box.
+
+That will bring up a standard open file dialog (see Figure
\ref{fig:openshapefile}) which allows you to navigate the file system and load
a shapefile or other supported data source.
The selection box \selectstring{Files of type}{\ldots} allows you to preselect some OGR supported file formats.
@@ -195,6 +194,14 @@
database. \\
\hline Password \index{PostgreSQL!password}& Password used with
\textsl{Username} to connect to the database.\\
+\hline SSL mode \index{PostgreSQL!sslmode}& How the SSL connection will be negotiated with the server. These are the options:
+\begin {itemize}
+\item disable: only try an unencrypted SSL connection;
+\item allow: try a non-SSL connection, if that fails, try an SSL connection;
+\item prefer (the default): try an SSL connection, if that fails, try a non-SSL connection;
+\item require: only try an SSL connection.
+\end {itemize}
+Note that massive speedups in PostGIS layer rendering can be achieved by disabling SSL in the connection editor. \\
\hline
\end{tabular}
\end{table}
@@ -264,8 +271,9 @@
QGIS requires that PostgreSQL layers contain a column that can be
used as a unique key for the layer. For tables this usually means
that the table needs a primary key, or a column with a unique
-constraint on it. QGIS additionally requires that this column be of
-type int4 (an integer of size 4 bytes). If a table lacks these items,
+constraint on it. In QGIS, this column needs to be of
+type int4 (an integer of size 4 bytes). Alternatively the ctid column can be used as primary key.
+If a table lacks these items,
the oid column will be used instead. Performance will be improved if the
column is indexed (note that primary keys are automatically indexed in
PostgreSQL).
@@ -414,6 +422,14 @@
gsherman at madison:~/current$
\end{verbatim}
+\subsection{SpatiaLite Layers}
+\index{SpatiaLite layers!properties dialog}
+\index{vector layers!SpatlaLIte|see{SpatiaLite}}
+\index{SpatiaLite!layers}
+\label{label_spatialite}
+
+Needs to be written...
+
\subsection{The Vector Properties Dialog}\label{sec:vectorprops}
\index{vector layers!properties dialog}
@@ -814,6 +830,19 @@
it allows to select a filename using the standard file dialog.
\end{itemize}
+\subsubsection{Diagram Tab}\label{sec:diagram}
+\index{vector layers!diagram}
+
+Needs to be finished.
+
+The \tab{Diagram} tab allows you to add a grahic overlay to a vector layer.
+To activate this feature, open the plugin manager and select the 'Diagram Overlay'
+plugin. After this, there is a new tab in the vector layer properties dialog
+where the settings for diagrams may be entered.
+The current implementation of diagrams provides support for pie- and barcharts
+and for linear scaling of the diagram size according to a classification
+attribute.
+
\subsection{Editing}\index{editing}
QGIS supports basic capabilities for editing vector geometries. Before reading any
@@ -840,16 +869,17 @@
\begin{enumerate}
\item A general, project wide snapping tolerance can be defined choosing
-\mainmenuopt{Settings} > \dropmenuopttwo{mActionOptions}{Options}
+\mainmenuopt{Settings} > \dropmenuopttwo{mActionOptions}{Options}.
+(On Mac: go to \mainmenuopt{QGIS} > Preferences, on Linux: \mainmenuopt{Edit} > \dropmenuopttwo{mActionOptions}{Options}.)
In the \tab{Digitizing} tab you can select between to vertex, to segment or
to vertex and segment as default snap mode. You can also define a default
-snapping tolerance and a search radius for vertex edits. Remember the
-tolerance is in layer units. In our digitizing project (working with the
+snapping tolerance and a search radius for vertex edits. The tolerance an be set either in map units or in pixels.
+In our digitizing project (working with the
Alaska dataset), the units are in feet. Your results may vary, but something
on the order of 300ft should be fine at a scale of 1:10 000 should be a
reasonable setting.
\item A layer based snapping tolerance can be defined by choosing
-\mainmenuopt{Settings} > \dropmenuopttwo{mActionOptions}{Project
+\mainmenuopt{Settings} (or \mainmenuopt{File}) > \dropmenuopttwo{mActionOptions}{Project
Properties\dots}. In the \tab{General} tab, section \classname{Digitize} you
can click on \button{Snapping options\dots} to enable and adjust snapping
mode and tolerance on a layer basis (see Figure~\ref{fig:snappingoptions}).
@@ -868,7 +898,7 @@
vertex you are trying to move when you click on the
map. If you aren't within the search radius, QGIS won't find and select
any vertex for editing and it will pop up an annoying warning to that effect.
-Snap tolerance and search radius are set in map units so you may find you
+Snap tolerance and search radius are set in map units or pixels, so you may find you
need to experiment to get them set right. If you specify too big of a
tolerance, QGIS may snap to the wrong vertex, especially if you are dealing
with a large number of vertices in close proximity. Set search radius too
@@ -1238,7 +1268,8 @@
QGIS allows digitized vertices to be snapped to other vertices of the same layer. To
set the snapping tolerance, go to
\mainmenuopt{Settings}>\dropmenuopttwo{mActionOptions}{Options}->\tab{Digitizing}.
-Note that the snapping tolerance is in map units.
+(On Mac: go to \mainmenuopt{QGIS} > Preferences, on Linux: \mainmenuopt{Edit} > \dropmenuopttwo{mActionOptions}{Options}.)
+Note that the snapping tolerance is in map units or pixels.
\minisec{Saving Edited Layers}
\index{editing!saving changes}
@@ -1285,6 +1316,11 @@
the layer has been created, it will be added to the map and you can edit it in
the same way as described in Section \ref{sec:edit_existing_layer} above.
+\subsubsection{Working with the Attribute Table}\label{sec:attribute table}\index{editing!working with the attribute table}
+
+Needs to be written.
+
+
\subsection{Query Builder}\label{sec:query_builder}
\index{Query Builder}
Modified: docs/trunk/english_us/user_guide/working_with_vector_screenies/editProjectSnapping.png
===================================================================
(Binary files differ)
More information about the QGIS-commit
mailing list