[QGIS Commit] r12958 - in docs/trunk/english_us/user_guide: .
appendices plugins_diagram_overlay_images
working_with_vector_screenies
svn_qgis at osgeo.org
svn_qgis at osgeo.org
Sat Feb 20 10:16:06 EST 2010
Author: dassau
Date: 2010-02-20 10:16:06 -0500 (Sat, 20 Feb 2010)
New Revision: 12958
Modified:
docs/trunk/english_us/user_guide/appendices/grass_toolbox_modules.tex
docs/trunk/english_us/user_guide/plugins_diagram_overlay_images/diagram_tab.png
docs/trunk/english_us/user_guide/working_with_vector.tex
docs/trunk/english_us/user_guide/working_with_vector_screenies/action_identifyaction.png
docs/trunk/english_us/user_guide/working_with_vector_screenies/shapefileloaded.png
docs/trunk/english_us/user_guide/working_with_vector_screenies/shapefileopendialog.png
docs/trunk/english_us/user_guide/working_with_vector_screenies/vectorClassifyContinous.png
docs/trunk/english_us/user_guide/working_with_vector_screenies/vectorClassifyGraduated.png
docs/trunk/english_us/user_guide/working_with_vector_screenies/vectorClassifySingle.png
docs/trunk/english_us/user_guide/working_with_vector_screenies/vectorClassifyUnique.png
docs/trunk/english_us/user_guide/working_with_vector_screenies/vectorLayerSymbology.png
Log:
started updates vector section
Modified: docs/trunk/english_us/user_guide/appendices/grass_toolbox_modules.tex
===================================================================
--- docs/trunk/english_us/user_guide/appendices/grass_toolbox_modules.tex 2010-02-19 20:10:10 UTC (rev 12957)
+++ docs/trunk/english_us/user_guide/appendices/grass_toolbox_modules.tex 2010-02-20 15:16:06 UTC (rev 12958)
@@ -132,7 +132,6 @@
\newpage
-
\begin{table}[ht]
\centering
\caption{GRASS Toolbox: Vector data export modules}\medskip
@@ -154,17 +153,18 @@
\end{tabular}
\end{table}
-begin{table}[ht]
+\begin{table}[ht]
\centering
\caption{GRASS Toolbox: Vector data table}\medskip
\begin{tabular}{|p{4cm}|p{12cm}|}
- \hline \multicolumn{2}{|c|}{\textbf{Vector table export modules in the GRASS
-Toolbox}} \\
+ \hline \multicolumn{2}{|c|}{\textbf{Vector table export modules in the
+GRASS Toolbox}} \\
\hline \textbf{Module name} & \textbf{Purpose} \\
- \hline dbout.ogr & Export attribute table to various formats \\
+ \hline db.out.ogr & Export attribute table to various formats \\
\hline
\end{tabular}
\end{table}
+
\newpage
\subsection{GRASS Toolbox data type conversion modules}
Modified: docs/trunk/english_us/user_guide/plugins_diagram_overlay_images/diagram_tab.png
===================================================================
(Binary files differ)
Modified: docs/trunk/english_us/user_guide/working_with_vector.tex
===================================================================
--- docs/trunk/english_us/user_guide/working_with_vector.tex 2010-02-19 20:10:10 UTC (rev 12957)
+++ docs/trunk/english_us/user_guide/working_with_vector.tex 2010-02-20 15:16:06 UTC (rev 12958)
@@ -73,8 +73,8 @@
\end{figure}
\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}.
+QGIS and click on the \toolbtntwo{mActionAddNonDbLayer}{Add Vector Layer}
+toolbar button\index{shapefile!loading} or simply type \keystroke{Ctrl-Shift-V}.
This will bring up a new window (see Figure\ref{fig:addvectorlayer}).
From the available options check \radiobuttonon{File}. Click on \button{Browse}.
@@ -130,19 +130,18 @@
\subsubsection{Loading a MapInfo Layer}
\index{vector layers!MapInfo}
-To load a MapInfo layer, click on the
-\toolbtntwo{mActionAddNonDbLayer}{Add a vector layer}
-toolbar bar button or type \keystroke{V}, change the file type filter to
-\selectstring{Files of Type}{[OGR] MapInfo (*.mif
+To load a MapInfo layer, click on the \toolbtntwo{mActionAddNonDbLayer}{Add
+Vector Layer} toolbar bar button or type \keystroke{Ctrl-Shift-V}, change the
+file type filter to \selectstring{Files of Type}{[OGR] MapInfo (*.mif
*.tab *.MIF *.TAB)} and select the layer you want to load.
\subsubsection{Loading an ArcInfo Binary Coverage}
\index{vector layers!ArcInfo Binary Coverage}
-To load an ArcInfo binary coverage click on the
-\toolbtntwo{mActionAddNonDbLayer}{Add a vector layer}
-toolbar button or type \keystroke{V} to open the
-\dialog{Add Vector Layer} dialog. Select \radiobuttonon{Directory}. Change to \selectstring {Type}{Arc/Ingo Binary Coverage}.
+To load an ArcInfo binary coverage click on the
+\toolbtntwo{mActionAddNonDbLayer}{Add Vector Layer} toolbar button or type
+\keystroke{Ctrl-Shift-V} to open the \dialog{Add Vector Layer} dialog. Select
+\radiobuttonon{Directory}. Change to \selectstring {Type}{Arc/Info Binary Coverage}.
Navigate to the directory that contains the coverage files and select it.
Similarly, you can load directory based vector files in the UK National Transfer Format as well as the
@@ -177,10 +176,10 @@
\includegraphics[width=0.7cm]{mActionAddLayer} The first time
you use a PostGIS data source, you must create a connection to the PostgreSQL
database that contains the data. Begin by clicking on the
-\toolbtntwo{mActionAddLayer}{Add a PostGIS Layer} toolbar button, selecting the
-\dropmenuopttwo{mActionAddLayer}{Add a PostGIS Layer...} option from the \mainmenuopt{Layer} menu or typing
-\keystroke{D}. You can also open the open the
-\dialog{Add Vector Layer} dialog and select \radiobuttonon{Database}.
+\toolbtntwo{mActionAddLayer}{Add PostGIS Layer} toolbar button, selecting the
+\dropmenuopttwo{mActionAddLayer}{Add PostGIS Layer...} option from the
+\mainmenuopt{Layer} menu or typing \keystroke{Ctrl-Shift-D}. You can also
+open the \dialog{Add Vector Layer} dialog and select \radiobuttonon{Database}.
The \dialog{Add PostGIS Table(s)} dialog will
be displayed. To access the connection manager\index{PostgreSQL!connection
manager}, click on the \button{New} button to display the \dialog{Create a New
@@ -250,7 +249,7 @@
\begin{itemize}
\item If the \dialog{Add PostGIS Table(s)} dialog is not already open, click on the
-\toolbtntwo{mActionAddLayer}{Add a PostGIS Layer} toolbar button.
+\toolbtntwo{mActionAddLayer}{Add PostGIS Layer} toolbar button.
\item Choose the connection from the drop-down list and click \button{Connect}.
\item Find the layer you wish to add in the list of available layers.
\item Select it by clicking on it. You can select multiple layers by holding
@@ -283,8 +282,8 @@
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. 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,
+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).
@@ -302,6 +301,7 @@
column (a type of int4 and either a primary key or with a unique constraint,
preferably indexed).
+%%FIXME: Add missing information
When dealing with views, QGIS parses the view definition and
\subsubsection{Importing Data into PostgreSQL}\label{sec:loading_postgis_data}
@@ -500,15 +500,14 @@
\subsection{The Vector Properties Dialog}\label{sec:vectorprops}
\index{vector layers!properties dialog}
-The \dialog{Layer Properties} dialog for a vector layer
-provides information about the layer, symbology
-settings and labeling options. If your vector layer has been loaded from a
-PostgreSQL / PostGIS datastore, you can also alter the underlying SQL for the
-layer - either by hand editing the SQL on the \tab{General} tab or by
-invoking the \dialog{Query Builder} dialog on the \tab{General} tab.
-To access the
-\dialog{Layer Properties} dialog, double-click on a layer in the legend or right-click on the
-layer and select \dropmenuopt{Properties} from the popup menu.
+The \dialog{Layer Properties} dialog for a vector layer provides information
+about the layer, symbology settings and labeling options. If your vector
+layer has been loaded from a PostgreSQL/PostGIS datastore, you can also alter
+the underlying SQL for the layer by invoking the \dialog{Query Builder}
+dialog on the \tab{General} tab.
+To access the \dialog{Layer Properties} dialog, double-click on a layer in
+the legend or right-click on the layer and select \dropmenuopt{Properties}
+from the popup menu.
\begin{figure}[H]
\begin{center}
@@ -517,16 +516,6 @@
\end{center}
\end{figure}
-\subsubsection{General Tab}\label{vectorgeneraltab}
-The \tab{General} tab is essentially like that of the raster dialog. It allows you
-to change the display name, set scale dependent rendering options, create a spatial
-index of the vector file (only for OGR supported formats and PostGIS) and view or
-change the projection of the specific vetor layer.
-
-The \button{Query Builder} button allows you to create a subset of the features
-in the layer - but this button currently only is available when you open the
-attribute table and select the \button{...} button next to Advanced search.
-
\subsubsection{Symbology Tab}\label{sec:symbology}
\index{vector layers!symbology}
@@ -572,17 +561,25 @@
At least the following styling options apply for nearly all renderers:
\begin{description}
- \item[Outline style] - pen-style for your outline of your feature. you can
+\item[Fill options]
+\begin{description}
+ \item[Fill style] - Style for filling. Beside the given brushes you can
+ select \selectstring{}{? Texture} and click the \browsebutton
+ button for selecting your own texture file. Currently the fileformats
+ \filename{*.jpeg, *.xpm, and *.png} are supported.
+ \item[Fill color] - fill-color of your features.
+\end{description}
+\item[Outline options]
+\begin{description}
+ \item[Outline style] - pen-style for your outline of your feature. You can
also set this to 'no pen'.
\item[Outline color] - color of the ouline of your feature
\item[Outline width] - width of your features
- \item[Fill color] - fill-color of your features.
- \item[Fill style] - Style for filling. Beside the given brushes you can
- select \selectstring{Fill style}{? texture} and click the \browsebutton
- button for selecting your own fill-style. Currently the fileformats
- \filename{*.jpeg, *.xpm, and *.png} are supported.
\end{description}
+\end{description}
+%%FIXME Add new symbology minisec
+
Once you have styled your layer you also could save your layer-style to a
separate file (with \filename{*.qml}-ending).
To do this, use the button \button{Save Style \ldots}. No need to say that
@@ -591,22 +588,14 @@
If you wish to always use a particular style whenever the layer is loaded,
use the \button{Save As Default} button to make your style the default. Also,
if you make changes to the style that you are not happy with, use the \button{Restore
-Default Styel} button to revert to your default style.
+Default Style} button to revert to your default style.
\minisec{Vector transparency} \label{sec:vect_transparency} \index{vector layers!transparency}
-QGIS \CURRENT allows to set a transparency for every vector layer. This can be done with
-the slider \slider{Transparency}{0}{20mm} inside the \tab{symbology} tab (see fig. \ref{fig:vector_symbology}).
-This is very useful for overlaying several vector layers.
+QGIS allows to set a transparency for every vector layer. This can be done with
+the slider \slider{Transparency}{0}{20mm} inside the \tab{symbology} tab (see
+fig. \ref{fig:vector_symbology}). This is very useful for overlaying several
+vector layers.
-\subsubsection{Metadata Tab}
-
-The \tab{Metadata} tab contains information about the layer, including specifics
-about the type and location, number of features, feature type, and the editing
-capabilities. The \guiheading{Layer Spatial Reference System} section, providing
-projection information, and the \guiheading{Attribute field info} section,
-listing fields and their data types, are displayed
-on this tab. This is a quick way to get information about the layer.
-
\subsubsection{Labels Tab}
The \tab{Labels} tab allows you to enable labeling features and control a number of
@@ -625,11 +614,13 @@
\item Choose the field to label with.
We'll use \selectstring{Field containing label}{NAMES}.
\item Enter a default for lakes that have no name. The default label will be
- used each time QGIS encounters a lake with no value in the \guilabel{NAMES} field.
-\item If have labels extending over several lines, check \checkbox{Multiline labels?}.
-QGIS will check for a true line return in your label field and insert the line breaks accordingly.
-A true line return is a \textbf{single} character \textbackslash n,
-(not two separate characters, like a backlash \textbackslash ~followed by the character n).
+ used each time QGIS encounters a lake with no value in the \guilabel{NAMES}
+field.
+\item If have labels extending over several lines, check \checkbox{Multiline
+labels?}. QGIS will check for a true line return in your label field and
+insert the line breaks accordingly. A true line return is a \textbf{single}
+character \textbackslash n, (not two separate characters, like a backlash
+\textbackslash ~followed by the character n).
\item Click \button{Apply}.
\end{enumerate}
@@ -686,8 +677,79 @@
Not that the \tab{Label} tab provides a \classname{preview-box} where your
selected label is shown.
-\subsubsection{Actions Tab}\index{actions}\label{label_actions}
+\subsubsection{Attributes Tab}\index{Attributes}\label{label_attributes}
+Within the \tab{Attributes} tab the attributes of the selected dataset can be
+manipulated. The buttons \toolbtntwo{mActionNewAttribute}{New Column} and
+\toolbtntwo{mActionDeleteAttribute}{Delete Column} can be
+used, when the dataset is \toolbtntwo{mActionToggleEditing}{editing mode}.
+At the moment only columns from PostGIS layers can be removed and added. The
+OGR library supports to add new columns, but not to remove them, if you have
+a GDAL version >= 1.6 installed.
+
+\minisec{edit widget}
+
+\begin{figure}[H]
+ \begin{center}
+ \caption{Dialog to select an edit widget for an attribute column
+\nixcaption}\label{fig:editwidget}\smallskip
+ \includegraphics[clip=true, width=14cm]{editwidgetsdialog}
+\end{center}
+\end{figure}
+
+Within the \tab{Attributes} tab you also find an \texttt{edit widget} column.
+This column can be used to define values or a range of values that are
+allowed
+to be added to the specific attribute table column. If you click on the
+\button{edit widget} button, a dialog opens, where you can define different
+widgets. These widgets are:
+
+\begin{itemize}
+\item Line edit: an edit field which allows to enter simple text (or restrict
+to
+numbers for numeric attributes).
+\item Classification: Displays a combo box with the values used for
+classification, if you have chosen 'unique value' as legend type in the
+symbology tab of the properties dialog.
+\item Range: Allows to set numeric values from a specific range. The edit
+widget can be either a slider or a spin box.
+\item Unique value: The user can select one of the values already used in the
+attribute table. If editable is activated, a line edit is shown with
+autocompletion support, otherwise a combo box is used.
+\item File name: Simplifies the selection by adding a file chooser dialog.
+\item Value map: a combo box with predefined items. The value is stored in
+the attribute, the description is shown in the comboo box. You can define
+values manually or load them from a layer or a csv file.
+\item Enumeration: Opens a combo box with values that can be used within the
+columns type. This is currently only supported by the postgres provider.
+\item Immutable: The immutable attribute column is read-only. The user is not
+able to modify the content.
+\end{itemize}
+
+\subsubsection{General Tab}\label{vectorgeneraltab}
+
+The \tab{General} tab is essentially like that of the raster dialog. It
+allows you to change the display name, set scale dependent rendering options,
+create a spatial index of the vector file (only for OGR supported formats and
+PostGIS) and view or change the projection of the specific vetor layer.
+
+The \button{Query Builder} button allows you to create a subset of the
+features in the layer - but this button currently only is available when you
+open the attribute table and select the \button{...} button next to Advanced
+search.
+
+\subsubsection{Metadata Tab}\index{Metadata}
+
+The \tab{Metadata} tab contains general information about the layer,
+including specifics about the type and location, number of features, feature
+type, and the editing capabilities. The \guiheading{Extents} section,
+providing
+layer extent information, and the \guiheading{Layer Spatial Reference System}
+section, providing information about the CRS of the layer. This is a quick
+way to get information about the layer, but is not yet editable.
+
+\subsubsection{Actions Tab}\index{Actions}\label{label_actions}
+
QGIS provides the ability to perform an action based on the attributes of a
feature. This can be used to perform any number of actions, for example,
running a program with arguments built from the attributes of a feature or
@@ -751,17 +813,14 @@
the value of the selected field in the identify results or attribute table.
\minisec{Using Actions}\index{actions!using}\label{label_usingactions}
+
Actions can be invoked from either the \dialog{Identify Results} dialog or an
- \dialog{Attribute Table} dialog.
-(Recall that these dialogs can be opened by clicking
-\toolbtntwo{mActionOpenTable}{Identify Features}
-or
-\toolbtntwo{mActionOpenTable}{Open Table}.)
-To invoke an action,
-right click on the
-record and choose the action from the popup menu. Actions are listed in the popup
-menu by the name you assigned when defining the actions. Click on the action you
-wish to invoke.
+\dialog{Attribute Table} dialog. (Recall that these dialogs can be opened by
+clicking \toolbtntwo{mActionIdentify}{Identify Features} or
+\toolbtntwo{mActionOpenTable}{Open Attribute Table}.) To invoke an action,
+right click on the record and choose the action from the popup menu. Actions
+are listed in the popup menu by the name you assigned when defining the
+actions. Click on the action you wish to invoke.
If you are invoking an action that uses the \%\% notation, right-click on the
field value in the \dialog{Identify Results} dialog or the
@@ -846,9 +905,11 @@
is just no other field available that would make sense to search for.
You can define multiple actions for a layer and each will show up in the
-\dialog{Identify Results} dialog. You can also invoke actions from the attribute table
-by selecting a row and right-clicking, then choosing the action from the popup
-menu.
+\dialog{Identify Results} dialog.
+%% FIXME No longer valid??
+%%You can also invoke actions from the attribute table
+%%by selecting a row and right-clicking, then choosing the action from the popup
+%%menu.
You can think of all kinds of uses for actions. For example, if you have a point layer
containing locations of images or photos along with a file name, you could
@@ -856,42 +917,6 @@
actions to launch web-based reports for an attribute field or combination of
fields, specifying them in the same way we did in our Google search example.
-\subsubsection{Attributes Tab}\index{attributes}\label{label_attributes}
-Within the \tab{Attributes} tab the attributes of the selected dataset can be
-manipulated. The buttons \toolbtntwo{mActionNewAttribute}{New Column} and
-\toolbtntwo{mActionDeleteAttribute}{Delete Column} can be
-used, when the dataset is \toolbtntwo{mActionToggleEditing}{editing mode}.
-At the moment only columns from PostGIS layers can be removed and added. The
-OGR library supports to add new columns, but not to remove them, if you have
-a GDAL version >= 1.6 installed.
-
-\minisec{edit widget}
-
-\begin{figure}[H]
- \begin{center}
- \caption{Dialog to select an edit widget for an attribute column \nixcaption}\label{fig:editwidget}\smallskip
- \includegraphics[clip=true, width=14cm]{editwidgetsdialog}
-\end{center}
-\end{figure}
-
-Within the \tab{Attributes} tab you also find an \texttt{edit widget} column.
-This column can be used to define values or a range of values that are allowed
-to be added to the specific attribute table column. If you click on the
-\button{edit widget} button, a dialog opens, where you can define different
-widgets. These widgets are:
-
-\begin{itemize}
-\item Line edit: an edit field which allows to enter simple text (or restrict to
-numbers for numeric attributes).
-\item Classification: Displays a combo box with the values used for classification, if you have chosen 'unique value' as legend type in the symbology tab of the properties dialog.
-\item Range: Allows to set numeric values from a specific range. The edit widget can be either a slider or a spin box.
-\item Unique value: The user can select one of the values already used in the attribute table. If editable is activated, a line edit is shown with autocompletion support, otherwise a combo box is used.
-\item File name: Simplifies the selection by adding a file chooser dialog.
-\item Value map: a combo box with predefined items. The value is stored in the attribute, the description is shown in the comboo box. You can define values manually or load them from a layer or a csv file.
-\item Enumeration: Opens a combo box with values that can be used within the columns type. This is currently only supported by the postgres provider.
-\item Immutable: The immutable attribute column is read-only. The user is not able to modify the content.
-\end{itemize}
-
\subsubsection{Diagram Tab}\label{sec:diagram}
\index{vector layers!diagram}
@@ -924,7 +949,7 @@
\item Click on the \tab{Diagram Overlay} and select \button{Bar chart} as
Diagram type.
\item In the diagram we want to display the values of the three columns
-\filename{T\_F\_JAN, T\_F\_JAN} and \filename{T\_F\_MEAN}. First select
+\filename{T\_F\_JAN, T\_F\_JUL} and \filename{T\_F\_MEAN}. First select
\filename{T\_F\_JAN} as Attributes and click \button{Add attribute}, then
\filename{T\_F\_JUL} and finally \filename{T\_F\_MEAN}.
\item For linear scaling of the diagram size we define \filename{T\_F\_JUL}
@@ -937,6 +962,8 @@
\item Finally click \button{Ok}.
\end{enumerate}
+%% FIXME: Does not work in 1.4?
+
\begin{figure}[ht]
\begin{center}
\caption{Diagram from temperature data overlayed on a map \nixcaption}\label{fig:climatediagram}\smallskip
Modified: docs/trunk/english_us/user_guide/working_with_vector_screenies/action_identifyaction.png
===================================================================
(Binary files differ)
Modified: docs/trunk/english_us/user_guide/working_with_vector_screenies/shapefileloaded.png
===================================================================
(Binary files differ)
Modified: docs/trunk/english_us/user_guide/working_with_vector_screenies/shapefileopendialog.png
===================================================================
(Binary files differ)
Modified: docs/trunk/english_us/user_guide/working_with_vector_screenies/vectorClassifyContinous.png
===================================================================
(Binary files differ)
Modified: docs/trunk/english_us/user_guide/working_with_vector_screenies/vectorClassifyGraduated.png
===================================================================
(Binary files differ)
Modified: docs/trunk/english_us/user_guide/working_with_vector_screenies/vectorClassifySingle.png
===================================================================
(Binary files differ)
Modified: docs/trunk/english_us/user_guide/working_with_vector_screenies/vectorClassifyUnique.png
===================================================================
(Binary files differ)
Modified: docs/trunk/english_us/user_guide/working_with_vector_screenies/vectorLayerSymbology.png
===================================================================
(Binary files differ)
More information about the QGIS-commit
mailing list