% Generated by Sphinx.
\def\sphinxdocclass{report}
\documentclass[a4paper,10pt,french]{sphinxmanual}
\usepackage[utf8]{inputenc}
\DeclareUnicodeCharacter{00A0}{\nobreakspace}
\usepackage{cmap}
\usepackage[T1]{fontenc}
\usepackage{babel}
\usepackage{times}
\usepackage[Sonny]{fncychap}
\usepackage{longtable}
\usepackage{sphinx}
\usepackage{multirow}


\title{QGIS User Guide}
\date{10 November 2013}
\release{1.8}
\author{QGIS Project}
\newcommand{\sphinxlogo}{}
\renewcommand{\releasename}{Version}
\makeindex

\makeatletter
\def\PYG@reset{\let\PYG@it=\relax \let\PYG@bf=\relax%
    \let\PYG@ul=\relax \let\PYG@tc=\relax%
    \let\PYG@bc=\relax \let\PYG@ff=\relax}
\def\PYG@tok#1{\csname PYG@tok@#1\endcsname}
\def\PYG@toks#1+{\ifx\relax#1\empty\else%
    \PYG@tok{#1}\expandafter\PYG@toks\fi}
\def\PYG@do#1{\PYG@bc{\PYG@tc{\PYG@ul{%
    \PYG@it{\PYG@bf{\PYG@ff{#1}}}}}}}
\def\PYG#1#2{\PYG@reset\PYG@toks#1+\relax+\PYG@do{#2}}

\expandafter\def\csname PYG@tok@gd\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.63,0.00,0.00}{##1}}}
\expandafter\def\csname PYG@tok@gu\endcsname{\let\PYG@bf=\textbf\def\PYG@tc##1{\textcolor[rgb]{0.50,0.00,0.50}{##1}}}
\expandafter\def\csname PYG@tok@gt\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.00,0.27,0.87}{##1}}}
\expandafter\def\csname PYG@tok@gs\endcsname{\let\PYG@bf=\textbf}
\expandafter\def\csname PYG@tok@gr\endcsname{\def\PYG@tc##1{\textcolor[rgb]{1.00,0.00,0.00}{##1}}}
\expandafter\def\csname PYG@tok@cm\endcsname{\let\PYG@it=\textit\def\PYG@tc##1{\textcolor[rgb]{0.25,0.50,0.56}{##1}}}
\expandafter\def\csname PYG@tok@vg\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.73,0.38,0.84}{##1}}}
\expandafter\def\csname PYG@tok@m\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.13,0.50,0.31}{##1}}}
\expandafter\def\csname PYG@tok@mh\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.13,0.50,0.31}{##1}}}
\expandafter\def\csname PYG@tok@cs\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.25,0.50,0.56}{##1}}\def\PYG@bc##1{\setlength{\fboxsep}{0pt}\colorbox[rgb]{1.00,0.94,0.94}{\strut ##1}}}
\expandafter\def\csname PYG@tok@ge\endcsname{\let\PYG@it=\textit}
\expandafter\def\csname PYG@tok@vc\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.73,0.38,0.84}{##1}}}
\expandafter\def\csname PYG@tok@il\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.13,0.50,0.31}{##1}}}
\expandafter\def\csname PYG@tok@go\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.20,0.20,0.20}{##1}}}
\expandafter\def\csname PYG@tok@cp\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.00,0.44,0.13}{##1}}}
\expandafter\def\csname PYG@tok@gi\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.00,0.63,0.00}{##1}}}
\expandafter\def\csname PYG@tok@gh\endcsname{\let\PYG@bf=\textbf\def\PYG@tc##1{\textcolor[rgb]{0.00,0.00,0.50}{##1}}}
\expandafter\def\csname PYG@tok@ni\endcsname{\let\PYG@bf=\textbf\def\PYG@tc##1{\textcolor[rgb]{0.84,0.33,0.22}{##1}}}
\expandafter\def\csname PYG@tok@nl\endcsname{\let\PYG@bf=\textbf\def\PYG@tc##1{\textcolor[rgb]{0.00,0.13,0.44}{##1}}}
\expandafter\def\csname PYG@tok@nn\endcsname{\let\PYG@bf=\textbf\def\PYG@tc##1{\textcolor[rgb]{0.05,0.52,0.71}{##1}}}
\expandafter\def\csname PYG@tok@no\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.38,0.68,0.84}{##1}}}
\expandafter\def\csname PYG@tok@na\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.25,0.44,0.63}{##1}}}
\expandafter\def\csname PYG@tok@nb\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.00,0.44,0.13}{##1}}}
\expandafter\def\csname PYG@tok@nc\endcsname{\let\PYG@bf=\textbf\def\PYG@tc##1{\textcolor[rgb]{0.05,0.52,0.71}{##1}}}
\expandafter\def\csname PYG@tok@nd\endcsname{\let\PYG@bf=\textbf\def\PYG@tc##1{\textcolor[rgb]{0.33,0.33,0.33}{##1}}}
\expandafter\def\csname PYG@tok@ne\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.00,0.44,0.13}{##1}}}
\expandafter\def\csname PYG@tok@nf\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.02,0.16,0.49}{##1}}}
\expandafter\def\csname PYG@tok@si\endcsname{\let\PYG@it=\textit\def\PYG@tc##1{\textcolor[rgb]{0.44,0.63,0.82}{##1}}}
\expandafter\def\csname PYG@tok@s2\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.25,0.44,0.63}{##1}}}
\expandafter\def\csname PYG@tok@vi\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.73,0.38,0.84}{##1}}}
\expandafter\def\csname PYG@tok@nt\endcsname{\let\PYG@bf=\textbf\def\PYG@tc##1{\textcolor[rgb]{0.02,0.16,0.45}{##1}}}
\expandafter\def\csname PYG@tok@nv\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.73,0.38,0.84}{##1}}}
\expandafter\def\csname PYG@tok@s1\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.25,0.44,0.63}{##1}}}
\expandafter\def\csname PYG@tok@gp\endcsname{\let\PYG@bf=\textbf\def\PYG@tc##1{\textcolor[rgb]{0.78,0.36,0.04}{##1}}}
\expandafter\def\csname PYG@tok@sh\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.25,0.44,0.63}{##1}}}
\expandafter\def\csname PYG@tok@ow\endcsname{\let\PYG@bf=\textbf\def\PYG@tc##1{\textcolor[rgb]{0.00,0.44,0.13}{##1}}}
\expandafter\def\csname PYG@tok@sx\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.78,0.36,0.04}{##1}}}
\expandafter\def\csname PYG@tok@bp\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.00,0.44,0.13}{##1}}}
\expandafter\def\csname PYG@tok@c1\endcsname{\let\PYG@it=\textit\def\PYG@tc##1{\textcolor[rgb]{0.25,0.50,0.56}{##1}}}
\expandafter\def\csname PYG@tok@kc\endcsname{\let\PYG@bf=\textbf\def\PYG@tc##1{\textcolor[rgb]{0.00,0.44,0.13}{##1}}}
\expandafter\def\csname PYG@tok@c\endcsname{\let\PYG@it=\textit\def\PYG@tc##1{\textcolor[rgb]{0.25,0.50,0.56}{##1}}}
\expandafter\def\csname PYG@tok@mf\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.13,0.50,0.31}{##1}}}
\expandafter\def\csname PYG@tok@err\endcsname{\def\PYG@bc##1{\setlength{\fboxsep}{0pt}\fcolorbox[rgb]{1.00,0.00,0.00}{1,1,1}{\strut ##1}}}
\expandafter\def\csname PYG@tok@kd\endcsname{\let\PYG@bf=\textbf\def\PYG@tc##1{\textcolor[rgb]{0.00,0.44,0.13}{##1}}}
\expandafter\def\csname PYG@tok@ss\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.32,0.47,0.09}{##1}}}
\expandafter\def\csname PYG@tok@sr\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.14,0.33,0.53}{##1}}}
\expandafter\def\csname PYG@tok@mo\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.13,0.50,0.31}{##1}}}
\expandafter\def\csname PYG@tok@mi\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.13,0.50,0.31}{##1}}}
\expandafter\def\csname PYG@tok@kn\endcsname{\let\PYG@bf=\textbf\def\PYG@tc##1{\textcolor[rgb]{0.00,0.44,0.13}{##1}}}
\expandafter\def\csname PYG@tok@o\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.40,0.40,0.40}{##1}}}
\expandafter\def\csname PYG@tok@kr\endcsname{\let\PYG@bf=\textbf\def\PYG@tc##1{\textcolor[rgb]{0.00,0.44,0.13}{##1}}}
\expandafter\def\csname PYG@tok@s\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.25,0.44,0.63}{##1}}}
\expandafter\def\csname PYG@tok@kp\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.00,0.44,0.13}{##1}}}
\expandafter\def\csname PYG@tok@w\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.73,0.73,0.73}{##1}}}
\expandafter\def\csname PYG@tok@kt\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.56,0.13,0.00}{##1}}}
\expandafter\def\csname PYG@tok@sc\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.25,0.44,0.63}{##1}}}
\expandafter\def\csname PYG@tok@sb\endcsname{\def\PYG@tc##1{\textcolor[rgb]{0.25,0.44,0.63}{##1}}}
\expandafter\def\csname PYG@tok@k\endcsname{\let\PYG@bf=\textbf\def\PYG@tc##1{\textcolor[rgb]{0.00,0.44,0.13}{##1}}}
\expandafter\def\csname PYG@tok@se\endcsname{\let\PYG@bf=\textbf\def\PYG@tc##1{\textcolor[rgb]{0.25,0.44,0.63}{##1}}}
\expandafter\def\csname PYG@tok@sd\endcsname{\let\PYG@it=\textit\def\PYG@tc##1{\textcolor[rgb]{0.25,0.44,0.63}{##1}}}

\def\PYGZbs{\char`\\}
\def\PYGZus{\char`\_}
\def\PYGZob{\char`\{}
\def\PYGZcb{\char`\}}
\def\PYGZca{\char`\^}
\def\PYGZam{\char`\&}
\def\PYGZlt{\char`\<}
\def\PYGZgt{\char`\>}
\def\PYGZsh{\char`\#}
\def\PYGZpc{\char`\%}
\def\PYGZdl{\char`\$}
\def\PYGZhy{\char`\-}
\def\PYGZsq{\char`\'}
\def\PYGZdq{\char`\"}
\def\PYGZti{\char`\~}
% for compatibility with earlier versions
\def\PYGZat{@}
\def\PYGZlb{[}
\def\PYGZrb{]}
\makeatother

\begin{document}

\maketitle
\tableofcontents
\phantomsection\label{docs/user_manual/index::doc}\phantomsection\label{docs/user_manual/index:qgis-manual-index-reference}



\chapter{Préambule}
\label{docs/user_manual/preamble/preamble:qgis-user-guide}\label{docs/user_manual/preamble/preamble:preamble}\label{docs/user_manual/preamble/preamble::doc}\label{docs/user_manual/preamble/preamble:qgis-documentation-preamble}
Ce document est le manuel officiel d'utilisation du logiciel Quantum GIS. Les logiciels et le matériel décrits dans ce document sont pour la plupart des marques déposées et donc soumises à des obligations légales. Quantum GIS est distribué sous la Licence publique générale GNU (GPL). Vous trouverez plus d'informations sur la page internet de Quantum GIS : \href{http://qgis.osgeo.org}{http://qgis.osgeo.org}.

Les détails, données, résultats, etc. inclus dans ce document ont été écrits et vérifiés au mieux des connaissances des auteurs et des éditeurs. Néanmoins, il est possible que des erreurs subsistent.

Ainsi l'ensemble des données ne saurait faire l'objet d'une garantie. Les auteurs et les éditeurs ne sauraient être responsables de tout dommage direct, indirect, secondaire ou accessoire découlant de l'utilisation de ce manuel. Les éventuelles corrections sont toujours les bienvenues.

Ce document a été rédigé avec reStructuredText. Les sources reST sont disponibles via \emph{github \textless{}https://github.com/qgis/QGIS-Documentation\textgreater{}}. La version en ligne en HTML et PDF via \href{http://documentation.qgis.org}{http://documentation.qgis.org}. Des versions traduites du manuel peuvent être téléchargées en différents formats via la section documentation du projet QGIS. Pour plus d'informations sur les manières de contribuer à ce document et à sa traduction, veuillez visiter \href{http://www.qgis.org/wiki/}{http://www.qgis.org/wiki/}.

\textbf{Références de ce document}

Ce document contient des références internes et externes sous forme de lien. Cliquer sur un lien interne provoque un déplacement dans le document, tandis que cliquer sur un lien externe ouvrira une adresse internet dans le navigateur choisi par défaut. Dans le PDF, les liens internes et externes sont indiqués en bleu et sont gérés par le navigateur du logiciel. En HTML, le navigateur affiche et gère les deux types de liens de la même façon.

\textbf{Auteurs et éditeurs :}

\begin{tabulary}{\linewidth}{|L|L|L|L|L|}
\hline

Tara Athan
 & 
Radim Blazek
 & 
Godofredo Contreras
 & 
Otto Dassau
 & 
Martin Dobias
\\

Peter Ersts
 & 
Anne Ghisla
 & 
Stephan Holl
 & 
N. Horning
 & 
Magnus Homann
\\

Werner Macho
 & 
Carson J.Q. Farmer
 & 
Tyler Mitchell
 & 
K. Koy
 & 
Lars Luthman
\\

Claudia A. Engel
 & 
Brendan Morely
 & 
David Willis
 & 
Jürgen E. Fischer
 & 
Marco Hugentobler
\\

Larissa Junek
 & 
Diethard Jansen
 & 
Paolo Corti
 & 
Gavin Macaulay
 & 
Gary E. Sherman
\\

Tim Sutton
 & 
Alex Bruy
 & 
Raymond Nijssen
 & 
Richard Duivenvoorde
 & 
Andreas Neumann
\\
\hline\end{tabulary}




\textbf{Sponsors}

La mise à jour de ce manuel a été aimablement sponsorisée par \href{http://www.so.ch/departemente/bau-und-justiz/amt-fuer-geoinformation.html}{Kanton Solothurn}, Suisse.

Copyright (c) 2004 - 2013  QGIS Development Team

\textbf{Internet:} \href{http://www.qgis.org}{http://www.qgis.org}

\textbf{Licence de ce document}

La permission de copier, distribuer, modifier ce document est accordée sous les termes de la GNU Free Documentation License, dans sa version 1.3 ou plus récente telle que publiée par la Free Software Foundation; sans modification de son contenu, sans ajouts la précédant ou la suivant. Une copie de la licence est incluse dans la section {\hyperref[docs/user_manual/appendices/appendices:gfl-appendix]{\emph{GNU Free Documentation License}}}.


\chapter{Conventions}
\label{docs/user_manual/preamble/conventions:label-conventions}\label{docs/user_manual/preamble/conventions::doc}\label{docs/user_manual/preamble/conventions:conventions}
Cette section décrit les symboles qui ponctuent ce manuel. Les conventions graphiques sont les suivantes :

\textbf{Conventions pour l'interface}

Les styles de conventions de l'interface (GUI) dans le texte ressemblent autant que possible à l'apparence du logiciel, l'objectif étant de permettre à l'utilisateur de repérer plus facilement les éléments mentionnés dans les instructions.
\begin{itemize}
\item {} 
Options du menu : \emph{Couches \(\rightarrow\) Ajouter une couche raster} ou \emph{Préférences \(\rightarrow\) Barre d'outils \(\rightarrow\) Numérisation}

\item {} 
Outil : \includegraphics[width=1.5em]{mActionAddRasterLayer.png} $^{\text{Ajouter une couche raster}}$

\item {} 
Bouton : \textbf{{[}Sauvegarder par défaut{]}}

\item {} 
Titre de boîte de dialogue : \emph{Propriétés de la couche}

\item {} 
Onglet : \emph{Général}

\item {} 
Case à cocher : \includegraphics{checkbox.png} \emph{Rendu}

\item {} 
Bouton radio :  \includegraphics{radiobuttonon.png} \emph{Postgis SRID} \includegraphics{radiobuttonoff.png} \emph{EPSG ID}

\item {} 
Sélection d'un chiffre : \includegraphics{selectnumber.png}

\item {} 
Sélection d'une ligne : \includegraphics{selectstring.png}

\item {} 
Parcourir un fichier : \includegraphics{browsebutton.png}

\item {} 
Sélection d'une couleur : \includegraphics{selectcolor.png}

\item {} 
Barre coulissante : \includegraphics{slider.png}

\item {} 
Zone de saisie de texte : \includegraphics{inputtext.png}

\end{itemize}

Une ombre indique un élément de l'interface qui peut être cliqué.

\textbf{Conventions de texte ou de clavier}

Le manuel se réfère aussi à des conventions pour le texte, les commandes du clavier et l'encodage pour définir les entités, les classes et les méthodes. Elles ne correspondent pas à l'apparence réelle.
\begin{itemize}
\item {} 
Liens hypertexte : \href{http://qgis.org}{http://qgis.org}

\item {} 
Combinaisons de touches : appuyez sur \code{Ctrl+B}, signifie qu'il faut rester en appui sur la touche Contrôle (Ctrl) tout en pressant la touche B.

\item {} 
Nom d'un fichier : \code{lakes.shp}

\item {} 
Nom d'une classe : \textbf{NewLayer}

\item {} 
Méthode : \emph{classFactory}

\item {} 
Serveur : \emph{myhost.de}

\item {} 
Texte pour l'utilisateur : \code{qgis -{-}help}

\end{itemize}

Lines of code are indicated by a fixed-width font

\begin{Verbatim}[commandchars=\\\{\}]
PROJCS["NAD\_1927\_Albers",
  GEOGCS["GCS\_North\_American\_1927",
\end{Verbatim}

\textbf{Instructions spécifiques à une plateforme}

Une séquence d'interface peut être exprimée dans une phrase : Cliquez sur \includegraphics[width=1em]{nix.png} \includegraphics[width=1em]{win.png} \emph{Fichier} \includegraphics[width=1em]{osx.png} \emph{QGIS \(\rightarrow\) Quitter pour fermer QGIS}.

Cela indique que sous Windows, Linux et les plateformes Unix il faudra d'abord cliquer sur Fichier puis dans la liste déroulante sur Quitter, alors que sous Mac OSX il faudra cliquer sur le menu QGIS. De grandes portions de textes peuvent être présentées en liste :
\begin{itemize}
\item {} 
\includegraphics[width=1em]{nix.png} faites ceci ;

\item {} 
\includegraphics[width=1em]{win.png} faites cela ;

\item {} 
\includegraphics[width=1em]{osx.png} faites autre chose.

\end{itemize}

ou comme des paragraphes :

\includegraphics[width=1em]{nix.png} \includegraphics[width=1em]{osx.png} Faites ceci et cela. Puis cela et ceci pour obtenir ça, etc.

\includegraphics[width=1em]{win.png} Faites ceci et cela. Puis cela et ceci pour obtenir ça, etc.

Les copies d'écrans ont été prises sous différentes plateformes, un icône à la fin de la légende de la figure indique le système en question.


\chapter{Avant-propos}
\label{docs/user_manual/preamble/foreword::doc}\label{docs/user_manual/preamble/foreword:foreword}\label{docs/user_manual/preamble/foreword:label-forward}
Bienvenue dans le monde merveilleux des Systèmes d'Informations Géographiques (SIG) !

Quantum GIS est un SIG libre qui a débuté en mai 2002 et s'est établi en tant que projet en juin 2002 sur SourceForge. Nous avons travaillé dur pour faire de ce logiciel SIG un choix accessible et viable pour toute personne ayant un ordinateur (qui sont traditionnellement des logiciels propriétaires assez coûteux). QGIS est utilisable sur la majorité des Unix, Mac OS X et Windows. QGIS utilise la bibliothèque logicielle Qt (\href{http://qt.digia.com}{http://qt.digia.com}) et le langage C++, ce qui se traduit par une interface graphique simple et réactive.

QGIS se veut simple à utiliser, fournissant des fonctionnalités courantes. Le but initial était de fournir un visionneur de données SIG. QGIS a, depuis, atteint un stade dans son évolution où beaucoup y recourent pour leurs besoins quotidiens. QGIS supporte un grand nombre de formats raster et vecteur, avec le support de nouveaux formats facilité par l'architecture basée sur les extension.

QGIS est distribué sous la licence GNU GPL (General Public License). Ceci signifie que vous pouvez étudier et modifier le code source, tout en ayant la garantie d'avoir accès à un programme SIG non onéreux et librement modifiable. Vous devez avoir reçu une copie complète de la licence avec votre exemplaire de QGIS, que vous pouvez également trouver dans l'Annexe {\hyperref[docs/user_manual/appendices/appendices:gpl-appendix]{\emph{GNU General Public License}}}.

\index{documentation}
\begin{notice}{tip}{Astuce:}
\textbf{Documentation à jour}

La dernière version de ce document est disponible dans la section documentation du site de QGIS : \href{http://www.qgis.org/fr/documentation}{http://www.qgis.org/fr/documentation}
\end{notice}


\section{Introduction au SIG}
\label{docs/user_manual/preamble/foreword:introduction-to-gis}
Un Système d'Information Géographique (SIG)  (Mitchell 2005 {\hyperref[docs/user_manual/literature_web/literature_and_web_references:literature-and-web]{\emph{Bibliographie}}}) est une collection de logiciels qui vous permettent de créer, visualiser, rechercher et analyser des données géospatiales. Ces données se réfèrent à des informations concernant l'emplacement géographique d'une entité. Ceci implique souvent l'utilisation de coordonnées géographiques, tel qu'une valeur de latitude ou de longitude. Le terme de donnée spatiale est employé couramment, ainsi que : donnée géographique, donnée SIG, donnée cartographique, donnée de localisation, donnée de géométrie spatiale.

Les applications utilisant des données géospatiales réalisent une grande variété de fonctions. La création de carte est celle-là plus admise, les logiciels cartographiques prennent les données géospatiales et les restituent sous une forme visuelle, sur un écran d'ordinateur ou sur une page imprimée. Ces applications peuvent présenter des cartes statiques (une seule image) ou des cartes dynamiques qui peuvent être personnalisées par la personne regardant la carte via un logiciel bureautique ou une page internet.

Beaucoup de gens présument à tort que les applications géospatiales se limitent à la production de cartes alors que l'analyse des données est une autre fonction importante de ces logiciels. Quelques exemples d'analyses incluent les calculs :
\begin{enumerate}
\item {} 
de distance entre deux points géographiques

\item {} 
d'aire (p. ex., en mètres carrés) d'une zone géographique

\item {} 
pour déterminer quelles entités se superposent sur d'autres entités

\item {} 
le taux de superposition entre entités

\item {} 
le nombre de points se situant à une certaine distance d'un autre

\item {} 
et beaucoup d'autres...

\end{enumerate}

Ces exemples peuvent sembler simplistes, mais ils peuvent être appliqués à de nombreuses disciplines. Le résultat de ces analyses peut être affiché sur une carte, mais plus généralement sous une forme tabulaire dans des rapports pour appuyer des décisions.

Le phénomène récent de services basés sur la localisation va introduire toutes sortes de nouvelles fonctionnalités dont beaucoup seront issues de la conjugaison de cartes et d'analyses. Par exemple, supposons que vous ayez un téléphone portable qui affiche votre position. Si vous avez le bon type de logiciel, votre téléphone pourra vous signaler les restaurants se trouvant à une courte distance de marche. Bien que ce soit une nouvelle application des technologies géospatiales, il s'agit pour l'essentiel d'analyser des données géospatiales et de vous en livrer les résultats.


\subsection{Pourquoi tout cela est-il si récent ?}
\label{docs/user_manual/preamble/foreword:why-is-all-this-so-new}
Et bien ça ne l'est pas. Il y a beaucoup de nouveaux appareils qui autorisent l'utilisation mobile de services géospatiaux. Beaucoup d'applications open source sont aussi disponibles, mais l'existence de matériels et logiciels dédiés à la géospatialisation n'est pas quelque chose de nouveau. Les récepteurs GPS (Global Positioning System) sont devenus courants, mais sont utilisés dans certaines industries depuis plus d'une décennie. De la même manière, la cartographie bureautique et les outils d'analyse ont depuis longtemps représenté un important secteur commercial, consacré à l'origine à des domaines comme la gestion de ressources naturelles.

Ce qui est nouveau est la façon dont les appareils et applications sont utilisés et par qui. Les utilisateurs traditionnels étaient des géomaticiens hautement qualifiés ou des techniciens habitués à travailler avec des outils de type CAO. Aujourd'hui les capacités de calculs des ordinateurs personnels et des logiciels open source ont permis à une foule de passionnés, de professionnels, de développeurs internet, etc. d'interagir avec des données géospatiales. La courbe d'apprentissage a diminué, les coûts ont diminué tandis que la diffusion des technologies spatiales a augmenté.

Comment sont stockées ces informations ? Pour faire simple, il existe deux sortes de données géospatiales dont l'utilisation est très répandue de nos jours, ce à quoi s'ajoutent les données tabulaires qui continuent à être utilisées couramment par les applications géospatiales.


\subsection{Les Données Raster}
\label{docs/user_manual/preamble/foreword:raster-data}
L'un des types de données géospatiales est qualifié de donnée raster/matricielle, ou plus communément un raster. Les formes les plus facilement reconnaissables de données raster sont les images satellites numériques ou les photos aériennes. Les ombrages de pentes ou les modèles numériques de terrain sont également représentés en raster. Tout type de données cartographiques peut être représenté comme une donnée raster, mais il y a des inconvénients.

Un raster est une grille régulière qui se compose de cellules ou, dans le cas de l'imagerie, de pixels. Il y a un nombre déterminé de lignes et de colonnes. Chaque cellule a une valeur numérique et une certaine taille géographique (par exemple 30 x 30 mètres de surface).

De multiples rasters sont superposés pour afficher des images qui utilisent plus d'une valeur de couleur (c.-à-d. un raster pour chaque bande de valeurs de rouge, vert et bleu sont combinés pour créer une image couleur). L'imagerie satellite représente les données avec plusieurs bandes. Chacune de ces bandes est un raster distinct qui se superpose spatialement aux autres rasters, une bande contient des valeurs correspondant à certaines longueurs d'onde de la lumière. Comme vous pouvez l'imaginer, un gros raster prend plus d'espace-disque.

Un raster avec de plus petites cellules fournira plus de détails, mais prendra plus de place. L'astuce est de trouver le juste équilibre entre la taille des cellules pour le stockage et la taille des cellules pour l'analyse ou la cartographie.


\subsection{Les données vectorielles}
\label{docs/user_manual/preamble/foreword:vector-data}
Les données vectorielles sont également utilisées dans les applications géospatiales. Si vous êtes resté éveillé durant vos cours de trigonométrie et de géométrie, vous serez déjà familier avec quelques-unes des particularités des données vectorielles. Les vecteurs sont une façon de décrire un emplacement en utilisant une série de coordonnées, chaque coordonnée se référant à une localisation géographique utilisant un système de valeurs en x et en y.

On peut faire la comparaison avec un plan cartésien, vous savez, le diagramme de l'école qui présentait des axes x et y. Vous y avez sans doute eu recours pour des graphiques montrant la chute de votre épargne-retraite ou l'augmentation de votre taxe d'habitation, le concept est ici similaire et essentiel pour l'analyse et la représentation géospatiale.

Il y a différentes manières de représenter ces coordonnées qui dépendent de votre objectif, c'est un tout autre chapitre à étudier : celui des projections cartographiques.

Les données vectorielles prennent trois formes, chacune progressivement plus complexe et s'appuyant sur la précédente.
\begin{enumerate}
\item {} 
les Points - une simple coordonnée (x y) qui représente un emplacement géographique ponctuel

\item {} 
les Lignes - plusieurs coordonnées (x$_{\text{1}}$ y$_{\text{1}}$, x$_{\text{2}}$ y$_{\text{2}}$, x$_{\text{3}}$ y$_{\text{3}}$, ... x$_{\text{n}}$ y$_{\text{n}}$)  reliées ensemble selon un ordre précis, tel que pour dessiner une ligne du point (x$_{\text{1}}$ y$_{\text{1}}$) au point (x$_{\text{2}}$ y$_{\text{2}}$) et ainsi de suite. Les parties qui se situent entre les points sont considérées comme des segments de ligne. Ils ont une longueur et la ligne peut avoir une direction suivant l'ordre des points. Techniquement, une ligne est une simple paire de points reliés ensemble tandis qu'une ficelle de ligne se compose multiples lignes qui sont connectées.

\item {} 
les Polygones - quand les lignes sont reliées par plus de deux points, avec le dernier point situé au même endroit que le premier, nous appelons le résultat un polygone. Un triangle, un cercle, un rectangle, etc. sont tous des polygones. La propriété clé des polygones est qu'ils ont une surface interne fixe.

\end{enumerate}


\chapter{Fonctionnalités}
\label{docs/user_manual/preamble/features::doc}\label{docs/user_manual/preamble/features:features}
QGIS offre beaucoup d'outils SIG standards par défaut et via les extensions de multiples contributeurs. Voici un bref résumé en six catégories qui vous donnera un premier aperçu.


\section{Visualiser des données}
\label{docs/user_manual/preamble/features:view-data}
Vous pouvez afficher et superposer des couches de données rasters et vecteurs dans différents formats et projections sans avoir à faire de conversion dans un format commun. Les formats supportés incluent :
\begin{itemize}
\item {} 
les tables spatiales PostGIS,SpatiaLite et MSSQL Spatial, les formats vecteurs supportés par la bibliothèque OGR installée, ce qui inclut les fichiers de forme ESRI (shapefiles), MapInfo, SDTS, GML et beaucoup d'autres, voir section {\hyperref[docs/user_manual/working_with_vector/index:label-workingvector]{\emph{Les données vectorielles}}}.

\item {} 
les formats raster supportés par la bibliothèque GDAL (Geospatial Data Abstraction Library) tels que GeoTiff, Erdas img., ArcInfo ascii grid, JPEG, PNG et beaucoup d'autres, voir section {\hyperref[docs/user_manual/working_with_raster/index:working-with-raster]{\emph{Les données raster}}}.

\item {} 
les formats raster et vecteur provenant des bases de données GRASS, voir section {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-grass]{\emph{Intégration du SIG GRASS}}}.

\item {} 
les données spatiales provenant des services réseaux compatibles OGC comme le Web Map Service (WMS) ou le Web Feature Service (WFS) (voir la  section {\hyperref[docs/user_manual/working_with_ogc/ogc_client_support:working-with-ogc]{\emph{Les données OGC}}}).

\item {} 
les données OpenStreetMap, voir section {\hyperref[docs/user_manual/osm/openstreetmap:plugins-osm]{\emph{OpenStreetMap}}}.

\end{itemize}


\section{Parcourir les données et créer des cartes}
\label{docs/user_manual/preamble/features:explore-data-and-compose-maps}
Vous pouvez créer des cartes et les parcourir de manière interactive avec une interface intuitive. Les outils disponibles dans l'interface sont :
\begin{itemize}
\item {} 
l'explorateur QGIS (QGIS browser)

\item {} 
la projection à la volée

\item {} 
la composition de carte

\item {} 
le panneau d'aperçu

\item {} 
les signets géospatiaux

\item {} 
l'identification et la sélection des entités

\item {} 
l'affichage, l'édition et la recherche de données attribuaires

\item {} 
l'étiquetage des entités

\item {} 
la personnalisation de la sémiologie des données raster et vecteur

\item {} 
l'ajout d'une couche de graticule - maintenant via l'extension fTools en tant que décoration

\item {} 
l'ajout d'une barre d'échelle, d'une flèche indiquant le nord et d'une étiquette de droits d'auteur

\item {} 
la sauvegarde et le chargement de projets

\end{itemize}


\section{Créer, éditer, gérer et exporter des données}
\label{docs/user_manual/preamble/features:create-edit-manage-and-export-data}
Vous pouvez créer, éditer, gérer et exporter des données vectorielles dans plusieurs formats. Les données raster doivent être importées dans GRASS pour être exportées dans d'autres formats. QGIS permet ce qui suit :
\begin{itemize}
\item {} 
Numérisation pour les formats gérés par OGR et les couches vectorielles de GRASS

\item {} 
Création et éditiont des fichiers de forme (shapefiles) et des couches vectorielles de GRASS

\item {} 
Géoréférencement des images avec l'extension de géoréférencement

\item {} 
Importation, exportation du format GPX pour les données GPS, avec la conversion des autres formats GPS vers le GPX ou l'envoi, la réception directement vers une unité GPS (pour Linux, le port USB a été ajouté à la liste des ports utilisables)

\item {} 
Visualisation et édition des données OpenStreetMap

\item {} 
Création de couches PostGIS à partir de fichiers shapefiles grâce au module d'extension SPIT

\item {} 
Prise en charge améliorée des tables PostGIS

\item {} 
Gestion des attributs des couches vectorielles grâce à la nouvelle table (voir la section {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-attribute-table]{\emph{Travailler avec la table d'attributs}}}) ou avec l'extension Table Manager

\item {} 
Enregistrement de captures d'écran en tant qu'images géoréférencées

\end{itemize}


\section{Analyser les données}
\label{docs/user_manual/preamble/features:analyse-data}
Vous pouvez opérer des analyses spatiales sur des données PostgreSQL/PostGIS et autres formats OGR en utilisant l'extension fTools. QGIS permet actuellement l'analyse vectorielle, l'échantillonnage, le géotraitement, la gestion de la géométrie et des bases de données. Vous pouvez aussi utiliser les outils GRASS intégrés qui comportent plus de 400 modules (voir section {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-grass]{\emph{Intégration du SIG GRASS}}}). Vous pouvez travailler avec SEXTANTE qui est un puissant framework de géotraitement et d'analyse permettant d'appeler les fonctions intégrées à QGIS tels que GDAL, SAGA, GRASS, fTools et bien d'autres encore (voir section {\hyperref[docs/user_manual/sextante/index:label-sextante]{\emph{SEXTANTE}}}).


\section{Publier une carte sur Internet}
\label{docs/user_manual/preamble/features:publish-maps-on-the-internet}
QGIS peut être employé pour exporter des données vers un mapfile et le publier sur Internet via un serveur web employant l'UMN MapServer. QGIS peut aussi servir de client WMS,WMS-C, WFS et WFS-T ou de serveur WMS/WFS (voir section {\hyperref[docs/user_manual/working_with_ogc/index:sec-ogc]{\emph{Les données OGC}}}).


\section{Étendre les fonctionnalités de QGIS grâce à des extensions}
\label{docs/user_manual/preamble/features:extend-qgis-functionality-through-plugins}
QGIS peut être adapté à vos besoins particuliers du fait de son architecture extensible à base de modules. QGIS fournit des bibliothèques qui peuvent être employées pour créer des extensions, vous pouvez même créer de nouvelles applications en C++ ou python !


\subsection{Extensions principales}
\label{docs/user_manual/preamble/features:core-plugins}\begin{enumerate}
\item {} 
Ajouter une couche de texte délimité (charge et affiche des fichiers texte ayant des colonnes contenant des coordonnées XY).

\item {} 
Saisie de coordonnées (Enregistre les coordonnées du pointeur de la souris dans un SCR différent).

\item {} 
DB Manager (Edition et visualisation des couches et des tables, execution de requêtes SQL).

\item {} 
Diagramme incrustés (place des diagrammes sur une couche vectorielle).

\item {} 
Convertisseur Dxf2Shp (convertit les fichiers DXF en fichier SHP).

\item {} 
Outils GPS (importe et exporte des données GPS).

\item {} 
GRASS (intégration du SIG GRASS).

\item {} 
GDALTools (intègre les outils GDAL dans QGIS).

\item {} 
Géoréférenceur GDAL (ajoute une projection à un raster).

\item {} 
Carte de chaleur (génère des cartes de chaleur raster à partir de données ponctuelles).

\item {} 
Extension d'interpolation (interpole une surface en utilisant une couche vectorielle de points).

\item {} 
Export Mapserver (exporte un fichier de projet QGIS dans le format de carte de MapServer).

\item {} 
Edition hors connexion (pemet l'édition hors connexion et la synchronisation avec une base de données).

\item {} 
Extension OpenStreetMap (permet de visualiser et d'éditer des données OSM).

\item {} 
Support des GeoRaster d'Oracle Spatial.

\item {} 
Installateur d'extensions python (télécharge et installe des extensions python pour QGIS).

\item {} 
Analyse de terrain raster (traitements raster de données d'élévation).

\item {} 
Extension de graphe routier (analyse du chemin le plus court sur un réseau).

\item {} 
SPIT (outil d'importation de Shapefile vers PostgreSQL/PostGIS).

\item {} 
Extension SQL Anywhere (stocke les couches vectorielles dans une base de données SQL Anywhere).

\item {} 
Statistiques zonales (Calcule le nombre, la somme et la moyenne des valeurs d'un raster par zones définies par une couche de polygones).

\item {} 
Extension de requête spatiale (effectue des requêtes spatiales sur les couches vectorielles).

\item {} 
eVIS (outils de visualisation d'évènements).

\item {} 
fTools (outils d'analyse et de gestion de vecteurs).

\end{enumerate}


\subsection{Extensions Python externes}
\label{docs/user_manual/preamble/features:external-python-plugins}
QGIS offre un nombre croissant d'extensions complémentaires en Python fournies par la communauté. Ces extensions sont entreposées dans le dépot officiel et peuvent être facilement installées en utilisant l'extension d'installation Python (voir la section {\hyperref[docs/user_manual/plugins/plugins:load-external-plugin]{\emph{Installer une extension externe}}}).


\section{Quoi de neuf dans la version 1.8}
\label{docs/user_manual/preamble/features:what-s-new-in-the-version-1-8}
Veuillez noter que cette version est un jalon important dans la série des versions. Comme tel, elle intègre de nouvelles fonctionnalités et étend l'interface de programmation par rapport aux versions QGIS 1.0.x and QGIS 1.7.0. Nous recommandons d'utiliser cette version préférentiellement aux précédentes.

Cette version inclut des centaines de résolutions de problèmes, ainsi que des améliorations et de nouvelles fonctionnalités décrites dans ce manuel.

\textbf{Explorateur QGIS (QGIS browser)}

Une application indépendante et un nouveau panneau dans QGIS. L'explorateur permet de naviguer facilement parmi vos fichiers et vos bases de données (PostGIS, WFS, etc.), de les visualiser et de les glisser-déposer dans QGIS.

\textbf{DB Manager}

DB manager fait maintenant officiellement partie du coeur de QGIS. Vous pouvez glisser des couches depuis l'explorateur QGIS vers DB Manager, elles seront importées dans votre base de données spatiale. Vous pouvez déplacer de la même manière des tables entre des bases de données. Vous pouvez utiliser DB Manager pour exécuter des requêtes et visualiser le résultat dans QGIS. Vous pouvez également créer, éditer, supprimer et vider des tables et les déplacer vers un autre schéma.

\textbf{Extension d'analyse de terrain}

Une nouvelle extension principale a été ajoutée pour effectuer des analyses de terrain (pente, exposition, ombrage, relief, index de de rugosité).

\textbf{Nouveaux types de symboles}
\begin{itemize}
\item {} 
Motifs de lignes

\item {} 
Motifs de points

\item {} 
Symboles elliptiques (rendu elliptique y compris pour des rectangles, triangles, croix, etc.)

\end{itemize}

\textbf{Nouveau dépôt d'extensions}

Notez que par défaut l'ancien dépôt n'est plus supporté, il est demandé aux auteurs d'extensions de bien vouloir déplacer leurs extensions vers le nouveau dépôt. Vous trouverez la liste des extensions QGIS sur \href{http://plugins.qgis.org/plugins/}{http://plugins.qgis.org/plugins/}.

\textbf{Beaucoup de nouvelles fonctionnalités}
\begin{itemize}
\item {} 
Possibilité d'inclure des projets dans d'autres projets

\item {} 
Possibilité de créer un nouveau groupe pour un ensemble de couches sélectionnées

\item {} 
Journal des messages : permet de garder un oeil sur les messages générés par QGIS lors des chargements et des traitements

\item {} 
Personnalisation de QGIS : permet de définir une interface simplifiée de QGIS en cachant différents composants de la fenêtre principale et autres éléments des fenêtres

\item {} 
L'outil d'exécution des actions est maintenant accessible depuis la barre d'outils Attributs et vous permet de cliquer sur une entité pour exécuter directement l'action

\item {} 
Liste d'échelles prédéfinies

\item {} 
Déplacer la carte jusqu'à la sélection : recentre la carte sur les entités sélectionnées sans changer le niveau de zoom

\item {} 
Copier-coller des styles entre des couches

\item {} 
Mise à jour de la fenêtre des SCR

\item {} 
Possibilité de définir un ordre des couches dans la légende différent de l'ordre de superposition

\item {} 
Support de MSSQL Spatia - vous pouvez maintenant vous connecter à des bases de données spatiales Microsoft SQL Server dans QGIS

\item {} 
Le composeur d'impression permet les retours à la ligne dans la légende grâce à un caractère spécifié

\item {} 
Étiquetage basé sur une expression

\item {} 
Carte de chaleur (une nouvelle extension principale qui génère des cartes de chaleur raster à partir de données ponctuelles)

\item {} 
L'interface de suivi de trace GPS a été remaniée et beaucoup de corrections et d'améliorations y ont été ajoutées

\item {} 
Les menus ont été réorganisés - nous avons maintenant des menus Vecteur, Raster et Web séparés et beaucoup d'extensions ont été mises à jour pour insérer leur menu dans les nouveaux menus Vecteur, Raster, Web et autres menus principaux

\item {} 
Déplacement de courbes - un nouvel outil de numérisation a été ajouté

\item {} 
Nouveaux outils dans le menu Vecteur pour Densifier les géométries et Créer un index spatial

\item {} 
L'outil d'export/ajout de colonne géométrique geometry peut utiliser au choix le SCR de la couche, du projet ou les mesures de l'ellispoïde

\item {} 
Vue arborescente pour le moteur de rendu basé sur des régles

\item {} 
Améliorations des signets géospatiaux

\item {} 
Nouveau fichier metadata.txt pour gérer les métadonnées des extensions

\item {} 
Refonte du pilote postgres : support des clés arbitraires (incluant celles non-numériques et multi-colonnnes), possibilité de limiter une requête sur un type de géométrie ou un SRID

\item {} 
Ajout de l'option gdal\_fillnodata à l'extension GDALTools

\item {} 
Support du type TopoGeometry pour PostGIS

\item {} 
Bindings Python pour les couches de symboles vectoriels basés sur des champs et mise à jour générale des bindings Python

\item {} 
Progamme de test de performances

\item {} 
Mise en cache des lignes de la table attributaire

\item {} 
Outil de génération d'UUID pour la table attributaire

\item {} 
Ajout du support de l'édition de vue dans les bases de données SpatiaLite

\item {} 
Outil basé sur les expressions dans la calculatrice de champ

\item {} 
Création de couches évenementielles dans la bibliothèque d'analyse utilisant le référencement linéaire

\item {} 
Chargement/sauvegarde des styles de la nouvelle symbologie depuis/vers un fichier SLD

\item {} 
QGIS Server peut maintenant agir comme serveur WFS

\item {} 
Support WFS dans QGIS Server

\item {} 
Option permettant d'exclure les informations de géométrie WKT lors de copies de la table attributaire

\item {} 
Support de l'utilisation de couches archivées dans des zip/gzip

\item {} 
Exécution quotidienne de tous les tests sur les principales plateformes

\item {} 
Vous pouvez définir la taille des dalles pour les couches WMS

\end{itemize}


\chapter{Premiers Pas}
\label{docs/user_manual/introduction/getting_started:label-getstarted}\label{docs/user_manual/introduction/getting_started:getting-started}\label{docs/user_manual/introduction/getting_started::doc}
Ce chapitre donne un bref aperçu de l'installation de QGIS, de quelques jeux de données provenant du site Internet et du lancement d'une première session d'affichage de couches matricielles et vectorielles.


\section{Installation}
\label{docs/user_manual/introduction/getting_started:label-installation}\label{docs/user_manual/introduction/getting_started:installation}
L'installation de QGIS est très simple. Des installateurs sont disponibles pour les systèmes d'exploitation MS Windows et Mac OS X. Beaucoup de distributions de GNU/Linux mettent à disposition des fichiers binaires précompilés (.rpm ou .deb) ou des dépôts sources via leurs interfaces de gestion de logiciels. Vous pouvez obtenir les dernières informations concernant les paquets binaires sur le site de QGIS sur \href{http://download.qgis.org}{http://download.qgis.org}.


\subsection{Installation à partir des sources}
\label{docs/user_manual/introduction/getting_started:installation-from-source}
Si vous désirez installer QGIS à partir des sources, référez-vous aux instructions d'installation. Elles sont diffusées avec le code source de QGIS dans un fichier nommé `INSTALL'. Vous pouvez  également les trouver en ligne sur \href{https://github.com/qgis/Quantum-GIS/blob/master/INSTALL}{https://github.com/qgis/Quantum-GIS/blob/master/INSTALL}


\subsection{Installation sur un support amovible}
\label{docs/user_manual/introduction/getting_started:installation-on-external-media}
QGIS vous permet de définir une option \code{-{-}configpath} qui remplace le chemin par défaut (par exemple \textasciitilde{}/.qgis pour Linux) pour la configuration utilisateur et oblige QSettings à l'utiliser. Cela permet à l'utilisateur de transporter son installation de QGIS sur une clé USB avec ses extensions et paramètres.


\section{Échantillon de données}
\label{docs/user_manual/introduction/getting_started:label-sampledata}\label{docs/user_manual/introduction/getting_started:sample-data}
Le guide de l'utilisateur contient des exemples basés sur le jeu de données échantillon inclus dans QGIS.

\includegraphics[width=1em]{win.png} L'installateur Windows possède une option qui permet de télécharger le jeu de données échantillon QGIS. Si vous la cochez, les données seront téléchargées dans votre répertoire intitulé \code{Mes Documents} et placées dans un répertoire \code{GIS Database}. Vous pouvez utiliser l'explorateur Windows pour vous déplacer à partir de ce répertoire vers un autre répertoire de votre choix. Si vous ne cochez pas cette option durant l'installation, vous pouvez
\begin{itemize}
\item {} 
utiliser des données que vous possédez déjà,

\item {} 
télécharger l'échantillon sur le site de QGIS \href{http://download.qgis.org}{http://download.qgis.org},

\item {} 
désinstaller et réinstaller QGIS en cochant, cette fois, la case de téléchargement.

\end{itemize}

\includegraphics[width=1em]{nix.png} \includegraphics[width=1em]{osx.png} Pour les systèmes GNU/Linux et Mac OSX il n'y a pas encore de paquets disponibles sous forme de rpm, deb ou dmg. Pour utiliser l'échantillon de données, téléchargez le fichier \code{qgis\_sample\_data} compressé au format ZIP ou archive TAR depuis \href{http://download.osgeo.org/qgis/data/}{http://download.osgeo.org/qgis/data/} et décompressez-le à l'endroit de votre choix. Le jeu de données sur l'Alaska comporte toutes les données SIG qui ont servi à la préparation des captures d'écran et des exemples qui figurent dans ce manuel et inclu également un petit jeu de données GRASS. La projection est l'Alaska Albers Equal Area qui a pour unité le pied et dont le code EPSG est le 2964.

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{n}{PROJCS}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{Albers Equal Area}\PYG{l+s}{\PYGZdq{}}\PYG{p}{,}
    \PYG{n}{GEOGCS}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{NAD27}\PYG{l+s}{\PYGZdq{}}\PYG{p}{,}
        \PYG{n}{DATUM}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{North\PYGZus{}American\PYGZus{}Datum\PYGZus{}1927}\PYG{l+s}{\PYGZdq{}}\PYG{p}{,}
            \PYG{n}{SPHEROID}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{Clarke 1866}\PYG{l+s}{\PYGZdq{}}\PYG{p}{,}\PYG{l+m+mf}{6378206.4}\PYG{p}{,}\PYG{l+m+mf}{294.978698213898}\PYG{p}{,}
                \PYG{n}{AUTHORITY}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{EPSG}\PYG{l+s}{\PYGZdq{}}\PYG{p}{,}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{7008}\PYG{l+s}{\PYGZdq{}}\PYG{p}{]}\PYG{p}{]}\PYG{p}{,}
            \PYG{n}{TOWGS84}\PYG{p}{[}\PYG{o}{\PYGZhy{}}\PYG{l+m+mi}{3}\PYG{p}{,}\PYG{l+m+mi}{142}\PYG{p}{,}\PYG{l+m+mi}{183}\PYG{p}{,}\PYG{l+m+mi}{0}\PYG{p}{,}\PYG{l+m+mi}{0}\PYG{p}{,}\PYG{l+m+mi}{0}\PYG{p}{,}\PYG{l+m+mi}{0}\PYG{p}{]}\PYG{p}{,}
            \PYG{n}{AUTHORITY}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{EPSG}\PYG{l+s}{\PYGZdq{}}\PYG{p}{,}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{6267}\PYG{l+s}{\PYGZdq{}}\PYG{p}{]}\PYG{p}{]}\PYG{p}{,}
        \PYG{n}{PRIMEM}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{Greenwich}\PYG{l+s}{\PYGZdq{}}\PYG{p}{,}\PYG{l+m+mi}{0}\PYG{p}{,}
            \PYG{n}{AUTHORITY}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{EPSG}\PYG{l+s}{\PYGZdq{}}\PYG{p}{,}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{8901}\PYG{l+s}{\PYGZdq{}}\PYG{p}{]}\PYG{p}{]}\PYG{p}{,}
        \PYG{n}{UNIT}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{degree}\PYG{l+s}{\PYGZdq{}}\PYG{p}{,}\PYG{l+m+mf}{0.0174532925199433}\PYG{p}{,}
            \PYG{n}{AUTHORITY}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{EPSG}\PYG{l+s}{\PYGZdq{}}\PYG{p}{,}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{9108}\PYG{l+s}{\PYGZdq{}}\PYG{p}{]}\PYG{p}{]}\PYG{p}{,}
        \PYG{n}{AUTHORITY}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{EPSG}\PYG{l+s}{\PYGZdq{}}\PYG{p}{,}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{4267}\PYG{l+s}{\PYGZdq{}}\PYG{p}{]}\PYG{p}{]}\PYG{p}{,}
    \PYG{n}{PROJECTION}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{Albers\PYGZus{}Conic\PYGZus{}Equal\PYGZus{}Area}\PYG{l+s}{\PYGZdq{}}\PYG{p}{]}\PYG{p}{,}
    \PYG{n}{PARAMETER}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{standard\PYGZus{}parallel\PYGZus{}1}\PYG{l+s}{\PYGZdq{}}\PYG{p}{,}\PYG{l+m+mi}{55}\PYG{p}{]}\PYG{p}{,}
    \PYG{n}{PARAMETER}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{standard\PYGZus{}parallel\PYGZus{}2}\PYG{l+s}{\PYGZdq{}}\PYG{p}{,}\PYG{l+m+mi}{65}\PYG{p}{]}\PYG{p}{,}
    \PYG{n}{PARAMETER}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{latitude\PYGZus{}of\PYGZus{}center}\PYG{l+s}{\PYGZdq{}}\PYG{p}{,}\PYG{l+m+mi}{50}\PYG{p}{]}\PYG{p}{,}
    \PYG{n}{PARAMETER}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{longitude\PYGZus{}of\PYGZus{}center}\PYG{l+s}{\PYGZdq{}}\PYG{p}{,}\PYG{o}{\PYGZhy{}}\PYG{l+m+mi}{154}\PYG{p}{]}\PYG{p}{,}
    \PYG{n}{PARAMETER}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{false\PYGZus{}easting}\PYG{l+s}{\PYGZdq{}}\PYG{p}{,}\PYG{l+m+mi}{0}\PYG{p}{]}\PYG{p}{,}
    \PYG{n}{PARAMETER}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{false\PYGZus{}northing}\PYG{l+s}{\PYGZdq{}}\PYG{p}{,}\PYG{l+m+mi}{0}\PYG{p}{]}\PYG{p}{,}
    \PYG{n}{UNIT}\PYG{p}{[}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{us\PYGZus{}survey\PYGZus{}feet}\PYG{l+s}{\PYGZdq{}}\PYG{p}{,}\PYG{l+m+mf}{0.3048006096012192}\PYG{p}{]}\PYG{p}{]}
\end{Verbatim}

Si vous désirez utiliser QGIS comme interface graphique de GRASS, vous trouverez une sélection d'échantillons de secteurs (e.g. Spearfish ou South Dakota) sur le site officiel de GRASS \href{http://grass.osgeo.org/download/data.php}{http://grass.osgeo.org/download/data.php}.


\section{Session test}
\label{docs/user_manual/introduction/getting_started:sample-session}\label{docs/user_manual/introduction/getting_started:samplesession}
Maintenant que vous avez QGIS d'installé avec un échantillon de données disponible, nous aimerions vous faire une courte démonstration. Vous allez visualiser une couche raster et une couche vectorielle. Nous allons utiliser la couche raster landcover \code{qgis\_sample\_data/raster/landcover.img}
et la couche vectorielle des lacs \code{qgis\_sample\_data/gml/lakes.gml}.


\subsection{Démarrer QGIS}
\label{docs/user_manual/introduction/getting_started:start-qgis}\begin{itemize}
\item {} 
\includegraphics[width=1em]{nix.png} Démarrer QGIS en tapant : ``QGIS'' en ligne de commande dans une console ou, si vous utilisez un fichier binaire précompilé, depuis le menu Application.

\item {} 
\includegraphics[width=1em]{win.png} Démarrer QGIS en utilisant le menu Démarrer, un raccourci placé sur le Bureau, ou double-cliquez sur un fichier de projet existant de QGIS.

\item {} 
\includegraphics[width=1em]{osx.png} Double-cliquez sur l'icône de QGIS dans votre répertoire du menu Applications.

\end{itemize}
\phantomsection\label{docs/user_manual/introduction/getting_started:fig-simple-session}

\subsection{Charger les couches raster et vecteur depuis le jeu de données test}
\label{docs/user_manual/introduction/getting_started:load-raster-and-vector-layers-from-the-sample-dataset}\begin{enumerate}
\item {} 
Cliquez sur l'icône \includegraphics[width=1.5em]{mActionAddRasterLayer.png} $^{\text{Ajouter une couche Raster}}$.

\item {} 
Parcourez le dossier \code{qgis\_sample\_data/raster/}, sélectionnez le fichier ERDAS \code{landcover.img} et cliquez sur \textbf{{[}Ouvrir{]}}.

\item {} 
Si le fichier n'est pas listé, vérifiez le type de fichier à partir du menu déroulant au dessous de la boîte de dialogue afin de filtrer le bon type de fichier, dans ce cas-ci c'est ``Erdas Imagine Images (\code{*.img}, \code{*.IMG})''.

\item {} 
Maintenant cliquez sur l'icône \includegraphics[width=1.5em]{mActionAddOgrLayer.png} $^{\text{Ajouter une couche vecteur}}$.

\item {} 
\includegraphics{radiobuttonon.png} \emph{Fichier} devrait être sélectionné comme Type de source dans la fenêtre \emph{Ajouter une couche vecteur} qui apparaît. Maintenant cliquez sur \textbf{{[}Parcourir{]}} pour sélectionner la couche vecteur.

\item {} 
Parcourez le répertoire \code{qgis\_sample\_data/gml/}, sélectionnez ``GML'' à partir du menu déroulant Type de fichier, sélectionnez le fichier GML \code{lakes.gml}, cliquez sur  \textbf{{[}Ouvrir{]}}, et enfin, dans la boîte de dialogue Ajouter une couche vecteur, cliquez sur \textbf{{[}OK{]}}.

\item {} 
Zoomez sur une zone de votre choix avec quelques lacs.

\item {} 
Double-cliquez sur la couche \code{lakes} dans la liste des couches pour ouvrir la fenêtre:guilabel:\emph{Propriété des couches}.

\item {} 
Cliquez sur l'onglet \emph{Style} et sélectionnez le bleu comme couleur de remplissage.

\item {} 
Cliquez sur l'onglet \emph{Étiquettes} et cochez la case \includegraphics{checkbox.png} \emph{Afficher les étiquettes} pour permettre l'étiquetage des entités. Choisissez le champ intitulé NAMES comme champ d'étiquetage.

\item {} 
Pour améliorer la lisibilité des étiquettes, vous pouvez ajouter un halo autour d'elles, en cliquant sur ``tampon'' dans la liste à gauche puis sur \includegraphics{checkbox.png} \emph{Tampon d'étiquette}. Choisissez 3 comme taille du tampon.

\item {} 
Cliquez sur \textbf{{[}Appliquez{]}} pour vérifier si le résultat est satisfaisant et enfin cliquez sur \textbf{{[}OK{]}}.

\end{enumerate}

Vous pouvez constater combien il est facile d'afficher des couches raster ou vecteur dans QGIS. Passons aux sections suivantes pour en apprendre plus sur les autres fonctionnalités, caractéristiques et paramètres disponibles et sur la façon de les utiliser.


\section{Démarrer et arrêter QGIS}
\label{docs/user_manual/introduction/getting_started:label-startingqgis}\label{docs/user_manual/introduction/getting_started:starting-and-stopping-qgis}
Dans le chapitre {\hyperref[docs/user_manual/introduction/getting_started:samplesession]{\emph{Session test}}}, vous avez appris comment démarrer QGIS. Nous allons répéter cette étape ici et vous verrez que QGIS propose des options supplémentaires via la ligne de commande.
\begin{itemize}
\item {} 
\includegraphics[width=1em]{nix.png} En présumant que QGIS est installé dans le PATH (chemin par défaut), vous pouvez le démarrez en tapant : \code{qgis} dans une console ou en cliquant sur l'icône de raccourci sur le bureau dans le menu des applications.

\item {} 
\includegraphics[width=1em]{win.png} Démarrez QGIS en utilisant le menu Démarrer, l'icône de raccourci présent sur le bureau ou encore, en cliquant sur un fichier de projet QGIS.

\item {} 
\includegraphics[width=1em]{osx.png} Double-cliquez sur l'icône de votre répertoire Applications. Si vous avez besoin d'exécuter QGIS dans une console, lancez avec /chemin-vers-exécutable/Contents/MacOS/Qgis.

\end{itemize}

Pour arrêter QGIS, cliquez sur le menu \includegraphics[width=1em]{nix.png} \includegraphics[width=1em]{win.png}  \emph{Fichier} \includegraphics[width=1em]{osx.png} \emph{QGIS \(\rightarrow\) Quitter}, ou utilisez le raccourci clavier \code{Ctrl+Q}.


\section{Options de ligne de commande}
\label{docs/user_manual/introduction/getting_started:label-commandline}\label{docs/user_manual/introduction/getting_started:command-line-options}
\index{command line options}
\includegraphics[width=1em]{nix.png} QGIS supporte un certain nombre d'options lorsqu'il est lancé par une ligne de commande. Pour obtenir une liste de ces options, entrez \code{qgis -{-}help} dans votre console. Le message qui en résulte est :

\begin{Verbatim}[commandchars=\\\{\}]
qgis --help
Quantum GIS - 1.8.0-Lisboa 'Lisboa' (exported)
Quantum GIS (QGIS) is a viewer for spatial data sets, including
raster and vector data.
Usage: qgis [options] [FILES]
  options:
        [--snapshot filename]           emit snapshot of loaded datasets to given file
        [--width width]                 width of snapshot to emit
        [--height height]               height of snapshot to emit
        [--lang language]               use language for interface text
        [--project projectfile]         load the given QGIS project
        [--extent xmin,ymin,xmax,ymax]  set initial map extent
        [--nologo]                      hide splash screen
        [--noplugins]                   don't restore plugins on startup
        [--nocustomization]             don't apply GUI customization
        [--optionspath path]            use the given QSettings path
        [--configpath path]             use the given path for all user configuration
        [--help]                        this text

  FILES:
    Files specified on the command line can include rasters,
    vectors, and QGIS project files (.qgs):
    1. Rasters - Supported formats include GeoTiff, DEM
       and others supported by GDAL
    2. Vectors - Supported formats include ESRI Shapefiles
       and others supported by OGR and PostgreSQL layers using
       the PostGIS extension
\end{Verbatim}

\begin{notice}{tip}{Astuce:}
\textbf{Exemple utilisant des options de ligne de commande}

Vous pouvez démarrer QGIS en spécifiant un ou plusieurs fichiers de données. Par exemple, si vous êtes placé dans le répertoire qgis\_sample\_data vous pouvez démarrer QGIS avec une couche vectorielle et un fichier raster dès le démarrage avec la commande suivante : \code{qgis ./raster/landcover.img ./gml/lakes.gml}
\end{notice}

\textbf{Option} \code{-{-}snapshot}

Cette option permet de créer une capture d'écran de l'affichage courant au format PNG. C'est pratique quand vous avez une longue série de projets et que vous voulez générer un aperçu de vos données.

L'image est créée au format PNG et fait 800x600 pixels. Cette commande peut être adaptée en utilisant les arguments \code{-{-}width} pour la largeur et \code{-{-}height} pour la hauteur. Un nom de fichier peut être ajouté après \code{-{-}snapshot}.

\textbf{Option} \code{-{-}lang}

QGIS se base sur votre environnement linguistique par défaut pour définir la langue de l'interface. Si vous voulez en changer, vous devez le spécifier en saisissant un code. Par exemple, \code{-{-}lang=it} provoquera l'utilisation de la version italienne. Une liste des langues intégrées est disponible sur \href{http://hub.qgis.org/wiki/quantum-gis/GUI\_Translation\_Progress}{http://hub.qgis.org/wiki/quantum-gis/GUI\_Translation\_Progress}

\textbf{Option} \code{-{-}project}

Démarrer QGIS avec un projet existant est possible, il suffit d'ajouter l'option  \code{-{-}project} suivie du nom de votre projet et QGIS se lancera avec toutes les couches définies dans ce fichier.

\textbf{Option} \code{-{-}extent}

Pour démarrer avec une étendue cartographique spécifique, utilisez cette option. Vous devez ajouter les limites de votre étendue dans l'ordre suivant en les séparant par une virgule :

\begin{Verbatim}[commandchars=\\\{\}]
--extent xmin,ymin,xmax,ymax
\end{Verbatim}

\textbf{Option} \code{-{-}nologo}

Cette commande dissimule l'écran de démarrage qui apparaît lors du lancement de QGIS.

\textbf{Option} \code{-{-}noplugins}

Si vous avez un problème de démarrage lié à une extension, cette option permet de lancer QGIS sans les charger (elles seront toujours accessibles dans le Gestionnaire d'extension).

\textbf{Option} \code{-{-}nocustomization}

Utiliser cette commande empêchera la personnalisation de l'interface au démarrage.

\textbf{Option} \code{-{-}optionspath}

Vous pouvez avoir plusieurs configurations et décider laquelle utiliser en utilisant cette option au démarrage. Lisez la section {\hyperref[docs/user_manual/introduction/qgis_configuration:gui-options]{\emph{Options}}} pour savoir où votre système d'exploitation entrepose les fichiers de préférences. Il n'y pas pour l'instant de possibilité de spécifier dans quel fichier écrire ces préférences, vous devrez donc faire une copie du fichier original et le renommer.

\textbf{Option} \code{-{-}configpath}

Cette option est similaire à la précédente, mais va plus loin en changeant le chemin par défaut de la configuration utilisateur (\textasciitilde{}/.qgis) et oblige QSettings à utiliser ce nouveau répertoire. Cela permet par exemple de transporter QGIS sur une clé USB avec tous les paramètres et extensions.


\section{Les projets}
\label{docs/user_manual/introduction/getting_started:sec-projects}\label{docs/user_manual/introduction/getting_started:projects}
L'état de votre session de QGIS est considéré comme étant un projet. QGIS ne peut travailler que sur un projet à la fois. Les propriétés sont considérées comme étant assignées à un projet ou celles par défaut des nouveaux projets (voir Section {\hyperref[docs/user_manual/introduction/qgis_configuration:gui-options]{\emph{Options}}}). QGIS peut enregistrer l'état de votre travail dans un fichier de projet en utilisant le menu \emph{Fichier \(\rightarrow\)} \includegraphics[width=1.5em]{mActionFileSave.png} \emph{Sauvegarder le projet} ou \emph{Fichier \(\rightarrow\)} \includegraphics[width=1.5em]{mActionFileSaveAs.png} \emph{Sauvegarder le projet sous...}.

Pour charger un projet dans une session QGIS, aller dans \emph{Fichier \(\rightarrow\)} \includegraphics[width=1.5em]{mActionFileOpen.png} \emph{Ouvrir un Projet} ou \emph{Fichier \(\rightarrow\) Ouvrir un projet récent}.

Si vous souhaitez revenir à une session vierge, aller sur \emph{Fichier \(\rightarrow\)} \includegraphics[width=1.5em]{mActionFileNew.png} \emph{Nouveau Projet}. Chacune de ces options vous demandera si vous désirez enregistrer le projet dès lors que des changements auront été effectués depuis son ouverture ou sa dernière sauvegarde.

Les types d'informations enregistrées dans un projet sont :
\begin{itemize}
\item {} 
les couches ajoutées,

\item {} 
les propriétés des couches comprenant notamment la sémiologie,

\item {} 
la projection de la carte,

\item {} 
l'étendue de la dernière zone de visualisation.

\end{itemize}

Le fichier de projet est enregistré au format XML, il est donc possible de l'éditer en dehors de QGIS si vous savez ce que vous faites. Le format a été modifié à plusieurs reprises depuis les versions antérieures de QGIS, les fichiers enregistrés sous ces versions peuvent ne plus fonctionner correctement avec les versions ultérieures. Pour être averti dans ce genre de cas, allez dans l'onglet  \emph{Général} du menu \emph{Préférences \(\rightarrow\) Options} et sélectionnez :

\includegraphics{checkbox.png} \emph{Demander à sauvegarder si des changements ont été apportés au projet}

\includegraphics{checkbox.png} \emph{M'avertir lors de l'ouverture d'un fichier projet sauvegardé avec une version précédente de QGIS}


\section{Sortie graphique}
\label{docs/user_manual/introduction/getting_started:output}\label{docs/user_manual/introduction/getting_started:sec-output}
\index{output save as image}
\index{print composer quick print}
Plusieurs sorties graphiques sont possibles depuis votre session. Nous en avons déjà vue une dans la section {\hyperref[docs/user_manual/introduction/getting_started:sec-projects]{\emph{Les projets}}} : sauvegarder dans un fichier de projet. Voici d'autres manières de produire une sortie graphique :
\begin{itemize}
\item {} 
L'option de menu  \emph{Fichier \(\rightarrow\)} \includegraphics[width=1.5em]{mActionSaveMapAsImage.png} $^{\text{Sauvegarder comme image...}}$ ouvre une fenêtre où vous devez saisir le nom, le chemin et le type d'image (PNG ou JPEG). Un fichier ``worldfile'' avec le même nom et avec l'extension PNGW ou JPGW est enregistré dans le même dossier que l'image, géoréférence celle-ci.

\item {} 
L'option de menu \emph{Fichier \(\rightarrow\)} \includegraphics[width=1.5em]{mActionNewComposer.png} \emph{Nouveau composeur d'impression} ouvre une fenêtre où vous pouvez faire une mise en page et imprimer la vue active de la carte (voir Section {\hyperref[docs/user_manual/print_composer/print_composer:label-printcomposer]{\emph{Composeur de cartes}}}).

\end{itemize}


\chapter{Interface de QGIS}
\label{docs/user_manual/introduction/qgis_gui:label-qgismainwindow}\label{docs/user_manual/introduction/qgis_gui:qgis-gui}\label{docs/user_manual/introduction/qgis_gui::doc}
Quand QGIS démarre, l'interface se présente à vous sous la forme affichée ci-dessous (les nombres de 1 à 5 se réfèrent aux cinq zones principales de l'interface décrites ici) :
\phantomsection\label{docs/user_manual/introduction/qgis_gui:fig-startup}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{startup.png}
\caption{QGIS GUI with Alaska sample data \includegraphics[width=1em]{nix.png}}\end{figure}

\begin{notice}{note}{Note:}
Le style des fenêtres peut vous apparaître différemment en fonction de votre système d'exploitation et de votre gestionnaire de fenêtres.
\end{notice}

L'interface de QGIS est divisée en cinq zones distinctes :
\begin{enumerate}
\item {} 
Barre de Menu

\item {} 
Barre d'Outils

\item {} 
Légende de la carte

\item {} 
Affichage de la carte

\item {} 
Barre d'état

\end{enumerate}

Ces cinq composants sont décrits dans les sections suivantes. Deux autres sections présentent les raccourcis clavier et l'aide contextuelle.


\section{Barre de Menu}
\label{docs/user_manual/introduction/qgis_gui:label-menubar}\label{docs/user_manual/introduction/qgis_gui:menu-bar}
\index{menus}
La barre de menu donne accès aux différentes fonctionnalités de QGIS par le biais de menus hiérarchiques. Les entrées du menu de niveau supérieur et un résumé de certaines options sont listés ci-dessous, avec les icônes des outils correspondants dans la barre d'outils et leurs raccourcis clavier. Les raccourcis clavier peuvent également être configurés manuellement via le menu {[}\textbf{Configurer les raccourcis...}{]} dans \emph{Préférences} (ceux présentés ici sont définis par défaut).

Bien que les options de menu aient des outils qui leur correspondent et vice-versa, les menus ne sont pas organisés comme les barres d'outils. La barre contenant l'outil est affichée à la suite de chaque option de menu. Certaines entrées n'apparaissent que lorsque les extensions correspondantes sont activées. Pour plus d'informations sur les outils et les barres d'outils, veuillez lire la section {\hyperref[docs/user_manual/introduction/qgis_gui:label-toolbars]{\emph{Barre d'outils}}}.


\subsection{Fichier}
\label{docs/user_manual/introduction/qgis_gui:file}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Barre de Menu
} & \textsf{\relax 
Raccourci
} & \textsf{\relax 
Référence
} & \textsf{\relax 
Barre d'outils
}\\
\hline
\includegraphics[width=1.5em]{mActionFileNew.png} \emph{Nouveau Projet}
 & 
\code{Ctrl+N}
 & 
voir {\hyperref[docs/user_manual/introduction/getting_started:sec-projects]{\emph{Les projets}}}
 & 
\emph{Fichier}
\\

\includegraphics[width=1.5em]{mActionFileOpen.png} \emph{Ouvrir un projet...}
 & 
\code{Ctrl+O}
 & 
voir {\hyperref[docs/user_manual/introduction/getting_started:sec-projects]{\emph{Les projets}}}
 & 
\emph{Fichier}
\\

\emph{Ouvrir un projet récent \(\rightarrow\)}
 & 

 & 
voir {\hyperref[docs/user_manual/introduction/getting_started:sec-projects]{\emph{Les projets}}}
 & 

\\

\includegraphics[width=1.5em]{mActionFileSave.png} \emph{Sauvegarder le projet}
 & 
\code{Ctrl+S}
 & 
voir {\hyperref[docs/user_manual/introduction/getting_started:sec-projects]{\emph{Les projets}}}
 & 
\emph{Fichier}
\\

\includegraphics[width=1.5em]{mActionFileSaveAs.png} \emph{Sauvegarder le projet sous...}
 & 
\code{Ctrl+Shift+S}
 & 
voir {\hyperref[docs/user_manual/introduction/getting_started:sec-projects]{\emph{Les projets}}}
 & 
\emph{Fichier}
\\

\includegraphics[width=1.5em]{mActionSaveMapAsImage.png} \emph{Sauvegarder comme image...}
 & 

 & 
voir {\hyperref[docs/user_manual/introduction/getting_started:sec-output]{\emph{Sortie graphique}}}
 & 

\\

\includegraphics[width=1.5em]{mActionNewComposer.png} \emph{Nouveau composeur d'impression}
 & 
\code{Ctrl+P}
 & 
voir {\hyperref[docs/user_manual/print_composer/print_composer:label-printcomposer]{\emph{Composeur de cartes}}}
 & 
\emph{Fichier}
\\

\includegraphics[width=1.5em]{mActionComposerManager.png} \emph{Gestionnaire de composeur...}
 & 

 & 
voir {\hyperref[docs/user_manual/print_composer/print_composer:label-printcomposer]{\emph{Composeur de cartes}}}
 & 
\emph{Fichier}
\\

\emph{Composeurs d'impression \(\rightarrow\)}
 & 

 & 
voir {\hyperref[docs/user_manual/print_composer/print_composer:label-printcomposer]{\emph{Composeur de cartes}}}
 & 

\\

\includegraphics{mActionFileExit.png} \emph{Quitter}
 & 
\code{Ctrl+Q}
 & 

 & 

\\
\hline\end{tabulary}



\subsection{Éditer}
\label{docs/user_manual/introduction/qgis_gui:edit}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Barre de Menu
} & \textsf{\relax 
Raccourci
} & \textsf{\relax 
Référence
} & \textsf{\relax 
Barre d'outils
}\\
\hline
\includegraphics[width=1.5em]{mActionUndo.png} \emph{Annuler}
 & 
\code{Ctrl+Z}
 & 
voir {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Numérisation avancée}}}
 & 
\emph{Numérisation avancée}
\\

\includegraphics[width=1.5em]{mActionRedo.png} \emph{Refaire}
 & 
\code{Ctrl+Shift+Z}
 & 
voir {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Numérisation avancée}}}
 & 
\emph{Numérisation avancée}
\\

\includegraphics[width=1.5em]{mActionEditCut.png} \emph{Couper Entités}
 & 
\code{Ctrl+X}
 & 
voir {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-edit-existing-layer]{\emph{Numériser une couche existante}}}
 & 
\emph{Numérisation}
\\

\includegraphics[width=1.5em]{mActionEditCopy.png} \emph{Copier Entités}
 & 
\code{Ctrl+C}
 & 
voir {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-edit-existing-layer]{\emph{Numériser une couche existante}}}
 & 
\emph{Numérisation}
\\

\includegraphics[width=1.5em]{mActionEditPaste.png} \emph{Coller Entités}
 & 
\code{Ctrl+V}
 & 
voir {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-edit-existing-layer]{\emph{Numériser une couche existante}}}
 & 
\emph{Numérisation}
\\

\includegraphics[width=1.5em]{mActionCapturePoint.png} \emph{Ajouter un point}
 & 
\code{Ctrl+.}
 & 
voir {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-edit-existing-layer]{\emph{Numériser une couche existante}}}
 & 
\emph{Numérisation}
\\

\includegraphics[width=1.5em]{mActionMoveFeature.png} \emph{Déplacer l'entité}
 & 

 & 
voir {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-edit-existing-layer]{\emph{Numériser une couche existante}}}
 & 
\emph{Numérisation}
\\

\includegraphics[width=1.5em]{mActionDeleteSelected.png} \emph{Supprimer les entités sélectionnées}
 & 

 & 
voir {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-edit-existing-layer]{\emph{Numériser une couche existante}}}
 & 
\emph{Numérisation}
\\

\includegraphics[width=2em]{mActionSimplify.png} \emph{Simplifier l'entité}
 & 

 & 
voir {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Numérisation avancée}}}
 & 
\emph{Numérisation avancée}
\\

\includegraphics[width=2em]{mActionAddRing.png} \emph{Ajouter un anneau}
 & 

 & 
voir {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Numérisation avancée}}}
 & 
\emph{Numérisation avancée}
\\

\includegraphics[width=2em]{mActionAddIsland.png} \emph{Ajouter une partie}
 & 

 & 
voir {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Numérisation avancée}}}
 & 
\emph{Numérisation avancée}
\\

\includegraphics[width=2em]{mActionDeleteRing.png} \emph{Effacer un anneau}
 & 

 & 
voir {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Numérisation avancée}}}
 & 
\emph{Numérisation avancée}
\\

\includegraphics[width=2em]{mActionDeletePart.png} \emph{Effacer une partie}
 & 

 & 
voir {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Numérisation avancée}}}
 & 
\emph{Numérisation avancée}
\\

\includegraphics[width=1.5em]{mActionReshape.png} \emph{Remodeler les entités}
 & 

 & 
voir {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Numérisation avancée}}}
 & 
\emph{Numérisation avancée}
\\

\includegraphics[width=1.5em]{mActionOffsetCurve.png} \emph{Décaler la courbe}
 & 

 & 
voir {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Numérisation avancée}}}
 & 
\emph{Numérisation avancée}
\\

\includegraphics[width=1.5em]{mActionSplitFeatures.png} \emph{Séparer les entités}
 & 

 & 
voir {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Numérisation avancée}}}
 & 
\emph{Numérisation avancée}
\\

\includegraphics[width=1.5em]{mActionMergeFeatures.png} \emph{Fusionner les entités sélectionnées}
 & 

 & 
voir {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Numérisation avancée}}}
 & 
\emph{Numérisation avancée}
\\

\includegraphics[width=1.5em]{mActionMergeFeatures.png} \emph{Fusionner les attributs des entités sélectionnées}
 & 

 & 
voir {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Numérisation avancée}}}
 & 
\emph{Numérisation avancée}
\\

\includegraphics[width=1.5em]{mActionNodeTool.png} \emph{Outil de noeud}
 & 

 & 
voir {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-edit-existing-layer]{\emph{Numériser une couche existante}}}
 & 
\emph{Numérisation}
\\

\includegraphics[width=1.5em]{mActionRotatePointSymbols.png} \emph{Rotation des symboles de points}
 & 

 & 
voir {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Numérisation avancée}}}
 & 
\emph{Numérisation avancée}
\\
\hline\end{tabulary}






L'activation du mode \includegraphics[width=1.5em]{mActionToggleEditing.png} $^{\text{Basculer en mode édition}}$ pour une couche fait apparaître une icône de création d'entité dans le menu \emph{Éditer} qui dépend du type de couche (point, ligne ou polygone).


\subsection{Éditer (selon le type de couche)}
\label{docs/user_manual/introduction/qgis_gui:edit-extra}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Barre de Menu
} & \textsf{\relax 
Raccourci
} & \textsf{\relax 
Référence
} & \textsf{\relax 
Barre d'outils
}\\
\hline
\includegraphics[width=1.5em]{mActionCapturePoint.png} \emph{Ajouter un point}
 & 

 & 
voir {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-edit-existing-layer]{\emph{Numériser une couche existante}}}
 & 
\emph{Numérisation}
\\

\includegraphics[width=1.5em]{mActionCaptureLine.png} \emph{Ajouter une Ligne}
 & 

 & 
voir {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-edit-existing-layer]{\emph{Numériser une couche existante}}}
 & 
\emph{Numérisation}
\\

\includegraphics[width=1.5em]{mActionCapturePolygon.png} \emph{Ajouter un polygone}
 & 

 & 
voir {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-edit-existing-layer]{\emph{Numériser une couche existante}}}
 & 
\emph{Numérisation}
\\
\hline\end{tabulary}



\subsection{Affichage de la carte}
\label{docs/user_manual/introduction/qgis_gui:view}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Barre de Menu
} & \textsf{\relax 
Raccourci
} & \textsf{\relax 
Référence
} & \textsf{\relax 
Barre d'outils
}\\
\hline
\includegraphics[width=1.5em]{mActionPan.png} \emph{Se déplacer dans la carte}
 & 

 & 

 & 
\emph{Navigation}
\\

\includegraphics[width=1.5em]{mActionPanToSelected.png} \emph{Déplacer la carte jusqu'à la sélection}
 & 

 & 

 & 
\emph{Navigation}
\\

\includegraphics[width=1.5em]{mActionZoomIn.png} \emph{Zoom +}
 & 
\code{Ctrl++}
 & 

 & 
\emph{Navigation}
\\

\includegraphics[width=1.5em]{mActionZoomOut.png} \emph{Zoom -}
 & 
\code{Ctrl+-}
 & 

 & 
\emph{Navigation}
\\

\emph{Sélection \(\rightarrow\)}
 & 

 & 
voir {\hyperref[docs/user_manual/introduction/general_tools:sec-selection]{\emph{Sélectionner et désélectionner des entités}}}
 & 
\emph{Attributs}
\\

\includegraphics[width=1.5em]{mActionIdentify.png} \emph{Identifier les entités}
 & 
\code{Ctrl+Shift+I}
 & 

 & 
\emph{Attributs}
\\

\emph{Mesure \(\rightarrow\)}
 & 

 & 
voir {\hyperref[docs/user_manual/introduction/general_tools:sec-measure]{\emph{Mesurer}}}
 & 
\emph{Attributs}
\\

\includegraphics[width=1.5em]{mActionZoomFullExtent.png} \emph{Zoom sur l'étendue}
 & 
\code{Ctrl+Shift+F}
 & 

 & 
\emph{Navigation}
\\

\includegraphics[width=1.5em]{mActionZoomToLayer.png} \emph{Zoom sur la couche}
 & 

 & 

 & 
\emph{Navigation}
\\

\includegraphics[width=1.5em]{mActionZoomToSelected.png} \emph{Zoom sur la sélection}
 & 
\code{Ctrl+J}
 & 

 & 
\emph{Navigation}
\\

\includegraphics[width=1.5em]{mActionZoomLast.png} \emph{Zoom précédent}
 & 

 & 

 & 
\emph{Navigation}
\\

\includegraphics[width=1.5em]{mActionZoomNext.png} \emph{Zoom suivant}
 & 

 & 

 & 
\emph{Navigation}
\\

\includegraphics[width=1.5em]{mActionZoomActual.png} \emph{Zoom à la taille réelle}
 & 

 & 

 & 
\emph{Navigation}
\\

\emph{Décorations \(\rightarrow\)}
 & 

 & 
voir {\hyperref[docs/user_manual/introduction/general_tools:decorations]{\emph{Décorations}}}
 & 

\\

\includegraphics[width=1.5em]{mActionMapTips.png} \emph{Infobulles}
 & 

 & 

 & 
\emph{Attributs}
\\

\includegraphics[width=1.5em]{mActionNewBookmark.png} \emph{Nouveau signet...}
 & 
\code{Ctrl+B}
 & 
voir {\hyperref[docs/user_manual/introduction/general_tools:sec-bookmarks]{\emph{Signets spatiaux}}}
 & 
\emph{Attributs}
\\

\includegraphics[width=1.5em]{mActionShowBookmarks.png} \emph{Montrer les signets}
 & 
\code{Ctrl+Shift+B}
 & 
voir {\hyperref[docs/user_manual/introduction/general_tools:sec-bookmarks]{\emph{Signets spatiaux}}}
 & 
\emph{Attributs}
\\

\includegraphics[width=1.5em]{mActionDraw.png} \emph{Rafraîchir}
 & 
\code{Ctrl+R}
 &  & 
\emph{Navigation}
\\

\emph{Barre d'échelle des tuiles}
 & 

 & 
voir {\hyperref[docs/user_manual/working_with_ogc/ogc_client_support:tilesets]{\emph{Jeux de Tuiles}}}
 & 
\emph{Échelle de tuile}
\\
\hline\end{tabulary}



\subsection{Couche}
\label{docs/user_manual/introduction/qgis_gui:layer}
\begin{longtable}{|l|l|l|l|}
\hline
\textsf{\relax 
Barre de Menu
} & \textsf{\relax 
Raccourci
} & \textsf{\relax 
Référence
} & \textsf{\relax 
Barre d'outils
}\\
\hline\endfirsthead

\multicolumn{4}{c}%
{{\textsf{\tablename\ \thetable{} -- Suite de la page précédente}}} \\
\hline
\textsf{\relax 
Barre de Menu
} & \textsf{\relax 
Raccourci
} & \textsf{\relax 
Référence
} & \textsf{\relax 
Barre d'outils
}\\
\hline\endhead

\hline \multicolumn{4}{|r|}{{\textsf{Suite sur la page suivante}}} \\ \hline
\endfoot

\endlastfoot


\emph{Nouvelle \(\rightarrow\)}
 & 

 & 
voir {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-create-shape]{\emph{Créer une nouvelle couche vecteur}}}
 & 
\emph{Contrôle des couches}
\\

\emph{Intégrer des couches et des groupes}
 & 

 & 
voir {\hyperref[docs/user_manual/introduction/general_tools:nesting-projects]{\emph{Inclusion de projets}}}
 & 

\\

\includegraphics[width=1.5em]{mActionAddNonDbLayer.png} \emph{Ajouter une couche vecteur...}
 & 
\code{Ctrl+Shift+V}
 & 
voir {\hyperref[docs/user_manual/working_with_vector/index:label-workingvector]{\emph{Les données vectorielles}}}
 & 
\emph{Contrôle des couches}
\\

\includegraphics[width=1.5em]{mActionAddRasterLayer.png} \emph{Ajouter une couche raster...}
 & 
\code{Ctrl+Shift+R}
 & 
voir {\hyperref[docs/user_manual/working_with_raster/supported_data:load-raster]{\emph{Charger des données raster dans QGIS}}}
 & 
\emph{Contrôle des couches}
\\

\includegraphics[width=1.5em]{mActionAddLayer.png} \emph{Ajouter une couche PostGIS...}
 & 
\code{Ctrl+Shift+D}
 & 
voir {\hyperref[docs/user_manual/working_with_vector/supported_data:label-postgis]{\emph{Couches PostGIS}}}
 & 
\emph{Contrôle des couches}
\\

\includegraphics[width=1.5em]{mActionAddSpatiaLiteLayer.png} \emph{Ajouter une couche Spatialite...}
 & 
\code{Ctrl+Shift+L}
 & 
voir {\hyperref[docs/user_manual/working_with_vector/supported_data:label-spatialite]{\emph{Couches SpatiaLite}}}
 & 
\emph{Contrôle des couches}
\\

\includegraphics[width=1.5em]{mActionAddMssqlLayer.png} \emph{Ajouter une couche MSSQL...}
 & 
\code{Ctrl+Shift+M}
 & 
voir {\hyperref[docs/user_manual/working_with_vector/supported_data:label-mssql]{\emph{Couches MSSQL Spatial}}}
 & 
\emph{Contrôle des couches}
\\

\includegraphics[width=1.5em]{mActionAddWmsLayer.png} \emph{Ajouter une couche WMS...}
 & 
\code{Ctrl+Shift+W}
 & 
voir {\hyperref[docs/user_manual/working_with_ogc/ogc_client_support:ogc-wms]{\emph{Client WMS}}}
 & 
\emph{Contrôle des couches}
\\

\includegraphics[width=1.5em]{delimited_text.png} \emph{Ajouter une couche de texte délimité}
 & 

 & 
voir {\hyperref[docs/user_manual/plugins/plugins_delimited_text:label-dltext]{\emph{Extension Texte Délimité}}}
 & 
\emph{Contrôle des couches}
\\

\includegraphics[width=1.5em]{gps_importer.png} \emph{Créer une nouvelle couche GPS}
 & 

 & 
voir {\hyperref[docs/user_manual/working_with_gps/plugins_gps:plugin-gps]{\emph{Extension GPS}}}
 & 
\emph{Contrôle des couches}
\\

\includegraphics[width=1.5em]{oracle_raster.png} \emph{Ajouter une couche GeoRaster Oracle}
 & 

 & 
voir {\hyperref[docs/user_manual/plugins/plugins_oracle_raster:oracle-raster]{\emph{Extension GeoRaster Oracle}}}
 & 
\emph{Contrôle des couches}
\\

\includegraphics[width=1.5em]{sqlanywhere.png} \emph{Ajouter une couche SQL Anywhere}
 & 

 & 
voir {\hyperref[docs/user_manual/plugins/plugins_sql_anywhere:sqlanywhere]{\emph{Extension SQL Anywhere}}}
 & 
\emph{Contrôle des couches}
\\

\includegraphics[width=1.5em]{wfs.png} \emph{Ajouter une couche WFS}
 & 

 & 

 & 
\emph{Contrôle des couches}
\\

\includegraphics[width=1.5em]{mActionEditCopy.png} \emph{Copier le style}
 & 

 & 
voir {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-style-tab]{\emph{Onglet Style}}}
 & 

\\

\includegraphics[width=1.5em]{mActionEditPaste.png} \emph{Coller le style}
 & 

 & 
voir {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-style-tab]{\emph{Onglet Style}}}
 & 

\\

\includegraphics[width=1.5em]{mActionOpenTable.png} \emph{Ouvrir la table d'attributs}
 & 

 & 

 & 
\emph{Attributs}
\\

\includegraphics[width=1.5em]{mActionFileSave.png} \emph{Sauvegarder les modifications}
 & 

 & 

 & 
\emph{Numérisation}
\\

\includegraphics[width=1.5em]{mActionToggleEditing.png} \emph{Basculer en mode édition}
 & 

 & 

 & 
\emph{Numérisation}
\\

\emph{Sauvegarder sous...}
 & 

 & 

 & 

\\

\emph{Enregistrer la sélection en tant que fichier vectoriel}
 & 

 & 
voir {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-attribute-table]{\emph{Travailler avec la table d'attributs}}}
 & 

\\

\includegraphics[width=1.5em]{mActionRemoveLayer.png} \emph{Supprimer la couche}
 & 
\code{Ctrl+D}
 & 

 & 

\\

\emph{Définir le SCR des couches}
 & 
\code{Ctrl+Shift+C}
 & 

 & 

\\

\emph{Définir le SCR du projet depuis cette couche}
 & 

 & 

 & 

\\

\emph{Propriétés...}
 & 

 & 

 & 

\\

\emph{Requête...}
 & 

 & 

 & 

\\

\includegraphics[width=1.5em]{mActionLabeling.png} \emph{Étiquetage}
 & 

 & 

 & 

\\

\includegraphics[width=1.5em]{mActionInOverview.png} \emph{Ajouter dans l'aperçu}
 & 
\code{Ctrl+Shift+O}
 & 

 & 
\emph{Contrôle des couches}
\\

\includegraphics[width=1.5em]{mActionAddAllToOverview.png} \emph{Tout ajouter dans l'aperçu}
 & 

 & 

 & 

\\

\includegraphics[width=1.5em]{mActionRemoveAllFromOverview.png} \emph{Enlever tout de l'aperçu}
 & 

 & 

 & 

\\

\includegraphics[width=1.5em]{mActionShowAllLayers.png} \emph{Afficher toutes les couches}
 & 
\code{Ctrl+Shift+U}
 & 

 & 
\emph{Contrôle des couches}
\\

\includegraphics[width=1.5em]{mActionHideAllLayers.png} \emph{Cacher toutes les couches}
 & 
\code{Ctrl+Shift+H}
 & 

 & 
\emph{Contrôle des couches}
\\
\hline\end{longtable}



\subsection{Préférences}
\label{docs/user_manual/introduction/qgis_gui:settings}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Barre de Menu
} & \textsf{\relax 
Raccourci
} & \textsf{\relax 
Référence
} & \textsf{\relax 
Barre d'outils
}\\
\hline
\emph{Panneaux \(\rightarrow\)}
 & 

 & 
voir {\hyperref[docs/user_manual/introduction/qgis_configuration:sec-panels-and-toolbars]{\emph{Panneaux et barres d'outils}}}
 & 

\\

\emph{Barres d'outils \(\rightarrow\)}
 & 

 & 
voir {\hyperref[docs/user_manual/introduction/qgis_configuration:sec-panels-and-toolbars]{\emph{Panneaux et barres d'outils}}}
 & 

\\

\emph{Basculer en mode plein écran}
 & 
\code{Ctrl-F}
 & 

 & 

\\

\includegraphics[width=1.5em]{mActionProjectProperties.png} \emph{Propriétés du projet...}
 & 
\code{Ctrl+Shift+P}
 & 
voir {\hyperref[docs/user_manual/introduction/getting_started:sec-projects]{\emph{Les projets}}}
 & 

\\

\includegraphics[width=1.5em]{mActionCustomProjection.png} \emph{Projection personnalisée...}
 & 

 & 
voir {\hyperref[docs/user_manual/working_with_projections/working_with_projections:sec-custom-projections]{\emph{Système de Coordonnées de Référence personnalisé}}}
 & 

\\

\emph{Gestionnaire de style...}
 & 

 & 
voir {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-style-manager]{\emph{Gestionnaire de styles}}}
 & 

\\

\includegraphics[width=1em]{mActionOptions.png} \emph{Configurer les raccourcis...}
 & 

 & 

 & 

\\

\includegraphics[width=1em]{mActionOptions.png} \emph{Personnalisation}
 & 

 & 
voir {\hyperref[docs/user_manual/introduction/qgis_configuration:sec-customization]{\emph{Personnalisation}}}
 & 

\\

\includegraphics[width=1em]{mActionOptions.png} \emph{Options...}
 & 

 & 
voir {\hyperref[docs/user_manual/introduction/qgis_configuration:gui-options]{\emph{Options}}}
 & 

\\

\emph{Options d'accrochage}
 & 

 & 

 & 

\\
\hline\end{tabulary}



\subsection{Extensions}
\label{docs/user_manual/introduction/qgis_gui:plugins}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Barre de Menu
} & \textsf{\relax 
Raccourci
} & \textsf{\relax 
Référence
} & \textsf{\relax 
Barre d'outils
}\\
\hline
\includegraphics[width=1.5em]{plugin_installer.png} \emph{Installateur d'extensions Python}
 & 

 & 
voir {\hyperref[docs/user_manual/plugins/plugins:plugins]{\emph{Extensions QGIS}}}
 & 

\\

\includegraphics[width=1.5em]{mActionShowPluginManager.png} \emph{Gestionnaire d'extension...}
 & 

 & 
voir {\hyperref[docs/user_manual/plugins/plugins:managing-plugins]{\emph{Gestion des extensions}}}
 & 

\\

\emph{Console Python}
 & 

 & 

 & 

\\

\emph{GRASS \(\rightarrow\)}
 & 

 & 
voir {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-grass]{\emph{Intégration du SIG GRASS}}}
 & 
\emph{GRASS}
\\
\hline\end{tabulary}



\subsection{Vecteur}
\label{docs/user_manual/introduction/qgis_gui:vector}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Barre de Menu
} & \textsf{\relax 
Raccourci
} & \textsf{\relax 
Référence
} & \textsf{\relax 
Barre d'outils
}\\
\hline
\emph{Outils d'analyse \(\rightarrow\)}
 & 

 & 
voir {\hyperref[docs/user_manual/plugins/plugins_ftools:ftools]{\emph{Extension fTools}}}
 & 

\\

\emph{Saisie de coordonnées \(\rightarrow\)}
 & 

 & 
voir {\hyperref[docs/user_manual/plugins/plugins_coordinate_capture:coordcapt]{\emph{Extension de Saisie de Coordonnées}}}
 & 

\\

\emph{Outils de gestion de données \(\rightarrow\)}
 & 

 & 
voir {\hyperref[docs/user_manual/plugins/plugins_ftools:ftools]{\emph{Extension fTools}}}
 & 

\\

\emph{Dxf2Shp \(\rightarrow\)}
 & 

 & 
voir {\hyperref[docs/user_manual/plugins/plugins_dxf2shape_converter:dxf2shape]{\emph{Extension Convertisseur Dxf2Shp}}}
 & 
\emph{Vecteur}
\\

\emph{Outils de géométrie \(\rightarrow\)}
 & 

 & 
voir {\hyperref[docs/user_manual/plugins/plugins_ftools:ftools]{\emph{Extension fTools}}}
 & 

\\

\emph{Outils de géotraitement \(\rightarrow\)}
 & 

 & 
voir {\hyperref[docs/user_manual/plugins/plugins_ftools:ftools]{\emph{Extension fTools}}}
 & 

\\

\emph{GPS \(\rightarrow\)}
 & 

 & 
voir {\hyperref[docs/user_manual/working_with_gps/plugins_gps:plugin-gps]{\emph{Extension GPS}}}
 & 
\emph{Vecteur}
\\

\emph{Outils de recherche \(\rightarrow\)}
 & 

 & 
voir {\hyperref[docs/user_manual/plugins/plugins_ftools:ftools]{\emph{Extension fTools}}}
 & 

\\

\emph{Graphes routiers \(\rightarrow\)}
 & 

 & 
voir {\hyperref[docs/user_manual/plugins/plugins_road_graph:roadgraph]{\emph{Extension Graphe routier}}}
 & 

\\

\emph{Requête spatiale \(\rightarrow\)}
 & 

 & 
voir {\hyperref[docs/user_manual/plugins/plugins_spatial_query:spatial-query]{\emph{Extension Requête Spatiale}}}
 & 
\emph{Vecteur}
\\
\hline\end{tabulary}



\subsection{Raster}
\label{docs/user_manual/introduction/qgis_gui:raster}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Barre de Menu
} & \textsf{\relax 
Raccourci
} & \textsf{\relax 
Référence
} & \textsf{\relax 
Barre d'outils
}\\
\hline
\emph{Calculatrice raster}
 & 

 & 
voir  {\hyperref[docs/user_manual/working_with_raster/raster_calculator:sec-raster-calc]{\emph{Calculatrice Raster}}}
 & 

\\

\emph{Géoréférencer \(\rightarrow\)}
 & 

 & 
voir {\hyperref[docs/user_manual/plugins/plugins_georeferencer:georef]{\emph{L'extension de géoréférencement}}}
 & 
\emph{Raster}
\\

\emph{Carte de chaleur \(\rightarrow\)}
 & 

 & 
voir {\hyperref[docs/user_manual/plugins/plugins_heatmap:heatmap-plugin]{\emph{Extension Carte de chaleur}}}
 & 
\emph{Raster}
\\

\emph{Interpolation \(\rightarrow\)}
 & 

 & 
voir {\hyperref[docs/user_manual/plugins/plugins_interpolation:interpol]{\emph{Extension Interpolation}}}
 & 
\emph{Raster}
\\

\includegraphics[width=1.5em]{dem.png} \emph{Analyse de terrain}
 & 

 & 
voir {\hyperref[docs/user_manual/plugins/plugins_raster_terrain:rasterrain]{\emph{Extension d'Analyse Raster de Terrain}}}
 & 

\\

\emph{Statistiques zonales \(\rightarrow\)}
 & 

 & 
voir {\hyperref[docs/user_manual/plugins/plugins_zonal_statistics:zonal-statistics]{\emph{Extension Statistiques de zone}}}
 & 
\emph{Raster}
\\

\emph{Projections \(\rightarrow\)}
 & 

 & 
voir {\hyperref[docs/user_manual/plugins/plugins_gdaltools:label-plugingdaltools]{\emph{Extension GDALTools}}}
 & 

\\

\emph{Conversion \(\rightarrow\)}
 & 

 & 
voir {\hyperref[docs/user_manual/plugins/plugins_gdaltools:label-plugingdaltools]{\emph{Extension GDALTools}}}
 & 

\\

\emph{Extraction \(\rightarrow\)}
 & 

 & 
voir {\hyperref[docs/user_manual/plugins/plugins_gdaltools:label-plugingdaltools]{\emph{Extension GDALTools}}}
 & 

\\

\emph{Analyse \(\rightarrow\)}
 & 

 & 
voir {\hyperref[docs/user_manual/plugins/plugins_gdaltools:label-plugingdaltools]{\emph{Extension GDALTools}}}
 & 

\\

\emph{Divers \(\rightarrow\)}
 & 

 & 
voir {\hyperref[docs/user_manual/plugins/plugins_gdaltools:label-plugingdaltools]{\emph{Extension GDALTools}}}
 & 

\\

\emph{Paramètres de GdalTools}
 & 

 & 
voir {\hyperref[docs/user_manual/plugins/plugins_gdaltools:label-plugingdaltools]{\emph{Extension GDALTools}}}
 & 

\\
\hline\end{tabulary}



\subsection{Base de données}
\label{docs/user_manual/introduction/qgis_gui:database}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Barre de Menu
} & \textsf{\relax 
Raccourci
} & \textsf{\relax 
Référence
} & \textsf{\relax 
Barre d'outils
}\\
\hline
\emph{DB manager \(\rightarrow\)}
 & 

 & 
voir {\hyperref[docs/user_manual/plugins/plugins_db_manager:dbmanager]{\emph{Extension DB Manager}}}
 & 
\emph{Base de données}
\\

\emph{eVis \(\rightarrow\)}
 & 

 & 
voir {\hyperref[docs/user_manual/plugins/plugins_evis:evis]{\emph{Extension eVis}}}
 & 
\emph{Base de données}
\\

\emph{Édition hors connexion \(\rightarrow\)}
 & 

 & 
voir {\hyperref[docs/user_manual/plugins/plugins_offline_editing:offlinedit]{\emph{Extension d'Édition hors-ligne}}}
 & 
\emph{Base de données}
\\

\emph{Spit \(\rightarrow\)}
 & 

 & 
voir {\hyperref[docs/user_manual/plugins/plugins_spit:label-spit]{\emph{Extension SPIT}}}
 & 
\emph{Base de données}
\\
\hline\end{tabulary}



\subsection{Web}
\label{docs/user_manual/introduction/qgis_gui:web}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Barre de Menu
} & \textsf{\relax 
Raccourci
} & \textsf{\relax 
Référence
} & \textsf{\relax 
Barre d'outils
}\\
\hline
\emph{MapServer Export ... \(\rightarrow\)}
 & 

 & 
voir {\hyperref[docs/user_manual/plugins/plugins_mapserver_export:mapserver-export]{\emph{Extension d'exportation Mapserver}}}
 & 
\emph{Web}
\\

\emph{OpenStreetMap \(\rightarrow\)}
 & 

 & 
voir {\hyperref[docs/user_manual/osm/openstreetmap:plugins-osm]{\emph{OpenStreetMap}}}
 & 
\emph{OpenStreetMap}
\\
\hline\end{tabulary}



\subsection{Aide}
\label{docs/user_manual/introduction/qgis_gui:help}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Barre de Menu
} & \textsf{\relax 
Raccourci
} & \textsf{\relax 
Référence
} & \textsf{\relax 
Barre d'outils
}\\
\hline
\includegraphics[width=1.5em]{mActionHelpContents.png} \emph{Table des matières de l'aide}
 & 
\code{F1}
 & 

 & 
\emph{Aide}
\\

\includegraphics[width=1.5em]{whats_this.png} \emph{Qu'est-ce que c'est ?}
 & 
\code{Shift+F1}
 & 

 & 
\emph{Aide}
\\

\emph{Documentation de l'API}
 & 

 & 

 & 

\\

\includegraphics[width=1.5em]{mActionQgisHomePage.png} \emph{Site officiel de QGIS}
 & 
\code{Ctrl+H}
 & 

 & 

\\

\includegraphics[width=1.5em]{mActionCheckQgisVersion.png} \emph{Vérifier la version de QGIS}
 & 

 & 

 & 

\\

\includegraphics[width=1.5em]{mActionHelpAbout.png} \emph{À propos}
 & 

 & 

 & 

\\

\includegraphics[width=1.5em]{mActionHelpSponsors.png} \emph{Sponsors de QGIS}
 & 

 & 

 & 

\\
\hline\end{tabulary}




Notez que pour Linux \includegraphics[width=1em]{nix.png}, la liste des entrées de menu décrites précédemment reprend l'agencement par défaut du gestionnaire de fenêtre KDE. Sous GNOME, le menu Préférences n'existe pas et ses entrées sont réparties comme suit :

\begin{tabulary}{\linewidth}{|L|L|}
\hline

\includegraphics[width=1.5em]{mActionProjectProperties.png} \emph{Propriétés du projet}
 & 
\emph{Fichier}
\\

\includegraphics[width=1em]{mActionOptions.png} \emph{Options}
 & 
\emph{Édition}
\\

\includegraphics[width=1em]{mActionOptions.png} \emph{Configurer les raccourcis}
 & 
\emph{Édition}
\\

\emph{Gestionnaire de style}
 & 
\emph{Édition}
\\

\includegraphics[width=1.5em]{mActionCustomProjection.png} \emph{Projection personnalisée}
 & 
\emph{Édition}
\\

\emph{Panneaux \(\rightarrow\)}
 & 
\emph{Vue}
\\

\emph{Barres d'outils \(\rightarrow\)}
 & 
\emph{Vue}
\\

\emph{Basculer en mode plein écran}
 & 
\emph{Vue}
\\

\emph{Échelle de tuile}
 & 
\emph{Vue}
\\

\emph{Live GPS tracking}
 & 
\emph{Vue}
\\
\hline\end{tabulary}



\section{Barre d'outils}
\label{docs/user_manual/introduction/qgis_gui:label-toolbars}\label{docs/user_manual/introduction/qgis_gui:toolbar}
\index{toolbar}
La barre d'outils fournit un accès à la majorité des fonctions des menus en plus d'outils additionnels destinés à interagir avec la carte. Chaque outil dispose d'une bulle d'aide qui s'affiche lorsque vous placez votre curseur au-dessus. Celle-ci affiche une courte description du rôle de l'outil.

Chaque barre de menu peut être déplacée selon vos besoins. Vous pouvez les désactiver à partir du menu contextuel qui s'affiche d'un clic droit de la souris sur la barre d'outils (voir aussi {\hyperref[docs/user_manual/introduction/qgis_configuration:sec-panels-and-toolbars]{\emph{Panneaux et barres d'outils}}}).

\index{layout toolbars}
\begin{notice}{tip}{Astuce:}
\textbf{Restaurer des barres d'outils}

Si vous avez accidentellement masqué toutes vos barres d'outils, vous pouvez les récupérer en sélectionnant le menu \emph{Vue \(\rightarrow\) Barres d'outils \(\rightarrow\)}. Si une barre d'outils disparaît sous Windows, ce qui semble arriver de temps en temps, il faut supprimer \code{\textbackslash{}HKEY\_CURRENT\_USER\textbackslash{}Software\textbackslash{}QuantumGIS\textbackslash{}qgis\textbackslash{}UI\textbackslash{}state} dans la base de registre. Lorsque vous relancez QGIS, la clé est de nouveau écrite en partant de l'état d'origine et toutes les barres d'outils sont visibles.
\end{notice}


\section{Légende de la carte}
\label{docs/user_manual/introduction/qgis_gui:map-legend}\label{docs/user_manual/introduction/qgis_gui:label-legend}
\index{legend}
La zone de légende cartographique liste l'ensemble des couches du projet. La case à cocher présente à gauche du nom d'une couche permet de l'afficher ou de la cacher.

\index{layer visibility}
Une couche peut être sélectionnée et glissée vers le haut ou le bas dans la légende pour modifier l'ordre d'empilement des couches. Une couche se situant au sommet de la liste de cette légende sera affichée au-dessus de celles qui se situent plus bas dans la liste.

Les couches peuvent être organisées en groupe. Il y a deux manières de procéder :
\begin{enumerate}
\item {} 
Faites un clic droit dans la légende puis choisissez \emph{Ajouter un nouveau groupe}. Donnez un nom au groupe et appuyez sur \code{Entrée}. Le nouveau groupe apparaît et vous pouvez maintenant glisser et déposer les couches sur l'icône de ce groupe.

\item {} 
Sélectionnez des couches, faites un clic droit dans la légende et choisissez  \emph{Grouper la sélection}. Les couches sélectionnées seront automatiquement placées dans un nouveau groupe.

\end{enumerate}

Pour retirer une couche d'un groupe, il suffit de pointer votre curseur sur elle, de la glisser-déposer en dehors ou de faire un clic droit et de choisir  \emph{Mettre l'objet au-dessus}. Un groupe peut contenir d'autres groupes.

La case à cocher d'un groupe permet d'afficher ou de cacher toutes les couches du groupe en un seul clic.

Le contenu du menu contextuel affiché par un clic droit varie si la couche sélectionnée est de type raster ou vecteur. Pour les couches vectorielles GRASS \includegraphics[width=1.5em]{mActionToggleEditing.png} $^{\text{Basculer en mode édition}}$ n'est pas disponible. Veuillez lire la section {\hyperref[docs/user_manual/grass_integration/grass_integration:grass-digitizing]{\emph{Numérisation et édition de couche vectorielle GRASS}}} pour plus d'informations sur l'édition de couches vectorielles GRASS.

\textbf{Menu clic droit pour les couches de type raster}
\begin{itemize}
\item {} 
\emph{Zoomer sur l'emprise de la couche}

\item {} 
\emph{Zoomer à la meilleure échelle (100 \%)}

\item {} 
\emph{Montrer dans l'aperçu}

\item {} 
\emph{Supprimer}

\item {} 
\emph{Définir le SCR de la couche}

\item {} 
\emph{Définir le SCR du projet depuis cette couche}

\item {} 
\emph{Propriétés...}

\item {} 
\emph{Renommer}

\item {} 
\emph{Copier le style}

\item {} 
\emph{Ajouter un nouveau groupe}

\item {} 
\emph{Étendre tout}

\item {} 
\emph{Réduire tout}

\item {} 
\emph{Mettre à jour l'ordre de rendu}

\end{itemize}

En plus, selon la position et les couches sélectionnées
\begin{itemize}
\item {} 
\emph{Mettre l'objet au dessus}

\item {} 
\emph{Grouper la sélection}

\end{itemize}



\textbf{Menu clic droit pour les couches de type vecteur}
\begin{itemize}
\item {} 
\emph{Zoomer sur l'emprise de la couche}

\item {} 
\emph{Montrer dans l'aperçu}

\item {} 
\emph{Supprimer}

\item {} 
\emph{Définir le SCR de la couche}

\item {} 
\emph{Définir le SCR du projet depuis cette couche}

\item {} 
\emph{Ouvrir la table d'attributs}

\item {} 
\emph{Basculer en mode édition (non disponible pour les couches GRASS)}

\item {} 
\emph{Sauvegarder sous...}

\item {} 
\emph{Sauvegarder la sélection sous...}

\item {} 
\emph{Requête...}

\item {} 
\emph{Montrer le décompte des entités}

\item {} 
\emph{Propriétés...}

\item {} 
\emph{Renommer}

\item {} 
\emph{Copier le style}

\item {} 
\emph{Ajouter un nouveau groupe}

\item {} 
\emph{Étendre tout}

\item {} 
\emph{Réduire tout}

\item {} 
\emph{Mettre à jour l'ordre de rendu}

\end{itemize}

En plus, selon la position et les couches sélectionnées
\begin{itemize}
\item {} 
\emph{Mettre l'objet au dessus}

\item {} 
\emph{Grouper la sélection}

\end{itemize}



\textbf{Menu clic droit pour les groupes}
\begin{itemize}
\item {} 
\emph{Zoom sur le groupe}

\item {} 
\emph{Supprimer}

\item {} 
\emph{Définir le SCR du groupe}

\item {} 
\emph{Renommer}

\item {} 
\emph{Ajouter un nouveau groupe}

\item {} 
\emph{Étendre tout}

\item {} 
\emph{Réduire tout}

\item {} 
\emph{Mettre à jour l'ordre de rendu}

\end{itemize}

Il est possible de sélectionner plus d'une couche ou groupe à la fois en tenant appuyée la touche \code{Ctrl} pendant que vous sélectionnez les couches avec le bouton gauche de la souris. Vous pouvez alors déplacer en une fois toutes les couches sélectionnées dans un nouveau groupe.

Vous pouvez également supprimer plus d'une couche ou d'un groupe à la fois en les sélectionnant avec la touche \code{Ctrl} puis en tapant sur \code{Ctrl D}. Toutes les couches et les groupes sélectionnés seront supprimés de la légende.


\subsection{Travailler avec un ordre des couches dans la légende indépendant du rendu cartographique}
\label{docs/user_manual/introduction/qgis_gui:working-with-the-legend-independent-layer-order}
Depuis la version 1.8 de QGIS, une option permet de définir un ordre d'affichage des couches dans la légende indépendant de l'ordre de superposition sur la carte. Vous pouvez l'activer via le menu \emph{Vue \(\rightarrow\) Panneaux}. Vous déterminez ici l'ordre de superposition des couches dans la carte. De cette manière vous pouvez, par exemple, ordonner vos couches par ordre d'importance et gardez une superposition correcte sur la carte (voir {\hyperref[docs/user_manual/introduction/qgis_gui:figure-layer-order]{figure\_layer\_order}}). Cocher la case \includegraphics{checkbox.png} \emph{Contrôle de l'ordre de rendu des couches} sous la liste des couches permet de revenir au comportement initial.
\phantomsection\label{docs/user_manual/introduction/qgis_gui:figure-layer-order}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{layer_order.png}
\caption{Define a legend independent layer order \includegraphics[width=1em]{nix.png}}\end{figure}


\section{Affichage de la carte}
\label{docs/user_manual/introduction/qgis_gui:map-view}\label{docs/user_manual/introduction/qgis_gui:label-mapview}
C'est la partie centrale de QGIS puisque les cartes y sont affichées ! Le contenu qui s'affiche dépend des couches de types raster et vecteur que vous avez choisies de charger (lire les sections suivantes pour plus d'informations sur comment charger une couche). L'emprise de la carte peut être modifiée en portant le focus sur une autre région, ou en zoomant en avant ou en arrière. Plusieurs opérations peuvent être effectuées sur la carte comme il est expliqué dans les descriptions des barres d'outils. La carte et la légende sont étroitement liées - la carte reflète les changements que vous opérez dans la légende.

\index{zoom mouse wheel}
\begin{notice}{tip}{Astuce:}
\textbf{Zoomer sur la carte avec la molette de la souris}

Vous pouvez utiliser la molette de la souris pour changer le niveau de zoom de la carte. Placez votre curseur dans la zone d'affichage de la carte et faites rouler la molette vers l'avant pour augmenter l'échelle, vers vous pour la réduire. La position du curseur permet de recentrer la vue lors du changement d'échelle. Vous pouvez modifier le comportement de la molette de la souris en utilisant l'onglet \emph{Outils cartographiques} dans le menu \emph{Préférences \(\rightarrow\) Options}.
\end{notice}

\begin{notice}{tip}{Astuce:}
\textbf{Se déplacer sur la carte avec les flèches et la barre espace}

\index{pan arrow keys}
Vous pouvez utiliser les flèches du clavier pour vous déplacer sur la carte. Placez le curseur sur la carte et appuyez sur la flèche droite pour décaler la vue vers l'Est, la flèche gauche pour la décaler vers l'Ouest, la flèche supérieure vers le Nord et la flèche inférieure vers le Sud. Vous pouvez aussi déplacer la carte en gardant la touche espace appuyée et en bougeant la souris.
\end{notice}
\phantomsection\label{docs/user_manual/introduction/qgis_gui:label-mapoverview}

\section{Barre d'état}
\label{docs/user_manual/introduction/qgis_gui:label-statusbar}\label{docs/user_manual/introduction/qgis_gui:status-bar}
La barre d'état montre votre position dans le système de coordonnées de la carte (coordonnées exprimées en mètres ou degrés décimaux par exemple) lorsque vous déplacez votre curseur. À gauche de l'affichage des coordonnées se trouve un petit bouton qui bascule l'affichage entre celui des coordonnées de la position ou celui de l'étendue de la zone que vous visualisez.

À droite de ces coordonnées se trouve l'échelle de la carte. Si vous zoomez ou dézoomez, l'échelle se met à jour automatiquement. Depuis la version 1.8 de QGIS, une liste déroulante vous permet de choisir une échelle prédéterminée allant du 1:500ème au 1:1000000ème.

Une barre de progression dans la barre de statut vous montre la progression du rendu au fur et à mesure que les couches sont dessinées sur l'écran. Dans certains cas, tel que lors du calcul des statistiques d'une couche raster, la barre indique la progression des opérations plus longues.

Si une nouvelle extension ou une mise à jour est disponible, vous verrez un message dans la barre d'état. Sur la droite, une case à cocher peut être utilisée pour bloquer temporairement le rendu des couches sur la carte (voir section {\hyperref[docs/user_manual/introduction/general_tools:redraw-events]{\emph{Rendu}}}). L'icône \includegraphics[width=1.5em]{mIconStopRendering.png} permet de stopper immédiatement le rendu cartographique.

À l'extrémité droite se situe le code EPSG du SCR du projet et l'icône de projection. Un clic dessus ouvrira la fenêtre de propriétés de projection pour le projet en cours.

\begin{notice}{tip}{Astuce:}
\textbf{Calculer l'échelle correcte de la carte}

\index{scale calculate}
Quand vous démarrez QGIS, le degré décimal est l'unité par défaut. QGIS exprime les coordonnées de vos couches dans cette unité. Pour avoir les valeurs correctes d'échelle, vous pouvez soit changer l'unité manuellement avec l'onglet \emph{Général} sous le menu \emph{Préférences \(\rightarrow\) Propriétés du projet...}, soit sélectionner un système de projection de référence en cliquant sur l'icône \includegraphics[width=1.5em]{mIconProjectionDisabled.png} $^{\text{Status de la projection}}$ en bas à droite de la barre d'état. Dans ce dernier cas, les unités sont automatiquement choisies selon les spécifications de la projection, par exemple `+units=m'.
\end{notice}


\chapter{Outils globaux}
\label{docs/user_manual/introduction/general_tools::doc}\label{docs/user_manual/introduction/general_tools:general-tools}

\section{Raccourcis clavier}
\label{docs/user_manual/introduction/general_tools:shortcuts}\label{docs/user_manual/introduction/general_tools:keyboard-shortcuts}
\index{Raccourcis clavier}
QGIS fournit des raccourcis claviers par défaut pour de nombreuses fonctionnalités. Vous les trouverez dans la section {\hyperref[docs/user_manual/introduction/qgis_gui:label-menubar]{\emph{Barre de Menu}}}. Le sous-menu  \emph{Préférences \(\rightarrow\) Configurer les raccourcis...} permet de personnaliser ces raccourcis clavier et d'en définir pour les autres fonctionnalités de QGIS listées.
\phantomsection\label{docs/user_manual/introduction/general_tools:figure-shortcuts}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{shortcuts.png}
\caption{Define shortcut options \includegraphics[width=1em]{nix.png} (KDE)}\end{figure}

La configuration est très simple. Sélectionnez une action dans la liste et cliquez sur le bouton \textbf{{[}Changement{]}}, \textbf{{[}Ne rien mettre{]}} ou \textbf{{[}Définir par défaut{]}}. Lorsque vous êtes satisfait de votre configuration, vous pouvez la sauver dans un fichier XML en vue de charger ce dernier dans un autre environnement d'exécution de QGIS (sur un autre ordinateur par exemple).


\section{Aide contextuelle}
\label{docs/user_manual/introduction/general_tools:context-help}\label{docs/user_manual/introduction/general_tools:id1}
\index{Aide contextuelle}
Lorsque le besoin d'aide se fait sentir sur un sujet spécifique, vous pouvez accéder à l'aide contextuelle via le bouton \emph{Aide} disponible dans la plupart des fenêtres de dialogue - notez que les extensions additionnelles peuvent pointer vers des pages web dédiées.


\section{Rendu}
\label{docs/user_manual/introduction/general_tools:rendering}\label{docs/user_manual/introduction/general_tools:redraw-events}
\index{Rendu}
Par défaut, QGIS effectue le rendu de toutes les couches visibles à chaque fois que l'affichage de la carte a besoin d'être mis à jour. Les évènements qui déclenchent ce rafraîchissement incluent :
\begin{itemize}
\item {} 
l'ajout d'une couche

\item {} 
le déplacement ou le zoom

\item {} 
le redimensionnement de la fenêtre de QGIS

\item {} 
la modification de la visibilité d'une ou plusieurs couches

\end{itemize}

QGIS vous laisse contrôler le processus de rendu de plusieurs manières.


\subsection{Rendu dépendant de l'échelle}
\label{docs/user_manual/introduction/general_tools:scale-dependent-rendering}
\index{Rendering scale dependent}
Le rendu dépendant de l'échelle permet de spécifier les échelles minimale et maximale auxquelles la couche doit être visible. Pour définir une échelle de rendu, ouvrez la fenêtre de \emph{Propriétés} en double-cliquant sur une couche dans la légende et dans l'onglet \emph{Général}, saisissez les valeurs voulues puis cochez la case \includegraphics{checkbox.png}\emph{Utiliser le rendu dépendant de la mise à l'échelle}.

Vous pouvez déterminer les valeurs d'échelle en zoomant au niveau que vous voulez utiliser et en notant les valeurs de la barre d'état.

\index{Scale}

\subsection{Contrôler le rendu}
\label{docs/user_manual/introduction/general_tools:index-4}\label{docs/user_manual/introduction/general_tools:controlling-map-rendering}\label{docs/user_manual/introduction/general_tools:label-controlmap}
Le rendu de la carte peut être contrôlé de différentes manières :


\subsubsection{Suspendre le rendu}
\label{docs/user_manual/introduction/general_tools:label-suspendrender}\label{docs/user_manual/introduction/general_tools:suspending-rendering}
Pour suspendre le rendu, cliquez sur la case \includegraphics{checkbox.png} \emph{Rendu} dans le coin inférieur droit de la barre de statut. Quand cette case n'est pas cochée, QGIS ne redessine pas la carte en réponse aux évènements décrits dans la section {\hyperref[docs/user_manual/introduction/general_tools:redraw-events]{\emph{Rendu}}}. Voici quelques cas pour lesquels vous pourriez souhaiter ce comportement :
\begin{itemize}
\item {} 
l'ajout d'un nombre important de couches et la définition de leur sémiologie avant de les afficher,

\item {} 
l'ajout d'une ou plusieurs couches lourdes et le choix d'un rendu dépendant de l'échelle avant leur affichage,

\item {} 
l'ajout d'une ou plusieurs couches lourdes et le zoom sur un endroit spécifique avant l'affichage,

\item {} 
n'importe quelle combinaison des éléments précédents.

\end{itemize}

Cocher la case \includegraphics{checkbox.png} \emph{Rendu} activera de nouveau le rendu et provoquera un rafraîchissement immédiat de la carte.


\subsubsection{Définir les options d'ajout de couche}
\label{docs/user_manual/introduction/general_tools:setting-layer-add-option}\label{docs/user_manual/introduction/general_tools:label-settinglayer}
Il est possible de définir une option qui chargera toutes les nouvelles couches sans les dessiner, elles seront ajoutées à la carte, mais la case de visibilité sera décochée par défaut. Pour définir cette option, sélectionnez l'option \emph{Préférences \(\rightarrow\) Options \(\rightarrow\)} et cliquez sur l'onglet \emph{Rendu}. Décochez la case \includegraphics{checkbox.png} \emph{Par défaut les couches supplémentaires sont affichées}. Les nouvelles couches ajoutées à la carte seront invisibles par défaut.


\subsubsection{Arrêter le rendu}
\label{docs/user_manual/introduction/general_tools:stopping-rendering}
\index{Rendering halting}\phantomsection\label{docs/user_manual/introduction/general_tools:label-stoprender}
Pour arrêter le rendu de la carte, appuyez sur la touche \code{ESC}. Ceci stoppera le rafraîchissement de la vue de la carte et laissera la carte partiellement dessinée. Il est possible qu'il y ait un délai entre le moment où la touche est pressée et le moment où le rendu de la carte est effectivement arrêté.

\begin{notice}{note}{Note:}
Il n'est actuellement pas possible d'arrêter le rendu de cette manière - cette fonctionnalité a été désactivée lors du port vers qt4 du fait d'instabilités.
\end{notice}


\subsubsection{Mettre à jour l'affichage de la carte pendant le rendu de l'affichage}
\label{docs/user_manual/introduction/general_tools:updating-the-map-display-during-rendering}\label{docs/user_manual/introduction/general_tools:label-updatemap}
\index{rendering update during drawing}
Vous pouvez définir une option pour mettre à jour l'affichage de la carte quand des entités sont dessinées. Par défaut, QGIS n'affiche pas les entités d'une couche tant que la couche n'a pas été rendue entièrement. Pour mettre à jour l'affichage à mesure que les entités sont lues dans la table attributaire, sélectionnez le menu \emph{Préférences \(\rightarrow\) Options} puis l'onglet \emph{Rendu}. Mettez comme valeur le nombre d'entités à mettre à jour durant le rendu. Si elle est égale à 0, cela désactive la mise à jour durant le dessin (c'est la valeur par défaut). Une valeur trop basse risque d'impacter les performances, car la vue de la carte sera constamment mise à jour durant la lecture des entités. Il est suggéré de commencer à 500.


\subsubsection{Influencer la qualité du rendu}
\label{docs/user_manual/introduction/general_tools:label-renderquality}\label{docs/user_manual/introduction/general_tools:influence-rendering-quality}
\index{rendering quality}
Pour influencer la qualité du rendu de la carte vous avez deux possibilités. Dans le menu \emph{Préférences \(\rightarrow\) Options} puis l'onglet \emph{Rendu} et sélectionnez ou désélectionnez les cases suivantes :
\begin{itemize}
\item {} 
\includegraphics{checkbox.png} \emph{Les lignes semblent moins déchiquetées aux dépens d'une certaine vitesse d'exécution}

\item {} 
\includegraphics{checkbox.png} \emph{Corriger les polygones remplis de manière erronée}

\end{itemize}


\section{Mesurer}
\label{docs/user_manual/introduction/general_tools:measuring}\label{docs/user_manual/introduction/general_tools:sec-measure}
\index{measure}
Les mesures fonctionnent uniquement au sein des systèmes de coordonnées projetées (par exemple : UTM, Lambert 93) et pour les données sans système de coordonnées. Si la couche active est définie par un système de coordonnées géographiques (latitude/longitude), les résultats d'une mesure de ligne ou d'aires seront incorrects. Pour y remédier, vous devez spécifier un système de coordonnées plus approprié (voir Section {\hyperref[docs/user_manual/working_with_projections/working_with_projections:label-projections]{\emph{Utiliser les projections}}}). Les outils de mesure utilisent les paramètres d'accrochage de l'outil de numérisation. C'est utile pour mesurer des distances et des aires pour des couches vectorielles.

Pour sélectionner un outil de mesure, cliquez sur \includegraphics[width=1.5em]{mActionMeasure.png} puis sur l'outil voulu.


\subsection{Mesurer des longueurs, des aires et des angles}
\label{docs/user_manual/introduction/general_tools:measure-length-areas-and-angles}
\index{measure!line length}
\index{measure!areas}
\index{measure!angles}
\includegraphics[width=1.5em]{mActionMeasure.png} QGIS peut mesurer des distances réelles entre plusieurs points selon un ellipsoïde défini. Pour le configurer, allez dans le menu \emph{Préférences \(\rightarrow\) Options} puis dans l'onglet \emph{Outils cartographiques} et choisissez l'ellipsoïde approprié. Vous pouvez également modifier ici la couleur du trait, l'unité de mesure (mètre ou pied) et l'unité d'angle (degrés, radian ou gon). Cet outil permet de placer des points sur la carte. La longueur de chaque segment s'affiche dans la fenêtre de mesure ainsi que la longueur cumulée totale. Pour stopper les mesures, faites un clic droit.
\phantomsection\label{docs/user_manual/introduction/general_tools:figure-measure-length}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=15em]{measure_line.png}
\caption{Measure Distance \includegraphics[width=1em]{nix.png} (KDE)}\end{figure}

\includegraphics[width=1.5em]{mActionMeasureArea.png} Les aires peuvent aussi être mesurées. Dans la fenêtre de mesure apparaît la surface totale mesurée. En complément, l'outil de mesure s'accrochera à la couche sélectionnée à partir du moment où celle-ci à un seuil d'accrochage défini (voir la section {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:snapping-tolerance]{\emph{Définir le rayon de tolérance d'accrochage et de recherche}}}). Donc si vous voulez mesurer avec exactitude une ligne ou le contour d'un polygone, spécifiez d'abord un seuil d'accrochage puis sélectionnez la couche. Avec l'outil de mesure, chaque clic de souris se situant dans ce seuil s'accrochera aux entités de cette couche.
\phantomsection\label{docs/user_manual/introduction/general_tools:figure-measure-area}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=15em]{measure_area.png}
\caption{Measure Area \includegraphics[width=1em]{nix.png} (KDE)}\end{figure}

\includegraphics[width=1.5em]{mActionMeasureAngle.png} Vous pouvez aussi mesurer des angles en sélectionnant l'outil de mesure d'angles. Le curseur adopte une forme en croix. Cliquez pour dessiner le premier côté de l'angle à mesurer puis bougez le curseur pour dessiner l'angle désiré. La mesure est affichée dans une fenêtre de dialogue.
\phantomsection\label{docs/user_manual/introduction/general_tools:figure-measure-angle}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=15em]{measure_angle.png}
\caption{Measure Angle \includegraphics[width=1em]{nix.png} (KDE)}\end{figure}


\subsection{Sélectionner et désélectionner des entités}
\label{docs/user_manual/introduction/general_tools:select-and-deselect-features}\label{docs/user_manual/introduction/general_tools:sec-selection}
La barre d'outils fournit plusieurs outils de sélection d'entités à partir du canevas de la carte. Pour sélectionner une ou plusieurs entités, cliquez sur \includegraphics[width=1.5em]{mActionSelect.png} et choisissez l'outil :
\begin{itemize}
\item {} 
\includegraphics[width=1.5em]{mActionSelect.png} $^{\text{Sélection d'entités}}$

\item {} 
\includegraphics[width=1.5em]{mActionSelectRectangle.png} $^{\text{Sélection d'entités avec un rectangle}}$

\item {} 
\includegraphics[width=1.5em]{mActionSelectPolygon.png} $^{\text{Sélection d'entités avec un polygone}}$

\item {} 
\includegraphics[width=1.5em]{mActionSelectFreehand.png} $^{\text{Sélection d'entités à main levée}}$

\item {} 
\includegraphics[width=1.5em]{mActionSelectRadius.png} $^{\text{Sélection d'entités selon un rayon}}$

\end{itemize}

Pour désélectionner toutes les entités, cliquez sur \includegraphics[width=1.5em]{mActionDeselectAll.png} $^{\text{Désélectionner toutes les entités}}$.


\section{Décorations}
\label{docs/user_manual/introduction/general_tools:id2}\label{docs/user_manual/introduction/general_tools:decorations}
Les éléments de décorations dans QGIS incluent l'etiquette de Copyright, la flèche du nord et la barre d'échelle. Ils s'utilisent pour ``décorer'' la carte.

\begin{notice}{note}{Note:}
Avant la version 1.8 de QGIS, ils étaient accessibles via l'extension Décoration.
\end{notice}


\subsection{Étiquette de Copyright}
\label{docs/user_manual/introduction/general_tools:copyright-label}
\includegraphics[width=1.5em]{copyright_label.png} \emph{Étiquette de Copyright} ajoute une zone de texte permettant de spécifier le Copyright de la carte.
\phantomsection\label{docs/user_manual/introduction/general_tools:figure-decorations-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=15em]{copyright.png}
\caption{The copyright Dialog \includegraphics[width=1em]{nix.png}}\end{figure}
\begin{enumerate}
\item {} 
Sélectionnez via le menu \emph{Vue \(\rightarrow\) Décorations \(\rightarrow\) Étiquette de Copyright}. La fenêtre s'affiche (voir {\hyperref[docs/user_manual/introduction/general_tools:figure-decorations-1]{figure\_decorations\_1}}).

\item {} 
Entrez le texte que vous souhaitez afficher sur la carte. Vous pouvez utiliser du code HTML comme le montre l'exemple

\item {} 
Choisissez l'emplacement de l'étiquette grâce à la liste déroulante \emph{Position}

\item {} 
Assurez-vous que la case \includegraphics{checkbox.png} \emph{Activez l'étiquette des droits d'auteur} est cochée

\item {} 
CLiquez sur \textbf{{[}OK{]}}

\end{enumerate}

Dans l'exemple ci-dessus (proposé par défaut), QGIS place un symbole de copyrigth suivi de la date dans le coin inférieur droit de la carte.


\subsection{Flèche du nord}
\label{docs/user_manual/introduction/general_tools:north-arrow}
\includegraphics[width=1.5em]{north_arrow.png} \emph{Flèche du nord} place une simple flèche sur la carte. Pour le moment seul un style de flèche est disponible. Vous pouvez modifier l'angle de la flèche ou laisser QGis définir la direction automatiquement. SI vous choisissez cette dernière option, QGIS fait au mieux. Quatre options sont disponibles concernant l'emplacement, correspondant aux quatre coins de la carte.
\phantomsection\label{docs/user_manual/introduction/general_tools:figure-decorations-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{north_arrow_dialog.png}
\caption{The North Arrow Dialog \includegraphics[width=1em]{nix.png}}\end{figure}


\subsection{Échelle graphique}
\label{docs/user_manual/introduction/general_tools:scale-bar}
\includegraphics[width=2.5em]{scale_bar.png} \emph{Échelle graphique} ajoute une simple barre d'échelle sur la carte. Vous choisissez le style, l'emplacement ainsi que les étiquettes de la barre.
\phantomsection\label{docs/user_manual/introduction/general_tools:figure-decorations-3}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{scale_bar_dialog.png}
\caption{The Scale Bar Dialog \includegraphics[width=1em]{nix.png}}\end{figure}

QGIS permet uniquement d'afficher l'échelle dans la même unité que celle de la carte. Donc, si l'unité est le mètre, vous ne pouvez créer une échelle en pieds. De la même manière, si vous utilisez les degrés décimaux, vous ne pouvez afficher une échelle en mètres.

Pour ajouter une échelle graphique :
\begin{enumerate}
\item {} 
Sélectionnez le menu \emph{Vue \(\rightarrow\) Décorations \(\rightarrow\) Échelle graphique}. Une fenêtre s'affiche (voir {\hyperref[docs/user_manual/introduction/general_tools:figure-decorations-3]{figure\_decorations\_3}})

\item {} 
Choisissez un emplacement grâce à la liste déroulante \emph{Emplacement}

\item {} 
Choisissez le style via la liste déroulante \emph{Style de la barre d'échelle}

\item {} 
Sélectionnez la couleur via la liste déroulante \emph{Couleur de la barre} ou laissez le noir définit par défaut

\item {} 
Définissez la taille via la liste \emph{Taille de la barre}

\item {} 
Assurez-vous que la case \includegraphics{checkbox.png} \emph{Activer l'échelle graphique} est cochée

\item {} 
En option vous pouvez choisir d'arrondir à l'entier le plus proche lors d'un changement de zoom avec \includegraphics{checkbox.png} \emph{Arrondir automatiquement lors du changement de zoom}

\item {} 
CLiquez sur \textbf{{[}OK{]}}

\end{enumerate}

\begin{notice}{tip}{Astuce:}
\textbf{Paramètre des décorations}

Lorsque vous sauvegardez un projet QGIS, toutes modifications faites sur la flèche du nord, l'échelle graphique et le copyrigth seront sauvées dans le fichier de projet et restaurées à la prochaine ouverture du projet.
\end{notice}
\phantomsection\label{docs/user_manual/introduction/general_tools:sec-annotations}
\index{annotation}

\section{Outils d'annotation}
\label{docs/user_manual/introduction/general_tools:annotation-tools}\label{docs/user_manual/introduction/general_tools:index-12}
L'outil \includegraphics[width=1.5em]{mActionTextAnnotation.png} \emph{Annotation de texte} de la barre d'outils d'attribut fournit la possibilité de placer du texte formaté dans des phylactères sur la carte. Sélectionnez l'outil d'annotation \emph{Annotation de texte} puis cliquez sur la carte.
\phantomsection\label{docs/user_manual/introduction/general_tools:annotation}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{annotation.png}
\caption{Annotation text dialog \includegraphics[width=1em]{nix.png}}\end{figure}

Un double clic dans l'emprise d'une annotation (matérialisée par quatre carrés aux angles) provoque l'ouverture d'une fenêtre de dialogue avec diverses options. Il y a un éditeur de texte avec quelques options (choix de la police de caractères, de la taille, de la graisse, etc.), le choix de la couleur de fond du cadre, ainsi que de la couleur et de l'épaisseur du contour. Il est également possible de choisir le marqueur. La position de ce dernier peut être soit fixe sur la carte soit relative à l'interface graphique et n'est pas impactée par la navigation dans la carte. La bulle peut être déplacée indépendamment du marqueur. Le déplacement du marqueur affecte l'ensemble de l'annotation.

L'outil \includegraphics[width=1.5em]{mActionAnnotation.png} \emph{Déplacer une annotation} permet de déplacer l'annotation sélectionnée sur la carte.


\subsection{Formulaire d'annotation}
\label{docs/user_manual/introduction/general_tools:form-annotations}
En outre, vous pouvez créer vos propres formulaires d'annotation. L'outil \includegraphics[width=1.5em]{mActionFormAnnotation.png} \emph{Formulaire d'annotation} est utile pour afficher les attributs d'une entité dans un formulaire qt personnalisé (voir {\hyperref[docs/user_manual/introduction/general_tools:figure-custom-annotation]{figure\_custom\_annotation}}). L'approche est similaire à la conception de formulaires pour l'outil \emph{Identifier les entités}, mais affiche les informations sous la forme d'une annotation. Pour un complément d'information, reportez-vous au blog \href{http://blog.qgis.org/node/143}{http://blog.qgis.org/node/143}.
\phantomsection\label{docs/user_manual/introduction/general_tools:figure-custom-annotation}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{custom_annotation.png}
\caption{Customized qt designer annotation form \includegraphics[width=1em]{nix.png}}\end{figure}

\begin{notice}{note}{Note:}
Si vous pressez les touches \code{Ctrl+T} alors que l'outil \emph{Annotation} est activé (déplacement d'annotation, annotation de texte ou formulaire d'annotation), les annotations sont automatiquement cachées ou, inversement, rendues visibles.
\end{notice}


\section{Signets spatiaux}
\label{docs/user_manual/introduction/general_tools:spatial-bookmarks}\label{docs/user_manual/introduction/general_tools:sec-bookmarks}
\index{bookmarks}
\index{spatial bookmarks!see bookmarks}
Les signets spatiaux vous permettent de marquer une zone de la carte pour y retourner plus tard.


\subsection{Créer un signet}
\label{docs/user_manual/introduction/general_tools:creating-a-bookmark}
Pour créer un signet :
\begin{enumerate}
\item {} 
Déplacez-vous sur la zone concernée.

\item {} 
Sélectionnez le menu \emph{Vue \(\rightarrow\) Nouveau signet...} ou appuyez sur les touches  \code{Ctrl-B}.

\item {} 
Entrez un nom pour décrire le signet (jusqu'à 255 caractères).

\item {} 
Appuyez sur \code{Entrée} pour ajouter le signet ou sur \textbf{{[}Annuler{]}} pour sortir de la fenêtre sans l'enregistrer.

\end{enumerate}

Notez que vous pouvez avoir plusieurs signets portant le même nom.


\subsection{Travailler avec les signets}
\label{docs/user_manual/introduction/general_tools:working-with-bookmarks}
Pour utiliser ou gérer les signets allez dans le menu \emph{Vue \(\rightarrow\) Montrer les signets}.
La fenêtre \emph{Signets géospatiaux} vous permet de rappeler ou d'effacer un signet. Vous ne pouvez pas modifier le nom d'un signet ou ses coordonnées.


\subsection{Zoomer sur un signet}
\label{docs/user_manual/introduction/general_tools:zooming-to-a-bookmark}
Depuis la fenêtre \emph{Signets géospatiaux}, sélectionnez le signet voulu en cliquant dessus puis sur le bouton \textbf{{[}Zoomer sur{]}}. Vous pouvez aussi zoomer en opérant un double-clic.


\subsection{Effacer un signet}
\label{docs/user_manual/introduction/general_tools:deleting-a-bookmark}
Pour effacer un signet depuis la fenêtre \emph{Signets géospatiaux}, cliquez dessus puis sur le bouton \textbf{{[}Effacer{]}}. Confirmez votre choix en cliquant sur \textbf{{[}Oui{]}} ou annuler en cliquant sur \textbf{{[}Non{]}}.


\section{Inclusion de projets}
\label{docs/user_manual/introduction/general_tools:nesting-projects}\label{docs/user_manual/introduction/general_tools:id3}
\index{nesting projects}
Si vous souhaitez inclure dans votre projet QGIS des couches ou des groupes de couches issus d'un autre projet, utilisez le menu \emph{Couches \(\rightarrow\) Intégrer des couches et des groupes}.


\subsection{Intégrer des couches}
\label{docs/user_manual/introduction/general_tools:embedding-layers}
La fenêtre suivante vous permet d'intégrer des couches provenant d'autres projets QGIS :
\begin{enumerate}
\item {} 
Cliquez sur \includegraphics{browsebutton.png} pour rechercher un autre projet dans le jeu de données Alaska.

\item {} 
Sélectionnez le fichier de projet grassland. Vous en visualisez le contenu (voir {\hyperref[docs/user_manual/introduction/general_tools:figure-embed-dialog]{figure\_embed\_dialog}}).

\item {} 
Maintenez la touche \code{Ctrl} appuyée et sélectionnez les couches grassland et regions. Ces couches peuvent maintenant être intégrées à la légende et à la carte.

\end{enumerate}
\phantomsection\label{docs/user_manual/introduction/general_tools:figure-embed-dialog}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{embed_dialog.png}
\caption{Select layers and groups to embed \includegraphics[width=1em]{nix.png}}\end{figure}

Bien que les couches intégrées oient éditables, vous ne pouvez pas en modifier le style et l'étiquetage.

\textbf{Supprimer des couches intégrées}

Faites un clic-droit sur la couche intégrée et sélectionnez \includegraphics[width=1.5em]{mActionRemoveLayer.png} \emph{Supprimer}.


\chapter{Configuration de QGIS}
\label{docs/user_manual/introduction/qgis_configuration:qgis-configuration}\label{docs/user_manual/introduction/qgis_configuration::doc}
QGIS se configure via le menu \emph{Préférences \(\rightarrow\)}. Les Panneaux, Barres d'outils, Propriétés du projet, Options et Personnalisation s'y configurent.


\section{Panneaux et barres d'outils}
\label{docs/user_manual/introduction/qgis_configuration:sec-panels-and-toolbars}\label{docs/user_manual/introduction/qgis_configuration:panels-and-toolbars}
Dans le menu \emph{Panneaux\(\rightarrow\)} vous pouvez afficher ou cacher les panneaux. De même pour les barres d'outils avec le menu \emph{Barres d'outils\(\rightarrow\)} (voir {\hyperref[docs/user_manual/introduction/qgis_configuration:figure-panels-toolbars]{figure\_panels\_toolbars}}).
\phantomsection\label{docs/user_manual/introduction/qgis_configuration:figure-panels-toolbars}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{panels_and_toolbars.png}
\caption{The Panels and Toolbars menu \includegraphics[width=1em]{nix.png}}\end{figure}

\index{Map overview}
\begin{notice}{tip}{Astuce:}
\textbf{Activer la fenêtre d'aperçu}

Dans QGIS, vous avez la possibilité de visualiser la totalité de l'étendue de couches en les ajoutant à l'aperçu. La fenêtre d'aperçu s'affiche via le menu \emph{Préférences \(\rightarrow\) Panneaux}. Au sein de cette fenêtre se situe un rectangle qui représente l'étendue de la carte, cela permet de savoir quelle région de la carte vous êtes en train de visualiser. Les étiquettes ne sont pas affichées dans l'aperçu même si les couches visibles ont l'étiquetage activé. Si vous cliquez et déplacez le rectangle rouge qui montre votre emprise actuelle, la vue principale se mettra à jour en conséquence.
\end{notice}

\begin{notice}{tip}{Astuce:}
\textbf{Voir le journal des  messages}

Depuis la version 1.8 de QGIS, il est possible de suivre les messages produits par QGIS. Activez cette fonctionnalité en cochant \includegraphics{checkbox.png}\emph{Journal des messages} dans le menu \emph{Préférences \(\rightarrow\) Panneaux} et suivez les mesages depuis les onglets \emph{Général} et \emph{Extensions}.
\end{notice}


\section{Propriétés du projet}
\label{docs/user_manual/introduction/qgis_configuration:project-properties}
Dans la fenêtre de propriétés du projet du menu \includegraphics[width=1em]{nix.png} \emph{Préférences \(\rightarrow\) Propriétés du projet} or \includegraphics[width=1em]{win.png} \emph{Préférences \(\rightarrow\) Propriétés du projet} vous pouvez définir les options spécifiques à un projet. Cela inclut :
\begin{itemize}
\item {} 
Dans l'onglet \emph{Général} se définissent le titre du projet, les couleurs de fond et de la sélection, les unités, la précision et la possibilité d'enregistrer des chemins relatifs vers les couches. Vous pouvez définir les unités des couches (uniquement lorsque la projection à la volée est désactivée) et la précision décimale à utiliser.

\item {} 
L'onglet \emph{Système de Coordonnées de Référence (SCR)} permet de choisir le système de coordonnées pour ce projet et d'activer la projection à la volée des couches raster et vectorielles définies dans un SCR différent.

\item {} 
Avec le troisième onglet \emph{Identification des couches}, vous pouvez activer (ou désactiver) les couches qui répondront à l'outil d'identification. (Voir le paragraphe sur les outils cartographiques dans la section {\hyperref[docs/user_manual/introduction/qgis_configuration:gui-options]{\emph{Options}}} pour autoriser l'identification de plusieurs couches.)

\item {} 
L'onglet \emph{Serveur OWS} permet de définir les informations concernant les capacités de  QGIS mapserver Service, les restrictions d'étendue et de SCR ainsi que les capacités WFS. Cocher la case \includegraphics{checkbox.png} \emph{Ajouter une géométrie WKT à la réponse de l'entité} permet kes requêtes sur les couches WMS.

\end{itemize}


\section{Options}
\label{docs/user_manual/introduction/qgis_configuration:options}\label{docs/user_manual/introduction/qgis_configuration:gui-options}
\includegraphics[width=1em]{mActionOptions.png} Quelques options basiques peuvent être sélectionnées dans la fenêtre \emph{Options} via le menu \emph{Préférences \(\rightarrow\)} \includegraphics[width=1em]{mActionOptions.png} \emph{Options}. Les onglets dans lesquels vous pouvez configurer les options sont :


\subsection{Onglet Général}
\label{docs/user_manual/introduction/qgis_configuration:general-tab}\begin{itemize}
\item {} 
\includegraphics{checkbox.png} \emph{Demander à sauvegarder si des changements ont été apportés au projet}

\item {} 
\includegraphics{checkbox.png} \emph{Avertir lors de l'ouverture d'un fichier projet sauvegardé dans une version précédente de QGIS}

\item {} 
Modifier la couleur de la sélection et du fond de carte

\item {} 
Modifier le style de QGIS

\item {} 
Modifier le thème des icônes (à choisire entre `défaut', `classique' et `gis')

\item {} 
Modifier la taille des icônes de 16 à 32 pixel.

\item {} 
Modifier la taille du menu

\item {} 
Définir l'effet d'un double-clic dans la légende (à choisir entre `Ouvrir les propriétés de la couche' ou `Ouvrir la table attributaire').

\item {} 
\includegraphics{checkbox.png} \emph{Mettre les noms de couche en majuscule dans la légende}

\item {} 
\includegraphics{checkbox.png} \emph{Afficher les noms des attributs de classifications dans la légende}

\item {} 
\includegraphics{checkbox.png} \emph{Créer des icônes raster dans la légende}

\item {} 
\includegraphics{checkbox.png} \emph{Cacher l'écran de démarrage}

\item {} 
\includegraphics{checkbox.png} \emph{Montrer les astuces au démarrage}

\item {} 
\includegraphics{checkbox.png} \emph{Ouvrir les résultats identifiés dans une fenêtre intégrée (redémarrage de QGIS requis)}

\item {} 
\includegraphics{checkbox.png} \emph{Ouvrir les options d'accrochage dans une fenêtre intégrée (redémarrage de QGIS requis)}

\item {} 
\includegraphics{checkbox.png} \emph{Ouvrir la table d'attributs dans une fenêtre intégrée}

\item {} 
\includegraphics{checkbox.png} \emph{Ajouter des couches PostGIS avec un double-clic et sélectionner en mode étendu}

\item {} 
\includegraphics{checkbox.png} \emph{Intégrer les nouvelles couches au groupe sélectionné}

\item {} 
\includegraphics{checkbox.png} \emph{Copier la représentation WKT de la géométrie depuis la table attributaire}

\item {} 
\emph{Comportement de la table d'attributs} (à choisir entre `Montrer toutes les entités' (comportement par défaut), `Ne montrer que les entités sélectionnées', `Ne montrer que les entités présentes sur la carte')

\item {} 
\emph{Cache de la table attributaire}

\item {} 
Définir la \emph{Représentation des valeurs NULL}

\item {} 
\emph{Demander pour les sous-couches raster} \includegraphics{selectstring.png}. Certains formats raster supportent les sous-couches - appelées subdataset dans gdal. Par exemple dans les fichiers netcdf, s'il y a beaucoup de variables netcdf, gdal les voit chacune comme un subdataset. L'option permet de contrôler la manière de gérer les sous-couches lorsqu'un fichier de ce type est ouvert. Vous avez les choix suivants :
\begin{itemize}
\item {} 
`Toujours' : demande toujours (s'il existe des sous-couches)

\item {} 
`Si besoin' : demande si la couche n'a pas de bande mais des sous-couches

\item {} 
`Jamais' : ne demande jamais et ne chargera rien

\item {} 
`Tout charger' : ne demande jamais et charge toutes les sous-couches

\end{itemize}

\item {} 
\emph{Rechercher les fichiers valides dans l'explorateur} \includegraphics{selectstring.png}. L'option `Vérifier l'extension' a été conçue pour accélerer le chargement d'un répertoire qui peut être long si l'option `Vérifier le contenu du fichier' est activée et qu'il y a de nombreux fichiers (des dizaines ou des centaines).

\item {} 
\emph{Rechercher du contenu dans les fichiers compressés (*.zip)} \includegraphics{selectstring.png}. Cette option permet également d'accélérer le chargement d'un répertoire. Les choix suivants sont disponibles :
\begin{itemize}
\item {} 
Le `Scan basique' vérifie que l'extension est supportée par un des drivers.

\item {} 
Le `Scan complet' ouvre tous les fichiers et vérifie qu'ils sont valides.

\item {} 
`Laisser passer' désactive l'option et sera retiré de la prochaine version de QGIS.

\end{itemize}

\end{itemize}


\subsection{Onglet GDAL}
\label{docs/user_manual/introduction/qgis_configuration:gdal-tab}
GDAL est une bibliothèque de conversion de format pour les fichiers raster. Dans cet onglet vous pouvez défninir quel driver GDAL utiliser pour chaque format raster lorsque plusieurs drivers GDAL sont disponibles.


\subsection{Onglet Extensions}
\label{docs/user_manual/introduction/qgis_configuration:plugins-tab}\begin{itemize}
\item {} 
Ajouter des \emph{Chemin(s) vers des extensions C++ supplémentaires}.

\end{itemize}


\subsection{Onglet Rendu}
\label{docs/user_manual/introduction/qgis_configuration:rendering-tab}\begin{itemize}
\item {} 
\includegraphics{checkbox.png} \emph{Par défaut les couches supplémentaires sont affichées}

\item {} 
Définir le \emph{Nombre d'entités à dessiner avant d'actualiserl'affichage}.

\item {} 
\includegraphics{checkbox.png} \emph{Utiliser le cache du rendu si possible pour accélérer l'affichage}

\item {} 
\includegraphics{checkbox.png} \emph{Les lignes semblent moins déchiquetées aux dépends d'une certaine vitesse d'exécution}

\item {} 
\includegraphics{checkbox.png} \emph{Corriger les polygones remplis de manière erronée}

\item {} 
\includegraphics{checkbox.png} \emph{Utiliser la nouvelle génération de symbologie pour le rendu}

\item {} 
Définir les paramètres par défaut pour la visualisation des rasters : `Sélection des bandes RVB', \includegraphics{checkbox.png} \emph{Utiliser l'écart type}, et `Amélioration de contraste'

\item {} 
Ajouter/ supprimer des \emph{Chemin(s) vers les symboles SVG}

\end{itemize}

De plus vous pouvez définir si vous sauvegardez les chemins vers les symboles SVG en relatif ou absolu dans le menu \emph{Préférences \(\rightarrow\) Propriétés du projet...}, onglet \emph{Général}.


\subsection{Onglet Outils cartographiques}
\label{docs/user_manual/introduction/qgis_configuration:map-tools-tab}\begin{itemize}
\item {} 
Le paramètre \emph{Mode} détermine quelles couches seront prises en compte par l'outil d'identification. En choisissant `De haut en bas' ou `De haut en bas, s'arrêter au premier' à la place de `Couche sélectionnée', les attributs de toutes les couches identifiables (voir la section sur les propriétés du projet {\hyperref[docs/user_manual/introduction/getting_started:sec-projects]{\emph{Les projets}}} pour sélectionner les couches identifiables) seront affichés par l'outil d'identification.

\item {} 
\includegraphics{checkbox.png} \emph{Ouvrir le formulaire si une seule entité est identifiée}

\item {} 
Définir le \emph{Rayon de recherche pour identifier les entités et afficher les infobulles en pourcentage de la largueur de la carte}

\item {} 
Définir l'\emph{Ellipsoïde pour les calculs de distance}

\item {} 
Définir la \emph{Couleur du trait} des outils de mesure

\item {} 
Définir le \emph{Nombre de décimales}

\item {} 
\includegraphics{checkbox.png} \emph{Garder l'unité de base}

\item {} 
\includegraphics{radiobuttonon.png} \emph{Unités de mesure préférées (`Mètre' ou `Pied')}

\item {} 
\includegraphics{radiobuttonon.png} \emph{Unités d'angle préférées (`Degrés', `Radians' ou `Grades')}

\item {} 
Définir l'\emph{Action de la molette souris} \includegraphics{selectstring.png} (`Zoom', `Zoom et recentrage', `Zoom sur le curseur de la souris', `Rien')

\item {} 
Définir le \emph{Facteur de zoom} pour la molette de la souris

\end{itemize}


\subsection{Onglet Revêtement}
\label{docs/user_manual/introduction/qgis_configuration:overlays-tab}\begin{itemize}
\item {} 
Définir l'\emph{Algorithme de placement} \includegraphics{selectstring.png} pour les étiquettes, la symbologie et les diagrammes (à choisir entre `Point central' (par défaut), `Chaîne', `Chaîne Popmusic tabu', et `Chaîne Popmusic')

\end{itemize}


\subsection{Onglet Numérisation}
\label{docs/user_manual/introduction/qgis_configuration:digitizing-tab}\begin{itemize}
\item {} 
Définir les caractéristiques du traçé : \emph{Largueur de ligne} et \emph{Couleur de ligne}

\item {} 
Définir le \emph{Mode d'accrochage par défaut} \includegraphics{selectstring.png} (`Sur un sommet', `Sur un segment', `Sur un sommet et un segment')

\item {} 
Définir la \emph{Tolérance d'accrochage} dans les unités de la carte ou en pixels

\item {} 
Définir le \emph{Rayon de recherche pour l'édition des sommets} dans les unités de la carte ou en pixels

\item {} 
\includegraphics{checkbox.png} \emph{Montrer les symboles uniquement pour les entités sélectionnées}

\item {} 
Définir le \emph{Style de marqueur} \includegraphics{selectstring.png} (`Croix' (par défaut), `Cercle semi-transparent', ou `Aucun') et la \emph{Taille du marqueur}.

\item {} 
\includegraphics{checkbox.png} \emph{Supprimer les fenêtres d'avertissements lors de la création de chaque entité}

\item {} 
\includegraphics{checkbox.png} \emph{Réutiliser la dernière caleur attributaire saisie}

\item {} 
\emph{Valider les géométries}. L'édition de lignes ou de polygones complexes composés de nombreux sommets peut se révéler très lente au niveau du rendu. Ceci est dû à la procédure de validation définie par défaut dans QGIS. Pour accélérer le rendu il est possible de sélectionner la validation des géométries avec GEOS (à partir de la version 3.3 de GEOS) ou de désactiver la validation. La validation avec GEOS est beaucoup plus rapide mais seul le premier problème de géométrie rencontré sera reporté.

\end{itemize}

Les trois options suivantes se réfèrent à l'outil de \includegraphics[width=1.5em]{mActionOffsetCurve.png} $^{\text{Décalage X,Y}}$ : {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Numérisation avancée}}}. Elles permettent de modifier la forme du décalage de ligne. Elles sont issues de GEOS 3.3.
\begin{itemize}
\item {} 
\emph{Style de jointure pour le décalage de courbe}

\item {} 
\emph{Quadrantsegments for curve offset}

\item {} 
\emph{Limite de pointe pour le décalage de la courbe}

\end{itemize}


\subsection{Onglet SCR}
\label{docs/user_manual/introduction/qgis_configuration:crs-tab}
L'onglet SCR se divide en deux parties. La première permet de définir le SCR par défaut de tous nouveaux projets.
\begin{itemize}
\item {} 
Sélectionnez un SCR puis \emph{Toujours lancer ce SCR pour les nouveaux projets}.

\item {} 
\includegraphics{checkbox.png} \emph{Activer la reprojection `à la volée' par défaut}

\end{itemize}

La seconde partie permet de définir le comportement lorsqu'une nouvelle couche est créée ou qu'une couche sans SCR est chargée.
\begin{itemize}
\item {} 
\includegraphics{radiobuttonoff.png} \emph{Demander le SCR}

\item {} 
\includegraphics{radiobuttonoff.png} \emph{Utiliser le SCR du projet}

\item {} 
\includegraphics{radiobuttonoff.png} \emph{Utiliser le SCR par défaut affiché ci-dessous}

\end{itemize}


\subsection{Onglet Langue}
\label{docs/user_manual/introduction/qgis_configuration:locale-tab}\begin{itemize}
\item {} 
\includegraphics{checkbox.png} \emph{Forcer la nationalité du système}

\item {} 
Informations sur les paramètres de lieu du système

\end{itemize}


\subsection{Onglet Réseau}
\label{docs/user_manual/introduction/qgis_configuration:network-tab}\phantomsection\label{docs/user_manual/introduction/qgis_configuration:figure-network-tab}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{proxy-settings.png}
\caption{Proxy-settings in QGIS}\end{figure}
\begin{itemize}
\item {} 
\includegraphics{checkbox.png} \emph{Utiliser un proxy pour l'accès internet} et définir l'`Hôte', le `Port', l'`Utilisateur', et le `Mot de passe'.

\item {} 
Sélection du \emph{Type de proxy} \includegraphics{selectstring.png} selon vos besoins.
\begin{itemize}
\item {} 
\emph{Default Proxy} : le proxy est déterminé sur la base du proxy de l'application

\item {} 
\emph{Socks5Proxy} : proxy générique pour tout type de connexion. Supporte le TCP, UDP, binding à un port (connexions entrantes) et l'authentification.

\item {} 
\emph{HttpProxy} : implémenté avec la commande ``CONNECT'' , supporte uniquement les connexions TCP sortantes, supporte l'authentication.

\item {} 
\emph{HttpCachingProxy} : implémenté via les commandes HTTP normales, utile dans un contexte de requêtes HTTP

\item {} 
\emph{FtpCachingProxy} : implémenté avec un proxy FTP, utile uniquement en contexte de requêtes FTP

\end{itemize}

\item {} 
Définir les \emph{Paramètres du cache} (répertoire et taille)

\item {} 
Définir l'\emph{Adresse de recherche WMS}, par défaut : \code{http://geopole.org/wms/search?search=\textbackslash{}\%1\textbackslash{}\&type=rss}

\item {} 
Définir le \emph{Délai d'abandon pour les requêtes réseaux (ms)} - par défaut 60000

\end{itemize}

Des URL à exclure peuvent être ajoutées dans la zone de texte sous les paramètres de proxy (voir {\hyperref[docs/user_manual/introduction/qgis_configuration:figure-network-tab]{Figure\_Network\_Tab}}) en cliquant sur le bouton \textbf{{[}Ajouter{]}} puis en double-cliquant sur le champ immédiatement créé et en entrant l'URL à exclure. Le bouton \textbf{{[}Supprimer{]}} supprime l'entrée sélectionnée.

Si vous avez besoin d'informations plus détaillées sur les différents paramètres de proxy, référez-vous au manuel de la bibliothèque sous-jacente QT : \href{http://doc.trolltech.com/4.5/qnetworkproxy.html\#ProxyType-enum}{http://doc.trolltech.com/4.5/qnetworkproxy.html\#ProxyType-enum}.

\begin{notice}{tip}{Astuce:}
\textbf{Utiliser les proxy}

L'utilisation de proxy peut se révéler difficile. Il est utile de tester les types de proxy décrits ci-dessus et vérifier s'ils conviennent.
\end{notice}

Vous pouvez modifier les options selon vos besoins. Certaines modifications peuvent nécessiter un redémarrage de QGIS pour qu'elles soient effectives.
\begin{itemize}
\item {} 
\includegraphics[width=1em]{nix.png} les paramètres sont sauvegardés dans un fichier texte : \$HOME/.config/QuantumGIS/qgis.conf

\item {} 
\includegraphics[width=1em]{osx.png} vous retrouvez vos paramètres dans : \$HOME/Library/Preferences/org.qgis.qgis.plist

\item {} 
\includegraphics[width=1em]{win.png} les paramètres sont stokés dans la base de registre sous :

\end{itemize}

\begin{Verbatim}[commandchars=\\\{\}]
\PYGZbs{}HKEY\PYGZbs{}CURRENT\_USER\PYGZbs{}Software\PYGZbs{}QuantumGIS\PYGZbs{}qgis
\end{Verbatim}


\section{Personnalisation}
\label{docs/user_manual/introduction/qgis_configuration:sec-customization}\label{docs/user_manual/introduction/qgis_configuration:customization}
L'outil de personnalisation est une nouveauté de la version 1.8 de QGIS. Il vous permet d'activer et de désactiver presque tous les éléments de l'interface de QGIS. Ceci se révèle très utile lorsque vous avez installé de nombreuses extensions que vous n'utilisez pas et qui encombrent l'écran.
\phantomsection\label{docs/user_manual/introduction/qgis_configuration:figure-customization}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{customization.png}
\caption{The Customization dialog \includegraphics[width=1em]{nix.png}}\end{figure}

La fenêtre de personnalisation de QGIS est subdivisée en cinq groupes. Sous \includegraphics{checkbox.png} \emph{Docks} vous trouverez les fenêtres intégrées. Il s'agit des fenêtres qui peuvent être affichées au premier plan ou intégrées à la fenêtre principale de QGIS (voir également {\hyperref[docs/user_manual/introduction/qgis_configuration:sec-panels-and-toolbars]{sec\_panels\_and\_toolbars}}). Sous \includegraphics{checkbox.png} \emph{Menus} vous pouvez cacher les entrées de la barre de menu. Sous \includegraphics{checkbox.png} \emph{Barre d'état} les informations telles que les coordonnées peuvent être désactivées. Sous \includegraphics{checkbox.png} \emph{Barre d'outils} vous pouvez désactiver les icônes des barres d'outils et sous \includegraphics{checkbox.png} \emph{Widgets} certaines fenêtres ainsi que les boutons associés.

Avec \includegraphics[width=1.5em]{mActionSelect.png} \emph{Passer à la sélection d'objets depuis la fenêtre principale}, vous pouvez cliquer sur les éléments de QGIS que vous souhaitez cacher et trouver l'entrée correspondante dans la liste de Personnalisation (voir {\hyperref[docs/user_manual/introduction/qgis_configuration:figure-customization]{figure\_customization}}). Vous pouvez sauvegarder différents états de personnalisation adaptés à différents cas d'utilisation. Vous devez redémarrer QGIS pour que les modifications soient appliquées.


\chapter{Utiliser les projections}
\label{docs/user_manual/working_with_projections/working_with_projections::doc}\label{docs/user_manual/working_with_projections/working_with_projections:label-projections}\label{docs/user_manual/working_with_projections/working_with_projections:working-with-projections}
\index{Projections}\index{CRS}\index{Coordinate\_Reference\_System}
QGIS permet à l'utilisateur de définir un Système de Coordonnées de Référence  (SCR) par défaut et pour l'ensemble des projets, pour les couches démunies de SCR prédéfini. Il lui permet également de définir des systèmes de coordonnées  de référence personnalisés et autorise la projection à la volée de couches  vecteur et raster. Toutes ces fonctionnalités permettent à l'utilisateur d'afficher des couches avec différents SCR et de les superposer correctement.


\section{Aperçu de la gestion des projections}
\label{docs/user_manual/working_with_projections/working_with_projections:label-projoverview}\label{docs/user_manual/working_with_projections/working_with_projections:overview-of-projection-support}
QGIS gère approximativement 2 700 SCR connus. Les définitions pour chacun d'entre eux sont stockées dans une base de données SQLite qui est installée avec QGIS. Normalement vous n'avez pas besoin de manipuler cette  base de données directement. En fait, cela peut poser des problèmes de gestion de projections. Les SCR personnalisés y sont stockés dans une base de données utilisateur. Reportez-vous à la section {\hyperref[docs/user_manual/working_with_projections/working_with_projections:sec-custom-projections]{\emph{Système de Coordonnées de Référence personnalisé}}} pour avoir des informations sur la gestion de vos systèmes de coordonnées de référence personnalisées.

\index{EPSG}\index{IGNF}\index{European\_Petroleom\_Search\_Group}
\index{Institut\_Geographique\_National\_de\_France}
Les SCR disponibles dans QGIS sont basés sur ceux définis par l'EPSG et l'Institut National Géographique (IGNF) et sont en grande partie extraits des  tables spatiales de référence de GDAL. Les identifiants EPSG sont présents dans la base de données et peuvent être utilisés pour définir un SCR dans QGIS.

Dans le but d'utiliser la projection à la volée, vos données doivent contenir des informations sur leur système de coordonnées de référence sinon vous devrez définir un SCR global, par projet, ou bien par couche. Pour les couches PostGIS, QGIS utilise l'identifiant de référence spatiale qui a été défini quand la couche a été créée. Pour les données gérées par OGR, QGIS utilise un moyen spécifique au format pour définir le SCR. Dans le cas du shapefile, il s'agit d'un fichier contenant une spécification Well Known Text (WKT) (\index{WKT}WKT) de la projection. Le fichier de projection a le même nom que le fichier shape et une extension prj. Par exemple, un shapefile nommé \code{alaska.shp} aura un fichier de projection correspondant nommé \code{alaska.prj}.

Lorsque vous sélectionnez un nouveau SCR, les unités des couches utilisées seront automatiquement changées dans l'onglet  \emph{Général} de la fenêtre des \includegraphics[width=1em]{mActionOptions.png} \emph{Propriétés du projet} du menu \emph{Éditer} (Gnome, OSX) ou \emph{Préférences} (KDE, Windows).

\index{default\_CRS}

\section{Définir une projection}
\label{docs/user_manual/working_with_projections/working_with_projections:index-4}\label{docs/user_manual/working_with_projections/working_with_projections:specifying-a-projection}
QGIS assigne à chaque nouveau projet la projection globale définie par défaut. Par défaut il s'agit du EPSG:4326 - WGS 84 (\code{proj=longlat +ellps=WGS84 +datum=WGS84 +no\_defs}). Ce SCR par défaut peut être modifié via le bouton  \textbf{{[}Sélection...{]}} dans la première partie de l'onglet qui permet de définir le SCR par défaut pour les nouveaux projets, voir {\hyperref[docs/user_manual/working_with_projections/working_with_projections:figure-projection-1]{figure\_projection\_1}}. Ce choix est sauvegardé pour toutes les sessions QGIS suivantes.
\phantomsection\label{docs/user_manual/working_with_projections/working_with_projections:figure-projection-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{crsdialog.png}
\caption{CRS tab in the QGIS Options Dialog \includegraphics[width=1em]{osx.png}}\end{figure}

Lorsque vous utilisez des couches qui sont dépourvues de SCR, vous devez contrôler et définir le choix de la projection pour ces couches. Cela peut être réalisée globalement ou par projet dans l'onglet \emph{SCR} dans le menu \emph{Éditer \(\rightarrow\)} \includegraphics[width=1em]{mActionOptions.png} \emph{Options} (Gnome, OSX) ou \emph{Préférences \(\rightarrow\)} \includegraphics[width=1em]{mActionOptions.png} \emph{Options} (KDE, Windows).

Les options montrées sur {\hyperref[docs/user_manual/working_with_projections/working_with_projections:figure-projection-1]{figure\_projection\_1}} sont :
\begin{itemize}
\item {} 
\includegraphics{radiobuttonoff.png} \emph{Demander le SCR}

\item {} 
\includegraphics{radiobuttonoff.png} \emph{Utiliser le SCR du projet}

\item {} 
\includegraphics{radiobuttonoff.png} \emph{Utiliser le SCR par défaut affiché ci-dessous}

\end{itemize}

Si vous voulez définir le système de coordonnées de référence pour certaines couches sans information de projection, vous pouvez également faire cela dans l'onglet \emph{Général} de la fenêtre de propriétés des couches raster (voir {\hyperref[docs/user_manual/working_with_raster/raster_properties:label-generaltab]{\emph{Onglet Général}}}) ou vecteur  (voir {\hyperref[docs/user_manual/working_with_vector/vector_properties:vectorgeneraltab]{\emph{Onglet Général}}}). Si votre couche a déjà une projection définie, elle sera affichée comme indiqué dans la figure {\hyperref[docs/user_manual/working_with_vector/vector_properties:figure-vector-properties-1]{\emph{Vector Layer Properties Dialog }}} .

\begin{notice}{tip}{Astuce:}
\textbf{SCR depuis la légende de la carte}

Un clic-droit sur une couche dans la légende (Section {\hyperref[docs/user_manual/introduction/qgis_gui:label-legend]{\emph{Légende de la carte}}}) propose deux raccourcis concernant les SCR.  \emph{Définir le SCR de la couche} ouvre directement la fenêtre de sélection de SCR (voir {\hyperref[docs/user_manual/working_with_projections/working_with_projections:figure-projection-2]{figure\_projection\_2}}). \emph{Définir le SCR du projet depuis cette couche} applique le SCR de la couche au projet.
\end{notice}


\section{Définir la projection à la volée}
\label{docs/user_manual/working_with_projections/working_with_projections:define-on-the-fly-otf-reprojection}
QGIS gère la projection à la volée pour les rasters et les vecteurs. Par contre elle n'est pas activée par défaut. Pour utiliser la projection à la volée, vous devez cocher la case \includegraphics{checkbox.png} \emph{Activer la projection `à la volée'} dans l'onglet \emph{SCR} de la fenêtre de  \includegraphics[width=1.5em]{mActionProjectProperties.png} \emph{Propriétés du projet}.

Il y a trois manières de le faire :
\begin{enumerate}
\item {} 
Sélectionner \includegraphics[width=1em]{mActionOptions.png} \emph{Proriétés du projet} depuis le menu \emph{Éditer} (Gnome, OSX) ou \emph{Préférences} (KDE, Windows).

\item {} 
Cliquer sur l'icône \includegraphics{geographic.png} $^{\text{Statut de la projection}}$ depuis le coin inférieur droit de la barre d'état.

\item {} 
Choisir d'activer la projection à la volée par défaut en cochant la case \includegraphics{checkbox.png} \emph{Activer la reprojection `à la volée' par défaut} dans l'onglet \emph{SCR} de la fenêtre des \emph{Options}.

\end{enumerate}

Si vous avez déjà chargé une couche, et désirez activer la projection à la volée, la meilleure façon de faire est d'ouvrir l'onglet  \emph{Système de coordonnées de référence} de la fenêtre des  \emph{Propriétés du projet}, de sélectionner le SCR de la couche chargée, et de cocher la case \includegraphics{checkbox.png} \emph{Activer la projection à la volée}. L'icône \includegraphics{geographic.png} $^{\text{Statut de la projection}}$ ne sera plus grisé et toutes les couches chargées plus tard seront projetées à la volée dans le SCR défini qui apparait à gauche de l'icône.

\index{Proj4}\index{Proj4\_text}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{projectionDialog.png}
\caption{Projection Dialog \includegraphics[width=1em]{win.png}}\label{docs/user_manual/working_with_projections/working_with_projections:figure-projection-2}\end{figure}

L'onglet:guilabel:\emph{Système de Coordonnées de Référence} de la fenêtre de  \emph{Propriétés du projet} contient cinq composants importants comme indiqué sur la figure {\hyperref[docs/user_manual/working_with_projections/working_with_projections:figure-projection-2]{Figure\_projection\_2}} et décrit ci-dessous.
\begin{enumerate}
\item {} 
\textbf{Activer la projection à la volée} - cette case à cocher est utilisée pour activer ou désactiver la projection à la volée. Lorsqu'elle est décochée, chaque couche est dessinée en utilisant les coordonnées lues dans la source de données et les composants décrits ci-dessous sont inactifs. Lorsqu'elle est activée, les coordonnées de chaque couche sont projetées dans le système de coordonnées de référence défini pour la carte.

\item {} 
\textbf{Système de Coordonnées de Référence} - c'est une liste de tous les SCR gérés par QGIS, incluant les systèmes de coordonnées de référence géographiques, projetés et personnalisés. Pour utiliser un SCR, sélectionnez-le dans la liste en dépliant le noeud approprié et en choisissant le système de coordonnées. Le SCR actif est présélectionné.

\item {} 
\textbf{Texte Proj4} - c'est la chaîne, décrivant le SCR, qui est utilisée par le moteur de projection Proj4. Ce texte est en lecture seule et est fourni à titre informatif.

\item {} 
\textbf{Rechercher} - si vous connaissez le code EPSG, l'identifiant ou le nom d'un système de coordonnées de référence, vous pouvez utiliser la fonction rechercher pour le retrouver. Entrez le code EPSG, l'identifiant ou le nom à chercher.

\item {} 
\textbf{SCR utilisés récemment} - si vous utilisez certains SCR fréquemment dans vos travaux quotidiens, ils seront affichés dans la table dans la fenêtre de projection.

\end{enumerate}

\begin{notice}{tip}{Astuce:}
\textbf{Fenêtre Propriétés du projet}

Si vous ouvrez la fenêtre  \emph{Propriétés du projet} à partir du menu \emph{Éditer} (Gnome, OSX) ou \emph{Préférences} (KDE, Windows) , vous devez cliquer sur l'onglet \emph{Système de Coordonnées de Référence} pour voir les définitions des SCR.

Ouvrir la fenêtre à partir de l'icône \includegraphics{geographic.png} \emph{Statut de la projection} vous amènera directement dans l'onglet  \emph{Système de Coordonnées de Référence}.
\end{notice}


\section{Système de Coordonnées de Référence personnalisé}
\label{docs/user_manual/working_with_projections/working_with_projections:custom-coordinate-reference-system}\label{docs/user_manual/working_with_projections/working_with_projections:sec-custom-projections}
\index{Custom\_CRS}
Si QGIS ne fournit pas le système de coordonnées de référence dont vous avez besoin, vous pouvez en définir un. Pour cela, sélectionnez \includegraphics[width=1.5em]{mIconNew.png}\emph{Projection personnalisée} à partir du menu \emph{Éditer} (Gnome, OSX) ou \emph{Préférences} (KDE, Windows).  Les SCR personnalisés sont stockés dans votre base de données utilisateur de QGIS.  En plus de ceux-ci, cette base de données contient également vos signets spatiaux et autres données personnalisées.
\phantomsection\label{docs/user_manual/working_with_projections/working_with_projections:figure-projection-3}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{customProjectionDialog.png}
\caption{Custom CRS Dialog \includegraphics[width=1em]{nix.png}}\end{figure}

\index{Proj.4}
Définir un SCR personnalisé dans QGIS nécessite une bonne compréhension de la bibliothèque de projection Proj4. Pour commencer, référez vous aux Procédures de Projection Cartographique pour l'environnement UNIX - Un manuel d'utilisateur de Gerald I. Evenden, U.S. Geological Survey Open-File Report 90-284, 1990 (disponible sur : \href{ftp://ftp.remotesensing.org/proj/OF90-284.pdf}{ftp://ftp.remotesensing.org/proj/OF90-284.pdf}).

Ce manuel décrit l'utilisation de \code{proj.4} et les applications en lignes de commandes liées. Les paramètres cartographiques utilisés avec \code{proj.4} sont décrit dans le manuel utilisateur et sont les mêmes que ceux utilisés par QGIS.

La fenêtre \emph{Définir un système de coordonnées de référence personnalisé} nécessite seulement deux paramètres pour définir un  SCR personnalisé :
\begin{enumerate}
\item {} 
un nom descriptif et

\item {} 
les paramètres cartographiques au format PROJ.4.

\end{enumerate}

Pour créer un nouveau SCR, cliquez sur le bouton \includegraphics[width=1.5em]{mIconNew.png} $^{\text{Nouveau}}$ et entrez un nom descriptif et les paramètres du SCR. Après cela, vous pouvez  le sauvegarder en cliquant sur le bouton  \includegraphics[width=1.5em]{mActionFileSave.png} $^{\text{Sauvegarder}}$.

Remarquez que les \emph{Paramètres} doivent débuter par un  bloc \code{+proj=} pour représenter le nouveau système de coordonnées de référence.

Vous pouvez tester vos paramètres de SCR pour voir s'ils produisent des résultats valides en utilisant le bouton \textbf{{[}Calculer{]}} dans le bloc   \emph{Test}. Copiez vos paramètres de projection dans le champ \emph{Paramètres}, puis entrez des latitude et longitude connues en WGS 84 dans les champs \emph{Nord} et \emph{Est} respectivement. Cliquez sur le bouton \textbf{{[}Calculer{]}} et comparez les résultats avec les valeurs connues dans votre système de coordonnées de référence.

\index{Browse\_Maps}
\index{Import\_Maps}

\chapter{Explorateur QGIS}
\label{docs/user_manual/qgis_browser/qgis_browser:label-qgis-browser}\label{docs/user_manual/qgis_browser/qgis_browser::doc}\label{docs/user_manual/qgis_browser/qgis_browser:index-1}\label{docs/user_manual/qgis_browser/qgis_browser:qgis-browser}
L'explorateur QGIS est un nouveau panneau qui permet de parcourir facilement vos bases de données. Vous avez accès aux fichiers vecteur courants (par exemple ESRI Shapefile ou MapInfo), aux bases de données (par exemple PostGIS ou MSSQL Spatial) et aux connexions WMS/WFS. Vous pouvez également visualiser vos données GRASS (voir {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-grass]{\emph{Intégration du SIG GRASS}}} pour importer les données dans QGIS).
\phantomsection\label{docs/user_manual/qgis_browser/qgis_browser:figure-browser-standalone-metadata}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=35em]{browser_standalone_metadata.png}
\caption{Qgis browser as a standalone application to view metadata, preview and attributes \includegraphics[width=1em]{nix.png}}\end{figure}

Utilisez l'explorateur QGIS pour prévisualiser vos données. La fonction glisser-déposer permet d'ajouter facilement vos données à la carte et la légende.
\begin{enumerate}
\item {} 
Activez l'explorateur QGIS : clic-droit sur la barre d'outils puis clic sur \includegraphics{checkbox.png}\emph{Parcourir}.

\item {} 
Déplacer le panneau sous la légende.

\item {} 
Cliquez sur \emph{Parcourir}.

\item {} 
Parcourez vos bases de données et choisissez le répertoire des données qgis\_sample\_data.

\item {} 
Maintenez la touche \code{Shift} appuyée et cliquez sur airports.shp et alaska.shp.

\item {} 
Glissez puis déposez les fichiers dans la carte par un clic-gauche.

\item {} 
Par un clic-droit sur une des couches sélectionnez  \emph{Définir le SCR du projet depuis cette couche}. Pour plus d'informations référez-vous à  {\hyperref[docs/user_manual/working_with_projections/working_with_projections:label-projections]{\emph{Utiliser les projections}}}.

\item {} 
Cliquez sur \includegraphics[width=1.5em]{mActionZoomFullExtent.png} \emph{Zoom sur l'étendue} pour visualiser les couches dans leur intégralité.

\end{enumerate}

Il est également possible de lancer l'explorateur QGIS comme application indépendante.

\textbf{Lancer l'explorateur QGIS}
\begin{itemize}
\item {} 
\includegraphics[width=1em]{nix.png} Tapez ``qbrowser'' dans une console.

\item {} 
\includegraphics[width=1em]{win.png} Lancez l'explorateur QGIS depuis le menu Démarrer, un raccourci sur le bureau ou en double-cliquant sur un fichier de projet QGIS.

\item {} 
\includegraphics[width=1em]{osx.png} L'explorateur QGIS n'est pas encore disponible depuis votre répertoire Applications. Cependant il est facile de l'y rajouter. Dans Finder, utilisez \emph{Go \(\rightarrow\) Go to map...} et cherchez \code{/Applications/QGIS.app/Contents/MacOS/bin}. Utilisez la combinaison de touches  \code{option - command} et glissez  \textbf{qbrowser.app} par un clic-gauche de la souris dans le répertoire Applications. Un lien sera alors créé pour lancer l'explorateur QGIS.

\end{itemize}

Vous pouvez voir sur {\hyperref[docs/user_manual/qgis_browser/qgis_browser:figure-browser-standalone-metadata]{figure\_browser\_standalone\_metadata}} les fonctionnalités avancées de l'explorateur QGIS. L'onglet  \emph{Paramètres} fournit les détails des connexions aux bases de données telles que PostGIS ou MSSQL Spatial. L'onglet \emph{Metadonnées} fournit les informations générales sur les fichiers (voir {\hyperref[docs/user_manual/working_with_vector/vector_properties:vectormetadatatab]{\emph{Onglet Métadonnées}}}). L'onglet \emph{Prévisualisation} permet d'avoir un aperçu de vos fichiers sans avoir à les importer à votre projet QGIS. Il est également possible de prévisualiser les attributs de vos fichiers via l'onglet \emph{Attributs}.


\chapter{Les données vectorielles}
\label{docs/user_manual/working_with_vector/index:label-workingvector}\label{docs/user_manual/working_with_vector/index:working-with-vector-data}\label{docs/user_manual/working_with_vector/index::doc}

\section{Formats de données gérés}
\label{docs/user_manual/working_with_vector/supported_data:supported-data-formats}\label{docs/user_manual/working_with_vector/supported_data::doc}
QGIS utilise la bibliothèque OGR pour lire et écrire des données vectorielles incluant les formats  ESRI Shapefiles, MapInfo et Microstation ; les bases de données PostGIS, Spatialite, Oracle Spatial et de nombreux autres formats (les données vectorielles GRASS et PostgreSQL sont gérées par des extensions natives de QGIS). Les données vectorielles peuvent également être lues depuis des archives zip ou gzip. A ce jour, 69 formats de données vectorielles sont gérés par la bibliothèque OGR (voir OGR-SOFTWARE-SUITE {\hyperref[docs/user_manual/literature_web/literature_and_web_references:literature-and-web]{\emph{Bibliographie}}}). La liste complète est disponible sur \href{http://www.gdal.org/ogr/ogr\_formats.html}{http://www.gdal.org/ogr/ogr\_formats.html}.

\begin{notice}{note}{Note:}
Tous les formats listés ne fonctionnent par dans QGIS, pour différentes raisons. Par exemple, certain requiert des bibliothèques externes payantes ou l'installation de QDAL/OGR n'a pas été effectuée correctement sur votre système pour le format demandé. Seuls les formats qui ont été testés apparaissent dans la liste des types de fichiers proposés au moment de charger un vecteur dans QGIS. Les autres formats peuvent être chargés en sélectionnant \code{*.*}.
\end{notice}

Le travail sur des couches vectorielles GRASS est décrit dans la Section {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-grass]{\emph{Intégration du SIG GRASS}}}.

Cette section décrit comment travailler avec les formats les plus communs : les shapefiles ESRI, les couches PostGIS et SpatiaLite. Beaucoup des fonctionnalités de QGIS marchent, de par sa conception, de la même manière quel que soit le format vecteur des données sources. Il s'agit des fonctionnalités d'identification, de sélection, d'étiquetage et de gestion des attributs.

\index{ESRI}\index{Shapefile}\index{OGR}

\subsection{Shapefiles ESRI}
\label{docs/user_manual/working_with_vector/supported_data:esri-shapefiles}\label{docs/user_manual/working_with_vector/supported_data:index-0}\label{docs/user_manual/working_with_vector/supported_data:vector-shapefiles}
Le format de fichier vecteur standard utilisé par QGIS est le Shapefile ESRI. Il est géré à travers la bibliothèque \index{OGR Simple Feature Library}OGR Simple Feature Library ( \href{http://www.gdal.org/ogr/}{http://www.gdal.org/ogr/} ).

Un shapefile est en réalité composé de plusieurs fichiers. Les trois suivants sont requis :
\begin{enumerate}
\item {} 
\code{.shp} fichier contenant la géométrie des entités.

\item {} 
\code{.dbf} fichier contenant les attributs au format dBase.

\item {} 
\code{.shx} fichier d'index.

\end{enumerate}

Un shapefile inclu également un fichier ayant l'extension \code{.prj} qui contient les informations sur le système de coordonnées. Bien que ces informations soient très utiles elles ne sont pas obligatoires. Il peut y avoir encore d'autres fichiers associés aux données shapefile. Si vous souhaitez avoir plus de détails nous vous recommandons de vous reporter aux spécifications techniques du format shapefile, qui se trouve notamment sur \href{http://www.esri.com/library/whitepapers/pdfs/shapefile.pdf}{http://www.esri.com/library/whitepapers/pdfs/shapefile.pdf}.


\subsubsection{Charger un Shapefile}
\label{docs/user_manual/working_with_vector/supported_data:vector-load-shapefile}\label{docs/user_manual/working_with_vector/supported_data:loading-a-shapefile}
\includegraphics[width=1.5em]{mActionAddNonDbLayer.png} Pour \index{charger un shapefile}charger un shapefile, lancez QGIS et cliquez sur le bouton \includegraphics[width=1.5em]{mActionAddNonDbLayer.png} $^{\text{Ajouter une couche vecteur}}$ ou pressez les touches \code{Ctrl+Shift+V}. Une nouvelle fenêtre apparaîtra (voir {\hyperref[docs/user_manual/working_with_vector/supported_data:figure-vector-1]{figure\_vector\_1}}).
\phantomsection\label{docs/user_manual/working_with_vector/supported_data:figure-vector-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{addvectorlayerdialog.png}
\caption{Add Vector Layer Dialog \includegraphics[width=1em]{nix.png}}\end{figure}

Cliquez sur \includegraphics{radiobuttonon.png} \emph{Fichier} puis sur le bouton \textbf{{[}Parcourir{]}}. L'outil ouvre alors une fenêtre de dialogue standard (voir {\hyperref[docs/user_manual/working_with_vector/supported_data:figure-vector-2]{figure\_vector\_2}}) qui vous permet de naviguer dans les répertoires et les fichiers et charger le shapefile ou tout autre format géré. La boîte de sélection \emph{Fichiers de type} \includegraphics{selectstring.png} vous permet de présélectionner un format de fichier géré par OGR.

Si vous le souhaitez, vous pouvez également sélectionner le type de codage du shapefile.
\phantomsection\label{docs/user_manual/working_with_vector/supported_data:figure-vector-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{shapefileopendialog.png}
\caption{Open an OGR Supported Vector Layer Dialog \includegraphics[width=1em]{nix.png}}\end{figure}

Sélectionner un shapefile dans la liste puis cliquer sur \textbf{{[}Ouvrir{]}} le charge dans QGIS. {\hyperref[docs/user_manual/working_with_vector/supported_data:figure-vector-3]{Figure\_vector\_3}} montre QGIS après avoir chargé le fichier \code{alaska.shp}.
\phantomsection\label{docs/user_manual/working_with_vector/supported_data:figure-vector-3}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{shapefileloaded.png}
\caption{QGIS with Shapefile of Alaska loaded \includegraphics[width=1em]{nix.png}}\end{figure}
\phantomsection\label{docs/user_manual/working_with_vector/supported_data:tip-layer-colors}
\begin{notice}{tip}{Astuce:}
\textbf{Couleur des couches}

Quand vous ajoutez une couche sur une carte, une couleur aléatoire lui est assignée. En ajoutant plusieurs couches en une fois, différentes couleurs sont assignées à chacune des couches.
\end{notice}

Une fois chargée, vous pouvez zoomer sur le shapefile en utilisant les outils de navigation sur la carte. Pour changer la symbologie d'une couche, ouvrez la fenêtre \emph{Propriétés de la Couche} en double-cliquant sur le nom de la couche ou en faisant un clic droit sur son nom dans la légende et en choisissant \emph{Propriétés} dans le menu qui apparait. Pour plus de détails sur les paramètres de la symbologie des couches vectorielles, référez-vous à la Section {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-style-tab]{\emph{Onglet Style}}}.
\phantomsection\label{docs/user_manual/working_with_vector/supported_data:tip-load-from-external-drive-osx}
\begin{notice}{tip}{Astuce:}
\textbf{Charger une couche et un projet depuis un lecteur externe sous OS X}

Sous OS X, les lecteurs portables qui sont montés à côté du disque dur primaire n'apparaissent pas dans \emph{Fichier \(\rightarrow\) Ouvrir un Projet} comme attendu. Nous travaillons sur le support des fenêtres d'ouverture/enregistrement natives d'OS X pour résoudre ce problème. Pour y pallier, vous pouvez taper `/Volumes' dans la boîte de nom Fichier et appuyer sur \code{Entrée}. Vous pouvez ensuite parcourir les lecteurs externes et les montages réseau.
\end{notice}


\subsubsection{Améliorer les performances d'affichage}
\label{docs/user_manual/working_with_vector/supported_data:vector-improving-performance-shape}\label{docs/user_manual/working_with_vector/supported_data:improving-performance-shape}
Pour améliorer les performances de dessin d'un shapefile, vous pouvez créer un index spatial. Un index spatial améliorera à la fois la vitesse d'exécution du zoom et du déplacement panoramique. Les index spatiaux utilisés par QGIS ont une extension \code{.qix}.

Voici les étapes de création d'un index spatial :
\begin{itemize}
\item {} 
Chargez un shapefile.

\item {} 
Ouvrez la fenêtre \emph{Propriétés de la Couche} en double-cliquant sur le nom de la couche dans la légende ou en faisant un clic droit et en choisissant \emph{Propriétés} dans le menu qui apparait.

\item {} 
Dans l'onglet \emph{Général}, cliquez sur le bouton \textbf{{[}Créer un index spatial{]}}.

\end{itemize}


\subsubsection{Problème de chargement de fichier .prj}
\label{docs/user_manual/working_with_vector/supported_data:vector-shape-problem-loading}\label{docs/user_manual/working_with_vector/supported_data:problem-loading-a-shape-prj-file}
Si vous ouvrez un shapefile disposant d'un fichier \code{.prj} et que QGIS ne parvient pas à lire le système de coordonnées de référence, vous devez le définir manuellement via l'onglet \emph{Général} de la fenêtre de \emph{Propriétés de la Couche}. Cela est dû au fait que ce fichier \code{.prj} ne fournit pas les paramètres complets de la projection requis par QGIS et listés dans la fenêtre \emph{SCR}.

C'est pour cette raison que lorsque vous créez un nouveau shapefile avec QGIS, deux fichiers de projection différents sont créés. Un fichier \code{.prj} contenant un nombre limité de paramètres, compatible avec les logiciels ESRI et un fichier \code{.qpj}, fournissant la totalité des paramètres du SCR utilisé. Chaque fois que QGIS trouve un fichier \code{.qpj}, il l'utilisera à la place du fichier \code{.prj}.

\index{MapInfo}

\subsection{Charger une couche MapInfo}
\label{docs/user_manual/working_with_vector/supported_data:loading-a-mapinfo-layer}\label{docs/user_manual/working_with_vector/supported_data:vector-loading-mapinfo}\label{docs/user_manual/working_with_vector/supported_data:index-3}
\includegraphics[width=1.5em]{mActionAddNonDbLayer.png} Pour charger une couche MapInfo, cliquez sur le bouton \includegraphics[width=1.5em]{mActionAddNonDbLayer.png} $^{\text{Ajouter une couche vecteur}}$ de la barre d'outils ou tapez \code{Ctrl+Shift+V}, changez le type de \emph{Filtre} \includegraphics{selectstring.png}: pour `MapInfo {[}OGR{]}' et sélectionnez la couche .MapInfo que vous souhaitez charger.

\index{ArcInfo\_Binary\_Coverage}\index{Tiger\_Format}\index{UK\_National\_Transfer\_Format}
\index{US\_Census\_Bureau}

\subsection{Charger une couverture ArcInfo binaire}
\label{docs/user_manual/working_with_vector/supported_data:loading-an-arcinfo-binary-coverage}\label{docs/user_manual/working_with_vector/supported_data:index-5}\label{docs/user_manual/working_with_vector/supported_data:vector-loading-arcinfo-coverage}
\includegraphics[width=1.5em]{mActionAddNonDbLayer.png} Pour charger une couverture binaire ArcInfo, cliquez sur le bouton \includegraphics[width=1.5em]{mActionAddNonDbLayer.png} $^{\text{Ajouter une couche vecteur}}$ ou tapez \code{Ctrl+Shift+V} pour ouvrir la fenêtre correspondante. Sélectionnez \includegraphics{radiobuttonon.png} \emph{Répertoire} puis `Arc/Info Binary Coverage' dans le \emph{Filtre} \includegraphics{selectstring.png} de type. Naviguez jusqu'au dossier contenant vos fichiers puis choisissez-les.

De manière similaire vous pouvez directement charger les fichiers vecteurs au format UK National Transfer ainsi que le format TIGER brut de l'US Census Bureau.

\index{PostGIS}\index{PostgreSQL}

\subsection{Couches PostGIS}
\label{docs/user_manual/working_with_vector/supported_data:label-postgis}\label{docs/user_manual/working_with_vector/supported_data:postgis-layers}\label{docs/user_manual/working_with_vector/supported_data:index-6}
Les couches PostGIS sont stockées dans une base de données PostgreSQL. Les avantages de PostGIS sont les possibilités d'indexation spatiale, de filtre et de requête qu'il fournit. En utilisant PostGIS, les fonctions vecteur telles que la sélection ou l'identification fonctionnent avec plus d'exactitude qu'avec les couches OGR dans QGIS.

\index{Connection\_Manager}

\subsubsection{Créer une connexion enregistrée}
\label{docs/user_manual/working_with_vector/supported_data:vector-create-stored-connection}\label{docs/user_manual/working_with_vector/supported_data:creating-a-stored-connection}\label{docs/user_manual/working_with_vector/supported_data:index-7}
\includegraphics[width=1.5em]{mActionAddLayer.png} La première fois que vous utilisez des données PostGIS vous devez créer une connexion vers la base PostgreSQL qui contient les données. Cliquez tout d'abord sur le bouton \includegraphics[width=1.5em]{mActionAddLayer.png} $^{\text{Ajouter une couche PostGIS}}$ de la barre d'outils ou sélectionnez l'option \includegraphics[width=1.5em]{mActionAddLayer.png} \emph{Ajouter une couche PostGIS...} depuis le menu \emph{Couche} ou tapez \code{Ctrl+Shift+D}. Vous pouvez aussi ouvrir la fenêtre \emph{Ajouter une couche vecteur} et sélectionnez \includegraphics{radiobuttonon.png} \emph{Base de données}. La fenêtre \emph{Ajouter une ou plusieurs tables PostGIS} apparaît. Pour accéder au gestionnaire de connexion, cliquez sur le bouton \textbf{{[}Nouveau{]}} pour faire apparaitre la fenêtre  \emph{Créer une nouvelle connexion PostGIS}. Les paramètres requis pour la connexion sont :
\begin{itemize}
\item {} 
\textbf{Nom} : un nom pour cette connexion. Il peut être identique à \emph{Base de données}

\item {} 
\textbf{Service} : paramètre de service à utiliser en alternative à l'hôte et le port (et potentiellement labase de données). Il peut être défini dans \code{pg\_service.conf}

\item {} 
\textbf{Hôte} : nom pour l'hôte de la base de données. Il doit s'agir d'un nom existant, car il sera utilisé pour ouvrir une connexion Telnet ou interroger l'hôte. Si la base de données est sur le même ordinateur que QGIS, mettez simplement \emph{`localhost'}.

\item {} 
\textbf{Port} : numéro de port que le serveur de base de données PostgreSQL écoute. Le port par défaut est 5432.

\item {} 
\textbf{Base de données} : nom de la base de données.

\item {} 
\textbf{Mode SSL} : comment sera négociée la connexion SSL avec le serveur. Notez qu'une importante accélération du rendu des couches PostGIS peut être obtenue en désactivant le SSL dans l'éditeur de connexion. Les options suivantes sont proposées :
\begin{itemize}
\item {} 
désactiver : essayer une connexion SSL non cryptée uniquement

\item {} 
permettre : essayer une connexion non-SSL. Si cela échoue, essayer une connexion SSL

\item {} 
préferer (par défaut) : essayer une connexion SSL. Si cela échoue une connexion non-SSL

\item {} 
requiert: essayer uniquement une connexion SSL.

\end{itemize}

\item {} 
\textbf{Nom d'utilisateur} : nom d'utilisateur utilisé pour se connecter à la base de données.

\item {} 
\textbf{Mot de passe} : mot de passe associé au \emph{Nom d'utilisateur} pour se connecter à la base de données.

\end{itemize}

Vous pouvez également activer les options suivantes :
\begin{itemize}
\item {} 
\includegraphics{checkbox.png} \emph{Sauvegarder le Nom d'utilisateur}

\item {} 
\includegraphics{checkbox.png} \emph{Sauvegarder le mot de passe}

\item {} 
\includegraphics{checkbox.png} \emph{Uniquement regarder la table geometry\_columns}

\item {} 
\includegraphics{checkbox.png} \emph{Uniquement regarder dans le schéma `public'}

\item {} 
\includegraphics{checkbox.png} \emph{Lister aussi les tables sans géométrie}

\item {} 
\includegraphics{checkbox.png} \emph{Utiliser la table des métadonnées estimées}

\end{itemize}

Une fois que tous les paramètres et les options sont définis, vous pouvez tester la connexion en cliquant sur le bouton \textbf{{[}Test de connexion{]}}.
\phantomsection\label{docs/user_manual/working_with_vector/supported_data:tip-settings-security}
\begin{notice}{tip}{Astuce:}
\textbf{Paramètres utilisateur de QGIS et Sécurité}

Selon le système d'exploitation que vous utilisez, stocker les mots de passe dans vos paramètres QGIS peut présenter un risque vis-à-vis de la sécurité. Voici comment les paramètres QGIS sont stockés :
\begin{itemize}
\item {} 
\includegraphics[width=1em]{nix.png}, les paramètres sont stockés dans votre répertoire home dans \code{.qgis/}.

\item {} 
\includegraphics[width=1em]{win.png}, les paramètres sont stockés dans la base de registre.

\end{itemize}
\end{notice}


\subsubsection{Charger une couche PostGIS}
\label{docs/user_manual/working_with_vector/supported_data:loading-a-postgis-layer}\label{docs/user_manual/working_with_vector/supported_data:vector-loading-postgis}
\includegraphics[width=1.5em]{mActionAddLayer.png} Une fois une ou plusieurs connexions définies, vous pouvez charger des couches de la base de données PostgreSQL. Bien sûr, cela nécessite d'avoir des données dans PostgreSQL. Référez-vous à la Section {\hyperref[docs/user_manual/working_with_vector/supported_data:vector-import-data-in-postgis]{\emph{Importer des données dans PostgreSQL}}} pour plus de détails concernant l'importation de données dans la base de données.

Pour charger une couche PostGIS, suivez ces étapes :
\begin{itemize}
\item {} 
Si la fenêtre \emph{Ajouter une ou plusieurs tables PostGIS} n'est pas ouverte, cliquez sur le bouton \includegraphics[width=1.5em]{mActionAddLayer.png} $^{\text{Ajouter une couche PostGIS}}$ de la barre d'outils.

\item {} 
Choisissez la connexion dans la liste déroulante et cliquez sur \textbf{{[}Connecter{]}}.

\item {} 
Cochez si besoin \includegraphics{checkbox.png} \emph{Lister aussi les tables sans géométrie}

\item {} 
Utilisez si besoin des \includegraphics{checkbox.png} \emph{Options de recherche} pour définir quelles entités charger ou utilisez le bouton \textbf{{[}Construire une requête{]}} pour ouvir la fenêtre \emph{Construction de requête}.

\item {} 
Trouvez la ou les couches que vous souhaitez ajouter dans la liste des couches disponibles.

\item {} 
Sélectionnez-la en cliquant dessus. Vous pouvez sélectionner plusieurs couches en gardant la touche \code{Shift} enfoncée quand vous cliquez. Référez-vous à la Section {\hyperref[docs/user_manual/working_with_vector/query_builder:vector-query-builder]{\emph{Constructeur de requêtes}}} pour plus d'informations sur l'utilisation du Constructeur de requête de PostgreSQL pour mieux définir la couche.

\item {} 
Cliquez sur le bouton \textbf{{[}Ajouter{]}} pour ajouter la couche à la carte.

\end{itemize}
\phantomsection\label{docs/user_manual/working_with_vector/supported_data:tip-postgis-layers}
\begin{notice}{tip}{Astuce:}
\textbf{Couches PostGIS}

Normalement, une couche PostGIS est définie par une entrée dans la table geometry\_columns. Depuis la version 0.9.0, QGIS peut charger des couches qui n'ont pas d'entrée dans la table geometry\_columns. Ceci concerne aussi bien les tables que les vues. Définir une vue spatiale fournit un moyen puissant pour visualiser vos données. Référez-vous à votre manuel PostgreSQL pour plus d'informations sur la création des vues.
\end{notice}


\subsubsection{Quelques éléments de détail à propos des couches PostgreSQL}
\label{docs/user_manual/working_with_vector/supported_data:sec-postgis-details}\label{docs/user_manual/working_with_vector/supported_data:some-details-about-postgresql-layers}
Cette section fournit quelques détails sur la manière dont QGIS accède aux couches PostgreSQL. La plupart du temps, QGIS devrait simplement fournir une liste de tables de base de données qui peuvent être chargées et les charger à la demande. Cependant, si vous avez des problèmes pour charger une table PostgreSQL dans QGIS, les informations données ci-dessous peuvent vous aider à comprendre les messages de QGIS et vous donnez une indication sur comment changer la table ou la vue PostgreSQL pour qu'elle se charge dans QGIS.

QGIS demande que les couches PostgreSQL aient un champ pouvant être utilisé comme clé unique pour la couche. Pour les tables, cela signifie qu'elles doivent avoir une clé primaire ou un champ ayant une contrainte d'unicité. De plus, QGIS impose que cette colonne soit de type int4 (un entier de 4 octets). Alternativement la colonne ctid peut être utilisée comme clé primaire. Si une table ne respecte pas ces conditions, le champ oid sera utilisé à la place. Les performances seront améliorées si le champ est indexé (notez que les clés primaires sont automatiquement indexées dans PostgreSQL).

Si la couche PostgreSQL est une vue, les mêmes conditions s'appliquent, mais elles n'ont pas de clé primaire ou de champ ayant une contrainte d'unicité. Dans ce cas, QGIS essayera de trouver un champ de la vue issu d'un champ une table qui convienne en parcourant la définition SQL de la vue. Cependant, il y a certains aspects du SQL que QGIS ignore tel que l'utilisation d'alias ou de colonnes générées par des fonctions SQL.

Si aucune colonne correcte n'est trouvée, QGIS ne chargera pas la couche. Si cela arrive, la solution consiste à modifier la vue de telle sorte qu'elle inclut un champ qui convienne (de type int4 et ayant soit une clé primaire soit une contrainte d'unicité, de préférence indexée).

\index{shp2pgsql}\phantomsection\label{docs/user_manual/working_with_vector/supported_data:loading-postgis-data}

\subsection{Importer des données dans PostgreSQL}
\label{docs/user_manual/working_with_vector/supported_data:vector-import-data-in-postgis}\label{docs/user_manual/working_with_vector/supported_data:loading-postgis-data}\label{docs/user_manual/working_with_vector/supported_data:index-8}\label{docs/user_manual/working_with_vector/supported_data:importing-data-into-postgresql}
De multiples méthodes existent pour importer des données dans PostgreSQL telle que l'extension SPIT ou les outils en lignes de commande shp2pgsql ou ogr2ogr.


\subsubsection{Extension SPIT}
\label{docs/user_manual/working_with_vector/supported_data:spit-plugin}\label{docs/user_manual/working_with_vector/supported_data:id1}
QGIS est distribué avec une extension nommée \includegraphics{spiticon.png} $^{\text{SPIT}}$ (Shapefile to PostGIS Import Tool). SPIT peut être utilisé pour charger plusieurs shapefiles en une fois et inclut la gestion des schémas. Voir section {\hyperref[docs/user_manual/plugins/plugins_spit:label-spit]{\emph{Extension SPIT}}} pour plus d'informations.


\subsubsection{shp2pgsql}
\label{docs/user_manual/working_with_vector/supported_data:shp2pgsql}
PostGIS est distribué avec l'outil \textbf{shp2pgsql} qui permet d'importer des shapefiles dans une base de données PostGIS. Par exemple pour importer le shapefile \code{lakes.shp} dans la base de données PostgreSQL nommée \code{gis\_data}, utilisez la commande suivante :

\begin{Verbatim}[commandchars=\\\{\}]
shp2pgsql -s 2964 lakes.shp lakes\_new \textbar{} psql gis\_data
\end{Verbatim}

Ceci crée une nouvelle couche nommée \code{lakes\_new} dans la base de données \code{gis\_data}. La nouvelle couche aura l'identifiant de référence spatiale (SRID) 2964. Référez-vous à la section {\hyperref[docs/user_manual/working_with_projections/working_with_projections:label-projections]{\emph{Utiliser les projections}}} pour plus d'informations sur les systèmes de référence spatiale et les projections.

\index{pgsql2shp}\phantomsection\label{docs/user_manual/working_with_vector/supported_data:tip-export-from-postgis}
\begin{notice}{tip}{Astuce:}
\textbf{Exporter des jeux de données depuis PostGIS}

De la même manière que l'outil d'importation \textbf{shp2pgsql}, il y a également un outil d'exportation de jeux de données PostGIS en shapefile : \textbf{pgsql2shp}. Cet outil est inclus dans la distribution de PostGIS.
\end{notice}

\index{ogr2ogr}

\subsubsection{ogr2ogr}
\label{docs/user_manual/working_with_vector/supported_data:ogr2ogr}\label{docs/user_manual/working_with_vector/supported_data:index-10}
En plus de \textbf{shp2pgsql} et \textbf{SPIT}, un autre outil est fourni pour importer des données géographiques dans PostGIS : \textbf{ogr2ogr}. Il est inclus dans GDAL.

Pour importer un shapefile dans PostGIS, lancez la commande suivante :

\begin{Verbatim}[commandchars=\\\{\}]
ogr2ogr -f "PostgreSQL" PG:"dbname=postgis host=myhost.de user=postgres \PYGZbs{}
password=topsecret" alaska.shp
\end{Verbatim}

Ceci va importer le shapefile  \code{alaska.shp} dans la base de données PostGIS nommée \emph{postgis} en utilisant l'utilisateur \emph{postgres} avec le mot de passe \emph{topsecret} sur l'hôte \emph{myhost.de}.

Notez qu'OGR doit être compilé avec PostgreSQL pour gérer PostGIS. Vous pouvez vérifier en tapant

\begin{Verbatim}[commandchars=\\\{\}]
ogrinfo --formats \textbar{} grep -i post
\end{Verbatim}

Si vous préférez utiliser la commande PostgreSQL \textbf{COPY} au lieu de la méthode par défaut, \textbf{INSERT INTO}, vous pouvez exporter la variable d'environnement suivante (au moins sur \includegraphics[width=1em]{nix.png} et \includegraphics[width=1em]{osx.png}) :

\begin{Verbatim}[commandchars=\\\{\}]
export PG\_USE\_COPY=YES
\end{Verbatim}

\textbf{ogr2ogr} ne crée pas d'index spatial comme le fait \textbf{shp2pgsl}. Vous devez effectuer une étape supplémentaire et le créer manuellement après en utilisant la commande SQL classique \textbf{CREATE INDEX} (comme cela est détaillé dans la section suivante {\hyperref[docs/user_manual/working_with_vector/supported_data:vector-improving-performance]{\emph{Améliorer les performances}}}).
\phantomsection\label{docs/user_manual/working_with_vector/supported_data:label-improve}

\subsubsection{Améliorer les performances}
\label{docs/user_manual/working_with_vector/supported_data:label-improve}\label{docs/user_manual/working_with_vector/supported_data:improving-performance}\label{docs/user_manual/working_with_vector/supported_data:vector-improving-performance}
Récupérer des entités depuis une base de données PostgreSQL peut être long, surtout par un réseau. Vous pouvez améliorer les performances de dessin de couches PostgreSQL en vous assurant qu'un \index{index spatial PostGIS}index spatial PostGIS existe pour chaque couche dans la base de données. PostGIS gère la création d'un index \index{index GiST (Generalized Search Tree)}index GiST (Generalized Search Tree) pour accélérer les recherches spatiales sur les données (les informations sur l'index GiST sont issues de la documentation de PostGIS disponible sur \href{http://postgis.refractions.net}{http://postgis.refractions.net}).

La syntaxe pour créer un index GiST est la suivante :

\begin{Verbatim}[commandchars=\\\{\}]
CREATE INDEX [indexname] ON [tablename]
  USING GIST ( [geometryfield] GIST\_GEOMETRY\_OPS );
\end{Verbatim}

Notez que pour de grandes tables, créer un index peut prendre du temps. Une fois cet index créé, vous devriez faire une \code{VACUUM ANALYZE}. Référez-vous à la documentation de PostGIS (POSTGIS-PROJECT {\hyperref[docs/user_manual/literature_web/literature_and_web_references:literature-and-web]{\emph{Bibliographie}}}) pour plus d'informations.

Voici un exemple de création d'un index GiST :

\begin{Verbatim}[commandchars=\\\{\}]
gsherman@madison:\textasciitilde{}/current\$ psql gis\_data
Welcome to psql 8.3.0, the PostgreSQL interactive terminal.

Type:  \PYGZbs{}copyright for distribution terms
       \PYGZbs{}h for help with SQL commands
       \PYGZbs{}? for help with psql commands
       \PYGZbs{}g or terminate with semicolon to execute query
       \PYGZbs{}q to quit

gis\_data=\# CREATE INDEX sidx\_alaska\_lakes ON alaska\_lakes
gis\_data-\# USING GIST (the\_geom GIST\_GEOMETRY\_OPS);
CREATE INDEX
gis\_data=\# VACUUM ANALYZE alaska\_lakes;
VACUUM
gis\_data=\# \PYGZbs{}q
gsherman@madison:\textasciitilde{}/current\$
\end{Verbatim}

\index{ST\_Shift\_Longitude}

\subsection{Couches vectorielles dépassants les 180° de longitude}
\label{docs/user_manual/working_with_vector/supported_data:vector-layers-crossing-180-degrees-longitude}\label{docs/user_manual/working_with_vector/supported_data:index-13}
Beaucoup de logiciels de SIG ne traitent pas les cartes vecteurs ayant un système de référence géographique \index{dépassant la ligne des 180 degrés de longitude}dépassant la ligne des 180 degrés de longitude (\href{http://postgis.refractions.net/documentation/manual-1.4/ST\_Shift\_Longitude.html}{http://postgis.refractions.net/documentation/manual-1.4/ST\_Shift\_Longitude.html}). Il en résulte que sous QGIS on verra deux emplacements distincts et éloignés qui devraient être proches l'un de l'autre. Sur {\hyperref[docs/user_manual/working_with_vector/supported_data:figure-vector-4]{Figure\_vector\_4}} le petit point tout à gauche de la carte (Chatham Island) devrait être dans la grille, à droite des îles principales de Nouvelle-Zélande.
\phantomsection\label{docs/user_manual/working_with_vector/supported_data:figure-vector-4}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{vectorNotWrapping.png}
\caption{Map in lat/lon crossing the 180° longitude line \includegraphics[width=1em]{nix.png}}\end{figure}

Une solution est de transformer les valeurs longitudinales en utilisant PostGIS et la fonction \textbf{ST\_Shift\_Longitude}. Cette fonction lit chaque point/sommet de chacune des entités dans une géométrie et si la coordonnée de longitude est inférieure à 0° elle lui ajoute 360°. Le résultat est une version 0° - 360° des données sur une carte centrée à 180°.
\phantomsection\label{docs/user_manual/working_with_vector/supported_data:figure-vector-5}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{vectorWrapping.png}
\caption{Crossing 180° longitude applying the \textbf{ST\_Shift\_Longitude}
function \includegraphics[width=1em]{nix.png}}\end{figure}


\subsubsection{Usage}
\label{docs/user_manual/working_with_vector/supported_data:usage}\begin{itemize}
\item {} 
Importer des données vers PostGIS ({\hyperref[docs/user_manual/working_with_vector/supported_data:vector-import-data-in-postgis]{\emph{Importer des données dans PostgreSQL}}}) en utilisant par exemple l'extension de gestion de PostGIS (PostGIS Manager) ou l'extension SPIT

\item {} 
Utiliser l'interface en ligne de commande PostGIS pour exécuter la commande suivante (c'est un exemple où ``TABLE'' est bien le nom de votre table PostGIS)

\code{gis\_data=\# update TABLE set the\_geom=ST\_Shift\_Longitude(the\_geom);}

\item {} 
Si tout ce passe bien, vous devriez recevoir une confirmation sur le nombre d'entités qui ont été mises à jour, puis vous pouvez charger la carte et voir la différence ({\hyperref[docs/user_manual/working_with_vector/supported_data:figure-vector-5]{Figure\_vector\_5}})

\end{itemize}

\index{Spatialite}\index{SQLite}

\subsection{Couches SpatiaLite}
\label{docs/user_manual/working_with_vector/supported_data:spatialite-layers}\label{docs/user_manual/working_with_vector/supported_data:index-15}\label{docs/user_manual/working_with_vector/supported_data:label-spatialite}
\includegraphics[width=1.5em]{mActionAddSpatiaLiteLayer.png} La première fois que vous chargerez une base Spatialite, commencez par cliquer sur le bouton \includegraphics[width=1.5em]{mActionAddSpatiaLiteLayer.png} $^{\text{Ajouter une couche SpatiaLite}}$ ou sélectionner l'option \includegraphics[width=1.5em]{mActionAddSpatiaLiteLayer.png} \emph{Ajouter une couche SpatiaLite...} depuis le menu \emph{Couche} ou en tapant \code{Ctrl+Shift+L}. Ceci fait apparaitre une fenêtre qui vous permet soit de vous connecter à une baseSpatiaLite déjà connue de QGIS, que vous pouvez choisir dans une liste déroulante, ou définissant une nouvelle connexion. Pour se faire, cliquez sur le bouton \textbf{{[}Nouveau{]}} et utilisez le navigateur de fichier pour pointer votre base SpatiaLite qui se termine par une extension \code{.sqlite}.

Si vous souhaitez sauvegarder une couche vecteur au format SpatiaLite, vous pouvez le faire par un clic-droit sur la couche dans la légende. Cliquez ensuite sur \emph{Sauvegarder sous...}, définissez le nom du fichier et le SCR en sortie, choisisez `SpatiaLite' comme format. Vous pouvez également sélctionner `SQLite' comme format et ajouter \code{SPATIALITE=YES} comme source de données dans les options OGR de création. OGR crée alors une base de données SpatiaLite. Voir également \href{http://www.gdal.org/ogr/drv\_sqlite.html}{http://www.gdal.org/ogr/drv\_sqlite.html}.

QGIS gère les vues SpatiaLite éditables.


\subsubsection{Créer une nouvelle couche SpatiaLite}
\label{docs/user_manual/working_with_vector/supported_data:creating-a-new-spatialite-layer}
Si vous souhaitez créer une nouvelle couche SpatiaLite, référez-vous à la section {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:vector-create-spatialite]{\emph{Créer une nouvelle couche SpatiaLite}}}.

\index{QSpatiaLite}\index{Spatialite\_Manager}\index{DB\_Manager}\phantomsection\label{docs/user_manual/working_with_vector/supported_data:tip-spatialite-management-plugin}
\begin{notice}{tip}{Astuce:}
\textbf{Extensions de gestion de données SpatiaLite}

Pour gérer des données SpatiaLite, vous pouvez également utiliser diverses extensions Python : QSpatiaLite, SpatiaLite Manager ou DB Manager (extension principale recommandée). Elles peuvent toutes être téléchargées et installées via le Gestionnaire d'extensions.
\end{notice}


\subsection{Couches MSSQL Spatial}
\label{docs/user_manual/working_with_vector/supported_data:mssql-spatial-layers}\label{docs/user_manual/working_with_vector/supported_data:label-mssql}
\includegraphics[width=1.5em]{mActionAddMssqlLayer.png} QGIS permet de gérer nativement MS SQL 2008. Le bouton \includegraphics[width=1.5em]{mActionAddMssqlLayer.png} $^{\text{Ajouter une couche MSSQL}}$ fait partie de la nouvelle barre d'outils et les bases MS SQL sont accessibles depuis l'explorateur QGIS permettant d'ajouter des couches dans QGIS par un glisser-déposer.


\section{Fenêtre Propriétés d'une couche vecteur}
\label{docs/user_manual/working_with_vector/vector_properties:the-vector-properties-dialog}\label{docs/user_manual/working_with_vector/vector_properties::doc}\label{docs/user_manual/working_with_vector/vector_properties:vector-properties-dialog}
La fenêtre \emph{Propriétés de la couche} pour une couche vectorielle fournit des informations sur la couche, les paramètres de représentation et les options d'étiquetage. Si votre couche a été chargée depuis une base PostgreSQL/PostGIS, vous pouvez également modifier la requête SQL d'appel de la couche, en l'éditant dans la fenêtre \emph{Constructeur de requête} de l'onglet \emph{Général}. Pour accéder à la fenêtre \emph{Propriétés de la couche}, double-cliquez sur la couche dans la légende ou faites un clic droit sur la couche et sélectionnez \emph{Propriétés} dans le menu qui apparait.
\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{vectorLayerSymbology.png}
\caption{Vector Layer Properties Dialog \includegraphics[width=1em]{nix.png}}\label{docs/user_manual/working_with_vector/vector_properties:figure-vector-properties-1}\end{figure}


\subsection{Onglet Style}
\label{docs/user_manual/working_with_vector/vector_properties:vector-style-tab}\label{docs/user_manual/working_with_vector/vector_properties:style-tab}
\index{New\_Symbology}\index{Symbology\_New}
\includegraphics[width=2em]{symbology.png} Depuis la version 1.4.0 de QGIS une nouvelle symbologie a été intégrée afin d'améliorer et de remplacer à terme l'ancienne symbologie. QGIS 1.8 utilise maintenant par défaut cette nouvelle symbologie qui apporte de nombreuses améliorations et de nouvelles fonctionnalités.

Une description du fonctionnement de l'ancienne symbologie est disponible dans la section {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-old-symbology]{\emph{Ancienne symbologie}}}.

Il y a trois types de symboles : le symbole marqueur (pour les points), le symbole de lignes et les symboles de remplissage et de contour (pour les polygones). Un symbole peut lui-même être composé de plusieurs couches de symboles. Il est possible de définir la couleur d'un symbole pour l'ensemble des couches de symbole. Certaines couches de symbole peuvent avoir leur couleur verrouillée. De la même manière, il est possible de définir la largeur d'une ligne ainsi que la taille et l'orientation des symboles de type marqueur.

\index{Font\_Marker}\index{Simple\_Marker}\index{SVG\_Marker}
\index{Line\_decoration}\index{Marker\_line}\index{Simple\_line}
\index{Centroid\_fill}\index{SVG\_fill}\index{Simple\_fill}\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:vector-symbol-types}
\textbf{Types de symboles disponibles}
\begin{itemize}
\item {} 
Couches de points
\begin{itemize}
\item {} 
\textbf{Symbole de police} : symbole issu d'une police de caractère.

\item {} 
\textbf{Symbole simple} : symbole de type prédéfini dans QGIS.

\item {} 
\textbf{Symbole SVG} : symbole au format SVG.

\item {} 
\textbf{Symbole d'ellispe} : symbole dont la forme et la couleur varient selon les valeurs d'attributs.

\item {} 
\textbf{Symbole de champ vectoriel} : rendu utilisant les valeurs d'attributs.

\end{itemize}

\item {} 
Couches de lignes
\begin{itemize}
\item {} 
\textbf{Décoration de ligne} : ajoute une flèche en fin de ligne pour indiquer sa direction.

\item {} 
\textbf{Ligne de symboles} : répétition de symboles le long de la ligne.

\item {} 
\textbf{Ligne simple} : affichage classique d'une ligne (en spécifiant la couleur, l'épaisseur et le style du trait).

\end{itemize}

\item {} 
Couches de polygones
\begin{itemize}
\item {} 
\textbf{Remplissage de centroïde} : place un symbole simple au centroïde de chaque polygone.

\item {} 
\textbf{Remplissage SVG} : rempli les polygones par une répétition de symboles SVG.

\item {} 
\textbf{Remplissage simple} : rendu classique des polygones (en spécifiant la couleur et le motif de remplissage ainsi que le style des contours).

\item {} 
\textbf{Motif de lignes} : rempli les polygones par un motif de lignes.

\item {} 
\textbf{Motif de points} : rempli les polygones par un motif de points.

\item {} 
\textbf{Bordure : décoration de ligne} : ajoute une flèche indiquant la direction de la ligne.

\item {} 
\textbf{Bordure : ligne de symboles} : ajoute une répétition de symboles simples sur le contour.

\item {} 
\textbf{Bordure : ligne simple} : contour simple défini par son épaisseur, sa couleur et un style de trait.

\end{itemize}

\end{itemize}

\index{Color\_ramps}
\textbf{Palettes de couleurs}

Les palettes de couleur sont utilisées pour définir des sets de couleurs. La couleur d'un symbole sera tirée de la palette.

Il y a trois types de palettes :
\begin{itemize}
\item {} 
\textbf{Dégradé} : un dégradé linéaire d'une couleur à d'autres.

\item {} 
\textbf{Aléatoire} : couleurs générées aléatoirement à partir d'un espace de couleur.

\item {} 
\textbf{Mélangeur de couleur} : Création d'un espace de couleur depuis un schéma et un nombre fixe de classes de couleurs.

\end{itemize}

Les palettes peuvent être créées via l'onglet \emph{Palette de couleur} du \emph{Gestionnaire de style} en cliquant sur le bouton \textbf{{[}Ajouter{]}} puis en choisissant une palette de couleur (voir section {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-style-manager]{vector\_style\_manager}} ).

\textbf{Styles}

Un style regroupe un ensemble de symboles et de palettes de couleurs. Vous pouvez choisir vos symboles préférés ou les plus utilisés afin de pouvoir les employer de nouveau sans devoir les recréer. Ces objets ont toujours un nom par lequel il est possible de les appeler. Il y a un style par défaut dans QGIS qui peut être modifié, l'utilisateur pouvant en créer de nouveaux. Dans la partie inférieure de l'onglet Style, quatre boutons permettent de gérer les styles : utilisez \textbf{{[}Restaurer le style par défaut{]}} pour réinitialiser le style, \textbf{{[}Sauvegarder comme défaut{]}} pour définir le style par défaut, \textbf{{[}Charger le style...{]}} pour appliquer votre propre style et \textbf{{[}Sauvegarder le style...{]}} pour enregistrer le style courant. Le style appliqué à une couche peut être transféré à une autre couche : activez la couche, sélectionnez  \emph{Couche \(\rightarrow\)} \includegraphics[width=1.5em]{mActionEditCopy.png} \emph{Copier le style} puis activez l'autre couche et sélectionnez \emph{Couche \(\rightarrow\)} \includegraphics[width=1.5em]{mActionEditPaste.png} \emph{Coller le style}.

\index{Renderers}
\textbf{Moteurs de Rendu}

Le moteur de rendu est responsable de l'affichage d'une entité avec le symbole adéquat. Il existe quatre types de rendus : symbole unique, catégorisé (nommé couleur unique dans l'ancienne symbologie), gradué et basé sur un ensemble de règles. Il n'y a pas de rendu de couleur continue, car il s'agit d'un cas spécifique du rendu gradué. Les rendus catégorisés et gradués peuvent être créés en spécifiant un symbole et une palette de couleur - les couleurs des différents symboles changeront selon.
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:vector-new-symbology}
\textbf{Travailler avec la nouvelle symbologie}

Dans l'onglet \emph{Style}, vous pouvez choisir entre différents types de rendu : symbole unique, catégorisé, gradué, ensemble de règles et déplacement de points. Pour chaque type de données (points, lignes ou polygones), des types de symboles vectoriels sont disponibles (voir {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-symbol-types]{vector\_symbol\_types}}). Selon le mode de rendu choisi, onglet style propose différents paramètres et options qui sont décrits dans les sections qui suivent. L'interface de la nouvelle symbologie propose également un bouton \textbf{{[}Gestionnaire de styles...{]}} qui permet d'accéder au Gestionnaire de styles (voir section {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-style-manager]{\emph{Gestionnaire de styles}}}). Ce dernier permet d'éditer, d'ajouter ou de supprimer des types de symboles.
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:tip-change-multiple-symbols}
\begin{notice}{tip}{Astuce:}
\textbf{Sélectionner et modifier plusieurs symboles}

La nouvelle symbologie permet de sélectionner plusieurs symboles et, par un clic-droit, de modifier la couleur, la transparence, la taille ou l'épaisseur du contour des entrées sélectionnées.
\end{notice}

\index{Single\_Symbol\_Renderer}\index{Renderer\_Single\_Symbol}
\textbf{Symboles uniques}

Le moteur de rendu pour symbole unique est utilisé pour représenter toutes les entités de la couche de la même façon, définie par l'utilisateur. Les propriétés, qui peuvent être ajustées dans l'onglet \code{Style}, dépendent du type de géométrie de la couche, mais partagent une structure similaire. En haut à gauche figure un aperçu du symbole tel qu'il apparaîtra. En bas est affichée la liste des symboles déjà existants dans le style courant, prêts à être sélectionnés d'un simple clic. Le symbole courant peut être modifié en utilisant le bouton \textbf{{[}Modification...{]}} situé sous l'aperçu et qui ouvre la fenêtre de \emph{Propriétés du symbole}, ou en utilisant le bouton \textbf{{[}Changer{]}} situé à droite de l'aperçu et qui ouvre la fenêtre \emph{Sélectionner une couleur}.
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-symbology-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{singlesymbol_ng_line.png}
\caption{Single symbol line properties \includegraphics[width=1em]{nix.png}}\end{figure}

Dans l'onglet \emph{Style},vous pouvez définir non seulement la transparence générale de la couche mais également les unités à utiliser pour la taille des symboles (millimètre ou unité identique à celle de la carte). Avec le bouton \textbf{{[}Avancé{]}} situé à côté de \textbf{{[}Sauvegarder le style{]}}, vous pouvez spécifier un champ de la table attributaire à utiliser pour faire varier la taille ou la rotation. Ici le menu \emph{Niveaux de symbole} permet définir manuellement dans quel ordre les couches de symboles doivent être dessinées (si plusieurs symboles différents ont été définis pour la couche).

Après avoir effectué les modifications nécessaires, le symbole peut être ajouté à la liste des symboles existants (en utilisant le bouton \textbf{{[}Sauvegarder le style{]}}) pour être réemployé ultérieurement. De plus, vous pouvez utiliser le bouton \textbf{{[}Sauvegarder le style{]}} situé en bas pour exporter le symbole comme fichier de style QGIS (.qml) ou fichier SLD (.sld). Actuellement dans la version 1.8, des SLD peuvent être exportés pour tous les types de rendu (symbole unique, catégorisé, gradué ou basé sur un ensemble de règles) mais lors de l'importation d'un SLD seuls les rendus simple et basé sur un ensemble de règles peuvent être créés. Cela signifie que les rendus catégorisé et gradué seront convertis en un ensemble de règles. Si vous souhaitez conserver ces types de rendu, il faut fonctionner avec des fichiers QML. Mais il peut être très pratique d'utiliser ce système pour convertir des styles en ensemble de règles.

\index{Categorized\_Renderer}\index{Renderer\_Categorized}
\textbf{Symboles catégorisés}

Le rendu catégorisé est utilisé pour afficher toutes les entités d'une couche en recourant à un symbole défini par l'utilisateur dont la couleur reflètera la valeur d'un attribut donné. L'onglet \emph{Style} vous permet de sélectionner :
\begin{itemize}
\item {} 
l'attribut (en choisissant parmi la liste des colonnes)

\item {} 
le symbole (en utilisant la fenêtre de Sélection de symbole)

\item {} 
les couleurs (en utilisant la liste de palettes de couleur)

\end{itemize}

Le bouton \textbf{{[}Avancé{]}} dans le coin inférieur droit de la fenêtre permet de définir les champs contenant les informations relatives à la rotation et la proportion.
Pour faciliter les choix de représentation, la liste dans la partie inférieure de la fenêtre affiche les valeurs de tous les attributs actuellement sélectionnés, ce qui inclut les symboles qui seront affichés.

L'exemple de la figure {\hyperref[docs/user_manual/working_with_vector/vector_properties:figure-symbology-2]{figure\_symbology\_2}} montre le rendu des catégories de la couche des rivières de l'échantillon de données de QGIS.
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-symbology-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{categorysymbol_ng_line.png}
\caption{Categorized Symbolizing options \includegraphics[width=1em]{nix.png}}\end{figure}

\index{Color\_Ramp}\index{Gradient\_Color\_Ramp}\index{ColorBrewer}\index{Custom\_Color\_Ramp}
Vous pouvez créer une palette de couleur personnalisée en cliquant sur \emph{New color ramp...} dans la liste déroulante des palettes. Une fenêtre vous demandera de choisir le type : gradué, aléatoire, mélangeur de couleur (ColorBrewer). Chacun des ces choix à sa propre série d'options, voir figure {\hyperref[docs/user_manual/working_with_vector/vector_properties:figure-symbology-3]{figure\_symbology\_3}} pour un exemple de palette personnalisée.
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-symbology-3}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=12em]{customColorRampGradient.png}
\caption{Example of custom gradient color ramp with multiple stops \includegraphics[width=1em]{nix.png}}\end{figure}

\index{Graduated\_Renderer}\index{Renderer\_Graduated}
\index{Natural\_Breaks\_(Jenks)}\index{Pretty\_Breaks}\index{Equal\_Interval}\index{Quantiles}
\textbf{Symboles gradués}

Le rendu gradué est utilisé pour afficher toutes les entités d'une couche, en utilisant un symbole de couche défini par l'utilisateur dont la couleur reflètera la plage d'appartenance d'une valeur d'un attribut (p. ex. une plage d'altitude de 0 à 100m).
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-symbology-4}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{graduatesymbol_ng_line.png}
\caption{Graduated Symbolizing options \includegraphics[width=1em]{nix.png}}\end{figure}

De la même manière que le rendu catégorisé, il est possible de faire varier l'angle de rotation et la taille des symboles selon les valeurs des champs spécifiés.

De la même façon que le rendu catégorisé, l'onglet \emph{Style} vous permet de modifier les points suivants :
\begin{itemize}
\item {} 
l'attribut (en choisissant parmi la liste des colonnes)

\item {} 
le symbole (en utilisant le bouton changer)

\item {} 
la couleur (en utilisant la liste des palettes de couleur)

\end{itemize}

De plus, vous pouvez choisir le nombre de classes et la méthode de classification. Les modes disponibles sont :
\begin{itemize}
\item {} 
Intervalles égaux

\item {} 
Quantiles

\item {} 
Ruptures naturelles (Jenks)

\item {} 
Écart-type

\item {} 
Jolies ruptures (``Pretty'' de R)

\end{itemize}

La liste de la partie inférieure de l'onglet \emph{Style} indique les classes ainsi que leurs plages, étiquettes et symboles.

L'exemple de la figure {\hyperref[docs/user_manual/working_with_vector/vector_properties:figure-symbology-4]{figure\_symbology\_4}} montre le rendu gradué de la couche des rivières de l'échantillon de données de QGIS.

\index{Rule-based\_Rendering}\index{Rendering\_Rule-based}
\textbf{Rendu basé sur un ensemble de règles}

Ce moteur de rendu est utilisé pour afficher toutes les entités d'une couche en utilisant un ensemble de règles prédéfinies dont la couleur reflète la manière dont une entité a été classée en fonction de ses attributs. Les règles sont définies par des expressions SQL. La fenêtre permet de regrouper les règles par type de filtre ou échelle de validité. Vous pouvez activer le rendu selon les niveaux de symboles ou arréter le rendu à la première règle validée pour chaque entité.

L'exemple de la figure {\hyperref[docs/user_manual/working_with_vector/vector_properties:figure-symbology-5]{figure\_symbology\_5}} montre le rendu basé sur des règles pour la couche des rivières de l'échantillon de données de QGIS.

Pour créer une règle, séletionez une ligne existante en cliquant dessus puis cliquez sur le bouton \textbf{{[}Éditer{]}} ou cliquez directement sur `+'. Dans la fenêtre de \emph{Propriétés de la règle} vous pouvez définir une Étiquette pour identifier la règle. Cliquez sur le bouton \includegraphics{browsebutton.png} pour ouvrir le Constructeur de chaîne d'expression. Dans la \textbf{Liste de fonctions}, cliquez sur \emph{Champs et valeurs} pour visualiser tous les attributs de la table. Pour ajouter un champ  dans la zone \textbf{Expression}, double-cliquez sur son nom depuis la liste \emph{Champs et valeurs}. Vous pouvez utiliser plusieurs champs, valeurs et fonctions pour construire l'expression à calculer ou les rentrer directement manuellement (voir {\hyperref[docs/user_manual/working_with_vector/field_calculator:vector-field-calculator]{\emph{Calculatrice de champ}}}).
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-symbology-5}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{rulesymbol_ng_line.png}
\caption{Rule-based Symbolizing options \includegraphics[width=1em]{nix.png}}\end{figure}

\index{Point\_Displacement\_Renderer}\index{Renderer\_Point\_Displacement}
\index{Displacement\_plugin}
\textbf{Déplacement de point}

Le rendu de déplacement de point offre une visualisation de tous les points d'une couche, même si ceux-ci se superposent. Pour se faire, les symboles des points sont répartis en cercle autour d'un symbole central.
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-symbology-6}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{poi_displacement.png}
\caption{Point displacement dialog \includegraphics[width=1em]{nix.png}}\end{figure}

\index{Symbol\_Properties}
\textbf{Propriétés des symboles}

La fenêtre de propriétés d'un symbole permet à l'utilisateur de spécifier ses différentes propriétés. En bas à gauche figure un aperçu du symbole tel qu'il sera affiché sur la carte. Juste au dessus est placée la liste des différentes couches de symbole. Pour accéder à cette fenêtre de \emph{Propriétés du symbole}, cliquez sur le bouton \textbf{{[}} \includegraphics[width=1em]{mActionOptions.png} \textbf{Modification...{]}} de l'onglet \emph{Style} de la fenêtre de \emph{Propriétés de la couche}.

Les boutons permettent d'ajouter ou de supprimer des couches de symbole, changer leur superposition, vérouiller leur couleur. Dans la partie droite sont affichés les paramètres relatifs à la couche de symbole sélectionnée. Le plus important est sans doute la liste \emph{Type de Symbole} \includegraphics{selectstring.png} qui permet de choisir le type de la couche. Les options disponibles dépendent du type d'entités (Point, Ligne, Polygone). Les types de couche de symboles sont décrits dans la section {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-symbol-types]{vector\_symbol\_types}}. Vous pouvez également changer les propriétés de la couche de symbole sélectionnée dans la partie droite de la fenêtre. Par exemple, si vous avez choisi un symbole SVG pour une couche de points, il est possible de changer la couleur en utilisant le bouton \emph{Couleur}.
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-symbology-7}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{symbolproperties1.png}
\caption{Line composed from three simple lines \includegraphics[width=1em]{nix.png}}\end{figure}


\subsection{Gestionnaire de styles}
\label{docs/user_manual/working_with_vector/vector_properties:style-manager}\label{docs/user_manual/working_with_vector/vector_properties:vector-style-manager}
Le gestionnaire de styles est une petite application qui liste les symboles et les palettes de couleurs disponibles. Il permet d'ajouter et/ou supprimer des styles. Pour l'utiliser, cliquez sur \emph{Préférences \(\rightarrow\) Gestionnaire de Style} dans le menu principal. Vous pouvez également y accéder depuis l'onglet \emph{Style}.
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-symbology-10}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{stylemanager.png}
\caption{Style Manager to manage symbols and color ramps \includegraphics[width=1em]{nix.png}}\end{figure}

\index{Old\_Symbology}\index{Symbology\_Old}

\subsection{Ancienne symbologie}
\label{docs/user_manual/working_with_vector/vector_properties:index-15}\label{docs/user_manual/working_with_vector/vector_properties:vector-old-symbology}\label{docs/user_manual/working_with_vector/vector_properties:old-symbology}
\begin{notice}{note}{Note:}
QGIS 1.8 permet toujours l'utilisation de l'ancienne symbologie, bien qu'il est recommandé de passer à la nouvelle, décrite dans la section {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-new-symbology]{vector\_new\_symbology}}. L'ancienne symbologie sera retirée dans l'une des prochaines versions.
\end{notice}

If you want or need to switch back to the old symbology you can click on
the \textbf{{[}Old symbology{]}} button in the \emph{Style} tab of the
\emph{Layer Properties} dialog.

You can also make the old symobolgy the default, deactivating \includegraphics{checkbox.png}
\emph{Use new generation symbology for rendering} in the
\emph{Rendering} tab under \emph{Settings \(\rightarrow\)} \includegraphics[width=1em]{mActionOptions.png}
\emph{Options}.

\index{Old\_Symbology\_Renderers}\index{Renderers\_Old\_Symbology}
The old QGIS symbology supports the following renderers:
\begin{itemize}
\item {} 
\textbf{Single symbol} - a single style is applied to every object in the layer.

\item {} 
\textbf{Graduated symbol} - objects within the layer are displayed with different
symbols classified by the values of a particular field.

\item {} 
\textbf{Continuous color} - objects within the layer are displayed with a spread of
colours classified by the numerical values within a specified field.

\item {} 
\textbf{Unique value} - objects are classified by the unique values within a
specified field with each value having a different symbol.

\end{itemize}

To \index{change the symbology}change the symbology for a layer, simply double click on its legend
entry and the vector \emph{Layer Properties} dialog will be shown.

\index{Fill\_Style}\index{Fill\_Color}\index{Outline\_Options}
\textbf{Style Options}

Within this dialog you can style your vector layer. Depending on the
selected rendering option you have the possibility to also classify your
map features.

At least the following styling options apply for nearly all renderers:
\begin{itemize}
\item {} 
\textbf{Fill style} - Style for filling. Beside the given brushes you can select
\emph{Fill style:} \includegraphics{selectstring.png} `Texture' and click the \includegraphics{browsebutton.png}
button for selecting your own texture file. Currently the fileformats
\code{*.jpeg}, \code{*.xpm}, and \code{*.png} are supported.

\item {} 
\textbf{Fill color} - fill-color of your features.

\item {} 
\textbf{Outline options}
\begin{itemize}
\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.

\end{itemize}

\end{itemize}

Once you have styled your layer you also could save your layer-style to a
separate file (ending with \code{*.qml}).
To do this, use the button \textbf{{[}Save Style...{]}}. No need to say that
\textbf{{[}Load Style...{]}} loads your saved layer-style-file.

If you wish to always use a particular style whenever the layer is loaded,
use the \textbf{{[}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
\textbf{{[}Restore Default Style{]}} button to revert to your default style.

\index{Vector\_Transparency}\index{Transparency\_Vector}
\textbf{Vector transparency}

QGIS allows to set a transparency for every vector layer. This can be done
with the slider \emph{Transparency} \includegraphics{slider.png} inside the
\emph{Style} tab. This is very useful for overlaying several vector
layers.

\index{Style\_Manager}\index{Manage\_Symbols}\index{Manage\_Color\_Ramps}
\index{Labeling\_Engine}\index{Labeling\_New}\index{Labeling\_Old}

\subsection{Onglet Étiquettes}
\label{docs/user_manual/working_with_vector/vector_properties:index-21}\label{docs/user_manual/working_with_vector/vector_properties:vector-labels-tab}\label{docs/user_manual/working_with_vector/vector_properties:labels-tab}
\includegraphics[width=2em]{labels.png} De même que pour la symbologie, QGIS 1.8 propose en parallèle deux moteurs d'étiquettes : un ancien et un nouveau. L'onglet \emph{Étiquettes} correspond toujours à l'ancien système d'étiquetage mais sera remplacé par le nouveau dans l'une des prochaines versions de QGIS.

Nous vous recommandons de passer au nouveau système d'étiquetage décrit dans la section {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-new-labeling]{\emph{Nouveau moteur d'étiquetage}}}.

The old labeling in the \emph{Labels} tab allows you to enable labeling
features and control a number of options related to fonts, placement, style,
alignment and buffering. We will illustrate this by labeling the lakes
shapefile of the QGIS sample dataset:
\begin{enumerate}
\item {} 
Load the Shapefile \code{alaska.shp} and GML file \code{lakes.gml}
in QGIS

\item {} 
Zoom in a bit to your favorite area with some lake

\item {} 
Make the \code{lakes} layer active

\item {} 
Ouvrir la fenêtre \emph{Propriétés de la couche}

\item {} 
Click on the \emph{Labels} tab

\item {} 
Check the \includegraphics{checkbox.png} \emph{Display labels} checkbox to enable labeling

\item {} 
Choose the field to label with. We will use
\emph{Field containing label} \includegraphics{selectstring.png} \code{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 \code{NAMES} field.

\item {} 
If you have labels extending over several lines, check
\includegraphics{checkbox.png}\emph{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 \code{\textbackslash{}n}, (not two separate
characters, like a backlash \code{\textbackslash{}} followed by the character \code{n}).  To insert
line returns in an attribute field configure the edit widget to be text
edit (not line edit).

\item {} 
Click \textbf{{[}Apply{]}}.

\end{enumerate}

Now we have labels. How do they look? They are probably too big and poorly
placed in relation to the marker symbol for the lakes.

Select the \code{Font} entry and use the \textbf{{[}Font{]}} and \textbf{{[}Color{]}} buttons to
set the font and color. You can also change the angle and the placement of
the text-label.

To change the position of the text relative to the feature:
\begin{enumerate}
\item {} 
Beneath the Basic label options change the placement by selecting one of the
radio buttons in the \emph{Placement} group. To fix our labels, choose
the \includegraphics{radiobuttonon.png} \emph{Right} radio button.

\item {} 
the \code{Font size units} allows you to select between \includegraphics{radiobuttonon.png}
\emph{Points} or \includegraphics{radiobuttonoff.png} \emph{Map units}.

\item {} 
Click \textbf{{[}Apply{]}} to see your changes without closing the dialog.

\end{enumerate}

Things are looking better, but the labels are still too close to the marker.
To fix this we can use the options on the \code{Offset} entry which is on the bottom
of the menu. Here we can add offsets for the X and Y directions. Adding an X
offset of 5 will move our labels off the marker and make them more readable. Of
course if your marker symbol or font is larger, more of an offset will be required.

The last adjustment we'll make is to \code{Buffer} the labels. This just means
putting a backdrop around them to make them stand out better. To buffer the
lakes labels:
\begin{enumerate}
\item {} 
Click the \includegraphics{checkbox.png} \emph{Buffer Labels} checkbox to enable
buffering.

\item {} 
Choose a size for the buffer using the spin box.

\item {} 
Choose a color by clicking on \textbf{{[}Color{]}} and choosing your favorite
from the color selector. You can also set some transparency for the
buffer if you prefer.

\item {} 
Click \textbf{{[}Apply{]}} to see if you like the changes.

\end{enumerate}

If you aren't happy with the results, tweak the settings and then test again by
clicking \textbf{{[}Apply{]}}.

A buffer of 1 points seems to give a good result. Notice you can also specify
the buffer size in map units if that works out better for you.

The advanced entries inside the \emph{Label} tab allow you control
the appearance of the labels using attributes stored in the layer. The
entries beginning with \code{Data defined} allow you to set all the parameters
for the labels using fields in the layer.

Note that the \emph{Label} tab provides a \code{preview-box} where your
selected label is shown.

\index{New\_Labeling}\index{Smart\_Labeling}

\subsection{Nouveau moteur d'étiquetage}
\label{docs/user_manual/working_with_vector/vector_properties:vector-new-labeling}\label{docs/user_manual/working_with_vector/vector_properties:new-labeling}\label{docs/user_manual/working_with_vector/vector_properties:index-22}
Le nouveau moteur d'\includegraphics[width=1.5em]{mActionLabeling.png} $^{\text{Étiquetage}}$ permet de générer intelligemment des étiquettes pour les couches vectorielles de points, lignes et polygones et requiert peu de paramètres. Il gère les couches transfoméées à la volée.Ce nouveau moteur remplacera celui décrit dans la section {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-labels-tab]{\emph{Onglet Étiquettes}}}.

\textbf{Utiliser le nouveau moteur d'étiquetage}
\begin{enumerate}
\item {} 
Démarrez QGIS et chargez une couche de points, lignes ou polygones.

\item {} 
Sélectionnez la la couche dans la légende et cliquez sur le bouton  \includegraphics[width=1.5em]{mActionLabeling.png} $^{\text{Étiquetage}}$ situé dans la barre d'outils de QGIS.

\end{enumerate}

\textbf{Étiqueter une couche de points}

La première étape est de cocher la case \includegraphics{checkbox.png} \emph{Étiqueter cette couche avec} et de choisir le champ de la table d'attribut à utiliser pour les étiquettes. Cliquez sur \includegraphics{browsebutton.png} si vous souhaitez obtenir des étiquettes complexes générées par une expression. Vous pouvez ensuite définir le style du texte et l'échelle de visibilité dans l'onglet \emph{Paramètres d'étiquetage} (voir {\hyperref[docs/user_manual/working_with_vector/vector_properties:figure-labels-1]{Figure\_labels\_1}}). L'onglet \emph{Avancé} permet de définir l'emplacement des étiquettes et leurs priorités d'affichage. C'est ici que vous choisissez si toutes les parties d'une entité multi-parties doivent être étiquetées. Le caractère de retour à la ligne se définit également ici et permet d'introduire des retours à la ligne dans les étiquettes. L'onglet \emph{Source de définition des paramètres} permet de définir les propriétés de la police, du tampon et de la position grâce aux valeurs stockées dans la table attributaire.
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-labels-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{label_points.png}
\caption{Smart labeling of vector point layers \includegraphics[width=1em]{nix.png}}\end{figure}

\textbf{Étiqueter une couche de lignes}

La première étape est de cocher la case \includegraphics{checkbox.png} \emph{Étiqueter cette couche avec} et de choisir le champ de la table d'attribut à utiliser pour les étiquettes. Cliquez sur \includegraphics{browsebutton.png} si vous souhaitez obtenir des étiquettes complexes générées par une expression. Vous pouvez ensuite définir le style du texte et l'échelle de visibilité dans l'onglet \emph{Paramètres d'étiquetage}. D'autres options d'étiquetage sont disponibles via l'onglet \emph{Avancé}. Vous pouvez définir l'emplacement des étiquettes et leur distance par rapport aux lignes ainsi que choisir un d'étiquetage suivant la direction des lignes et la priorité d'affichage. De plus, c'est ici que vous choisissez si toutes les parties d'une entité multi-parties doivent être étiquetées, si les lignes doivent être fusionnées pour éviter la duplication d'étiquettes et si un symbole de direction doit être ajouté (voir {\hyperref[docs/user_manual/working_with_vector/vector_properties:figure-labels-2]{Figure\_labels\_2}}). Vous pouvez empêcher l'étiquetage de certaines lignes et définir le caractère de retour à la ligne. Utilisez l'onglet \emph{Source de définition des paramètres} pour définir des paramètres d'étiquetage grâce aux valeurs stockées dans la table attributaire.
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-labels-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{label_line.png}
\caption{Smart labeling of vector line layers \includegraphics[width=1em]{nix.png}}\end{figure}

\textbf{Étiqueter une couche de polygones}

La première étape est de cocher la case \includegraphics{checkbox.png} \emph{Étiqueter cette couche avec} et de choisir le champ de la table d'attribut à utiliser pour les étiquettes. Cliquez sur \includegraphics{browsebutton.png} si vous souhaitez obtenir des étiquettes complexes générées par une expression. Vous pouvez ensuite définir le style du texte et l'échelle de visibilité dans l'onglet \emph{Paramètres d'étiquetage} (voir {\hyperref[docs/user_manual/working_with_vector/vector_properties:figure-labels-3]{Figure\_labels\_3}} ). Des options de placement, de distance et de priorité d'affichage sont disponibles via l'onglet \emph{Avancé}. De plus, c'est ici que vous choisissez si toutes les parties d'une entité multi-parties doivent être étiquetées. Vous pouvez empêcher l'étiquetage de certains polygones et définir le caractère de retour à la ligne. Utilisez l'onglet \emph{Source de définition des paramètres} pour définir des paramètres d'étiquetage grâce aux valeurs stockées dans la table attributaire.
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-labels-3}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{label_area.png}
\caption{Smart labeling of vector polygon layers \includegraphics[width=1em]{nix.png}}\end{figure}

\index{Label\_Engine\_Settings}\index{Colliding\_Labels}
\index{Popmusic\_Tabu}\index{Popmusic\_Chain}\index{Chain}\index{Popmusic\_Tabu\_Chain}\index{FALP}
\textbf{Modifier les paramètres de rendu des étiquettes}

En cliquant sur le bouton \textbf{{[}Paramètres{]}}, vous pouvez sélectionner la méthode de recherche à appliquer pour trouver le meilleur emplacement de chaque étiquette. Les méthodes disponibles sont : Chaîne, Popmusic Tabu, Popmusic Chain, Popmusic Tabu Chain et FALP.
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-labels-4}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=15em]{label_engine.png}
\caption{Dialog to change label engine settings \includegraphics[width=1em]{nix.png}}\end{figure}

De plus le nombre de possibilités peut être précisé pour les couches de points, lignes et polygones et vous pouvez choisir de forcer l'affichage de toutes les étiquettes (y compris celles qui se superposent) et afficher toutes les possibilité d'affichage, pour le débogage.

\textbf{Mots-clé à utiliser dans les champs destinés à l'étiquetage}

Voici une liste des mots-clé supportés, qui peuvent être utilisés dans les attributs pour l'emplacement des étiquettes.
\begin{itemize}
\item {} 
\textbf{Pour l'alignement horizontal} : \code{left}, \code{center}, \code{right}

\item {} 
\textbf{Pour l'alignement vertical} : \code{bottom}, \code{base}, \code{half}, \code{top}

\item {} 
\textbf{Les couleurs sont à spécifier en notation svg}, par exemple . \#ff0000

\item {} 
\textbf{Pour le gras, le souligné, le barré et l'italic} : 0 = faux 1 = vrai

\end{itemize}

Une combinaison de ces mots-clé dans un champ fonctionne également, par exemple : \code{base right} ou \code{bottom left}.


\subsection{Onglet Champs}
\label{docs/user_manual/working_with_vector/vector_properties:vector-attributes-tab}\label{docs/user_manual/working_with_vector/vector_properties:fields-tab}
\includegraphics[width=2em]{attributes.png} Dans l'onglet \emph{Champs}, il est possible de manipuler les attributs du jeu de données sélectionné. Les boutons  \includegraphics[width=1.5em]{mActionNewAttribute.png} $^{\text{Nouvelle colonne}}$ et \includegraphics[width=1.5em]{mActionDeleteAttribute.png} $^{\text{Effacer une colonne}}$ peuvent être utilisés lorsque le jeu de données est en \includegraphics[width=1.5em]{mActionToggleEditing.png} $^{\text{mode édition}}$.

Actuellement, seules les colonnes des couches PostGIS peuvent être effacées ou ajoutées. La bibliothèque OGR, avec les versions de GDAL \textgreater{}= 1.9, supporte l'ajout et la suppression de colonnes.

\textbf{Outils d'édition}




\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-fields-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{editwidgetsdialog.png}
\caption{Dialog to select an edit widget for an attribute column \includegraphics[width=1em]{nix.png}}\end{figure}

Dans l'onglet \emph{Champs} vous trouverez un colonne \code{Outils d'édition}. Cette colonne peut être utilisée pour définir les valeurs ou les plages de valeurs permises lors de l'ajout d'attributs dans une colonne. Si vous cliquez sur le bouton \textbf{{[}Édition de ligne{]}}, une fenêtre s'ouvre et permet de choisir parmi les différents outils d'édition proposés. Ces outils sont :
\begin{itemize}
\item {} 
\textbf{Édition de ligne} : un champ d'édition qui permet d'entrer du texte simple (ou de restreindre à des nombres pour des attributs de type numériques).

\item {} 
\textbf{Classification} : Affiche une liste déroulante avec les valeurs utilisées pour la classification, si vous avez choisi le style `Catégorisé' dans l'onglet \emph{Style} de la fenêtre de propriétés.

\item {} 
\textbf{Plage} : Permet de spécifier une plage de valeurs numériques disponibles. Il peut s'agir d'une barre coulissante ou d'une zone de texte éditable.

\item {} 
\textbf{Valeurs uniques} : L'utilisateur peut sélectionner l'une des valeurs déjà utilisées dans cette colonne. Une ligne est affichée avec le support de l'auto-complétion si la case `Éditable' est cochée, une boîte de saisie est utilisée sinon.

\item {} 
\textbf{Nom de fichier} : Simplifie la sélection d'un fichier par l'ouverture d'un explorateur de fichiers.

\item {} 
\textbf{Liste de valeurs} : Liste déroulante avec des valeurs prédéfinies. La valeur est stockée dans l'attribut, la description est affichée dans la liste. Vous pouvez défninir des valeurs manuellement ou les charger depuis la couche ou depuis un fichier CSV.

\item {} 
\textbf{Énumération} : Ouvre une liste déroulante avec les valeurs qui peuvent être utilisées selon la définition du type de champ. Ce mode d'édition n'est actuellement disponible que pour les couches PostgreSQL.

\item {} 
\textbf{Immuable} : Un attribut immuable est en lecture seule. L'utilisateur ne pourra pas le modifier.

\item {} 
\textbf{Cachée} : Un attribut caché sera invisible. L'utilisateur ne pourra pas visualiser son contenu.

\item {} 
\textbf{Case à cocher} : Affiche une case à cocher et vous pouvez définir quelle valeur stocker quand la case est cochée ou pas.

\item {} 
\textbf{Édition de texte} : Ouvre une zone d'édition de texte permettant les retours à la ligne.

\item {} 
\textbf{Calendrier} : Ouvre un calendrier permettant de choisir une date. Le champ doit être de type texte.

\item {} 
\textbf{Valeur relationnelle} : Propose les valeurs stockées dans un champ d'une autre table. Vous choisisez la table, le champ clé et le champ de valeur.

\item {} 
\textbf{Générateur d'UUID} : Champ en lecture seule qui génère un UUID (Identifiant Unique Universel) lorsqu'il est vide.

\end{itemize}


\subsection{Onglet Général}
\label{docs/user_manual/working_with_vector/vector_properties:general-tab}\label{docs/user_manual/working_with_vector/vector_properties:vectorgeneraltab}
\includegraphics[width=2em]{general.png} L'onglet \emph{Général} des couches vectorielles est très proche de celui des couches raster. Voici les options disponibles :
\begin{itemize}
\item {} 
modifier le nom affiché de la couche,

\item {} 
choisir le champ à afficher dans la fenêtre d'\emph{Identification des résultats},

\item {} 
définir une Interface d'édition pour la couche, interface réalisée avec l'IDE Qt Creator et ses outils associés (\href{http://qt.digia.com/Product/Developer-Tools/}{http://qt.digia.com/Product/Developer-Tools/}),

\item {} 
créer un \emph{Index Spatial} (uniquement pour les formats supportés par OGR),

\item {} 
ajouter une \emph{Fonction d'initialisation} pour la couche. Elle écrasera les initialisations définies par QGIS,

\item {} 
\emph{Mettre à jour l'emprise} dans les informations de la couche,

\item {} 
visualiser ou modifier le système de coordonnées de référence de la couche en cliquant sur  \emph{Specifier le SCR},

\end{itemize}

De plus vous pouvez \includegraphics{checkbox.png} \emph{Utiliser le rendu dépendant de l'échelle}, définir des options spécifiques (par exemple l'encodage) et, avec le bouton \textbf{{[}Constructeur de requête{]}}, vous pouvez restreindre la couche à un sous-ensemble d'entités (référez-vous également à la section {\hyperref[docs/user_manual/working_with_vector/query_builder:sec-selection-query]{\emph{Sélection}}}).
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-general-vect}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{vector_general_tab.png}
\caption{General tab in vector layers properties dialog \includegraphics[width=1em]{nix.png}}\end{figure}


\subsection{Onglet Métadonnées}
\label{docs/user_manual/working_with_vector/vector_properties:metadata-tab}\label{docs/user_manual/working_with_vector/vector_properties:vectormetadatatab}
\includegraphics[width=2em]{metadata.png} L'onglet \emph{Métadonnées} contient les informations sur la couche dont le type et la localisation, le nombre d'entités, le type des entités et les possibilités d'éditions. Les sections \emph{Emprise} et \emph{Système spatial de référence de la couche} fournissent d'autres informations sur la couche. Cet onglet permet d'obtenir rapidement des informations sur la couche.

De plus, vous pouvez ajouter ou éditer le titre et le résumé de la couche. Ces informations seront sauvegardées dans le fichier de projet QGIS et utilisées par QGIS Server.
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-metadata-vect}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{vector_metadata_tab.png}
\caption{Metadata tab in vector layers properties dialog \includegraphics[width=1em]{nix.png}}\end{figure}


\subsection{Onglet Actions}
\label{docs/user_manual/working_with_vector/vector_properties:actions-tab}
\includegraphics[width=2em]{action.png} QGIS est capable d'effectuer des actions basées sur les attributs d'une entité. Il peut s'agir de nombreuses actions, par exemple exécuter un programme avec des arguments construits à partir des attributs d'une entité, ou encore, passer des paramètres à un outil de publication de rapports sur internet.
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-actions-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{action_dialog.png}
\caption{Overview action dialog with some sample actions \includegraphics[width=1em]{nix.png}}\end{figure}

Les actions sont utiles si vous voulez exécuter fréquemment une application externe ou charger une page web basée sur une ou plusieurs valeurs de votre couche vecteur. Il en existe 6 types  qui peuvent être utilisés de la sorte :
\begin{itemize}
\item {} 
Les actions Générique, Mac, Windows et Unix lancent un processus externe,

\item {} 
Les actions Python lancent un code python,

\item {} 
Les actions Générique et Python sont disponibles quel que soit le système d'exploitation,

\item {} 
Les actions Mac, Windows et Unix sont disponibles uniquement depuis les systèmes d'exploitation correspondants (c'est à dire que vous pouvez définir trois actions `Editer' qui ouvrent un éditeur et les utilisateurs ne verront que l'action correspondant à leur système d'exploitation).

\end{itemize}

Quelques exemples d'actions sont fournis. Vous pouvez les charger en cliquant sur \textbf{{[}Ajouter les actions par défaut{]}}. Un des exemples effectue une recherche basée sur la valeur d'un attribut. C'est ce qui est développé par la suite.

\index{Actions}\index{Attribute\_Actions}
\textbf{Définir des actions}

Les actions sur les attributs sont définies dans la fenêtre \emph{Propriétés de la couche}. Pour \index{définir une action}définir une action, ouvrez la fenêtre \emph{Propriétés de la couche} et cliquez sur l'onglet \emph{Actions}. Sélectionnez le type `Générique' et renseignez un nom pour l'action. L'action elle-même doit contenir le nom de l'application qui sera exécutée quand l'action sera lancée. Vous pouvez ajouter un ou plusieurs champs d'attributs comme argument pour l'application. Quand l'action est invoquée n'importe quelle chaîne de caractère précédée de \code{\%} et correspondant au nom d'un champ sera remplacé par la valeur de ce champ. Le caractère spécial \index{\%\%}\%\% sera remplacé par la valeur d'un champ qui a été sélectionné par le résultat d'un Identifier ou dans la table d'attributs (voir {\hyperref[docs/user_manual/working_with_vector/vector_properties:using-actions]{using\_actions}}, ci-dessous). Des guillemets peuvent être utilisés pour grouper du texte en un seul argument pour le programme, le script ou la commande. Les guillemets seront ignorés s'ils sont précédés d'un antislash.

Si vous avez des noms de champs qui sont contenus dans d'autres noms de champs (par exemple, \code{col1} et \code{col10}), vous devez l'indiquer en entourant le nom de champ (le caractère \%) par des crochets (par exemple \code{{[}\%col10{]}}). Ceci évitera de prendre le nom de champ \code{\%col10} pour \code{\%col1} avec un \code{0} à la fin. Les crochets seront retirés quand QGIS substituera le nom par la valeur du champ. Si vous voulez que le champ à substituer soit entouré de crochets, utilisez un deuxième jeu de crochets comme ici : \code{{[}{[}\%col10{]}{]}}.

En utilisant l'outil \emph{Identifier les entités}, vous ouvrez la fenêtre \emph{Résultats identifiés}. Elle inclut une entrée \emph{(Dérivé)} qui contient des informations pertinentes selon le type de couche. Les valeurs de cette entrée sont accessibles de la même manière que les autres champs en ajoutant \code{(Derived).} avant le nom du champ. Par exemple, une couche de points a un champ \code{X} et \code{Y} et leur valeur peut être utilisée dans l'action avec \code{\%(Derived).X} et \code{\%(Derived).Y}. Les attributs dérivés sont disponibles uniquement depuis la fenêtre \emph{Résultats identifiés} et pas la \emph{Table d'attributs}.

Deux \index{exemples d'action}exemples d'action sont proposés ci-dessous :
\begin{itemize}
\item {} 
\code{konqueror http://www.google.com/search?q=\%nam}

\item {} 
\code{konqueror http://www.google.com/search?q=\%\%}

\end{itemize}

Dans le premier exemple, le navigateur internet konqueror est lancé avec une URL. L'URL effectue une recherche Google sur la valeur du champ \code{nam} de la couche vecteur. Notez que l'application ou le script appelé par l'action doit être dans le path sinon vous devez fournir le chemin complet vers l'application. Pour être certain, nous pouvons réécrire le premier exemple de cette manière : \code{/opt/kde3/bin/konqueror http://www.google.com/search?q=\%nam}. Ceci assurera que l'application konqueror sera exécutée quand l'action sera invoquée.

Le deuxième exemple utilise la notation \%\% dont la valeur ne dépend pas d'un champ en particulier. Quand l'action est invoquée, \%\% sera remplacé par la valeur du champ sélectionné dans les résultats de l'identification ou dans la table d'attributs.
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:using-actions}
\textbf{Utiliser les actions}

Les actions se lancent depuis la fenêtre \emph{Résultats identifiés}, depuis la \emph{Table d'attributs} ou depuis  \emph{Exécuter l'action de l'entité} (rappelez-vous que ces fenêtres s'ouvrent en cliquant sur \includegraphics[width=1.5em]{mActionIdentify.png} $^{\text{Identifier les entités}}$, \includegraphics[width=1.5em]{mActionOpenTable.png} $^{\text{Ouvrir la table d'attributs}}$ ou \includegraphics[width=1.5em]{mAction.png} $^{\text{Exécuter l'action de l'entité}}$). Pour lancer une action, faites un clic droit sur un enregistrement et choisissez l'action depuis le menu qui apparaît. Les actions sont listées dans le menu par le nom que vous leur avez donné en les définissant. Cliquez ensuite sur l'action que vous souhaitez lancer.

Si vous invoquez une action qui utilise la notation \%\%, faites un clic droit sur la valeur du champ que vous souhaitez passer en argument à l'application ou au script dans la fenêtre \emph{Résultats identifiés} ou la \emph{Table d'attributs}.

Voici un autre exemple qui récupère des données d'une couche vecteur et qui les insère dans un fichier utilisant bash et la commande \code{echo} (cela ne marchera que sur \includegraphics[width=1em]{nix.png} et peut-être \includegraphics[width=1em]{osx.png}). La couche en question a des champs pour le nom d'espèce \code{taxon\_name}, la latitude \code{lat} et la longitude \code{long}. Je souhaiterais faire une sélection spatiale de localisations et exporter les valeurs des enregistrements sélectionnés dans un fichier texte (ils apparaissent en jaune sur la carte dans QGIS). Voici l'action qui permettra de le faire :

\begin{Verbatim}[commandchars=\\\{\}]
bash -c "echo \PYGZbs{}"\%taxon\_name \%lat \%long\PYGZbs{}" \textgreater{}\textgreater{} /tmp/species\_localities.txt"
\end{Verbatim}

Après avoir sélectionné quelques localités et lancé l'action sur chacune, le fichier de destination ressemblera à ça :

\begin{Verbatim}[commandchars=\\\{\}]
Acacia mearnsii -34.0800000000 150.0800000000
Acacia mearnsii -34.9000000000 150.1200000000
Acacia mearnsii -35.2200000000 149.9300000000
Acacia mearnsii -32.2700000000 150.4100000000
\end{Verbatim}

Comme exercice, nous allons créer une action qui réalise une recherche Google sur la couche \code{lakes}. Tout d'abord, nous avons besoin de déterminer l'URL nécessaire pour effectuer une recherche sur un mot clé. Il suffit simplement d'aller sur Google et faire une recherche simple puis récupérer l'URL dans la barre d'adresse de votre navigateur. De cela, nous en déduisons la formulation : \href{http://google.com/search?q=qgis}{http://google.com/search?q=qgis}, où \code{qgis} est le terme recherché. À partir de tout cela, nous pouvons poursuivre :
\begin{enumerate}
\item {} 
Assurez-vous que la couche \code{lakes} est chargée.

\item {} 
Ouvrez la fenêtre \emph{Propriétés de la couche} en double cliquant sur la couche dans la légende ou en faisant un clic droit et en choisissant \emph{Propriétés} dans le menu qui apparaît.

\item {} 
Cliquez sur l'onglet \emph{Actions}.

\item {} 
Entrez un nom pour l'action, par exemple \code{Recherche Google}.

\item {} 
Pour l'action, nous devons fournir le nom du programme externe à lancer. Dans ce cas, nous allons utiliser Firefox. Si le programme n'est pas dans votre path, vous devez fournir le chemin complet.

\item {} 
A la suite du nom de l'application externe, ajoutez l'URL utilisée pour faire la recherche Google, jusqu'au terme de recherche, mais sans l'ajouter : \code{http://google.com/search?q=}

\item {} 
Le texte dans le champ \emph{Action} devrait ressembler à ça : \code{firefox http://google.com/search?q=}

\item {} 
Cliquez sur le menu déroulant contenant les noms des champs pour la couche \code{lakes}. Il est situé juste à gauche du bouton \textbf{{[}Insérer un champ{]}}.

\item {} 
Dans le menu déroulant, \includegraphics{selectstring.png} sélectionnez `NAMES' et cliquez sur \textbf{{[}Insérer un champ{]}}.

\item {} 
Le texte de votre action devrait maintenant ressembler à ça : \code{firefox http://google.com/search?q=\%NAMES}

\item {} 
Pour finaliser l'action, cliquez sur le bouton \textbf{{[}Insérer une action{]}}.

\end{enumerate}

L'action est donc entièrement définie et prête à être utilisée. Le texte final de l'action devrait correspondre à ça :
\begin{quote}

\code{firefox http://google.com/search?q=\%NAMES}
\end{quote}

Nous pouvons maintenant utiliser l'action. Fermez la fenêtre \emph{Propriétés de la couche} et zoomez sur une zone d'intérêt. Assurez-vous que la couche \code{lakes} est active puis identifiez un lac. Dans la fenêtre de résultats, vous constatez que notre action est maintenant visible :
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-actions-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=15em]{action_identifyaction.png}
\caption{Select feature and choose action \includegraphics[width=1em]{nix.png}}\end{figure}

Quand vous cliquez sur l'action, cela ouvre Firefox et charge l'URL \href{http://www.google.com/search?q=Tustumena}{http://www.google.com/search?q=Tustumena}. Il est également possible d'ajouter d'autres champs attributs à l'action. Pour faire cela, vous pouvez ajouter un \code{+} à la fin du texte de l'action, sélectionnez un autre champ et cliquez sur \textbf{{[}Insérer un champ{]}}. Dans cet exemple, la recherche sur un autre champ n'aurait pas de sens.

Vous pouvez définir de multiples actions pour une couche et chacune apparaitra dans la fenêtre \emph{Résultats identifiés}.

Vous pouvez imaginer toute sorte d'utilisations pour ces actions. Par exemple, si vous avez une couche de points contenant la localisation d'images ou de photos ainsi qu'un nom de fichier, vous pouvez créer une action qui lancera un visualisateur pour afficher les images. Vous pouvez également utiliser les actions pour lancer des rapports sur internet pour un champ attributaire ou une combinaison de champs, en les spécifiant de la même manière que dans l'exemple d'une recherche Google.

Nous pouvons également fournir des exemples plus complexes, notammnent sur la manière d'utiliser des actions \textbf{Python}.

D'ordinaire lorsque l'on crée une action pour ouvrir un fichier avec une application externe, on peut utiliser un chemin absolu ou relatif. Dans ce dernier cas, le chemin dépend donc de l'emplacement du fichier d'exécution du programme externe. Mais si nous souhaitons utiliser des chemins relatifs à la couche sélectionnée (stockée sous forme de fichier comme un shapefile ou une base spatialite) ? Le code suivant permet de le faire :

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{n}{command} \PYG{o}{=} \PYG{l+s}{\PYGZdq{}}\PYG{l+s}{firefox}\PYG{l+s}{\PYGZdq{}}\PYG{p}{;}
\PYG{n}{imagerelpath} \PYG{o}{=} \PYG{l+s}{\PYGZdq{}}\PYG{l+s}{images\PYGZus{}test/test\PYGZus{}image.jpg}\PYG{l+s}{\PYGZdq{}}\PYG{p}{;}
\PYG{n}{layer} \PYG{o}{=} \PYG{n}{qgis}\PYG{o}{.}\PYG{n}{utils}\PYG{o}{.}\PYG{n}{iface}\PYG{o}{.}\PYG{n}{activeLayer}\PYG{p}{(}\PYG{p}{)}\PYG{p}{;}
\PYG{k+kn}{import} \PYG{n+nn}{os.path}\PYG{p}{;}
\PYG{n}{layerpath} \PYG{o}{=} \PYG{n}{layer}\PYG{o}{.}\PYG{n}{source}\PYG{p}{(}\PYG{p}{)} \PYG{k}{if} \PYG{n}{layer}\PYG{o}{.}\PYG{n}{providerType}\PYG{p}{(}\PYG{p}{)} \PYG{o}{==} \PYG{l+s}{\PYGZsq{}}\PYG{l+s}{ogr}\PYG{l+s}{\PYGZsq{}} \PYG{k}{else} \PYGZbs{}
\PYG{p}{(}\PYG{n}{qgis}\PYG{o}{.}\PYG{n}{core}\PYG{o}{.}\PYG{n}{QgsDataSourceURI}\PYG{p}{(}\PYG{n}{layer}\PYG{o}{.}\PYG{n}{source}\PYG{p}{(}\PYG{p}{)}\PYG{p}{)}\PYG{o}{.}\PYG{n}{database}\PYG{p}{(}\PYG{p}{)} \PYGZbs{}
\PYG{k}{if} \PYG{n}{layer}\PYG{o}{.}\PYG{n}{providerType}\PYG{p}{(}\PYG{p}{)} \PYG{o}{==} \PYG{l+s}{\PYGZsq{}}\PYG{l+s}{spatialite}\PYG{l+s}{\PYGZsq{}} \PYG{k}{else} \PYG{n+nb+bp}{None}\PYG{p}{)}\PYG{p}{;}
\PYG{n}{path} \PYG{o}{=} \PYG{n}{os}\PYG{o}{.}\PYG{n}{path}\PYG{o}{.}\PYG{n}{dirname}\PYG{p}{(}\PYG{n+nb}{str}\PYG{p}{(}\PYG{n}{layerpath}\PYG{p}{)}\PYG{p}{)}\PYG{p}{;}
\PYG{n}{image} \PYG{o}{=} \PYG{n}{os}\PYG{o}{.}\PYG{n}{path}\PYG{o}{.}\PYG{n}{join}\PYG{p}{(}\PYG{n}{path}\PYG{p}{,}\PYG{n}{imagerelpath}\PYG{p}{)}\PYG{p}{;}
\PYG{k+kn}{import} \PYG{n+nn}{subprocess}\PYG{p}{;}
\PYG{n}{subprocess}\PYG{o}{.}\PYG{n}{Popen}\PYG{p}{(} \PYG{p}{[}\PYG{n}{command}\PYG{p}{,} \PYG{n}{image} \PYG{p}{]} \PYG{p}{)}\PYG{p}{;}
\end{Verbatim}

Il faut simplement se rappeler qu'il s'agit d'une action \emph{Python} et qu'il faut modifier les variables \emph{command} et \emph{imagerelpath} selon vos besoins.

Et si le chemin relatif doit dépendre du fichier de projet (sauvegardé) ? Le code de l'action Python deviendra :

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{n}{command}\PYG{o}{=}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{firefox}\PYG{l+s}{\PYGZdq{}}\PYG{p}{;}
\PYG{n}{imagerelpath}\PYG{o}{=}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{images/test\PYGZus{}image.jpg}\PYG{l+s}{\PYGZdq{}}\PYG{p}{;}
\PYG{n}{projectpath}\PYG{o}{=}\PYG{n}{qgis}\PYG{o}{.}\PYG{n}{core}\PYG{o}{.}\PYG{n}{QgsProject}\PYG{o}{.}\PYG{n}{instance}\PYG{p}{(}\PYG{p}{)}\PYG{o}{.}\PYG{n}{fileName}\PYG{p}{(}\PYG{p}{)}\PYG{p}{;}
\PYG{k+kn}{import} \PYG{n+nn}{os.path}\PYG{p}{;} \PYG{n}{path}\PYG{o}{=}\PYG{n}{os}\PYG{o}{.}\PYG{n}{path}\PYG{o}{.}\PYG{n}{dirname}\PYG{p}{(}\PYG{n+nb}{str}\PYG{p}{(}\PYG{n}{projectpath}\PYG{p}{)}\PYG{p}{)} \PYGZbs{}
\PYG{k}{if} \PYG{n}{projectpath} \PYG{o}{!=} \PYG{l+s}{\PYGZsq{}}\PYG{l+s}{\PYGZsq{}} \PYG{k}{else} \PYG{n+nb+bp}{None}\PYG{p}{;}
\PYG{n}{image}\PYG{o}{=}\PYG{n}{os}\PYG{o}{.}\PYG{n}{path}\PYG{o}{.}\PYG{n}{join}\PYG{p}{(}\PYG{n}{path}\PYG{p}{,} \PYG{n}{imagerelpath}\PYG{p}{)}\PYG{p}{;}
\PYG{k+kn}{import} \PYG{n+nn}{subprocess}\PYG{p}{;}
\PYG{n}{subprocess}\PYG{o}{.}\PYG{n}{Popen}\PYG{p}{(} \PYG{p}{[}\PYG{n}{command}\PYG{p}{,} \PYG{n}{image} \PYG{p}{]} \PYG{p}{)}\PYG{p}{;}
\end{Verbatim}

Un autre exemple d'action Python consiste à ajouter de nouvelles couche au projet. L'exemple qui suit montre comment ajouter une couche vecteur et un raster. Les noms des fichiers à ajouter au projet et les noms à donner aux couches dépendent de données attributaires (\emph{filename} et \emph{layname} sont deux champs de la table attributaire de la couche sur laquelle l'action est créée) :

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{n}{qgis}\PYG{o}{.}\PYG{n}{utils}\PYG{o}{.}\PYG{n}{iface}\PYG{o}{.}\PYG{n}{addVectorLayer}\PYG{p}{(}\PYG{l+s}{\PYGZsq{}}\PYG{l+s}{/yourpath/[}\PYG{l+s}{\PYGZpc{}}\PYG{l+s}{ }\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{filename}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{ }\PYG{l+s}{\PYGZpc{}}\PYG{l+s}{].shp}\PYG{l+s}{\PYGZsq{}}\PYG{p}{,}\PYG{l+s}{\PYGZsq{}}\PYG{l+s}{[}\PYG{l+s}{\PYGZpc{}}\PYG{l+s}{ }\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{layername}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{ }\PYG{l+s}{\PYGZpc{}}\PYG{l+s}{]}\PYG{l+s}{\PYGZsq{}}\PYG{p}{,} \PYG{l+s}{\PYGZsq{}}\PYG{l+s}{ogr}\PYG{l+s}{\PYGZsq{}}\PYG{p}{)}
\end{Verbatim}

Pour ajouter un raster (ici une image tif), cela devient :

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{n}{qgis}\PYG{o}{.}\PYG{n}{utils}\PYG{o}{.}\PYG{n}{iface}\PYG{o}{.}\PYG{n}{addRasterLayer}\PYG{p}{(}\PYG{l+s}{\PYGZsq{}}\PYG{l+s}{/yourpath/[}\PYG{l+s}{\PYGZpc{}}\PYG{l+s}{ }\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{filename}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{ }\PYG{l+s}{\PYGZpc{}}\PYG{l+s}{].tif}\PYG{l+s}{\PYGZsq{}}\PYG{p}{,}\PYG{l+s}{\PYGZsq{}}\PYG{l+s}{[}\PYG{l+s}{\PYGZpc{}}\PYG{l+s}{ }\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{layername}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{ }\PYG{l+s}{\PYGZpc{}}\PYG{l+s}{]}\PYG{l+s}{\PYGZsq{}}\PYG{p}{)}
\end{Verbatim}


\subsection{Onglet Jointure}
\label{docs/user_manual/working_with_vector/vector_properties:joins-tab}\label{docs/user_manual/working_with_vector/vector_properties:sec-joins}
\includegraphics[width=2em]{join.png} L'onglet \emph{Jointure} permet de \index{joindre une table attributaire chargée à une couche vecteur chargée}joindre une table attributaire chargée à une couche vecteur chargée. Vous devez définir une \index{couche de jointure}couche de jointure, un champ de jointure et un champ cible. QGis permet actuellement de joindre les formats de tables non spatiales supportées par OGR, les fichiers de texte délimités et les tables PostgreSQL (voir {\hyperref[docs/user_manual/working_with_vector/vector_properties:figure-joins-1]{figure\_joins\_1}}).
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-joins-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{join_attributes.png}
\caption{Join an attribute table to an existing vector layer \includegraphics[width=1em]{nix.png}}\end{figure}

De plus, la fenêtre de jointure permet de :
\begin{itemize}
\item {} 
\includegraphics{checkbox.png} \emph{Mettre la couche jointe en cache dans la mémoire virtuelle}

\item {} 
\includegraphics{checkbox.png} \emph{Créer un index des attributs joins}

\end{itemize}


\subsection{Onglet Diagrammes}
\label{docs/user_manual/working_with_vector/vector_properties:diagrams-tab}\label{docs/user_manual/working_with_vector/vector_properties:sec-diagram}
\includegraphics[width=2em]{diagram.png} L'onglet \emph{Diagrammes} permet d'ajouter une couche de graphiques sur une couche vecteur (voir {\hyperref[docs/user_manual/working_with_vector/vector_properties:figure-diagrams-1]{figure\_diagrams\_1}}).

L'implémentation actuelle des diagrammes permet de visualiser des graphiques sous forme de diagrammes circulaires ou textuels accompagnés des valeurs attributaires correspondantes. La taille du diagramme est fixe ou proportionnel à une valeur d'attribut. Le placement du diagramme interagit avec le nouveau système d'étiquetage de sorte que les conflits de placement sont détectés et résolus. La position des diagrammes peut également être modifiée manuellement.
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-diagrams-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{diagram_tab.png}
\caption{Vector properties dialog with diagram tab \includegraphics[width=1em]{nix.png}}\end{figure}

Nous allons vous montrer un exemple en superposant dans les frontières de l'Alaska des données concernant la température issues d'une couche vecteur portant sur le climat. Toutes ces couches sont disponibles dans l'échantillon de données QGIS (voir Section {\hyperref[docs/user_manual/introduction/getting_started:label-sampledata]{\emph{Échantillon de données}}}).
\begin{enumerate}
\item {} 
Cliquez sur l'icône \includegraphics[width=1.5em]{mActionAddOgrLayer.png} $^{\text{Ajouter une couche vecteur}}$, parcourez le répertoire de l'échantillon QGIS et chargez les couches \code{alaska.shp} et \code{climate.shp}.

\item {} 
Double-cliquez sur la couche \code{climate} dans la légende pour ouvrir la fenêtre de \emph{Propriétés de la Couche}.

\item {} 
Cliquez sur l'onglet de \emph{Diagrammes}, cochez \emph{Afficher les diagrammes} et choisissez `Diagramme texte' comme \emph{Type de diagramme} \includegraphics{selectstring.png}.

\item {} 
Comme couleur de fond nous choisissons un bleu clair et fixons la taille à 18 mm.

\item {} 
La position est choisie `Autour du point'.

\item {} 
Dans le diagramme, nous souhaitons afficher les valeurs de trois colonnes \code{T\_F\_JAN}, \code{T\_F\_JUL} et \code{T\_F\_MEAN}. Sélectionnez d'abord \code{T\_F\_JAN} dans la liste d'Attributs et cliquez sur le bouton vert \textbf{{[}+{]}}, de même pour \code{T\_F\_JUL} et \code{T\_F\_MEAN}.

\item {} 
Cliquez maintenant sur \textbf{{[}Appliquer{]}} pour afficher les diagrammes sur la carte.

\item {} 
Vous pouvez adapter la taille du diagramme ou changer la couleur des attributs en double-cliquant sur les couleurs dans la liste des attributs. La {\hyperref[docs/user_manual/working_with_vector/vector_properties:figure-diagrams-2]{Figure\_diagrams\_2}} donne une idées du résultat.

\item {} 
Et pour finir cliquez sur \textbf{{[}OK{]}}.

\end{enumerate}
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:figure-diagrams-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{climate_diagram.png}
\caption{Diagram from temperature data overlayed on a map \includegraphics[width=1em]{nix.png}}\end{figure}

De plus, dans la fenêtre \emph{Préférences \(\rightarrow\) Options}, l'onglet \code{Revêtement} permet de choisir l'algorithme de placement des diagrammes. La méthode `Point central' est la plus générique, les autres utilisent des algorithmes de la bibliothèque PAL. Ils permettent également de considérer les diagrammes et étiquettes des autres couches. Voir aussi la section {\hyperref[docs/user_manual/plugins/plugins_diagram_overlay:diagram-overlay]{\emph{Extension Diagramme incrusté}}} pour d'autres fonctionnalités concernant les diagrammes.


\section{Éditer}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:editing}\label{docs/user_manual/working_with_vector/editing_geometry_attributes::doc}
QGIS dispose d'un support étendu de l'\index{édition}édition de données provenant de couches vectorielles OGR, PostGIS et Spatialite.

\begin{notice}{note}{Note:}
La procédure pour éditer des couches GRASS est différente - voir Section {\hyperref[docs/user_manual/grass_integration/grass_integration:grass-digitizing]{\emph{Numérisation et édition de couche vectorielle GRASS}}} pour plus de détails.
\end{notice}
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:tip-concurrent-edits}
\begin{notice}{tip}{Astuce:}
\textbf{Éditions concurrentes}

Cette version de QGIS ne vérifie pas si quelqu'un d'autre est en train d'éditer une entité en même temps que vous, la dernière personne qui enregistre sa modification gagne !
\end{notice}

\index{Snapping}\index{Snapping\_Tolerance}

\subsection{Définir le rayon de tolérance d'accrochage et de recherche}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:snapping-tolerance}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:setting-the-snapping-tolerance-and-search-radius}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-1}
Avant de pouvoir éditer des sommets, il est très important de fixer la tolérance d'accrochage et le rayon de recherche à des valeurs qui nous permettent d'éditer les géométries vecteur de manière optimale.


\subsubsection{Tolérance d'accrochage}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:id1}
La tolérance d'accrochage est la distance que QGIS utilise pour \code{chercher} le sommet et/ou le segment le plus près que vous souhaitez connecter lorsque vous créez un nouveau sommet ou en déplacez un existant. Si vous n'êtes pas dans la tolérance d'accrochage, QGIS va laisser le vertex à l'endroit où vous lâchez le bouton de la souris, au lieu de l'accrocher à un sommet ou un segment existant. Les paramètres de tolérance d'accrochage affectent tous les outils qui utilisent cette tolérance.
\begin{enumerate}
\item {} 
Une tolérance générale, commune à tout le projet, peut-être définie via le menu \emph{Préférences \(\rightarrow\)} \includegraphics[width=1em]{mActionOptions.png} \emph{Options}. Sur Mac via le menu \emph{QIS \(\rightarrow\)} \includegraphics[width=1em]{mActionOptions.png} \emph{Préferences...}, et sur Linux : \emph{Éditer \(\rightarrow\)} \includegraphics[width=1em]{mActionOptions.png} \emph{Options}. Dans l'onglet \emph{Numérisation}, vous pouvez choisir le mode d'accrochage par défaut : sur un sommet, sur un segment ou sur un sommet et un segment. Vous pouvez également définir une tolérance d'accrochage par défaut et un rayon de recherche pour les éditions de sommets. La tolérance peut être définie dans l'unité du projet ou en pixel, l'avantage du pixel est qu'elle n'a pas à être changée pour tenir compte des zooms. Dans notre projet de numérisation (sur le jeu de données Alaska), les unités sont en pieds. Le résultat peut varier, mais une tolérance de l'ordre de 300 pieds devrait être convenable pour une échelle de 1:10 000.

\item {} 
Une tolérance d'accrochage liée à une couche peut être définie dans \emph{Préférences \(\rightarrow\)} (ou \emph{Fichier \(\rightarrow\)}) \emph{Options d'accrochage...} pour activer et ajuster le mode d'accrochage et la tolérance pour chaque couche (voir {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:figure-edit-1]{figure\_edit\_1}}).

\end{enumerate}

Notez que l'accrochage défini pour chaque couche est prioritaire par rapport à celui défini dans les options générales. Si vous avez besoin d'éditer une couche en vous accrochant à une autre, il vous faut donc activer l'accrochage uniquement sur la couche à accrocher et réduire la tolérance générale d'accrochage à une valeur moindre. De plus, l'accrochage ne se produira jamais sur une couche dont l'accrochage n'a pas été activé, qu'importe l'option générale. Assurez-vous de cocher la case idoine sur les couches que vous voulez pouvoir utiliser.
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:figure-edit-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=40em]{editProjectSnapping.png}
\caption{Edit snapping options on a layer basis \includegraphics[width=1em]{nix.png}}\end{figure}

\index{Search\_Radius}

\subsubsection{Rayon de recherche}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:search-radius}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-2}
Le rayon de recherche est la distance que QGIS utilise pour \code{chercher} le sommet le plus proche que vous souhaitez déplacer quand vous cliquez sur la carte. Si vous n'êtes pas dans le rayon de recherche, QGIS ne trouvera ni ne sélectionnera de sommets à éditer et une fenêtre d'alerte désagréable apparaitra. La tolérance d'accrochage et le rayon de recherche sont définis en pixels ou dans les unités de la carte, vous allez peut-être avoir besoin d'expérimenter différentes valeurs avant de trouver la bonne. Si vous spécifiez une tolérance trop grande, QGIS risque d'accrocher le mauvais sommet, surtout si vous avez un grand nombre de sommets à proximité. Définissez un rayon de recherche trop petit et QGIS ne trouvera rien à déplacer.

Le rayon de recherche pour l'édition des sommets dans l'unité de la couche peut être défini dans l'onglet \emph{Numérisation} du menu \emph{Préférences \(\rightarrow\)} \includegraphics[width=1em]{mActionOptions.png} \emph{Options}. Au même endroit que vous définissez la tolérance d'accrochage pour tout le projet.

\index{Zoom\_In Zoom\_Out}\index{Pan}\index{Map\_Navigation}

\subsection{Zoomer et se déplacer}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:zooming-and-panning}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-3}
Avant d'éditer une couche, vous devriez zoomer sur la zone qui vous intéresse. Cela évite de devoir attendre que tous les sommets soient affichés sur l'ensemble de la couche au moment du passage en mode édition.

En plus d'utiliser les boutons  \includegraphics[width=1.5em]{mActionPan.png} $^{\text{Se déplacer dans la carte}}$ and \includegraphics[width=1.5em]{mActionZoomIn.png} $^{\text{zoom +}}$ / \includegraphics[width=1.5em]{mActionZoomOut.png} $^{\text{zoom -}}$ de la barre d'outils avec la souris, la navigation peut également se faire avec la roulette de la souris, la barre espace et les flèches du clavier.


\subsubsection{Zoomer et bouger avec la roulette de la souris}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:zooming-and-panning-with-the-mouse-wheel}
Lorsque vous numérisez vous pouvez appuyer sur la roulette de la souris pour vous déplacer dans la fenêtre principale et la faire rouler pour zoomer la carte. Pour vous rapprocher, placez le curseur sur la carte et faites rouler la molette vers l'avant tandis que si vous voulez vous éloigner vous devrez la faire rouler vers vous. La position du curseur sera le centre la zone affichée. Vous pouvez personnaliser le zoom via l'onglet \emph{Outils cartographiques} du menu \emph{Préférences \(\rightarrow\)} \includegraphics[width=1em]{mActionOptions.png} \emph{Options}.


\subsubsection{Se déplacer avec les touches du clavier}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:panning-with-the-arrow-keys}
Il est possible de se déplacer sur la carte en utilisant les flèches du clavier. Placez votre curseur sur la carte et appuyez sur la flèche de droite pour vous déplacer vers l'Est, la flèche de gauche pour aller à l'Ouest, la flèche du haut pour le Nord et celle du bas pour le Sud.

Vous pouvez utiliser la barre d'espace pour que les mouvements de la souris se traduisent par un déplacement sur la carte. Les touches \code{PgUp} et \code{PgDown} vous permettront de zoomer sans devoir interrompre votre numérisation.

\index{Topological\_Editing}

\subsection{Édition topologique}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-4}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:topological-editing}
En plus des options d'accrochage pour chaque couche, la fenêtre des \emph{Options d'accrochage} du menu \emph{Préférences} (ou \emph{Fichier}) propose quelques fonctionnalités topologiques. Vous pouvez \includegraphics{checkbox.png} \emph{Activer l'édition topologique} et/ou cocher la case \includegraphics{checkbox.png} \emph{Éviter Intersections} pour les couches de polygones.

\index{Shared\_Polygon\_Boundaries}

\subsubsection{Activer l'édition topologique}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-5}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:enable-topological-editing}
L'option \includegraphics{checkbox.png} \emph{Activer l'édition topologique} permet d'éditer en gardant des limites communes entre les polygones. QGIS `détecte' une limite commune entre les polygones, vous avez simplement à déplacer le sommet commun et QGIS s'occupera de mettre à jour toutes les limites.

\index{Avoid\_Intersections\_Of\_Polygons}

\subsubsection{Éviter les intersections de nouveaux polygones}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:avoid-intersections-of-new-polygons}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-6}
La deuxième option topologique, \includegraphics{checkbox.png} \emph{Éviter Intersections}, permet d'éviter des recouvrements entre les polygones. Cela permet de numériser des polygones adjacents plus rapidement. Si vous avez déjà un polygone, avec cette option, vous pouvez numériser le second de manière à ce qu'ils intersectent et QGIS coupera le second polygone aux limites communes. L'avantage est que les utilisateurs n'ont pas à numériser tous les sommets des limites communes.

\index{Digitizing}

\subsection{Numériser une couche existante}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:digitizing-an-existing-layer}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:sec-edit-existing-layer}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-7}
Par défaut, QGIS charge les couches en lecture seule : c'est une sécurité pour éviter d'éditer accidentellement une couche si la souris glisse. Cependant, vous pouvez choisir d'éditer une couche du moment que le fournisseur de données le gère et que la source de données est éditable (c.-à-d. fichiers qui ne sont pas en lecture seule). L'édition d'une couche est plus flexible lorsqu'il s'agit de sources de données PostgreSQL/PostGIS.

L'édition des couches vectorielles est répartie dans les barres de numérisation et de numérisation avancée telles que décrites dans la section {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Numérisation avancée}}}. Vous pouvez afficher les deux depuis le menu \emph{Préférences \(\rightarrow\) Barres d'Outils \(\rightarrow\)}. En utilisant les outils basiques de numérisation, vous pouvez accomplir les actions suivantes :
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:table-editing}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Bouton
} & \textsf{\relax 
Fonction
} & \textsf{\relax 
Bouton
} & \textsf{\relax 
Fonction
}\\
\hline
\includegraphics[width=1.5em]{mActionToggleEditing.png}
 & 
Basculer en mode édition
 & 
\includegraphics[width=1.5em]{mActionCapturePoint.png}
 & 
Ajouter une entité : Créer un point
\\

\includegraphics[width=1.5em]{mActionCaptureLine.png}
 & 
Ajouter une entité : Créer une Ligne
 & 
\includegraphics[width=1.5em]{mActionCapturePolygon.png}
 & 
Ajouter une entité: Créer un polygone
\\

\includegraphics[width=1.5em]{mActionMoveFeature.png}
 & 
Déplacer une entité
 & 
\includegraphics[width=1.5em]{mActionNodeTool.png}
 & 
Outil de noeud
\\

\includegraphics[width=1.5em]{mActionDeleteSelected.png}
 & 
Supprimer les entités sélectionnées
 & 
\includegraphics[width=1.5em]{mActionEditCut.png}
 & 
Couper les entités
\\

\includegraphics[width=1.5em]{mActionEditCopy.png}
 & 
Copier les entités
 & 
\includegraphics[width=1.5em]{mActionEditPaste.png}
 & 
Coller les entités
\\

\includegraphics[width=1.5em]{mActionFileSave.png}
 & 
Sauvegarder les modifications et continuer
 &  & \\
\hline\end{tabulary}

\begin{quote}

Tableau Numérisation : barre d'outils basiques de numérisation pour les couches vectorielles
\end{quote}

Toutes les sessions d'édition débutent par \includegraphics[width=1.5em]{mActionToggleEditing.png} $^{\text{Basculer en mode édition}}$ qui se trouve dans le menu contextuel après un clic droit sur le nom de la couche à éditer.

Alternativement, vous pouvez utiliser le bouton \index{Basculer en mode édition}Basculer en mode édition \includegraphics[width=1.5em]{mActionToggleEditing.png} $^{\text{Basculer en mode édition}}$ dans la barre de numérisation pour débuter ou terminer une session d'édition. Une fois que la couche est éditable, des marqueurs vont apparaître sur les sommets et de nouveaux outils seront disponibles dans la barre d'outils de numérisation.
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:tip-save-regularly}
\begin{notice}{tip}{Astuce:}
\textbf{Sauvegardez régulièrement}

N'oubliez pas de cliquer sur \includegraphics[width=1.5em]{mActionFileSave.png} $^{\text{Sauvegarder les modifications}}$ régulièrement. Cela vous permet de sauvegarder les changements récents, mais également de confirmer que votre source de données accepte tous vos changements.
\end{notice}


\subsubsection{Ajouter des entités}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:adding-features}
Vous pouvez utiliser le bouton \includegraphics[width=1.5em]{mActionCapturePoint.png} $^{\text{Ajouter un point}}$, \includegraphics[width=1.5em]{mActionCaptureLine.png} $^{\text{Ajouter une ligne}}$ ou \includegraphics[width=1.5em]{mActionCapturePolygon.png} $^{\text{Ajouter un polygone}}$ de la barre d'outils pour mettre le curseur de QGIS en mode numérisation.

Pour chaque entité, vous numérisez d'abord la géométrie puis entrez les attributs. Pour numériser la géométrie, faites un clic gauche sur la zone de la carte pour créer le premier point de votre nouvelle entité.

Pour les lignes ou les polygones, continuer à faire des clics gauche pour chaque nouveau point que vous souhaitez créer. Lorsque vous avez fini d'ajouter des points, faites un clic droit n'importe où sur la carte pour confirmer que vous avez fini d'entrer la géométrie de cette entité.

La fenêtre des attributs apparaît, ce qui vous permet d'entrer les informations sur la nouvelle entité. La figure {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:figure-edit-2]{Figure\_edit\_2}} montre les attributs d'édition pour une nouvelle rivière fictive en Alaska. Dans l'onglet \emph{Numérisation} du menu \emph{Préférences \(\rightarrow\) Options}, vous pouvez cocher les cases \includegraphics{checkbox.png} \emph{Supprimer la fenêtre de saisie des attributs lors de la création de chaque entité} et \includegraphics{checkbox.png} \emph{Réutiliser la dernière valeur attributaire saisie}.
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:figure-edit-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{editDigitizing.png}
\caption{Enter Attribute Values Dialog after digitizing a new vector
feature \includegraphics[width=1em]{nix.png}}\end{figure}

Avec le bouton \includegraphics[width=1.5em]{mActionMoveFeature.png} $^{\text{Déplacer l'entité}}$, vous pouvez déplacer des entités existantes.
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:tip-attributes-types}
\begin{notice}{tip}{Astuce:}
\textbf{Types des valeurs d'attribut}

Pour l'édition des shapefiles au moins, les types des attributs sont validés au moment de la saisie. Il n'est donc pas possible d'entrer un nombre dans un champ de type texte depuis la fenêtre \emph{Entrez les valeurs d'attributs} et vice-versa. Si vous avez besoin de le faire, vous devez éditer les attributs par la suite dans la \emph{Table d'attributs}.
\end{notice}

\index{Node\_Tool}

\subsubsection{Outil de noeud}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-9}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:node-tool}
Pour les couches PostgreSQL/PostGIS et shapefile, l'\includegraphics[width=1.5em]{mActionNodeTool.png} $^{\text{Outil de nœud}}$ offre des capacités de manipulation des sommets des entités semblables à celles des logiciels de CAO. Il est possible de sélectionner plusieurs sommets ensemble et de les déplacer, ajouter ou supprimer en une fois. Cet outil fonctionne sur les couches reprojetées `à la volée' et supporte des fonctionnalités d'éditions topologiques. Contrairement aux autres outils de Quantum GIS, la sélection persiste même lorsque une autre opération est effectuée. Si l'outil de nœud ne trouve pas d'entités, un avertissement sera affiché.

Il est important de fixer le paramètre \emph{Préférences \(\rightarrow\)} \includegraphics[width=1em]{mActionOptions.png} \emph{Options \(\rightarrow\) Numérisation \(\rightarrow\)} \emph{Rayon de recherche :} \includegraphics{selectnumber.png} à un nombre supérieur à zéro (par exemple 10). Sinon QGIS ne sera pas en mesure de dire quelle entité est éditée.
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:tip-vertex-markers}
\begin{notice}{tip}{Astuce:}
\textbf{Marqueurs de sommets}

La version actuelle de QGIS présente 3 types de marqueurs - un cercle semi-transparent, une croix ou aucun. Pour changer de style de marqueurs, allez dans \includegraphics[width=1em]{mActionOptions.png} \emph{Options} depuis le menu \emph{Préférences} et cliquez sur l'onget \emph{Numérisation} et sélectionnez le symbole voulu dans la liste déroulante.
\end{notice}


\subsubsection{Opérations basiques}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:basic-operations}
\index{Nodes}\index{Vertices}\index{Vertex}
Commencez par cliquer sur le bouton \includegraphics[width=1.5em]{mActionNodeTool.png} $^{\text{Outil de nœud}}$ puis sélectionnez une entité. Des petits carrés rouges aparraissent sur chaque sommet de cette entité, cela indique qu'elle est bien sélectionnée.
\begin{itemize}
\item {} 
\textbf{Sélectionner des sommets} : La sélection se fait en cliquant directement sur un sommet, sur un segment pour en sélectionner les deux extrémités ou en dessinant un rectangle autour de quelques sommets. Quand un sommet est sélectionné, sa couleur devient bleu. Pour ajouter des sommet à une sélection, maintenez appuyée la touche \code{Ctrl} et continuez la sélection.  Maintenez \code{Ctrl} ou \code{Shift} appuyé en cliquant pour inverser l'état sélectionné ou désélectionné des sommets (les sommets non sélectionnés le deviendront et ceux qui l'étaient seront désélectionnés).

\item {} 
\textbf{Ajouter des sommets} : Pour ajouter un sommet, double-cliquez simplement sur un segment, un nouveau sommet apparaîtra sur le segement proche du curseur. Notez que le sommet est créé sur le segment et pas forcément exactement à l'emplacement du curseur, il est donc peut-être nécessaire de le déplacer.

\item {} 
\textbf{Supprimer des sommets} : Après avoir sélectionné les sommets à supprimer, appuyez sur la touche \code{Suppr} de votre clavier. Notez que vous ne pouvez pas utiliser l' \includegraphics[width=1.5em]{mActionNodeTool.png} $^{\text{Outil de noeud}}$ pour supprimer complètement une entité : QGIS s'assure qu'il reste le nombre minimal de sommets selon le tye d'entité. Pour supprimer une entité, utilisez l'outil \includegraphics[width=1.5em]{mActionDeleteSelected.png} $^{\text{Supprimer les entités sélectionnées}}$.

\item {} 
\textbf{Déplacer des sommets} : Sélectionnez tous les sommets que vous voulez déplacer (encliquant sur un sommet ou un segment), puis bougez votre souris en gardant le bouton appuyé. Tous les sommets bougeront dans la même direction que le curseur. Si l'accrochage est activé, la sélection complète peut sauter sur la ligne ou le sommet le plus proche du curseur.

\end{itemize}

Chaque changement effectué avec l'outil de noeud correspond à une entrée séparée du bouton Annuler. Rappelez-vous que toutes les manipulations supportent l'édition topologique, si elle est activée. La projection à la volée est également supportée. Enfin, l'outil de noeud affiche une info-bulle au passage de la souris sur un sommetafin de l'identifier.


\subsubsection{Couper, Copier et Coller des entités}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:cutting-copying-and-pasting-features}
Les entités sélectionnées peuvent être coupées, copiées et collées entre des couches d'un même projet QGIS, du moment que les couches de destination sont \includegraphics[width=1.5em]{mActionToggleEditing.png} $^{\text{Basculées en mode édition}}$ au préalable.

\index{CSV}\index{WKT}
Les entités peuvent également être collées dans des applications externes au format texte. Les entités sont alors représentées au format CSV et leur géométrie apparaît dans le format OGC Well-Known Text (WKT).

Cependant, dans cette version de QGIS, les entités au format texte venant d'applications externes ne peuvent pas être collées à une couche dans QGIS. En quoi les fonctions copier et coller sont-elles utiles ? Et bien il se trouve que vous pouvez éditer plus d'une couche à la fois et que vous pouvez alors utiliser les fonctions copier/coller entre les couches. Pourquoi voudrions-nous faire cela ? Imaginons que nous devions travailler sur une nouvelle couche, mais que nous avions besoin que d'un ou deux lacs, pas les 5 000 de notre couche \code{big\_lakes}. Nous pouvons créer une nouvelle couche puis utiliser copier/coller pour y insérer les quelques lacs.

Voici un exemple de copie de quelques lacs dans une nouvelle couche :
\begin{enumerate}
\item {} 
Chargez la couche dont vous voulez copier des entités (couche source)

\item {} 
Chargez ou créez la couche sur laquelle vous voulez coller des entités (couche cible)

\item {} 
Lancez l'édition pour la couche cible

\item {} 
Assurez-vous que la couche source est active en cliquant dessus dans la légende

\item {} 
Utilisez l'outil \includegraphics[width=1.5em]{mActionSelect.png} $^{\text{Sélection}}$ pour sélectionner les entités dans la couche source

\item {} 
Cliquez sur l'outil \includegraphics[width=1.5em]{mActionEditCopy.png} $^{\text{Copier les entités}}$

\item {} 
Assurez-vous que la couche cible est active en cliquant dessus dans la légende

\item {} 
Cliquez sur l'outil \includegraphics[width=1.5em]{mActionEditPaste.png} $^{\text{Coller Entités}}$

\item {} 
Stoppez l'édition et sauvegardez les changements

\end{enumerate}

Qu'arrive-t-il si les couches sources et cibles ont différents schémas de données (noms et type des champs différents) ? QGIS remplit ceux qui correspondent et ignore les autres. Si la copie des attributs ne vous intéresse pas, la façon dont vous designez les champs et les types de données n'a pas d'importance. Si vous voulez être sûr que tout - entité et ses attributs - est copié, assurez-vous que les schémas de données correspondent.
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:tip-projections-and-pasting}
\begin{notice}{tip}{Astuce:}
\textbf{Conformité des entités copiées}

Si vos couches source et cible utilisent la même projection, les entités collées auront la même géométrie que dans la couche source. Cependant, si la couche cible n'a pas la même projection, QGIS ne peut garantir que les géométries seront identiques. Cela est simplement dû aux erreurs d'arrondissement faites lors de la conversion de projection.
\end{notice}


\subsubsection{Supprimer les entités sélectionnées}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:deleting-selected-features}
Si nous voulons supprimer un polygone entier, nous pouvons le faire en sélectionnant d'abord le polygone en utilisant l'outil \includegraphics[width=1.5em]{mActionSelect.png} $^{\text{Sélectionner une entité}}$. Vous pouvez sélectionner plusieurs objets pour la suppression. Une fois le ou les objets sélectionnés, utilisez l'outil \includegraphics[width=1.5em]{mActionDeleteSelected.png} $^{\text{Supprimer les entités sélectionnées}}$ pour supprimer les entités.

L'outil \includegraphics[width=1.5em]{mActionEditCut.png} $^{\text{Couper les entités}}$ de la barre d'outils numérisation peut également être utilisé pour supprimer des entités. Ceci supprime effectivement les entités et les place également dans un ``presse-papier spatial''. Donc nous coupons les entités pour les supprimer et nous pouvons ensuite utiliser l'outil \includegraphics[width=1.5em]{mActionEditPaste.png} $^{\text{Coller les entités}}$ pour les récupérer, nous donnant alors la capacité d'annuler une fois les changements. Couper, copier et coller fonctionnent sur les entités sélectionnées ce qui signifie que nous pouvons travailler sur plus d'un objet à la fois.
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:tip-deleting-features}
\begin{notice}{tip}{Astuce:}
\textbf{Gestion de la suppression d'entités}

Lors de l'édition de shapefile, la suppression d'entités ne fonctionne que si QGIS est lié à une version 1.3.2 ou supérieure de GDAL. Les versions OS X et Windows de QGIS disponibles depuis le site de téléchargement incluent GDAL 1.3.2 ou supérieur.
\end{notice}


\subsubsection{Sauvegarder les couches éditées}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:saving-edited-layers}
Quand une couche est en mode édition, tous les changements sont stockés en mémoire par QGIS. Ils ne sont pas sauvegardés immédiatement dans la source de données ou sur le disque. Si vous voulez enregistrer les modifications sans quitter le mode d'édition, il faut cliquer sur le bouton \includegraphics[width=1.5em]{mActionFileSave.png} $^{\text{Sauvegarder les modifications}}$. Lorsque vous déactivez le mode édition en cliquant sur \includegraphics[width=1.5em]{mActionToggleEditing.png} $^{\text{Basculer en mode édition}}$ (ou en fermant QGIS), il vous est demandé si vous souhaitez sauvegarder les changements ou les annuler.

Si les changements ne peuvent pas être sauvés (par exemple à cause d'un disque plein ou des valeurs d'attributs dépassant la plage prévue), l'état de la mémoire de QGIS est préservé. Cela vous permet d'ajuster vos éditions et réessayer.
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:tip-data-integrity}
\begin{notice}{tip}{Astuce:}
\textbf{Intégrité des données}

Il est toujours bon de sauvegarder vos données sources avant de les éditer. Bien que les auteurs de QGIS s'efforcent de préserver l'intégrité de vos données, il n'y pas de garantie à cet égard.
\end{notice}


\subsection{Numérisation avancée}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:advanced-digitizing}



\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:table-advanced-editing}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Bouton
} & \textsf{\relax 
Fonction
} & \textsf{\relax 
Bouton
} & \textsf{\relax 
Fonction
}\\
\hline
\includegraphics[width=1.5em]{mActionUndo.png}
 & 
Annuler
 & 
\includegraphics[width=1.5em]{mActionRedo.png}
 & 
Refaire
\\

\includegraphics[width=2em]{mActionSimplify.png}
 & 
Simplifier Entité
 & 
\includegraphics[width=2em]{mActionAddRing.png}
 & 
Ajouter un anneau
\\

\includegraphics[width=2em]{mActionAddIsland.png}
 & 
Ajouter une partie
 & 
\includegraphics[width=2em]{mActionDeleteRing.png}
 & 
Effacer un anneau
\\

\includegraphics[width=2em]{mActionDeletePart.png}
 & 
Effacer une partie
 & 
\includegraphics[width=1.5em]{mActionReshape.png}
 & 
Remodeler les  entités
\\

\includegraphics[width=1.5em]{mActionOffsetCurve.png}
 & 
Décalage X,Y
 & 
\includegraphics[width=1.5em]{mActionSplitFeatures.png}
 & 
Séparer les entités
\\

\includegraphics[width=1.5em]{mActionMergeFeatures.png}
 & 
Fusionner les entités sélectionnées
 & 
\includegraphics[width=1.5em]{mActionRotatePointSymbols.png}
 & 
Rotation des symboles de point
\\

\includegraphics[width=1.5em]{mActionMergeFeatures.png}
 & 
Fusionner les attributs des entités sélectionnées
 &  & \\
\hline\end{tabulary}

\begin{quote}

Tableau Numérisation avancée : barre d'outils de numérisation avancée pour les couches vectorielles
\end{quote}


\subsubsection{Annuler et refaire}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:undo-and-redo}
Les outils \includegraphics[width=1.5em]{mActionUndo.png} $^{\text{Annuler}}$ et \includegraphics[width=1.5em]{mActionRedo.png} $^{\text{Refaire}}$ permettent à l'utilisateur d'annuler ou revenir sur un certain nombre d'opérations sur les données vectorielless. La vue de base est une fenêtre où toutes les opérations sont répertoriées (voir {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:figure-edit-3]{Figure\_edit\_3}}). Cette fenêtre n'est pas affichée par défaut, mais peut être affichée par un clic droit sur une barre d'outils puis en cochant Annuler/Refaire L'outil est actif même quand la fenêtre n'est pas visible.
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:figure-edit-3}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=15em]{redo_undo.png}
\caption{Redo and Undo digitizing steps \includegraphics[width=1em]{nix.png}}\end{figure}

Quand on clique sur Annuler, l'état de toutes les entitéset leurs attributs retourne à l'état connu avant que les changements dus à une opération quelconque aient été appliqués. Les changements autres que des modifications classiques (par exemple des modifications effectuées par une extension) peuvent ne pas être annulés, selon la manières dont ils ont été effectués.

Pour utiliser l'historique Annuler/Refaire, cliquez simplement sur l'opération à annuler dans la liste et toutes les entités retrouveront leur état antérieur à cette opération.


\subsubsection{Simplifier Entité}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:simplify-feature}
L'outil \includegraphics[width=2em]{mActionSimplify.png} $^{\text{Simplifier une entité}}$ permet de réduire le nombre de sommets qui composent une entité tant que cela ne change pas le type de géométrie. Vous devez sélectionner une ou plusieurs entités qui seront alors surlignées par un contour rouge, une barre coulissante est affichée pour choisir le degré de simplification que vous désirez appliquer (le contour rouge reflète la forme que vous obtiendrez). Cliquez sur \textbf{{[}OK{]}} et la nouvelle forme sera retenue. Si une entité ne peut être simplifiée (p. ex. un polygone multiple), un message vous le signalera.


\subsubsection{Ajouter un anneau}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:add-ring}
Vous pouvez créer des polygones à trou en utilisant l'icône \includegraphics[width=2em]{mActionAddRing.png} $^{\text{Ajouter un anneau}}$ Cela signifie qu'il est possible de dessiner des polygones à l'intérieur d'une zone existante et d'en faire des trous, seule la zone entre les limites externes des polygones sera conservée.


\subsubsection{Ajouter une partie}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:add-part}
Vous pouvez \includegraphics[width=2em]{mActionAddIsland.png} $^{\text{ajouter une partie}}$ à un multipolygone sélectionné. La nouvelle partie doit être dessinée en dehors de celui-ci.


\subsubsection{Effacer un anneau}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:delete-ring}
L'outil \includegraphics[width=2em]{mActionDeleteRing.png} $^{\text{Effacer un anneau}}$ permet de supprimer un anneau existant dans un polygone. Il ne change rien lorsque il est utilisé sur la bordure extérieure du polygone. Cet outil peut être utilisé sur un polygone ou un polygone multiple. Avant de sélectionner un sommet d'un anneau, ajustez la tolérance d'édition du sommet.


\subsubsection{Effacer une partie}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:delete-part}
L'outil \includegraphics[width=2em]{mActionDeletePart.png} $^{\text{Effacer une partie}}$ permet de supprimer des parties d'une entité multiparties (p.ex. un polygone composé de multiples polygones distincts). Cela n'effacera pas la dernière partie restante. Cet outil marche avec toutes les géométries multiparties. Avant de sélectionner un sommet d'un anneau, ajustez la tolérance d'édition du sommet.


\subsubsection{Remodeler les  entités}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:reshape-features}
Il est possible de retoucher des lignes ou des polygones grâce à l'outil \includegraphics[width=1.5em]{mActionReshape.png} $^{\text{Remodeler une entité}}$. Vous pouvez changer la forme d'une ligne ou d'un polygone en traçant une nouvelle forme entre deux sommets, la modification viendra s'ajouter à l'existant ou le remplacer selon la taille de l'intervalle entre le premier sommet et celui clôturant le remodelage. Cette méthode convient pour remplacer de petites portions d'une entité, la ligne de remodelage n'est pas autorisée à croiser plusieurs anneaux de polygones, car cela générerait un polygone invalide.

Par exemple vous pouvez modifier les limites d'un polygone avec cet outil. Tout d'abord cliquez à l'intérieur du polygone près de la zone où vous souhaitez ajouter un noeud. Franchissez ensuite la limite et positionnez les noeuds à extérieur du polygone. Pour terminer cliquez à nouveau à l'intérieur du polygone. L'outil ajoute automatiquement un noeud à l'endroit où la ligne intersecte le limite du polygone. Il est possible également de supprimer des morceaux de polygones en commençant à l'extérieur du polygone puis en ajoutant des noeuds à l'intérieur et en terminant à l'extérieur par un clic-droit.

\begin{notice}{note}{Note:}
L'outil de remodelage peut altérer la position de départ d'un anneau polygonal ou d'une ligne close, le point ``double'' ne sera plus le même. Ce n'est pas un problème pour la plupart des applications, mais c'est quelque chose à considérer.
\end{notice}


\subsubsection{Décalage X,Y}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:offset-curves}
L'outil \includegraphics[width=1.5em]{mActionOffsetCurve.png} $^{\text{Déclage X,Y}}$ est nouveau, il permet de décaler des lignes ou des anneaux de polygones. Cet outil fonctionne sur la couche en mode édition (dont les géométries sont modifiées) ou sur les autres couches présentes (crée une copie des lignes ou anneaux et les ajoute à la couche en mode édition). Cet outil convient parfaitement à la création de couches de lignes de distance. La distance du décalage s'affiche en bas à gauche de la barre d'état.

\index{Split\_Features}

\subsubsection{Séparer les entités}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-14}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:split-features}
Vous pouvez diviser une entité en utilisant le bouton \includegraphics[width=1.5em]{mActionSplitFeatures.png} $^{\text{Couper Entités}}$. Pour couper, dessinez une ligne en travers de l'entité avec cet outil et terminez avec un clic droit.

\index{Merge\_Selected\_Features}

\subsubsection{Fusionner les entités sélectionnées}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:merge-selected-features}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-15}
L'outil \includegraphics[width=1.5em]{mActionMergeFeatures.png} $^{\text{Fusionner les entités sélectionnées}}$ permet de combiner des entités ayant une bordure commune et des attributs similaires.

\index{Merge\_Attributes\_of\_Selected\_Features}

\subsubsection{Fusionner les attributs des entités sélectionnées}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-16}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:merge-attributes-of-selected-features}
L'outil \includegraphics[width=1.5em]{mActionMergeFeatures.png} $^{\text{Fusionner les attributs des entités sélectionnées}}$ permet de \index{combiner les attributs des entités}combiner les attributs des entités ayant une bordure commune et des attributs similaires sans fusionner leur géométrie.

\index{Rotate\_Point\_symbols}

\subsubsection{Rotation des symboles de point}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:rotate-point-symbols}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-18}
L'outil \includegraphics[width=1.5em]{mActionRotatePointSymbols.png} $^{\text{Rotation d'un symbole de point}}$ n'est plus supporté que par l'ancien système de symbologie. Il permet de modifier l'orientation d'un symbole de point sur la carte, si vous avez défini une colonne attributaire contenant l'orientation dans l'onglet \emph{Style} de la fenêtre \emph{Propriétés de la couche}. Dans le cas contraire, l'outil restera inactif.
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:figure-edit-4}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=15em]{rotatepointsymbol.png}
\caption{Rotate Point Symbols \includegraphics[width=1em]{nix.png}}\end{figure}

Pour changer l'orientation, sélectionnez une entité ponctuelle sur le canevas et faite là tourner en gardant le bouton gauche de votre souris appuyé. Une flèche rouge avec la valeur de rotation est visible (voir {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:figure-edit-4]{Figure\_edit\_4}}). Lorsque vous relâchez le bouton, la valeur sera mise à jour dans la table attributaire.

\begin{notice}{note}{Note:}
Si vous gardez la touche \code{Ctrl} enfoncée, la rotation se fera par palier de 15 degrés.
\end{notice}

\index{Create\_New\_Layers}\index{New\_Shapefile\_Layer}

\subsection{Créer une nouvelle couche vecteur}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:sec-create-shape}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:creating-a-new-vector-layer}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-19}
QGIS permet de créer de nouveaux Shapefile et couches Spatialite.La création de couches GRASS est gérée par l'extension GRASS. Référez-vous à la section {\hyperref[docs/user_manual/grass_integration/grass_integration:creating-new-grass-vectors]{\emph{Création d'une nouvelle couche vectorielle GRASS}}} pour plus d'informations sur ce sujet.


\subsubsection{Créer une nouvelle couche Shapefile}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:creating-a-new-shapefile-layer}
Pour créer une nouvelle couche Shapefile à éditer, allez dans le menu \emph{Nouveau \(\rightarrow\)} \includegraphics[width=1.5em]{mActionNewVectorLayer.png} \emph{Nouvelle couche Shapefile...} du menu \emph{Couche}. La fenêtre \emph{Nouvelle couche vecteur} apparaitra telle que montrée dans {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:figure-edit-5]{Figure\_edit\_5}}. Choisissez le type de géométrie de la couche (point, ligne ou polygone) et le SCR (Système de Coordonnées de Référence).

Notez que QGIS ne gère pas encore la création d'entité 2.5D (c.-à-d. des entités avec des coordonnées X, Y, Z).
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:figure-edit-5}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{editNewVector.png}
\caption{Creating a new Shapefile layer Dialog \includegraphics[width=1em]{nix.png}}\end{figure}

Pour terminer la création de la nouvelle couche, ajouter les attributs désirés en cliquant sur le bouton \textbf{{[}Ajouter à la liste d'attributs{]}} après avoir spécifié le nom et le type de chaque attribut. Un attribut `id' est proposé par défaut et peut être supprimé. Seuls les attributs de type \emph{Nombre décimal} \includegraphics{selectstring.png}, \emph{Nombre entier} \includegraphics{selectstring.png}, and \emph{Données texte} \includegraphics{selectstring.png} sont gérés. De plus, selon le type d'attribut vous pouvez définir la largeur et la précision de la nouvelle colonne. Une fois satisfait de vos attributs, cliquez sur \textbf{{[}OK{]}} et donnez un nom pour le shapefile. QGIS va automatiquement ajouter l'extension \code{.shp} au nom que vous lui avez spécifié. Une fois la couche créée, elle sera ajoutée à la carte et vous pouvez l'éditer de la manière décrite dans la Section ref:\emph{sec\_edit\_existing\_layer} ci-dessus.

\index{New\_Spatialite\_Layer}

\subsubsection{Créer une nouvelle couche SpatiaLite}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:creating-a-new-spatialite-layer}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:vector-create-spatialite}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-20}
Pour créer une nouvelle couche SpatiaLite à éditer, allez dans \emph{Nouveau \(\rightarrow\)} \includegraphics[width=1.5em]{mActionNewVectorLayer.png} \emph{Nouvelle couche SpatiaLite...} depuis le menu \emph{Couche}. La fenêtre \emph{Nouvelle couche SpatiaLite} apparaitra telle que montrée dans la figure {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:figure-edit-6]{Figure\_edit\_6}}.
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:figure-edit-6}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{editNewSpatialite.png}
\caption{Creating a New SpatiaLite layer Dialog \includegraphics[width=1em]{nix.png}}\end{figure}

La première étape est sélectionner une base SpatiaLite existante ou d'en créer une nouvelle en utilisant le bouton \includegraphics{browsebutton.png} à droite de la liste des bases de données. Donnez un nom à la nouvelle couche, choisissez un type puis un SCR. Si besoin, vous pouvez cocher \includegraphics{checkbox.png} \emph{Créer une clé primaire autoincrémentée}.

Pour défnir une table attributaire, ajoutez les noms des colonnes avec leur type de données et cliquez sur le bouton \textbf{{[}Ajouter à la liste d'attribut{]}}. Lorsque la liste d'attributs est terminée, cliquez sur \textbf{{[}OK{]}}. QGIS ajoutera automatiquement cette nouvelle couche à la légende où vous pourrez l'éditer comme indiquée dans la section {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-edit-existing-layer]{\emph{Numériser une couche existante}}} ci-dessus.

D'autres opérations de gestion des couches SpatiaLite peuvent être effectuées via DB Manager, voir {\hyperref[docs/user_manual/plugins/plugins_db_manager:dbmanager]{\emph{Extension DB Manager}}}.

\index{Work\_with\_Attribute\_Table}

\subsection{Travailler avec la table d'attributs}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:sec-attribute-table}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-21}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:working-with-the-attribute-table}
La \index{table d'attributs}table d'attributs affiche les entités de la couche sélectionnée. Chaque ligne représente une entité avec ses attributs répartis dans plusieurs colonnes. Chaque entité de la table peut être recherchée, sélectionnée, déplacée et éditée.

Pour ouvrir la table attributaire d'une couche vecteur, activez la couche en cliquant dessus depuis la zone de légende de la carte. Puis dans le menu \emph{Couche}, cliquez sur \includegraphics[width=1.5em]{mActionOpenTable.png} \emph{Ouvrir la table d'attributs}. Vous pouvez aussi y accéder avec un clic droit sur la couche puis en sélectionnant \includegraphics[width=1.5em]{mActionOpenTable.png} \emph{Ouvrir la table d'attributs}.

Cela ouvrira une nouvelle fenêtre qui affiche les attributs de toutes les entités de la couche (voir {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:figure-attributes-1]{figure\_attributes\_1}}). Le nombre des entités et le nombre d'entités sélectionnées sont affichés dans la barre de titre de la table d'attributs.
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:figure-attributes-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{vectorAttributeTable.png}
\caption{Attribute Table for Alaska layer \includegraphics[width=1em]{nix.png}}\end{figure}

\index{Attribute\_Table\_Selection}

\subsubsection{Sélectionner une entité depuis la table}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-23}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:selecting-features-in-an-attribute-table}
\textbf{Chaque ligne sélectionnée} dans la table d'attributs correspond aux attributs d'une entité sélectionnée de la couche. Si la sélection est modifiée sur la carte, elle est également mise à jour dans la table d'attributs. De la même manière, une modification de la sélection dans la table est automatiquement répercutée sur la carte.

Les lignes peuvent être sélectionnées en cliquant sur le numéro de ligne placé tout à gauche. \textbf{Plusieurs lignes} peuvent être sélectionnées en maintenant la touche \code{Ctrl}.Une \textbf{sélection continue} s'effectue en gardant appuyée la touche \code{Shift} et en cliquant sur une nouvelle ligne, toutes les lignes entre la première sélection et la dernière seront prises. Déplacer la position du curseur dans la table d'attributs en cliquant sur une cellule ne modifie pas la sélection des lignes. Modifier les entités sélectionnées depuis la carte ne modifie pas la position du curseur dans la table.

Vous pouvez faire un tri sur les colonnes en cliquant sur l'en-tête. Une petite flèche indique l'ordre de tri (une flèche pointant vers le bas indiquera un tri décroissant, une flèche vers le haut, un tri croissant).

Pour une \textbf{simple recherche par attribut} sur une seule colonne, le champ \emph{Chercher} peut être utilisé. Sélectionnez la colonne sur laquelle doit être opérée la recherche depuis la liste déroulante et appuyez sur le bouton \textbf{{[}Chercher{]}}. Les entités correspondantes seront sélectionnées et leur nombre total sera affiché dans le titre de la table ainsi que dans la barre d'état de la fenêtre principale. Pour des recherches plus complexes, passez par le bouton Recherche avancée \includegraphics{browsebutton.png}, qui lancera le Constructeur de requêtes décrit à la section {\hyperref[docs/user_manual/working_with_vector/query_builder:vector-query-builder]{\emph{Constructeur de requêtes}}}.

Pour afficher uniquement les enregistrements que vous avez sélectionnés, utiliser la case à cocher \includegraphics{checkbox.png} \emph{Afficher sélection}. Pour limiter la recherche à la sélection, activer la case \includegraphics{checkbox.png} \emph{Ne recherche que dans la sélection} Les autres boutons disposés en bas à gauche de la fenêtre fournissent les fonctionnalités suivantes :
\begin{itemize}
\item {} 
\includegraphics[width=1.5em]{mActionOpenTable.png} $^{\text{Tout désélectionner}}$ ou \code{Ctrl+U}

\item {} 
\includegraphics[width=1.5em]{mActionSelectedToTop.png} $^{\text{Déplacer la sélection au sommet}}$ ou \code{Ctrl+T}

\item {} 
\includegraphics[width=1.5em]{mActionInvertSelection.png} $^{\text{Inverser la sélection}}$ ou \code{Ctrl+S}

\item {} 
\includegraphics[width=1.5em]{mActionCopySelected.png} $^{\text{Copier les lignes sélectionnées dans le presse papier}}$ ou \code{Ctrl+C}

\item {} 
\includegraphics[width=1.5em]{mActionZoomToSelected.png} $^{\text{Zoomer sur les lignes sélectionnées}}$ ou \code{Ctrl+J}

\item {} 
\includegraphics[width=1.5em]{mActionPanToSelected.png} $^{\text{Déplacer la carte sur les lignes sélectionnées}}$ ou \code{Ctrl+P}

\item {} 
\includegraphics[width=1.5em]{mActionToggleEditing.png} $^{\text{Activer le mode édition}}$ pour éditer les valeurs une à une et activer les fonctionnalités décrites ci-dessous ou \code{Ctrl+E}

\item {} 
\includegraphics[width=1.5em]{mActionDeleteSelected.png} $^{\text{Supprimer les entités sélectionnées}}$ ou \code{Ctrl+D}

\item {} 
\includegraphics[width=1.5em]{mActionNewAttribute.png} $^{\text{Nouvelle colonne}}$ pour les couches PostGIS et les couches gérées par OGR (GDAL version \textgreater{}= 1.6) ou \code{Ctrl+W}

\item {} 
\includegraphics[width=1.5em]{mActionDeleteAttribute.png} $^{\text{Supprimer une colonne}}$ pour les couches PostGIS et les couches gérées par OGR (GDAL version \textgreater{}= 1.9) ou \code{Ctrl+L}

\item {} 
\includegraphics[width=1.5em]{mActionCalculateField.png} $^{\text{Ouvrir la calculatrice de champs}}$ ou \code{Ctrl+I}

\end{itemize}

\begin{notice}{tip}{Astuce:}
\textbf{Éviter d'exporter la géométrie WKT}

Si vous souhaitez utiliser les données attributaires dans un progamme externe (comme Excel), utilisez le bouton \includegraphics[width=1.5em]{mActionCopySelected.png} $^{\text{Copier les lignes sélectionnées dans le presse papier}}$. Vous pouvez copier les données sans la géométrie si vous désactivez l'option \emph{Préférences \(\rightarrow\) Options \(\rightarrow\)} onglet Général \includegraphics{checkbox.png} \emph{Copier la représentation WKT de la géométrie depuis la table attributaire}.
\end{notice}


\subsubsection{Enregistrer les entités sélectionnées dans une nouvelle couche}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:save-selected-features-as-new-layer}
Les entités sélectionnées peuvent être enregistrées dans un nouveau fichier (dans tout format supporté par OGR) et transformé dans n'importe quel autre système de coordonnéesde référence (SCR). Il suffit de faire un clic droit sur la couche contenant la sélection, de cliquer sur \emph{Sauvegarder la sélection sous...} pour définir le nom du fichier en sortie, le format et le SCR (voir section {\hyperref[docs/user_manual/introduction/qgis_gui:label-legend]{\emph{Légende de la carte}}}). Il est possible de définir des options de création OGR à cette étape.

\index{Non\_Spatial\_Attribute\_Tables}

\subsubsection{Travailler avec tables non-spatialisées}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:working-with-non-spatial-attribute-tables}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-24}
QGIS permet de charger des tables n'ayant pas d'information spatiale, cela comprend les tables supportées par OGR, les fichers de texte délimité et les tables PostgreSQL. Les tables peuvent être utilisées pour regarder les champs, pour des requêtes ou pour de l'édition. Lorsque vous chargez une table de ce type, elle apparaîtra dans la liste des couches, elle peut être ouverte avec l'outil \includegraphics[width=1.5em]{mActionOpenTable.png} $^{\text{Ouvrir la table d'attributs}}$. Elle est ensuite éditable comme n'importe qu'elle autre table attributaire.

Par exemple vous pouvez utiliser ces colonnes pour définir des valeurs d'attributs ou un intervalle de valeurs qui sont autorisées à être ajoutées à une couche vectorielle spécifique durant une numérisation. Jetez un oeil du côté de l'outil d'édition pour en savoir plus (section {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-attributes-tab]{\emph{Onglet Champs}}}).

\index{Query\_Builder}

\section{Constructeur de requêtes}
\label{docs/user_manual/working_with_vector/query_builder:index-0}\label{docs/user_manual/working_with_vector/query_builder:vector-query-builder}\label{docs/user_manual/working_with_vector/query_builder:query-builder}\label{docs/user_manual/working_with_vector/query_builder::doc}
Le constructeur de requêtes qui vous permet de définir un sous-ensemble de la table en utilisant une clause SQL de type WHERE et de l'afficher dans QGIS. Le résultat de la requête peut être sauvegardé comme une nouvelle couche.


\subsection{Requête}
\label{docs/user_manual/working_with_vector/query_builder:query}
Ouvrez la table d'attributs depuis le menu \includegraphics[width=1.5em]{mActionOpenTable.png} $^{\text{Ouvrir la table d'attributs}}$. Cliquez sur le bouton \textbf{{[}Recherche avancée{]}} pour ouvrir le \emph{Constructeur de requête}. Par exemple si vous avez une couche \code{towns} avec un champ \code{population}, vous pouvez sélectionner les plus grandes villes en entrant \code{population \textgreater{} 100000} dans la clause SQL WHERE du Constructeur de requête. {\hyperref[docs/user_manual/working_with_vector/query_builder:figure-attributes-2]{Figure\_attributes\_2}} montre un exemple de requête sur une couche PostGIS dont les attributs sont stockés dans PostgreSQL. Les listes des Champs, Valeurs et Opérateurs aident à la construction de la requête SQL.
\phantomsection\label{docs/user_manual/working_with_vector/query_builder:figure-attributes-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{queryBuilder.png}
\caption{Query Builder \includegraphics[width=1em]{nix.png}}\end{figure}

La \textbf{liste des champs} contient tous les attributs de la table d'attributs pouvant être parcourus par la recherche. Pour ajouter un attribut à la clause WHERE, double-cliquez sur son nom dans la  liste. Vous pouvez cliquez sur les différents champs, valeurs et opérateurs qui composent votre requête ou bien les écrire directement.

La \textbf{liste des valeurs} recense toutes les valeurs d'un attribut. Pour en lister la totalité, sélectionnez l'attribut dans la liste de champs puis cliquez sur le bouton \textbf{{[}Tout{]}}. Pour lister uniquement les 25 premières valeurs, sélectionnez l'attribut puis cliquez sur \textbf{{[}Échantillon{]}}. Pour ajouter une valeur à la requête, il vous suffit de faire un double-clic dessus.

La \textbf{liste des opérateurs} contient toutes les opérations effectuables sur une recherche. Pour ajouter un opérateur à la requête SQL, cliquez sur le bouton approprié. Les opérateurs relationnels ( \code{=} , \code{\textgreater{}} , ...), les opérateurs de comparaison (\code{LIKE}), les opérateurs logiques (\code{AND}, \code{OR}, ...) sont disponibles.

Le \textbf{{[}Test{]}} affiche une fenêtre comptabilisant le nombre d'entités correspondant à votre requête, vous permettant de savoir si votre requête fonctionne au fil de sa construction. Le bouton \textbf{{[}Effacer{]}} nettoye le texte de la clause SQL where. Les boutons \textbf{{[}Sauvegarder{]}} et \textbf{{[}Charger{]}} permettent d'enregistrer et de charger des requêtes. Le bouton \textbf{{[}OK{]}} ferme la fenêtre et effectue la sélection en fonction de la recherche définie. Le bouton \textbf{{[}Annuler{]}} clôt la fenêtre, sans modifier la sélection en cours.
\phantomsection\label{docs/user_manual/working_with_vector/query_builder:tip-sql-layer-definition}
\begin{notice}{tip}{Astuce:}
\textbf{Changer la définition d'une couche}

Vous pouvez changer la définition d'une couche après son chargement en modifiant la requête SQL utilisée pour définir la couche. Pour faire cela, ouvrez la fenêtre \emph{Propriétés de la couche} en double-cliquant sur la couche dans la légende puis cliquez sur le bouton \textbf{{[}Constructeur de requête{]}} dans l'onglet \emph{Général}. Voir Section {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-properties-dialog]{\emph{Fenêtre Propriétés d'une couche vecteur}}}.
\end{notice}

\index{Select\_using\_Query}

\subsection{Sélection}
\label{docs/user_manual/working_with_vector/query_builder:selection}\label{docs/user_manual/working_with_vector/query_builder:index-1}\label{docs/user_manual/working_with_vector/query_builder:sec-selection-query}
Dans QGIS, il est possible également de sélectionner des entités en utilisant une interface similaire à celle du constructeur de requêtes utilisé dans {\hyperref[docs/user_manual/working_with_vector/query_builder:vector-query-builder]{\emph{Constructeur de requêtes}}}. Dans la section ci-dessus, le but du constructeur de requêtes était seulement de surligner en jaune les entités répondant aux critères, les autres entités ne changeant pas d'apparence.

Une autre possibilité est de réaliser une sélection par un clic-droit sur une couche de la légende et de choisir \emph{Requête}. Si vous effectuez une requête SQL ici, seules les entités correspondant à la requête seront affichées sur la carte. Les autres entités n'apparaissent plus sur la carte. La même fonctionnalité est disponible via l'onglet \emph{Général} de la fenêtre  \emph{Propriétés de la couche}. Vous y trouverez un bouton \textbf{{[}Constructeur de requête{]}}. Ce type de sélection est opérationnel pour tous les formats de données vecteurs.


\subsection{Sauvegarder la sélection dans une nouvelle couche}
\label{docs/user_manual/working_with_vector/query_builder:save-selected-features-as-new-layer}
Les entités sélectionnées peuvent être sauvegardées dans n'importe quel format vecteur géré par OGR et transformées dans un autre système de coordonnées de référence (SCR). Faites un clic-droit sur le nom de la couche puis choisissez \emph{Sauvegarder la sélection sous...} pour donner un nom au fichier, son format et son SCR (voir section {\hyperref[docs/user_manual/introduction/qgis_gui:label-legend]{\emph{Légende de la carte}}}). Il est possible de définir des options de création OGR à cette étape.

\index{Field\_Calculator}\index{Calculator\_Field}\index{Derived\_Fields}

\section{Calculatrice de champ}
\label{docs/user_manual/working_with_vector/field_calculator:vector-field-calculator}\label{docs/user_manual/working_with_vector/field_calculator:field-calculator}\label{docs/user_manual/working_with_vector/field_calculator:index-0}\label{docs/user_manual/working_with_vector/field_calculator::doc}
Le bouton \includegraphics[width=1.5em]{mActionCalculateField.png} $^{\text{Calculatrice de champs}}$ de la table d'attributs permet d'opérer des calculs sur la base des valeurs attributaires ou d'utiliser des fonctions, p. ex. pour calculer la longueur ou la surface des entités. Les résultats peuvent être écrits dans une nouvelle colonne attributaire ou mettre à jour une colonne existante.

Vous devez basculer la couche vectorielle en mode d'édition avant de pouvoir cliquer sur le bouton de la calculatrice (voir {\hyperref[docs/user_manual/working_with_vector/field_calculator:figure-attributes-3]{figure\_attributes\_3}}). Dans la fenêtre, il vous faut d'abord choisir si une nouvelle colonne doit être créée ou s'il s'agit d'une mise à jour d'une colonne existante.
\phantomsection\label{docs/user_manual/working_with_vector/field_calculator:figure-attributes-3}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{fieldcalculator.png}
\caption{Field Calculator \includegraphics[width=1em]{nix.png}}\end{figure}

Si vous choisissez d'ajouter un nouveau champ, vous devez lui donner un nom, un type (nombre entier, nombre décimal ou chaîne de caractère), une longueur et sa précision (voir {\hyperref[docs/user_manual/working_with_vector/field_calculator:figure-attributes-3]{figure\_attributes\_3}}). Par exemple, si vous créez un champ d'une longueur de 10 et doté d'une précision de 3, vous aurez 6 chiffres avant la virgule, la virgule et 3 chiffres après, soit 10 caractères au total.

La \textbf{liste de fonctions} contient les fonctions, les champs et les valeurs. Référez-vous à l'aide des fonctions qui s'affiche dans l'\textbf{Aide pour la fonction sélectionnée}. Dans la zone \textbf{Expression} s'affiche le calcul à effectuer. Les fonctions les plus courantes se trouvent sous \textbf{Opérateurs}.

Dans la \textbf{Liste de fonctions}, cliquez sur \emph{Champs et valeurs} pour visualiser la liste des champs de la table d'attributs. Pour ajouter un champ à l'\textbf{Expression}, double-cliquez sur son nom dans la liste \emph{Champs et valeurs}. Vous pouvez utiliser plusieurs champs, valeurs et fonctions dans votre calcul depuis la liste ou les entrer directement dans la zone d'expression. Pour visualiser les valeurs d'un champ, faites un clic-droit sur le champ voulu. Vous avez le choix entre \emph{Charger les 10 valeurs les plus représentées} ou \emph{Charger toutes les valeurs}. Une liste \textbf{Valeurs de champs} apparaît à droite. Pour ajouter une valeur au calcul, double-cliquez dessus depuis la liste des \textbf{Valeurs de champs}.

\emph{Opérateurs}, \emph{Math}, \emph{Conversions}, \emph{Chaîne}, \emph{Géometrie} et \emph{Enregistrement} proposent de multiples fonctions. Dans \emph{Opérateurs}, vous trouverez les opérateurs mathématiques. Dans \emph{Math}, les fonctions mathématiques. Dans \emph{Conversions}, les fonctions de conversion d'un type à un autre. Dans \emph{Chaîne}, les fonctions concernant les chaînes de caractère. Dans \emph{Géometrie}, les fonctions concernant la géométrie des entités. Dans \emph{Enregistrement}, les fonctions d'énumération des données. Pour ajouter une fonction au calcul, double-cliquez dessus.

Un court exemple pour illustrer la manière dont la calculatrice fonctionne. Nous voulons calculer la longueur des lignes de la couche \code{railroads} de l'échantillon de données de QGIS :
\begin{enumerate}
\item {} 
Chargez le fichier Shapefile \code{railroads.shp} dans QGIS et ouvrez sa \includegraphics[width=1.5em]{mActionOpenTable.png} $^{\text{Table d'Attributs}}$.

\item {} 
Cliquez sur \includegraphics[width=1.5em]{mActionToggleEditing.png} $^{\text{Basculer en mode édition}}$ et ouvrez la \includegraphics[width=1.5em]{mActionCalculateField.png} $^{\text{Calculatrice de champs}}$.

\item {} 
Cochez la case \includegraphics{checkbox.png} \emph{Créer un nouveau champ} pour enregistrer le résultat des calculs dans un nouveau champ.

\item {} 
Ajoutez \code{longueur} dans le nom de ce champ, \code{réel} en tant que type et définissez une longueur de 10 et une précision de 3.

\item {} 
Maintenant cliquez sur \code{longueur} parmi les fonctions de \emph{Géométrie} pour l'ajouter dans l'expression (sous la forme \code{\$length}) et cliquez sur le bouton \textbf{{[}Ok{]}}.

\item {} 
Vous pouvez maintenant voir la nouvelle colonne \code{longueur} dans la table d'attributs.

\end{enumerate}

Les fonctions disponibles sont listées ci-dessous.

\index{Field\_Calculator\_Functions}
\begin{Verbatim}[commandchars=\\\{\}]
column name "column name"            value of the field column name
'string'                             a string value
NULL                                 null value
a IS NULL                            a has no value
a IS NOT NULL                        a has a value
a IN (value[,value])                 a is below the values listed
a NOT IN (value[,value])             a is not below the values listed
a OR b                               a or *b* is true
a AND b                              a and *b* is true
NOT a                                inverted truth value of a
sqrt(a)                              square root of a
sin(a)                               sinus of a
cos(a)                               cosinus of b
tan(a)                               tangens of a
asin(a)                              arcussinus of a
acos(a)                              arcuscosinus of a
atan(a)                              arcustangens of a
to int(a)                            convert string a to integer
to real(a)                           convert string a to real
to string(a)                         convert number a to string
lower(a)                             convert string a to lower case
upper(a)                             convert string a to upper case
length(a)                            length of string a
atan2(y,x)                           arcustangens of y/x using the signs of the two
                                     arguments to determine the quadrant of the result
replace(*a*, replacethis, withthat)  replace this with that in string a
regexp\_replace(a,this,that)          replace the regular expression this with that
substr(*a*,from,len)                 len characters of string *a* starting from from
                                     (first character index is 1)
a \textbar{}\textbar{} b                               concatenate strings a and b
\$rownum                              number current row
\$area                                area of polygon
\$perimeter                           perimeter of polygon
\$length                              length of line
\$id                                  feature id
\$x                                   x coordinate of point
\$y                                   y coordinate of point
xat(n)                               X coordinate of the point of an n-th line (indeces
                                     start at 0; negative values refer to the line end)
yat(n)                               y coordinate of the point of an n-th line (indeces
                                     start at 0; negative values refer to the line end)
a = b                                a and b are equal
a != b and a \textless{}\textgreater{} b                    a and b are not equal
a \textgreater{}= b                               a is larger than or equal to b
a \textless{}= b                               a is less than or equal to b
a \textgreater{} b                                a is larger than b
a \textless{} b                                a is smaller than b
a \textasciitilde{} b                                a matches the regular expression b
a LIKE b                             a equals b
a ILIKE b                            a equals b (without regard to case-sensitive)
a \textbar{}wedge\textbar{} b                          a raised to the power of b
a * b                                a multiplied by b
a / b                                a divided by b
a + b                                a plus b
a - b                                a minus b
+ a                                  positive sign
- a                                  negative value of a
\end{Verbatim}

La \textbf{Liste de fonctions} avec l'\textbf{Aide pour la fonction sélectionnée}, les \textbf{Opérateurs} et la zone \textbf{Expression} sont également accessibles depuis le type de rendu Ensemble de règles de l'onglet Style de la fenêtre de propriétés d'une couche et l'étiquetage basé sur une formule \includegraphics{browsebutton.png} dans l'extension d'\includegraphics[width=1.5em]{mActionLabeling.png} $^{\text{Étiquetage}}$.


\chapter{Les données raster}
\label{docs/user_manual/working_with_raster/index:working-with-raster-data}\label{docs/user_manual/working_with_raster/index::doc}\label{docs/user_manual/working_with_raster/index:working-with-raster}
\index{Raster}
\index{Arc/Info\_Binary\_Grid}\index{Arc/Info\_ASCII\_Grid}\index{GeoTIFF}
\index{Erdas Imagine}

\section{Les données raster}
\label{docs/user_manual/working_with_raster/supported_data:working-with-raster-data}\label{docs/user_manual/working_with_raster/supported_data::doc}\label{docs/user_manual/working_with_raster/supported_data:index-2}
Cette section explique comment visualiser et définir les propriétés d'une couche raster. QGIS utilise la bibliothèque \index{GDAL}GDAL pour lire et écrire des raster de multiples formats dont Arc/Info Binary Grid, Arc/Info ASCII Grid, GeoTIFF, Erdas Imagine et bien d'autres. La gestion des raster GRASS se fait de manière native via une extension spécifique. Des raster peuvent également être lus par QGIS depuis des archives zip et gzip.

A ce jour, plus de 100 formats raster sont gérés par la bibliothèque GDAL (voir GDAL-SOFTWARE-SUITE {\hyperref[docs/user_manual/literature_web/literature_and_web_references:literature-and-web]{\emph{Bibliographie}}}). La liste complète est disponible sur cette page : \href{http://www.gdal.org/formats\_list.html}{http://www.gdal.org/formats\_list.html}.

\begin{notice}{note}{Note:}
Certains des formats listés peuvent ne pas fonctionner dans QGIS pour diverses raisons. Par exemple, certains formats requièrent une bibliothèque commerciale externe ou la bibliothèque GDAL n'a pas été compilée sur votre système d'exploitation pour gérer le format souhaité. Seuls les formats ayant été testés correctement apparaissent dans la liste des types de fichiers proposés au moment de l'ajout de données raster dans QGIS. Les autres formats peuvent être chargés en sélectionnant \code{{[}GDAL{]} Tous les fichiers (*)} .
\end{notice}

La gestion des données raster GRASS est décrite dans la section {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-grass]{\emph{Intégration du SIG GRASS}}}.


\subsection{Qu'est ce qu'un raster ?}
\label{docs/user_manual/working_with_raster/supported_data:what-is-raster-data}
Les données raster dans les SIG sont des matrices de cellules discrètes qui représentent des objets, au-dessus ou en dessous de la surface de la Terre. Les cellules de la grille raster sont de la même taille et généralement rectangulaires (dans QGIS, elles seront toujours rectangulaires). Les jeux de données raster les plus classiques sont des données de télédétection telles que des photographies aériennes ou des images satellitaires et des données issues de modèles telles que les matrices d'élévation.

Contrairement aux données vectorielles, les données raster n'ont pas de base de données associée. Elles sont géoréférencées grâce à la résolution des pixels et les coordonnées x/y du pixel d'un des coins de la couche raster. Cela permet à QGIS de  positionner les données correctement dans la zone de la carte.

Pour afficher correctement les données, QGIS utilise les informations de géoréférencement intégrées aux couches raster (par exemple \index{GeoTiff}GeoTiff) ou présentes dans un fichier world.

\index{loading\_raster}

\subsection{Charger des données raster dans QGIS}
\label{docs/user_manual/working_with_raster/supported_data:index-5}\label{docs/user_manual/working_with_raster/supported_data:load-raster}\label{docs/user_manual/working_with_raster/supported_data:loading-raster-data-in-qgis}
Les couches raster sont chargées soit en cliquant sur le bouton \includegraphics[width=1.5em]{mActionAddRasterLayer.png} $^{\text{Charger une couche raster}}$ soit via le menu \emph{Couche\(\rightarrow\)} \includegraphics[width=1.5em]{mActionAddRasterLayer.png} \emph{Ajouter une couche raster}. Plusieurs couches peuvent être chargées en même temps en appuyant sur la touche \code{Ctrl} ou \code{Shift} et en cliquant sur plusieurs fichiers dans la fenêtre \emph{Ouvrez des données rasters gérées par GDAL}.

Une fois la couche raster chargée vous pouvez faire un clic-droit sur son nom dans la légende de la carte pour sélectionner et activer des paramètres spécifiques à la couche ou pour ouvrir la fenêtre de propriétés de la couche.

\textbf{Menu du bouton droit de la souris pour les couches raster}
\begin{itemize}
\item {} 
\emph{Zoom sur l'étendue de la couche}

\item {} 
\emph{Zoom à la meilleur échelle (100\%)}

\item {} 
\emph{Montrer dans l'aperçu}

\item {} 
\emph{Supprimer}

\item {} 
\emph{Définir le SCR d'une couche}

\item {} 
\emph{Définir le SCR du projet depuis cette couche}

\item {} 
\emph{Propriétés}

\item {} 
\emph{Renommer}

\item {} 
\emph{Copier le style}

\item {} 
\emph{Ajouter un groupe}

\item {} 
\emph{Tout éténdre}

\item {} 
\emph{Tout diminuer}

\item {} 
\emph{Mettre à jour l'ordre de rendu}

\end{itemize}


\section{Fenêtre Propriétés d'une couche raster}
\label{docs/user_manual/working_with_raster/raster_properties:raster-properties-dialog}\label{docs/user_manual/working_with_raster/raster_properties::doc}
Pour voir et définir les propriétés d'une couche raster, double-cliquez sur le nom de la couche dans la légende de la carte ou faites un clic-droit son nom et choisissez \emph{Propriétés} dans le menu qui apparaît.

La fenêtre \emph{Propriétés de la couche} s'ouvre alors (voir {\hyperref[docs/user_manual/working_with_raster/raster_properties:figure-raster-1]{figure\_raster\_1}}).

Il y a plusieurs onglets dans cette fenêtre :
\begin{itemize}
\item {} 
\emph{Style}

\item {} 
\emph{Transparence}

\item {} 
\emph{Palette de Couleur}

\item {} 
\emph{Général}

\item {} 
\emph{Métadonnées}

\item {} 
\emph{Pyramides}

\item {} 
\emph{Histogramme}

\end{itemize}
\phantomsection\label{docs/user_manual/working_with_raster/raster_properties:figure-raster-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{rasterPropertiesDialog.png}
\caption{Raster Layers Properties Dialog \includegraphics[width=1em]{nix.png}}\end{figure}

\index{Symbology}\index{Single\_Band\_Raster}\index{Three\_Band\_Color\_Raster}\index{Multi\_Band\_Raster}

\subsection{Onglet Style}
\label{docs/user_manual/working_with_raster/raster_properties:index-0}\label{docs/user_manual/working_with_raster/raster_properties:style-tab}\label{docs/user_manual/working_with_raster/raster_properties:label-symbology}
QGIS permet d'afficher les couches rasters de deux manières différentes :
\begin{enumerate}
\item {} 
Bande simple - une bande de l'image sera affichée en nuance de gris, en pseudo-couleurs ou en couleurs farfelues.

\item {} 
Trois bandes de couleurs - trois bandes de l'image seront affichées, chaque bande représentant la composante rouge, vert ou bleu qui sera utilisée pour créer une image en couleur.

\end{enumerate}

Pour les deux types de rendu, vous pouvez inverser la sortie couleur en utilisant la case à cocher \includegraphics{checkbox.png} \emph{Inverser la carte de couleur}.

\textbf{Rendu des bandes simples}

Ce choix vous propose deux paramétrages. Vous pouvez tout d'abord sélectionner quelle bande vous voulez utiliser pour le rendu (si le jeu de données comporte plus d'une bande).

La deuxième possibilité vous permet une sélection des tables de couleurs disponibles pour le rendu.

Le deuxième paramètre vous permet de choisir une  \emph{Palette de couleur} \includegraphics{selectstring.png}

\index{Pseudo-Couleurs}\index{Freak\_out}\index{Grayscale}\begin{itemize}
\item {} 
Dégradé de Gris (par défaut)

\item {} 
Pseudo-Couleurs

\item {} 
Couleurs farfelues

\item {} 
Palette de Couleur

\end{itemize}

Quand vous sélectionnez `Palette de Couleur' dans la liste \emph{Palette de Couleur} \includegraphics{selectstring.png}, l'onglet \emph{Palette de Couleur} devient disponible. Pour plus d'informations, voir {\hyperref[docs/user_manual/working_with_raster/raster_properties:label-colormaptab]{\emph{Palette de Couleur}}}.

QGIS peut restreindre les données affichées pour afficher seulement les pixels dont la valeur est comprise dans un nombre donné d'écarts types par rapport à la moyenne.

Cela est utile lorsque vous avez une ou deux cellules dont les valeurs sont aberrentes et qui ont donc un impact négatif sur le rendu du raster. Cette option est seulement disponible pour les images en dégradé de gris, pseudo-couleur et couleurs farfelues.

\textbf{Trois bandes de couleurs}

Ce choix vous offre une large gamme d'options pour modifier l'apparence de votre couche raster. Par exemple, vous pouvez passer les bandes de couleurs d'un ordre RVB standard à un autre.

L'échantillonnage des couleurs est également disponible.

\begin{notice}{tip}{Astuce:}
\textbf{Visualiser une seule bande d'un raster multibande}

Si vous désirez visualiser une seule bande (par exemple la bande rouge) d'une image multibande, vous pouvez penser que vous pourriez définir les bandes Vertes et Bleue à  ``Non définie ''. Mais ce n'est pas la manière correcte. Pour afficher la bande Rouge, définissez le type d'image à Bande grise unique, puis sélectionnez la bande Rouge comme bande à utiliser pour le gris.
\end{notice}

\index{Contrast\_enhancement}
\textbf{Amélioration de contraste}

\begin{notice}{note}{Note:}
Lors de l'ajout d'une couche raster GRASS, l'option \emph{Amélioration de contraste} sera automatiquement \emph{Etirer jusqu'au MinMax}, quelles que soient les options générales de QGIS définies pour cette option.
\end{notice}

\index{Transparency}

\subsection{Onglet Transparence}
\label{docs/user_manual/working_with_raster/raster_properties:transparency-tab}\label{docs/user_manual/working_with_raster/raster_properties:index-3}
QGIS permet d'afficher chaque raster à des niveaux de transparence différents. Utilisez le curseur de transparence pour indiquer dans quelle mesure les couches sous-jacentes (s'il y en a) pourront être visibles à travers cette couche raster. Cela est très utile, si vous désirez superposer plus d'une couche raster, par exemple une carte des reliefs ombrés superposée par une carte raster classifiée. Cela donnera un rendu proche d'un rendu en trois dimensions.

De plus, vous pouvez entrer une valeur raster qui pourra être traitée comme \emph{NODATA}. Cela peut être effectué manuellement ou en utilisant le bouton \includegraphics[width=1.5em]{mActionContextHelp.png} $^{\text{Ajouter les valeurs depuis l'affichage}}$.

Un moyen encore plus flexible de personnaliser la transparence est d'utiliser la section \emph{Options de transparence personnalisée}. La transparence de chaque pixel peut être définie dans cet onglet.

Par exemple, pour donner une transparence de 20\% à l'eau sur notre raster d'exemple \code{landcover.tif}, les étapes suivantes sont nécessaires :
\begin{enumerate}
\item {} 
Chargez le fichier raster \code{landcover}.

\item {} 
Ouvrez la boîte de dialogue \emph{Propriétés de la couche} en double-cliquant sur le nom du raster dans la légende ou avec un clic droit et en choisissant \emph{Propriétés} dans le menu qui apparaît.

\item {} 
Sélectionnez l'onglet \emph{Transparence}.

\item {} 
Cliquez sur le bouton \includegraphics[width=1.5em]{mActionNewAttribute.png} $^{\text{Ajouter des valeurs manuellement}}$. Une nouvelle ligne apparait dans la liste des pixels.

\item {} 
Entrez la valeur du raster (ici la valeur 0) et ajustez la transparence à 20\%.

\item {} 
Cliquez sur le bouton \textbf{{[}Appliquer{]}} et regardez la carte.

\end{enumerate}

Vous pouvez répéter les étapes 4 et 5 pour personnaliser la transparence d'autres valeurs.

Comme vous pouvez le voir, il est assez facile de définir une transparence personnalisée, mais cela peut prendre un peu de temps. Par conséquent, vous pouvez utiliser le bouton \includegraphics[width=1.5em]{mActionFileSave.png} $^{\text{Exporter dans un fichier}}$ pour sauver vos paramètres  de transparence dans un fichier. Le bouton \includegraphics[width=1.5em]{mActionFolder.png} $^{\text{Importer à partir d'un fichier}}$ charge vos paramètres de transparence et les applique à la couche raster actuelle.


\subsection{Palette de Couleur}
\label{docs/user_manual/working_with_raster/raster_properties:label-colormaptab}\label{docs/user_manual/working_with_raster/raster_properties:colormap}
\index{Palette de Couleur}
L'onglet \emph{Palette de couleur} n'est disponible que si vous avez sélectionné un rendu sur une seule bande en Palette de couleur dans l'onglet \emph{Style} (voir {\hyperref[docs/user_manual/working_with_raster/raster_properties:label-symbology]{\emph{Onglet Style}}}).

\index{Color\_interpolation}\index{Discrète}
Trois manières de faire une interpolation de couleurs sont disponibles :
\begin{enumerate}
\item {} 
Discrète

\item {} 
Liénaire

\item {} 
Exacte

\end{enumerate}

Le bouton \textbf{{[}Ajouter une entrée{]}} ajoute une couleur à la table de couleur individuelle. Le bouton \textbf{{[}Éffacer entrée{]}}, supprime une couleur de la table et \textbf{{[}Trier{]}} permet de classer selon la valeur des pixels. Double-cliquez sur une valeur entrée vous permet de la modifier. Double-cliquez sur une couleur, ouvre une fenêtre \emph{Sélectionner une couleur} où vous pouvez sélectionner une autre couleur à appliquer sur cette valeur. Vous pouvez également ajouter des étiquette pour chaque couleur mais elles ne s'afficheront pas via l'outil d'identification des entités.

Alternativement, vous pouvez cliquer sur le bouton \includegraphics[width=1.5em]{mActionNewAttribute.png} $^{\text{Charger une Palette de couleurs depuis la bande}}$ qui tente de charger la table de couleur à partir d'une bande (si celle-ci en a une). Et vous pouvez utiliser les boutons \includegraphics[width=1.5em]{mActionFileOpen.png} $^{\text{Charger une palette de couleur depuis un fichier}}$ ou \includegraphics[width=1.5em]{mActionFileSave.png} $^{\text{Exporter une palette de couleur vers un fichier}}$ pour charger ou sauvegarder la palette dans un fichier pour des sessions utltérieures.

Le bloc  \emph{Générer une nouvelle palette de couleur} vous permet de créer de nouvelles palettes de couleurs par catégorie. Vous avez seulement besoin de sélectionner le \emph{Nombre d'entrées} \includegraphics{selectnumber.png} dont vous avez besoin et d'appuyez sur le bouton \emph{Classer}. Actuellement seul un \emph{Mode de classification} \includegraphics{selectstring.png} est géré, `Intervalles égaux'.


\subsection{Onglet Général}
\label{docs/user_manual/working_with_raster/raster_properties:general-tab}\label{docs/user_manual/working_with_raster/raster_properties:label-generaltab}
L'onglet \emph{Général} affiche des informations basiques sur le raster sélectionné, dont la source de la couche et le nom affiché dans la légende (qui peut être modifié). Cet onglet montre aussi un aperçu de la couche, le symbole de la légende et la palette.

La visibilité en fonction de l'échelle se définie également dans cet onglet. Vous devez activer la case à cocher et définir une échelle appropriée pour l'affichage de vos données sur la carte.

Le système de coordonnées de référence (SCR) est également affiché ici. Il peut être modifié en cliquant sur le bouton \textbf{{[}Spécifier{]}}.

\index{Metadata}

\subsection{Onglet Métadonnées}
\label{docs/user_manual/working_with_raster/raster_properties:metadata-tab}\label{docs/user_manual/working_with_raster/raster_properties:index-6}
L'onglet \emph{Métadonnées} affiche de nombreuses d'information sur la couche raster, dont les statistiques sur chaque bande de la couche raster. Les statistiques sont recueillies `à la demande', de sorte qu'il est possible que les statistiques sur une couche n'aient pas été encore collectées.

Cet onglet est principalement informatif. Vous ne pouvez pas modifier les valeurs qui y sont affichées.

\index{Pyramids}

\subsection{Onglet Pyramides}
\label{docs/user_manual/working_with_raster/raster_properties:pyramids-tab}\label{docs/user_manual/working_with_raster/raster_properties:index-7}
Les couches raster à haute résolution peuvent ralentir la navigation dans QGIS. En créant des copies des données de plus basses résolutions (des pyramides), les performances peuvent être considérablement améliorées puisque QGIS sélectionne la résolution la plus pertinente à utiliser en fonction du niveau de zoom.

Vous devez avoir accès en écriture dans le répertoire où les données originelles sont stockées pour construire les pyramides.

Plusieurs méthodes de reéchantillonage peuvent être utilisées pour calculer les pyramides :
\begin{itemize}
\item {} 
Moyenne

\item {} 
Plus proche voisin

\end{itemize}

Quand la case \includegraphics{checkbox.png} \emph{Construire les pyramides de manière interne si possible} est cochée, QGIS tente de construire les pyramides au sein même du fichier image.

Notez que construire des pyramides peut altérer le fichier original et, une fois créées, elles ne peuvent plus être supprimées. Si vous désirez préserver une version `sans pyramide' de vos raster, réalisez une copie de sauvegarde avant de les construire.


\subsection{Onglet Histogramme}
\label{docs/user_manual/working_with_raster/raster_properties:label-histogram}\label{docs/user_manual/working_with_raster/raster_properties:histogram-tab}
\index{Histogram}
L'onglet \emph{Histogramme} vous permet de visualiser la distribution des bandes ou des couleurs dans votre raster. Il se génère automatiquement quand vous accédez à l'onglet \emph{Histogramme}. Toutes les bandes seront représentées ensemble. Vous pouvez exporter une image de l'histogramme grâce au bouton \includegraphics[width=1.5em]{mActionFileSave.png}.


\section{Calculatrice Raster}
\label{docs/user_manual/working_with_raster/raster_calculator:sec-raster-calc}\label{docs/user_manual/working_with_raster/raster_calculator:raster-calculator}\label{docs/user_manual/working_with_raster/raster_calculator::doc}
\index{Raster\_Calculator}
La \emph{Calculatrice Raster} du menu \emph{Raster} (voir {\hyperref[docs/user_manual/working_with_raster/raster_calculator:figure-raster-2]{figure\_raster\_2}}) permet d'opérer des calculs sur la base des valeurs des pixels d'un raster existant. Le résultat est écrit dans un nouveau raster dans un des formats gérés par GDAL.
\phantomsection\label{docs/user_manual/working_with_raster/raster_calculator:figure-raster-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{raster_calculator.png}
\caption{Raster Calculator \includegraphics[width=1em]{nix.png}}\end{figure}

La liste \textbf{Bandes raster} contient toutes les couches rasters actuellement chargées pouvant être utilisées. Pour ajouter un raster à la formule de calcul, faites un double-clic sur son nom dans la liste. Vous pouvez alors utiliser les opérateurs pour construire une formule ou bien les taper directement dans la zone de saisie.

Dans la partie \textbf{Couche de résultat}, vous devez définir la couche en sortie. Vous pouvez préciser l'étendue de la zone de calcul en vous basant sur une des couches raster utilisées ou en spécifiant des coordonnées X et Y ainsi que les nombres de lignes et de colonnes pour indiquer la résolution. Si la couche en entrée a une résolution différente, les valeurs seront interpolées avec l'algorithme du plus proche voisin.

La partie \textbf{Opérateurs} contient tous les opérateurs utilisables. Pour ajouter un opérateur à la formule, cliquez sur le bouton approprié. Les opérateurs mathématiques (\code{+}, \code{-}, \code{*}, ... ) et les fonctions trigonométriques (\code{sin}, \code{cos}, \code{tan}, ... ) sont disponibles, d'autres feront leur apparition !

Le fait de cocher \includegraphics{checkbox.png} \emph{Ajouter le résultat au projet} chargera automatiquement le raster de résultat dans la légende du projet en courant.


\subsection{Exemples}
\label{docs/user_manual/working_with_raster/raster_calculator:examples}
\textbf{Conversion en pieds de données d'élévation en mètres}

Pour créer un raster d'élévation en pieds à partir d'un raster en mètres, vous devez utiliser le facteur de conversion 3,28. La formule est la suivante :

\begin{Verbatim}[commandchars=\\\{\}]
elevation@1 * 3.28
\end{Verbatim}

\textbf{Utilisation d'un masque}

Si vous souhaitez masquer certaines zones d'un raster, par exemple si vous vous intéressez uniquement aux altitudes supérieures à 0, vous pouvez utiliser la formule suivante qui crée un masque et l'applique au raster en une seule étape :

\begin{Verbatim}[commandchars=\\\{\}]
(elevation@1 \textgreater{}= 0) * elevation@1
\end{Verbatim}

Les pixels de valeur supérieure ou égale à 0 prennent la valeur 1, les autres la valeur 0. Ceci permet de créer le masque à la volée.


\chapter{Les données OGC}
\label{docs/user_manual/working_with_ogc/index:working-with-ogc-data}\label{docs/user_manual/working_with_ogc/index:sec-ogc}\label{docs/user_manual/working_with_ogc/index::doc}

\section{Les données OGC}
\label{docs/user_manual/working_with_ogc/ogc_client_support:working-with-ogc}\label{docs/user_manual/working_with_ogc/ogc_client_support::doc}\label{docs/user_manual/working_with_ogc/ogc_client_support:working-with-ogc-data}
QGIS gère le WMS et le WFS comme sources de données.


\subsection{Que sont les données OGC ?}
\label{docs/user_manual/working_with_ogc/ogc_client_support:what-is-ogc-data}
\index{Open\_Geospatial\_Consortium}\index{OGC}
L'OGC (Open Geospatial Consortium) est une organisation internationale à laquelle participent plus de 300 organisations commerciales, gouvernementales, associatives et laboratoires de recherche à travers le monde. Ses membres développent et implémentent des standards pour les services et le contenu géospatial, le traitement de données SIG et les formats d'échange.

Un nombre croissant de spécifications décrivant les modèles de données géographiques sont développées pour servir des besoins spécifiques dans des situations nécessitant une interopérabilité et des technologies géospatiales, dont les SIG. Des informations supplémentaires peuvent être trouvées sur le site \href{http://www.opengeospatial.org}{http://www.opengeospatial.org}.

\index{WMS}\index{WFS}\index{WCS}\index{CAT}\index{SFS}\index{GML}
Les spécifications importantes de l'OGC sont :
\begin{itemize}
\item {} 
\textbf{WMS} --- Web Map Service

\item {} 
\textbf{WFS} --- Web Feature Service

\item {} 
\textbf{WCS} --- Web Coverage Service

\item {} 
\textbf{CAT} --- Web Catalog Service

\item {} 
\textbf{SFS} --- Simple Features for SQL

\item {} 
\textbf{GML} --- Geography Markup Language

\end{itemize}

Les services OGC sont de plus en plus utilisés pour échanger des données géospatiales entre différentes implémentations SIG et des fournisseurs de données. QGIS peut maintenant traiter trois des spécifications citées : le SFS (via PostgreSQL / PostGIS, voir section {\hyperref[docs/user_manual/working_with_vector/supported_data:label-postgis]{\emph{Couches PostGIS}}}), le WFS et le WMS comme client.


\subsection{Client WMS}
\label{docs/user_manual/working_with_ogc/ogc_client_support:wms-client}\label{docs/user_manual/working_with_ogc/ogc_client_support:ogc-wms}
\index{WMS\_client}

\subsubsection{Aperçu de la gestion du WMS}
\label{docs/user_manual/working_with_ogc/ogc_client_support:overview-of-wms-support}\label{docs/user_manual/working_with_ogc/ogc_client_support:ogc-wms-about}\label{docs/user_manual/working_with_ogc/ogc_client_support:index-2}
QGIS peut actuellement agir comme client WMS pour les versions 1.1, 1.1.1 et 1.3 des serveurs WMS. Il a été tout particulièrement testé avec des serveurs accessibles publiquement comme ceux de DEMIS.

Les serveurs WMS agissent en fonction des requêtes envoyées par le client (par exemple QGIS) pour une carte raster avec une étendue donnée, un ensemble de couches, une sémiologie et une transparence. Le serveur WMS consulte alors ses sources de données locales, rasterise la carte et la renvoie au client dans un format raster. Pour QGIS, cela sera par exemple du JPEG ou du PNG.

Un WMS est de manière générale un service web mis en oeuvre selon une architecture REST (Representational State Transfer) plutôt qu'un service RPC (Remote Procedure Call) pleinement déployé. De cette façon, vous pouvez copier les adresses générées par QGIS et les copier dans un navigateur internet pour retrouver les mêmes images que dans QGIS. Cela peut être très pratique pour résoudre des problèmes, car de fait il y a plusieurs serveurs WMS existants ayant chacun leur interprétation du standard WMS.

Des couches WMS peuvent être ajoutées assez simplement, du moment que vous connaissez l'URL pour accéder au serveur WMS, vous avez une connexion sous forme de service sur ce serveur, et celui-ci comprend le protocole HTTP comme mécanisme de transport.


\subsubsection{Sélectionner des serveurs WMS}
\label{docs/user_manual/working_with_ogc/ogc_client_support:ogc-wms-servers}\label{docs/user_manual/working_with_ogc/ogc_client_support:selecting-wms-servers}
La première fois que vous utilisez la fonctionnalité de services WMS, il n'y a aucun serveur défini.

Commencez par cliquer sur le bouton \includegraphics[width=1.5em]{mActionAddWmsLayer.png} $^{\text{Ajoutez une couche WMS}}$ dans la barre des outils ou via le menu \emph{Couche \(\rightarrow\) Ajoutez une couche WMS...}.

La fenêtre \emph{Ajouter des couches depuis un serveur} pour ajouter des couches d'un serveur WMS s'ouvre. Vous pouvez ajouter des serveurs pour tester en cliquant le bouton \textbf{{[}Ajouter les serveurs par défaut{]}}. Cela ajoutera deux serveurs WMS de démonstration : celui de DM Solutions Group et celui de Lizardtech. Pour définir un nouveau serveur WMS, dans l'onglet \emph{Couches}, cliquez sur le bouton \textbf{{[}Nouveau{]}} puis entrez les paramètres de connexion du serveur WMS désiré, comme listé dans le tableau {\hyperref[docs/user_manual/working_with_ogc/ogc_client_support:table-ogc-1]{table\_OGC\_1}}:
\phantomsection\label{docs/user_manual/working_with_ogc/ogc_client_support:table-ogc-1}
\begin{tabulary}{\linewidth}{|L|L|}
\hline

Nom
 & 
Un nom pour cette connexion. Ce nom sera utilisé dans la liste déroulante des connexions aux serveurs afin que vous puissiez le distinguer des autres serveurs WMS.
\\

URL
 & 
URL du serveur fournissant les données. Cela doit être un nom d'hôte publique ; de même format que si vous l'utilisiez pour ouvrir une connexion Telnet ou pinguer un hôte (ou dans un navigateur Internet).
\\

Nom utilisateur
 & 
Nom d'utilisateur pour accéder à un serveur WMS sécurisé. Ce paramètre est optionnel.
\\

Mot de Passe
 & 
Mot de passe pour une authentification basique à un serveur WMS. Ce paramètre est optionnel.
\\

Ignorer l'adresse GetMap
 & 
\includegraphics{checkbox.png} \emph{Ignorer l'adresse GetMap signalée} : force l'utilisation de l'adresse précisée dans le champ URL ci-dessus.
\\

Ignorer l'adresse GetFeatureInfo
 & 
\includegraphics{checkbox.png} \emph{Ignorer l'adresse GetFeatureInfo signalée} : force l'utilisation de l'adresse précisée dans le champ URL ci-dessus.
\\
\hline\end{tabulary}


Table OGC 1 : Paramètres de connexion à un serveur WMS

\index{Proxy}\index{proxy-server}
Si vous devez configurer un serveur proxy pour pouvoir recevoir des services WMS à partir d'Internet, vous pouvez ajouter votre serveur proxy dans les options. Choisissez le menu \emph{Préférences \(\rightarrow\) Options} et cliquez sur l'onglet \emph{Réseau}. Vous pouvez alors ajouter votre configuration de proxy et l'activer en cochant la case \includegraphics{checkbox.png} \emph{Utiliser un proxy pour l'accès Internet}. Assurez-vous que vous avez sélectionné le type de proxy correct dans la liste déroulante:guilabel:\emph{Type de proxy} \includegraphics{selectstring.png}.

Une fois qu'une nouvelle connexion à un serveur WMS a été créée, elle sera sauvegardée pour les futures sessions de QGIS.

\begin{notice}{tip}{Astuce:}
\textbf{À propos des URL des serveurs WMS}

Assurez-vous, lorsque vous entrez l'URL du serveur WMS, d'avoir l'URL de base. Par exemple, vous ne devez pas avoir de paramètres tels que \code{request=GetCapabilities} ou \code{version=1.0.0} dans votre URL.
\end{notice}


\subsubsection{Charger des couches WMS}
\label{docs/user_manual/working_with_ogc/ogc_client_support:loading-wms-layers}\label{docs/user_manual/working_with_ogc/ogc_client_support:ogc-wms-layers}
Une fois avoir rempli correctement vos paramètres, vous pouvez cliquer sur le bouton \textbf{{[}Se connecter{]}} pour récupérer les possibilités du serveur sélectionné. Cela inclut le format d'image, les couches, les styles des couches et les projections. Puisque c'est une opération sur un réseau, la vitesse de la réponse dépend de la qualité de votre connexion réseau au serveur WMS. Pendant le téléchargement des données du serveur WMS, la progression du téléchargement est visualisée en bas à gauche de la fenêtre WMS.

Votre écran doit ressembler un peu plus à la figure {\hyperref[docs/user_manual/working_with_ogc/ogc_client_support:figure-ogr-1]{figure\_OGR\_1}}, qui affiche la réponse fournie par le serveur WMS de DM Solutions Group.
\phantomsection\label{docs/user_manual/working_with_ogc/ogc_client_support:figure-ogr-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{connection_wms.png}
\caption{Dialog for adding a WMS server, showing its available layers \includegraphics[width=1em]{nix.png}}\end{figure}

\textbf{Format d'image}

La section \emph{Format d'image} liste les formats qui sont gérés à la fois par le client et leur serveur. Choisissez en fonction de votre besoin de précision de l'image.

\begin{notice}{tip}{Astuce:}
\textbf{Format d'image}

Les serveurs WMS vous offriront typiquement le choix entre les formats d'image JPEG et PNG. Le JPEG est un format de compression avec perte alors que le PNG reproduit fidèlement les données raster brutes.

Utilisez le JPEG si vous vous attendez à ce que les données WMS soient de nature photographiques et/ou si vous acceptez une perte de qualité dans l'image. Ce compromis réduit généralement de 5 fois le temps de transfert des données par rapport au PNG.

Utilisez le PNG si vous voulez une représentation précise des données d'origine, et vous acceptez des temps de transfert des données plus longs.
\end{notice}

\textbf{Options}

La zoneOptions dipose d'un champ textuel où vous pouvez saisir le \emph{Nom de la couche} WMS. Ce nom sera affiché dans la légende après le chargement de la couche.

Sous le nom de la couche vous pouvez définir la \emph{Taille de tuile} (par exemple 256x256), si vous souhaitez diviser la requête WMS en plusieurs requêtes.

\emph{Limite d'entité de GetFeatureInfo} permet de définir quelles entités requêter sur le serveur.

Si vous sélectionnez un WMS depuis la liste, la projection par défaut, fournie par mapserver, apparaît. Si le bouton \textbf{{[}Modifications...{]}} est actif, vous pouvez cliquer dessus pour changer cette projection par défaut pour une autre, fournie par le serveur WMS.

\textbf{Ordre des couches}

L'onglet \emph{Ordre des couches} liste les couches sélectionnées disponibles pour le serveur WMS actuellement connecté. Certaines couches seront peut-être dépliables, cela signifie que différents styles sont disponibles pour cette couche.

Vous pouvez sélectionner plusieurs couches à la fois, mais seulement un style d'image par couche. Lorsque plusieurs couches sont sélectionnées, celles-ci seront combinées par le serveur WMS et transmises à QGIS en une seule fois.

\begin{notice}{tip}{Astuce:}
\textbf{Ordonner les couches WMS}

Les couches WMS sont superposées par le serveur dans l'ordre listé dans la section Couches, du haut vers le bas. Si vous souhaitez changer cet ordre, utilisez l'onglet \emph{Ordre des couches}.
\end{notice}
\phantomsection\label{docs/user_manual/working_with_ogc/ogc_client_support:ogc-wms-transparency}
\textbf{Transparence}

Dans cette version de QGIS, le paramètre de \emph{Transparence globale} de la fenêtre de  \emph{Propriétés de la couche} est codé en dur pour être toujours activé, si disponible.

\index{WMS\_layer\_transparency}
\begin{notice}{tip}{Astuce:}
\textbf{Transparence des couches WMS}

La disponibilité de la transparence de l'image WMS dépend du format d'image utilisé : les formats PNG et GIF gèrent la transparence, tandis que le format JPEG ne le gère pas.
\end{notice}

\textbf{Système de Coordonnées de Référence}

\index{Coordinate\_Reference\_System}\index{SRS}\index{CRS}
Un système de Coordonnées de Référence de (SCR) est la terminologie de l'OGC pour désigner une projection QGIS.

Chaque couche WMS peut être représentée dans plusieurs projections (ou SCR), en fonction des possibilités du serveur WMS.

Pour choisir un SCR, cliquez sur le bouton \textbf{{[}Modifications...{]}} et une fenêtre similaire à la figure de la section {\hyperref[docs/user_manual/working_with_projections/working_with_projections:label-projections]{\emph{Utiliser les projections}}} apparaitra. La principale différence est qu'ici seules les projections gérées par le serveur seront listées.


\subsubsection{Recherche de serveur}
\label{docs/user_manual/working_with_ogc/ogc_client_support:server-search}\label{docs/user_manual/working_with_ogc/ogc_client_support:serversearch}
Dans QGIS vous pouvez rechercher directement des serveurs WMS.  La figure {\hyperref[docs/user_manual/working_with_ogc/ogc_client_support:figure-ogc-2]{Figure\_OGC\_2}} montre l'onglet \emph{Recherche de serveurs} de la fenêtre \emph{Ajouter des couches d'un serveur}.
\phantomsection\label{docs/user_manual/working_with_ogc/ogc_client_support:figure-ogc-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{wms_server_search.png}
\caption{Dialog for searching WMS servers after some keywords \includegraphics[width=1em]{nix.png}}\end{figure}

Comme vous pouvez le voir, il est possible d'entrer une chaîne de recherche dans un champ texte puis cliquez sur le bouton \textbf{{[}Chercher{]}}. Après un court moment d'attente, le résultat de la recherche sera affiché sous le champ texte. Parcourez la liste et inspectez les résultats de la recherche dans le tableau. Pour visualiser le résultat, sélectionnez un serveur, cliquez sur le bouton \textbf{{[}Ajoutez les lignes sélectionnées à la liste des serveurs WMS{]}} et retournez sur l'onglet \emph{Couches}. QGIS a automatiquement mis à jour votre liste de serveur et les résultats sélectionnés de la recherche sont déjà activés dans la liste des serveurs WMS sauvés. Vous n'avez plus qu'à interroger la liste des couches en cliquant sur le bouton \textbf{{[}Connecter{]}}. Cette option est pratique quand vous voulez chercher des couches par des mots clés spécifiques.

Fondamentalement cette option est un frontend à l'API de \href{http://geopole.org}{http://geopole.org}.


\subsubsection{Jeux de Tuiles}
\label{docs/user_manual/working_with_ogc/ogc_client_support:id1}\label{docs/user_manual/working_with_ogc/ogc_client_support:tilesets}
\index{WMS\_tiles}\index{WMS-C}
Lorsque vous utilisez des services WMS-C (WMS en cache) comme \href{http://labs.metacarta.com/wms-c/Basic.py}{http://labs.metacarta.com/wms-c/Basic.py}, vous avez la possibilité de parcourir l'onglet \emph{Jeu de tuiles}. Des informations supplémentaires comme la taille des tuiles, les formats et les SCR gérés sont listés ici. De plus vous pouvez utilisez la barre d'échelle des tuiles via le menu \emph{Vue \(\rightarrow\) Barre d'échelle des tuiles} qui vous donne les échelles auxquelles les tuiles sont disponibles avec la possibilité de changer d'échelle facilement grâce au curseur.


\subsubsection{Utiliser l'outil Identifier}
\label{docs/user_manual/working_with_ogc/ogc_client_support:ogc-wms-identify}\label{docs/user_manual/working_with_ogc/ogc_client_support:using-the-identify-tool}
\index{WMS\_identify}
Une fois que vous avez ajouté un serveur WMS et si une couche du serveur WMS est interrogeable, vous pouvez utiliser l'outil \includegraphics[width=1.5em]{mActionIdentify.png} $^{\text{Identifier}}$ pour sélectionner un pixel sur la carte. Une requête est envoyée au serveur WMS pour chaque sélection effectuée. Les résultats de la requête sont renvoyés au format texte. Le formatage de ce texte dépend du serveur WMS utilisé.
\phantomsection\label{docs/user_manual/working_with_ogc/ogc_client_support:ogc-wms-properties}
\textbf{Visualiser les propriétés}

\index{WMS\_properties}
Une fois que vous avez ajouté un serveur WMS, vous pouvez voir ses propriétés en faisant un clic-droit sur la couche dans la légende et en sélectionnant \emph{Propriétés}.
\phantomsection\label{docs/user_manual/working_with_ogc/ogc_client_support:ogc-wms-properties-metadata}
\textbf{Onglet Métadonnées}

\index{WMS\_metadata}
L'onglet \emph{Métadonnées} affiche la richesse des informations du serveur WMS, généralement collectées à partir de la requête Capabilities renvoyée par le serveur. Beaucoup de définitions peuvent être obtenues par la lecture des normes WMS (voir OPEN-GEOSPATIAL-CONSORTIUM {\hyperref[docs/user_manual/literature_web/literature_and_web_references:literature-and-web]{\emph{Bibliographie}}}), mais en voici quelques-unes :
\begin{itemize}
\item {} 
\textbf{Propriétés du serveur}
\begin{itemize}
\item {} 
\textbf{Version du WMS} --- La version de WMS gérée par le serveur.

\item {} 
\textbf{Formats d'image} --- La liste des types MIME que le serveur peut renvoyer lors qu'il dessine la carte. QGIS gère tous les formats pour lesquelles la bibliothèque Qt en sous-couche a été compilée, qui sont à minima les types \code{image/png} et \code{image/jpeg}.

\item {} 
\textbf{Formats de l'outil Identitier} --- La liste des types MIME auxquels le serveur peut répondre quand vous utilisez l'outil Identifier. Pour l'instant QGIS gère le type \code{text-plain}.

\end{itemize}

\item {} 
\textbf{Propriétés de la couche}
\begin{itemize}
\item {} 
\textbf{Selectionnée} --- Si la couche a été sélectionnée quand le serveur correspondant a été ajouté au projet.

\item {} 
\textbf{Visible} --- Si cette couche a été sélectionnée comme visible dans la légende (pas encore utilisé dans cette version de QGIS).

\item {} 
\textbf{Peut identifier} --- Si cette couche retournera des résultats quand l'outil Identifier est utilisé sur celle-ci.

\item {} 
\textbf{Peut être transparente} --- Si cette couche peut être rendue avec une transparence. Cette version de QGIS utilisera toujours la transparence si cette option est à \code{Oui} et que le format d'image gère la transparence.

\item {} 
\textbf{Peut zoomer} --- Si on peut zoomer sur cette couche avec le serveur. Cette version de QGIS suppose que toutes les couches WMS ont ce paramètre défini à \code{Oui}. Les couches déficientes seront peut-être rendues d'une manière étrange.

\item {} 
\textbf{Décompte des cascades} --- Les serveurs WMS peuvent agir comme un proxy à d'autres serveurs WMS pour obtenir des données pour une couche. Cette entrée affiche le nombre de fois où la requête pour cette couche est redirigée vers un autre serveur WMS pour obtenir un résultat.

\item {} 
\textbf{Largeur fixe, hauteur fixe} --- Si les pixels sources d'une couche ont des dimensions fixes. Cette version de QGIS suppose que toutes les couches WMS ont ce paramètre non fixé. Les couches déficientes seront peut-être rendues d'une manière étrange.

\item {} 
\textbf{Emprise en WGS 84} --- La limite du contour de la couche, en coordonnées WGS 84. Certains serveurs WMS ne définissent pas ceci correctement (par exemple, des coordonnées UTM sont utilisées à la place). Si cela est le cas, alors la vue initiale sera rendue avec une vue très étendue. Le webmaster du WMS doit être informé de cette erreur sur ce paramètre qui est certainement connu en tant qu'éléments XML du WMS \code{LatLonBoundingBox}, \code{EX\_GeographicBoundingBox} ou the CRS:84 \code{BoundingBox}.

\item {} 
\textbf{Disponibilité des SCR} --- Les projections que l'on peut utiliser via le serveur WMS. Elles sont listées dans le format natif du WMS.

\item {} 
\textbf{Disponibilité des styles} --- Les styles d'images que le serveur WMS peut utiliser pour le rendu de cette couche.

\end{itemize}

\end{itemize}


\subsubsection{Limitations du client WMS}
\label{docs/user_manual/working_with_ogc/ogc_client_support:ogc-wms-limits}\label{docs/user_manual/working_with_ogc/ogc_client_support:wms-client-limitations}
Toutes les fonctionnalités d'un client WMS n'ont pas été intégrées dans cette version de QGIS. Les exceptions les plus notables sont présentées ci-après.

\textbf{Éditer la configuration d'une couche WMS}

Une fois que vous avez complété la procédure d'  \includegraphics[width=1.5em]{mActionAddWmsLayer.png} $^{\text{Ajout de couches WMS}}$, il n'y aucun moyen de modifier la configuration. Une solution de contournement consiste à supprimer la couche et recommencer.

\textbf{Serveurs WMS nécessitant une authentification}

Actuellement les serveurs WMS publics et sécurisés sont gérés. Les serveurs sécurisés sont accessibles via authentification publique. Vous pouvez ajouter ces informations d'authenfication au moment de l'ajout d'un serveur WMS. Voir la section {\hyperref[docs/user_manual/working_with_ogc/ogc_client_support:ogc-wms-servers]{\emph{Sélectionner des serveurs WMS}}} pour les détails.

\index{InteProxy}\index{Secured\_OGC\_Authentication}
\begin{notice}{tip}{Astuce:}
\textbf{Accéder à des couches OGC sécurisées}

Si vous avez besoin d'accéder à des couches sécurisées avec d'autres méthodes sécurisées que des authentifications basiques, vous pouvez utiliser InteProxy comme proxy transparent, qui gère plusieurs méthodes d'authentification. Vous pouvez trouver plus d'informations dans le manuel d'InteProxy que vous trouverez sur le site \href{http://inteproxy.wald.intevation.org}{http://inteproxy.wald.intevation.org}.
\end{notice}

\index{QGIS\_mapserver}\index{WMS\_1.3.0}
\begin{notice}{tip}{Astuce:}
\textbf{QGIS WMS Mapserver}

Depuis la version 1.7.0, QGIS possède sa propre implémentation d'un Mapserver WMS 1.3.0. Référez vous au chapitre {\hyperref[docs/user_manual/working_with_ogc/ogc_server_support:label-qgisserver]{\emph{Serveur QGIS}}} pour en savoir plus.
\end{notice}


\subsection{Client WFS et WFS-T}
\label{docs/user_manual/working_with_ogc/ogc_client_support:ogc-wfs}\label{docs/user_manual/working_with_ogc/ogc_client_support:wfs-and-wfs-t-client}
\index{WFS}\index{WFS-T}\index{WFS\_Transactional}
Dans QGIS, une couche WFS se comporte à peu près comme n'importe quelle autre couche vecteur. Vous pouvez identifier et sélectionner des objets et voir la table attributaire. Depuis QGIS 1.6, l'édition (WFS-T) est prise en charge si le serveur le propose.

Dans l'ensemble, l'ajout d'une couche WFS suit une procédure très similaire à celle des couches WMS. La différence est qu'il n'y a pas de serveur défini par défaut, nous allons donc devoir en ajouter un.

\textbf{Charger une couche WFS}

Pour notre exemple nous utiliserons le serveur WFS de DM Solutions et afficherons une couche. L'URL est : \href{http://www2.dmsolutions.ca/cgi-bin/mswfs\_gmap}{http://www2.dmsolutions.ca/cgi-bin/mswfs\_gmap}
\begin{enumerate}
\item {} 
Cliquez sur le bouton \includegraphics[width=1.5em]{wfs.png} $^{\text{Ajouter une couche WFS}}$ de la barre d'outils Couches, la fenêtre \emph{Ajouter une couche WFS d'un serveur} apparaît.

\item {} 
Cliquez sur \textbf{{[}Nouveau{]}}

\item {} 
Entrez `DM Solutions' pour le nom

\item {} 
Entrez l'URL (voir ci-dessus)

\item {} 
Cliquez sur \textbf{{[}OK{]}}

\item {} 
Choisissez `DM Solutions' dans la liste déroulante \emph{Connexions au serveur:} \includegraphics{selectstring.png}.

\item {} 
Cliquez sur \textbf{{[}Connexion{]}}

\item {} 
Attendez que la liste des couches soit complète

\item {} 
Cliquez sur la couche \emph{Parks} dans la liste

\item {} 
Cliquez sur \textbf{{[}Appliquer{]}} pour ajouter la couche à la carte

\end{enumerate}

Notez que les paramètres proxy que vous avez définis dans vos préférences sont également reconnus.
\phantomsection\label{docs/user_manual/working_with_ogc/ogc_client_support:figure-ogc-3}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{connection_wfs.png}
\caption{Adding a WFS layer \includegraphics[width=1em]{nix.png}}\end{figure}

Vous remarquerez que la progression du téléchargement est affichée en bas à gauche de la fenêtre principale de QGIS. Une fois que la couche est chargée, vous pouvez identifier et sélectionner une ou deux provinces et visualiser la table d'attributs.

Seul le WFS 1.0.0 est géré. Pour le moment il n'y a pas eu de test pour les autres versions des services WFS des serveurs WFS. Si vous rencontrez des problèmes avec d'autres serveurs WFS, n'hésitez pas à contacter l'équipe de développement. Référez-vous à la section {\hyperref[docs/user_manual/preamble/help_and_support:label-helpsupport]{\emph{Listes de diffusion}}} pour plus d'informations sur les listes de diffusions.

\begin{notice}{tip}{Astuce:}
\textbf{Trouver des serveurs WFS}

Vous trouverez d'autres serveurs WFS en cherchant dans votre moteur de recherche favori. Il existe de nombreuses listes d'URL publiques, plus ou moins à jour.
\end{notice}

\index{QGIS\_Server}\index{FastCGI}\index{CGI}\index{Common\_Gateway\_Interface}

\section{Serveur QGIS}
\label{docs/user_manual/working_with_ogc/ogc_server_support:index-0}\label{docs/user_manual/working_with_ogc/ogc_server_support:qgis-server}\label{docs/user_manual/working_with_ogc/ogc_server_support::doc}\label{docs/user_manual/working_with_ogc/ogc_server_support:label-qgisserver}
Le Serveur QGIS est une implémentation open source du WMS 1.3 et WFS 1.0.0 qui propose de plus des fonctionnalités avancées de rendu cartographique. Il s'agit d'une application FastCGI/CGI (Common Gateway Interface) écrite en C++ qui tourne sur un serveur web (par exemple Apache ou Lighttpd). Il est financé par les projets Orchestra et Sany de l'Union Européenne et la ville d'Uster en Suisse.

\index{SLD}\index{SLD/SE}
Il utilise QGIS comme backend pour la logique des couches SIG et le rendu cartographique. La bibliothèque Qt est utilisée pour l'interface et la programmation multiplateforme en C++. À la différence des autres serveurs WMS, le Serveur QGIS utilise les règles de cartographie comme langage de configuration, à la fois pour la configuration du serveur et pour les règles cartographiques définie par l'utilisateur.

\index{Publish\_to\_Web\_plugin}
De plus, le projet de Serveur QGIS fournit l'extention `Publish to Web', une extention de QGIS desktop qui exporte les couches courantes et la symbologie dans un projet web pour le Serveur QGIS (contenant les règles de visualisation cartographiques au format SLD).

Les Serveur QGIS utilise les mêmes bibliothèques de visualisation que QGIS desktop : les cartes publiées sur le web ont le même rendu que celles de QGIS desktop. L'extention `Publish to Web' gère pour le moment la sémiologie basique et des règles cartographiques plus complexes paramétrées manuellement. Comme la configuration se base sur le \href{http://www.opengeospatial.org/standards/sld}{standard SLD} et ses extensions, il n'y a qu'un seul langage standardisé à apprendre, ce qui simplifie grandement la complexité de création de cartes pour le web.

Dans un prochain manuel de QGIS, nous fournirons un exemple de configuration pour mettre en place un Serveur QGIS. Pour le moment, nous vous recommandons de vous référer aux sites suivants pour obtenir plus d'informations :
\begin{itemize}
\item {} 
\href{http://karlinapp.ethz.ch/qgis\_wms/}{http://karlinapp.ethz.ch/qgis\_wms/}

\item {} 
\href{http://hub.qgis.org/projects/quantum-gis/wiki/QGIS\_Server\_Tutorial}{http://hub.qgis.org/projects/quantum-gis/wiki/QGIS\_Server\_Tutorial}

\item {} 
\href{http://linfiniti.com/2010/08/qgis-mapserver-a-wms-server-for-the-masses/}{http://linfiniti.com/2010/08/qgis-mapserver-a-wms-server-for-the-masses/}

\end{itemize}

\index{apache}\index{apache2}\index{Debian\_Squeeze}

\subsection{Installation test sur Debian Squeeze}
\label{docs/user_manual/working_with_ogc/ogc_server_support:sample-installation-on-debian-squeeze}\label{docs/user_manual/working_with_ogc/ogc_server_support:index-3}
Nous fournissons ici que de courtes et simples explications sur l'installation sur Debian Squeeze. De nombreux autres systèmes d'exploitation proposent des paquets pour le Serveur QGIS. Si vous devez les compiler depuis le source, référez-vous aux URL ci-dessus.

En plus de qgis et qgis-mapserver, vous avez besoin d'un serveur web, dans notre exemple apache2. Vous pouvez installer tous ces paquets et leurs dépendances nécessaires avec aptitude ou apt-get install. Après l'installation vous devez tester si le serveur web et le serveur QGIS fonctionnent comme prévu. Assurez vous que le serveur Apache tourne avec \code{/etc/init.d/apache2 start}. Ouvrez un navigateur web et tapez l'URL \code{http://localhost}. Si Apache fonctionne, vous devriez voir le message `It works!'.

Testons maintenant l'installation du serveur QGIS. Le fichier \code{qgis\_mapserv.fcgi} est disponible dans \code{/usr/lib/cgi-bin/qgis\_mapserv.fcgi} et fournit un WMS standard qui affiche les frontières de l'Alaska. Ajoutez le WMS via l'URL \code{http://localhost/cgi-bin/qgis\_mapserv.fcgi} comme expliqué dans {\hyperref[docs/user_manual/working_with_ogc/ogc_client_support:ogc-wms-servers]{\emph{Sélectionner des serveurs WMS}}}.
\phantomsection\label{docs/user_manual/working_with_ogc/ogc_server_support:figure-server-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{standard_wms_usa.png}
\caption{Standard WMS with USA boundaries included in the qgis server (KDE) \includegraphics[width=1em]{nix.png}}\end{figure}


\subsection{Créer un WMS / WFS depuis un projet QGIS}
\label{docs/user_manual/working_with_ogc/ogc_server_support:creating-a-wms-wfs-from-a-qgis-project}\label{docs/user_manual/working_with_ogc/ogc_server_support:creating-a-wms-from-a-qgis-project}
Pour créer un nouveau serveur WMS/WFS, nous devons créer un fichier de projet QGIS avec quelques données. Nous utiliserons ici le shapefile `alaska' de l'échantillon de données test de QGIS. Définissez les couleurs et les styles des couches dans QGIS, ainsi que le SCR si ce n'est pas déjà fait.
\phantomsection\label{docs/user_manual/working_with_ogc/ogc_server_support:figure-server-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{ows_server_definition.png}
\caption{Definitions for a qgis project WMS/WFS server (KDE)}\end{figure}

Ouvrez ensuite l'onglet \code{Serveur OWS} depuis le menu \emph{Préférences \(\rightarrow\) Propriétés du projet} et renseignez les champs concernant les `Capacités du serveur'. Concernant les \code{Capacités WMS}, précisez les `Restrictions de système de coordonnées' et l'Emprise annoncée.Vous pouvez également cocher la case \includegraphics{checkbox.png} \emph{Ajouter une géométrie WKT à la réponse de l'entité} pour que les couches soient interrogeables et imposer  une `Largeur maximale' et une `Hauteur maximale' sur les requêtes. Pour les \code{Capacités WFS}, il suffit juste de sélectionner les couches que vous souhaiter publier en WFS. Sauvegardez le projet sous \code{alaska.qgs}. Pour diffuser le projet en WMS/WFS, il reste à créer un nouveau répertoire \code{/usr/lib/cgi-bin/project} avec les droits d'administration, y ajouter le fichier de projet \code{alaska.qgs} et copier le fichier \code{qgis\_mapserv.fcgi} - c'est tout !

Nous pouvons maintenant tester notre projet WMS et WFS. Ajoutez le WMS et WFS dans QGIS tel que décrit dans {\hyperref[docs/user_manual/working_with_ogc/ogc_client_support:ogc-wms-layers]{\emph{Charger des couches WMS}}} et {\hyperref[docs/user_manual/working_with_ogc/ogc_client_support:ogc-wfs]{\emph{Client WFS et WFS-T}}} et chargez le WMS. L'URL est la suivante :

\begin{Verbatim}[commandchars=\\\{\}]
http://localhost/cgi-bin/project/qgis\_mapserv.fcgi
\end{Verbatim}


\chapter{Les données GPS}
\label{docs/user_manual/working_with_gps/index::doc}\label{docs/user_manual/working_with_gps/index:working-with-gps-data}

\section{Extension GPS}
\label{docs/user_manual/working_with_gps/plugins_gps:plugin-gps}\label{docs/user_manual/working_with_gps/plugins_gps:gps-plugin}\label{docs/user_manual/working_with_gps/plugins_gps::doc}

\subsection{Qu'est ce que le GPS ?}
\label{docs/user_manual/working_with_gps/plugins_gps:what-is-gps}\label{docs/user_manual/working_with_gps/plugins_gps:whatsgps}
Le GPS, Global Positioning System, est un système basé sur des satellites qui permet à toute personne possédant un récepteur GPS d'obtenir sa position exacte n'importe où dans le monde. Il est utilisé comme aide à la navigation, par exemple pour les avions, dans les bateaux et par les voyageurs. Le récepteur GPS utilise les signaux des satellites pour calculer la latitude, la longitude et (parfois) l'élévation. La plupart des récepteurs ont également la possibilité de stocker la position (nommé \emph{waypoints}), des séquences de positions qui constituent un \emph{itinéraire} prévu et un tracklog ou \emph{track} des déplacements du récepteur en fonction du temps. Waypoints, itinéraires et tracks sont les trois types d'objet basiques dans les données GPS. QGIS affiche les waypoints dans des couches points tandis que les itinéraires et les tracks sont affichés dans des couches linéaires.


\subsection{Charger des données GPS à partir d'un fichier}
\label{docs/user_manual/working_with_gps/plugins_gps:loading-gps-data-from-a-file}\label{docs/user_manual/working_with_gps/plugins_gps:label-loadgps}
Il y a des dizaines de formats de fichier différent pour stocker des données GPS. Le format que QGIS utilise est appelé GPX (GPS eXchange format), qui est un format d'échange standard qui peut contenir n'importe quel nombre de waypoints, itinéraires et tracks dans un même fichier.

Pour charger un fichier GPX vous devez d'abord charger l'extension : aller dans \emph{Extensions \(\rightarrow\)} \includegraphics[width=1.5em]{mActionShowPluginManager.png} \emph{Gestionnaire d'extensions} puis cochez la case \includegraphics{checkbox.png} \emph{Outils GPS}. Quand l'extension est chargée, deux boutons avec un petit périphérique GPS apparaîssent dans la barre d'outils :
\begin{itemize}
\item {} 
\includegraphics[width=1.5em]{gps_importer.png} $^{\text{Créer une nouvelle couche GPX}}$

\item {} 
\includegraphics[width=1.5em]{gps_importer.png} $^{\text{Outils GPS}}$

\end{itemize}

Pour travailler sur des données GPS, nous utiliserons le fichier GPX fournit dans le jeu de données test de QGIS : \code{qgis\_sample\_data/gps/national\_monuments.gpx}. Référez-vous à la section {\hyperref[docs/user_manual/introduction/getting_started:label-sampledata]{\emph{Échantillon de données}}} pour plus d'informations sur le jeu de données test.
\begin{enumerate}
\item {} 
cliquez sur le bouton \includegraphics[width=1.5em]{gps_importer.png} $^{\text{Outils GPS}}$ et ouvrez l'onglet \emph{Charger un fichier GPX} (voir {\hyperref[docs/user_manual/working_with_gps/plugins_gps:figure-gps-1]{figure\_GPS\_1}}).

\item {} 
Naviguez vers le répertoire \code{qgis\_sample\_data/gps/}, sélectionnez le fichier \code{national\_monuments.gpx} et cliquez sur le bouton \textbf{{[}Ouvrir{]}}.

\end{enumerate}
\phantomsection\label{docs/user_manual/working_with_gps/plugins_gps:figure-gps-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{loadgpx.png}
\caption{The \emph{GPS Tools} dialog window \includegraphics[width=1em]{nix.png}}\end{figure}

Utilisez le bouton \textbf{{[}Parcourir{]}} pour sélectionner le fichier GPX, puis utilisez la case à cocher pour sélectionner les types de géométrie que vous voulez charger à partir de ce fichier GPX. Chaque type d'objet sera chargé dans une couche séparée lors du clic sur le bouton \textbf{{[}OK{]}}. Le fichier \code{national\_monuments.gpx} ne contient que des waypoints.

\begin{notice}{note}{Note:}
Les récepteurs GPS permettent de stocker des données dans différents systèmes de coordonnées. Lorsque vous récupérez un fichier GPX (depuis votre GPS ou un site web) et le chargez dans QGIS, assurez-vous que les données sont dans le système WGS84 (latitude/longitude). Cela correspond à la spécification officielle du format GPX et QGIS la suit. Voir \href{http://www.topografix.com/GPX/1/1/}{http://www.topografix.com/GPX/1/1/}
\end{notice}


\subsection{GPSBabel}
\label{docs/user_manual/working_with_gps/plugins_gps:gpsbabel}
Comme QGIS ne lit que les fichiers GPS au format GPX, vous avez besoin d'un moyen pour convertir les autres formats de fichier GPS en GPX. Le logiciel libre GPSBabel le fait pour de nombreux formats. Il est disponible sur \href{http://www.gpsbabel.org}{http://www.gpsbabel.org}. Ce programme peut aussi transférer des données GPS entre votre ordinateur et un périphérique GPS. QGIS utilise GPSBabel pour réaliser ces tâches, il est donc recommandé de l'installer. Cependant si vous voulez juste charger des données à partir de fichiers GPX vous n'en avez pas besoin. La version 1.2.3 de GPSBabel est connue pour bien fonctionner avec QGIS, mais vous pouvez devriez pouvoir utiliser des versions plus récentes sans problème.


\subsection{Importer des données GPS}
\label{docs/user_manual/working_with_gps/plugins_gps:importing-gps-data}
Pour importer des données d'un fichier qui n'est pas un fichier GPX, vous devez utiliser l'outil \emph{Importer un autre fichier} dans la fenêtre des outils GPS. Vous sélectionnez le fichier que vous voulez importer, le type de géométrie, l'emplacement où stocker le fichier GPX converti et sous quel nom l'enregistrer. Tous les formats de données GPS ne supportent pas les trois types d'entités, ne vous laissant le choix qu'entre un ou deux types.


\subsection{Télécharger des données GPS à partir d'un périphérique}
\label{docs/user_manual/working_with_gps/plugins_gps:downloading-gps-data-from-a-device}
QGIS peut utiliser GPSBabel pour télécharger des données d'un périphérique GPS directement vers de nouvelles couches vecteurs. Pour cela, utilisez l'onglet \emph{Télécharger depuis le récepteur GPS} de la fenêtre Outils GPS (voir {\hyperref[docs/user_manual/working_with_gps/plugins_gps:figure-gps-2]{Figure\_GPS\_2}}). Vous y choisissez votre type de périphérique GPS, le port auquel il est connecté (ou usb si le GPS le permet), le type de géométrie que vous voulez télécharger, le fichier GPX où les données seront stockées et le nom de la nouvelle couche.
\phantomsection\label{docs/user_manual/working_with_gps/plugins_gps:figure-gps-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{download.png}
\caption{The download tool}\end{figure}

Le type de périphérique que vous sélectionnez dans le menu périphérique GPS détermine comment GPSBabel tente de communiquer avec votre périphérique GPS. Si aucun des types ne fonctionne avec votre périphérique GPS, vous pouvez créer un nouveau type adapté (voir la section {\hyperref[docs/user_manual/working_with_gps/plugins_gps:defining-new-device]{\emph{Définir de nouveaux types de périphériques}}}).

Le port porte peut-être un nom de fichier ou un autre nom que votre système d'exploitation utiliserait comme une référence du port physique auquel le périphérique GPS est connecté. Il peut s'agir plus simplement du port USB, pour les appareils GPS qui le permettent.
\begin{itemize}
\item {} 
\includegraphics[width=1em]{nix.png} Sous Linux cela ressemble à \code{/dev/ttyS0} ou \code{/dev/ttyS1}

\item {} 
\includegraphics[width=1em]{win.png} Sous Windows à \code{COM1} ou \code{COM2}.

\end{itemize}

Quand vous cliquez sur le bouton \textbf{{[}OK{]}} les données seront téléchargées du périphérique et apparaîtront dans une couche dans QGIS.


\subsection{Envoyer des données GPS vers un appareil}
\label{docs/user_manual/working_with_gps/plugins_gps:uploading-gps-data-to-a-device}
Vous pouvez également envoyer directement vos données depuis une couche vecteur de QGIS vers un périphérique GPS en utilisant l'onglet  \emph{Uploader vers le GPS} de la fenêtre des Outils GPS. Pour le faire, vous devez sélectionner la couche que vous voulez envoyer (qui doit être au format GPX), le type de votre périphérique GPS et le port (com ou USB) auquel il est connecté. De la même manière que pour l'outil de téléchargement, vous pouvez définir de nouveaux types de périphérique si le vôtre n'est pas dans la liste.

Cet outil est très utile lorsque combiné avec les capacités d'édition vectorielle de QGIS. Il permet de charger une carte, créer des points et des itinéraires, puis de les envoyer pour les utiliser dans votre périphérique GPS.


\subsection{Définir de nouveaux types de périphériques}
\label{docs/user_manual/working_with_gps/plugins_gps:defining-new-device-types}\label{docs/user_manual/working_with_gps/plugins_gps:defining-new-device}
Il y a beaucoup de types différents de périphériques GPS. Les développeurs de QGIS ne peuvent pas les tester tous, si vous en avez un qui ne fonctionne pas avec un des types de périphériques dans les outils \emph{Uploader vers le GPS} et \emph{Télécharger depuis le récepteur GPS}, vous pouvez définir votre propre type de périphérique. Cela se fait via l'éditeur de périphérique GPS en cliquant sur le bouton \textbf{{[}Éditer les périhériques{]}} depuis les onglets d'upload et de téléchargement.

Pour définir un nouveau périphérique, vous cliquez sur le bouton \textbf{{[}Nouveau{]}}, entrez un nom, les commandes de téléchargement et d'envoi de données vers votre GPS et cliquez sur le bouton \textbf{{[}Mise à jour{]}}. Le nom sera listé dans la liste des périphériques des onglets de téléchargement et d'upload, il peut s'agir de n'importe quelle chaîne de caractère. La commande de téléchargement est la commande qui est utilisée pour récupérer les données du périphérique vers un fichier GPX. Il s'agira certainement une commande GPSBabel, mais vous pouvez utiliser un autre programme en ligne de commande qui crée un fichier GPX. QGIS remplacera les mots clé \code{\%type}, \code{\%in}, et \code{\%out} lorsqu'il lancera la commande.

\code{\%type} sera remplacé par \code{-w} si vous téléchargez des waypoints, \code{-r}  pour des routes et  \code{-t} pour des tracks. Ce sont des options de la ligne de commande qui présice à GPSBabel quel type d'objet télécharger.

\code{\%in} sera remplacé par le port que vous avez choisi dans l'onglet de téléchargement et \code{\%out} sera remplacé par le nom choisi pour le fichier GPX où les données téléchargées doivent être stockées. Donc si vous créez un type de périphérique avec la commande de téléchargement \code{gpsbabel \%type -i garmin -o gpx \%in \%out} (qui correspond à celle définie pour le type `Garmin serial') et l'utilisez pour télécharger les waypoints depuis le port \code{/dev/ttyS0} vers le fichier \code{output.gpx}, QGIS remplacera les mots-clés et lancera lacommande \code{gpsbabel -w -i garmin -o gpx /dev/ttyS0 output.gpx}.

La commande de téléchargement est la commande qui est utilisée pour télécharger des données vers le périphérique. Les même mots-clés sont utilisés mais \code{\%in} est maintenant remplacé par le nom du fichier GPX pour la couche qui est à uploader et \code{\%out} est remplacé par le nom du port.

Pour en savoir plus sur GPSBabel et les options de ligne de commande disponibles, référez-vous à \href{http://www.gpsbabel.org}{http://www.gpsbabel.org}.

Une fois le nouveau type de périphérique créé, celui-ci apparaitra dans les listes de périphériques des outils de téléchargement et d'upload.


\section{Suivi GPS en direct}
\label{docs/user_manual/working_with_gps/live_GPS_tracking:sec-gpstracking}\label{docs/user_manual/working_with_gps/live_GPS_tracking:live-gps-tracking}\label{docs/user_manual/working_with_gps/live_GPS_tracking::doc}
Pour activer le suivi GPS en direct dans QGIS, sélectionnez le menu \emph{Vue \(\rightarrow\)} \includegraphics{checkbox.png} \emph{Panneaux / Informations GPS}. Une nouvelle fenêtre sera ancrée à gauche de la carte.

Cette fenêtre propose quatre écrans différents :
\begin{itemize}
\item {} 
\includegraphics[width=1.5em]{mActionToggleEditing.png} Coordonnées de la position GPS et saisie manuelle de sommets et d'entités.

\item {} 
\includegraphics[width=1.5em]{gpstrack_barchart.png} Force des signaux GPS des satellites connectés.

\item {} 
\includegraphics[width=1.5em]{gpstrack_polarchart.png} Graphe polaire montrant le numéro et la position des satellites.

\item {} 
\includegraphics[width=1em]{mActionOptions.png} Écran des options GPS (voir {\hyperref[docs/user_manual/working_with_gps/live_GPS_tracking:figure-gps-options]{figure\_gps\_options}}).

\end{itemize}

Avec un récepteur GPS connecté (il doit être compatible avec votre système d'exploitation), un simple clic sur \textbf{{[}Connexion{]}} connecte le GPS à QGIS. Un second clic (maintenant sur \textbf{{[}Déconnexion{]}}), déconnecte le récepteur de l'ordinateur. Sous GNU/Linux, le support gpsd est intégré afin de gérer la connexion de la majorité des récepteurs GPS. De ce fait, vous devez préalablement configurer gpsd pour y connecter QGIS correctement.

\begin{notice}{warning}{Warning:}
Si vous désirez enregistrer votre position sur la carte, vous devez, au préalable, créer une nouvelle couche et la passer en mode édition.
\end{notice}


\subsection{Coordonnées de la position}
\label{docs/user_manual/working_with_gps/live_GPS_tracking:position-and-additional-attributes}
\includegraphics[width=1.5em]{mActionToggleEditing.png} Si le GPS reçoit les signaux d'un nombre suffisant de satellites, vous verrez votre position exprimée en latitude, longitude et élévation ainsi que d'autres attributs.
\phantomsection\label{docs/user_manual/working_with_gps/live_GPS_tracking:figure-gps-position}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=10em]{gpstrack_main.png}
\caption{GPS tracking position and additional attributes \includegraphics[width=1em]{nix.png}}\end{figure}


\subsection{Force du signal GPS}
\label{docs/user_manual/working_with_gps/live_GPS_tracking:gps-signal-strength}
\includegraphics[width=1.5em]{gpstrack_barchart.png} Cet écran affiche la force des signaux GPS des satellites connectés sous forme de barres.
\phantomsection\label{docs/user_manual/working_with_gps/live_GPS_tracking:figure-gps-strength}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=10em]{gpstrack_stren.png}
\caption{GPS tracking signal strength \includegraphics[width=1em]{nix.png}}\end{figure}


\subsection{Graphe polaire}
\label{docs/user_manual/working_with_gps/live_GPS_tracking:gps-polar-window}
\includegraphics[width=1.5em]{gpstrack_polarchart.png} Si vous voulez connaître la position des satellites connectés, vous devez passer à l'écran du graphe polaire. Vous y voyez également les identifiants ID des satellites dont vous recevez un signal.
\phantomsection\label{docs/user_manual/working_with_gps/live_GPS_tracking:figure-gps-polar}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=10em]{gpstrack_polar.png}
\caption{GPS tracking polar window \includegraphics[width=1em]{nix.png}}\end{figure}


\subsection{Configuration GPS}
\label{docs/user_manual/working_with_gps/live_GPS_tracking:gps-options}
\includegraphics[width=1em]{mActionOptions.png} Si vous avez des problèmes de connexion, vous pouvez tester :
\begin{itemize}
\item {} 
\includegraphics{radiobuttonon.png} \emph{Autodétecter}

\item {} 
\includegraphics{radiobuttonon.png} \emph{Interne},

\item {} 
\includegraphics{radiobuttonon.png} \emph{Port Série}

\item {} 
\includegraphics{radiobuttonon.png} \emph{gpsd} (en sélectionnant l'Hôte, le Port et le Périphérique GPS).

\end{itemize}

Cliquez à nouveau sur \textbf{{[}Connecter{]}} pour réinitialiser la connexion avec le récepteur GPS.
\phantomsection\label{docs/user_manual/working_with_gps/live_GPS_tracking:figure-gps-options}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=10em]{gpstrack_options.png}
\caption{GPS tracking options window \includegraphics[width=1em]{nix.png}}\end{figure}

Vous pouvez activer \includegraphics{checkbox.png} \emph{Enregistrer automatiquement chaque entité ajoutée} lorsque vous êtes en mode édition. Ou vous pouvez activer \includegraphics{checkbox.png} \emph{Ajouter automatiquement des points} en choisissant la largeur et la couleur.

En activant \includegraphics{checkbox.png} \emph{Curseur}, utilisez le curseur \includegraphics{slider.png} pour augmenter on diminuer la taille du curseur marquant la position du GPS sur la carte.

\includegraphics{radiobuttonon.png} \emph{Centrer la carte} permet de choisir comment mettre à jour l'emprise de la carte. Soit `toujours', soit `lorsque l'on sort', si les coordonnées enregistrées commencent à sortir de la carte, soit `jamais'.

Enfin, vous pouvez activer le \includegraphics{checkbox.png} \emph{Fichier journal} et définir un fichier pour enregistrer les messagesdu suivi GPS.

Si vous voulez enregistrer une entité manuellement, vous devez retourner à l'écran  \includegraphics[width=1.5em]{mActionToggleEditing.png} $^{\text{Coordonnées de la position}}$ et cliquer sur \textbf{{[}Ajouter des entités{]}} ou \textbf{{[}Ajouter un point de tracé{]}}.

\index{GRASS}

\chapter{Intégration du SIG GRASS}
\label{docs/user_manual/grass_integration/grass_integration:index-0}\label{docs/user_manual/grass_integration/grass_integration:grass-gis-integration}\label{docs/user_manual/grass_integration/grass_integration::doc}\label{docs/user_manual/grass_integration/grass_integration:sec-grass}
L'extension GRASS fournit un accès aux bases de données et aux fonctionnalités de GRASS (voir GRASS-PROJECT {\hyperref[docs/user_manual/literature_web/literature_and_web_references:literature-and-web]{\emph{Bibliographie}}}) .  Cela inclut la visualisation des couches d'informations GRASS raster et vecteur, la numérisation de couches vectorielles, l'édition des attributs des couches d'informations vecteurs,  la création de nouvelles couches et l'analyse 2D et 3D grâce à près de 300 modules GRASS.

Cette section présente les fonctionnalités de l'extension et donner des exemples sur la manière de gérer et de travailler avec des données GRASS. Les fonctionnalités principales suivantes sont fournies dans la barre de menu lorsque vous lancez l'extension GRASS, comme décrit dans la section  {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-starting-grass]{\emph{Lancer l'extension GRASS}}}  :
\begin{itemize}
\item {} 
\includegraphics[width=1.5em]{grass_open_mapset.png} $^{\text{Ouvrir le jeu de données}}$

\item {} 
\includegraphics[width=1.5em]{grass_new_mapset.png} $^{\text{Nouveau jeu de données}}$

\item {} 
\includegraphics[width=1.5em]{grass_close_mapset.png} $^{\text{Fermer le jeu de données}}$

\item {} 
\includegraphics[width=1.5em]{grass_add_vector.png} $^{\text{Ajouter une couche vectorielle GRASS}}$

\item {} 
\includegraphics[width=1.5em]{grass_add_raster.png} $^{\text{Ajouter une couche raster GRASS}}$

\item {} 
\includegraphics[width=1.5em]{grass_new_vector_layer.png} $^{\text{Créer une nouvelle couche vectorielle GRASS}}$

\item {} 
\includegraphics[width=1.5em]{grass_edit.png} $^{\text{Éditer une couche vectorielle GRASS}}$

\item {} 
\includegraphics[width=1.5em]{grass_tools.png} $^{\text{Ouvrir les outils GRASS}}$

\item {} 
\includegraphics[width=1.5em]{grass_region.png} $^{\text{Afficher la région courante GRASS}}$

\item {} 
\includegraphics[width=1.5em]{grass_region_edit.png} $^{\text{Éditer la région courante GRASS}}$

\end{itemize}

\index{GRASS!Start Plugin}

\section{Lancer l'extension GRASS}
\label{docs/user_manual/grass_integration/grass_integration:starting-the-grass-plugin}\label{docs/user_manual/grass_integration/grass_integration:index-1}\label{docs/user_manual/grass_integration/grass_integration:sec-starting-grass}
Pour pouvoir utiliser les fonctionnalités de GRASS et/ou visionner des données vecteurs ou raster dans QGIS, vous devez sélectionner et charger l'extension GRASS à l'aide du gestionnaire d'extensions. Cliquez sur le menu  \emph{Extensions \(\rightarrow\)} \includegraphics[width=1.5em]{mActionShowPluginManager.png} \emph{Gestionnaire d'extensions}, sélectionnez \includegraphics{checkbox.png} \emph{GRASS} et cliquez sur \textbf{{[}OK{]}}.

Vous pouvez maintenant charger des données raster et vecteur depuis un \code{SECTEUR} GRASS existant  (voir section {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-load-grassdata]{\emph{Charger des données GRASS raster et vecteur}}}). Ou alors vous pouvez créer un nouveau \code{SECTEUR} GRASS à l'aide de QGIS (voir section {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-create-loc]{\emph{Créer un nouveau SECTEUR GRASS}}}) et y importer des données raster et vecteur (voir Section {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-import-loc-data]{\emph{Importer des données dans un SECTEUR GRASS}}}) pour réaliser des traitements à l'aide de la boîte à outils GRASS (voir section {\hyperref[docs/user_manual/grass_integration/grass_integration:subsec-grass-toolbox]{\emph{La boîte à outils GRASS}}}).


\section{Charger des données GRASS raster et vecteur}
\label{docs/user_manual/grass_integration/grass_integration:loading-grass-raster-and-vector-layers}\label{docs/user_manual/grass_integration/grass_integration:sec-load-grassdata}
\index{GRASS!loading data}
Avec l'extension GRASS, vous pouvez charger des données raster ou vecteur à l'aide du bouton approprié dans la barre de menu. Ici nous utiliserons comme exemple le jeu de données QGIS sur l'Alaska (voir Section {\hyperref[docs/user_manual/introduction/getting_started:label-sampledata]{\emph{Échantillon de données}}}).  Il contient un \code{SECTEUR} GRASS avec 3 couches vectorielles et 1 raster d'élévation.
\begin{enumerate}
\item {} 
Créez un nouveau répertoire \code{grassdata}, téléchargez le jeu de données QGIS alaska \code{qgis\_sample\_data.zip} depuis \href{http://download.osgeo.org/qgis/data/}{http://download.osgeo.org/qgis/data/} et décompressez le dans le répertoire \code{grassdata}.

\item {} 
Démarrez QGIS.

\item {} 
Si cela n'a pas déjà été fait dans une précédente session QGIS, chargez l'extension GRASS en cliquant sur  \emph{Extensions \(\rightarrow\)} \includegraphics[width=1.5em]{mActionShowPluginManager.png} \emph{Gestionnaire d'extensions} et sélectionnez \includegraphics{checkbox.png} \emph{GRASS}. La barre d'outils GRASS apparaît dans la barre de menu.

\item {} 
Dans la barre d'outils GRASS, cliquez sur le bouton \includegraphics[width=1.5em]{grass_open_mapset.png}$^{\text{Ouvrir le jeu de données}}$ pour ouvrir le gestionnaire de \code{Base de données}.

\item {} 
Pour \code{Base de données GIS}, parcourez puis sélectionnez ou entrez le chemin vers le répertoire nouvellement créé : \code{grassdata}.

\item {} 
Vous devriez maintenant être capable de sélectionner le \emph{SECTEUR} \includegraphics{selectstring.png} \code{alaska} et le \emph{jeu de données} \includegraphics{selectstring.png} \code{demo}.

\item {} 
Cliquez sur \textbf{{[}OK{]}}. Notez que les outils GRASS sont maintenant accessibles dans la barre d'outils.

\item {} 
Cliquez sur \includegraphics[width=1.5em]{grass_add_raster.png} $^{\text{Ajouter une couche raster GRASS}}$, choisissez le fichier \code{gtopo30} et cliquez sur \textbf{{[}OK{]}}. Vous isionnez alors la couche d'élévation.

\item {} 
Cliquez sur \includegraphics[width=1.5em]{grass_add_vector.png} $^{\text{Ajouter une couche vectorielle GRASS}}$, choisissez la couche \code{alaska} et cliquez sur \emph{OK}. La couche vectorielle Alaska s'affiche au-dessus du raster \code{gtopo30}. Vous pouvez modifier les propriétés de la couche d'information comme décrit dans le chapitre {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-properties-dialog]{\emph{Fenêtre Propriétés d'une couche vecteur}}}. Vous pouvez par exemple modifier la transparence, changer la couleur du contour ou celle du remplissage.

\item {} 
Chargez également les deux autres couches vecteur \code{rivers} et \code{airports} et modifiez leurs propriétés.

\end{enumerate}

Comme vous pouvez le constater, il est très facile d'afficher des données GRASS raster et vecteur dans QGIS.  Dans les sections suivantes, nous allons voir comment éditer des données GRASS et créer un nouveau \code{SECTEUR}.  Vous trouverez sur le site GRASS (\href{http://grass.osgeo.org/download/data.php}{http://grass.osgeo.org/download/data.php}) d'autres exemples de \code{SECTEURs}.

\begin{notice}{tip}{Astuce:}
\textbf{Charger des données GRASS}

Si vous rencontrez des problèmes lors du chargement de données ou si QGIS se ferme anormalement, vérifiez que vous que avez bien charger l'extension GRASS comme décrit dans la section {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-starting-grass]{\emph{Lancer l'extension GRASS}}}.
\end{notice}


\section{Secteur et Jeu de données GRASS}
\label{docs/user_manual/grass_integration/grass_integration:grass-location-and-mapset}\label{docs/user_manual/grass_integration/grass_integration:sec-about-loc}
Les données GRASS sont stockées dans un répertoire référencé sous le nom GISDBASE. Ce répertoire, souvent appelé \code{grassdata}, doit être créé avant que vous commenciez à travailler avec l'extension GRASS dans QGIS. Dans ce répertoire, les données GRASS sont organisées par projets et stockées dans des sous-répertoires appelés \code{SECTEUR} ( \code{LOCATION} en Anglais). Chaque \code{SECTEUR} est défini par son système de coordonnées, sa projection et son étendue géographique. Chaque \code{SECTEUR} peut contenir plusieurs \code{Jeux de données} (\code{MAPSETs} en Anglais) (sous-répertoires du \code{SECTEUR}) qui sont utilisés pour subdiviser le projet en différents thèmes, sous régions ou espaces de travail pour chaque membre d'une équipe (Neteler \& Mitasova 2008 {\hyperref[docs/user_manual/literature_web/literature_and_web_references:literature-and-web]{\emph{Bibliographie}}}). Pour pouvoir analyser des couches raster ou vecteur à l'aide des modules GRASS, vous devez les importer dans un \code{SECTEUR} (ce n'est pas complètement vrai, car avec les modules GRASS \code{r.external} et \code{v.external}, vous pouvez lier (en lecture seule) des données externes gérées par GDAL/OGR sans les importer. Mais comme il ne s'agit pas d'une fonctionnalité courante pour les débutants sur GRASS, elle ne sera pas décrite ici).
\phantomsection\label{docs/user_manual/grass_integration/grass_integration:figure-grass-location-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{grass_location.png}
\caption{GRASS data in the alaska LOCATION}\end{figure}


\subsection{Créer un nouveau SECTEUR GRASS}
\label{docs/user_manual/grass_integration/grass_integration:sec-create-loc}\label{docs/user_manual/grass_integration/grass_integration:creating-a-new-grass-location}
À titre d'exemple, voici la manière dont le \code{SECTEUR alaska}, projeté en Albers Equal Area et ayant pour unité le pied, a été créé pour l'échantillon de données QGIS. Ce \code{SECTEUR alaska} sera utilisé pour tous les exemples et exercices GRASS qui suivent. Il est utile de le télécharger et de l'installer sur votre ordinateur {\hyperref[docs/user_manual/introduction/getting_started:label-sampledata]{\emph{Échantillon de données}}}.
\begin{enumerate}
\item {} 
Démarrez QGIS et assurez vous que l'extension GRASS est chargée.

\item {} 
Affichez le shapefile \code{alaska.shp} (voir Section {\hyperref[docs/user_manual/working_with_vector/supported_data:vector-load-shapefile]{\emph{Charger un Shapefile}}}) du jeu de données QGIS Alaska {\hyperref[docs/user_manual/introduction/getting_started:label-sampledata]{\emph{Échantillon de données}}}.

\item {} 
Dans la barre d'outils GRASS, cliquez sur \includegraphics[width=1.5em]{grass_new_mapset.png}$^{\text{Nouveau jeu de données}}$ pour ouvrir l'assistant de création de \code{Jeux de données}.

\item {} 
Sélectionnez un répertoire existant de base de données GRASS (GISDBASE) \code{grassdata} ou créez en un pour le nouveau \code{SECTEUR} avec le gestionnaire de fichiers de votre ordinateur. Cliquez sur le bouton \textbf{{[}Suivant{]}}.

\item {} 
Nous pouvons utiliser cet assistant à la fois pour créer un nouveau \code{Jeu de données} dans un \code{SECTEUR} existant (voir Section {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-add-mapset]{\emph{Ajouter un nouveau Jeu de données}}}) et pour créer également un nouveau \code{SECTEUR}. Cliquez sur le bouton radio \includegraphics{radiobuttonon.png}\emph{Créez un nouveau secteur} (voir {\hyperref[docs/user_manual/grass_integration/grass_integration:figure-grass-location-2]{figure\_grass\_location\_2}}).

\item {} 
Entrez un nom pour le \code{SECTEUR} - nous avons utilisé alaska et cliquez sur le bouton \textbf{{[}Suivant{]}}.

\item {} 
Définissez la projection en cliquant sur le bouton radio \includegraphics{radiobuttonon.png}\emph{Projection} pour activer la liste des projections.

\item {} 
Nous utilisons la projection Albers Equal Area Alaska (pieds). Étant donné que nous savons qu'elle correspond au code EPSG 2964, nous le saisissons dans le champ de recherche. (Note : Si vous souhaitez reproduire la manipulation pour un autre \code{SECTEUR} et une autre projection dont vous ne connaissez pas le code EPSG, cliquez sur \includegraphics[width=1.5em]{mIconProjectionEnabled.png} $^{\text{Statut de la projection}}$ dans le coin inférieur droit de la barre d'état de QGIS (voir Section {\hyperref[docs/user_manual/working_with_projections/working_with_projections:label-projections]{\emph{Utiliser les projections}}})).

\item {} 
Saisissez 2964 dans \emph{Filtre} pour sélectionner la projection.

\item {} 
Cliquez sur \textbf{{[}Suivant{]}}.

\item {} 
Pour définir la région par défaut, nous devons saisir les limites Nord, Sud , Est et Ouest du \code{SECTEUR}. Ici il suffit de cliquer sur le bouton  \emph{Fixer l'emprise courante de QGIS}, pour appliquer l'emprise du shapefile \code{alaska.shp} déjà chargé comme emprise par défaut.

\item {} 
Cliquez sur \textbf{{[}Suivant{]}}.

\item {} 
Nous avons aussi besoin de définir un \code{Jeu de données} dans notre nouveau \code{SECTEUR}. Vous pouvez l'appeler comme vous le souhaitez - nous utiliserons demo (quand nous créons une nouveau \code{SECTEUR}, GRASS créé automatiquement un \code{Jeu de données} spécial appelé \code{PERMANENT} conçu pour stocker les données essentielles du projet, son emprise spatiale par défaut et la définition du système de coordonnées (Neteler \& Mitasova 2008 {\hyperref[docs/user_manual/literature_web/literature_and_web_references:literature-and-web]{\emph{Bibliographie}}}).

\item {} 
Vérifiez le résumé pour vous assurez que tout est correct et cliquez sur \textbf{{[}Terminer{]}}.

\item {} 
Le nouveau \code{SECTEUR alaska} et les deux \code{Jeux de données démo} et \code{PERMANENT} sont créés. Le jeu de données ouvert à ce moment est le \code{Jeux de données démo}, tel que vous l'avez défini.

\item {} 
Notez que certains outils de la barre d'outils GRASS qui n'étaient pas accessibles le sont maintenant.

\end{enumerate}
\phantomsection\label{docs/user_manual/grass_integration/grass_integration:figure-grass-location-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{create_grass_location.png}
\caption{Creating a new GRASS LOCATION or a new MAPSET in QGIS}\end{figure}

Si ce processus semble long, il s'agit en fait d'un moyen simple et rapide de créer un \code{SECTEUR}. Le \code{SECTEUR alaska} est maintenant prêt pour l'importation de données (voir section {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-import-loc-data]{\emph{Importer des données dans un SECTEUR GRASS}}}). Vous pouvez également utiliser des données raster ou vecteur existantes dans le \code{SECTEUR alaska} inclues dans le jeu de données QGIS Alaska {\hyperref[docs/user_manual/introduction/getting_started:label-sampledata]{\emph{Échantillon de données}}} et continuez avec la section {\hyperref[docs/user_manual/grass_integration/grass_integration:label-vectmodel]{\emph{Le modèle vecteur de GRASS}}}.


\subsection{Ajouter un nouveau Jeu de données}
\label{docs/user_manual/grass_integration/grass_integration:adding-a-new-mapset}\label{docs/user_manual/grass_integration/grass_integration:sec-add-mapset}
Un utilisateur a seulement des droits d'écriture sur le \code{Jeu de données} GRASS qu'il a créé. Cela veut dire, qu'au-delà de l'accès à son propre \code{Jeu de données} GRASS, chaque utilisateur peut aussi lire les données des autres \code{Jeux de données}, mais il ne peut modifier ou supprimer que les données de son propre \code{Jeu de données}.

Tous les \code{Jeux de données} incluent un fichier \code{WIND} qui stocke l'emprise et la résolution raster courante (Neteler \& Mitasova 2008 {\hyperref[docs/user_manual/literature_web/literature_and_web_references:literature-and-web]{\emph{Bibliographie}}}, voir Section {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-grass-region]{\emph{L'outil région GRASS}}}).
\begin{enumerate}
\item {} 
Démarrez QGIS et assurez vous que l'extension GRASS est chargée.

\item {} 
Dans la barre d'outils GRASS, cliquez sur  \includegraphics[width=1.5em]{grass_new_mapset.png} $^{\text{Nouveau jeu de données}}$ pour ouvrir l'assistant de création de \code{Jeux de données}.

\item {} 
Sélectionnez le répertoire \code{grassdata} de la base de données GRASS (GISDBASE) qui contient déjà le \code{SECTEUR alaska} et où nous voulons ajouter un autre \code{SECTEUR} nommé test.

\item {} 
Cliquez sur \textbf{{[}Suivant{]}}.

\item {} 
Nous pouvons utiliser cet assistant à la fois pour créer un nouveau \code{Jeu de données} dans le \code{SECTEUR} existant et pour créer un nouveau \code{SECTEUR}. Cliquez sur le bouton radio \includegraphics{radiobuttonon.png}\emph{Sélectionnez le Secteur} (voir {\hyperref[docs/user_manual/grass_integration/grass_integration:figure-grass-location-2]{figure\_grass\_location\_2}}) et cliquez sur \textbf{{[}Suivant{]}}.

\item {} 
Entrez le \code{texte} du nom pour le nouveau \code{Jeu de données}. En dessous, dans l'assistant, vous pouvez voir une liste des \code{Jeux de données} et de leurs propriétaires.

\item {} 
Cliquez sur \textbf{{[}Suivant{]}}, vérifiez le résumé pour vous assurer qu'il est correct et cliquez sur \textbf{{[}Terminer{]}}.

\end{enumerate}


\section{Importer des données dans un SECTEUR GRASS}
\label{docs/user_manual/grass_integration/grass_integration:sec-import-loc-data}\label{docs/user_manual/grass_integration/grass_integration:importing-data-into-a-grass-location}
Cette section donne un exemple d'importation de données raster et vecteur dans le \code{SECTEUR} GRASS \code{alaska} fournit dans le jeu de données QGIS Alaska. Nous utiliserons une couche raster d'occupation du sol \code{landcover.img} et une couche vectorielle au format GML \code{lakes.gml}, toutes deux présentes dans le jeu de données Alaska.
\begin{enumerate}
\item {} 
Démarrez QGIS et assurez vous que l'extension GRASS est chargée.

\item {} 
Dans la barre d'outils GRASS, cliquez sur \includegraphics[width=1.5em]{grass_open_mapset.png}$^{\text{Ouvrir un jeu de données}}$ pour ouvrir l'assistant \code{Jeu de données}.

\item {} 
Sélectionnez comme base de données GRASS le répertoire \code{grassdata} dans le jeu de données QGIS Alaska, puis le \code{SECTEUR alaska}, \code{demo} comme \code{Jeu de donnée} et cliquez sur \textbf{{[}OK{]}}.

\item {} 
Maintenant cliquez sur \includegraphics[width=1.5em]{grass_tools.png} $^{\text{Ouvrir les outils GRASS}}$. La boîte à outils GRASS s'ouvre (voir section {\hyperref[docs/user_manual/grass_integration/grass_integration:subsec-grass-toolbox]{\emph{La boîte à outils GRASS}}}).

\item {} 
Pour importer la couche raster \code{landcover.img}, cliquez sur le module \code{r.in.gdal} dans l'onglet  \emph{Arborescence des modules}. Ce module GRASS vous permet d'importer les fichiers raster gérés par la librairie GDAL dans un \code{SECTEUR} GRASS. La fenêtre \code{r.in.gdal} apparaît.

\item {} 
Naviguer jusqu'au répertoire \code{raster} dans le jeu de données QGIS Alaska et sélectionnez le fichier \code{landcover.img}.

\item {} 
Définissez \code{landcover\_grass} comme nom de sortie pour le raster et cliquez sur \textbf{{[}Lancer{]}}. Dans l'onglet \emph{Rendu}, vous voyez la commande GRASS en cours \code{r.in.gdal -o input=/path/to/landcover.img output=landcover\_grass}.

\item {} 
Lorsque \textbf{Terminé avec succès} s'affiche, cliquez sur \textbf{{[}Vue{]}}.  La couche raster \code{landcover\_grass} est maintenant importée dans GRASS et pourra être affichée dans QGIS.

\item {} 
Pour importer le fichier GML \code{lakes.gml}, cliquez sur le module \code{v.in.ogr} dans l'onglet \emph{Arborescence des modules}. Ce module permet d'importer des données vectorielles gérées par OGR dans un \code{SECTEUR} GRASS. La fenêtre \code{v.in.ogr} apparaît.

\item {} 
Naviguer jusqu'au répertoire \code{gml} dans le jeu de données QGIS Alaska et sélectionnez le fichier \code{lakes.gml}.

\item {} 
Définissez \code{lakes\_grass} comme nom de sortie et cliquez sur \textbf{{[}Lancer{]}}. Vous n'avez pas besoin des autres options dans cet exemple. Dans l'onglet \emph{Rendu}, vous voyez la commande GRASS en cours \code{v.in.ogr -o dsn=/path/to/lakes.gml output=lakes\_grass}.

\item {} 
Lorsque \textbf{Terminé avec succès} s'affiche, cliquez sur \textbf{{[}Vue{]}}. La couche raster \code{lakes\_grass} est maintenant importée dans GRASS et pourra être affichée dans QGIS.

\end{enumerate}


\section{Le modèle vecteur de GRASS}
\label{docs/user_manual/grass_integration/grass_integration:label-vectmodel}\label{docs/user_manual/grass_integration/grass_integration:the-grass-vector-data-model}
\index{GRASS!vector data model}
Il est important de comprendre le modèle vectoriel de GRASS avant de faire de la numérisation.

\index{GRASS!digitizing}
En général, GRASS utilise un modèle topologique pour les couches vecteur.

\index{GRASS!topology}
Cela signifie que les surfaces ne sont pas représentées par des polygones fermés et distincts, mais par une ou plusieurs limites. Une limite entre des polygones adjacents n'est numérisée qu'une seule fois et est partagée par les deux surfaces. Les limites doivent être connectées sans trous. Une surface est identifiée (et libellée) via le \textbf{centroïde} de la surface.

Outre les limites et centroïdes, une couche vectorielle peut également contenir des points et des lignes. Tous ces éléments de géométrie peuvent être mélangés dans une couche vectorielle et seront représentés dans différentes `sous-couches' dans une carte vectorielle GRASS. Ainsi, une couche GRASS n'est pas un vecteur ou un raster, mais un niveau à l'intérieur d'une couche vectorielle. Il est important de bien distinguer ceci (même s'il est possible de mélanger des éléments de géométries différentes, c'est inhabituel et même dans GRASS, on l'utilise dans des cas particuliers tel que l'analyse de réseau. Normalement, vous devriez stocker des éléments de géométries différentes dans des couches différentes).

Il est possible de stocker plusieurs `sous-couches' dans une couche vectorielle. Par exemple, des champs, de la forêt et des lacs peuvent être stockés dans une couche vectorielle. Les forêts et les lacs adjacents partagent les mêmes limites, mais ils auront des tables attributaires différentes. Il est aussi possible de faire correspondre une table attributaire aux limites. Par exemple, la limite entre un lac et une forêt peut être une route qui peut avoir une table attributaire différente.

La `sous-couche' est définie dans GRASS par un chiffre. Ce chiffre définit s'il y a plusieurs sous-couches à l'intérieur d'une couche vectorielle. Par exemple, il définit s'il s'agit de lac ou de forêt. Pour l'instant, il s'agit d'un nombre, mais dans des versions futures GRASS pourra utiliser des noms pour les sous-couches dans l'interface utilisateur.

Les données attributaires peuvent être stockées dans le \code{SECTEUR} au format DBase, SQLITE3 ou dans des tables de bases de données externes comme par exemple : PostgreSQL, MySQL, Oracle, etc.

\index{GRASS!attribute storage}
Les données attributaires sont liées à la géométrie par le biais d'un champ `category'.

\index{GRASS!attribute linkage}
`Category' (clé, ID) est un entier attaché à la géométrie, et il est utilisé comme lien vers une colonne de clé dans la table de base de données.

\begin{notice}{tip}{Astuce:}
\textbf{Apprendre le modèle vecteur de GRASS}

Le meilleur moyen d'apprendre le modèle vecteur de GRASS et ses possibilités est de télécharger un des nombreux tutoriels GRASS où le modèle vecteur est décrit plus précisément. Voir \href{http://grass.osgeo.org/gdp/manuals.php}{http://grass.osgeo.org/gdp/manuals.php} pour des informations complémentaires, des livres et des tutoriels dans différentes langues.
\end{notice}

\index{GRASS|see{Creating new vectors;editing;creating a new layer}}

\section{Création d'une nouvelle couche vectorielle GRASS}
\label{docs/user_manual/grass_integration/grass_integration:creating-new-grass-vectors}\label{docs/user_manual/grass_integration/grass_integration:index-8}\label{docs/user_manual/grass_integration/grass_integration:creating-a-new-grass-vector-layer}
Pour créer une nouvelle couche vectorielle GRASS à l'aide de l'extension GRASS, cliquez sur  \includegraphics[width=1.5em]{grass_new_vector_layer.png} $^{\text{Créez une nouvelle couche vectorielle GRASS}}$ dans la barre d'outils. Entrez le nom de la couche dans la fenêtre et vous pouvez commencer à digitaliser un point, une ligne ou un polygone en suivant les instructions de la section {\hyperref[docs/user_manual/grass_integration/grass_integration:grass-digitizing]{\emph{Numérisation et édition de couche vectorielle GRASS}}}.

Dans GRASS, il est possible de gérer plusieurs types de géométrie (point, ligne et surface) dans une seule couche d'information, car GRASS utilise un modèle vecteur topologique. Vous n'avez donc pas besoin de sélectionner un type de géométrie quand vous créez une couche vectorielle GRASS. C'est différent de la création de shapefile avec QGIS, car les shapefiles utilisent un modèle vecteur d'entité simple (Simple Feature vector model) (voir Section {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-create-shape]{\emph{Créer une nouvelle couche vecteur}}}).

\begin{notice}{tip}{Astuce:}
\textbf{Création d'une table attributaire pour une nouvelle couche vectorielle GRASS}

Si vous souhaitez renseigner les données attributaires de vos entités numérisées, assurez-vous d'avoir créé une table attributaire avec des champs avant de commencer votre numérisation (voir {\hyperref[docs/user_manual/grass_integration/grass_integration:figure-grass-digitizing-5]{figure\_grass\_digitizing\_5}}).
\end{notice}


\section{Numérisation et édition de couche vectorielle GRASS}
\label{docs/user_manual/grass_integration/grass_integration:grass-digitizing}\label{docs/user_manual/grass_integration/grass_integration:digitizing-and-editing-a-grass-vector-layer}
\index{GRASS!digitizing tools}
Les outils de numérisation pour les couches vectorielles de GRASS sont accessibles via \includegraphics[width=1.5em]{grass_edit.png} $^{\text{Éditer une couche vectorielle GRASS}}$ dans la barre d'outils. Assurez-vous d'avoir ouvert une couche vectorielle GRASS et sélectionné la sous-couche dans la légende avant d'utiliser l'outil d'édition. La figure {\hyperref[docs/user_manual/grass_integration/grass_integration:figure-grass-digitizing-2]{figure\_grass\_digitizing\_2}} montre la fenêtre GRASS qui s'affiche quand vous cliquez sur l'outil d'édition. Les outils et les paramètres d'édition sont détaillés dans les paragraphes suivants.

\begin{notice}{tip}{Astuce:}
\textbf{Numérisation de polygones dans GRASS}

Si vous voulez créer un polygone dans GRASS, vous devez numériser premièrement les limites du polygone, en définissant le mode sur `Pas de catégorie'.Ensuite, vous ajoutez un centroïde (emplacement de l'étiquette) dans le polygone fermé, fixant le mode sur `Prochain non utilisé'. La raison en est, que le modèle vectoriel topologique assure toujours le lien entre les informations d'attributs des polygones via le centroïde et non via la limite.
\end{notice}
\phantomsection\label{docs/user_manual/grass_integration/grass_integration:label-grasstoolbar}
\textbf{Barre d'outils}

Sur la figure {\hyperref[docs/user_manual/grass_integration/grass_integration:figure-grass-digitizing-1]{figure\_grass\_digitizing\_1}} vous pouvez voir la barre d'outils d'édition GRASS de l'extension GRASS. Le tableau {\hyperref[docs/user_manual/grass_integration/grass_integration:table-grass-digitizing-1]{table\_grass\_digitizing\_1}} récapitule les fonctions disponibles.
\phantomsection\label{docs/user_manual/grass_integration/grass_integration:figure-grass-digitizing-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{grass_digitizing_toolbar.png}
\caption{GRASS Digitizing Toolbar}\end{figure}
\phantomsection\label{docs/user_manual/grass_integration/grass_integration:table-grass-digitizing-1}
\begin{tabulary}{\linewidth}{|L|L|L|}
\hline
\textsf{\relax 
Icône
} & \textsf{\relax 
Outil
} & \textsf{\relax 
Fonction
}\\
\hline
\includegraphics[width=1.5em]{grass_new_point.png}
 & 
Nouveau Point
 & 
Numérise un nouveau point
\\

\includegraphics[width=1.5em]{grass_new_line.png}
 & 
Nouvelle Ligne
 & 
Numérise une nouvelle ligne
\\

\includegraphics[width=1.5em]{grass_new_boundary.png}
 & 
Nouveau Contour
 & 
Numérise un nouveau contour (terminer la numérisation en sélectionnant un nouvel outil)
\\

\includegraphics[width=1.5em]{grass_new_centroid.png}
 & 
Nouveau Centroïde
 & 
Numérise un nouveau centroïde (permet d'étiqueter un polygone existant)
\\

\includegraphics[width=1.5em]{grass_move_vertex.png}
 & 
Déplacer un sommet
 & 
Déplace un sommet d'une ligne ou d'un polygone existant et indique sa nouvelle position
\\

\includegraphics[width=1.5em]{grass_add_vertex.png}
 & 
Ajouter un sommet
 & 
Ajoute un nouveau sommet à une ligne existante
\\

\includegraphics[width=1.5em]{grass_delete_vertex.png}
 & 
Effacer un sommet
 & 
Efface un sommet d'une ligne existante (confirmez le sommet sélectionné par un autre clic)
\\

\includegraphics[width=1.5em]{grass_move_line.png}
 & 
Déplacer l'élément
 & 
Déplacez la limite, la ligne, le point ou le centroïde sélectionné puis cliquez sur la nouvelle position
\\

\includegraphics[width=1.5em]{grass_split_line.png}
 & 
Couper la ligne
 & 
Coupe une ligne existante en deux parties
\\

\includegraphics[width=1.5em]{grass_delete_line.png}
 & 
Effacer l'élément
 & 
Efface une limite, une ligne, un point ou un centroïde existant (confirmez l'élément sélectionné avec un autre clic)
\\

\includegraphics[width=1.5em]{grass_edit_attributes.png}
 & 
Éditer les attributs
 & 
Édite les attributs de l'élément sélectionné (notez qu'un seul élément peut représenter plusieurs géométries, voir ci-dessus)
\\

\includegraphics[width=1.5em]{grass_close_edit.png}
 & 
Fermer
 & 
Ferme la session et sauvegarde l'état actuel (reconstruit la topologie après)
\\
\hline\end{tabulary}

\begin{quote}

Tableau Numérisation avec GRASS 1 : outils d'édition GRASS
\end{quote}

\textbf{Onglet Categorie}

\index{GRASS!category settings}
L'onglet \emph{Categorie} vous permet de définir la manière dont les valeurs du champ category sont assignées au nouvel élément géométrique.
\phantomsection\label{docs/user_manual/grass_integration/grass_integration:figure-grass-digitizing-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{grass_digitizing_category.png}
\caption{GRASS Digitizing Category Tab}\end{figure}
\begin{itemize}
\item {} 
\textbf{Mode} : quelle catégorie sera appliquée aux nouveaux éléments.
\begin{itemize}
\item {} 
Prochain non utilisé - applique la valeur suivante non utilisée du champ category à l'élément géométrique.

\item {} 
Saisie manuelle - saisir manuellement la valeur du champ category pour l'élément géométrique.

\item {} 
Pas de catégorie - ne pas remplir le champ category. C'est par exemple utilisé pour les surfaces, car les valeurs de catégorie sont stockées via le centroïde.

\end{itemize}

\item {} 
\textbf{Categorie} : un identifiant (ID) est attaché à chaque objet numérisé. Il est utilisé pour connecter les objets géométriques avec ces attributs.

\item {} 
\textbf{Couche} : chaque objet peut être connecté à différentes tables attributaires au travers des différentes sous-couches. Le numéro de sous-couche par défaut est 1.

\end{itemize}

\begin{notice}{tip}{Astuce:}
\textbf{Création d'une `sous-couche' supplémentaire avec QGIS}

i vous souhaitez avoir plusieurs sous-couches dans votre couche vectorielle, ajouter simplement un nouveau chiffre dans la zone de saisie `Couche' et appuyez sur entrée. Dans l'onglet Table, vous pouvez créer de nouvelles tables attributaires connectées à votre nouvelle sous-couche.
\end{notice}
\phantomsection\label{docs/user_manual/grass_integration/grass_integration:label-settingtab}
\textbf{Onglet Paramètres}

\index{GRASS!snapping tolerance}
L'onglet \emph{Paramètres} vous permet de définir la tolérance d'accrochage en pixels-écrans. Le seuil définit à partir de quelle distance les nouveaux points ou les nouvelles lignes sont accrochées automatiquement à des noeuds existants. Cela aide à éviter de créer des trous ou des superpositions entre les contours. La valeur par défaut est fixée à 10 pixels.
\phantomsection\label{docs/user_manual/grass_integration/grass_integration:figure-grass-digitizing-3}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{grass_digitizing_settings.png}
\caption{GRASS Digitizing Settings Tab}\end{figure}

\textbf{Onglet Convention des signes}

\index{GRASS!symbology settings}
L'onglet \emph{Convention des signes} vous permet d'afficher et modifier la symbologie, la couleur des différentes formes géométriques ainsi que leur statut topologique (par exemple : contour ouvert / fermé).
\phantomsection\label{docs/user_manual/grass_integration/grass_integration:figure-grass-digitizing-4}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{grass_digitizing_symbology.png}
\caption{GRASS Digitizing Symbolog Tab}\end{figure}

\textbf{Onglet Table}

\index{GRASS!table editing}
L'onglet \emph{Table} donne des informations sur la table attributaire d'une `sous-couche' donnée. C'est ici que vous pouvez ajouter des colonnes à une table attributaire existante ou créer une nouvelle table attributaire pour une nouvelle couche vectorielle GRASS (voir Section {\hyperref[docs/user_manual/grass_integration/grass_integration:creating-new-grass-vectors]{\emph{Création d'une nouvelle couche vectorielle GRASS}}}).
\phantomsection\label{docs/user_manual/grass_integration/grass_integration:figure-grass-digitizing-5}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{grass_digitizing_table.png}
\caption{GRASS Digitizing Table Tab}\end{figure}

\begin{notice}{tip}{Astuce:}
\textbf{Droits d'édition GRASS}

Vous devez être propriétaire du \code{Jeu de données} que vous voulez éditer. Il est impossible de modifier des informations d'un \code{Jeu de données} qui n'est pas à vous, même si vous avez des droits en écriture.
\end{notice}


\section{L'outil région GRASS}
\label{docs/user_manual/grass_integration/grass_integration:the-grass-region-tool}\label{docs/user_manual/grass_integration/grass_integration:sec-grass-region}
\index{GRASS!region}
La définition d'une région (définir une emprise spatiale de travail) dans GRASS est très importante pour travailler avec des couches rasters. Le travail d'analyse vecteur n'est, par défaut, pas limitée à une région définie. Mais, tous les rasters nouvellement créés auront l'emprise spatiale et la résolution de la région GRASS en cours d'utilisation, indépendamment de leur emprise et résolution d'origine. La région courante GRASS est stockée dans le fichier \code{\$SECTEUR/\$Jeu de donnée/WIND}, et celui-ci définit les limites Nord, Sud, Est et Ouest, le nombre de lignes et de colonnes ainsi que la résolution spatiale horizontale et verticale.

Il est possible d'afficher ou de masquer l'emprise de la région GRASS dans QGIS à l'aide du bouton \includegraphics[width=1.5em]{grass_region.png} $^{\text{Afficher la région courante GRASS}}$.

\index{GRASS!region display}
A l'aide du bouton \includegraphics[width=1.5em]{grass_region_edit.png} $^{\text{Éditer la région courante GRASS}}$ vous avez accès à une fenêtre qui vous permet de modifier la région courante ainsi que sa symbologie. Entrez les nouvelles limites et résolution et cliquez sur \textbf{{[}OK{]}}. Cette fenêtre vous permet aussi de définir une nouvelle région interactivement à l'aide de la souris. Pour définir ce rectangle d'emprise, cliquez avec le bouton gauche de la souris et définissez un rectangle que vous terminerez en cliquant de nouveau sur le bouton gauche de la souris et cliquez sur \textbf{{[}OK{]}}.

\index{GRASS!region editing}
Le module GRASS \code{g.region} propose un grand nombre de paramètres pour définir de façon appropriée les limites et la résolution d'une région pour faire de l'analyse raster. Vous pouvez vous servir de ces paramètres dans la boîte à outils GRASS décrite dans la Section {\hyperref[docs/user_manual/grass_integration/grass_integration:subsec-grass-toolbox]{\emph{La boîte à outils GRASS}}}.


\section{La boîte à outils GRASS}
\label{docs/user_manual/grass_integration/grass_integration:the-grass-toolbox}\label{docs/user_manual/grass_integration/grass_integration:subsec-grass-toolbox}
\index{GRASS toolbox}
La fenêtre \includegraphics[width=1.5em]{grass_tools.png} $^{\text{Ouvrir les outils GRASS}}$ donne accès aux fonctionnalités GRASS qui permettent de travailler sur les données d'un \code{SECTEUR} et d'un \code{Jeu de données}. Pour utiliser les outils GRASS, vous devez ouvrir un \code{SECTEUR} et un \code{Jeu de données} sur lequel vous avez des droits d'écriture (que vous avez normalement si vous avez créé le \code{Jeu de données}). Cela est nécessaire car les rasters et les vecteurs nouvellement créés lors des analyses doivent être écrits dans le \code{SECTEUR} et \code{Jeu de données} courant.
\phantomsection\label{docs/user_manual/grass_integration/grass_integration:figure-grass-toolbox-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{grass_toolbox_moduletree.png}
\caption{GRASS Toolbox and Module Tree \includegraphics[width=1em]{nix.png}}\end{figure}

La console de la boîte à outils GRASS vous donne accès à pratiquement tous les modules GRASS (près de 330) en ligne de commande. Afin d'offrir un environnement de travail plus agréable, environ 200 d'entre eux sont disponibles via l'interface graphique de la boîte à outils GRASS.


\subsection{Travailler avec les modules GRASS}
\label{docs/user_manual/grass_integration/grass_integration:grass-modules}\label{docs/user_manual/grass_integration/grass_integration:working-with-grass-modules}
La console de la boîte à outils GRASS vous donne accès à pratiquement tous les modules GRASS (près de 330) en ligne de commande. Afin d'offrir un environnement de travail plus agréable, environ 200 d'entre eux sont disponibles via l'interface graphique de la boîte à outils GRASS.

La liste des modules GRASS disponibles via la boîte à outils de la version 1.8.0 de QGIS est détaillée sur le wiki de GRASS ( \href{http://grass.osgeo.org/wiki/GRASS-QGIS\_relevant\_module\_list}{http://grass.osgeo.org/wiki/GRASS-QGIS\_relevant\_module\_list}).

Il est aussi possible de personnaliser le contenu de la boîte à outils GRASS. Ceci est décrit dans la Section {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-toolbox-customizing]{\emph{Paramètrer la boîte à outils GRASS}}}.

Comme indiqué sur la figure {\hyperref[docs/user_manual/grass_integration/grass_integration:figure-grass-toolbox-1]{figure\_grass\_toolbox\_1}}, vous pouvez chercher le module GRASS approprié en utilisant l'onglet \emph{Arborescence des modules} ou en utilisant l'onglet \emph{Liste des Modules} pour faire une recherche.

Lorsque vous cliquez sur un module, un nouvel onglet apparaît proposant trois sous-onglets : \emph{Options}, \emph{Rendu} et \emph{Manuel}.

\textbf{Options}

L'onglet \emph{Options} propose une interface simplifiée où vous pouvez sélectionner un raster ou un vecteur en cours de visualisation dans QGIS et saisir les paramètres spécifiques au module avant de le lancer.
\phantomsection\label{docs/user_manual/grass_integration/grass_integration:figure-grass-module-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{grass_module_option.png}
\caption{GRASS Toolbox Module Options \includegraphics[width=1em]{nix.png}}\end{figure}

Tous les paramètres du module ne sont généralement pas fournis afin de simplifier les fenêtres. Pour utiliser des paramètres qui ne se trouvent pas dans la fenêtre, vous devez utiliser la console GRASS et lancer les modules en lignes de commande.

Une nouvelle fonctionnalité de QGIS 1.8.0 est l'ajout d'un bouton \emph{afficher les options avancées \textgreater{}\textgreater{}} en-dessous de la fenêtre simplifiée de l'onglet \emph{Options}. Pour l'instant seul le module v.in.ascii a été adapté afin de servir d'exemple d'utilisation mais d'autres le seront dans les prochaines versions de QGIS. La finalité est de pouvoir recourir à toutes les options de GRASS sans devoir ouvrir la console GRASS.

\textbf{Rendu}
\phantomsection\label{docs/user_manual/grass_integration/grass_integration:figure-grass-module-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{grass_module_output.png}
\caption{GRASS Toolbox Module Output \includegraphics[width=1em]{nix.png}}\end{figure}

L'onglet \emph{Rendu} fournit des informations sur l'état de sortie du module. Quand vous cliquez sur le bouton \textbf{{[}Lancer{]}}, le module passe sur l'onglet \emph{Rendu} et vous voyez les informations sur le processus en cours. Si tout se passe bien, vous verrez finalement le message \code{Terminé avec succès}.

\textbf{Manuel}
\phantomsection\label{docs/user_manual/grass_integration/grass_integration:figure-grass-module-3}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{grass_module_manual.png}
\caption{GRASS Toolbox Module Manual \includegraphics[width=1em]{nix.png}}\end{figure}

L'onglet \emph{Manuel} montre la page HTML d'aide du module GRASS. Vous pouvez vous en servir pour voir les autres paramètres du module et pour avoir une connaissance plus approfondie de l'objet du module. À la fin de chaque page d'aide d'un module, vous avez des liens vers \code{Main Help index} (index principal), \code{Thematic.index} (index par thème) et \code{Full.index} (index complet). Ces liens vous donnent les mêmes informations que si vous utilisiez directement \code{g.manual}.

\index{GRASS!display results}
\begin{notice}{tip}{Astuce:}
\textbf{Afficher les résultats immédiatement}

Si vous voulez voir immédiatement dans votre fenêtre carte le résultat des calculs du module, vous pouvez utiliser le bouton `Vue' au bas de l'onglet du module.
\end{notice}


\subsection{Exemples de modules GRASS}
\label{docs/user_manual/grass_integration/grass_integration:grass-module-examples}
Les exemples suivants décrivent les possibilités de certains modules GRASS.


\subsubsection{Création de courbes de niveau}
\label{docs/user_manual/grass_integration/grass_integration:creating-contour-lines}
Le premier exemple permet de créer une couche vectorielle de courbes de niveau à partir d'un modèle numérique de terrain (MNT). Nous considérerons que le \code{SECTEUR} Alaska a été installé comme décrit dans la Section {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-import-loc-data]{\emph{Importer des données dans un SECTEUR GRASS}}}.
\begin{itemize}
\item {} 
Premièrement, ouvrez le secteur en cliquant sur le bouton \includegraphics[width=1.5em]{grass_open_mapset.png} $^{\text{Ouvrir le jeu de données}}$ et choisissez le secteur Alaska.

\item {} 
Maintenant chargez le raster \code{gtopo30} en cliquant sur le bouton \includegraphics[width=1.5em]{grass_add_raster.png} $^{\text{Ajouter une couche raster GRASS}}$ puis en sélectionnant le raster \code{gtopo30} dans le secteur demo.

\item {} 
Ouvrez la boite à outils à l'aide du bouton \includegraphics[width=1.5em]{grass_tools.png} $^{\text{Ouvrir les outils GRASS}}$.

\item {} 
Dans la liste des outils double-cliquez sur \emph{Raster -\textgreater{} Gestion de surface -\textgreater{} Générer des lignes vectorielles de contours}.

\item {} 
Maintenant, cliquez sur l'outil \textbf{r.contour}, cela ouvrira une fenêtre comme expliqué ci-dessus {\hyperref[docs/user_manual/grass_integration/grass_integration:grass-modules]{\emph{Travailler avec les modules GRASS}}}. Le raster \code{gtopo30} devrait apparaitre dans le champ \emph{Nom du raster en entrée}.

\item {} 
Dans le champ \emph{Increment between Contour levels} \includegraphics{selectnumber.png}, saisissez la valeur 100. (Cela va créer des courbes de niveau tous les 100 mètres)

\item {} 
Saisisez dans le champ \emph{Nom de la couche vectorielle en sortie}, le nom \code{ctour\_100}.

\item {} 
Cliquer sur \textbf{{[}Lancer{]}} pour lancer le traitement. Attendez quelques instants que le message \code{Terminé avec succès} apparaisse à l'écran. Cliquez enfin sur \textbf{{[}Vue{]}} puis \textbf{{[}Fermer{]}}.

\end{itemize}

Comme il s'agit d'une grande région, cela prendra un certain temps à s'afficher. Une fois l'affichage terminé, vous pouvez ouvrir la fenêtre de propriétés de la couche pour changer la couleur des courbes de niveau afin qu'elles apparaissent clairement au dessus de la couche raster d'élévation comme décrit dans {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-properties-dialog]{\emph{Fenêtre Propriétés d'une couche vecteur}}}.

Zoomez sur une petite région montagneuse du centre de l'Alaska. Avec un zoom important, vous constaterez que les courbes de niveau sont constituées de lignes brisées avec des angles vifs. GRASS offre la possibilité de généraliser les cartes vecteurs à l'aide de l'outil \textbf{v.generalize}, tout en conservant leur forme générale. L'outil utilise différents algorithmes ayant différents objectifs. Certains de ces algorithmes (par exemple : Douglas Peucker et réduction de vertex) simplifient les lignes en supprimant des sommets. La couche simplifiée se chargera plus rapidement. Cette commande peut être utilisée lorsque vous avez une couche vectorielle très détaillée et que vous créez une carte à petite échelle où les détails ne sont donc pas nécessaires.

\index{GRASS!display results}
\begin{notice}{tip}{Astuce:}
\textbf{L'outil de simplification}

Vous remarquerez que fTools dispose aussi d'un outil de simplification \emph{Simplifier la géometrie} qui fonctionne comme l'algorithme Douglas-Peucker de GRASS, \textbf{v.generalize}.
\end{notice}

Cependant, le but de cet exemple est différent. Les courbes de niveau créées avec \code{r.contour} ont des angles vifs qui doivent être lissés. Parmi les algorithmes de \textbf{v.generalize}, il y a l'algorithme de Chaikens qui fait justement ça (comme Hermite splines). Gardez à l'esprit que ces algorithmes peuvent \textbf{ajouter} des sommets supplémentaires au vecteur, l'amenant à se charger encore plus lentement.
\begin{itemize}
\item {} 
Ouvrez la boite à outils GRASS et double cliquez sur \emph{Vecteur -\textgreater{} Développer la carte -\textgreater{} Généralisation}. Cliquez alors sur le module \textbf{v.generalize} pour ouvrir sa fenêtre d'options.

\item {} 
rifier que la couche vectorielle `ctour\_100' apparait dans le champ \emph{Nom de la couche vectorielle en entrée}.

\item {} 
Dans la liste des algorithmes choisissez Chaiken. Laisser les autres options par défaut et descendez à la dernière ligne pour donner le nom de la couche d'information à créer : \emph{Nom de la couche vectorielle en sortie} `ctour\_100\_smooth', et cliquez sur \textbf{{[}Lancer{]}}.

\item {} 
Cela peut prendre plusieurs minutes. Lorsque le texte \code{Terminé avec succès} apparait, cliquez sur le bouton \textbf{{[}Vue{]}} puis sur \textbf{{[}Fermer{]}}.

\item {} 
Vous pouvez changer la couleur de cette couche vectorielle pour qu'elle apparaisse clairement sur le raster et qu'elle contraste aussi avec la couche de départ.Vous remarquerez que les nouvelles courbes de niveau ont des angles plus arrondis que l'original tout en restant fidèle à la forme globale d'origine.

\end{itemize}
\phantomsection\label{docs/user_manual/grass_integration/grass_integration:figure-grass-module-4}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{grass_toolbox_vgeneralize.png}
\caption{GRASS module v.generalize to smooth a vector map \includegraphics[width=1em]{nix.png}}\end{figure}

\index{GRASS!toolbox}
\begin{notice}{tip}{Astuce:}
\textbf{Autres utilisations de r.contour}

La procédure décrite ci-dessus peut être utilisée dans d'autres cas. Si vous disposez d'une couche d'informations raster representant des précipitations, par exemple, vous pouvez utiliser la même méthode pour créer des isohyètes (lignes reliant des points d'égales quantités de précipitations).
\end{notice}


\subsubsection{Créer un ombrage avec effet 3D}
\label{docs/user_manual/grass_integration/grass_integration:creating-a-hillshade-3d-effect}
Différentes méthodes sont utilisées pour afficher les modèles numérique de terrain et donner un effet 3D au carte. L'utilisation de courbes de niveau comme décrit ci-dessus est un des moyens souvent utilisés pour produire des cartes topographiques. Un autre moyen de rendre cet effet 3D est d'utiliser l'ombrage. L'ombrage est créé à partir du modèle numérique de terrain (MNT) en calculant d'abord les pentes et les expositions puis en simulant la position du soleil dans le ciel ce qui donne à chaque cellule une valeur de réflectance. Les pentes éclairées par le soleil sont plus claires et les pentes à l'abri du soleil sont plus sombres.
\begin{itemize}
\item {} 
Commencez par ouvrir la couche raster \code{gtopo30}. Ouvrez la boite à outils GRASS et dans la catégorie Raster double cliquez sur \emph{Analyse spatiale \(\rightarrow\) Analyse de terrain}.

\item {} 
Cliquez ensuite sur \textbf{r.shaded.relief} pour lancer le module.

\item {} 
Changer l' \emph{Azimuth du soleil par rapport au nord, en degrés} \includegraphics{selectnumber.png} et mettez 315.

\item {} 
Saisissez \code{gtopo30\_shade} comme nom pour la nouvelle couche d'ombrage et cliquez sur le bouton \textbf{{[}Lancer{]}}.

\item {} 
Quand le calcul est terminé, ajoutez le raster d'ombrage à la fenêtre carte. Normalement, il devrait s'afficher en niveau de gris.

\item {} 
Pour voir les deux couches d'informations ombrage et \code{gtopo30} en même temps, placez la couche ombrage sous la couche \code{gtopo30} dans le gestionnaire de couches et ouvrez la fenêtre \emph{Propriétés} de la couche \code{gtopo30}, allez sur l'onglet \emph{Transparence} et fixez la transparence à environ 25\%.

\end{itemize}

Vous devriez maintenant avoir la couche \code{gtopo30} en couleur et en transparence, affiché \textbf{au dessus} de la couche d'ombrage en niveau de gris. Pour bien visualiser l'effet d'ombrage, décochez puis recochez la couche \code{gtopo30\_shade} dans la légende.

\textbf{Utiliser la console GRASS}

L'extension Grass de QGIS est faite pour les utilisateurs ne connaissant pas GRASS et qui ne sont pas familiers avec les modules et les options. Ainsi, certains modules dans la boite à outils n'apparaissent pas avec toutes les options possibles et certains n'apparaissent pas du tout. La console GRASS donne accès à ces modules additionnels qui n'apparaissent pas dans la boite à outils et aussi aux options des modules qui n'apparaissent que de façon simplifiés dans la boite à outils. Cet exemple montre l'utilisation des options supplémentaires du module \textbf{r.shaded.relief} utilisé ci-dessus.
\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{grass_toolbox_shell.png}
\caption{The GRASS shell, r.shaded.relief module \includegraphics[width=1em]{nix.png}}\end{figure}

Le module \textbf{r.shaded.relief} possède un paramètre \code{zmult} qui multiplie la valeur de l'altitude (exprimé dans la même unité que les coordonnées X - Y) ce qui a pour effet d'accentuer le relief.
\begin{itemize}
\item {} 
Ouvrez le raster \code{gtopo30} comme ci-dessus, lancez la boite à outils GRASS et ouvrez la console GRASS. Dans la console, entrez la ligne suivante \code{r.shaded.relief map=gtopo30 shade=gtopo30\_shade2 azimuth=315 zmult=3} et pressez \textbf{{[}Entrée{]}}.

\item {} 
Une fois le calcul terminé, allez sur l'onglet \emph{Parcourir} et double-cliquez sur le nouveau raster \code{gtopo30\_shade2} pour l'afficher dans QGIS.

\item {} 
Comme expliqué ci-dessus, placez le raster d'ombrage sous le raster gtopo30 puis vérifiez la transparence du raster gtopo30. Vous devriez constater que le relief apparaît plus marqué qu'avec le premier raster d'ombrage.

\end{itemize}
\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{grass_toolbox_shadedrelief.png}
\caption{Displaying shaded relief created with the GRASS module r.shaded.relief \includegraphics[width=1em]{nix.png}}\end{figure}


\subsubsection{Statistiques raster avec des couches vectorielles}
\label{docs/user_manual/grass_integration/grass_integration:raster-statistics-in-a-vector-map}
L'exemple suivant comment un module GRASS peut aggréger des données raster et ajouter des colonnes de statistiques pour chaque polygone d'une couche vectorielle.
\begin{itemize}
\item {} 
Encore une fois, nous allons utiliser le jeu de  données Alaska. Référez vous à {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-import-loc-data]{\emph{Importer des données dans un SECTEUR GRASS}}} pour importer les shapefiles contenus dans le répetoire \code{shapefiles} dans GRASS.

\item {} 
Un étape intermédiaire est nécessaire : des centroïdes doivent importés afin d'avoir une couche GRASS vecteur complète (incluant les contours et les centroïdes).

\item {} 
Dans la boite à outils choisissez \emph{Vecteur -\textgreater{} Gestion des entités} et ouvrez le module \textbf{v.centroids}.

\item {} 
Entrez `forest\_areas' comme  \emph{nom de couche en sortie} et lancez le module.

\item {} 
Maintenant ouvrez la couche vectorielle \code{forest\_areas} et affichez les types de forêts avec différentes couleurs : caduques, persistentes, mélangées. Dans la fenêtre \emph{Propriétés}, onglet  \emph{symbologie} , choisissez le \emph{Type de légende} \includegraphics{selectstring.png} `Valeur unique' et le champ `VEGDESC' comme champ de classification. (Reportez vous aux explications de l'onglet Symbologie \emph{sec\_symbology} dans la section vecteur).

\item {} 
Réouvrez la boîte à outils GRASS et ouvrez \emph{Vecteur -\textgreater{} Mise à jour vectorielle via d'autres cartes}.

\item {} 
Cliquez sur le module \textbf{v.rast.stats}. Saisissez \code{gtopo30} et \code{forest\_areas}.

\item {} 
Un seul paramètre additionnel est requis : Entrez \code{elev} pour le \emph{column prefix}, et cliquez sur le bouton \textbf{{[}Lancer{]}}. C'est un opération lourde qui peut durer longtemps (jusqu'à deux heures).

\item {} 
Pour finir, ouvrez la table attributaire de \code{forest\_areas}, et vérifiez que plusieurs nouvelles colonnes ont étés ajoutées dont \code{elev\_min}, \code{elev\_max}, \code{elev\_mean}, etc. pour chaque polygone de forêt.

\end{itemize}


\subsection{Travailler avec le navigateur GRASS}
\label{docs/user_manual/grass_integration/grass_integration:working-with-the-grass-location-browser}
\index{GRASS toolbox!Browser}
Une autre fonctionnalité utile de la boîte à outils GRASS est le navigateur de \code{SECTEUR} GRASS. Sur la figure {\hyperref[docs/user_manual/grass_integration/grass_integration:figure-grass-module-7]{figure\_grass\_module\_7}} vous pouvez voir le \code{SECTEUR} en cours avec ses \code{Jeux de données}.

Dans la partie gauche de la fenêtre vous pouvez naviguer dans tous les \code{Jeux de données} du \code{SECTEUR} courant. La partie droite de la fenêtre affiche des informations sur le raster ou le vecteur sélectionné, tel que la résolution, l'emprise, la source des données, les tables attributaires pour les vecteurs et un historique des commandes.
\phantomsection\label{docs/user_manual/grass_integration/grass_integration:figure-grass-module-7}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{grass_mapset_browser.png}
\caption{GRASS LOCATION browser \includegraphics[width=1em]{nix.png}}\end{figure}

La barre d'outils de l'onglet \emph{Parcourir} donne accès à des outils de gestion du \code{SECTEUR} sélectionné :
\begin{itemize}
\item {} 
\includegraphics[width=1.5em]{grass_add_map.png} \emph{Ajoute la carte sélectionnée à la carte QGIS}

\item {} 
\includegraphics[width=1.5em]{grass_copy_map.png} \emph{Copie la carte sélectionnée}

\item {} 
\includegraphics[width=1.5em]{grass_rename_map.png} \emph{Renomme la carte sélectionnée}

\item {} 
\includegraphics[width=1.5em]{grass_delete_map.png} \emph{Efface la carte sélectionnée}

\item {} 
\includegraphics[width=1.5em]{grass_set_region.png} \emph{Région courante réglée sur la carte choisie}

\item {} 
\includegraphics[width=1.5em]{grass_refresh.png} \emph{Rafraîchir}

\end{itemize}

Les commandes \includegraphics[width=1.5em]{grass_rename_map.png} \emph{Renommer la carte sélectionnée} et \includegraphics[width=1.5em]{grass_delete_map.png} \emph{Effacer la carte sélectionnée} ne fonctionnent qu'avec les cartes présentes dans votre \code{Jeu de données} sélectionné. Tous les autres outils fonctionnent aussi avec les autres \code{Jeux de données}.


\subsection{Paramètrer la boîte à outils GRASS}
\label{docs/user_manual/grass_integration/grass_integration:customizing-the-grass-toolbox}\label{docs/user_manual/grass_integration/grass_integration:sec-toolbox-customizing}
\index{GRASS toolbox!customize}
Pratiquement tous les modules GRASS peuvent être ajoutés à la boîte à outils. Une interface XML est fournie pour analyser les fichiers XML très simples qui configurent l'apparence et les paramètres des modules dans la boîte à outils.

Un exemple de fichier XML pour le module \code{v.buffer} (v.buffer.qgm) est donné ci-dessous :

\begin{Verbatim}[commandchars=\\\{\}]
\textless{}?xml version="1.0" encoding="UTF-8"?\textgreater{}
\textless{}!DOCTYPE qgisgrassmodule SYSTEM "http://mrcc.com/qgisgrassmodule.dtd"\textgreater{}

\textless{}qgisgrassmodule label="Vector buffer" module="v.buffer"\textgreater{}
        \textless{}option key="input" typeoption="type" layeroption="layer" /\textgreater{}
        \textless{}option key="buffer"/\textgreater{}
        \textless{}option key="output" /\textgreater{}
\textless{}/qgisgrassmodule\textgreater{}
\end{Verbatim}

L'analyseur lit cette définition et crée un nouvel onglet à l'intérieur de la boîte à outils lorsque vous sélectionnez le module. Une description plus détaillée pour ajouter des modules, changer les groupes de modules, etc. est disponible sur le wiki QGIS à l'adresse \href{http://hub.qgis.org/projects/quantum-gis/wiki/Adding\_New\_Tools\_to\_the\_GRASS\_Toolbox}{http://hub.qgis.org/projects/quantum-gis/wiki/Adding\_New\_Tools\_to\_the\_GRASS\_Toolbox}


\chapter{OpenStreetMap}
\label{docs/user_manual/osm/openstreetmap:openstreetmap}\label{docs/user_manual/osm/openstreetmap::doc}\label{docs/user_manual/osm/openstreetmap:plugins-osm}
In recent years, the OpenStreetMap project has gained popularity because in many
countries no free geodata such as digital roadmaps are available. The objective
of the OSM project is to create a free editable map of the world from GPS data,
aerial photography or from local knowledge. To support this objective, QGIS
provides a plugin that enables its users to work with OSM data.

The OpenStreetMap plugin, a core QGIS plugin, provides the basic functionalities
for OSM data manipulation; this includes data loading, importing, saving,
downloading, editing and uploading data back to the OpenStreetMap server. While
implementing the OSM plugin an inspiration was taken from existing OSM data
editors. The purpose was to combine their functionalities to get the best possible
result.

The following section gives a brief introduction to principles of the OSM project.

Parts of the following paragraphs are copied from the OpenStreetMap web site at
\href{http://www.openstreetmap.org}{http://www.openstreetmap.org}.


\section{The OpenStreetMap project}
\label{docs/user_manual/osm/openstreetmap:the-openstreetmap-project}
OpenStreetMap is a project to create a free editable map of the world. The maps
are created using data from portable GPS devices, aerial photography, other free
sources or simply from local knowledge. The project was started because most maps
have legal or technical restrictions on their use, restricting people from using
them in creative, productive, or unexpected ways. Both rendered images and the
vector dataset of OSM are available for download under a Creative Commons Attribution
ShareAlike 2.0 license.
\phantomsection\label{docs/user_manual/osm/openstreetmap:figure-openstreetmap-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=40em]{osmweb.png}
\caption{OpenStreetMap data in the web}\end{figure}

OpenStreetMap was inspired by sites such as Wikipedia - the map display
(see {\hyperref[docs/user_manual/osm/openstreetmap:figure-openstreetmap-1]{Figure\_OpenStreetMap\_1}} ) features a prominent \emph{Edit} tab and a
full revision history is maintained. Registered users can upload GPS track logs
and edit the vector data using the given editing tools.

OSM data primitive is an object class that can be stored via the API in the
server. The three supported types of data are: \textbf{Node}, \textbf{Way} and \textbf{Relation}.
\begin{itemize}
\item {} 
\textbf{A node} is a latitude/longitude pair of coordinates. It is used as building
a block for other features and as a feature itself (Points Of Interest), if
they are tagged as required.

\item {} 
\textbf{A way} is a list of at least two nodes that describe a linear feature such
as a street, or similar. Nodes can be members of multiple ways.

\item {} 
\textbf{A relation} is a group of zero or more primitives with associated roles. It
is used to specify relationships between objects, and may also model an abstract
object.

\end{itemize}

Several different logical features in a common map `Point Of Interest', `Street',
`Tram Line', `Bus Stop' etc.) are defined by these primitives. Map features are
well-known in the OSM community and are stored as tags, based on a key and a
value. OSM is usually distributed in XML format. XML payload is used for the
communication with the OSM server as well.


\section{QGIS - OSM Connection}
\label{docs/user_manual/osm/openstreetmap:qgis-osm-connection}\label{docs/user_manual/osm/openstreetmap:id1}
The first part of this section describes how OSM data primitives are displayed
in QGIS vector layers. As previously mentioned, OSM data consists of Nodes, Ways
and Relations. In QGIS, they are displayed in three different layer types: Point
layer, Line layer and Polygon layer. It is not possible to remove any of these
layers and work with the other ones.
\begin{itemize}
\item {} 
A \textbf{Point layer} displays all features of type Node that stands alone. That
means that only Nodes that are not included in any Way belongs to the Point layer.

\item {} 
A \textbf{Line layer} displays those OSM features of type Way that are not closed.
That means, none of these Ways starts and ends with the same Node.

\item {} 
A \textbf{Polygon layer} displays all Ways that are not included in Line layer.

\end{itemize}

OpenStreetMap has one more data primitive in addition to the three mentioned
above. This is called \textbf{Relation}. There is purposely no vector layer to display
Relations. A Relation defines a connection between any number of data primitives.
After a Point, Line or Polygon is identified on a map, the plugin shows a list
of all relations which the identified feature is part of.

It was challenging to design the connection between OSM data and the standard
QGIS editing tools. These tools are made to edit a single vector layer at a time,
no matter of what feature types it displays. This means that if OSM data are
loaded to QGIS through the plugin, you could (theoretically) edit the Point
layer, Line layer or Polygon layer with these standard tools separately.

A Line layer consists of two different types of OSM features, Ways and Nodes.
In OSM format, a Way is composed of Nodes. If you start editing a Line layer
and change the shape of some line, your action affects not only the OSM Way,
but also the OSM Nodes that are part of it.

QGIS standard editing tools cannot tell the OSM provider, which members of which
line has changed and how. It can tell only what's the new geometry of which line,
and that's not enough to propagate changes to the OSM database correctly. The
Line layer does also not know the identifiers of the line members. The same
problem occurs when you try to edit the Polygon layer.

For this reason, the OSM plugin need its own tools for editing OSM data. While
they are used, the OSM layers can be changed correctly. The Plugin editing tools
consists of tools for Point, Line, Polygon and Relation creation, deletion and
moving.

\begin{notice}{note}{Note:}
To create a connection between the OSM plugin and standard editing tools,
changes in QuantumGIS core code would be necessary.
\end{notice}


\section{Installation}
\label{docs/user_manual/osm/openstreetmap:installation}
The OpenStreetMap plugin is a core plugin inside QGIS. The `OpenStreetMap' plugin
can be selected in the Plugin Manager as described in section {\hyperref[docs/user_manual/plugins/plugins:load-core-plugin]{\emph{Activer une extension principale}}}.


\section{Basic user interface}
\label{docs/user_manual/osm/openstreetmap:basic-user-interface}
The first time the OSM plugin is started (and after the first data are loaded),
several new OSM plugin icons appear in the QGIS toolbar menu together with new
dock windows as shown in {\hyperref[docs/user_manual/osm/openstreetmap:figure-openstreetmap-2]{figure\_OpenStreetMap\_2}}.
\phantomsection\label{docs/user_manual/osm/openstreetmap:figure-openstreetmap-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=40em]{osm_widgets.png}
\caption{OSM plugin user interface}\end{figure}


\subsection{OSM Features widget}
\label{docs/user_manual/osm/openstreetmap:osm-features-widget}
The OSM Feature widget helps to identify OSM features. It shows basic information
on the feature type and identifier as well as information on who has changed a
feature, and when. The OSM Feature widget also provides all editing tools (in
the top part of it). More information on those tools can be found in the sections
below. The widget is initially disabled. It activates itself after successful
loading some OSM data.


\subsection{OSM Undo/Redo widget}
\label{docs/user_manual/osm/openstreetmap:osm-undo-redo-widget}
This Undo/Redo widget is used to undo and redo edit actions. It consists not only
a classic Undo and Redo button, but also shows a list with a brief description
of the edit actions that were done. The OSM Undo/Redo widget is initially closed.
You can show it using a button on the OSM Feature widget.


\subsection{Toolbar menu icons}
\label{docs/user_manual/osm/openstreetmap:toolbar-menu-icons}
\includegraphics[width=1.5em]{osm_load.png} $^{\text{Load OSM from file}}$ is used to load data from a special
OpenStreetMap XML file.

\includegraphics[width=1.5em]{osm_featureManager.png} $^{\text{Show/Hide OSM Feature Manager}}$ is used to show or hide
the OSM Feature widget. The OSM Feature widget is a panel that helps with OSM
feature identification and with OSM data editing.

\includegraphics[width=1.5em]{osm_download.png} $^{\text{Download OSM data}}$ is used to download data from the
OpenStreetMap server.

\includegraphics[width=1.5em]{osm_upload.png} $^{\text{Upload OSM data}}$ is used to upload changes (on current data).

\includegraphics[width=1.5em]{osm_import.png} $^{\text{Import data from a layer}}$ is used to import data from a vector
layer. At least one vector layer must be loaded and current OSM data must be selected.

\includegraphics[width=1.5em]{osm_save.png} $^{\text{Save OSM to file}}$ is used to save OSM data back to an XML file.

More detailed information on all the widgets, buttons and dialogs can be found
in appropriate sections of this plugin section according to their functionality
(editing, identification, etc.).


\section{Loading OSM data}
\label{docs/user_manual/osm/openstreetmap:loading-osm-data}
The first action that should be done after starting the OSM Plugin is opening data
from an OSM file. OSM data can be import as shapefile or downloaded directly from
the OpenStreetMap server. Here we are focusing on the first mentioned method.

To load data from a file use the \includegraphics[width=1.5em]{osm_load.png} $^{\text{Load OSM from file}}$ icon. If
there is no such button, maybe someone disabled OpenStreetMap toolbar in your
QGIS installation. You can enable it again selecting \emph{Settings \(\rightarrow\)
Toolbars \(\rightarrow\) OpenStreetMap}.
\phantomsection\label{docs/user_manual/osm/openstreetmap:figure-openstreetmap-3}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{osmloaddialog.png}
\caption{Load OSM data dialog}\end{figure}

The purpose of its elements is explained below.

\textbf{OpenStreetMap file to load}: Click on the \includegraphics{browsebutton.png} button to select the
file:\emph{.osm} file you want to load data from.

\textbf{Add columns for tags}: This option determines a connection between OSM and QGIS
data. Each feature of OSM data has some tags (pairs of key and value), that
define the feature properties. Each feature of a QGIS vector layer also has its
attributes (key and value). With this option you can define which properties of
OSM objects should be visible when displaying detailed information about QGIS
features.

\textbf{Replace current data}: Checking this option means that new data should replace
current data the user is working with. Layers of current data will be removed and
new ones will be loaded. When loading OSM data for the first time, this option
is not active, because there is nothing to replace.

\textbf{Use custom renderer}: This option determines how many details of the map will
be used. There are three pre-defined OSM styles for map displaying. Use `Small
scale' if you want to view OSM data at low level, to see all details and to edit
something. If not you can use `Medium scale' or `Large scale'. QGIS 1.8.0 doesn't
support changing the renderer style dynamically.

Click \textbf{{[}OK{]}} to load your data. If this is the first time the OSM file is loaded,
the plugin must first parse the database. This may take few seconds or minutes - it
depends on the amount of loaded data.


\section{Viewing OSM data}
\label{docs/user_manual/osm/openstreetmap:viewing-osm-data}
After the OSM data are loaded, you can identify map features using the appropriate
tool. Use the \includegraphics[width=1.5em]{osm_identify.png} $^{\text{Identify feature}}$ button on the top-left of the
OSM Feature widget. Using this tool you can easily explore all map objects. When
the mouse cursor is placed over an object, you can see all information on it
directly in the OSM Feature widget. There is also a dynamic rubberband displayed
on the map so that the user is able to determine which feature is currently
identified.

The \emph{Properties} tab of the widget contains of all feature tags.
Clicking on the \emph{Relation} tab shows you a list of all relations
connected with identified feature.

If you want to hold a feature for a while to be able to read its properties and
relations, move the mouse cursor at the same time, try left-clicking while you
are over the feature. Identification process will stop until next left-clicking.

Sometimes there is more than one feature at a point where left-clicking was
performed. This happens especially when clicking on cross-roads or if you did
not zoom enough into the map. In this situation only one of such features is
identified (and marked with the rubberband) but the plugin remembers all of them.
Then (still in the pause mode) you can cycle through the identified features by
right-clicking.


\section{Editing basic OSM data}
\label{docs/user_manual/osm/openstreetmap:editing-basic-osm-data}
`Basic data' in this context means non-relational OSM features - nodes and ways.
If you prefer to examine how to perform relational editing, skip this section
and move on to the next one.

Basic data editing is a key part of the OSM Plugin. You can change the property,
position or shape of any existing basic feature. You can remove features or add
new ones. All changes on nodes and ways are remembered by Undo/Redo all changes
can be easily uploaded to the OpenStreetMap server.


\subsection{Changing feature tags}
\label{docs/user_manual/osm/openstreetmap:changing-feature-tags}
Changing the property/tag of an OSM feature can be done directly in the table of
feature tags. The Tags table of basic features can be found on the OSM Feature
widget. Don't forget to identify feature first.
\phantomsection\label{docs/user_manual/osm/openstreetmap:figure-openstreetmap-4}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=40em]{osm_changefeaturetag.png}
\caption{Changing an OSM feature tag}\end{figure}

If you want to change a tag value, just double-click in the appropriate row of
column `Value' and type, or select a new value. If you want to remove a tag,
click in the relevant row, then use the button \includegraphics[width=1.5em]{osm_removeTag.png} $^{\text{Remove
selected tags}}$ on the right bottom under the table.

To add new tags just type the key and value into the last row of the table where
`\textless{}next tag value\textgreater{}' is written. Notice that you cannot change the key of an
existing tag pair. Conveniently, there are some combo boxes of all existing tag
keys and their typical values.


\subsection{Point creation}
\label{docs/user_manual/osm/openstreetmap:point-creation}
For point creation there is a \includegraphics[width=1.5em]{osm_createPoint.png} $^{\text{Create point}}$ button on the
OSM Feature widget. To create some points, just click on the button and start
clicking on the map. If your cursor is over some map feature, the feature is
marked/identified immediately. If you click on the map when a line or polygon is
marked, a new point is created directly on such line or polygon as its new member.
If your cursor is over an existing point, a new point cannot be created. In such
case the OSM plugin will show following message:
\phantomsection\label{docs/user_manual/osm/openstreetmap:figure-openstreetmap-5}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{osm_pointcreation.png}
\caption{OSM point creation message}\end{figure}

The mechanism of helping a user to hit the line or polygon is called snapping
and is enabled by default. If you want to create a point very close to some line
(but not on it) you must disable snapping by holding the \code{Ctrl} key first.


\subsection{Line creation}
\label{docs/user_manual/osm/openstreetmap:line-creation}
For line creation, there is a \includegraphics[width=1.5em]{osm_createLine.png} $^{\text{Create Line}}$ button on the
OSM Feature widget. To create a line just click the button and start left-clicking
on the map. Each of your left-clicks is remembered as a vertex of the new line.
Line creation ends when the first right-click is performed. The new line will
immediately appear on the map.

\begin{notice}{note}{Note:}
A Line with less than two members cannot be created. In such case the operation
is ignored.
\end{notice}

Snapping is performed to all map vertices - points from the Point vector layer
and all Line and Polygon members. Snapping can be disabled by holding the
\code{Ctrl} key.


\subsection{Polygon creation}
\label{docs/user_manual/osm/openstreetmap:polygon-creation}
For polygon creation there is a \includegraphics[width=1.5em]{osm_createPolygon.png} $^{\text{Create polygon}}$ button
on the OSM Feature widget. To create a polygon just click the button and start
left-clicking on the map. Each of your left-clicks is remembered as a member
vertex of the new polygon. The Polygon creation ends when first right-click is
performed. The new polygon will immediately appear on the map. Polygon with less
than three members cannot be created. In such case operation is ignored. Snapping
is performed to all map vertexes - points (from Point vector layer) and all Line
and Polygon members. Snapping can be disabled by holding the \code{Ctrl} key.


\subsection{Map feature moving}
\label{docs/user_manual/osm/openstreetmap:map-feature-moving}
If you want to move a feature (no matter what type) please use the \includegraphics[width=1.5em]{osm_move.png}
$^{\text{Move feature}}$ button from the OSM Feature widget menu. Then you can browse
the map (features are identified dynamically when you go over them) and click on
the feature you want to move. If a wrong feature is selected after your click,
don't move it from the place. Repeat right-clicking until the correct feature is
identified. When selection is done and you move the cursor, you are no more able
to change your decision what to move. To confirm the move, click on the left mouse
button. To cancel a move, click another mouse button.

If you are moving a feature that is connected to another features, these
connections won't be damaged. Other features will just adapt themselves to a new
position of a moved feature.

Snapping is also supported in this operation, this means:
\begin{itemize}
\item {} 
When moving a standalone (not part of any line/polygon) point,snapping to all
map segments and vertices is performed.

\item {} 
When moving a point that is a member of some lines/polygons,snapping to all map
segments and vertices is performed, except for vertices of point parents.

\item {} 
When moving a line/polygon, snapping to all map vertices is performed. Note
that the OSM Plugin tries to snap only to the 3 closest-to-cursor vertices of
a moved line/polygon, otherwise the operation would by very slow. Snapping can
be disabled by holding \code{Ctrl} key during the operation.

\end{itemize}


\subsection{Map feature removing}
\label{docs/user_manual/osm/openstreetmap:map-feature-removing}
If you want to remove a feature, you must identify it first. To remove an
identified feature, use the \includegraphics[width=1.5em]{osm_removeFeat.png} $^{\text{Remove this feature}}$ button
on the OSM Feature widget. When removing a line/polygon, the line/polygon itself
is deleted, so are all its member points that doesn't belong to any other
line/polygon.

When removing a point that is member of some lines/polygons, the point is deleted
and the geometries of parent lines/polygons are changed. The new parent geometry
has less vertices than the old one.

If the parent feature was a polygon with three vertexes, its new geometry has
only two vertexes. And because there cannot exist polygon with only two vertices,
as described above, the feature type is automatically changed to Line.

If the parent feature was a line with two vertexes, its new geometry has only one
vertex. And because there cannot exist a line with only one vertex, the feature
type is automatically changed to Point.


\section{Editing relations}
\label{docs/user_manual/osm/openstreetmap:editing-osm-relation}\label{docs/user_manual/osm/openstreetmap:editing-relations}
Thanks to existence of OSM relations we can join OSM features into groups and
give them common properties - in such way we can model any possible map object:
borders of a region (as group of ways and points), routes of a bus, etc. Each
member of a relation has its specific role. There is a pretty good support for
OSM Relations in our plugin. Let's see how to examine, create, update or remove
them.


\subsection{Examining relation}
\label{docs/user_manual/osm/openstreetmap:id2}\label{docs/user_manual/osm/openstreetmap:examining-relation}
If you want to see relation properties, first identify one of its members. After
that open the \emph{Relations} tab on the OSM Feature widget. At the top of
the tab you can see a list of all relations the identified feature is part of.
Please choose the one you want to examine and look at its information below. In
the first table called `Relation tags' you find the properties of the selected
relation. In the table called `Relation members' you see brief information on
the relation members. If you click on a member, the plugin will make a rubberband
on it in the map.


\subsection{Relation creation}
\label{docs/user_manual/osm/openstreetmap:relation-creation}
There are 2 ways to create a relation:
\begin{enumerate}
\item {} 
You can use the \includegraphics[width=1.5em]{osm_createRelation.png}$^{\text{Create relation}}$ button on OSM
Feature widget.

\item {} 
You can create it from the \emph{Relation} tab of OSM Feature widget
using the \includegraphics[width=1.5em]{osm_addRelation.png}$^{\text{Add relation}}$ button.

\end{enumerate}

In both cases a dialog will appear. For the second case, the feature that is
currently identified is automatically considered to be the first relation member,
so the dialog is prefilled a little. When creating a relation, please select its
type first. You can select one of predefined relation types or write your own
type. After that fill the relation tags and choose its members.

If you have already selected a relation type, try using the \includegraphics[width=1.5em]{osm_generateTags.png}
$^{\text{Generate tags}}$ button. It will generate typical tags to your relation type.
Then you are expected to enter values to the keys. Choosing relation members can
be done either by writing member identifiers, types and roles or using the
\includegraphics[width=1.5em]{osm_identify.png} $^{\text{Identify}}$ tool and clicking on map.

Finally when type, tags and members are chosen, the dialog can be submitted.
In such case the plugin creates a new relation for you.


\subsection{Changing relation}
\label{docs/user_manual/osm/openstreetmap:changing-relation}
If you want to change an existing relation, identify it first (follow steps
written above in Section {\hyperref[docs/user_manual/osm/openstreetmap:examining-relation]{\emph{Examining relation}}}). After that click on the
\includegraphics[width=1.5em]{osm_editRelation.png} $^{\text{Edit relation}}$ button. You will find it on the OSM
Feature widget. A new dialog appears, nearly the same as for the `create relation'
action. The dialog is pre-filled with information on given relations. You can
change relation tags, members or even its type. After submitting the dialog your
changes will be committed.


\section{Downloading OSM data}
\label{docs/user_manual/osm/openstreetmap:downloading-osm-data}
To download data from OpenStreetMap server click on the \includegraphics[width=1.5em]{osm_download.png}
$^{\text{Download OSM data}}$ button. If there is no such button, the OSM toolbar may
be disabled in your QGIS instalation. You can enable it again at
\emph{Settings \(\rightarrow\) Toolbars \(\rightarrow\) OpenStreetMap} . After clicking the
button a dialog occurs and provides following functionalities:
\phantomsection\label{docs/user_manual/osm/openstreetmap:figure-openstreetmap-6}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{osm_downloaddialog.png}
\caption{OSM download dialog}\end{figure}

\textbf{Extent}: Specifies an area to download data from intervals of latitude and
longitude degrees. Because there is some restriction of OpenStreetMap server on
how much data can be downloaded, the intervals must not be too wide. More detailed
info on extent specification can is shown after clicking the \includegraphics[width=1.5em]{osm_questionMark.png}
$^{\text{Help}}$ button on the right.

\textbf{Download to}: Here you are expected to write a path to the file where data
will be stored. If you can't remember the structure of your disk, don't panic.
The browse button \includegraphics{browsebutton.png} will help you.

\textbf{Open data automatically after download}: Determines, if the download process
should be followed by loading the data process or not. If you prefer not to load
data now, you can do it later by using the \includegraphics[width=1.5em]{osm_load.png} $^{\text{Load OSM from file}}$
button.

\textbf{Replace current data}: This option is active only if \includegraphics{radiobuttonon.png}
\emph{Open data automatically after download} is checked. Checking this
option means that downloaded data should replace current data we are working with
now. Layers of the current data will be removed and new ones will be loaded. When
starting QGIS and downloading OSM data for the first time, this option is
initially inactive, because there is nothing to replace.

\textbf{Use custom renderer}: This option is active only if the \includegraphics{radiobuttonon.png}
\emph{Open data automatically after download} checkbox is checked. It
determines how many details will be in the map. There are three predefined OSM
styles for map displaying. Use `Small scale' if you want to view OSM data at low
level, to see all details and to edit something. If not you can use `Medium scale'
or `Large scale'. QGIS 1.8.0 does not support changing the renderer style
dynamically.

Click the \textbf{{[}Download{]}} button to start the download process.

A progress dialog will continuously inform you about how much of data is already
downloaded. When an error occurs during the download process, a dialog tells you
why. When action finishes successfully both the progress dialog and download
dialog will close themselves.


\section{Uploading OSM data}
\label{docs/user_manual/osm/openstreetmap:uploading-osm-data}
Note that the upload is always done on current OSM data. Before opening the OSM
Upload dialog, please be sure that you really have the right active layer with
OSM data.

To upload current data to the OSM server click on the \includegraphics[width=1.5em]{osm_upload.png}
$^{\text{Upload OSM data}}$ button. If there is no such button, OSM toolbar in your
QGIS installation is disabled. You can enable it again in
\emph{Settings \(\rightarrow\) Toolbars \(\rightarrow\) OpenStreetMap} . After clicking the
\textbf{{[}Upload{]}} button a new dialog will appear.
\phantomsection\label{docs/user_manual/osm/openstreetmap:figure-openstreetmap-7}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{osm_uploaddialog.png}
\caption{OSM upload dialog}\end{figure}

At the top of the dialog you can check, if you are uploading the correct data.
There is a short name of a current database. In the table you find information
on how many changes will be uploaded. Statistics are displayed separately for
each feature type.

In the `Comment on your changes' box you can write brief information on meaning
of your upload operation. Just write in brief what data changes you've done or
let the box empty. Fill `OSM account' arrays so that the server could authenticate
you. If you don't have an account on the OSM server, it's the best time to create
one at \href{http://www.openstreetmap.org}{http://www.openstreetmap.org}. Finally use \textbf{{[}Upload{]}} to start an upload
operation.


\section{Saving OSM data}
\label{docs/user_manual/osm/openstreetmap:saving-osm-data}
To save data from a current map extent to an XML file click on the \includegraphics[width=1.5em]{osm_save.png}
$^{\text{Save OSM to file}}$ button. If there is no such button, the OSM toolbar in
your QuantumGIS installation is probably disabled. You can enable it again in
\emph{Settings \(\rightarrow\) Toolbars \(\rightarrow\) OpenStreetMap}. After clicking on the
button a new dialog appears.
\phantomsection\label{docs/user_manual/osm/openstreetmap:figure-openstreetmap-8}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{osm_savedialog.png}
\caption{OSM saving dialog}\end{figure}

Select features you want to save into XML file and the file itself. Use the
\textbf{{[}OK{]}} button to start the operation. The process will create an XML file, in
which OSM data from your current map extent are represented. The OSM version of
the output file is 0.6. Elements of OSM data (\textless{}node\textgreater{}, \textless{}way\textgreater{}, \textless{}relation\textgreater{}) do not
contain information on their changesets and uids. This information are not
compulsory yet, see DTD for OSM XML version 0.6. In the output file OSM elements
are not ordered.

Notice that not only data from the current extent are saved. Into the output file
the whole polygons and lines are saved even if only a small part of them is
visible in the current extent. For each saved line/polygon all its member nodes
are saved too.


\section{Import OSM data}
\label{docs/user_manual/osm/openstreetmap:import-osm-data}
To import OSM data from an opened non-OSM vector layer follow this instructions.
Choose current OSM data by clicking on one of their layers. Click on the
\includegraphics[width=1.5em]{osm_import.png} $^{\text{Import data from a layer}}$ button. If there is no such button,
someone has probably disabled the OpenStreetMap toolbar in your QGIS installation.
You can enable it again in \emph{Settings \(\rightarrow\) Toolbars \(\rightarrow\) OpenStreetMap}.

After clicking on the button following message may show up:
\phantomsection\label{docs/user_manual/osm/openstreetmap:figure-openstreetmap-9}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{osm_importdialog.png}
\caption{OSM import message dialog}\end{figure}

In such case there is no vector layer currently loaded. The import must be done
from a loaded layer - please load a vector layer from which you want to import
data. After a layer is opened, your second try should give you a better result
(don't forget to mark the current OSM layer again):
\phantomsection\label{docs/user_manual/osm/openstreetmap:figure-openstreetmap-10}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{osm_importtoosmdialog.png}
\caption{Import data to OSM dialog}\end{figure}

Use the submit dialog to start the process of OSM data importing. Reject it if
you are not sure you want to import something.


\chapter{SEXTANTE}
\label{docs/user_manual/sextante/index:sextante}\label{docs/user_manual/sextante/index::doc}\label{docs/user_manual/sextante/index:label-sextante}

\section{Introduction}
\label{docs/user_manual/sextante/intro:introduction}\label{docs/user_manual/sextante/intro::doc}
Ce chapitre présente le module SEXTANTE, la plateforme performante d'analyse géospatiale de QGIS. SEXTANTE est un environnement de géotraitement qui permet d'exécuter des algorithmes natifs ou d'applications tierces directement depuis QGIS, vous permettant d'effectuer des tâches d'analyses spatiales rapidement et efficacement.

Dans les sections suivantes, seront exposés les éléments graphiques de SEXTANTE et comment les exploiter au maximum


\subsection{Les éléments de base de l'interface graphique de SEXTANTE}
\label{docs/user_manual/sextante/intro:basic-elements-of-the-sextante-gui}
Il y a quatre éléments de base dans l'interface graphique de SEXTANTE, permettant d'excéuter des algorithmes SEXTANTE selon la finalité. Le choisx d'un outil plutôt qu'un autre dépendra du type d'analyse à réaliser, selon les préférences de l'utilisateur et du projet. Tous les éléments (à l'exception de l'interface de traitement en paquets qui est appelé par la boîte à outils) peuvent être utilisées à partir du menu \emph{SEXTANTE} (vous y verrez plus que quatre entrées de menu. Les autres entrées ne sont pas destinées à l'exécution d'algorithmes et seront expliquées plus tard dans ce chapitre).
\begin{itemize}
\item {} 
La Boîte à outils SEXTANTE. Il s'agit de l'élément principal de l'interface de SEXTANTE et permet de lancer les algorithmes individuellement ou par lot.

\end{itemize}
\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=15em]{toolbox.png}
\caption{SEXTANTE Toolbox \includegraphics[width=1em]{win.png}}\label{docs/user_manual/sextante/intro:figure-toolbox-1}\end{figure}
\begin{itemize}
\item {} 
Le modeleur graphique SEXTANTE. Les algorithmes peuvent être combinés graphiquement en utilisant le modeleur pour définir une tâche, composé plusieurs traitements

\end{itemize}
\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{models.png}
\caption{SEXTANTE Models \includegraphics[width=1em]{win.png}}\label{docs/user_manual/sextante/intro:figure-model}\end{figure}
\begin{itemize}
\item {} 
Le gestionnaire d'historiques SEXTANTE. Toutes les actions réalisées par un élément précité sont sauvegardées dans une fichie d'historique et peuvent être aisément reproduites grâce au gestionnaire d'historiques

\end{itemize}
\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{history.png}
\caption{SEXTANTE History \includegraphics[width=1em]{win.png}}\label{docs/user_manual/sextante/intro:figure-history}\end{figure}
\begin{itemize}
\item {} 
Le gestionnaire de traitement en paquets SEXTANTE. Cette interface permetd'exécuter des traitements en paquets et d'automatiser l'exécution d'un même traitement sur plusieurs sources de données.

\end{itemize}
\phantomsection\label{docs/user_manual/sextante/intro:figure-batchprocess}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{batch_processing.png}
\caption{SEXTANTE Batch Processing \includegraphics[width=1em]{win.png}}\end{figure}

Dans les sections suivantes, ces quatre éléments seront détaillés.


\section{La boîte à outils SEXTANTE}
\label{docs/user_manual/sextante/toolbox:the-sextante-toolbox}\label{docs/user_manual/sextante/toolbox::doc}

\subsection{Introduction}
\label{docs/user_manual/sextante/toolbox:introduction}
La \emph{Boîte à outils} est l'élément principale de l'interface graphique de SEXTANTE et celui que vous utiliserez le plus au quotidien. Elle montre la liste des algorithmes disponibles, regroupés en plusieurs catégories. C'est aussi par son intermédiaire qu'il est possible d'exécuter ponctuellement, ou par paquets un algorithme sur un jeu de données en entrée.
\phantomsection\label{docs/user_manual/sextante/toolbox:figure-toolbox-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=15em]{toolbox.png}
\caption{SEXTANTE Toolbox \includegraphics[width=1em]{win.png}}\end{figure}

La boîte à outils contient tous les algorithmes disponibles, regroupés par catégorie. Chacune d'entre elles représente un `fournisseur d'algorithme', c'est-à-dire un ensemble d'algorithme prevenant de la même source, par exemple une application de géotraitement tierce (comme SAGA, GRASS ou R). D'autres algorithmes sont fournis directement par SEXTANTE. Ces derniers sont des réécritures d'extensions existantes de QGIS, comme les extensions fTools ou mmqgis, mais en leur permettant d'être inclus dans les flux de traitement du modeleur ou du l'interface de traitement par paquets décrits plus loin.

Deux fournisseurs supplémentaires sont fournis : `Modèles' et `Scripts'. Ces fournisseurs contiennent les algorithmes utilisateurs et vous permettent de définir vos flux de traitement. Une section complète est consacrée plus loin à ce sujet.

Dans la partie haute de la boîte à outils se trouve un champ texte. Pour réduire le nombre d'algorithmes affichés dans la boîte à outils et vous permettre de trouver celui qui vous convient, il vous suffit d'entrer un mot-clé ou une phrase dnas ce champ. La liste des algorithmes contenant ce texte est filtrée au fur et à mesure de la saisie.

Pour exécuter un algorithme, double-cliquez simplement sur son nom dans la boîte à outils.


\subsection{La fenêtre Algorithme}
\label{docs/user_manual/sextante/toolbox:the-algorithm-dialog}
Une fois que vous avez double-cliqué sur le nom de l'algorithme à exécuter, une fenêtre semblable à la suivante sera affichée (ici, il s'agit de la fenêtre de l'algorithme de SAGA `Index de convergence').
\phantomsection\label{docs/user_manual/sextante/toolbox:figure-parameters-dialog}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{parameters_dialog.png}
\caption{Parameters Dialog \includegraphics[width=1em]{win.png}}\end{figure}

Cette fenêtre permet de définir les données d'entrée à l'algorithme. Elle présente ici une table des données d'entrée et des paramètres à fournir. Cette fenêtre différera selon les paramètres nécessaires à l'exécution de l'algorithme et sera créée automatiquement. Sur la partie gauche, le nom du paramètre est affiché. Sur la droite, indiquez la valeur nécessaire.

Les algorithmes différeront par le nombre et le type de paramètres, mais la structure sera la même pour tous. Les paramètres présents dans la table pourront être un des types suivants.
\begin{itemize}
\item {} 
Une couche raster, à sélectionner dans la liste des couches disponibles (ouvertes) dans QGIS. Le sélecteur contient également un bouton sur sa partie droite, pour choisir un fichier correspondant à une couche non ouverte dans QGIS.

\item {} 
Une couche vectoirelle, à sélectionner dans la liste des couches disponibles dans QGIS. Tout comme pour les couches raster, vous pouvez sélectionner une couche par son nom de fichier, mais à la condition que l'algorithme ne nécessite pas un champ de cette couche vectorielle. Dans ce dernier cas, il est nécessaire de charger au préalable la couche vectorielle, afin de pouvoir accéder à la liste des champs.

Un bouton est présent à côté de chaque sélecteur de couche vectorielle. Si l'algorithme contient plusieurs de ces boutons, vous ne pourrez en activer qu'un seul. Pour la couche vectorielle correspondant à ce bouton activé, l'algorithme sera exécuté pour chacun de ses élements. Un exemple de ce type de traitement est exposé à la fin de cette section.

\item {} 
Une table, à sélectionner dans la liste des tables disponibles dans QGIS. Des tables non spatiales peuvent être chargées dans QGIS comme les couches vectorielles et sont en fait traitées de la même manière. Actuellement, les seules tables utilisables par les algorithmes SEXTANTE proviennent de fichiers DBase (\code{.dbf}) ou CSV (\code{.csv}).

\item {} 
Une option, à choisir dans une liste d'options possibles.

\item {} 
Une valeur numérique, à entrer dans le champ. Sur le côté se situe un bouton, vous permettant d'entrer une expression mathématique ou une valeur calculée. Des formules basées sur les données chargées dans QGIS peuvent être ajoutées à l'expression, par exemple la taille du carroyage d'une couche ou le point le plus au nord.

\end{itemize}
\phantomsection\label{docs/user_manual/sextante/toolbox:figure-number-selector}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{number_selector.png}
\caption{Number Selector \includegraphics[width=1em]{win.png}}\end{figure}
\begin{itemize}
\item {} 
Un intervalle, où doivent être remplies les valeurs minimales et maximales.

\item {} 
Une chaîne de texte, à mettre dans le champ correspondant.

\item {} 
Le num d'un champ, à choisir dans la liste des attributs d'une couche vectorielle ou d'une table préalablement sélectionnées.

\item {} 
Un Système de Coordonnées Géoréférencées (SCR). Entrez directement le code EPSG dans le champ, ou sélectionnez-le dans la fenêtre de sélection de SCR qui apparaît en cliquant sur le bouton à droite du champ

\item {} 
Une emprise, à entrer sous la forme des quatre limites \code{xmin}, \code{xmax}, \code{ymin}, \code{ymax}. En cliquant sur le bouton situé à droite du sélecteur, un menu apparaîtra, vous permettant de choisir l'emprise courante du canvas ou de le sélectionner avec la souris sur le canvas.
\phantomsection\label{docs/user_manual/sextante/toolbox:figure-extent}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{extent.png}
\caption{SEXTANTE Extent \includegraphics[width=1em]{win.png}}\end{figure}

Dans le premier cas s'affichera une fenêtre comme celle-ci.
\phantomsection\label{docs/user_manual/sextante/toolbox:figure-extent-list}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{extent_list.png}
\caption{SEXTANTE Extent List \includegraphics[width=1em]{win.png}}\end{figure}

Dans le second cas, la fenêtre de paramètres sera cachée afin de vous permettre de cliquer et glisser sur le canevas. Une fois le rectangle délimité, la fenêtre réapparaîtra, contenant les valeurs de l'emprise choisie.
\phantomsection\label{docs/user_manual/sextante/toolbox:figure-extent-drag}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{extent_drag.png}
\caption{Extent Drag \includegraphics[width=1em]{win.png}}\end{figure}

\item {} 
Une liste d'éléments (parmi les couches raster, vectorielles ou les tables), à choisir dans la liste des éléments disponibles dans QGIS. Pour sélectionner un élément, cliquez sur le petit bouton situé à sa gauche  pour faire apparaître une fenêtre comme celle-ci.
\phantomsection\label{docs/user_manual/sextante/toolbox:figure-multiple-selection}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{multiple_selection.png}
\caption{Multiple Selection \includegraphics[width=1em]{win.png}}\end{figure}

\item {} 
Une petite table, à éditer par l'utilisateur, pour définir certains paramètres tels que tables de recherche ou le produit de convolution.

Cliquez sur le bouton sur le côté droit pour voir la table et éditer ses valeurs.
\phantomsection\label{docs/user_manual/sextante/toolbox:figure-fixed-table}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{fixed_table.png}
\caption{Fixed Table \includegraphics[width=1em]{win.png}}\end{figure}

Selon l'algorithme, les lignes sont modifiables ou non, selon les boutons situés à droite de la fenêtre.

\end{itemize}

Un bouton \textbf{{[}Aide{]}} est situé au bas de la fenêtre des paramètres. Si le fichier d'aide est disponible, il sera affiché, vous donnant plus d'informations sur l'algorithme et la description détaillée de chaque paramètre. Malheureusement, la plupart des algorithmes ne présentent pas de documentation, mais c'est un bon point de départsi vous souhaitez contribuer au projet.


\subsubsection{A propos des projections}
\label{docs/user_manual/sextante/toolbox:a-note-on-projections}
SEXTANTE - ainsi que la plupart des applications tierces utilisables à partir de SEXTANTE - n'effectue pas de reprojection des couches en entrée et suppose que toutes les données sont déjà dans un système de coordonnées identique pour être analysées. Si plusieurs couches, aussi bien raster que vecteurs, sont utilisées par un algorithme, c'est à vous de vérifier qu'ils sont dans le même système de coordonnées.

Il faut faire attention notamment à la `reprojection à la volée' qui peut montrer que deux couches de systèmes de coordonnées différents semblent se chevaucher et dont le traitement sera infructueux. Il vous faudra les reprojeter manuellement avant de pouvoir les traiter par SEXTANTE. Cette reprojection peut également s'effectuer par les outils SEXTANTE.


\subsection{Les données générées par les algorithmes SEXTANTE}
\label{docs/user_manual/sextante/toolbox:data-objects-generated-by-sextante-algorithms}
Les données générées par SEXTANTE peuvent être des types suivants:
\begin{itemize}
\item {} 
Une couche raster

\item {} 
Unee couche vectorielle

\item {} 
Une table

\item {} 
Un fichier HTML (utilisé pour les sorties texte et graphiques)

\end{itemize}

Ils sont tous sauvegardés sur disque (et non en couches en mémoire), et la table des paramètres contient un champ texte correspondant à chaque résultat, où vous pouvez choisir un canal de sortie. Un chemin de sortie contient les informations nécessaires à la sauvegarde des objets résulats. Dans la plupart des cas, vous les sauvegarderez dans un fichier, mais l'architecture de SEXTANTE vous permet d'autres possibilités. Par exemple, une couche vectorielle peut être sauvegardée dans une base de données ou téléchargée vers un serveur distant fournissant un service WFS-T. Bien que de telles fonctionnalités de soient pas toutes implémentées, SEXTANTE pourra les gérer et nous espérons pouvoir ajouter d'autres canaux de sortie dans un futur proche.

Pour choisir un canal de sortie, cliquez simplement sur le bouton à droite du champ texte. Une fenêtre `Enregistrez sous' apparaîtra. Les extensions de fichier possibles seront indiquées dans le sélecteur de format de fichier, selon le type de résultat de l'algorithme.

Le format du fichier résultat dépend de l'extension de fichier ainsi que de l'algorithme. Pour choisir un format, sélectionnez l'extension adéquat (ou ajoutez-le si vous entrez directement le nom et chemin complet du fichier). Si l'extension entrée ne correspond pas à un format reconnu, l'extension et le format par défaut seront utilisés (habituellement \code{.dbf} pour les tables, \code{.tif} pour les rasters et \code{.shp} pour les vecteurs).

Si vous ne spécifiez pas de nom de fichier, le résultat sera sauvegardé dans un fichier temporaire, dans le format par défaut et qui sera supprimé en quittant QGIS (précaution à prendre si vous sauvegardez votre projet qui contiendrait des couches temporaires).

Vous pouvez définir une répertoire par défaut pour la sortie des données. Allez dans la fenêtre de configuration (par le menu \emph{SEXTANTE}) et dans le groupe \emph{Général}, vous trouverez un paramètre \emph{Dossier de sortie}. Il constituera le dossier par défaut si vous entrez un nom de fichier sans chemin (par exemple \code{monfichier.shp}) dans un algorithme.

En plus des fichiers raster et des tables, SEXTANTE peut générer des graphiques et du texte sou forme de fichiers HTML. Ces résultats figurent dans une nouvelle fenêtre apparaissant à la fin de l'exécution de l'algorithme. Cette fenêtre gardera les résultats de SEXTANTE pendant toute la session de travail et peut être affichée à tout moment en choisissant le menu \emph{SEXTANTE -\textgreater{} SEXTANTE results viewer}.

Certaines applications tierces peuvent créer des fichiers d'un type différent à ceux précédemment exposés. Ces fichiers résultats ne seront pas gérés par QGIS (ouverts ou intégrés dans le projet courant) dans la mesure où le format de fichier n'est pas reconnu par QGIS. C'est par exemple le cas de fichier LAS produits par LiDAR. Ces fichiers sont créés, mais vous ne verrez rien de plus dans la session de travail QGIS.

Pour les autres types de résultat, vous pourrez choisir de les charger ou non à l'issue de l'exécution de l'algorithme en cochant la case. Par défaut, tous les fichiers sont chargés.

SEXTANTE ne prend pas en charge de sorties optionnelles : tous les résultats sont créés, mais vous pouvez choisir de désactiver les sorties qui ne vous intéresse pas. (Ces fichiers seront créés dnas des fichiers temporaires qui seront supprimés en quittant QGIS)


\subsection{Configuration de SEXTANTE}
\label{docs/user_manual/sextante/toolbox:configuring-sextante}
Comme mentionné précédemment, le menu de configuration permet d'accéder à une nouvelle fenêtre dans laquelle vous pouvez paramétrer le fonctionnement de SEXTANTE. Les paramètres sont regroupés en blocs sélectionnables sur la partie gauche.

A côté de l'entrée \emph{Dossier de sortie} déjà exposée, le bloc \emph{Général} contient les paramètres pour le style de rendu par défaut des couches générées par les algorithmes SEXTANTE. Créez ces styles à l'aide de QGIS, sauvegardez-les dans un fichier que vous indiquerez dans la configuration de SEXTANTE. Une couche traitée par SEXTANTE présentera alors ce style dans le canevas de QGIS.

Le rendu des styles peut être configuré pour chaque algorithmr et pour chacunes de ses sorties. Cliquez avec le bouton droit sur le nom de l'algorithme dnas la boîte à outils et sélectionnez \emph{Editez les styles de rendu}. Une fenêtre comme celle-ci apparaitra.
\phantomsection\label{docs/user_manual/sextante/toolbox:figure-rendering-styles}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{rendering_styles.png}
\caption{Rendering Styles \includegraphics[width=1em]{win.png}}\end{figure}

Sélectionnez le fichier de style (\code{.qml}) que vous souhaitez appliquer à chaque résultat et appuyez sur \textbf{{[}OK{]}}.

Les autres paramètres de configuration dans le groupe \emph{Général} sont expliqués ci-dessous:
\begin{itemize}
\item {} 
\textbf{Utiliser le nom de fichier comme couche}. Le nom de chaque couche résultat créée par SEXTANTE contient le nom de l'algorithme utilisé. Dans certains cas, on peut fixer le nom à utiliser, quelques soit les couches utilisées en entrée. Dans d'autres cas, le nom devra dépendre de la couche utilisée en entrée, ou d'un paramètre de l'algorithme. Si cette case est cochée, le nom sera celui du fichier de sortie. Il faut noter que si la sortie est un fichier temporaire, le nom est intentionnellement long et illisible pour éviter des conflit avec des fichiers déjà existants.

\item {} 
\textbf{Utiliser seulement les entités sélectionnées}. Si cette option est choisie, pour une couche vectorielle, seuls les entités sélectionnées seront utilisées par l'algorithme. Si aucun objet n'est sélectionné alors toute la couche sera traitée.

\end{itemize}

Vous trouverez également un bloc \emph{Général} pour chaque fournisseur d'algorithmes. Il contient une rubrique \emph{Activé} pour le faire apparaître dans la boîte à outils. De plus, certains founisseurs ont leurs propres options de configuration. Cela sera détaillé dans la description de chaque founisseur.


\section{Le modeleur graphique SEXTANTE}
\label{docs/user_manual/sextante/modeler:the-sextante-graphical-modeler}\label{docs/user_manual/sextante/modeler::doc}

\subsection{Introduction}
\label{docs/user_manual/sextante/modeler:introduction}
Le \emph{modeleur graphique} permet de créer des modèles complexes en utilisant une interface simple et facile à utiliser. Dans un SIG, la plupart des opérations d'analyses ne sont pas simples mais font parties d'une chaîne d'opérations. En utilisant le modeleur graphique, cette chaîne de traitements peut être regroupée dans une tâche, qui est plus simple à exécuter et peut être réutilisée sur d'autres jeux de données. Peu importe le nombre d'étapes et d'algorithmes impliqués, un modèle est exécuté comme un seul algrithme, permettant ainsi d'économiser temps et effort, notamment sur de plus grands modèles.

Le modeleur peut être ouvert à partir du menu \emph{SEXTANTE}, mais également à partir de la boîte à outils. Dans la rubrique \emph{Modeleur} de l'arborescence des algorithmes se trouve un groupe \emph{Outils} qui contient une entrée \emph{Créer un nouveau modèle}.

Le modeleur possède un espace de travail où sont représentés la structure du modèle et le flux de traitement. Sur la partie gauche se trouve un panneau avec deux onglets pour ajouter de nouveaux éléments au modèle.
\phantomsection\label{docs/user_manual/sextante/modeler:figure-modeler}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{modeler_canvas.png}
\caption{Modeler \includegraphics[width=1em]{win.png}}\end{figure}

Deux étapes sont nécessaires pour la création d'un modèle:
\begin{enumerate}
\item {} 
Définir les entrées nécessaires*. Ces entrées seront ajoutées à la fenêtre des paramètres, afin que l'utilisateur puisse y fixer les valeurs nécessaires à l'excéution du modèle. Le modèle en lui-même est un algorithme SEXTANTE. Ainsi la fenêtre des paramètres est générée automatiquement comme cela est le cas pour tous les algorithmes fournis avec SEXTANTE.

\item {} 
Définir le flux de traitements. A partir des données d'entrée du modèle, le flux de traitements est défini en ajoutant des algorithmes et en sélectionnant comment ces derniers utiliseront les données ou d'autres données générées par d'autres algorithmes déjà présents dans le modèle.

\end{enumerate}


\subsection{Définition des données d'entrée}
\label{docs/user_manual/sextante/modeler:definition-of-inputs}
La première étape pour créer un modèle est de définir les données d'entrées nécessaires. vous trouverez les éléments suivants dans l'onglet \emph{Entrées} dans la partie gauche de la fenêtre du modeleur:
\begin{itemize}
\item {} 
Couche raster

\item {} 
Couche vectorielle

\item {} 
Chaîne de caractères

\item {} 
Champ d'une table

\item {} 
Table

\item {} 
Valeur numérique

\item {} 
Valeur booléenne

\end{itemize}

Double cliquez sur ces éléments pour faire apparaître une fenêtre avec leurs détails. Selon le paramètre, cette fenêtre peut contenir une simple description (que l'utilisateur verra à l'exécution du modèle) ou d'autres informations. Par exemple, à l'ajout d'une valeur numérique, à la description devront être définies la valeur par défaut ainsi que la liste des valeurs valides. La figure suivante illustre cette fenêtre.
\phantomsection\label{docs/user_manual/sextante/modeler:figure-model-parameter}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{models_parameters.png}
\caption{Model Parameters \includegraphics[width=1em]{win.png}}\end{figure}

Pour chaque donnée d'entrée ajoutée, un nouvel élément apparaît dans l'espace de travail du modeleur.
\phantomsection\label{docs/user_manual/sextante/modeler:figure-model-parameter-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{models_parameters2.png}
\caption{Model Parameters \includegraphics[width=1em]{win.png}}\end{figure}


\subsection{Définition d'un flux de traitements}
\label{docs/user_manual/sextante/modeler:definition-of-the-workflow}
Une fois les données d'entrée définies, il faut à présent ajouter les algorithmes de traitement. Ces algorithmes se situent dans l'onglet \emph{Algorithmes}, regroupés par fournisseur comme dans la boîte à outils.
\phantomsection\label{docs/user_manual/sextante/modeler:figure-model-parameter-3}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{models_parameters3.png}
\caption{Model Parameters \includegraphics[width=1em]{win.png}}\end{figure}

Pour ajouter un algorithme, double cliquez sur son nom. Une boîte d'exécution apparaît, semblable à celle qui apparaît à partir de la boîte à outils SEXTANTE. L'illustration suivante montre celle correspondantà l'algorithme `Index de convergence' de SAGA, tout comme nous l'avons vu précédemment dans la boîte à outils SEXTANTE.
\phantomsection\label{docs/user_manual/sextante/modeler:figure-model-parameter-4}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{models_parameters4.png}
\caption{Model Parameters \includegraphics[width=1em]{win.png}}\end{figure}

Comme vous pouvez le voir, quelques différences existent entre les deux fenêtres. Ainsi, le nom de fichier en sortie de l'algorithme est remplacé par un simple champ de texte. Pour créer une couche temporaire en sortie, laissez le champ texte vide. Dans le cas contraire, la couche résultante sera un résultat final de l'algorithme et portera le nom défini dans le champ de texte. C'est ce nom que verra l'utilisateur du modèle à son exécution.

La sélection des valeurs de chaque paramètre s'effectue également différemment, en raison de la différence de contexte entre le modeleur et la boite à outils. Détaillons les valeurs pour chaque type de paramètre.
\begin{itemize}
\item {} 
Les couches raster et vectorielles et les tables. Ils sont à choisir dans une liste, non pas des couches ou tables déjà chargées dans QGIS, mais soit des entrées du modèle, soit des couches et/ou tables générées par les algorithmes déjà présents dans le modèle.

\item {} 
Les valeurs numériques. Les valeurs litérales peuvent être directement indiquées dans le champ correspondant. Mais ce dernier peut aussi être rempli à partir d'une donnée d'entrée du modèle. Dans ce cas, la valeur sera paramétrée par l'utilisateur à l'exécution du modèle.

\item {} 
Les chaînes de caractères. Comme pour les valeurs numériques, les chaînes peuvent être fixées une fois pour toute ou à l'exécution du modèle.

\item {} 
Un champ de table. Les champs d'une table ou d'une couche ne sont pas connus au moment de la conception du modèle, puisqu'ils seront définis à l'exécution du modèle. Pour remplir ce paramètre, entrez le nom du champ directement dans le champ texte correspondant, ou sélectionnez-le dans la liste des champs de table déjà présents dans le modèle. La validité du champ sélectionné sera vérifiée à l'exécution par SEXTANTE.

\end{itemize}

Une fois tous les paramètres remplis, validez avec le bouton \textbf{{[}OK{]}} et l'algorithme sera ajouté au canevas. Il sera lié aux autres éléments déjà présents, données d'entrée ou algorithmes fournissant des objets à utiliser comme entrée.
\phantomsection\label{docs/user_manual/sextante/modeler:figure-model-parameter-5}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{models_parameters5.png}
\caption{Model Parameters \includegraphics[width=1em]{win.png}}\end{figure}

Les éléments peuvent être disposés et rangés en les glissant dans l'espace de travail. Cela améliore la lecture et la compréhension du modèle. Les liens entre éléments sont mis à jour automatiquement.

Vous pouvez à tout moment exécuter votre algorithme en cliquant que le bouton \textbf{{[}Exécuter{]}}. Toutefois, pour pouvoir l'utiliser à partir de la boîte à outils, le modèle doit être sauvegardé et le modeleur fermé. La boîte à outils pourra alors mettre à jour les traitements disponibles.


\subsection{Sauvegarder et charger les modèles}
\label{docs/user_manual/sextante/modeler:saving-and-loading-models}
Utilisez le bouton \textbf{{[}Sauvegarder{]}} pour sauvegarder le modèle courant et le bouton \textbf{{[}Ouvrir{]}} pour restaurer un précédent modèle. Les modèles sont sauvegardés dans un fichier avec l'extension \code{.model}. Si le modèle a précédemment été sauvegardé à partir du modeleur, vous n'aurez pas à redonner de nom de fichier, ce nom étant déjà associé au modèle sera réutilisé.

Avant de sauvegarder un modèle, il faudra définir son nom et le groupe auquel il appartient. Pour cela, remplissez les deux champs texte situés sur la partie haute de la fenêtre.

Les modèles sauvegardés dans le répertoire \code{modèles} (le répertoire par défaut) apparaîtront dans la boîte à outils dans le groupe correspondant. Comme le modèle fait maintenant partie des algorithmes de SEXTANTE, il peut être utilisé comme tous les autres depuis la boite à outils ou depuis le modeleur.

Le répertoire par défaut des modèles peut être défini dans les configurations de SEXTANTE, dans le groupe \emph{Modeleur}.

Les modèles chargés le répertoire des modèles apparaîtront dans la boîte à outils mais également dans l'arborescence des \emph{Algorithmes} disponibles dans le modeleur. Vous pouvez ainsi intégrer votre modèle dans une traitement plus important, comme vous le feriez avec un autre algorithme.

Dans certains cas, SEXTANTE peut ne pas charger un modèle car un des algorithmes utilisés dans le flux de traitement est introuvable. Les algorithmes utilisés doivent donc être préalablement activés dans la boîte à outils. Veuillez vérifier que le fournisseur est bien disponible et activé dans la fenêtre de configuration de SEXTANTE. C'est une des premières pistes à vérifier en cas d'erreur de chargement ou d'exécution d'un modèle.


\subsection{Editer un modèle}
\label{docs/user_manual/sextante/modeler:editing-a-model}
Vous pouvez éditerle modèle sur lequel vous travaillez, en redéfinissant le flux de traitements et les relations entre algorithmes et données d'entrée.

Si vous cliquez avec le bouton droit sur un algorithme de l'espace de travail du modèle, le menu contextuel suivant apparaîtra:
\phantomsection\label{docs/user_manual/sextante/modeler:figure-model-right-click}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{modeler_right_click.png}
\caption{Modeler Right Click \includegraphics[width=1em]{win.png}}\end{figure}

Choisissez l'option \emph{Enlever} pour supprimer l'algorithme sélectionné. Un algorithme ne peut être enlevé que si aucun autre algorithme ne dépend de lui, c'est-à-dire si aucune de ses sorties n'est utilisée par ailleurs. Si vous tentez de supprimer un algorithme utilisé par ailleurs, SEXTANTE affichera le message d'avertissement suivant:
\phantomsection\label{docs/user_manual/sextante/modeler:figure-cannot-delete-alg}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=15em]{cannot_delete_alg.png}
\caption{Cannot Delete ALG \includegraphics[width=1em]{win.png}}\end{figure}

Choisissez l'option \emph{Editer} ou bouble-cliquez simplement sur l'élément pour afficher la fenêtre des paramètres de l'algorithme, pour changer les données en entrée et les paramètres. Tous les paramètres d'entrée ne seront pas systématiquement affichés. Les couches ou les valeurs générées en amont dans le flux de traitement ne seront ainsi pas disponibles, pour éviter les références circulaires.

Sélectionnez les nouvelles valeurs et validez avec le bouton \textbf{{[}OK{]}}. Les liens entre les éléments du modèle seront actualisés dans l'espace de travail du modeleur.


\subsection{Activer et désactiver les algorithmes}
\label{docs/user_manual/sextante/modeler:activating-and-deactivating-algorithms}
Les algorithmes peuvent être désactivés dans le modeleur, pour éviter leur exécution au lancement du modèle. Cela peut servir notamment à tester une partie du modèle ou lorsque toutes les sorties ne sont pas nécessaires.

Pour désactiver un algorithme, cliquez avec le bouton droit sur l'élement désiré et choisissez l'option \emph{Désactiver}. Une mention `Désactivé' sera indiquée en rouge sous le nom de l'algorithme , signe qu'il n'est pas actif.
\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=15em]{deactivated.png}
\caption{Deactivate \includegraphics[width=1em]{win.png}}\end{figure}

Tous ses algorithmes dépendants, directement ou indirectement, seront également désactivés, puisqu'ils ne pourront pas être exécutés.

Pour activer un algorithme, répétez l'opération en choisissant cette fois l'option \emph{Activer}.


\subsection{Editer l'aide et les métadonnées}
\label{docs/user_manual/sextante/modeler:editing-model-help-files-and-meta-information}
Vous pouvez documenter vos modèles dans SEXTANTE. Cliquez sur le bouton \textbf{{[}Editer l'aide du modèle{]}} et une fenêtre semblable à celle-ci apparaîtra.
\phantomsection\label{docs/user_manual/sextante/modeler:figure-help-edition}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{help_edition.png}
\caption{Help Edition \includegraphics[width=1em]{win.png}}\end{figure}

Sur la partie droite apparaîtra une simple page HTML, créée à partir de la description des paramètres d'entrées et des sorties de l'algorithme, ainsi que d'autres éléments tels que description générale du modèle ou l'auteur. 0 la première ouverture de l'éditeur d'aide, ces champs seront vides, mais vous pouvez les éditer à partir des éléments situés à gauche de la fenêtre. Sélectionnez un élément dans la partie supérieure et remplissez sa description dans la partie inférieure.

L'aide du modèle est sauvegardée dans le répertoire du modèle. La sauvegarde est automatique.


\subsection{A propos des algorithmes disponibles}
\label{docs/user_manual/sextante/modeler:about-available-algorithms}
Vous remarquerez que certains algorithmes présents dans la boîte à outils ne sont pas disponibles dans le modeleur. Pour pouvoir être utilisé dans un modèle, un algorithme doit présenter une syntaxe correcte pour pouvoir être lié aux autres traitements. Si cela n'est pas le cas, par exemple si le nombre de couche en sortie n'est pas connu à l'avance, alors il ne sera pas possible de l'utiliser au sein d'un modèle et n'apparaîtra donc pas dans la liste du modeleur.

De même, certains alogorithmes du modeleur ne sont pas disponibles dans la boîte à outils. Ils sont destinés à être utilisés dans un modèle et n'ont que peu d'intérêt en dehors de ce contexte. C'est par exemple le cas de la `Calculatrice' : c'est un simple calculateur arithmétique qui vous permet de modifier une valeur numérique (saisie âs l'utilisateur ou générée par un autre algorithme). Cet outil peut être utile dans un modèle, mais n'a que peu d'intérêt en dehors de ce contexte.


\subsection{Du Python en tant que modèle SEXTANTE}
\label{docs/user_manual/sextante/modeler:sextante-models-as-python-code}
\emph{Cette fonctionnalité est temporairement non disponible}

Dans l'arborescence du modeleur, vous trouverez une rubrique contenant des scripts Python réalisant les mêmes tâches que dans le modeleur. A partir de ce code, vous pouvez créer un script (cela sera expliquer plus loin dans le manuel) et le modifier pour y intéger des actions et méthodes non disponibles dnas le modeleur, comme des boucles ou des branchements conditionnels.

Cette fonctionnalité est également très utile pour l'apprentissage de SEXTANTE à partir de la console et pour créer des algorithmes à partir de Python. Les scripts peuvent servir de points de départ à la création de scripts SEXTANTE.

Cliquez sur le bouton situé sous le champ texte contenant le code Python pour créer directement une copie dans un nouveau script basé sur ce code.


\section{L'interface de traitement batch de SEXTANTE}
\label{docs/user_manual/sextante/batch::doc}\label{docs/user_manual/sextante/batch:the-sextante-batch-processing-interface}

\subsection{Introduction}
\label{docs/user_manual/sextante/batch:introduction}
Les algorithmes SEXTANTE (donc les modèles) peuvent être exécutés sous forme de processus batch. C'est à dire qu'ils peuvent être exécutés en utilisant non pas une entrée mais plusieurs entrées, exécutant les algorithmes autant de fois que nécessaire. Ceci est utile lors du traitement de gros volume de données, puisqu'il n'est pas nécessaire de lancer l'algorithme plusieurs fois à partir de la boîte à outils.

Pour exécuter un algorithme en traitement par lots, cliquez avec le bouton droit sur son nom dans la boîte à outis et sélectionnez l'option \emph{Exécution par lots} dans le menu contextuel qui apparaît.
\phantomsection\label{docs/user_manual/sextante/batch:figure-sextante-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{batch_processing_right_click.png}
\caption{Batch Processing Right Click \includegraphics[width=1em]{win.png}}\end{figure}


\subsection{La table des paramètres}
\label{docs/user_manual/sextante/batch:the-parameters-table}
L'exécution d'un traitement par lots est semblable à l'exécution simple d'un algorithme. Les valeurs des paramètres peuvent être définies, mais dans le cas présent, il est nécessaire de définir les valeurs pour chaque exécution de l'algorithme. Ces valeurs sont à donner dans la table suivante.
\phantomsection\label{docs/user_manual/sextante/batch:figure-sextante-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{batch_processing.png}
\caption{Batch Processing \includegraphics[width=1em]{win.png}}\end{figure}

Chaque ligne de la table correspond à une itération de l'algorithme et chaque cellule contient la valeur de chaque paramètre. Ce sont les mêmes paramètres que dans la boîte à outils, mais présentés différemment.

Par défaut, la table contient seulement deux lignes. Vous pouvez ajouter ou retirer des lignes en utilisant les boutons situés en bas de la fenêtre.

Une fois le nombre de lignes souhaitées atteint, vous pouvez remplir les paramètres avec les valeurs correspondantes.


\subsection{Remplir la table de paramètres}
\label{docs/user_manual/sextante/batch:filling-the-parameters-table}
Pour la plupart des paramètres, la valeur à fixer est triviale. Selon le type de paramètre, entrez simplement la valeur ou sélectionnez l'option adéquate dans la liste de choix.

La principale différence réside dans les couches et les tables en entrées et les fichiers de sortie des algorithmes. Les couches et tables en entrée d'un algorithme en mode batch sont lues directement à partir de fichiers et non à partir de couches déjà chargées dans QGIS. C'est pourquoi tout algorithme peut être exécuté en traitement par lots, même si aucun objet n'est ouvert, mais que le traitement par lot ne peut être exécuté depuis la boîte à outils.

Les noms de fichiers pour les données en entrée peuvent être directement entrés au clavier ou, pour simplifier, en cliquant sur le bouton situé à droite de la cellule, ouvrant un explorateur de fichiers. Plusieurs fichiers peuvent être sélectionnés simultanément. Si le paramètre d'entrée ne représente qu'une seule donnée et que plusieurs fichiers ont été sélectionnés, alors autant de lignes que nécessaires seront remplis. Si le paramètre représente une liste d'objets en entrée, alors les fichiers seront ajoutés dans une seule cellule, séparés par un point-virgule (\code{;}).

Les données en sortie sont toujours sauvegardées dans un fichier et, contrairement à son exécution à partir de la boîte à outils, la sauvegarde dans un fichier temporaire n'est pas permise. Vous pouvez entrer le nom directement ou utiliser l'explorateur de fichiers en cliquant sur le bouton adéquat.

Une fois le fichier choisi,, une nouvelle fenêtre apparaît permettant le remplissage automatique des autres cellules d'une même colonne (même paramètre).
\phantomsection\label{docs/user_manual/sextante/batch:figure-sextante-3}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{batch_processing_save.png}
\caption{Batch Processing Save}\end{figure}

Si la valeur par défaut (`Ne pas autocompléter') est choisie, SEXTANTE ne remplira que la cellule correspondant au nom de fichier. Dans le cas contraire, toutes les cellules sous la ligne sélectionnée seront remplies à partir de la valeur choisie. Ainsi, il est aisée de remplir la table de paramètres et le traitement par lots s'en trouve facilité.

Le remplissage automatique peut également effectué en concaténant un compteur au nom de fichier, ou en ajoutant un champ à un autre dans la même ligne. Cela peut être utile pour nommer un résultat en fonction de la donnée d'entrée.
\phantomsection\label{docs/user_manual/sextante/batch:figure-sextante-4}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{batch_processing_filepath.png}
\caption{Batch Processing File Path \includegraphics[width=1em]{win.png}}\end{figure}


\subsection{Exécuter le traitement par lots}
\label{docs/user_manual/sextante/batch:executing-the-batch-process}
Pour exécuter un traitement par lots une fois définies toutes les valeurs nécessaires, cliquez simplement sur le bouton \textbf{{[}OK{]}}. SEXTANTE affichera alors la progression du traitement dans la partie basse de la fenêtre.


\section{Utiliser SEXTANTE depuis la console}
\label{docs/user_manual/sextante/console:using-sextante-from-the-console}\label{docs/user_manual/sextante/console::doc}

\subsection{Introduction}
\label{docs/user_manual/sextante/console:introduction}
La console permet aux utilisateurs confirmés d'accroître leur productivité en réalisant des opérations complexes qui ne pourraient par être réalisées à partir de l'interface graphique de SEXTANTE. Les modèles impliquant plusieurs algorithmes peuvent être définis à partir de l'interface en lignes de commandes et des opérations additionnelles comme les boucles ou les branchements conditionnels permettent de créer des flux de traitements plus puissants et plus flexibles.

Il n'y a pas de console propre à SEXTANTE dans QGIS, mais toutes les commandes SEXTANTE sont disponibles à partir de la console Python de QGIS. Cela signifie que vous pouvez intégrer ces commandes dans vos développements et y relier les algorithmes SEXTANTE aux autres fonctionnalités de QGIS (voir l'API QGIS).

Le code exécuté à partir de la console Python, même utilsant des méthodes SEXTANTE, peut être converti en algorithme SEXTANTE pour être réutilisé dans la boîte à outils, le modeleur ou dans un autre flux de traitements, comme tout autre élément SEXTANTE. Ainsi certains algorithmes que vous pouvez trouver dans la boîte à outils, comme ceux du groupe \emph{mmqgis} sont en fait de simples scripts.

Dans ces chapitre, nous allons voir comme utiliser SEXTANTE à partir de la console Python de QGIS et également comment écrire vos propres algorithmes en Python.


\subsection{Appeler SEXTANTE depuis la console Python}
\label{docs/user_manual/sextante/console:calling-sextante-from-the-python-console}
La première chose à faire est d'importer les fonctions SEXTANTE à l'aide de l'instruction suivante:

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{g+gp}{\PYGZgt{}\PYGZgt{}\PYGZgt{} }\PYG{k+kn}{import} \PYG{n+nn}{sextante}
\end{Verbatim}

A présent, la seule instruction (intéressante) à faire est d'exécuter un algorithme SEXTANTE. Cela est effectué en utilisant la méthode \code{runalg()}, qui prend en premier paramètre le nom de l'algorithme à lancer, puis tous les paramètres nécessaire à son exécution. Vous devez donc connaître le nom de commande de l'algorithme, qui peut être différent de celui affiché dans la boîte à outils. Pour le trouver, tapez \code{alglist()} dans la console:

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{g+gp}{\PYGZgt{}\PYGZgt{}\PYGZgt{} }\PYG{n}{sextante}\PYG{o}{.}\PYG{n}{alglist}\PYG{p}{(}\PYG{p}{)}
\end{Verbatim}

Vous devriez avoir quelque chose qui ressemble à ceci.

\begin{Verbatim}[commandchars=\\\{\}]
Accumulated Cost (Anisotropic)----------------\textgreater{}saga:accumulatedcost(anisotropic)
Accumulated Cost (Isotropic)------------------\textgreater{}saga:accumulatedcost(isotropic)
Add Coordinates to points---------------------\textgreater{}saga:addcoordinatestopoints
Add Grid Values to Points---------------------\textgreater{}saga:addgridvaluestopoints
Add Grid Values to Shapes---------------------\textgreater{}saga:addgridvaluestoshapes
Add Polygon Attributes to Points--------------\textgreater{}saga:addpolygonattributestopoints
Aggregate-------------------------------------\textgreater{}saga:aggregate
Aggregate Point Observations------------------\textgreater{}saga:aggregatepointobservations
Aggregation Index-----------------------------\textgreater{}saga:aggregationindex
Analytical Hierarchy Process------------------\textgreater{}saga:analyticalhierarchyprocess
Analytical Hillshading------------------------\textgreater{}saga:analyticalhillshading
Average With Mask 1---------------------------\textgreater{}saga:averagewithmask1
Average With Mask 2---------------------------\textgreater{}saga:averagewithmask2
Average With Thereshold 1---------------------\textgreater{}saga:averagewiththereshold1
Average With Thereshold 2---------------------\textgreater{}saga:averagewiththereshold2
Average With Thereshold 3---------------------\textgreater{}saga:averagewiththereshold3
B-Spline Approximation------------------------\textgreater{}saga:b-splineapproximation
...
\end{Verbatim}

Il s'agit de la liste des algorithmes disponibles, par ordre alphabétique, accompagnés des noms de commande.

Vous pouvez également passer une chaine de caractères en paramètre de cette méthode. Au lieu de retourner lal iste complète des algorithmes, elle filtrera les résultats selon la chaîne fournies. Par exemple, si vous recherchez un algorithme premettant de calculer la pente d'un MNT, l'instruction \code{alglist("slope")} donnera le résultat suivant:

\begin{Verbatim}[commandchars=\\\{\}]
DTM Filter (slope-based)----------------------\textgreater{}saga:dtmfilter(slope-based)
Downslope Distance Gradient-------------------\textgreater{}saga:downslopedistancegradient
Relative Heights and Slope Positions----------\textgreater{}saga:relativeheightsandslopepositions
Slope Length----------------------------------\textgreater{}saga:slopelength
Slope, Aspect, Curvature----------------------\textgreater{}saga:slopeaspectcurvature
Upslope Area----------------------------------\textgreater{}saga:upslopearea
Vegetation Index[slope based]-----------------\textgreater{}saga:vegetationindex[slopebased]
\end{Verbatim}

Ce résultat peut différer d'un système à l'autre selon les algorithmes disponibles.

Il est ainsi facile de trouver l'algorithme recherché et son nom de commande, ici \code{saga:slopeaspectcurvature}.

Une fois trouvé le nom de commande de l'algorithme, il s'agit de connaître la bonne syntaxe pour l'exécuter. Cela comprend la liste et l'ordre des paramètres à fournir à l'appel de la méthode \code{runalg()}. SEXTANTE comprend une méthode destinée à décrire en détail un algorithme, qui renvoie la liste des paramètres nécessaires et le type de sorties générées : il s'agit de la méthode \code{alghelp(nom\_de\_l\_algorithme)}. Veuillez à bien utiliser le nom de commande et non le nom descriptif.

L'appel à la méthode avec le paramètre \code{saga:slopeaspectcurvature} donnera la description suivante.

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{g+gp}{\PYGZgt{}\PYGZgt{}\PYGZgt{} }\PYG{n}{sextante}\PYG{o}{.}\PYG{n}{alghelp}\PYG{p}{(}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{saga:slopeaspectcurvature}\PYG{l+s}{\PYGZdq{}}\PYG{p}{)}
\PYG{g+go}{ALGORITHM: Slope, Aspect, Curvature}
\PYG{g+go}{   ELEVATION \PYGZlt{}ParameterRaster\PYGZgt{}}
\PYG{g+go}{   METHOD \PYGZlt{}ParameterSelection\PYGZgt{}}
\PYG{g+go}{   SLOPE \PYGZlt{}OutputRaster\PYGZgt{}}
\PYG{g+go}{   ASPECT \PYGZlt{}OutputRaster\PYGZgt{}}
\PYG{g+go}{   CURV \PYGZlt{}OutputRaster\PYGZgt{}}
\PYG{g+go}{   HCURV \PYGZlt{}OutputRaster\PYGZgt{}}
\PYG{g+go}{   VCURV \PYGZlt{}OutputRaster\PYGZgt{}}
\end{Verbatim}

Vous avez à présent tout ce qu'il faut pour exécute n'importe quel algorithme. Comme indiqué précédemment, l'instruction \code{runalg()} suffit pour exécuter un algorithme. Sa syntaxe est la suivante:

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{g+gp}{\PYGZgt{}\PYGZgt{}\PYGZgt{} }\PYG{n}{sextante}\PYG{o}{.}\PYG{n}{runalg}\PYG{p}{\PYGZob{}}\PYG{n}{name\PYGZus{}of\PYGZus{}the\PYGZus{}algorithm}\PYG{p}{,} \PYG{n}{param1}\PYG{p}{,} \PYG{n}{param2}\PYG{p}{,} \PYG{o}{.}\PYG{o}{.}\PYG{o}{.}\PYG{p}{,} \PYG{n}{paramN}\PYG{p}{,}
\PYG{g+go}{         Output1, Output2, ..., OutputN)}
\end{Verbatim}

La liste des paramètres et des sorties à fournir dépend de l'algorithme à exécuter et correspond au résultat, dans l'ordre donné, de la méthode \code{alghelp()}.

Selon le type de paramètre, les valeurs peuvent être fournies selon plusieurs manières. Une rapide description de ces possibilités est donnée pour chaque type de paramètre d'entrée
\begin{itemize}
\item {} 
Les couches raster, vectorielles ou les tables. Indiquez simplement le nom identifiant la donnée (le nom dans la liste de couches de QGIS) ou un nom de fichier (si la couche n'a pas encore été ouverte, elle sera chargée mais pas ajoutée au canevas). Si vous avez une instance d'un objet QGIS représentant une couche, vous pouvez également la transmettre en paramètre. Si l'entrée est optionnelle et que vous ne souhaitez pas fournir de données particulières, utilisez la valeur \code{None}.

\item {} 
Sélection. Si un algorithme  possède un paramètre sélection, cette valeur doit être une valeur entière. Pour connaître les options possibles, vous pouvez utilisez la commande \code{algoptions}, comme dans l'exemple suivant :

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{g+gp}{\PYGZgt{}\PYGZgt{}\PYGZgt{} }\PYG{n}{sextante}\PYG{o}{.}\PYG{n}{algoptions}\PYG{p}{(}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{saga:slopeaspectcurvature}\PYG{l+s}{\PYGZdq{}}\PYG{p}{)}
\PYG{g+go}{METHOD(Method)}
\PYG{g+go}{    0 \PYGZhy{} [0] Maximum Slope (Travis et al. 1975)}
\PYG{g+go}{    1 \PYGZhy{} [1] Maximum Triangle Slope (Tarboton 1997)}
\PYG{g+go}{    2 \PYGZhy{} [2] Least Squares Fitted Plane (Horn 1981, Costa\PYGZhy{}Cabral \PYGZam{} Burgess 1996)}
\PYG{g+go}{    3 \PYGZhy{} [3] Fit 2.Degree Polynom (Bauer, Rohdenburg, Bork 1985)}
\PYG{g+go}{    4 \PYGZhy{} [4] Fit 2.Degree Polynom (Heerdegen \PYGZam{} Beran 1982)}
\PYG{g+go}{    5 \PYGZhy{} [5] Fit 2.Degree Polynom (Zevenbergen \PYGZam{} Thorne 1987)}
\PYG{g+go}{    6 \PYGZhy{} [6] Fit 3.Degree Polynom (Haralick 1983)}
\end{Verbatim}

Dans l'exemple, l'algorithme présente ces types de paramètres, avec 7 options. Notez que le premier élément a pour numéro 0.

\item {} 
Entrées multiples. La valeur est une chaîne de caractères, avec les entrées séparées par des points-virgules. Comme pour les couches simples et les tables, chaque élément d'entrée peut être le nom d'une variable objet ou un nom de fichier.

\item {} 
Champ de la table XXX. Insérez une chaîne de caractère contenant le nom du champ à utiliser. Ce paramètre est sensible à la casse.

\item {} 
Table fixée. Entrez la liste de toutes les valeurs, séparées par des virgules et entre quotes. Les valeurs commencent en haut à gauche et se lisent en ligne. Vous pouvez aussi utiliser un tableau à deux dimensions pour représenter la table.

\item {} 
SCR. Entrez le code EPSG du système de coordonnées désiré.

\item {} 
Étendue. Vous devez fournir une chaîne de caratères avec les valeurs \code{xmin}, \code{xmax}, \code{ymin} et \code{ymax} séparées par des virgules.

\end{itemize}

Booléen, fichier, chaîne de caractères et valeurs numériques ne nécessitent pas d'explications particulières.

Pour spécifier les valeurs par défaut des paramètres tels que chaînes de caractères, booléens ou valeurs numériques, entrez \code{None} dans l'entrée correspondante.

Pour les données en sortie, entrez le chemin à utiliser, comme dans la boîte à outils. Si vous préférez sauvegarder le résultat dans un fichier temporaire, indiquez \code{None}. L'extension du fichier déterminera le format de fichier utilisé. Si elle n'est pas reconnue par l'algorithme, le format de fichier par défaut sera utilisé et l'extension sera ajouté à la fin du nom de fichier.

Contrairement à la boîte à outils, les résultats d'un algorithme exécuté à partir de la console ne sont ajoutés au canevas de cartes. Pour les ajouter, il vous faudra le faire manuellement après l'exécution de l'algorithme. Vous pouvez utiliser pour cela les commandes de l'API QGIS ou plus simplement une des méthodes proposées par SEXTANTE.

La méthode \code{runalg()} renvoie une structure dictionnaire avec les clés (correspondant à la description des éléments de l'algorithme) et pour valeurs les chemins des résultats. Pour ajouter tous les résultats de l'algorithme au canevas, passez le dictionnaire renvoyé à la méthode \code{loadFromAlg()}. Vous pouvez également charger les couches individuellement en passant leur nom de fichier à la méthode \code{load()}.


\subsection{Créer des scripts et les exécuter depuis la boîte à outils}
\label{docs/user_manual/sextante/console:creating-scripts-and-running-them-from-the-toolbox}
Vous pouvez créer vos propres algorithmes codés en Python et ajouter quelques lignes d'information pour que SEXTANTE les reconnaisse. L'outil \emph{Créer un nouveau script} dans le group Outils de la boite à outils permet de vous y aider. Double-cliquez pour ouvrir un éditeur de script dans lequel mettre votre code. La sauvegarde du script s'effectuera dans le répertoire !file:\emph{scripts} (le répertoire par défaut à l'ouverture de la fenêtre) avec une extension \code{.py}, et correspondra automatiquement à votre algorithme.

Le nom de l'algorithme (celui qui apparaît dans la boîte à outils) est généré à partir du nom de fichier, en enlevant son extension et en remplaçant les underscores (`\_') par des espaces.

Voici par exemple le code permettante de calculer l'Indice d'Humidité Topographique (Topographic Wetness Index, TWI) directement à partir d'un MNT

\begin{Verbatim}[commandchars=\\\{\}]
\#\#dem=raster
\#\#twi=output
ret\_slope = sextante.runalg("saga:slopeaspectcurvature", dem, 0, None,
                None, None, None, None)
ret\_area = sextante.runalg("saga:catchmentarea(mass-fluxmethod)", dem,
                0, False, False, False, False, None, None, None, None, None)
sextante.runalg("saga:topographicwetnessindex(twi), ret\_slope['SLOPE'],
                ret\_area['AREA'], None, 1, 0, twi)
\end{Verbatim}

Comme vous pouvez le voir, il utilise 3 algorithmes, provenant de SAGA. Le dernier calcule le TWI, mais nécessite de une couche représentant la pente et une autre pour la permeéabilité des sols. Dans la mesure où ces dexu couches n'existent pas mais que nous disposons d'un MNT, nous allons les calculer en faisant appel aux algorithmes SAGA adéquats.

Le bout de code où le traitement est effectué n'est pas compliqué à comprendre si vous avez lu les sections précédentes. Cependant, les premières lignes nécessitent quelques explications. Elles fournissent à SEXTANTE les informations nécessaires pour convertir votre code en un algorithme utilisables à partir d'autres contextes, comme la boîte à outils ou le modeleur graphique.

Ces lignes débutent par deux sympboles de commentaire Python et présentent la structure suivante:

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{p}{[}\PYG{n}{parameter\PYGZus{}name}\PYG{p}{]}\PYG{o}{=}\PYG{p}{[}\PYG{n}{parameter\PYGZus{}type}\PYG{p}{]} \PYG{p}{[}\PYG{n}{optional\PYGZus{}values}\PYG{p}{]}
\end{Verbatim}

Voici la liste des types de paramètres que SEXTANTE reconnaît, leurs syntaxes ainsi que quelques exemples.
\begin{itemize}
\item {} 
\code{raster}. Une couche raster

\item {} 
\code{vector}. Une couche vectorielle

\item {} 
\code{table}. Une table

\item {} 
\code{number}. Une valeur numérique. Une valeur par défaut doit être définie. Par exemple, \code{depth=number 2.4}

\item {} 
\code{string}. Une chaîne de caractère. Comme pour les valeurs numériques, une valeur par défaut doit être définie. Par exemple, \code{name=string Victor}

\item {} 
\code{boolean}. Une valeur booléenne. Ajoutez \code{True} (Vrai) ou \code{False} (Faux) pour définir la valeur par défaut. Par exemple, \code{verbose=boolean True} pour plus un rendu plus parlant

\item {} 
\code{multiple raster}. Un ensemble de couches raster en entrée.

\item {} 
\code{multiple vector}. Un ensemble de couches vectorielles en entrée.

\item {} 
\code{field}. Un champ dans la table d'attributs d'une couche vectorielle. Le nom de la couche doit être ajoutée après l'étiquette \code{field}. Par exemple, si vous déclarez une couche vectorielle \code{macouche=vector} en entrée, vous pouvez utilisez \code{monchamp=champ1 macouche} pour ajouter en paramètre le champ de cette couche.

\item {} 
\code{folder}. Un répertoire

\item {} 
\code{file}. Un nom de fichier

\end{itemize}

Le nom du paramètre correspond à ce qui sera affiché lorsque l'utilisateur exécutera l'algorithme, ainsi qu'au nom de variable à utiliser dans le script. La valeur saisie par l'utilisateur pour ce paramètre sera assignée à cette variable, portant ce nom.

A l'affichage du nom de paramètre, SEXTANTE convertit les underscores (`\_') en espaces. Ainsi, par exemple, si vous souhaitez que l'utilisateur saisisse une valeur appelée `Valeur numérique', vous devez utiliser une variable nommée \code{Valeur\_numérique}.

Les variables Couches et Tables ont des chaînes de caractères contenant le chemin complet de l'objet correspondant. Pour les convertir en objet QGIS, utilisez la fonction \code{sextante.getObjectFromUri()}. Les entrées multiplessont également des chaînes de caractères, contenant les chemins des objets, séparés par des points-virgules.

Les sorties sont définies de la même manière, avec les étiquettes suivantes:
\begin{itemize}
\item {} 
\code{output raster}

\item {} 
\code{output vector}

\item {} 
\code{output table}

\item {} 
\code{output html}

\item {} 
\code{output file}

\item {} 
\code{output number}

\item {} 
\code{output string}

\end{itemize}

La valeur attribuée à une variable de sortie est toujours une chaîne de caractères contenant le chemin de l'objet. Si le nom est vide, un fichier temporaire sera créé.

Si un résultat est défini, SEXTANTE tentera de l'ajouter à QGIS à l'issue de l'exécution de l'algorithme. C'est la raison pour laquelle la couche résultat TWI, nommée explicitement par l'utilisateur, sera chargée, même si la méthode \code{runalg()} ne le fait pas.

N'utilisez donc pas la méthode \code{load()} dans vos scripts, mais uniquement à partir de la console. Si un algorithme définit une couche en sortie, celle-ci doit être déclarée ainsi. Dans le cas contraire, vous ne pourriez pas l'utiliser dans le modeleur parce que sa syntaxe (comme définie par ses étiquettes, exposées précédemment) ne correspond âs à ce que l'algorithme crée effectivement.

Les sorties masquées (nombres ou chaînes) n'ont pas de valeur. C'est à vous de leur assigner une valeur. Pour cela, affecter une valeur à la variable pour la déclarer en sortie. Par exemple, vous pourriez utiliser la déclaration suivante,

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{c}{\PYGZsh{}\PYGZsh{}average=output number}
\end{Verbatim}

l'instruction suivante fixe la valeur de sortie à 5:

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{n}{average} \PYG{o}{=} \PYG{l+m+mi}{5}
\end{Verbatim}

En complément des étiquettes définissant les paramètres et les sorties, vous pouvez définir la catégorie dans laquelle l'algorithme apparaîtra, en utilisant l'étiquette \code{group}.

Il est conseillé d'informer l'utilisateur de l'avancée du traitement de l'algorithme. Vous disposez de la variable globale \code{progress}, aevc deux méthodes, \code{setText(text)} et \code{setPercentage(percent)} pour modifier le message et la barre de progression.

Plusieurs exemples sont fournis avec SEXTANTE. Veuillez vous y reporter pour servir d'exemples.. Cliquez avec le bouton droit sur un script et choisissez \code{Editer le script} pour voir et éditer le code correspondant.


\subsection{Documenter ses scripts}
\label{docs/user_manual/sextante/console:documenting-your-scripts}
Comme pour les modèles, vous pouvez ajouter des commentaires à votre script, pour expliciter le traitement effectué et son utilisation. Dans la fenêtre d'édition du script se situe un bouton \textbf{{[}Editer l'aide{]}}, qui vous amènera à la fenêtre d'édition de l'aide. Veuillez vous reporter au chapitre Modeleur graphique pour plus d'information sur cette fenêtre.

Les fichiers d'aide sont sauvegardés dans le même répertoire que les scripts, avec l'extention \code{.help}.Veuillez noter qu'à la première édition de l'aide, la fermeture de la fenêtre ne sauvegarde pas vos modifications. Par contre, si le fichier a déjà été sauvegardé une fois préalablement, les modifications seront conservées.


\section{Le gestionnaire d'historiques SEXTANTE}
\label{docs/user_manual/sextante/history::doc}\label{docs/user_manual/sextante/history:the-sextante-history-manager}

\subsection{L'historique SEXTANTE}
\label{docs/user_manual/sextante/history:the-sextante-history}
A chaque exécution d'un algorithme SEXTANTE, les informations du traitement (paramètres utilisés, date et heure d'exécution) sont sauvegardées dans le gestionnaire d'historiques SEXTANTE.

Ainsi, il est possible de suivre et vérifier les tâches effectuées avec SEXTANTE et de les reproduire.

Le gestionnaire d'historiques SEXTANTE est un ensemble d'entrées de registre, regroupées selon la date d'exécution, permettant de retrouver facilement quel algorithme a été exécuté à un moment donné.
\phantomsection\label{docs/user_manual/sextante/history:figure-history-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{history.png}
\caption{History \includegraphics[width=1em]{win.png}}\end{figure}

Les informations de traitement sont sauvegardées sous forme de ligne de commande, même si l'algorithme a été exécuté depuis la boîte à outils. Cela permet également de comprendre l'interface en ligne de commande en visualisant la commande effectivement lancée depuis la boîte à outils.

Pour réexécuter une commande présente dans l'historique, double-cliquez sur l'entrée correspondante.

SEXTANTE affiche des informations pendant l'exécution d'un algorithme : \emph{Erreurs}, \emph{Warnings} et \emph{Information}. Si une erreur se produit, vous pourrez informer l'auteur de SEXTANTE en lui fournissant les informations indiquées dans la rubrique \emph{Erreurs}, cela lui permettra de cooriger le bug.

L'exécution d'une application tierce s'effectue par appel de l'interface en lignes de commandes qui interagit habituellement avec l'utilisateur dans une console. Bien que cette dernière ne soit pas affichée, une copie complète des commandes est gardée dans le groupe \emph{Information} à chaque exécution. Si par exemple vous rencontrez un problème à l'exécution d'un algorithme SAGA, recherchez une entrée `SAGA execution console output' pour visualiser les messages générés par SAGA et trouver l'erreur.

Certains algorithmes générent des message d'avertissements ou des commentaires dans le groupe \emph{Warning}, même si le traitement semble avoir réussi. Vérifiez ces messages si les résultats ne semblent pas cohérents.


\section{Configuration des applications tierces}
\label{docs/user_manual/sextante/3rdParty:configuring-external-applications}\label{docs/user_manual/sextante/3rdParty::doc}

\subsection{Introduction}
\label{docs/user_manual/sextante/3rdParty:introduction}
SEXTANTE peut être étendue par des applications tierces, qui sont exécutées directement depuis SEXTANTE. Pour l'instant, les logiciels SAGA, GRASS, OTB (Orfeo Toolbox) et R sont supportés, ainsi que des applications en ligne de commande qui proposent des fonctionnalités d'analyses spatiales. Les algorithmes reposant sur des applications tierces sont gérées par leur propres fournisseurs d'algorithme.

Ce chapitre vous montrera comment configurer SEXTANTE pour inclure ces applications additionnelles et vous expliquera quelques fonctionnalités particulières basées sur ces applications. Une fois le système configuré, vous pourrez exécuter les algorithmes externes depuis tout composant SEXTANTE tel que la boîte à outils ou le modeleur graphique, comme vous pourriez le faire depuis un géoalgorithme SEXTANTE préexistant.

Par défaut, tous les algorithmes qui reposent sur une application tierce non fournie avec QGIS sont désactivés. Vous pouvez les activer dans le fenêtre de configuration de SEXTANTE. Veuillez vérifier que l'application correspondante est préalablement installée sur votre ordinateur. Activer un fournisseur d'algorithmes non installé résultera en une erreur à l'exécution, bien que les algorithmes soient présent dans la boîte à outils.

La raison est que les descriptions des algorithmes (nécessaires pour créer la fenêtre de paramètres et donner à SEXTANTE les informations sur l'algorithme) ne sont pas fournis avec les applications mais sont inclus dans SEXTANTE. SEXTANTE les inclut d'office, mêm si vous ne les avez pas installé. Exécuter un algorithme nécessite évidemment que l'application tierce soit installée au préalable.


\subsubsection{A propos des formats de fichiers}
\label{docs/user_manual/sextante/3rdParty:a-note-on-file-formats}
Le fait d'ouvrir un fichier dans QGIS ne garantit pas que ce fichier pourra être ouvert et traité par l'application tierce. Dans la plupart des cas, celui-ci pourra lire ce que vous avez ouvert dans QGIS, mais parfois, cela ne sera pas le cas. C'est particulièrement le cas des connections aux bases de données et les fichiers peu communs, aussi bien raster que vectoriels, qui pourront présenter des problèmes. Si cela arrivait, essayez de convertir vos données dans un format usuel reconnu par l'application tierce et vérifiez dans la console (historique et messages) le résultat du traitement pour analyser l'origine des erreurs.

Par exemple, l'utilisation d'une couche raster GRASS en entrée d'un algorithme SEXTANTE présente souvent des erreurs. C'est pourquoi ces couches ne seront pas disponibles (nous travaillons activement pour résoudre ce défaut et espérons y rémedier rapidement).

Pour les couches vectorielles, vous ne devriez pas rencontrer de problème : SEXTANTE les convertit automatiquement dans un format reconnu par l'application tierce avant de lui transmettre. Cela aboutit à un temps de traitement plus long, particulièrement si la couche comprend beaucoup d'objets. Ne vous étonnez donc pas si le traitement d'un couche prevenant d'un base de données est plus long que celui d'un shapefile de taille équivalente.

Les fournisseurs non basés sur des applications tierces peuvent traiter toute couche ouvrable par QGIS, dans la mesure où le traitement s'effectue par QGIS.

Concernant les formats de sortie, les fichiers raster sont sauvegardés au format TIFF (\code{.tif}) et les fichiers vectoriels en shapefile (\code{.shp}). Ces deux formats ont été choisis car universellement reconnus par les applications tierces et QGIS. Si vous n'avez pas sélectionner un nom de fichier se terminant par ces extensions, SEXTANTE le modifiera automatiquement et le format par défaut sera utilisé.

Dans le cas de GDAL, le nombre de formats reconnus est plus important.Dans la fenêtre de sélection de fichier, vous pourrez choisir le format et son extension. Pour plus d'information sur les formats reconnus, veuillez vous reporter à la documentation GDAL.


\subsubsection{A propos de la sélection des couches vectorielles}
\label{docs/user_manual/sextante/3rdParty:a-note-on-vector-layer-selections}
Par défaut, quand une application tierce utilise une couche vectorielle, elle utilisera tous ses objets, même si une partie d'entre eux ont été sélectionnés dans QGIS. Cochez \emph{Utiliser les éléments sectionnés} dans le group \emph{Général} pour restreindre le traitement aux éléments séelectionnés. Les éléments sélectionnés seront alors copiés dans une nouvelle couche vectorielle avant d'être traités par l'algorithme.

Veuillez noter qu'avec cette option sélectionnée, une couche sans objet sélectionné sera entièrement traitée, comme si tous ces objets avaient été sélectionnés et non comme une couche vide.


\subsection{SAGA}
\label{docs/user_manual/sextante/3rdParty:saga}
Les algorithmes SAGA peuvent être exécutés depuis SEXTANTE si SAGA est installé sur votre système et que SEXTANTE est correctement configuré pour y faire appel. En particulier, l'exécutable en ligne de commande de SAGA doit être accessible. Les fichiers de SAGA ne sont pas fournis avec SEXTANTE. Il vous faudra donc le télécharger et l'installer indépendamment de SEXTANTE et QGIS. Veuillez vous reporter au site web de SAGA pour plus d'information. Seule une version supérieure ou égal à SAGA 2.0.8 est supportée.

Une fois SAGA installé, sous Windows, ouvrez la fenêtre de configuration de SEXTANTE. Dans la rubrique \emph{SAGA}, renseignez l'entrée \emph{répertoire SAGA}. Entrez le chemin d'installation de SAGA. Refermez la fenêtre et les les algorithmes SAGA sont à présent disponibles dans SEXTANTE.

Si votre système est de type Linux, il n'est pas nécessaire de configurer tout ceci. Vérifiez que SAGA est correctement installé et que le chemin d'installation figure dans la variable d'environnement PATH. Pour vérifier que les fichiers binaires de SAGA sont accessibles, ouvrez une console et tapez \code{saga\_cmd}.


\subsubsection{A propos des limitations du système de grille de SAGA}
\label{docs/user_manual/sextante/3rdParty:about-saga-grid-system-limitations}
La plupart des algorithmes SAGA nécessitent habituellement des couches Raster en entrée sur la même emprise et la même grille, couvrant la même emprise et auyant la même résolution. A l'appel d'un algorithme SAGA depuis SEXTANTE, vous pouvezcependant  utilisez n'importe quelle couche, quelques soient leur emprise et résolution. Quand plusieurs couches raster son indiquées en entré d'un algorithme SAGA, SEXTANTE les rééchantillonne sur une grille commune avant de les transmettre à SAGA (à moins que l'algorithme SAGA manipule directement des couches dans des grilles différentes).

La définition d'une grille commune est contrôlée par l'utilisateur et peut se faire selon plusieurs paramètres, présents dans le groupe SAGA de la fenêtre de configuration. Deux façons de procéder existent:
\begin{itemize}
\item {} 
La configuration manuelle. Vous définissez les valeurs de l'emprise:
\begin{itemize}
\item {} 
Rééchantillonner la valeur minimum de X

\item {} 
Rééchantillonner la valeur maximum de X

\item {} 
Rééchantillonner la valeur minimum de Y

\item {} 
Rééchantillonner la valeur maximum de Y

\item {} 
Rééchantillonner la taille de la cellule

\end{itemize}

Veuillez noter que SEXTANTE rééchantillonnera les couches en entrées sur cette emprise, même si elles ne la recoupent pas.

\item {} 
La configuration automatique à partir des couches en entrée. Pour choisir cette option, activez l'option \emph{Utiliser la grille minimal pour le rééchantillonnage}. Toutes les autres options seront ignorées et l'emprise minimum pour couvrir les couhces sera utilisée. La taille de la cellule de la couche cible sera la plus grande des tailles de cellules des couches en entrée.

\end{itemize}

Pour les algorithmes qui n'utilisent pas plusieurs couches raster, ou pour ceux qui n'ont pas besoin d'une grille unique, le rééchantillonnage n'est pas nécessaire et ces paramètres ne seront pas utilisés.


\subsubsection{Limitations pour les couches multi-bandes}
\label{docs/user_manual/sextante/3rdParty:limitations-for-multi-band-layers}
Contrairement à QGIS, SAGA ne supporte pas les couches multi-bandes de couleur. Si vous souhaitez utiliser ce type de couches, tels que les fichiers RGB ou les images multispectrales), vous devez au préalable les séparer en images monocanaux. Pour cela, utilisez l'algorithme `SAGA/Grille - Outils/Séparer les canaux RGB' qui créera 3 images à partir d'une image RGB, ou `SAGA/Grille - Outils/Extraire une bande' pour n'en garder qu'une seule.


\subsubsection{Limitations dans la résolution}
\label{docs/user_manual/sextante/3rdParty:limitations-in-cellsize}
SAGA suppose que la couche raster possède la même résolution en X et en Y. Si vous travaillez sur une couche avec des résolutions différentes entre les deux axes, les résultats peuvent être incohérents. Dans ce cas, un message d'avertissement est ajouté au journal, indiquant que la couche n'est pas adaptée au traitement SAGA.


\subsubsection{Suivi du journal}
\label{docs/user_manual/sextante/3rdParty:logging}
SEXTANTE appelle SAGA par son interface en lignes de commandes, pour effectuer l'opération demandée. SAGA transmet son état d'avancement dans la console ainsi que d'autres informations. Ces messages sont filtrés par SEXTANTE pour afficher la barre d'avancement pendant l'exécution de l'algorithme.

Les commandes envoyées par SEXTANTE ainsi que les informations renvoyées par SAGA sont gardées dans le journal comme les autres informations de SEXTANTE et vous pourrez les consulter pour vérifier le bon déroulement de l'exécution d'un algorithme SAGA dans SEXTANTE. Vous trouverez deux options de configuration pour effectuer ce suivi : \emph{Journal des sorties} et \emph{Journal des commandes}.

La plupart des autres fournisseurs tiers qui sont appelés par la ligne de commandes ont des options similaires, que vous trouverez dans la rubrique configuration de SEXTANTE.


\subsection{R et les scripts R}
\label{docs/user_manual/sextante/3rdParty:r-and-r-scripts}
L'intégration de R dans SEXTANTE est légèrement différente de celle de SAGA, dans la mesure où il n'y a pas d'ensemble prédéfini d'algorithmes à exécuter, hormis quelques exemples. Au lieu de cela, c'est à vous d'écrire les scripts à transmettre à R, comme vous le feriez depuis R. Un peu comme dans le cahpitre sur les scripts SEXTANTE. Ce chapitre va vous montrer comment appeler les commandes R à partir de SEXTANTE et comme leur transmettre les objets SEXTANTE (couches et tables).

La première chose à faire, comme nous l'avons vu pour SAGA, est de dire à SEXTANTE où se situent les fichiers exécutables de R. Paramétrez l'entrée :guilabel::\emph{Répertoire R} dans la fenêtre de configuration de SEXTANTE. Une fois cela fait, vous pouvez commencer à créer vos scripts R et à les exécuter.

Une fois encore, pour Linux, cela est légèrement différent : vous n'avez qu'à vérifier que le répertoire R est inclus dans la variable d'environnement PATH. Si vous pouvez lancer R en tapant \code{R} dans un terminal, alors vous êtes prêt pour la suite.

Pour ajouter un nouvel algorithme qui appelle une fonction R (ou un script R plus complexe que vous auriez développé et que vous souhaiteriez utiliser dans SEXTANTE), vous devez créer un fichier de script qui va indiquer à SEXTANTE comme effectuer l'opération et les commandes R correspondantes.

Les fichiers de scripts ont une extension de fichier \code{.rsx} et leur création est relativement simple si vous connaissez la syntaxe et le langage de script de R. Ils seront sauvegardés dans le répertoire de scripts de R. Vous pouvez configurer ce repertoire dans le groupe de configuration de R, dans la fenêtre de configuration de SEXTANTE, comme vous le feriez  pour un script ordinaire de SEXTANTE.

Voyons un simple script, qui appelle la méthode \code{spsample} de R, pour créer une grille aléatoire à l'intérieur de l'emprise d'un ensemble de polygones d'une couche donnée. Cette fonction appartient au paquet \code{maptools}. Comme la plupart des algorithmes que vous aurez à intégrer dans SEXTANTE utilisent ou génèrent ds données spatiales, la connaissance des paquets spatiaux comme \code{maptools} et \code{sp} est obligatoire.

\begin{Verbatim}[commandchars=\\\{\}]
\#\#polyg=vector
\#\#numpoints=number 10
\#\#output=output vector
\#\#sp=group
pts=spsample(polyg,numpoints,type="random")
output=SpatialPointsDataFrame(pts, as.data.frame(pts))
\end{Verbatim}

Les premières lignes, qui commencent par un double signe de commentaire Python (\#\#{]} indiquera à SEXTANTE les données d'entrée et les sorties générées par l'algorithme. Ces lignes ont le même rôle que pour les scripts SEXTANTE que nous avons vu précédemment. Nous n'allons donc pas les décrire, veuillez vous reporter à la section correspondante.

Quand vous déclarez un paramètre d'entrée, SEXTANTE utilise cette information pour deux choses : créer le formulaire pour demander à l'utilisateur la valeur de ce paramètre et créer la variable R correspondante qui sera ensuite utilisée dans les commandes R.

Dans l'exemple ci-dessus, nous avons déclaré une entrée de type \code{vecteur} appelée \code{polyg}. A l'exécution de l'algorithme, SEXTANTE ouvrira la couche sélectionnée par l'utilisateur dans R et la stockera dans une variable nommée \code{polyg}. Ainsi le nom du paramètre est également le nom de la variable à utiliser dans R pour accéder à son contenu (par conséquent, veuillez ne pas utiliser de mots réservés R comme noms de paramètre).

Les éléments spatiaux, comme les couches vectorielles et raster sont lus en appelant respectivement les méthodes \code{readOGR()} et \code{readGDAL} (vous n'avez pas besoin des les ajouter à votre description de fichier, SEXTANTE s'en occupe pour vous) et seront sauvegardés sous forme de \code{Dataframe spatiaux}. Les champs des tables sont sauvegardés comme des chaînes de caractères contenant le nom des champs sélectionnés.

Les tables sont chargées par la commande \code{read.csv()}. Si la table à charger n'est pas au format CSV, il faudra la convertir avant de l'importer dans R.

Sachant cela, il est facile de comprendre la première ligne (hors commentaire) de notre exemple de script.

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{n}{pts}\PYG{o}{=}\PYG{n}{spsample}\PYG{p}{(}\PYG{n}{polyg}\PYG{p}{,}\PYG{n}{numpoints}\PYG{p}{,}\PYG{n+nb}{type}\PYG{o}{=}\PYG{l+s}{\PYGZdq{}}\PYG{l+s}{random}\PYG{l+s}{\PYGZdq{}}\PYG{p}{)}
\end{Verbatim}

La variable \code{polygon} contient déjà un objet \code{SpatialPolygonsDataFrame}, l'appel de la méthode \code{spsample} est donc simple. Il en est de même pour la méthode \code{numpoints} qui renvoit le nombre de points à ajouter pour créer la grille.

Comme nous avons déclaré une sortie de type \code{vecteur} nommée \code{out}, nous devons créer cette variable \code{out} et lui affecter un objet \code{Spatial*DataFrame} (dans notre cas, un \code{SpatialPointsDataFrame}). Vous pouvez utiliser n'importe quel nom pour les variables intermédiaires. Assurez-vous simplement que la variable qui stocke la valeur finale correspond à la variable de sortie définie au début.

Dans notre exemple, le résultat de la méthode \code{spsample} doit être converti explicitement en objet \code{SpatialPointsDataFrame}, dans la mesure où c'est un objet de la classe \code{ppp} qui ne peut être retransmis à SEXTANTE.

Si votre algorithme ne renvoie pas de couche, mais un résultat texte dans la console, vous devez indiquer à SEXTANTE d'afficher la console à la fin de son exécution. Pour cela commencez les lignes qui doivent renvoyer les résultats par le signe \code{\textgreater{}}. Les sorties des autres lignes seront masquées. Par exemple, voici la description d'un algorithme quie réalise un test de normalisation sur un champ donné (ou une colonne) de la table d'attributs d'une couche vectorielle:

\begin{Verbatim}[commandchars=\\\{\}]
\#\#layer=vector
\#\#field=field layer
\#\#nortest=group
library(nortest)
\textgreater{}lillie.test(layer[[field]])
\end{Verbatim}

La sortie de la dernière ligne est affichée, mais la sortie de la première ne l'est pas (ni celles des commandes ajoutées automatiquement par SEXTANTE).

Si votre algorithme crée des graphiques (par la méthode \code{plot()}), ajoutez la ligne suivante:

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{c}{\PYGZsh{}\PYGZsh{}showplots}
\end{Verbatim}

Ceci va indiquer à SEXTANTE de rediriger toutes les sorties graphiques de R vers un fichier temporaire qui sera chargé une fois l'exécution de R terminée.

Les graphiques et les résultats dans la console seront affichés dans le gestionnaire de résultats de SEXTANTE.

Pour plus d'information, veuillez vous référer aux scripts fournis avec SEXTANTE. Tous sont relativement simples et pourront vous aider à construire vos propres scripts.


\subsection{GRASS}
\label{docs/user_manual/sextante/3rdParty:grass}
Configurer GRASS est similaire à celle de SAGA. Tout d'abord,pour Windows, indiquez le répertoire d'installation de GRASS, ainsi que l'emplacement de l'interpréteur de shell (habituellement le fichier \code{msys.exe} fourni avec GRASS).

Par défaut, SEXTANTE tente d'accéder à la version de GRASS fournies avec QGIS. Cela ne devrait pas poser de problème dans la plupart des cas, mais si vous rencontrez des soucis, essayez de le configurer manuellement. De plus, si vous utilisez une version différente de GRASS, il vous faudra peut-être changer la configuration et indiquer le répertoire de cette version. Pour un bon fonctionnement des algorithme, une version de GRASS supérieur ou égale à la 6.4 est nécessaire.

Sous Linux, assurez-vous simplement que GRASS est correctement installé et qu'il peut être lancé depuis un terminal.

Les algorithmes GRASS nécessitent la définition d'une région. Cette région peut être définie manuellement, en fournissant les valeurs, comme pour la configuration de SAGA, ou de manière automatique, correspondant à l'emprise minimale des données d'entrée à l'exécution de l'algorithme. Si vous préférez ce dernier réglage, cochez l'option \emph{Utiliser l'emprise minimale} dans les paramètres de configuration de GRASS.

GRASS inclut des fichiers d'aide pour chaque algorithme. Si vous remplissez le paramètre \emph{Répertoire d'aide GRASS}, SEXTANTE les affichera quand vous appuyerez sur le bouton \textbf{{[}Afficher l'aide{]}} depuis la fenêtre des paramètres de l'algorithme.

Le dernier paramètre à configurer est le jeu de cartes. Un jeu de carte est nécessaire pour exécuter GRASS et SEXTANTE crée un jeu temporaire à chaque exécution. Vous devez indiquer à SEXTANTE si le système de coordonnées est géographique (lat/lon) ou planes.


\subsection{GDAL}
\label{docs/user_manual/sextante/3rdParty:gdal}
Les algorithmes GDAL ne nécessitent pas de configuration particulière, dans la mesure où ils sont déjà intégrés dans QGIS. SEXTANTE y récupère donc leurs configurations.


\subsection{La boîte à outils Orfeo (OTB)}
\label{docs/user_manual/sextante/3rdParty:orfeo-toolbox}
Les algorithmes de la boîte à outils Orfeo (OTB) peuvent être exécutés depuis SEXTANTE si OTB est installé sur votre ordinateur et que SEXTANTE est configuré correctement pour trouver les fichiers nécessaires (outils en ligne de commande et librairies). OTB n'est pas fourni avec SEXTANTE, vous devrez donc le télécharger et l'installer au préalable. Veuillez vous reporter au site web OTB pour plus d'information.

Une fois OTB installé, démarrez QGIS, ouvrez la fenêtre de configuration de SEXTANTE et configurer le fournisseur OTB. Dnas le groupe \emph{Boîte à outils Orfeo (analyses d'image)}, vous retrouverez tous les réglages relatifs à OTB. Vérifiez que les algorithmes sont activés.

Ensuite configurez l'emplacement des exécutables et des librairies OTB:
\begin{itemize}
\item {} 
\includegraphics[width=1em]{nix.png} habituellement, le répertoire \emph{Applications OTB} pointe vers \code{/usr/lib/otb/applications} et celui des \emph{Outils en ligne OTB} est \code{/usr/bin}

\item {} 
\includegraphics[width=1em]{win.png} si vous avez utilisé l'installateur OSGeo4W pour installer le paquet \code{otb-bin}, entrez respectivement \code{C:\textbackslash{}OSGeo4W\textbackslash{}apps\textbackslash{}orfeotoolbox\textbackslash{}applications} et \code{C:\textbackslash{}OSGeo4W\textbackslash{}bin} pour les répertoires  \emph{OTB applications} et \emph{OTB command line tools}

\end{itemize}


\subsection{TauDEM}
\label{docs/user_manual/sextante/3rdParty:taudem}
Pour utiliser ce fournisseur, vous devez installer les outils TauDEM en lignes de commandes.


\subsubsection{Windows}
\label{docs/user_manual/sextante/3rdParty:windows}
Veuillez vous reporter au site de \href{http://hydrology.usu.edu/taudem/taudem5.0/downloads.html}{TauDEM} pour les instructions d'installation et fichiers exécutables pour les systèmes 32bits et 64bits.**IMPORTANT**, installez la version TauDEM 5.0.6, la version 5.2 et au -dela n'étant pas pour l'instant supportée.


\subsubsection{Linux}
\label{docs/user_manual/sextante/3rdParty:linux}
La plupart des distributions Linux n'ont pas de paquets précompilés. Il vous faudra donc compiler vous-même TauDEM. TauDEM utilise MPICH2, qu'il faudra donc installer avec votre gestionnaire de paquets. TauDEM fonctionne également avec OpenMPI, que vous pouvez installer à la place de MPICH2.

Téléchargez le code source de TauDEM 5.0.6 à l'adresse suivante \href{http://hydrology.usu.edu/taudem/taudem5.0/TauDEM5PCsrc\_506.zip}{http://hydrology.usu.edu/taudem/taudem5.0/TauDEM5PCsrc\_506.zip} et décompressez les fichiers dans un répertoire.

Ouvrez le fichier \code{lienarpart.h} et après la ligne

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{c}{\PYGZsh{}include \PYGZdq{}mpi.h\PYGZdq{}}
\end{Verbatim}

ajoutez la ligne suivante

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{c}{\PYGZsh{}include \PYGZlt{}stdint.h\PYGZgt{}}
\end{Verbatim}

afin d'obtenir ceci

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{c}{\PYGZsh{}include \PYGZdq{}mpi.h\PYGZdq{}}
\PYG{c}{\PYGZsh{}include \PYGZlt{}stdlib.h\PYGZgt{}}
\end{Verbatim}

Sauvegardez les modifications et fermez le fichier. À présent, ouvrez le fichier \code{tiffIO.h}, trouvez la ligne \code{\#include "stdint.h"} dans laquelle vous remplacerez les quotes (\code{""}) par des  \code{\textless{}\textgreater{}}, pour obtenir ceci

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{c}{\PYGZsh{}include \PYGZlt{}stdint.h\PYGZgt{}}
\end{Verbatim}

Sauvegardez et fermez le fichier. Créez un répertoire de compilation et déplacez-vous dedans

\begin{Verbatim}[commandchars=\\\{\}]
mkdir build
cd build
\end{Verbatim}

Configurez votre compliation avec la commande

\begin{Verbatim}[commandchars=\\\{\}]
CXX=mpicxx cmake -DCMAKE\_INSTALL\_PREFIX=/usr/local ..
\end{Verbatim}

ensuite compilez

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{n}{make}
\end{Verbatim}

Enfin, pour installer TauDEM dans \code{/usr/local/bin}, exécutez

\begin{Verbatim}[commandchars=\\\{\}]
sudo make install
\end{Verbatim}

\index{Create\_Maps}
\index{Layout\_Maps}
\index{Compose\_Maps}

\chapter{Composeur de cartes}
\label{docs/user_manual/print_composer/print_composer:label-printcomposer}\label{docs/user_manual/print_composer/print_composer:print-composer}\label{docs/user_manual/print_composer/print_composer::doc}\label{docs/user_manual/print_composer/print_composer:index-2}
Le composeur de cartes fournit des fonctionnalités croissantes de mise en page et d'impression. Il vous permet d'ajouter des éléments tels qu'un cadre de carte, une légende, une échelle graphique, des images, des flèches et des étiquettes. Vous pouvez modifier la taille, grouper, aligner et positionner chaque élément et ajuster leurs propriétés pour créer votre mise en page. Le résultat peut être imprimé ou exporté dans plusieurs formats d'images, mais aussi en Postscript, PDF et SVG. L'export en SVG est géré, mais il ne fonctionne pas correctement avec certaines versions de QT4. Vous devriez essayer et vérifier individuellement sur votre système. Voir {\hyperref[docs/user_manual/print_composer/print_composer:table-composer-1]{table\_composer\_1}} pour la liste des outils:

\index{print\_composer!tools}\phantomsection\label{docs/user_manual/print_composer/print_composer:table-composer-1}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Bouton
} & \textsf{\relax 
Fonction
} & \textsf{\relax 
Bouton
} & \textsf{\relax 
Fonction
}\\
\hline &  &  & \\

\includegraphics[width=1.5em]{mActionFolder.png}
 & 
Charger depuis un modèle
 & 
\includegraphics[width=1.5em]{mActionFileSaveAs.png}
 & 
Enregistrer en tant que modèle
\\

\includegraphics[width=1.5em]{mActionSaveMapAsImage.png}
 & 
Exporter dans un format d'image
 & 
\includegraphics[width=1.5em]{mActionSaveAsPDF.png}
 & 
Exporter en PDF
\\

\includegraphics[width=1.5em]{mActionSaveAsSVG.png}
 & 
Exporter la composition en SVG
 & 
\includegraphics[width=1.5em]{mActionFilePrint.png}
 & 
Imprimer ou exporter en Postscript
\\

\includegraphics[width=1.5em]{mActionZoomFullExtent.png}
 & 
Zoom à l'étendue maximale
 & 
\includegraphics[width=1.5em]{mActionZoomIn.png}
 & 
Zoom +
\\

\includegraphics[width=1.5em]{mActionZoomOut.png}
 & 
Zoom -
 & 
\includegraphics[width=1.5em]{mActionDraw.png}
 & 
Rafraichir la vue
\\

\includegraphics[width=1.5em]{mActionUndo.png}
 & 
Annuler la dernière action
 & 
\includegraphics[width=1.5em]{mActionRedo.png}
 & 
Refaire la dernière action
\\

\includegraphics[width=1.5em]{mActionAddMap.png}
 & 
Ajouter une nouvelle carte à partir de la fenêtre principale de QGIS
 & 
\includegraphics[width=1.5em]{mActionAddImage.png}
 & 
Ajouter une image au composeur de cartes
\\

\includegraphics[width=1.5em]{mActionLabel.png}
 & 
Ajouter une étiquette au composeur de cartes
 & 
\includegraphics[width=1.5em]{mActionAddLegend.png}
 & 
Ajouter une nouvelle légende au composeur de cartes
\\

\includegraphics[width=1.5em]{mActionScaleBar.png}
 & 
Ajouter une nouvelle barre d'échelle graphique au composeur de cartes
 & 
\includegraphics[width=1.5em]{mActionAddBasicShape.png}
 & 
Ajouter une forme basique au composeur de cartes
\\

\includegraphics[width=1.5em]{mActionAddArrow.png}
 & 
Ajouter une flèche au composeur de cartes
 & 
\includegraphics[width=1.5em]{mActionOpenTable.png}
 & 
Ajouter une table d'attributs
\\

\includegraphics[width=1.5em]{mActionSelectPan.png}
 & 
Sélectionner/déplacer les objets dans le composeur de cartes
 & 
\includegraphics[width=1.5em]{mActionMoveItemContent.png}
 & 
Déplacer l'emprise de la carte
\\

\includegraphics[width=1.5em]{mActionGroupItems.png}
 & 
Grouper des objets du composeur de cartes
 & 
\includegraphics[width=1.5em]{mActionUngroupItems.png}
 & 
Dégrouper des objets du composeur de cartes
\\

\includegraphics[width=1.5em]{mActionRaiseItems.png}
 & 
Monter l'objet sélectionné
 & 
\includegraphics[width=1.5em]{mActionLowerItems.png}
 & 
Descendre l'objet sélectionné
\\

\includegraphics[width=1.5em]{mActionMoveItemsToTop.png}
 & 
Monter les objets sélectionnés au premier plan
 & 
\includegraphics[width=1.5em]{mActionMoveItemsToBottom.png}
 & 
Descendre les objets sélectionnés en arrière plan
\\

\includegraphics[width=1.5em]{mActionAlignLeft.png}
 & 
Aligner les objets sélectionnés à gauche
 & 
\includegraphics[width=1.5em]{mActionAlignRight.png}
 & 
Aligner les objets sélectionnés à droite
\\

\includegraphics[width=1.5em]{mActionAlignHCenter.png}
 & 
Aligner les objets sélectionnés au centre
 & 
\includegraphics[width=1.5em]{mActionAlignVCenter.png}
 & 
Aligner les objets sélectionnés au centre vertical
\\

\includegraphics[width=1.5em]{mActionAlignTop.png}
 & 
Aligner les objets sélectionnés en haut
 & 
\includegraphics[width=1.5em]{mActionAlignBottom.png}
 & 
Aligner les objets sélectionnés en bas
\\
\hline\end{tabulary}


Table Composeur de cartes 1 : Outils du Composeur de cartes

Tous les outils du composeur de cartes sont disponibles dans les menus et la barre d'outils. Cette barre peut être affichée ou masquée en faisant un clic droit sur elle.

\index{Composer\_Template}
\index{Map\_Template}

\section{Créer un nouveau composeur de cartes}
\label{docs/user_manual/print_composer/print_composer:index-5}\label{docs/user_manual/print_composer/print_composer:open-a-new-print-composer-template}
Avant de démarrer le travail avec le composeur de cartes, vous devez charger des couches raster et vecteurs dans la fenêtre principale de QGIS et adapter leurs propriétés pour qu'elles vous conviennent. Quand tout est rendu et symbolisé comme souhaité, cliquez sur l'icône  \includegraphics[width=1.5em]{mActionNewComposer.png} $^{\text{Nouveau composeur d'impression}}$ ou le menu  \emph{Fichier \(\rightarrow\) Nouveau composeur d'impression}.


\section{Utiliser le composeur de cartes}
\label{docs/user_manual/print_composer/print_composer:using-print-composer}
Ouvrir le composeur de cartes vous affiche un cadre vide dans lequel vous pouvez ajouter une vue de la carte actuelle de QGIS, une légende, une échelle graphique, des images, des formes basiques, des flèches et du texte. La figure {\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-1]{Figure\_composer\_1}} montre la vue initiale du composeur de cartes, avec l'option \includegraphics{checkbox.png} \emph{Accrochage à la grille} cochée avant qu'un élément ne soit ajouté.
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{print_composer_blank.png}
\caption{Print Composer \includegraphics[width=1em]{nix.png}}\end{figure}

Le composeur de cartes présente trois onglets:
\begin{itemize}
\item {} 
L'onglet \emph{Composition} vous permet de définir la taille du papier, l'orientation et la qualité d'impression pour le fichier de sortie (en dpi/ppp) et d'activer l'accrochage sur une grille d'une résolution prédéfinie. La fonction \includegraphics{checkbox.png} \emph{Accrochage à la grille} fonctionne uniquement si vous avez défini une résolution supérieure à 0. Vous pouvez activer la case \includegraphics{checkbox.png} \emph{Impression raster} qui permet de rastériser tous les éléments avant impression ou export en Postscript ou PDF.

\item {} 
L'onglet \emph{Propriétés de l'objet} affiche les propriétés pour l'élément de la carte sélectionnée. Cliquez sur l'icône \includegraphics[width=1.5em]{mActionSelectPan.png} $^{\text{Sélectionner/déplacer un objet}}$ pour sélectionner un élément (par exemple l'échelle graphique ou une étiquette) dans la feuille. Puis cliquez sur l'onglet \emph{Propriétés de l'objet} et personnalisez les paramètres de l'élément sélectionné.

\item {} 
L'onglet \emph{Historique des commandes} affiche un historique des dernières commandes effectuées au composeur de cartes. Avec un clic droit, il est possible de défaire et refaire des actions jusqu'à l'état choisi.

\end{itemize}

Vous pouvez ajouter de nombreux éléments au composeur. Il est également possible d'avoir plusieurs vues d'une carte, légendes ou échelles graphiques dans le canevas du composeur de cartes. Chaque élément possède ses propres propriétés et dans le cas de la carte, sa propre étendue. Si vous voulez supprimer un élément du canevas du composeur, vous pouvez le faire en utilisant les touches \code{Suppr.} ou \code{Retour arrière}.


\section{Ajouter la carte courante de QGis au composeur de cartes}
\label{docs/user_manual/print_composer/print_composer:adding-a-current-qgis-map-canvas-to-the-print-composer}
Pour ajouter la carte courante de la fenêtre principale de QGIS, cliquez sur le bouton \includegraphics[width=1.5em]{mActionAddMap.png} $^{\text{Ajouter une nouvelle carte}}$ dans la barre d'outils du composeur de cartes et dessinez un rectangle dans la feuille du composeur avec le bouton gauche de la souris pour ajouter la carte. Pour afficher la carte actuelle, vous pouvez choisir trois modes de représentation dans l'onglet \emph{Propriétés de l'objet} de la carte:
\begin{itemize}
\item {} 
\textbf{Rectangle} est l'option par défaut. Elle n'affiche qu'un cadre vide avec un message `La carte sera imprimée ici'.

\item {} 
\textbf{Cache} affiche la carte dans sa résolution d'écran actuelle. Si vous zoomez sur la fenêtre de composition, la carte ne sera pas actualisée, mais l'image sera mise à l'échelle.

\item {} 
\textbf{Rendu} signifie que, si vous faites un zoom dans la fenêtre de composition, la carte sera actualisée, mais pour des raisons de performances, une résolution maximale a été prédéfinie.

\end{itemize}

\textbf{Cache} est le mode d'aperçu par défaut pour une carte nouvellement créée.

Vous pouvez redimensionner l'élément de la carte en cliquant sur le bouton \includegraphics[width=1.5em]{mActionSelectPan.png} $^{\text{Sélectionner/déplacer un objet}}$, en sélectionnant l'élément, et en déplaçant un des curseurs bleus dans le coin de la carte. Avec la carte sélectionnée, vous pouvez maintenant adapter plus de propriétés dans l'onglet \emph{Propriétés de l'objet}.

Pour déplacer l'emprise dans l'élément carte, sélectionnez-le puis cliquez sur l'icône \includegraphics[width=1.5em]{mActionMoveItemContent.png} $^{\text{Déplacer le contenu de l'objet}}$ et déplacez les couches dans le cadre de l'élément `carte' avec le bouton gauche de la souris. Après avoir trouvé le bon emplacement, vous pouvez figer la position de cet élément au sein du composeur. Sélectionnez l'élément, faites un clic droit pour \includegraphics[width=1.5em]{mIconLock.png} $^{\text{verrouiller}}$. Vous pouvez également verrouiller la position de l'élément en activant la case \includegraphics{checkbox.png} \emph{Verrouiller les couches de cette carte} dans le panneau Objet.

\begin{notice}{note}{Note:}
QGIS peut maintenant afficher les étiquettes produites par le nouveau système d'étiquetage. La mise à l'échelle n'est pas encore au point, il vous sera peut-être nécessaire de retourner à l'ancien système dans certains cas.
\end{notice}


\subsection{Propriétés de la carte - Panneaux Carte et Emprise}
\label{docs/user_manual/print_composer/print_composer:map-item-properties-tab-map-and-extents-dialog}
\textbf{Panneau Carte}

Le panneau \emph{Carte} de l'onglet \emph{Propriétés de l'objet} présente les fonctionnalités suivantes (voir figure {\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-2]{figure\_composer\_2}}):
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{print_composer_map1.png}
\caption{Map Dialog \includegraphics[width=1em]{nix.png}}\end{figure}
\begin{itemize}
\item {} 
La zone \textbf{Prévisualisation} permet de choisir le mode d'aperçu `Rectangle', `Cache', et `Rendu' comme décrit plus haut. Cliquez sur \textbf{Mise à jour de l'aperçu} pour rafraîchir l'affichage de la carte.

\item {} 
La zone \textbf{Carte} vous permet de redimensionner le cadre de la carte selon la taille ou l'échelle. Le champ \emph{Rotation} \includegraphics{selectnumber.png} permet de tourner le contenu de l'élément carte dans le sens horaire, en degrés. Par défaut, l'angle des couches ayant un système de coordonnées est de 0. De plus, vous pouvez choisir de \includegraphics{checkbox.png} \emph{verrouiller les couches pour  cette carte} et de \includegraphics{checkbox.png} \emph{dessiner les objets du canevas de la carte}.

\end{itemize}

Si vous changez l'emprise de la fenêtre principale de QGIS en zoomant, déplaçant ou après avoir changé les propriétés d'une couche vecteur ou raster, vous pouvez mettre à jour le composeur de cartes en sélectionnant l'élément carte de la feuille et en cliquant sur le bouton \textbf{Mettre à jour l'aperçu}.

\textbf{Panneau Emprise}

Le panneau  \emph{Emprise} de l'onglet \emph{Propriétés de l'objet} présente les fonctionnalités suivantes (voir figure {\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-3]{figure\_composer\_3}}):
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-3}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{print_composer_map2.png}
\caption{Extents Dialog \includegraphics[width=1em]{nix.png}}\end{figure}
\begin{itemize}
\item {} 
La zone \textbf{Emprise de la carte} permet de spécifier l'étendue de la représentation cartographique en utilisant les valeurs X/Y minimales et maximales ou en cliquant sur le bouton  \textbf{{[}Fixer sur l'emprise courante de la carte{]}}.

\end{itemize}

Si vous changez de vue sur le canevas de la carte de QGIS en zoomant, en vous déplaçant ou en changeant les paramètres du vecteur ou raster, vous pouvez mettre à jour l'aperçu du composeur en sélectionnant l'élément de la carte et en cliquant le bouton \textbf{{[}Mettre à jour l'aperçu{]}} dans le panneau \emph{Propriétés de l'objet} (voir figure {\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-2]{figure\_composer\_2}} a).


\subsection{Onglet Propriétés de l'objet Carte - Panneaux Grille et Options globales}
\label{docs/user_manual/print_composer/print_composer:map-item-properties-tab-grid-and-general-options-dialog}
\index{Grid!Map\_Grid}
\textbf{Panneau Grille}

Le panneau  \emph{Grille} de l'onglet \emph{Propriétés de l'objet} présente les fonctionnalités suivantes (voir figure {\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-4]{figure\_composer\_4}}):
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-4}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{print_composer_map3.png}
\caption{Grid Dialog \includegraphics[width=1em]{nix.png}}\end{figure}
\begin{itemize}
\item {} 
La case \includegraphics{checkbox.png} \emph{Afficher le graticule} permet de superposer une grille sur l'élément de la carte. Vous pouvez choisir de la représenter sous forme de lignes continues ou de croix, choisir l'intervalle d'espacement dans les directions X et Y et les propriétés graphiques (couleur, épaisseur, etc.).

\item {} 
La case \includegraphics{checkbox.png} \emph{Dessiner une annotation} permet l'affichage des coordonnées sur le contour de la carte. Les annotations peuvent être placées à l'intérieur ou à l'extérieur tandis que leur direction peut être horizontale, verticale, horizontale et verticale ou dans le sens de la limite. Vous pouvez aussi choisir le type de police, la distance séparant l'annotation du cadre et la précision des coordonnées.

\end{itemize}

\textbf{Panneau Options globales}

Le panneau  \emph{Options globales} de l'onglet \emph{Propriétés de l'objet} présente les fonctionnalités suivantes (voir figure {\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-5]{figure\_composer\_5}}):
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-5}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{print_composer_map4.png}
\caption{General Options Dialog \includegraphics[width=1em]{nix.png}}\end{figure}
\begin{itemize}
\item {} 
Vous pouvez définir ici la couleur et l'épaisseur du cadre de l'élément, choisir une couleur pour le fond et le niveau d'opacité de la carte. Le bouton \textbf{Position} ouvre la fenêtre \emph{Définir la position de l'objet} qui permet de configurer la position du canevas de la carte en utilisant des points de référence ou des coordonnées. De plus, vous pouvez sélectionner ou désélectionner l'affichage du cadre de l'objet avec la case \includegraphics{checkbox.png} \emph{Afficher le cadre}.

\end{itemize}


\section{Ajouter d'autres éléments au compositeur de cartes}
\label{docs/user_manual/print_composer/print_composer:adding-other-elements-to-the-print-composer}
Au-delà de l'ajout d'un cadre de carte au composeur de cartes, il est possible d'ajouter, déplacer et personnaliser les éléments légendes, échelles graphiques, images et étiquettes.


\subsection{Onglet Propriétés de l'objet Etiquette - Panneaux Etiquette et Options globales}
\label{docs/user_manual/print_composer/print_composer:label-item-properties-tab-label-and-general-options-dialog}
Pour ajouter une étiquette, , cliquez sur l'icône \includegraphics[width=1.5em]{mActionLabel.png} $^{\text{Ajouter une étiquette}}$ et placez l'élément sur le canevas de la carte avec le bouton gauche de votre souris. Vous pouvez modifier la position et l'apparence avec le panneau de propriétés d'objets après avoir sélectionné l'élément.

\textbf{Panneau Etiquette}

Le panneau  \emph{Etiquette} de l'objet étiquette présente les fonctionnalités suivantes:
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-6}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{print_composer_label1.png}
\caption{Label Options Dialog \includegraphics[width=1em]{nix.png}}\end{figure}
\begin{itemize}
\item {} 
Le panneau \emph{Etiquette} permet d'ajouter des éléments textuels à la composition. Vous pouvez sélectionner l'alignement horizontal et vertical, la police et la couleur ainsi que définir la marge en mm.

\end{itemize}

\textbf{Panneau Options globales}

Le panneau \emph{Options globales} de l'onglet \emph{Propriétés de l'objet} présente les fonctionnalités suivantes:
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-7}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{print_composer_label2.png}
\caption{General Options Dialog \includegraphics[width=1em]{nix.png}}\end{figure}
\begin{itemize}
\item {} 
Vous pouvez choisir ici la couleur et le contour du cadre de l'élément, mettre une couleur de fond et gérer l'opacité de l'étiquette. Le bouton \emph{Position} ouvre la fenêtre \emph{Définir la position de l'objet} qui permet de configurer la position du canevas de la carte en utilisant des points de référence ou des coordonnées. De plus, vous pouvez sélectionner ou désélectionner l'affichage du cadre de l'objet avec la case \includegraphics{checkbox.png} \emph{Afficher le cadre}. Utilisez l'\emph{Identifiant de l'objet} pour créer des relations avec d'autres éléments du composeur.

\end{itemize}


\subsection{Onglet Propriétés de l'objet Image - Panneaux Options de l'image et Options globales}
\label{docs/user_manual/print_composer/print_composer:image-item-properties-tab-picture-options-and-general-options-dialog}
Pour ajouter une image, cliquez sur l'icône  \includegraphics[width=1.5em]{mActionSaveMapAsImage.png} $^{\text{Ajouter une image}}$ et placez l'élément sur le canevas de la carte avec le bouton gauche de votre souris. Vous pouvez modifier la position et l'apparence avec l'onglet \emph{Propriétés de l'objet} après avoir sélectionné l'élément.

\index{Picture\_database}
\index{Rotated\_North\_Arrow}
\textbf{Panneau Options de l'image}

Le panneau  \emph{Options de l'image} de l'onglet \emph{Propriétés de l'objet} d'une image présente les fonctionnalités suivantes (voir figure {\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-8]{figure\_composer\_8}}):
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-8}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{print_composer_image1.png}
\caption{Picture Options Dialog Dialog \includegraphics[width=1em]{nix.png}}\end{figure}
\begin{itemize}
\item {} 
La zone \textbf{Images préchargées} montre toutes les images présentes dans les répertoires sélectionnés.

\item {} 
La zone \textbf{Options} montre l'image actuellement sélectionnée et permet de définir sa taille et sa rotation. Il est également possible d'ajouter un répertoire personnalisé vers des fichiers SVG. Cocher l'option \includegraphics{checkbox.png} \emph{Synchroniser avec la carte} permet à l'image de suivre la même rotation que la carte (P. ex. une flèche pointant ainsi toujours vers le Nord même si le contenu de la carte a été pivoté).

\item {} 
La zone \textbf{Rechercher dans les répertoires} permet d'ajouter ou de retirer des répertoires contenant des images au format SVG à la liste des images disponibles.

\end{itemize}

\textbf{Panneau Options globales}

Le panneau  \emph{Options globales} de l'onglet \emph{Propriétés de l'objet} d'une image présente les fonctionnalités suivantes:
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-9}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{print_composer_image2.png}
\caption{General Options Dialog Dialog \includegraphics[width=1em]{nix.png}}\end{figure}
\begin{itemize}
\item {} 
Vous pouvez ici choisir la couleur et le contour du cadre de l'image, mettre une couleur de fond et gérer son opacité. Le bouton \textbf{Position} ouvre la fenêtre \emph{Définir la position de l'objet} qui permet de configurer la position du canevas de la carte en utilisant des points de référence ou des coordonnées. De plus, vous pouvez sélectionner ou désélectionner l'affichage du cadre de l'objet avec la case \includegraphics{checkbox.png} \emph{Afficher le cadre}. Utilisez l'\emph{Identifiant de l'objet} pour créer des relations avec d'autres éléments du composeur.

\end{itemize}

\index{Map\_Legend}

\subsection{Onglet Propriétés de l'objet Légende - Panneaux Général, Objets de légende et Options Globales}
\label{docs/user_manual/print_composer/print_composer:index-9}\label{docs/user_manual/print_composer/print_composer:legend-item-properties-tab-general-legend-items-and-item-option-dialog}
Pour ajouter une légende, cliquez sur l'icône  \includegraphics[width=1.5em]{mActionAddLegend.png} $^{\text{Ajouter une légende}}$ et placez l'élément sur le canevas de la carte avec le bouton gauche de votre souris. Vous pouvez modifier la position et l'apparence avec l'onglet \emph{Propriétés de l'objet} après avoir sélectionné l'élément.

\textbf{Panneau Général}

Le panneau  \emph{Général} de l'onglet \emph{Propriétés de l'objet} d'une légende propose les fonctionnalités suivantes (voir figure {\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-10]{figure\_composer\_10}}):
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-10}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{print_composer_legend1.png}
\caption{General Dialog \includegraphics[width=1em]{nix.png}}\end{figure}
\begin{itemize}
\item {} 
Vous pouvez ici modifier le titre de la légende et la police utilisée. Vous pouvez changer la hauteur et la largeur des symboles de la légende et ajouter des couches, des symboles, des icônes et des espaces. Depuis QGIS 1.8, vous pouvez choisir la chaîne de caractères définissant le retour à la ligne dans le titre.

\end{itemize}

\textbf{Panneau Objets de légende}

Le panneau  \emph{Objets de légende} de l'onglet \emph{Propriétés de l'objet} d'une légende propose les fonctionnalités suivantes (voir figure {\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-11]{figure\_composer\_11}}):
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-11}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{print_composer_legend2.png}
\caption{Legend Items Dialog \includegraphics[width=1em]{nix.png}}\end{figure}
\begin{itemize}
\item {} 
Cette fenêtre montre tous les objets inclus dans la légende et permet d'en changer l'ordre. Après avoir modifié la symbologie de QGIS dans la fenêtre principale de l'application, vous pouvez cliquer sur \textbf{Mise à jour} pour répercuter ces changements sur les objets de la légende du composeur de cartes. L'ordre des objets peut être altéré en utilisant les boutons \textbf{monter} et \textbf{descendre} ou en faisant un glisser-déposer.

\end{itemize}

\textbf{Panneau Options globales}

Le panneau  \emph{Options gloables} de l'onglet \emph{Propriétés de l'objet} d'une légende propose les fonctionnalités suivantes (voir figure {\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-12]{figure\_composer\_12}}):
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-12}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{print_composer_legend3.png}
\caption{General Options Dialog \includegraphics[width=1em]{nix.png}}\end{figure}
\begin{itemize}
\item {} 
Vous pouvez ici choisir la couleur et le contour du cadre de l'élément, mettre une couleur de fond et gérer son opacité. Le bouton \textbf{Position} ouvre la fenêtre \emph{Définir la position de l'objet} qui permet de configurer la position du canevas de la carte en utilisant des points de référence ou des coordonnées. De plus, vous pouvez sélectionner ou désélectionner l'affichage du cadre de l'objet avec la case \includegraphics{checkbox.png} \emph{Afficher le cadre}. Utilisez l'\emph{Identifiant de l'objet} pour créer des relations avec d'autres éléments du composeur.

\end{itemize}

\index{Scalebar!Map\_Scalebar}

\subsection{Onglet Propriétés de l'objet Barre d'échelle - Panneaux Barre d'échelle et Options globales}
\label{docs/user_manual/print_composer/print_composer:scalebar-item-properties-tab-scalebar-and-general-options-dialog}\label{docs/user_manual/print_composer/print_composer:index-10}
Pour ajouter une barre d'échelle, cliquez sur l'icône \includegraphics[width=1.5em]{mActionScaleBar.png} $^{\text{Ajouter une nouvelle échelle graphique}}$, placez l'élément sur le canevas de la carte avec le bouton gauche de votre souris. Vous pouvez modifier la position et son apparence avec le panneau de \emph{Propriétés de l'objet} après avoir sélectionné l'élément.

\textbf{Panneau Barre d'échelle}

Le panneau  \emph{Barre d'échelle} de l'onglet \emph{Propriétés de l'objet} propose les fonctionnalités suivantes (voir figure {\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-13]{figure\_composer\_13}}):
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-13}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{print_composer_scalebar1.png}
\caption{Scalebar Options Dialog \includegraphics[width=1em]{nix.png}}\end{figure}
\begin{itemize}
\item {} 
Ce panneau \emph{Barre d'échelle} permet de définir la taille de segment de l'échelle en unités de la carte, les unités de carte par unité de barre et le nombre segments à faire figurer à droite et à gauche du 0.

\item {} 
Vous pouvez changer le style de la barre d'échelle, disponible avec un ou 2 niveaux de segments, plate avec des repères ajustables ou simplement numérique.

\item {} 
Il est également possible de définir la hauteur, l'épaisseur des traits, les différents espaces ainsi que la police, la couleur et l'étiquette des unités.

\end{itemize}

\textbf{Panneau Options globales}

Le panneau  \emph{Options globales} de l'onglet \emph{Propriétés de l'objet} propose les fonctionnalités suivantes (voir figure {\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-14]{figure\_composer\_14}}):
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-14}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{print_composer_scalebar2.png}
\caption{General Options Dialog \includegraphics[width=1em]{nix.png}}\end{figure}
\begin{itemize}
\item {} 
Vous pouvez ici choisir la couleur et le contour du cadre de l'élément, mettre une couleur de fond et gérer son opacité. Le bouton \textbf{Position} ouvre la fenêtre ;guilabel:\emph{Définir la position de l'objet} qui permet de configurer la position du canevas de la carte en utilisant des points de référence ou des coordonnées. De plus, vous pouvez sélectionner ou désélectionner l'affichage du cadre de l'objet avec la case  \includegraphics{checkbox.png} \emph{Afficher le cadre}. Utilisez l'\emph{Identifiant de l'objet} pour créer des relations avec d'autres éléments du composeur.

\end{itemize}


\section{Outils de navigation}
\label{docs/user_manual/print_composer/print_composer:navigation-tools}
Pour vous déplacer sur la carte, le composeur de cartes propose 4 outils :
\begin{itemize}
\item {} 
\includegraphics[width=1.5em]{mActionZoomIn.png} $^{\text{Zoom +}}$

\item {} 
\includegraphics[width=1.5em]{mActionZoomOut.png} $^{\text{Zoom -}}$

\item {} 
\includegraphics[width=1.5em]{mActionZoomFullExtent.png} $^{\text{Zoom sur l'étendue totale}}$

\item {} 
\includegraphics[width=1.5em]{mActionDraw.png} $^{\text{Rafraîchir la vue}}$ pour actualiser l'affichage si nécessaire

\end{itemize}

\index{Revert\_Layout\_Actions}

\section{Outils Annuler et Refaire}
\label{docs/user_manual/print_composer/print_composer:revert-and-restore-tools}\label{docs/user_manual/print_composer/print_composer:index-11}
Pendant la mise en page de la carte, il est possible d'annuler et refaire des modifications. Cela peut être réaliser à l'aide des outils Annuler et Refaire:
\begin{itemize}
\item {} 
\includegraphics[width=1.5em]{mActionUndo.png} $^{\text{Annuler les dernières actions}}$

\item {} 
\includegraphics[width=1.5em]{mActionRedo.png} $^{\text{Refaire les dernières actions}}$

\end{itemize}

ou en cliquant sur l'onglet \emph{Historique des commandes} (voir figure {\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-16]{figure\_composer\_16}}).
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-16}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{command_hist.png}
\caption{Command history in the Print Composer \includegraphics[width=1em]{nix.png}}\end{figure}


\section{Ajouter des formes basiques et des flèches}
\label{docs/user_manual/print_composer/print_composer:add-basic-shape-and-arrow}
Il est possible d'ajouter des formes simples (Ellipse, Rectangle, Triangle) et des flèches à la composition.

Le panneau \emph{Forme} permet de dessiner une ellipse, un rectangle, ou un triangle. Vous pouvez modifier le contours, la couleur de remplissage et la rotation (dans le sens horaire).
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-18}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{print_composer_shape.png}
\caption{Shape Dialog \includegraphics[width=1em]{nix.png}}\end{figure}

Le panneau \emph{Flèche} permet de dessiner une flèche sur la carte, vous permettant d'attirer l'attention sur une partie spécifique de votre composition. Vous pouvez changer la couleur, le contour et la taille de la flèche. Il est possible d'utiliser un marqueur par défaut pour la pointe, aucun marqueur ou un marqueur SVG. Dans le cas du marqueur SVG, vous pouvez placer un marqueur de début et de fin à partir d'images situées sur l'ordinateur.
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-19}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{print_composer_arrow.png}
\caption{Arrow Dialog \includegraphics[width=1em]{nix.png}}\end{figure}


\section{Ajouter une table attributaire}
\label{docs/user_manual/print_composer/print_composer:add-attribute-table-values}
Vous pouvez ajouter une table attributaire d'une couche vectorielle dans le composeur de cartes.

\textbf{Panneau Table}

Le panneau  \emph{Table} de l'onglet \emph{Propriétés de l'objet} d'une table attributaire propose les fonctionnalités suivantes (voir figure {\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-20]{figure\_composer\_20}}):
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-20}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{print_composer_attribute1.png}
\caption{Table Dialog \includegraphics[width=1em]{nix.png}}\end{figure}
\begin{itemize}
\item {} 
Le panneau \emph{Table} permet de sélectionner une couche vectorielle et d'en afficher les colonnes avec la carte. Les colonnes peuvent être triées, dans un ordre croissant ou décroissant.

\item {} 
Vous pouvez limiter le nombre d'enregistrements affichés et ne montrer que les attributs des entités affichés dans votre composition.

\item {} 
Vous pouvez modifier les caractétristiques de grille du tableau ainsi que l'en-tête et la police employée.

\end{itemize}

\textbf{Panneau Options globales}

Le panneau \emph{Options globales} de l'onglet \emph{Propriétés de l'objet} d'une table attributaire propose les fonctionnalités suivantes (voir figure {\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-21]{figure\_composer\_21}}):
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-21}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{print_composer_attribute2.png}
\caption{General Options Dialog \includegraphics[width=1em]{nix.png}}\end{figure}
\begin{itemize}
\item {} 
Vous pouvez ici choisir la couleur et le contour du cadre de l'élément, mettre une couleur de fond et gérer son opacité. Le bouton \textbf{Position} ouvre la fenêtre \emph{Définir la position de l'objet} qui permet de configurer la position du canevas de la carte en utilisant des points de référence ou des coordonnées. De plus, vous pouvez sélectionner ou désélectionner l'affichage du cadre de l'objet avec la case  \includegraphics{checkbox.png} \emph{Afficher le cadre}. Utilisez l'\emph{Identifiant de l'objet} pour créer des relations avec d'autres éléments du composeur.

\end{itemize}


\section{Monter, descendre et aligner des éléments}
\label{docs/user_manual/print_composer/print_composer:raise-lower-and-align-elements}
Les fonctionnalités pour monter ou descendre des éléments sont présentes dans le menu déroulant \includegraphics[width=1.5em]{mActionRaiseItems.png} $^{\text{Relever les objets sélectionnés}}$. Prenez un élément dans le composeur de carte et sélectionnez la fonction correspondante pour le monter ou le descendre par rapport aux autres éléments (voir figure {\hyperref[docs/user_manual/print_composer/print_composer:table-composer-1]{table\_composer\_1}}).

Il y a plusieurs fonctionnalités d'alignements disponibles dans le menu déroulant \includegraphics[width=1.5em]{mActionAlignLeft.png} $^{\text{Aligner les objets sélectionnés}}$ (voir {\hyperref[docs/user_manual/print_composer/print_composer:table-composer-1]{table\_composer\_1}}). Pour utiliser une fonction, vous devez d'abord sélectionner plusieurs éléments et ensuite cliquer sur l'icône d'alignement désiré. Toute la sélection sera alignée dans le cadre de leurs limites respectives.

\index{Printing!Export\_Map}

\section{Création de carte}
\label{docs/user_manual/print_composer/print_composer:creating-output}\label{docs/user_manual/print_composer/print_composer:index-12}
La figure {\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-22]{figure\_composer\_22}} montre le composeur de cartes avec un exemple de mise en page incluant chaque type d'élément de carte décrit dans les sections précédentes.
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-22}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=40em]{print_composer_complete.png}
\caption{Print Composer with map view, legend, scalebar, coordinates and text added \includegraphics[width=1em]{nix.png}}\end{figure}

\index{Export\_as\_image}\index{Export\_as\_PDF}\index{Export\_as\_SVG}
Le composeur de cartes vous permet de choisir plusieurs formats de sortie et il est possible de définir la résolution (qualité d'impression) et le format du papier :
\begin{itemize}
\item {} 
Le bouton \includegraphics[width=1.5em]{mActionFilePrint.png} $^{\text{Imprimer}}$ permet d'imprimer la mise en page sur une imprimante ou dans un fichier Postscript en fonction des pilotes d'imprimante installés.

\item {} 
Le bouton \includegraphics[width=1.5em]{mActionSaveMapAsImage.png} $^{\text{Exporter dans une image}}$ exporte le cadre du composeur dans plusieurs formats d'image tels que PNG, BPM,TIF, JPG...

\item {} 
Le bouton \includegraphics[width=1.5em]{mActionSaveAsPDF.png} $^{\text{Exporter au format PDF}}$ enregistre le contenu du composeur directement dans un fichier PDF.

\item {} 
Le bouton \includegraphics[width=1.5em]{mActionSaveAsSVG.png} $^{\text{Exporter au format SVG}}$ sauve le cadre du composeur de carte en SVG (Scalable Vector Graphic).

\end{itemize}

\begin{notice}{note}{Note:}
Actuellement la sortie SVG est très basique. Ce n'est pas un problème de QGIS mais un problème de la bibliothèque Qt sous-jacente. Cela sera probablement corrigé dans une prochaine version.
\end{notice}

\index{Composer\_Manager}

\section{Enregistrer et charger un modèle de mise en page}
\label{docs/user_manual/print_composer/print_composer:saving-and-loading-a-print-composer-layout}\label{docs/user_manual/print_composer/print_composer:index-14}
Avec les boutons \includegraphics[width=1.5em]{mActionFileSaveAs.png} $^{\text{Sauvegarder en tant que modèle}}$ et \includegraphics[width=1.5em]{mActionFolder.png} $^{\text{Charger depuis un modèle}}$, vous pouvez enregistrer l'état actuel d'une session du composeur dans un modèle \code{.qpt} et le charger dans une autre session.

Le bouton \includegraphics[width=1.5em]{mActionComposerManager.png} $^{\text{Gestionnaire de composition}}$ qui se situe dans la barre d'outils et dans le menu \emph{Fichier \(\rightarrow\) Gestionnaire de composition} permet de gérer l'ajout de nouveau modèle à votre projet (p. ex. en chargeant un modèle externe) ou de gérer les modèles existants.
\phantomsection\label{docs/user_manual/print_composer/print_composer:figure-composer-23}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{print_composer_manager.png}
\caption{The Print Composer Manager \includegraphics[width=1em]{nix.png}}\end{figure}


\chapter{Extensions}
\label{docs/user_manual/plugins/plugins_index::doc}\label{docs/user_manual/plugins/plugins_index:plugins}
\index{plugins}

\section{Extensions QGIS}
\label{docs/user_manual/plugins/plugins:index-0}\label{docs/user_manual/plugins/plugins:qgis-plugins}\label{docs/user_manual/plugins/plugins::doc}\label{docs/user_manual/plugins/plugins:plugins}
QGIS repose sur un système d'extensions. Cela permet d'ajouter facilement de nouvelles fonctions au logiciel. De nombreuses nouvelles fonctions de QGIS sont implémentées comme des extensions \textbf{principales} ou \textbf{complémentaires}.

\index{plugins!types}\begin{itemize}
\item {} 
Les \textbf{extensions principales} sont maintenues par l'équipe de développement de QGIS et sont intégrées automatiquement à chaque nouvelle distribution de QGIS. Elles sont écrites en C++ ou en Python. On trouvera plus d'informations sur les extensions principales dans la Section {\hyperref[docs/user_manual/plugins/core_plugins:core-plugins]{\emph{Utiliser les extensions principales de QGIS}}}

\item {} 
Les \textbf{extensions complémentaires} sont actuellement toutes écrites en Python. Elles sont stockées dans des dépôts externes et maintenues par leurs auteurs. Elles peuvent être ajoutées à QGIS en utilisant l'\emph{Installateur d'extensions Python}. On trouvera plus d'informations sur les extensions complémentaires dans la Section \emph{load\_external\_plugins}.

\end{itemize}


\subsection{Gestion des extensions}
\label{docs/user_manual/plugins/plugins:id1}\label{docs/user_manual/plugins/plugins:managing-plugins}
De manière générale, gérer les extensions consiste à les afficher ou pas à l'aide du \emph{Gestionnaire d'extension}. Les extensions complémentaires doivent d'abord être installées à l'aide de l'\emph{Installateur d'extensions python} pour pouvoir être activées ou désactivées dans le \emph{Gestionnaire d'extension}.


\subsubsection{Activer une extension principale}
\label{docs/user_manual/plugins/plugins:loading-a-qgis-core-plugin}\label{docs/user_manual/plugins/plugins:load-core-plugin}
On active une extension principale à l'aide du menu \emph{Extensions \(\rightarrow\) Gestionnaire d'extensions}

\index{plugins!manager}\phantomsection\label{docs/user_manual/plugins/plugins:figure-plugins-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{pluginmanager.png}
\caption{Plugin Manager \includegraphics[width=1em]{nix.png}}\end{figure}

Le \emph{Gestionnaire d'extensions} liste toutes les extensions disponibles et leur statut (installé ou pas), dont toutes les extensions principales et toutes celles complémentaires que vous avez ajoutées à l'aide de l'\emph{Installateur d'extensions Python} (voir Section \emph{load\_external\_plugins}). Les extensions installées sont cochées à gauche de leur nom. La figure {\hyperref[docs/user_manual/plugins/plugins:figure-plugins-1]{Figure\_plugins\_1}} montre la boîte de dialogue du \emph{Gestionnaire d'extension}.

Pour installer une extension, cocher la case à gauche du nom puis cliquez sur \textbf{{[}OK{]}}. Les extensions installées sont mémorisées lorsque vous quittez l'application et seront restaurées à la prochaine ouverture de QGIS.

\index{crashes}
\begin{notice}{tip}{Astuce:}
\textbf{Extensions défaillantes}

Si QGIS ne se lance pas, il est possible que cela vienne d'une extension défaillante. Vous pouvez désactiver le chargement des extensions en éditant le fichier de configuration (voir {\hyperref[docs/user_manual/introduction/qgis_configuration:gui-options]{\emph{Options}}} pour son emplacement exact). Recherchez les configurations des extensions et mettez les valeurs à \code{false} pour empêcher leur chargement.

\includegraphics[width=1em]{nix.png} Par exemple, pour empêcher le chargement de l'extension `Texte Délimité', sous Linux, la ligne du fichier \code{\$HOME/.config/QuantumGIS/qgis.conf} devra ressembler à ceci: \code{Add Delimited Text Layer=false}.

Faites ceci pour chaque extension de la section {[}Extensions{]}. Vous pouvez alors redémarrer QGIS et activer les extensions une par une dans le \emph{Gestionnaire d'extensions} pour trouver celle qui pose problème.
\end{notice}


\subsubsection{Installer une extension externe}
\label{docs/user_manual/plugins/plugins:load-external-plugin}\label{docs/user_manual/plugins/plugins:loading-an-external-qgis-plugin}
Les extensions QGIS externes sont écrites en Python. Elles sont stockées par défaut soit dans le répertoire QGIS `Officiel' ou `contribution utilisateur' soit dans différents dépôts externes maintenus par des auteurs indépendants. Ces listes sont disponibles automatiquement à partir de l'\emph{Installateur d'extensions Python}.

Des informations détaillées sur l'utilisation, la version minimale de QGIS, la page principale, les auteurs et d'autres informations importantes sont disponibles avec le Dépôt Officiel QGIS situé à l'adresse \href{http://plugins.qgis.org/plugins/}{http://plugins.qgis.org/plugins/}. Pour les dépôts externes, ces informations peuvent être disponibles avec les extensions elles-mêmes. De manière général, elles ne sont pas incluses dans ce manuel d'utilisation.

\begin{notice}{note}{Note:}
Les mises à jours des extensions principales sont disponibles dans ce dépôt externe.
\end{notice}

\begin{notice}{note}{Note:}
Les extensions fTools, Export Mapserver et l'Installateur d'Extensions sont écrits en Python, mais elles font également parties du code source de QGIS. Elles sont donc automatiquement chargées et activées dans le Gestionnaire d'Extension (voir la Section {\hyperref[docs/user_manual/plugins/plugins:load-external-plugin]{\emph{Installer une extension externe}}}).
\end{notice}

Actuellement plus de 150 extensions externes sont disponibles à partir du Dépôt Officiel QGIS. Certaines de ces extensions offrent des fonctionnalités qui sont demandées par beaucoup d'utilisateurs (par exemple, fournir la possibilité de voir et d'éditer des données OpenStreetMap ou d'ajouter des couches Google) tandis que d'autres offrent des fonctions très spécialisées (par exemple calculer le diamètre économique pour les réseaux d'approvisionnement en eau).

Il est cependant assez simple de faire une recherche à travers les extensions externes disponibles à l'aide de mots-clés, en choisissant un dépôt et/ou en filtrant le statut des extensions (pour le moment celles installées et non installées sur votre système). Chercher et filtrer est réaliser à partir du Gestionnaire d'extension de QGIS (voir Figure {\hyperref[docs/user_manual/plugins/plugins:figure-plugins-2]{figure\_plugins\_2}}).

\begin{notice}{tip}{Astuce:}
\textbf{Ajouter plus de dépôts}

Pour ajouter un dépôt `Contribution d'utilisateurs' et/ou plusieurs dépôts de contributeurs externes, ouvrez l'installeur d'extension Python(\emph{Extensions \(\rightarrow\) Installeur d'extensions Python}), allez sur l'onglet \emph{Dépôts} et cliquez sur \textbf{{[}Ajouter les dépôts tiers{]}}. Si vous ne voulez pas un ou plusieurs dépôts  ajoutés, ils peuvent être désactivés via le bouton \textbf{{[}Éditer...{]}}, ou complètement supprimés avec le bouton \textbf{{[}Supprimer{]}}.
\end{notice}

Une seule étape est nécessaire pour installer une extension externe dans QGIS:
\begin{itemize}
\item {} 
Téléchargez une extension externe depuis un dépôt à l'aide de l'\emph{installeur d'extension python} (voir section {\hyperref[docs/user_manual/plugins/plugins:python-plugin-installer]{\emph{Utiliser l'installeur d'extension python de QGIS}}}). La nouvelle extension complémentaire sera ajoutée à la liste des extensions disponibles dans le \emph{gestionnaire d'extensions} et automatiquement chargée.

\end{itemize}


\subsubsection{Utiliser l'installeur d'extension python de QGIS}
\label{docs/user_manual/plugins/plugins:python-plugin-installer}\label{docs/user_manual/plugins/plugins:using-the-qgis-python-plugin-installer}
\index{plugins!installing}
\index{plugins!Python Plugin Installer}
\index{plugins!upgrading}
Pour télécharger et installer une extension python complémentaire, cliquez sur le \emph{Extensions \textgreater{}} \includegraphics[width=1.5em]{plugin_installer.png} \emph{Installateur d'extensions python}. La fenêtre de l'\emph{Installeur d'extension python} apparaîtra (figure {\hyperref[docs/user_manual/plugins/plugins:figure-plugins-2]{figure\_plugins\_2}}) avec l'onglet \emph{Extensions}, qui présente la liste de toutes les extensions python installées localement ou disponibles dans des dépôts distants.
\phantomsection\label{docs/user_manual/plugins/plugins:figure-plugins-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{plugininstaller.png}
\caption{Installing external python plugins \includegraphics[width=1em]{nix.png}}\end{figure}

Chaque extension peut être soit:
\begin{itemize}
\item {} 
\textbf{non installée} : signifie que l'extension est disponible dans le dépôt, mais n'est pas encore installée. Pour l'installer, sélectionnez-la dans la liste et cliquez sur le bouton \textbf{{[}Installer l'extension{]}}.

\item {} 
\textbf{nouveau} : signifie que l'extension est nouvelle dans le dépôt.

\item {} 
\textbf{installée} : l'extension est déjà installée. Si elle est également disponible dans un dépôt, le bouton \textbf{{[}Ré-installer l'extension{]}} est actif. En revanche, si la version disponible est plus ancienne que la version installée, le bouton \textbf{{[}Rétrograder la version{]}} apparaît à la place.

\item {} 
\textbf{mise à jour disponible} : l'extension est installée, mais une version plus récente est disponible. Les boutons \textbf{{[}Mettre à jour l'extension{]}} et \textbf{{[}Toute mettre à jour{]}} sont actifs.

\item {} 
\textbf{invalide} : l'extension est installée, mais ne fonctionne pas. Les détails sont donnés dans la description de l'extension.

\end{itemize}

\textbf{L'onglet Extensions}

Pour installer une extension, sélectionnez-la dans la liste et cliquez sur le bouton \textbf{{[}Installer l'extension{]}}. L'extension est installée dans un répertoire qui lui est dédié.
\begin{itemize}
\item {} 
\includegraphics[width=1em]{nix.png} Linux et autres unix
\begin{itemize}
\item {} 
\code{/share/qgis/python/plugins}

\item {} 
\code{\$HOME/.qgis/python/plugins}

\end{itemize}

\item {} 
\includegraphics[width=1em]{osx.png} Mac OS X
\begin{itemize}
\item {} 
\code{/Contents/MacOS/share/qgis/python/plugins}

\item {} 
\code{/Users/\$USERNAME/.qgis/python/plugins}

\end{itemize}

\item {} 
\includegraphics[width=1em]{win.png} Windows
\begin{itemize}
\item {} 
\code{C:\textbackslash{}Program Files\textbackslash{}QGIS\textbackslash{}python\textbackslash{}plugins}

\item {} 
\code{C:\textbackslash{}Documents and Settings\textbackslash{}\$USERNAME\textbackslash{}.qgis\textbackslash{}python\textbackslash{}plugins}

\end{itemize}

\end{itemize}

Si l'installation est réussie, un message de confirmation apparaît.

Si l'installation ne fonctionne pas, la raison est alors indiquée dans une fenêtre d'alerte. Les problèmes les plus fréquents sont dus à des erreurs de connexion et à des modules Python manquants. Dans le premier cas, il vous faudra probablement attendre quelques instants puis retenter l'installation (dans le cas où il s'agit d'un problème dû au serveur); dans le second cas, il sera nécessaire d'installer les modules manquants pour votre système d'exploitation avant d'utiliser les extensions. Pour Linux, la plupart des modules requis devraient être disponibles dans le gestionnaire de paquets de votre distribution. Pour les instructions d'installation pour Windows, visitez la page web du module.

Si vous utilisez un proxy, vous pourriez avoir besoin de le configurer dans le menu \emph{Edition \(\rightarrow\) Options} (Gnome, OSX) or \emph{Préférences \(\rightarrow\) Options} (KDE, Windows) dans l'onglet \emph{Proxy}.

Le bouton \textbf{{[}Désinstaller l'extension{]}} est actif seulement si l'extension sélectionnée est installée et n'est pas une extension principale. Notez que si vous avez installé une mise à jour d'une extension principale, vous pouvez désinstaller cette mise à jour avec le bouton \textbf{{[}Désinstaller l'extension{]}} et revenir à la version d'origine fournie à l'installation de Quantum GIS. Cette dernière ne peut cependant pas être désinstallée.

\textbf{L'onglet Dépôts}

Le second onglet, \emph{Dépôts}, contient une liste de dépôts d'extensions disponibles pour l'\emph{Installateur d'extensions}. Par défaut, seul le Dépôt Officiel de QGIS (QGIS Official Repository) est utilisé. Vous pouvez ajouter des dépôts contenant des contributions d'utilisateurs, notamment le dépôt central de contributions de QGIS (QGIS Contributed Repository) et quelques autres dépôts externes cliquant sur le bouton \textbf{{[}Ajouter un dépôt-tiers d'extension à la liste{]}}. Ces dépôts contiennent une grande quantité d'extensions utiles, mais elles ne sont pas maintenues par l'équipe de développement de QGIS et nous ne pouvons prendre aucune responsabilité les concernant. Vous pouvez également gérer la liste de dépôts manuellement, pour ajouter, retirer ou éditer des entrées. Désactiver temporairement un dépôt particulier est possible en cliquant sur le bouton \textbf{{[}Éditer...{]}}.

\textbf{L'onglet Options}

L'onglet \emph{Options} vous permet de configurer les paramètres de l'\emph{Installateur d'extensions}. La case \includegraphics{checkbox.png} \emph{Chercher des mises à jour au démarrage} configure QGIS pour rechercher automatiquement les mises à jour et les actualités relatives aux extensions. Si la case est cochée, tous les dépôts listés et activés dans l'onglet \emph{Dépôts} sont vérifiés à chaque démarrage du programme. La fréquence de cette vérification peut être ajustée dans le menu déroulant allant d'une fois par jour à tous les mois. Si une nouvelle extension ou une mise à jour est disponible pour une des extensions installées, une notification cliquable apparaît dans la barre de statut. Si la case est décochée, la recherche de mises à jour et d'actualités s'effectue uniquement lorsque l'\emph{Installateur d'Extension} est lancé manuellement depuis le menu.

Bien que l'installateur d'extensions puisse prendre en charge des ports autres que le 80, certaines connexions Internet peuvent poser des problèmes lors des vérifications automatiques. Dans ce cas, un indicateur \emph{Recherche de nouvelles extensions...} reste visible dans la barre de statut durant toute la session QGIS et peut faire planter le programme à la fermeture. Dans ce cas, décochez la case.

De plus, vous pouvez spécifier le type d'extension qui sont affichées dans l'\emph{Installateur d'extensions Python}. Sous \emph{Extensions autorisées}, vous pouvez spécifier si vous le souhaitez :
\begin{itemize}
\item {} 
\includegraphics{radiobuttonon.png} \emph{Afficher seulement les extensions du dépôt officiel}

\item {} 
\includegraphics{radiobuttonoff.png} \emph{Afficher toutes les extensions, sauf celles encore expérimentales}

\item {} 
\includegraphics{radiobuttonoff.png} \emph{Afficher toutes les extensions, même celles encore expérimentales}

\end{itemize}

\begin{notice}{tip}{Astuce:}
\textbf{Utiliser les extensions expérimentales}

Les extensions expérimentales sont généralement inadaptées à une utilisation en production. Ces extensions sont à des stades peu avancés de développement et doivent être considérées comme des outils `incomplets' ou des `démonstrations de faisabilité'. L'équipe de développement de QGIS ne recommande pas de les installer sauf pour des besoins de test.
\end{notice}

\index{data providers}

\subsection{Prestataires de données}
\label{docs/user_manual/plugins/plugins:index-7}\label{docs/user_manual/plugins/plugins:data-providers}
Les prestataires de données sont des extensions ``spéciales'' donnant accès à un dépôt de données. Par défaut, QGIS supporte les couches PostGIS et les bases de données couvertes par la bibliothèque GDAL/OGR. L'utilisation d'extensions pour fournir des données permet d'élargir les sources de données utilisables par QGIS.

Les extensions fournissant des données sont automatiquement enregistrées par QGIS au démarrage. Elles ne sont pas gérées par le Gestionnaire d'Extension, mais utilisées en arrière-plan lorsqu'un type de données est ajouté comme couche dans QGIS.


\section{Utiliser les extensions principales de QGIS}
\label{docs/user_manual/plugins/core_plugins:using-qgis-core-plugins}\label{docs/user_manual/plugins/core_plugins::doc}\label{docs/user_manual/plugins/core_plugins:core-plugins}






\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Bouton
} & \textsf{\relax 
Extension
} & \textsf{\relax 
Description
} & \textsf{\relax 
Référence dans le manuel
}\\
\hline
\includegraphics[width=1.5em]{delimited_text.png}
 & 
Ajoute une couche de Texte Délimité
 & 
Charge un fichier texte contenant des coordonnées en x,y
 & 
{\hyperref[docs/user_manual/plugins/plugins_delimited_text:label-dltext]{\emph{Extension Texte Délimité}}}
\\

\includegraphics[width=1.5em]{coordinate_capture.png}
 & 
Saisie de coordonnées
 & 
Saisie les coordonnées de la souris dans des systèmes de coordonnées différents
 & 
{\hyperref[docs/user_manual/plugins/plugins_coordinate_capture:coordcapt]{\emph{Extension de Saisie de Coordonnées}}}
\\

\includegraphics[width=1.5em]{dbmanager.png}
 & 
DB Manager
 & 
Gère les bases de données depuis QGIS
 & 
{\hyperref[docs/user_manual/plugins/plugins_db_manager:dbmanager]{\emph{Extension DB Manager}}}
\\


 & 
Diagramme incrusté
 & 
Ajoute des diagrammes aux couches vectorielles
 & 
{\hyperref[docs/user_manual/plugins/plugins_diagram_overlay:diagram-overlay]{\emph{Extension Diagramme incrusté}}}
\\

\includegraphics[width=1.5em]{dxf2shp_converter.png}
 & 
Convertisseur DXF vers Shapefile
 & 
Convertit depuis un fichier DXF vers un fichier SHP
 & 
{\hyperref[docs/user_manual/plugins/plugins_dxf2shape_converter:dxf2shape]{\emph{Extension Convertisseur Dxf2Shp}}}
\\

\includegraphics[width=1.5em]{event_id.png}
 & 
eVis
 & 
Outil de visualisation d'évènements
 & 
{\hyperref[docs/user_manual/plugins/plugins_evis:evis]{\emph{Extension eVis}}}
\\

\includegraphics[width=1.5em]{ftools_logo.png}
 & 
fTools
 & 
Ensemble d'outils vectoriels
 & 
{\hyperref[docs/user_manual/plugins/plugins_ftools:ftools]{\emph{Extension fTools}}}
\\

\includegraphics[width=1.5em]{gps_importer.png}
 & 
Outils GPS
 & 
Outils pour charger et importer des données GPS
 & 
{\hyperref[docs/user_manual/working_with_gps/plugins_gps:plugin-gps]{\emph{Extension GPS}}}
\\

\includegraphics[width=1.5em]{grasslogo.png}
 & 
GRASS
 & 
Fonctionnalités GRASS
 & 
{\hyperref[docs/user_manual/grass_integration/grass_integration:sec-grass]{\emph{Intégration du SIG GRASS}}}
\\

\includegraphics[width=1.5em]{raster-info.png}
 & 
Outils GDALTools
 & 
Fonctionnalités GDAL sur des couches raster
 & 
{\hyperref[docs/user_manual/plugins/plugins_gdaltools:label-plugingdaltools]{\emph{Extension GDALTools}}}
\\

\includegraphics[width=1.5em]{georeferencer.png}
 & 
Géoréférenceur GDAL
 & 
Géoréférenceur de couches raster à l'aide de GDAL
 & 
{\hyperref[docs/user_manual/plugins/plugins_georeferencer:georef]{\emph{L'extension de géoréférencement}}}
\\

\includegraphics[width=1.5em]{heatmap.png}
 & 
Carte de chaleur
 & 
Crée une carte raster de chaleur à partir d'une couche vectorielle de points
 & 
{\hyperref[docs/user_manual/plugins/plugins_heatmap:heatmap-plugin]{\emph{Extension Carte de chaleur}}}
\\

\includegraphics[width=1.5em]{interpolation.png}
 & 
Extension d'interpolation
 & 
Interpolation sur la base des vertex d'une couche vectorielle
 & 
{\hyperref[docs/user_manual/plugins/plugins_interpolation:interpol]{\emph{Extension Interpolation}}}
\\

\includegraphics{mapserver_export.png}
 & 
Extension Exportation Mapserver
 & 
Exporte un projet QGIS vers un fichier map de Mapserver
 & 
{\hyperref[docs/user_manual/plugins/plugins_mapserver_export:mapserver-export]{\emph{Extension d'exportation Mapserver}}}
\\

\includegraphics[width=1.5em]{offline_editing_copy.png}
 & 
Edition hors-ligne
 & 
Edition hors-ligne avec synchronisation de la base de données
 & 
{\hyperref[docs/user_manual/plugins/plugins_offline_editing:offlinedit]{\emph{Extension d'Édition hors-ligne}}}
\\

\includegraphics[width=1.5em]{osm_load.png}
 & 
OpenStreetMap
 & 
Accède à OpenStreetMap
 & 
{\hyperref[docs/user_manual/osm/openstreetmap:plugins-osm]{\emph{OpenStreetMap}}}
\\

\includegraphics[width=1.5em]{oracle_raster.png}
 & 
Géoraster Oracle Spatial
 & 
Accède aux Géorasters d'Oracle Spatial
 & 
{\hyperref[docs/user_manual/plugins/plugins_oracle_raster:oracle-raster]{\emph{Extension GeoRaster Oracle}}}
\\

\includegraphics[width=1.5em]{plugin_installer.png}
 & 
Installateur d'extensions
 & 
Télécharge et installe des extensions python
 & 
{\hyperref[docs/user_manual/plugins/plugins:python-plugin-installer]{\emph{Utiliser l'installeur d'extension python de QGIS}}}
\\

\includegraphics[width=1.5em]{raster_terrain.png}
 & 
Analyse des modèles de terrain
 & 
Calcule les caractéristiques géomorphologiques depuis des MNT
 & 
{\hyperref[docs/user_manual/plugins/plugins_raster_terrain:rasterrain]{\emph{Extension d'Analyse Raster de Terrain}}}
\\


 & 
Extensions de graphes routiers
 & 
Recherche du plus court chemin
 & 
{\hyperref[docs/user_manual/plugins/plugins_road_graph:roadgraph]{\emph{Extension Graphe routier}}}
\\

\includegraphics{spiticon.png}
 & 
SPIT
 & 
Outil d'import de fichiers Shape vers PostgreSQL/PostGIS
 & 
{\hyperref[docs/user_manual/working_with_vector/supported_data:loading-postgis-data]{\emph{Importer des données dans PostgreSQL}}}
\\

\includegraphics[width=1.5em]{sqlanywhere.png}
 & 
Extension SQL Anywhere
 & 
Accède à une base SQL Anywhere
 & 
{\hyperref[docs/user_manual/plugins/plugins_sql_anywhere:sqlanywhere]{\emph{Extension SQL Anywhere}}}
\\

\includegraphics[width=1.5em]{spatialquery.png}
 & 
Requête spatiale
 & 
Réalise des requêtes spatiales sur des couches vectorielles
 & 
{\hyperref[docs/user_manual/plugins/plugins_spatial_query:spatial-query]{\emph{Extension Requête Spatiale}}}
\\

\includegraphics[width=1.5em]{raster-stats.png}
 & 
Statistiques de zones
 & 
Statistiques des pixels contenus dans des polygones
 & 
{\hyperref[docs/user_manual/plugins/plugins_zonal_statistics:zonal-statistics]{\emph{Extension Statistiques de zone}}}
\\
\hline\end{tabulary}



\section{Extension de Saisie de Coordonnées}
\label{docs/user_manual/plugins/plugins_coordinate_capture:coordinate-capture-plugin}\label{docs/user_manual/plugins/plugins_coordinate_capture:coordcapt}\label{docs/user_manual/plugins/plugins_coordinate_capture::doc}
L'extension Saisie de Coordonnées est simple d'utilisation et offre la possibilité d'afficher des coordonnées sur la carte en sélectionnant deux Systèmes de Coordonnées de Référence (SCR) différents.
\phantomsection\label{docs/user_manual/plugins/plugins_coordinate_capture:figure-coordinate-capture-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{coordinate_capture_dialog.png}
\caption{Coordinate Capture Plugin \includegraphics[width=1em]{nix.png}}\end{figure}
\begin{enumerate}
\item {} 
Démarrez QGIS, sélectionnez \includegraphics[width=1em]{mActionOptions.png} \emph{Propriétés du Projet} dans le menu \emph{Préférences} (KDE, Windows) ou \emph{Fichier} (Gnome, OSX) et appuyez sur l'onglet \emph{Système de coordonnées de référence (SCR)}. Vous pouvez également appuyer sur le bouton \includegraphics[width=1.5em]{mIconProjectionEnabled.png} $^{\text{Statut de la projection}}$ située dans l'angle inférieur droit de la barre de statut.

\item {} 
Cochez l'option \includegraphics{checkbox.png} \emph{Autoriser la projection `à la volée'} et sélectionnez le système de coordonnées de votre choix (voir également la Section {\hyperref[docs/user_manual/working_with_projections/working_with_projections:label-projections]{\emph{Utiliser les projections}}}).

\item {} 
Chargez l'extension Saisie de Coordonnées depuis le Gestionnaire d'Extension (voir la Section {\hyperref[docs/user_manual/plugins/plugins:load-core-plugin]{\emph{Activer une extension principale}}}) puis assurez-vous que l'extension est activée en allant dans \emph{Vue \textgreater{} Panneaux} pour vérifier que la fonction \includegraphics{checkbox.png} \emph{Saisie de Coordonnées} est cochée. La fenêtre Saisie de Coordonnées apparaît alors comme indiqué dans la Figure {\hyperref[docs/user_manual/plugins/plugins_coordinate_capture:figure-coordinate-capture-1]{figure\_coordinate\_capture\_1}}.

\item {} 
Appuyez sur le bouton \includegraphics{geographic.png} $^{\text{Cliquez pour sélectionner le SCR à utiliser pour l'affichage des coordonnées}}$ et sélectionnez un SCR différent de celui que vous avez choisi plus haut.

\item {} 
Pour lancer la capture de coordonnées, appuyez sur \textbf{{[}Débuter la capture{]}}. Vous pouvez maintenant cliquer n'importe où sur la carte et l'extension affichera les coordonnées dans chacun des deux SCR sélectionnés.

\item {} 
Pour activer le suivi des coordonnées par le curseur appuyez sur le bouton \includegraphics[width=1.5em]{tracking.png} $^{\text{Suivi du curseur}}$.

\item {} 
Vous pouvez également copier les coordonnées dans le presse-papier.

\end{enumerate}


\section{Extension DB Manager}
\label{docs/user_manual/plugins/plugins_db_manager:db-manager-plugin}\label{docs/user_manual/plugins/plugins_db_manager:dbmanager}\label{docs/user_manual/plugins/plugins_db_manager::doc}
L'extensions DB Manager fait officiellement partie des extensions principales de QGIS et est destiné à terme à remplacer les extensions SPIT et PostGIS Manager afin d'intégrer en une seule et même interface utilisateur l'accès à tous les formats de bases de données reconnus par QGIS. Le bouton \includegraphics[width=1.5em]{dbmanager.png} $^{\text{DB Manager}}$ propose plusieurs donctionnalités. Vous pouvez glisser des couches depuis l'explorateur QGIS vers DB Manager et cela importera la couche dans votre base de données. Vous pouvez également transférer des tables entre bases de données par un simple glisser-déposer. Vous pouvez utiliser DB Manager pour exécuter une requête SQL sur une base de données et visualiser le résultat sous forme de couche dans QGIS.
\phantomsection\label{docs/user_manual/plugins/plugins_db_manager:figure-db-manager}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{db_manager.png}
\caption{DB Manager dialog (KDE) \includegraphics[width=1em]{nix.png}}\end{figure}

Le menu \emph{Base de données} permet de se connecter à une base de données existante, de démarrer la fenêtre de requête SQL et de quitter l'extension DB Manager. Le menu \emph{Schema} inclut des outils pour créer, supprimer des schémas (vides) et, si les fonctions topologiques sont disponibles (par exemple avec PostGIS 2), de démarrer le \emph{TopoViewer}. Le menu \emph{Table} permet de créer, d'éditer et de supprimer des tables et des vues. Il est également possible de vider des tables, de les déplacer entre schemas. Enfin, vous pouvez exécuter un Vacuum Analyse et ajouter le suivi des version sur une table.

La zone \emph{Arborescence} affiche l'ensemble des bases de données existantes supportées par QGIS. A l'aide d'un double-clic, vous pouvez vous connecter à une base. Un clic droit permet de renommer ou de supprimer un schéma ou une table existante. Les tables peuvent être ajoutées au canevas de QGIS à l'aide du menu contextuel.

Si une connection à une base de données est active, la fenêtre \textbf{principale} de DB Manager présente trois onglets. L'onglet \emph{Info} affiche les informations concernant la table et sa géométrie ainsi que mes champs, contraintes et index existants. Il est également possible d'exécuter un Vacuum Analyse et de créer un index spatial sur une table, s'il n'existe pas. L'onglet \emph{Table} affiche les attributs et l'onglet \emph{Aperçu} génère un aperçu des gémotries.


\section{Extension Texte Délimité}
\label{docs/user_manual/plugins/plugins_delimited_text:delimited-text-plugin}\label{docs/user_manual/plugins/plugins_delimited_text:label-dltext}\label{docs/user_manual/plugins/plugins_delimited_text::doc}
L'extension Texte Délimité permet de charger un fichier texte délimité comme
couche dans QGIS.


\subsection{Exigences}
\label{docs/user_manual/plugins/plugins_delimited_text:requirements}
Pour afficher un fichier texte délimité comme une couche, le fichier texte doit contenir :
\begin{enumerate}
\item {} 
Une ligne d'en-tête délimité contenant les noms des champs. Cette ligne doit être la première du fichier.

\item {} 
La ligne d'entête doit contenir les champs X et Y. Ces champs peuvent avoir n'importe quel nom.

\item {} 
Les coordonnées X et Y doivent être de type numérique. Le système de coordonnées n'est pas important.

\end{enumerate}

Comme exemple de fichier texte valide, nous pouvons importer le fichier point d'élévation \code{elevp.csv} fourni avec le jeu de données échantillon de QGIS (voir la Section {\hyperref[docs/user_manual/introduction/getting_started:label-sampledata]{\emph{Échantillon de données}}}):

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{n}{X}\PYG{p}{;}\PYG{n}{Y}\PYG{p}{;}\PYG{n}{ELEV}
\PYG{o}{\PYGZhy{}}\PYG{l+m+mi}{300120}\PYG{p}{;}\PYG{l+m+mi}{7689960}\PYG{p}{;}\PYG{l+m+mi}{13}
\PYG{o}{\PYGZhy{}}\PYG{l+m+mi}{654360}\PYG{p}{;}\PYG{l+m+mi}{7562040}\PYG{p}{;}\PYG{l+m+mi}{52}
\PYG{l+m+mi}{1640}\PYG{p}{;}\PYG{l+m+mi}{7512840}\PYG{p}{;}\PYG{l+m+mi}{3}
\PYG{p}{[}\PYG{o}{.}\PYG{o}{.}\PYG{o}{.}\PYG{p}{]}
\end{Verbatim}

Nous noterons les points suivants à propos du fichier texte :
\begin{enumerate}
\item {} 
Le fichier texte d'exemple utilise le \code{;} comme délimiteur. N'importe quel caractère peut être utilisé comme délimiteur de champ.

\item {} 
La première ligne est la ligne d'entête. Elle contient les champs \code{X}, \code{Y} et \code{ELEV}.

\item {} 
Les guillemets (\code{"}) ne peuvent pas être utilisés pour délimiter les champs textes.

\item {} 
Les coordonnées x sont incluses dans le champ \code{X}.

\item {} 
Les coordonnées y sont incluses dans le champ \code{Y}.

\end{enumerate}


\subsection{Mise en oeuvre de l'extension}
\label{docs/user_manual/plugins/plugins_delimited_text:using-the-plugin}
Pour utiliser l'extension, vous devez d'abord l'activer comme décrit dans la Section {\hyperref[docs/user_manual/plugins/plugins:managing-plugins]{\emph{Gestion des extensions}}}.

Appuyez sur la nouvelle icône apparue dans la barre d'outils \includegraphics[width=1.5em]{delimited_text.png} $^{\text{Ajoutez un fichier de texte sur la couche}}$ pour ouvrir la boîte de dialogue \emph{Texte Délimité} comme montré dans la figure {\hyperref[docs/user_manual/plugins/plugins_delimited_text:figure-delimited-text-1]{figure\_delimited\_text\_1}}.
\phantomsection\label{docs/user_manual/plugins/plugins_delimited_text:figure-delimited-text-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{delimited_text_dialog.png}
\caption{Delimited Text Dialog \includegraphics[width=1em]{nix.png}}\end{figure}

Sélectionnez d'abord le fichier à importer (par exemple, \code{qgis\_sample\_data/csv/elevp.csv}) en appuyant sur le bouton \textbf{{[}Parcourir...{]}}. Une fois le fichier sélectionné, l'extension essaie d'analyser le fichier en utilisant le dernier délimiteur utilisé, dans le cas présent le point-virgule (\code{;}). Afin d'analyser correctement le fichier, il est important de sélectionner le bon délimiteur. Pour changer et utiliser le délimiteur tabulation, utilisez \code{\textbackslash{}t} (c'est l'expression en vigueur pour indiquer le caractère tabulation).

Une fois le fichier analysé, choisissez les champs \code{X} et \code{Y} à l'aide des listes déroulantes si possible vous pouvez aussi choisir le champ WKT pour les informations de projection. Enfin choisissez un nom de couche (par exemple, \code{elevp}) comme montré dans la Figure {\hyperref[docs/user_manual/plugins/plugins_delimited_text:figure-delimited-text-1]{figure\_delimited\_text\_1}}. Pour ajouter la couche à la carte, appuyez sur \textbf{{[}OK{]}}. Le fichier texte délimité se comporte maintenant dans QGIS comme n'importe quelle autre couche de la carte.


\section{Extension Diagramme incrusté}
\label{docs/user_manual/plugins/plugins_diagram_overlay:diagram-overlay-plugin}\label{docs/user_manual/plugins/plugins_diagram_overlay::doc}\label{docs/user_manual/plugins/plugins_diagram_overlay:diagram-overlay}
\includegraphics[width=2em]{diagram.png} L'extension \emph{Diagramme incrusté} permet d'incruster des graphiques sur une couche vectorielle (voir figure {\hyperref[docs/user_manual/plugins/plugins_diagram_overlay:figure-overlay-1]{figure\_overlay\_1}}). Elle ajoute des fonctionnalités à l'onglet \emph{Diagrammes}, décrit au chapitre {\hyperref[docs/user_manual/working_with_vector/vector_properties:sec-diagram]{\emph{Onglet Diagrammes}}}.

Avant de commencer, l'extension \emph{Diagramme incrusté} doit être activé grâce au Gestionnaire d'extension (voir section {\hyperref[docs/user_manual/plugins/plugins:load-core-plugin]{\emph{Activer une extension principale}}}). Il sera alors disponible dans l'onglet \emph{Revêtement} dans les \emph{Propriétés} de la couche, juste après l'onglet \emph{Diagrammes}.
\phantomsection\label{docs/user_manual/plugins/plugins_diagram_overlay:figure-overlay-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{overlay_tab1.png}
\caption{Vector properties dialog with overlay tab \includegraphics[width=1em]{nix.png}}\end{figure}

L'onglet \emph{Revêtement} permet de créer des camemberts, des histogrammes et des symboles SVG proportionnels.

Tout comme pour l'onglet \emph{Diagrammes}, en guise d'exemple, nous allons rajouter des camemberts à la couche sur l'Alaska pour indiquer les données de température depuis une couche de climat. Les deux couches vectorielles sont disponibles dans le jeu de données exemples fournis avec QGIS (voir rubrique {\hyperref[docs/user_manual/introduction/getting_started:label-sampledata]{\emph{Échantillon de données}}}).
\begin{enumerate}
\item {} 
Tout d'abord, cliquez sur le bouton \includegraphics[width=1.5em]{mActionAddOgrLayer.png} $^{\text{Ajouter une couche vecteur}}$, naviguez jusqu'au jeu de données exemples de QGIS et ajouter les deux couches \code{alaska.shp} et \code{climate.shp}.

\item {} 
Double-cliquez sur la couche \code{climate} dans la légende pour ouvrir la fenêtre des \emph{Propriétés}.

\item {} 
Cliquez sur l'onglet \emph{Revêtement}, activez la case \includegraphics{checkbox.png} \emph{Afficher les diagrammes} et choisissez `Diagramme en Camembert' dans la liste déroulante \includegraphics{selectstring.png} \emph{Type de diagramme}.

\item {} 
Nous souhaitons afficher les valeurs des trois colonnes suivantes : \code{T\_F\_JAN}, \code{T\_F\_JUL} and \code{T\_F\_MEAN}. Pour cela, sélectionnez \code{T\_F\_JAN} dansl a liste déroulante des \emph{Attributs} et cliquez sur \textbf{{[}Ajouter{]}}. Faites de même pour \code{T\_F\_JUL} et \code{T\_F\_MEAN}.

\item {} 
La taille du diagramme est proportionnelle à un des attributs. Nous allons choisir \code{T\_F\_JUL} comme référence. Cliquez sur \textbf{{[}Trouver la valeur maximale{]}}. Mettez la \emph{Taille} à \code{20} et la \emph{Taille d'unité} en `Millimètre'.

\item {} 
Cliquez maintenant sur \textbf{{[}Appliquer{]}} pour afficher les diagrammes dans la fenêtre principale de QGIS.

\item {} 
Vous pouvez ajuster la taille du diagramme ou changer les couleurs de chaque attribut en double-cliquant sur la \emph{Color} associée à l'attribut. La figure {\hyperref[docs/user_manual/plugins/plugins_diagram_overlay:figure-overlay-2]{Figure\_overlay\_2}} montre un rendu.

\item {} 
Cliquez enfin sur \textbf{{[}OK{]}}.

\end{enumerate}
\phantomsection\label{docs/user_manual/plugins/plugins_diagram_overlay:figure-overlay-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{overlay_tab2.png}
\caption{Pie chart diagram from temperature data overlayed on a map \includegraphics[width=1em]{nix.png}}\end{figure}

Il est possible de choisir l'algorithme de placement des diagrammes en choisissant l'onglet \code{Revêtement} dans le menu \emph{Préférences -\textgreater{} Options}. La méthode par défaut est le placement au `Point central', les autres méthodes utilisent les algorithmes de la librairie PAL. Il faut noter que les diagrammes et les étiquettes sont dessinées dans des couches différentes.


\section{Extension Convertisseur Dxf2Shp}
\label{docs/user_manual/plugins/plugins_dxf2shape_converter:dxf2shp-converter-plugin}\label{docs/user_manual/plugins/plugins_dxf2shape_converter:dxf2shape}\label{docs/user_manual/plugins/plugins_dxf2shape_converter::doc}
L'extension Convertisseur Dxf2Shape permet de convertir des données vectorielles du format DXF au format shapefile (SHP). Avant d'être exécutée, elle requiert les réglages suivants:
\phantomsection\label{docs/user_manual/plugins/plugins_dxf2shape_converter:figure-dxf2shape-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{dxf2shape_dialog.png}
\caption{Dxf2Shape Converter Plugin}\end{figure}
\begin{itemize}
\item {} 
\textbf{Fichier DXF en entrée} : Entrer la localisation du fichier DXF à convertir

\item {} 
\textbf{Fichier SHP en sortie} : Entrer le nom souhaité du fichier shape à créer

\item {} 
\textbf{Type de fichier de sortie} : Spécifier le type géométrique du shapefile créé. Les formats implémentés pour le moment sont point, polyligne et polygone.

\item {} 
\textbf{Exporter les étiquettes} : Si cette case est cochée, une couche supplémentaire shapefile de type point sera créée et la table dbf associée contiendra des informations à propos des champs ``TEXT'' trouvés dans le fichier dxf ainsi que les chaînes de caractères elles-mêmes.

\end{itemize}


\subsection{Mettre en œuvre l'extension}
\label{docs/user_manual/plugins/plugins_dxf2shape_converter:using-the-plugin}\begin{enumerate}
\item {} 
Démarrez QGIS, chargez l'extension Dxf2Shape dans le gestionnaire d'extensions (voir la Section {\hyperref[docs/user_manual/plugins/plugins:load-core-plugin]{\emph{Activer une extension principale}}}) puis appuyez sur le bouton \includegraphics[width=1.5em]{dxf2shp_converter.png} $^{\text{Convertisseur Dxf2Shape}}$ qui apparaît dans la barre d'outils QGIS. La boîte de dialogue de l'extension Dxf2Shape apparaît alors comme montrée dans la Figure {\hyperref[docs/user_manual/plugins/plugins_dxf2shape_converter:figure-dxf2shape-1]{Figure\_dxf2shape\_1}}.

\item {} 
Entrez la localisation du fichier DXF ainsi qu'un nom et un type pour le shapefile à créer.

\item {} 
Cochez la case \includegraphics{checkbox.png} \emph{Exporter les étiquettes} si vous souhaitez créer une couche point supplémentaire contenant les étiquettes.

\item {} 
Appuyez sur \textbf{{[}Ok{]}}.

\end{enumerate}


\section{Extension eVis}
\label{docs/user_manual/plugins/plugins_evis:evis-plugin}\label{docs/user_manual/plugins/plugins_evis:evis}\label{docs/user_manual/plugins/plugins_evis::doc}
Le laboratoire Biodiversity Informatics du Centre pour la Conservation et la Biodiversité (CBC) du Musée américain d'Histoire Naturelle (AMNH) (Cette partie est tirée du Guide eVis (v1.1.0) Horning, N., K. Koy, P. Ersts. 2009.  American Museum of Natural History, Center for Biodiversity and Conservation. Disponible à \href{http://biodiversityinformatics.amnh.org}{http://biodiversityinformatics.amnh.org}, publié sous la licence GNU FDL.) a développé l'outil de visualisation des évènements (eVis) qui fait partit d'une suite logicielle destinée à la gestion et la surveillance des zones naturelles protégées. Cette extension permet à un utilisateur de lier facilement des photographies géocodées (c-à-d avec des coordonnées lat/long ou X/Y renseignées) et d'autres types de documents à des données vectorielles dans QGIS.

eVis est dorénavant installée automatiquement dans les nouvelles versions de QGIS, et comme toutes autres extensions, elle peut être activée ou désactivée dans le Gestionnaire d'extensions (voir section {\hyperref[docs/user_manual/plugins/plugins:managing-plugins]{\emph{Gestion des extensions}}}).

L'extension consiste en 3 modules : l'outil de `Connexion à une base de données', l'outil `ID d'évènements' et le `Navigateur d'évènement'. Ils fonctionnent ensemble pour permettre l'affichage de documents géoéréfrencés qui sont liés à des entités enregistrées dans des fichiers vectoriels, des bases de données ou des feuilles de tableur.


\subsection{Navigateur d'évènement}
\label{docs/user_manual/plugins/plugins_evis:evis-browser}\label{docs/user_manual/plugins/plugins_evis:event-browser}
Le navigateur d'évènement fournit la capacité d'afficher des photographies ayant un lien avec les entités vecteurs affichées dans la fenêtre principale de QGIS. Ces entités doivent avoir des informations attributaires associées décrivant l'emplacement et le nom du fichier contenant la photographie et, optionnellement, la direction vers laquelle était pointé l'objectif lors de la prise de vue. Votre couche vectorielle doit être chargée dans QGIS avant le lancement du navigateur d'évènements.


\subsubsection{Afficher le navigateur d'évènement}
\label{docs/user_manual/plugins/plugins_evis:launch-the-event-browser-module}\label{docs/user_manual/plugins/plugins_evis:evis-launch-browser}
Pour lancer le navigateur d'évènement, vous pouvez soit cliquer sur le bouton \includegraphics[width=1.5em]{event_browser.png} $^{\text{eVis Navigateur d'évènement}}$ ou bien cliquer sur le menu \emph{Base de données \textgreater{} eVis \textgreater{} Navigateur d'évènement eVis}.

La fenêtre de \emph{navigateur} affiche 3 onglets dans sa partie supérieure. L'onglet \emph{affiché} est utilisé pour voir la photographie et les données attributaires correspondantes. L'onglet des \emph{options} fournit une série de paramètres qui peuvent être ajustés pour contrôler le comportement de l'extension eVis. Enfin, l'onglet de \emph{configurer les applications externes} contient une table des extensions de fichiers et des applications qui leur sont associées pour permettre à eVis d'afficher des documents autre qu'une image.


\subsubsection{La fenêtre Affiché}
\label{docs/user_manual/plugins/plugins_evis:evis-display-window}\label{docs/user_manual/plugins/plugins_evis:understanding-the-display-window}
Pour voir la fenêtre \emph{Affiché}, cliquez sur l'onglet \emph{Affiché} du navigateur d'évènement. Cette fenêtre est utilisée pour regarder les photographies et leurs données attributaires.
\phantomsection\label{docs/user_manual/plugins/plugins_evis:figure-evis-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{evisdisplay.png}
\caption{The \emph{eVis} display window \includegraphics[width=1em]{win.png}}\end{figure}
\begin{enumerate}
\item {} 
\textbf{Zone d'affichage} : emplacement où s'affichera l'image.

\item {} 
Bouton \textbf{Zoom +} : Zoomez pour voir plus de détails. Si l'image ne peut être affichée entièrement dans la fenêtre, des barres de défilement apparaîtront sur les bords gauches et inférieures pour que vous puissiez bouger l'image.

\item {} 
Bouton \textbf{Zoom -} : Zoomez en arrière pour avoir une vue d'ensemble.

\item {} 
Bouton \textbf{Zoomer sur l'emprise} : Affiche l'emprise maximale de la photographie.

\item {} 
\textbf{Zone d'informations} : Toutes les informations attributaires pour le point associé à la photographie sélectionnée sont affichées ici. Si le type de fichier référencé n'est pas une image, mais d'un type renseigné dans l'onglet \emph{configurer les applications externes} (il sera alors affiché en vert), un double clic lancera l'application désignée.

\item {} 
\textbf{Boutons de navigation} : Utilisez les boutons \textbf{{[}Suivant{]}} et \textbf{{[}Précédent{]}} pour charger une autre entité lorsque plusieurs sont sélectionnées.

\item {} 
\textbf{Indicateur d'entité} : Cet entête indique quelle entité est affichée et combien d'entités sont disponibles pour l'affichage.

\end{enumerate}


\subsubsection{La fenêtre Options}
\label{docs/user_manual/plugins/plugins_evis:understanding-the-options-window}\label{docs/user_manual/plugins/plugins_evis:evis-options-window}\phantomsection\label{docs/user_manual/plugins/plugins_evis:figure-evis-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{evisoptions.png}
\caption{The \emph{eVis} Options window \includegraphics[width=1em]{win.png}}\end{figure}
\begin{enumerate}
\item {} 
\textbf{Chemin du fichier} : Une liste déroulante permet de spécifier quel est l'attribut contenant le chemin d'accès vers le document devant être affiché. Si l'emplacement est un chemin relatif alors la boîte à cocher juste en dessous doit être activée. Le chemin de base peut être saisi dans la zone de texte. Les informations à propos des différentes options pour indiquer le chemin sont expliquées dans une section suivante.

\item {} 
\textbf{Attribut contenant le compas} : Une liste déroulante permet de spécifier le champ contenant les informations sur l'orientation de la photographie affichée. Si cette information est disponible, il est indispensable de cliquer sur la boîte à cocher située à gauche de la liste.

\item {} 
\textbf{Décalage du compas} : Ce décalage peut être utilisé pour compenser une déclinaison (pour passer du nord magnétique au nord géographique) Cliquez sur le bouton \includegraphics{radiobuttonon.png} \emph{Manuel} pour le saisir ou cliquez sur \includegraphics{radiobuttonon.png} \emph{Depuis l'Attribut} pour sélectionner le champ attributaire contenant cette indication. Dans les 2 cas, la déclinaison Est doit être une valeur positive tandis que la déclinaison Ouest doit être négative.

\item {} 
\textbf{Chemin de base} : C'est le chemin à partir duquel le chemin relatif (A) définit dans la figure {\hyperref[docs/user_manual/plugins/plugins_evis:figure-evis-2]{Figure\_eVis\_2}} sera établi.

\item {} 
\textbf{Remplacer le chemin} : Si cette case est cochée alors seul le nom du fichier sera ajouté au chemin de base.

\item {} 
\textbf{Appliquer la règle à tous les documents} : Si cochée, la règle définie pour les photographies sera utilisée pour les autres documents tels que les vidéos et les fichiers audio. Dans le cas contraire, les règles s'appliqueront seulement aux photographies.

\item {} 
\textbf{Se souvenir de} : Si cette case est cochée, les valeurs des paramètres correspondants seront enregistrées pour la prochaine session.

\item {} 
\textbf{Réinitialiser} : Remet les valeurs par défaut pour ce paramètre.

\item {} 
\textbf{Restorer les valeurs par défaut} : Réinitialise tous les paramètres à leur valeur par défaut.

\item {} 
\textbf{Enregistrer} : Ceci enregistrera les valeurs sans fermer l'onglet des \emph{options}.

\end{enumerate}


\subsubsection{La fenêtre Configurer les applications externes}
\label{docs/user_manual/plugins/plugins_evis:evis-external-window}\label{docs/user_manual/plugins/plugins_evis:understanding-the-configure-external-applications-window}\phantomsection\label{docs/user_manual/plugins/plugins_evis:figure-evis-3}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{evisexternal.png}
\caption{The \emph{eVis} External Applications window \includegraphics[width=1em]{win.png}}\end{figure}
\begin{enumerate}
\item {} 
\textbf{Tableau des références} : Une table contient tous les types de fichiers qui peuvent être ouverts par eVis. Chaque type de fichier doit avoir une extension qui lui est propre et un chemin vers une application pour l'ouvrir. Ce la permet d'utiliser un large éventail de documents autre que des images.

\item {} 
\textbf{Ajouter un nouveau type de fichier} : Ajoute un nouveau type de fichier avec son extension et une application dédiée.

\item {} 
\textbf{Effacer la cellule courante} : Effacer le type de fichier sélectionné dans la table.

\end{enumerate}


\subsection{Spécifier un emplacement et le nom d'une photographie}
\label{docs/user_manual/plugins/plugins_evis:evis-specifying}\label{docs/user_manual/plugins/plugins_evis:specifying-the-location-and-name-of-a-photograph}
Le nom et l'emplacement d'une photographie peuvent être enregistrés avec un chemin absolu ou relatif ou une URL si l'image se trouve sur un serveur Internet. Des exemples de ces différentes approches sont listés dans la table {\hyperref[docs/user_manual/plugins/plugins_evis:evis-examples]{evis\_examples}}.
\phantomsection\label{docs/user_manual/plugins/plugins_evis:evis-examples}
\begin{Verbatim}[commandchars=\\\{\}]
X        Y        FILE                                                  BEARING
780596   1784017  C:\PYGZbs{}Workshop\PYGZbs{}eVis\_Data\PYGZbs{}groundphotos\PYGZbs{}DSC\_0168.JPG       275
780596   1784017  /groundphotos/DSC\_0169.JPG                            80
780819   1784015  http://biodiversityinform.org/testdata/DSC\_0170.JPG   10
780596   1784017  pdf:http://www.test.com/attach.php?attachment\_id-12   76
\end{Verbatim}


\subsection{Spécifier l'emplacement et le nom d'un document autre qu'une image}
\label{docs/user_manual/plugins/plugins_evis:evis-location}\label{docs/user_manual/plugins/plugins_evis:specifying-the-location-and-name-of-other-supporting-documents}
Les documents texte, vidéos ou audio peuvent aussi être affichés par eVis. Pour ce faire, il est nécessaire d'ajouter une entrée dans la table des références fichiers qui pourra être utilisé par l'une des \emph{applications externes} définies. Il est aussi nécessaire d'avoir le chemin vers le fichier dans la table attributaire de la couche vectorielle. Une possibilité supplémentaire est de spécifier l'extension du fichier avant le chemin (par exemple avi:/chemin/du/fichier), ce qui est très utile pour accéder à des documents placés sur des sites ou des wiki utilisant une base de données pour la gestion de leurs pages (voir la table {\hyperref[docs/user_manual/plugins/plugins_evis:evis-examples]{evis\_examples}}).


\subsection{Utilisation du Navigateur d'évènement}
\label{docs/user_manual/plugins/plugins_evis:using-the-generic-event-browser}\label{docs/user_manual/plugins/plugins_evis:evis-using-browser}
Quand la fenêtre du \emph{navigateur d'évènement} s'ouvre, une photographie apparaîtra dans l'onglet d'affichage si le document référencé dans la table attributaire du fichier vectoriel est une image et que les paramètres d'emplacement sont correctement renseignés. Si la photographie voulue n'apparaît pas, c'est qu'il vous est nécessaire d'ajuster les paramètres de l'onglet des \emph{options}.

Si un document supporté (ou une image n'ayant pas d'extension reconnue par eVis) est référencé dans la table attributaire, le champ contenant le chemin vers le fichier sera surligné en vert dans la liste des références fichiers si cette extension a été définie dans la table de configuration des guilabel:\emph{applications externes}. Pour l'ouvrir, faites un double-clic sur la ligne en vert. Si un document est référencé, mais nonsurligné en vert, il est nécessaire d'ajouter une entrée pour son extension. Si le chemin est bien surligné en vert, mais qu'un double-clic reste sans effet, il faudra alors vérifier que l'application associée à l'extension est bien renseignée.

Si aucune indication de compas n'est fournie dans les \emph{options}, un astérisque rouge sera affiché au-dessus de l'entité vectorielle concernée par l'image affichée. Si cette indication est disponible alors une flèche pointant la direction de l'objectif apparaîtra. La flèche sera centrée sur le point associé à la photographie ou au document.

Pour fermer ce \emph{navigateur}, cliquez sur le bouton \textbf{{[}Fermer{]}} de l'onglet d'\emph{affiché}.


\subsection{Outil ID évènement}
\label{docs/user_manual/plugins/plugins_evis:evis-id-tool}\label{docs/user_manual/plugins/plugins_evis:event-id-tool}
L'outil `Id évènement' permet d'afficher une photographie en cliquant sur l'entité affichée dans la fenêtre de QGIS. La couche vectorielle doit avoir des attributs associés indiquant l'emplacement, le nom du fichier et l'indication de compas si nécessaire. Cette couche doit être chargée avant d'utiliser cet outil.


\subsubsection{Lancement du module Id évènement}
\label{docs/user_manual/plugins/plugins_evis:launch-the-event-id-module}\label{docs/user_manual/plugins/plugins_evis:evis-launch-id}
Pour executer cet outil, cliquez sur le bouton \includegraphics[width=1.5em]{event_id.png} $^{\text{Event ID}}$ ou bien sur le menu \emph{Bases de données \textgreater{} eVis -\textgreater{} Outil ID Evènement}. Cela provoquera le changement du curseur en une flèche avec un `i' à son sommet signifiant que l'outil ID est actif.

Pour visonner les photographies liées aux entitées de la couche vectorielle active, déplacez le curseur sur l'une d'elles et faites un clic. La fenêtre du \emph{navigateur d'évènement} s'ouvre alors en affichant la photographie du point ou proche. Si plus d'une est disponible, vous pouvez faire défiler les différentes entités avec les boutons \textbf{Suivant} et \textbf{Précédent}. Les autres boutons sont décrits dans la section {\hyperref[docs/user_manual/plugins/plugins_evis:evis-browser]{\emph{Navigateur d'évènement}}} de ce manuel.


\subsection{Connexion à une base de données}
\label{docs/user_manual/plugins/plugins_evis:database-connection}\label{docs/user_manual/plugins/plugins_evis:evis-database}
Cet outil permet de se connecter et d'interroger une base de données ou une ressource ODBC telle qu'un tableur.

eVis peut directement se connecter à 4 types de bases : Microsoft Access, PostgreSQL, MySQL, SQLITE. Il est possible de lire une connexion ODBC telle qu'une feuille Excel, dans ce cas il faut configurer cette connexion via votre système d'exploitation.


\subsubsection{L'outil de connexion à une base de données}
\label{docs/user_manual/plugins/plugins_evis:launch-the-database-connection-module}\label{docs/user_manual/plugins/plugins_evis:evis-launch-database}
Cliquez sur le bouton \includegraphics[width=1.5em]{evis_connect.png} $^{\text{Connection à une base de données}}$ ou sur le menu \emph{Bases de données -\textgreater{} eVis -\textgreater{} connexion à une base de données}. Cela ouvrira une fenêtre avec 3 onglets : \emph{Requêtes prédéfinies}, \emph{Connexion à une base}, et \emph{Requête SQL}. La \emph{console de sortie} en bas de la fenêtre affiche le statut des actions initialisées par les différentes sections de cet outil.


\subsubsection{Se connecter à une base}
\label{docs/user_manual/plugins/plugins_evis:connect-to-a-database}\label{docs/user_manual/plugins/plugins_evis:evis-connect-database}
Cliquez sur l'onglet \emph{Connexion à une base} puis sur le menu déroulant \emph{Type de la base de données} pour sélectionner \includegraphics{selectstring.png} le type de base à laquelle vous voulez vous connecter. Vous pouvez saisir un \emph{nom d'utilisateur} et un \emph{mot de passe} si nécessaire.

Entrez le nom de l'\emph{hôte de la base}, cette option n'est pas disponible si vous avez sélectionné ``MS Access'' comme type. Si la base de données est sur votre ordinateur, vous devrez saisir ``localhost''.

Entrez le  \emph{nom de la base} dans la zone de saisie correspondante. Si vous avez sélectionné ``ODBC'' comme type de base, vous devrez indiquer le nom de la source de données.

Quand tous les paramètres sont corrects, cliquez sur le bouton \textbf{{[}Connecter{]}}. Si la connexion est réussie, un message sera écrit dans la \emph{console de sortie}. En cas d'échec, il vous faudra vérifier les paramètres.
\phantomsection\label{docs/user_manual/plugins/plugins_evis:figure-evis-4}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{evisdatabase.png}
\caption{The \emph{eVis} Database connection window \includegraphics[width=1em]{win.png}}\end{figure}
\begin{enumerate}
\item {} 
\textbf{Type de base de données} : Une liste déroulante pour spécifier le type de base utilisée.

\item {} 
\textbf{Hôte de la base de données} : le nom de l'hôte de la base.

\item {} 
\textbf{Port} : Le chiffre du port dans le cas d'une base MYSQL.

\item {} 
\textbf{Nom de la base de données} : Le nom de la base de données.

\item {} 
\textbf{Connecter} : Ce bouton établit la connexion avec les paramètres définis.

\item {} 
\textbf{Console de sortie} : Console où sont affichés les messages relatifs au déroulement de la connexion.

\item {} 
\textbf{Nom d'utilisateur} : Nécessaire quand la base est protégée en accès.

\item {} 
{\color{red}\bfseries{}**}Mot de passe {\color{red}\bfseries{}**}: Nécessaire quand la base est protégée en accès.

\item {} 
\textbf{Requêtes Prédéfinies} : Onglet ouvrant la fenêtre de Requêtes Prédéfinies.

\item {} 
\textbf{Connexion à une base de données} : Onglet ouvrant la fenêtre de Connexion à une base de données.

\item {} 
\textbf{Requête SQL} : Onglet ouvrant la fenêtre de Requête SQL.

\item {} 
\textbf{Aide} : Affiche l'aide en ligne.

\item {} 
\textbf{OK} : Ferme la fenêtre Connexion à une base de données.

\end{enumerate}


\subsubsection{Faire une requête SQL}
\label{docs/user_manual/plugins/plugins_evis:running-sql-queries}\label{docs/user_manual/plugins/plugins_evis:evis-running-sql}
Les requêtes SQL sont utilisées pour extraire des informations depuis une base de données ou unesource ODBC. Dans eVis, le résultat de ces requêtes est une couche vectorielle ajoutée à QGIS. cliquez sur l'onglet \emph{Requête SQL} pour afficher l'interface. Les commandes SQL peuvent être saisies depuis cette fenêtre de texte. Un tutoriel bien pratique sur les commandes SQl est disponible à \href{http://www.w3schools.com/sql}{http://www.w3schools.com/sql}. Par exemple, pour extraire toutes les données d'un fichier Excel, faites \code{select * from {[}sheet1\${]}} où \code{sheet1} est le nom de la feuille concernée.

Cliquez sur le bouton \textbf{{[}Exécuter la requête{]}} pour exécuter la commande. Si la requête est fructueuse, une \emph{fenêtre de sélection} sera affichée. Dans le cas contraire, un message d'erreur apparaîtra dans la \emph{console de sortie}.

Dans cette nouvelle fenêtre, entrez le nom de la couche qui sera créée à partir des résultats dans la zone de texte \emph{Nom de la Nouvelle Couche}.
\phantomsection\label{docs/user_manual/plugins/plugins_evis:figure-evis-5}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{evissql_query.png}
\caption{The eVis SQL query tab \includegraphics[width=1em]{win.png}}\end{figure}
\begin{enumerate}
\item {} 
\textbf{Zone de texte de requête SQL} : Une zone poursaisir vos requêtes.

\item {} 
\textbf{Exécuter la requête} : Ce bouton exécute la requête écrite.

\item {} 
\textbf{Console} : Console où sont affichés les messages relatifs au déroulement de la connexion.

\item {} 
\textbf{Aide} : Affiche l'aide en ligne.

\item {} 
\textbf{OK} : Ferme la fenêtre \emph{Connexion à une base de données}.

\end{enumerate}

Utilisez les menus déroulants \emph{Coordonnée X} et \emph{Coordonnée Y} pour choisir les champs stockant les coordonnées en X  (ou longitude) et Y  (ou latitude). Cliquez sur \textbf{{[}Ok{]}} pour créer la couche vectorielle qui sera affichée sur la carte de QGIS.

Pour enregistrer ce fichier pour une utilisation ultérieure, vous pouvez utiliser la fonction de QGIS `Sauvegarder sous' accessible via un clic droit sur la couche listée dans la zone de légende

\begin{notice}{tip}{Astuce:}
\textbf{Créer une couche vectorielle depuis un fichier Microsoft Excel}

Lorsque vous créer une couche vectorielle depuis un fichier Excel, vous risquez peut être de voir des zéros (``0'') insérés dans les lignes de la table attributaire à l a suite de données valides. Cela peut être résolu par l'utilisation de la touche \code{Retour arrière} dans une cellule. Pour cela, vous devez ouvrir le fichier (après avoir fermé QGIS si vous y êtes connecté) et utiliser le menu \emph{Édition \textgreater{} Effacer le contenu} pour supprimer les espaces blancs.
\end{notice}


\subsubsection{Exécuter des requête prédéfinies}
\label{docs/user_manual/plugins/plugins_evis:running-predefined-queries}\label{docs/user_manual/plugins/plugins_evis:evis-predefined}
Avec les requêtes prédéfinies, vous pouvez sélectionner des requêtes déjà écrites et stockées au format XML. Cela peut être utile si vous n'êtes pas familier avec les commandes SQL. Cliquez sur l'onglet \emph{Requêtes prédéfinies} pour afficher l'interface.

Pour charger un jeu de requêtes prédéfinies, cliquez sur le bouton \includegraphics[width=1.5em]{evis_file.png} $^{\text{Ouvrir}}$. Une fenêtre s'ouvre pour sélectionner le fichier. Lorsque les requêtes sont chargées, leurs titres définis au format XML apparaîtront dans le menu déroulant situé en dessous du bouton \includegraphics[width=1.5em]{evis_file.png} $^{\text{Ouvrir}}$, la description complète de la requête est affichée dans la zone en dessous de la liste.

Sélectionnez la requête que vous voulez exécuter depuis la liste déroulante et ensuite cliquez sur l'onglet de \emph{requête SQL} pour observer la requête qui vient d'être chargée. Si c'est la première fois que vous exécutez une requête prédéfinie ou que vous changez de base de travail, vous devrez vous connecter à la base de données.

Cliquez sur le bouton \textbf{{[}Exécuter la requête{]}} dans l'onglet \emph{Requête SQL} pour lancer la commande. Si la requête est fructueuse, une fenêtre de sélection sera affichée. Dans le cas contraire, un message d'erreur apparaîtra dans la \emph{console de sortie}.
\phantomsection\label{docs/user_manual/plugins/plugins_evis:figure-evis-6}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{evispredefined.png}
\caption{The \emph{eVis} Predefined queries tab \includegraphics[width=1em]{win.png}}\end{figure}
\begin{enumerate}
\item {} 
\textbf{Ouvrir le fichier} : Lance un explorateur de fichier pour sélectionner le fichier contenant les requêtes au format XML.

\item {} 
\textbf{Requêtes prédéfinies} : Une liste déroulante affichant toutes les requêtes prédéfinies dans le fichier XML.

\item {} 
\textbf{Description de la requête} : Une courte description de la requête.

\item {} 
\textbf{Console} : Console où sont affichés les messages relatifs au déroulement de la connexion.

\item {} 
\textbf{Aide} : Affiche l'aide en ligne.

\item {} 
\textbf{OK} : Ferme la fenêtre principale.

\end{enumerate}
\phantomsection\label{docs/user_manual/plugins/plugins_evis:evis-xml-tags}

\subsubsection{Le format XML pour les requêtes d'eVis}
\label{docs/user_manual/plugins/plugins_evis:evis-xml-tags}\label{docs/user_manual/plugins/plugins_evis:evis-xml-format}\label{docs/user_manual/plugins/plugins_evis:xml-format-for-evis-predefined-queries}
Les balises XML reconnues par eVis

\begin{tabulary}{\linewidth}{|L|L|}
\hline
\textsf{\relax 
Balise
} & \textsf{\relax 
Description
}\\
\hline
query
 & 
Définit le début et la fin d'une requête.
\\

shortdescription
 & 
Une courte description qui apparaît dans le menu déroulant.
\\

description
 & 
Une description plus détaillée.
\\

databasetype
 & 
Le type de base de données tel que définit dans la liste déroulante dans l'onglet de connexion.
\\

databaseport
 & 
Le port tel que définit dans la liste déroulante dans l'onglet de connexion.
\\

databasename
 & 
Le nom de la base de données tel que définit dans la liste déroulante dans l'onglet de connexion.
\\

databaseusername
 & 
Le nom d'utilisateur tel que définit dans la liste déroulante dans l'onglet de connexion.
\\

databasepassword
 & 
Le mot de passe tel que définit dans la liste déroulante dans l'onglet de connexion.
\\

sqlstatement
 & 
La commande SQL.
\\

autoconnect
 & 
Un interrupteur (``vrai'' or ``faux'') pour spécifier si les balises précédentes doivent être utilisées pour se connecter automatiquement à une base de données sans passer par les routines de connexion de l'onglet.
\\
\hline\end{tabulary}


Voici un exemple complet avec 3 requêtes:

\begin{Verbatim}[commandchars=\\\{\}]
\textless{}?xml version="1.0"?\textgreater{}
\textless{}doc\textgreater{}
 \textless{}query\textgreater{}
   \textless{}shortdescription\textgreater{}Import all photograph points\textless{}/shortdescription\textgreater{}
   \textless{}description\textgreater{}This command will import all of the data in the SQLite database to QGIS
      \textless{}/description\textgreater{}
   \textless{}databasetype\textgreater{}SQLITE\textless{}/databasetype\textgreater{}
   \textless{}databasehost /\textgreater{}
   \textless{}databaseport /\textgreater{}
   \textless{}databasename\textgreater{}C:\PYGZbs{}textbackslash Workshop/textbackslash
eVis\PYGZbs{}\_Data\PYGZbs{}textbackslash PhotoPoints.db\textless{}/databasename\textgreater{}
   \textless{}databaseusername /\textgreater{}
   \textless{}databasepassword /\textgreater{}
   \textless{}sqlstatement\textgreater{}SELECT Attributes.*, Points.x, Points.y FROM Attributes LEFT JOIN
      Points ON Points.rec\_id=Attributes.point\_ID\textless{}/sqlstatement\textgreater{}
   \textless{}autoconnect\textgreater{}false\textless{}/autoconnect\textgreater{}
 \textless{}/query\textgreater{}
  \textless{}query\textgreater{}
   \textless{}shortdescription\textgreater{}Import photograph points "looking across Valley"\textless{}/shortdescription\textgreater{}
   \textless{}description\textgreater{}This command will import only points that have photographs "looking across
      a valley" to QGIS\textless{}/description\textgreater{}
   \textless{}databasetype\textgreater{}SQLITE\textless{}/databasetype\textgreater{}
   \textless{}databasehost /\textgreater{}
   \textless{}databaseport /\textgreater{}
   \textless{}databasename\textgreater{}C:\PYGZbs{}Workshop\PYGZbs{}eVis\_Data\PYGZbs{}PhotoPoints.db\textless{}/databasename\textgreater{}
   \textless{}databaseusername /\textgreater{}
   \textless{}databasepassword /\textgreater{}
   \textless{}sqlstatement\textgreater{}SELECT Attributes.*, Points.x, Points.y FROM Attributes LEFT JOIN
      Points ON Points.rec\_id=Attributes.point\_ID where COMMENTS='Looking across
      valley'\textless{}/sqlstatement\textgreater{}
   \textless{}autoconnect\textgreater{}false\textless{}/autoconnect\textgreater{}
 \textless{}/query\textgreater{}
 \textless{}query\textgreater{}
   \textless{}shortdescription\textgreater{}Import photograph points that mention "limestone"\textless{}/shortdescription\textgreater{}
   \textless{}description\textgreater{}This command will import only points that have photographs that mention
      "limestone" to QGIS\textless{}/description\textgreater{}
   \textless{}databasetype\textgreater{}SQLITE\textless{}/databasetype\textgreater{}
   \textless{}databasehost /\textgreater{}
   \textless{}databaseport /\textgreater{}
   \textless{}databasename\textgreater{}C:\PYGZbs{}Workshop\PYGZbs{}eVis\_Data\PYGZbs{}PhotoPoints.db\textless{}/databasename\textgreater{}
   \textless{}databaseusername /\textgreater{}
   \textless{}databasepassword /\textgreater{}
   \textless{}sqlstatement\textgreater{}SELECT Attributes.*, Points.x, Points.y FROM Attributes LEFT JOIN
      Points ON Points.rec\_id=Attributes.point\_ID where COMMENTS like '\%limestone\%'
      \textless{}/sqlstatement\textgreater{}
   \textless{}autoconnect\textgreater{}false\textless{}/autoconnect\textgreater{}
 \textless{}/query\textgreater{}
\textless{}/doc\textgreater{}
\end{Verbatim}


\section{Extension fTools}
\label{docs/user_manual/plugins/plugins_ftools:ftools-plugin}\label{docs/user_manual/plugins/plugins_ftools:ftools}\label{docs/user_manual/plugins/plugins_ftools::doc}
Le but de l'extension Python fTools est de fournir un outil unique pour un certain nombre de traitements SIG vectoriels, sans avoir recours à des logiciels, des bibliothèques ou des constructions complexes supplémentaires. Elle fournit un ensemble grandissant de fonctions de gestion et d'analyse des données spatiales qui sont à la fois rapides et fonctionnelles.

fTools est maintenant installé automatiquement et disponible dans les dernières versions de QGIS et, comme toutes les extensions, peut être activé et désactivé via le Gestionnaire d'extensions (voir Section {\hyperref[docs/user_manual/plugins/plugins:load-core-plugin]{\emph{Activer une extension principale}}}). Lorsqu'elle est activée, l'extension fTools ajoute une entrée au menu \emph{Vecteur} de QGIS, et propose des outils d'Analyse et de Recherche, de Géométrie et de Géotraitement ainsi que de Gestion des données.
\phantomsection\label{docs/user_manual/plugins/plugins_ftools:ftools-function}
\index{Outils d'analyse}

\subsection{Outils d'analyse}
\label{docs/user_manual/plugins/plugins_ftools:analysis-tools}\label{docs/user_manual/plugins/plugins_ftools:index-0}\label{docs/user_manual/plugins/plugins_ftools:table-ftools-1}
\begin{tabulary}{\linewidth}{|L|L|L|}
\hline
\textsf{\relax 
\textbf{Bouton}
} & \textsf{\relax 
\textbf{Outil}
} & \textsf{\relax 
\textbf{Fonction}
}\\
\hline
\includegraphics[width=1.5em]{matrix.png}
 & 
Matrice des distances
 & 
Mesure les distances entre deux couches de points et renvoie les résultats sous la forme de a) Matrice de distance standard, b) Matrice des distances en ligne, ou c) Résumé des distances (moyenne, min, max, écart type). Il est possible de limiter les distances aux k entités les plus proches.
\\

\includegraphics[width=1.5em]{sum_lines.png}
 & 
Total des longueurs de lignes
 & 
Calcule la somme totale des longueurs de lignes présentes dans chaque entité d'une couche de polygones.
\\

\includegraphics[width=1.5em]{sum_points.png}
 & 
Points dans un polygone
 & 
Compte le nombre de points inclus dans chaque entité d'une couche de polygones.
\\

\includegraphics[width=1.5em]{unique.png}
 & 
Liste les valeurs uniques
 & 
Liste toutes les valeurs uniques d'un champ d'une couche vecteur
\\

\includegraphics[width=1.5em]{basic_statistics.png}
 & 
Statistiques basiques
 & 
Calcule des statistiques de base (moyenne, écart type, max, min, nombre, somme, CV) sur un champ donné.
\\

\includegraphics[width=1.5em]{neighbour.png}
 & 
Analyse du plus proche voisin
 & 
Calcule des statistiques sur le plus proche voisin pour évaluer le niveau de clustering dans une couche vecteur de points
\\

\includegraphics[width=1.5em]{mean.png}
 & 
Coordonnée(s) moyenne(s)
 & 
Calcule le centre moyen normal ou pondéré soit d'une couche vecteur entière, soit des entités partageant un même identifiant.
\\

\includegraphics[width=1.5em]{intersections.png}
 & 
Intersections de lignes
 & 
Localise les intersections entre lignes et renvoie les résultats sous la forme d'un shapefile de points. Utile pour localiser les croisements de route ou de rivières. Ignore les intersections de ligne d'une longueur supérieure à zéro.
\\
\hline\end{tabulary}


Table fTools 1 : Outils d'analyse fTools

\index{Outils de recherche}

\subsection{Outils de recherche}
\label{docs/user_manual/plugins/plugins_ftools:index-1}\label{docs/user_manual/plugins/plugins_ftools:research-tools}
\begin{tabulary}{\linewidth}{|L|L|L|}
\hline
\textsf{\relax 
\textbf{Bouton}
} & \textsf{\relax 
\textbf{Outil}
} & \textsf{\relax 
\textbf{Fonction}
}\\
\hline
\includegraphics[width=1.5em]{random_selection.png}
 & 
Sélection aléatoire
 & 
Sélectionne aléatoirement un nombre ou un pourcentage n d'entités
\\

\includegraphics[width=1.5em]{sub_selection.png}
 & 
Sélectionne aléatoirement des entités au sein de sous-ensemble
 & 
Sélectionne aléatoirement des entités au sein d'un sous-ensemble défini par un champ identifiant.
\\

\includegraphics[width=1.5em]{random_points.png}
 & 
Points aléatoires
 & 
Génère des points pseudo-aléatoires sur une couche de données.
\\

\includegraphics[width=1.5em]{regular_points.png}
 & 
Points réguliers
 & 
Génère une grille régulière de points sur une zone spécifiée et les exporte dans un shapefile de points.
\\

\includegraphics[width=1.5em]{vector_grid.png}
 & 
Grille vecteur
 & 
Génère une grille formée par des lignes ou des polygones à partir d'un espacement défini par l'utilisateur.
\\

\includegraphics[width=1.5em]{select_location.png}
 & 
Sélection par localisation
 & 
Sélectionne des entités en fonction de leur localisation par rapport à une autre couche puis crée une nouvelle sélection, ajoute ou retire de la sélection courante.
\\

\includegraphics[width=1.5em]{layer_extent.png}
 & 
Créer un polygone à partir de l'étendue de la couche
 & 
Crée une couche polygone contenant un unique rectangle couvrant l'étendue d'une couche raster ou vecteur.
\\
\hline\end{tabulary}


Table fTools 2: Outils de recherche fTools


\subsection{Outils de géotraitement}
\label{docs/user_manual/plugins/plugins_ftools:geoprocessing-tools}
\begin{tabulary}{\linewidth}{|L|L|L|}
\hline
\textsf{\relax 
\textbf{Bouton}
} & \textsf{\relax 
\textbf{Outil}
} & \textsf{\relax 
\textbf{Fonction}
}\\
\hline
\includegraphics[width=1.5em]{convex_hull.png}
 & 
Enveloppe(s) convexe(s)
 & 
Crée l'enveloppe(s) minimale(s) convexe(s) pour une couche données ou des sous-ensembles définis par un champ identifiant.
\\

\includegraphics[width=1.5em]{buffer.png}
 & 
Tampon(s)
 & 
Crée une(des) zone(s) tampon(s) autour des entités, basée(s) soit sur la distance soit sur la valeur d'un champ donné.
\\

\includegraphics[width=1.5em]{intersect.png}
 & 
Intersection
 & 
Intersecte deux couches de sorte que la couche renvoyée contienne uniquement les aires appartenant aux deux couches entrées.
\\

\includegraphics[width=1.5em]{union.png}
 & 
Union
 & 
Intersecte deux couches de sorte que la couche renvoyée contienne à la fois les aires appartenant aux deux couches et celles n'appartenant qu'à l'une des deux.
\\

\includegraphics[width=1.5em]{sym_difference.png}
 & 
Différenciation symétrique
 & 
Superpose les couches de sorte que la couche renvoyée ne contienne que les aires des deux couches ne s'intersectant pas.
\\

\includegraphics[width=1.5em]{clip.png}
 & 
Couper
 & 
Superpose deux couches de sorte que la couche renvoyée contienne les aires de la couche d'entrée qui intersectent celles de la couche de découpage.
\\

\includegraphics[width=1.5em]{difference.png}
 & 
Différenciation
 & 
Superpose deux couches de sorte que la couche renvoyée contienne les aires de la couche d'entrée qui n'intersectent pas celles de la couche de découpage.
\\

\includegraphics[width=1.5em]{dissolve.png}
 & 
Regroupement
 & 
Regroupe les entités selon un champ. Toutes les entités ayant des valeurs identiques de ce champ sont combinées pour former une seule entité.
\\
\hline\end{tabulary}


Table fTools 3: Outils de géotraitement fTools


\subsection{Outils de géométrie}
\label{docs/user_manual/plugins/plugins_ftools:geometry-tools}
\begin{tabulary}{\linewidth}{|L|L|L|}
\hline
\textsf{\relax 
\textbf{Bouton}
} & \textsf{\relax 
\textbf{Outil}
} & \textsf{\relax 
\textbf{Fonction}
}\\
\hline
\includegraphics[width=1.5em]{check_geometry.png}
 & 
Vérifier la validité de la géométrie
 & 
Vérifie sur une couche de polygones s'il n'y a pas d'intersections ou de trous et corrige l'ordre des noeuds.
\\

\includegraphics[width=1.5em]{export_geometry.png}
 & 
Exporter/ajouter des colonnes de géométrie
 & 
Ajoute des informations de géométrie sur une couche vecteur de points (XCOORD, YCOORD), de lignes (LENGTH - longueur), ou de polygones (AREA - aire, PERIMETER - périmètre).
\\

\includegraphics[width=1.5em]{centroids.png}
 & 
Centroïdes de polygones
 & 
Calcule le centroïde réel de chaque entité d'une couche de polygones.
\\

\includegraphics[width=1.5em]{delaunay.png}
 & 
Triangulation de Delaunay
 & 
Calcule et renvoie (sous forme de couche de polygones) la triangulation de Delaunay d'une couche vecteur de points.
\\
 & 
Polygones de Voronoï
 & 
Calcule les polygones de Voronoï d'une couche vecteur de points.
\\

\includegraphics[width=1.5em]{simplify.png}
 & 
Simplifier la géométrie
 & 
Généralise les lignes ou les polygones avec l'algorithme modifié de Douglas-Peucker.
\\
 & 
Densification de géométrie
 & 
Ajoute des vertex aux lignes et aux polygones
\\

\includegraphics[width=1.5em]{multi_to_single.png}
 & 
Morceaux multiples vers morceaux uniques
 & 
Convertit des entités constituées de plusieurs parties en des entités en une seule partie. Crée des polygones et des lignes simples.
\\

\includegraphics[width=1.5em]{single_to_multi.png}
 & 
Morceaux uniques vers morceaux multiples
 & 
Fusionne plusieurs entités possédant le même identifiant sur un champ donné en des entités multipartites.
\\

\includegraphics[width=1.5em]{to_lines.png}
 & 
Polygones vers lignes
 & 
Convertit des polygones en lignes, des polygones multipartites en lignes multipartites.
\\

\includegraphics[width=1.5em]{to_lines.png}
 & 
Lignes vers polygones
 & 
Convertit les lignes en polygones, les lignes multi-partie en plusieurs polygones mono-parties.
\\

\includegraphics[width=1.5em]{extract_nodes.png}
 & 
Extraction de noeuds
 & 
Extrait les noeuds d'une couche de ligne ou de polygone et renvoie une couche de points.
\\
\hline\end{tabulary}


Table fTools 4: Outils de géométrie fTools

\begin{notice}{note}{Note:}
L'outil \emph{Simplifier la géométrie} permet de retirer les noeuds en double de lignes ou de polygones. L'astuce consiste à mettre la \emph{Tolérance de simplification} à 0.
\end{notice}


\subsection{Outils de gestion de données}
\label{docs/user_manual/plugins/plugins_ftools:table-ftools-5}\label{docs/user_manual/plugins/plugins_ftools:data-management-tools}
\begin{tabulary}{\linewidth}{|L|L|L|}
\hline
\textsf{\relax 
\textbf{Bouton}
} & \textsf{\relax 
\textbf{Outil}
} & \textsf{\relax 
\textbf{Fonction}
}\\
\hline
\includegraphics[width=1.5em]{define_projection.png}
 & 
Définir la projection courante
 & 
Définit le système de coordonnées pour les shapefiles qui n'en ont pas.
\\

\includegraphics[width=1.5em]{join_location.png}
 & 
Joindre les attributs par localisation
 & 
Joint des attributs supplémentaires à une couche vecteur en fonction le la localisation. Les attributs d'une couche vecteur sont ajoutés à ceux d'une autre couche et exportés en shapefile.
\\

\includegraphics[width=1.5em]{split_layer.png}
 & 
Séparer une couche vectorielle
 & 
Sépare une couche en plusieures couches distinctes selon un identifiant spécifié.
\\

\includegraphics[width=1.5em]{merge_shapes.png}
 & 
Fusionner les shapefiles
 & 
Fusionne les shapefiles présents dans un répertoire en un nouveau shapefile de même type (point, ligne ou polygone).
\\
 & 
Créer un index spatial
 & 
Crée un index spatial pour les fichiers supportés par OGR.
\\
\hline\end{tabulary}


Table fTools 5: Outils de gestion de données


\section{Extension GDALTools}
\label{docs/user_manual/plugins/plugins_gdaltools:label-plugingdaltools}\label{docs/user_manual/plugins/plugins_gdaltools::doc}\label{docs/user_manual/plugins/plugins_gdaltools:gdal-tools-plugin}

\subsection{Que sont les outils GDALTools ?}
\label{docs/user_manual/plugins/plugins_gdaltools:what-is-gdaltools}\label{docs/user_manual/plugins/plugins_gdaltools:whatsgdal}
Les outils GDALTools offrent une interface graphique aux outils de la bibliothèque Geospatial Data Abstraction Library, (\href{http://gdal.osgeo.org}{http://gdal.osgeo.org}). Ce sont des outils de gestion de raster qui permettent d'interroger, de reprojeter et de manipuler une large palette de formats. Il y a également des outils pour créer des contours vectoriels ou un relief ombré à partir d'un MNT, pour produire un vrt (Virtual Raster Tile au format XML) depuis un ensemble de rasters. Tous ces outils sont disponibles lorsque l'extension GDALTools est activée.


\subsubsection{La bibliothèque GDAL}
\label{docs/user_manual/plugins/plugins_gdaltools:the-gdal-library}
La bibliothèque GDAL regroupe plusieurs programmes en ligne de commande, chacun possédant une longue liste d'options. Les utilisateurs habitués aux consoles préfèreront la ligne de commande qui donne accès à toutes les options tandis que l'extension offre une interface graphique plus abordable et ne liste que les options les plus courantes.


\subsection{Liste des outils GDAL}
\label{docs/user_manual/plugins/plugins_gdaltools:list-of-gdal-tools}\phantomsection\label{docs/user_manual/plugins/plugins_gdaltools:figure-gdal-tools-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{raster_menu.png}
\caption{The \emph{GDALTools} menu list}\end{figure}


\subsubsection{Projections}
\label{docs/user_manual/plugins/plugins_gdaltools:projections}
\begin{tabulary}{\linewidth}{|L|L|}
\hline

\includegraphics[width=1.5em]{warp.png} \emph{Projection}
 & 
Cet outil permet de déformer et de reprojeter des images. Le programme peut reprojeter dans n’importe quelles projections supportées, et appliquer les points d’amer stockés avec l’image si l’image est fournie « brute ». Pour plus d'informations, se reporter au site web GDAL \href{http://www.gdal.org/gdalwarp.html}{http://www.gdal.org/gdalwarp.html}
\\

\includegraphics[width=1.5em]{projection-add.png} \emph{Assigner une projection}
 & 
Cet utilitaire permet de définir la projection d'un raster qui aurait déjà été géoréférencé mais dont il manque les informations de projection. Il permet également de modifier la projection définie. Le traitement peut s'effectue sur un ou plusieurs fichiers simultanément. Pour plus d'informations, se reporter au site web GDAL \href{http://www.gdal.org/gdalwarp.html}{http://www.gdal.org/gdalwarp.html}
\\

\includegraphics[width=1.5em]{projection-export.png} \emph{Extraction de projection}
 & 
Cet utilitaire permet d'extraire les informations de projection d'un fichier en entrée. Il peut être utilisé pour extraire les projections des fichiers d'un répertoire . Il crée des fichiers \code{.prj} et \code{.wld}.
\\
\hline\end{tabulary}



\paragraph{}
\label{docs/user_manual/plugins/plugins_gdaltools:id1}

\subsubsection{Conversion}
\label{docs/user_manual/plugins/plugins_gdaltools:conversion}
\begin{tabulary}{\linewidth}{|L|L|}
\hline

\includegraphics[width=1.5em]{rasterize.png} \emph{Rastériser}
 & 
This program burns vector geometries (points, lines
and polygons) into the raster band(s) of a raster
image. Vectors are read from OGR supported vector
formats. Note that the vector data must in the same
coordinate system as the raster data; on the fly
reprojection is not provided. For more information see
\href{http://www.gdal.org/gdal\_rasterize.html}{http://www.gdal.org/gdal\_rasterize.html}
\\

\includegraphics[width=1.5em]{polygonize.png} \emph{Polygoniser}
 & 
Cet utilitaire crée des polygones vectoriels à partir des zones de pixels connectés partageant la même valeur de cellule. Chaque polygone est créé avec un attribut indiquant la valeur du pixel sous-jacent. Il créera la couche de données vectorielles en sortie si elle n'existe pas encore, le format par défaut étant le ESRI shapefile. Pour plus d'informations, se reporter à \href{http://www.gdal.org/gdal\_polygonize.html}{http://www.gdal.org/gdal\_polygonize.html}
\\

\includegraphics[width=1.5em]{translate.png} \emph{Convertir}
 & 
L'utilitaire de conversion permet de traduire un raster dans un autre format raster, ainsi que d'appliquer d'autres opérations telles que le rééchantillonnage, le changement de taille des pixels ou l'extraction d'un sous-secteur. Pour plus d'informations, se reporter à \href{http://www.gdal.org/gdal\_translate.html}{http://www.gdal.org/gdal\_translate.html}
\\

\includegraphics[width=1.5em]{raster-rgb.png} \emph{RVB vers PCT}
 & 
Ce programme va calculer une table de pseudo-couleurs (PCT) optimale à partir d'une image RVB en utilisant un algorithme médian sur un histogramme RVB réduit. L'image sera convertie en une image dotée de pseudo-couleurs tirées de la table de couleurs créée. Cette conversion utilise la correction Floyd-Steinberg afin d'améliorer la qualité visuelle. Pour plus d'informations, se reporter à \href{http://www.gdal.org/rgb2pct.html}{http://www.gdal.org/rgb2pct.html}
\\

\includegraphics[width=1.5em]{raster-rgb.png} \emph{PCT vers RVB}
 & 
Ce programme convertit une bande de couleurs indexées en RVB. Pour plus d'informations, se reporter à \href{http://www.gdal.org/pct2rgb.html}{http://www.gdal.org/pct2rgb.html}
\\
\hline\end{tabulary}



\paragraph{}
\label{docs/user_manual/plugins/plugins_gdaltools:id2}

\subsubsection{Extraction}
\label{docs/user_manual/plugins/plugins_gdaltools:extraction}
\begin{tabulary}{\linewidth}{|L|L|}
\hline

\includegraphics[width=1.5em]{contour.png} \emph{Création de contours}
 & 
Ce programme génère un fichier de contours vectoriels à partir d'un raster d'élévation (DEM/MNE/MNT). Pour plus d'informations, se reporter à \href{http://www.gdal.org/gdal\_contour.html}{http://www.gdal.org/gdal\_contour.html}.
\\

\includegraphics[width=1.5em]{raster-clip.png} \emph{Découper}
 & 
Cet utilitaire permet d'extraire une zone d'une ou plusieurs images selon une emprise de coordonnées ou selon une couche de masquage. Pour plus d'informations, se reporter à \href{http://www.gdal.org/gdal\_translate.html}{http://www.gdal.org/gdal\_translate.html}.
\\
\hline\end{tabulary}



\paragraph{}
\label{docs/user_manual/plugins/plugins_gdaltools:id3}

\subsubsection{Analyse}
\label{docs/user_manual/plugins/plugins_gdaltools:analysis}
\begin{tabulary}{\linewidth}{|L|L|}
\hline

\includegraphics[width=1.5em]{sieve.png} \emph{Tamiser}
 & 
Cet utilitaire efface les surfaces rasters plus petites que la taille donnée (en pixel) et les remplace par la valeur de la surface voisine la plus importante. Le résultat peut être appliqué à la bande raster existante ou être sauvegardé dans un nouveau fichier. Pour plus d'informations, se reporter à \href{http://www.gdal.org/gdal\_sieve.html}{http://www.gdal.org/gdal\_sieve.html}.
\\

\includegraphics[width=1.5em]{nearblack.png} \emph{Presque Noir}
 & 
Cet utilitaire scanne une image et essaye de convertir les pixels qui sont dans une couleur presque noire (ou presque blanche) dans une couleur noire totale (ou blanche). Cela permet de corriger des images compressés afin de pouvoir spécifier une couleur comme transparente. Pour plus d'informations, se reporter à \href{http://www.gdal.org/nearblack.html}{http://www.gdal.org/nearblack.html}.
\\

\includegraphics[width=1.5em]{fillnodata.png} \emph{Remplir la valeur nulle}
 & 
cet utilitaire remplit les zones sélectionnées du raster en interpolant les valeurs des pixels valides en bordure de zone. Pour plus d'informations, se reporter à \href{http://www.gdal.org/gdal\_fillnodata.html}{http://www.gdal.org/gdal\_fillnodata.html}.
\\

\includegraphics[width=1.5em]{proximity.png}\emph{Proximité}
 & 
Cet utilitaire génère une carte raster de proximité qui indique la distance entre le centre de chaque pixel et le centre du pixel le plus proche qui est désigné comme un pixel cible. Les cibles sont les pixels qui correspondent à une valeur de pixel précise. Pour plus d'informations, se reporter à \href{http://www.gdal.org/gdal\_proximity.html}{http://www.gdal.org/gdal\_proximity.html}.
\\

\includegraphics[width=1.5em]{grid.png} \emph{Grille}
 & 
Ce programme créé des grilles régulières depuis les données sources. Les données sources peuvent être interpolées afin de remplir les noeuds de la grille avec des valeurs. Pour plus d'informations, se reporter à \href{http://www.gdal.org/gdal\_grid.html}{http://www.gdal.org/gdal\_grid.html}.
\\

\includegraphics[width=1.5em]{gdal_dem.png} \emph{MNT/DEM (Modèles de terrain)}
 & 
Outils pour l'analyse et la visualisation de MNT. Il est possible de créer un raster d'ombrage, de pente, d'aspect, de relief coloré, d'Indice de Rugosité du terrain (TRI), d'Indice de Position Topographique (TPI) et de rugosité depuis tous les types de format raster supportés par GDAL. Pour plus d'informations, se reporter à \href{http://www.gdal.org/gdaldem.html}{http://www.gdal.org/gdaldem.html}
\\
\hline\end{tabulary}



\paragraph{}
\label{docs/user_manual/plugins/plugins_gdaltools:id4}

\subsubsection{Divers}
\label{docs/user_manual/plugins/plugins_gdaltools:miscellaneous}
\begin{tabulary}{\linewidth}{|L|L|}
\hline

\includegraphics[width=1.5em]{vrt.png} \emph{Construire un Raster Virtuel}
 & 
Ce programme construit un VRT, un fichier virtuel qui affiche en mosaïque une liste de rasters. Pour plus d'informations, se reporter à \href{http://www.gdal.org/gdalbuildvrt.html}{http://www.gdal.org/gdalbuildvrt.html}.
\\

\includegraphics[width=1.5em]{merge.png} \emph{Fusionner}
 & 
Ce programme fusionnera automatiquement une série d'images. Toutes les images doivent avoir le même système de coordonnées et posséder le même nombre de bandes, elles peuvent se superposer ou être de résolutions différentes. Dans les zones de superposition, la dernière image de la liste sera copiée sur les autres. Pour plus d'informations, se reporter à \href{http://www.gdal.org/gdal\_merge.html}{http://www.gdal.org/gdal\_merge.html}.
\\

\includegraphics[width=1.5em]{raster-info.png} \emph{Information}
 & 
Ce programme liste les diverses informations d'un raster supporté par GDAL. Pour plus d'informations, se reporter à \href{http://www.gdal.org/gdalinfo.html}{http://www.gdal.org/gdalinfo.html}.
\\

\includegraphics[width=1.5em]{raster-overview.png} \emph{Construire des aperçus}
 & 
Ce programme permet de construire ou de reconstruire des aperçus (pyramides) pour une image selon plusieurs algorithmes. Pour plus d'informations, se reporter à \href{http://www.gdal.org/gdaladdo.html}{http://www.gdal.org/gdaladdo.html}.
\\

\includegraphics[width=1.5em]{tileindex.png} \emph{Index des tuiles}
 & 
Ce programme construit un shapefile où chaque entité correspond à un fichier raster, avec un champ attribut contenant le nom du fichier et une géométrie de type polygone correspondant à l'emprise du raster. Pour plus d'informations, se reporter à \href{http://www.gdal.org/gdalindex.html}{http://www.gdal.org/gdalindex.html}.
\\
\hline\end{tabulary}



\section{L'extension de géoréférencement}
\label{docs/user_manual/plugins/plugins_georeferencer:georef}\label{docs/user_manual/plugins/plugins_georeferencer:georeferencer-plugin}\label{docs/user_manual/plugins/plugins_georeferencer::doc}
L'extension de géoréférencement est un outil permettant de renseigner les coordonnées de rasters en générant les fichiers ``world'' (fichiers de référence indiquant les paramètres de translation, rotation et mise à l'échelle) ou de les transformer dans un nouveau système. La première étape pour le géoréférencement d'une image est de localiser, sur le raster, des points dont vous pouvez déterminer les coordonnées avec précision.

Fonctionnalités

\index{Georeferencer tools}\phantomsection\label{docs/user_manual/plugins/plugins_georeferencer:table-georeferencer-1}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Bouton
} & \textsf{\relax 
Description
} & \textsf{\relax 
Bouton
} & \textsf{\relax 
Description
}\\
\hline &  &  & \\

\includegraphics[width=1.5em]{mActionAddRasterLayer.png}
 & 
Ouvrir un raster
 & 
\includegraphics[width=1.5em]{mActionStartGeoref.png}
 & 
Commencer le géoréférencement
\\

\includegraphics[width=1.5em]{mActionGDALScript.png}
 & 
Générer le script GDAL
 & 
\includegraphics[width=1.5em]{mActionFileOpen.png}
 & 
Charger les points de contrôle
\\

\includegraphics[width=1.5em]{mActionFileSave.png}
 & 
Sauvegarder les points de contrôle
 & 
\includegraphics[width=1em]{mActionOptions.png}
 & 
Paramètres de transformation
\\

\includegraphics[width=1.5em]{mActionCapturePoint.png}
 & 
Ajouter un point
 & 
\includegraphics[width=1.5em]{mActionDeleteSelected.png}
 & 
Effacer un point
\\

\includegraphics[width=1.5em]{mActionMoveFeature.png}
 & 
Déplacer un point
 & 
\includegraphics[width=1.5em]{mActionPan.png}
 & 
Se déplacer
\\

\includegraphics[width=1.5em]{mActionZoomIn.png}
 & 
Zoom +
 & 
\includegraphics[width=1.5em]{mActionZoomOut.png}
 & 
Zoom -
\\

\includegraphics[width=1.5em]{mActionZoomToLayer.png}
 & 
Zoom sur la couche
 & 
\includegraphics[width=1.5em]{mActionZoomLast.png}
 & 
Zoom précédent
\\

\includegraphics[width=1.5em]{mActionZoomNext.png}
 & 
Zoom suivant
 & 
\includegraphics[width=2.5em]{mActionLinkGeorefToQGis.png}
 & 
Lier le géoréférenceur à QGIS
\\

\includegraphics[width=2.5em]{mActionLinkQGisToGeoref.png}
 & 
Lier QGIS au géoréférenceur
 &  & \\
\hline\end{tabulary}


Table Géoréférenceur 1: Outils de géoréférencement


\subsection{Procédures courantes}
\label{docs/user_manual/plugins/plugins_georeferencer:usual-procedure}
Pour déterminer des coordonnées X et Y (notées en DMS (dd mm ss.ss), DD (dd.dd) ou en coordonnées projetées (mmmm.mm)) qui correspondent au point sélectionné sur l'image, deux procédures peuvent être suivies :
\begin{itemize}
\item {} 
Par le raster lui-même : quelquefois les coordonnées sont littéralement écrites (p. ex., les graticules). Dans ce cas, vous pouvez les saisir manuellement.

\item {} 
par des données déjà géoréférencées ; cela peut être des données vecteur ou raster où figurent les mêmes objets/entités que sur le raster que vous désirez géoréférencer. Dans ce cas, il vous faudra renseigner les coordonnées en cliquant les données de référence qui auront été chargées dans la carte principale de QGIS.

\end{itemize}

La procédure standard pour le géoréférencement d'une image implique la sélection de plusieurs points sur le raster, en spécifiant leurs coordonnées et en choisissant la transformation appropriée. En se basant sur les paramètres entrés et les données, l'extension calculera les paramètres du fichier ``world''. Plus il y a de coordonnées fournies, meilleur sera le résultat.

La première étape consiste à lancer QGIS puis à charger l'extension (voir la section {\hyperref[docs/user_manual/plugins/plugins:load-core-plugin]{\emph{Activer une extension principale}}}) puis cliquer sur le bouton \includegraphics[width=1.5em]{georeferencer.png} $^{\text{Géoreferencer}}$ qui apparaît dans la barre d'outils de QGIS. La fenêtre de géoréférencement se présente sous la forme montrée dans la figure {\hyperref[docs/user_manual/plugins/plugins_georeferencer:figure-georeferencer-1]{figure\_georeferencer\_1}}.

En guise d'exemple, nous allons utiliser une carte topographique du Dakota du Sud publiée par le SDGS. Elle pourra par la suite être affichée avec les données du secteur GRASS spearfish60. Cette carte topographique peut être téléchargée à l'adresse suivante : \href{http://grass.osgeo.org/sampledata/spearfish\_toposheet.tar.gz}{http://grass.osgeo.org/sampledata/spearfish\_toposheet.tar.gz}.
\phantomsection\label{docs/user_manual/plugins/plugins_georeferencer:figure-georeferencer-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{georefplugin.png}
\caption{Georeferencer Plugin Dialog \includegraphics[width=1em]{nix.png}}\end{figure}


\subsubsection{Saisir des points de contrôle (GCP)}
\label{docs/user_manual/plugins/plugins_georeferencer:georeferencer-entering}\label{docs/user_manual/plugins/plugins_georeferencer:entering-ground-control-points-gcps}\begin{enumerate}
\item {} 
Pour commencer le géoréférencement d'un raster, nous devons le charger via le bouton \includegraphics[width=1.5em]{mActionAddRasterLayer.png}. Le raster apparaît alors dans la surface principale de travail de la fenêtre. Une fois qu'il est chargé, nous pouvons commencer à entrer des points de contrôles.

\item {} 
En utilisant le bouton \includegraphics[width=1.5em]{mActionCapturePoint.png} $^{\text{Ajouter des Points}}$, ajouter par un clic des points dans la surface de travail et saisissez leurs coordonnées (voir figure {\hyperref[docs/user_manual/plugins/plugins_georeferencer:figure-georeferencer-2]{figure\_georeferencer\_2}}). Pour ce faire, il y a deux manières de procéder :
\begin{itemize}
\item {} 
En cliquant en un point de la carte raster et entrant les coordonnées X et Y manuellement.

\item {} 
En cliquant en un point de la carte raster puis sur le bouton \includegraphics[width=1.5em]{pencil.png} $^{\text{Depuis le canevas}}$ pour ajouter les coordonnées X et Y à l'aide d'une carte géoréférencée déjà chargée dans le canevas principal de QGIS.

\item {} 
Avec le bouton \includegraphics[width=1.5em]{mActionMoveFeature.png}, vous pouvez déplacer les points de contrôle dans les deux fenêtres au cas où ils seraient mal placés.

\end{itemize}

\item {} 
Continuez d'entrer des points jusqu'à en avoir au moins quatre. Des outils additionnels situés dans la partie supérieure de cette fenêtre permettent de zoomer et de se déplacer dans l'espace de travail.

\end{enumerate}
\phantomsection\label{docs/user_manual/plugins/plugins_georeferencer:figure-georeferencer-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{choose_points.png}
\caption{Add points to the raster image \includegraphics[width=1em]{nix.png}}\end{figure}

Les points qui sont ajoutés sur la carte sont enregistrés dans un fichier texte distinct (\code{nomdufichier.points}) qui est stocké avec le fichier raster. Il permet de rouvrir l'extension à une date ultérieure et de rajouter de nouveaux points ou d'effacer ceux existants pour améliorer le résultat sans devoir tout refaire. Le fichier de points contient les valeurs suivantes : mapX, mapY, pixelX, pixelY (soit les coordonnées cartographiques et les coordonnées du pixel). Vous pouvez aussi utiliser \includegraphics[width=1.5em]{mActionFileOpen.png} $^{\text{Charger des points de contrôle}}$ et \includegraphics[width=1.5em]{mActionFileSave.png} $^{\text{Sauvegarder des points de contrôle}}$ dans des répertoires différents si vous le désirez.

En cliquant sur l'en-tête d'une colonne de la table des points, vous pouvez les trier numériquement. Cette liste est automatiquement mise à jour.


\subsubsection{Configurer la transformation}
\label{docs/user_manual/plugins/plugins_georeferencer:georeferencer-transformation}\label{docs/user_manual/plugins/plugins_georeferencer:defining-the-transformation-settings}
Après avoir ajouté vos points de contrôle, vous devez sélectionner la méthode de transformation qui sera utilisée pour le géoréférencement.
\phantomsection\label{docs/user_manual/plugins/plugins_georeferencer:figure-georeferencer-3}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{transformation_settings.png}
\caption{Defining the georeferencer transformation settings \includegraphics[width=1em]{nix.png}}\end{figure}


\subsubsection{Algorithmes de transformation disponibles}
\label{docs/user_manual/plugins/plugins_georeferencer:available-transformation-algorithms}
Selon le nombre de points que vous saisissez, vous aurez à utiliser différents algorithmes de transformation. Le choix d'un algorithme dépend aussi du type et de la qualité de vos sources de données et du niveau de distorsion géométrique que vous êtes prêt à accepter dans le résultat final.

Actuellement les algorithmes suivants sont disponibles :
\begin{itemize}
\item {} 
L'algorithme \textbf{Linéaire} est utilisé pour créer un fichier ``world''. Il est différent des autres algorithmes en ce sens qu'il ne transforme pas le raster. Cet algorithme ne sera vraisemblablement pas suffisant pour géoréférencer des données scannées.

\item {} 
L'algorithme \textbf{Helmert} applique de simples translation, rotation et mise à l'échelle.

\item {} 
Les algorithmes \textbf{Polynomiaux} de degré 1 à 3 sont parmi les algorithmes les plus utilisés pour le géoréférencement et chacun diffère par le degré de distorsion qu'il introduit pour faire correspondre au mieux la source aux points de contrôles. La transformation polynomiale la plus utilisée est celle d'ordre deux qui autorise quelques courbes. La transformation polynomiale d'ordre un (aussi appelée transformation affine) préserve la colinéarité et permet seulement les translation, rotation et mise à l'échelle (comme la transformation de Helmert).

\item {} 
L'algorithme \textbf{Thin Plate Spline} (TPS) est une méthode plus moderne qui est capable d'introduire des déformations sur des secteurs précis de l'image. Il est très pratique quand des sources de faible qualité sont utilisées.

\item {} 
L'algorithme \textbf{Projective} est une rotation linéaire puis une translation des coordonnées.

\end{itemize}


\subsubsection{Définir la méthode de rééchantillonage}
\label{docs/user_manual/plugins/plugins_georeferencer:define-the-resampling-method}
Le type de ré-échantillonnage à effectuer dépendra de votre donnée en entrée et de l'objectif de l'exercice. Si vous ne voulez pas changer les statistiques de l'image, vous devriez sélectionner la méthode du plus proche voisin tandis que le ré-échantillonnage cubique produira un résultat plus lisse.

Il est possible de choisir entre 5 méthodes de ré-échantillonnage.
\begin{enumerate}
\item {} 
Au plus proche voisin

\item {} 
Linéaire

\item {} 
Cubique

\item {} 
Cubic Spline

\item {} 
Lanczos

\end{enumerate}


\subsubsection{Définir les paramètres de transformation}
\label{docs/user_manual/plugins/plugins_georeferencer:define-the-transformation-settings}
Plusieurs paramètres doivent être renseignés afin de créer un raster géoréférencé.
\begin{itemize}
\item {} 
La case \includegraphics{checkbox.png} \emph{Créer un fichier de coordonnées} est uniquement disponible lorsque la méthode de transformation linéaire est choisie, et ce, parce que votre image ne sera alors pas transformée en sortie. Dans ce cas précis, le champ \emph{raster de sortie} ne sera pas activé, car seul le fichier de coordonnées sera créé.

\item {} 
Pour tous les autres types de transformations, vous pouvez saisir un \emph{Raster de sortie}. Par défaut, le nouveau fichier s'intitulera ({[}nomdefichier{]}\_georef) et sera enregistré dans le même répertoire que le raster original.

\item {} 
L'étape suivante est la définition du \emph{SCR cible} pour le raster géoréférencé (lire section {\hyperref[docs/user_manual/working_with_projections/working_with_projections:label-projections]{\emph{Utiliser les projections}}}).

\item {} 
Si vous le désirez, vous pouvez demander à \textbf{générer une carte PDF} ou \textbf{générer un rapport PDF} qui inclut tous les paramètres définis ainsi qu'une image avec tous les résidus et une liste des points de contrôles et leurs erreurs RMS.

\item {} 
Vous pouvez cocher la case \includegraphics{checkbox.png} \emph{Définir la résolution de la cible} et préciser la résolution de pixel du raster généré. La résolution horizontale et verticale par défaut est de 1,

\item {} 
Lorsque la case \includegraphics{checkbox.png} \emph{Employer 0 pour la transparence si nécessaire} est cochée, cela indique que la valeur 0 sera transparente lors de la visualisation. Dans notre exemple, toutes les zones blanches seront transparentes.

\item {} 
Pour finir, la case \includegraphics{checkbox.png} \emph{Charger dans QGIS lorsque terminé} assure le chargement automatique du raster quand la transformation est achevée.

\end{itemize}


\subsubsection{Afficher et modifier les propriétés raster}
\label{docs/user_manual/plugins/plugins_georeferencer:show-and-adapt-raster-properties}
En cliquant sur \emph{Propriétés du raster} dans le menu \emph{Paramètres} s'ouvre la fenêtre des propriétés du raster que vous voulez géoréférencer.


\subsubsection{Configurer le géoreferenceur}
\label{docs/user_manual/plugins/plugins_georeferencer:configure-the-georeferencer}\begin{itemize}
\item {} 
Vous pouvez choisir d'afficher les coordonnées de points ou leur identifiant.

\item {} 
Les résidus peuvent être exprimés en unités de la carte ou en pixel.

\item {} 
Vous pouvez modifier les marges et la taille de papier du rapport PDF.

\item {} 
Enfin, vous pouvez aussi activer la case \includegraphics{checkbox.png} \emph{Afficher la fenêtre de géoréférencement dans la fenêtre principale}.

\end{itemize}


\subsubsection{Lancer la transformation}
\label{docs/user_manual/plugins/plugins_georeferencer:running-the-transformation}\label{docs/user_manual/plugins/plugins_georeferencer:georeferencer-running}
Lorsque tous les points de contrôle ont été posés et les paramètres de transformation saisis, appuyez sur le bouton \includegraphics[width=1.5em]{mActionStartGeoref.png} $^{\text{Commencer le géoréférencement}}$ pour créer le raster final.


\section{Extension Interpolation}
\label{docs/user_manual/plugins/plugins_interpolation::doc}\label{docs/user_manual/plugins/plugins_interpolation:interpolation-plugin}\label{docs/user_manual/plugins/plugins_interpolation:interpol}
L'extension Interpolation permet de générer une interpolation TIN ou IDW depuis une couche vectorielle de points. Cette extension est très simple à manipuler et fournit à l'utilisateur une interface graphique intuitive pour la création de couches matricielles interpolées (voir la Figure {\hyperref[docs/user_manual/plugins/plugins_interpolation:figure-interpolation-1]{Figure\_interpolation\_1}}). Avant son exécution, l'extension nécessite les réglages suivants:
\begin{itemize}
\item {} 
\textbf{Couche vecteur d'entrée} : Spécifier une (ou plusieurs) couche vectorielle de points parmi la liste de couches vectorielles de points chargées. Si plusieurs couches sont sélectionnées, alors l'ensemble des données de toutes les couches est utilisé pour l'interpolation. Note: il est possible d'insérer des lignes ou des polygones comme contrainte pour la triangulation en spécifiant ``lignes de structure'' ou ``break lines'' dans la liste déroulante \includegraphics{selectstring.png} du sous-menu \emph{Type}.

\item {} 
\textbf{Attribut d'interpolation} : Sélectionner une colonne attributaire à utiliser pour l'interpolation ou cocher la case \includegraphics{checkbox.png} \emph{Utiliser les coordonnées Z pour l'interpolation} afin d'utiliser une couche contenant des valeurs Z.

\item {} 
\textbf{Méthode d'interpolation} : Sélectionner une méthode d'interpolation. Cela peut être `Interpolation Triangulaire (TIN)' ou'Pondération par Distance Inverse (IDW)'.

\item {} 
\textbf{Nombre de colonnes/cellules} : Définir le nombre de colonnes et de lignes du raster de sortie.

\item {} 
\textbf{Fichier de sortie} : Attribuer un nom au fichier raster de sortie.

\end{itemize}
\phantomsection\label{docs/user_manual/plugins/plugins_interpolation:figure-interpolation-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{interpolate_dialog.png}
\caption{Interpolation Plugin \includegraphics[width=1em]{nix.png}}\end{figure}


\subsection{Mettre en oeuvre l'extension}
\label{docs/user_manual/plugins/plugins_interpolation:using-the-plugin}\label{docs/user_manual/plugins/plugins_interpolation:interpolation-usage}\begin{enumerate}
\item {} 
Lancez QGIS et chargez une couche vectorielle de points (par exemple, \code{elevp.csv}).

\item {} 
Activez l'extension Interpolation via le Gestionnaire d'Extensions (voir la Section {\hyperref[docs/user_manual/plugins/plugins:load-core-plugin]{\emph{Activer une extension principale}}}) puis appuyez sur l'icône \includegraphics[width=1.5em]{raster-interpolate.png} $^{\text{Interpolation}}$ qui apparaît alors dans la barre d'outils QGIS. La boîte de dialogue de l'extension Interpolation s'ouvre comme montrée dans la Figure {\hyperref[docs/user_manual/plugins/plugins_interpolation:figure-interpolation-1]{Figure\_interpolation\_1}}.

\item {} 
Dans le bloc Saisie, sélectionnez une couche vectorielle de départ (par exemple, \emph{elevp} \includegraphics{selectstring.png}) ainsi qu'une colonne attributaire pour l'interpolation (par exemple, \code{ELEV}).

\item {} 
Dans le bloc Rendu, sélectionnez une méthode d'interpolation (par exemple,'Interpolation Triangulaire'), puis définissez le nombre de colonnes et de cellules, par exemple, 5000 ainsi qu'un nom pour le fichier raster de sortie (par exemple, \code{elevation\_tin}).

\item {} 
Appuyez sur \textbf{{[}Ok{]}}.

\item {} 
Pour cet exemple, double cliquez sur \code{elevation\_tin} dans la liste des couches pour ouvrir la fenêtre de \emph{propriétés} de la couche raster et sélectionnez \emph{Pseudocouleur} comme couleur de la carte \includegraphics{selectstring.png} dans l'onglet \emph{Style}. Vous pouvez également définir une nouvelle table de couleurs comme décrit dans la Section {\hyperref[docs/user_manual/working_with_raster/index:working-with-raster]{\emph{Les données raster}}}.

\end{enumerate}

\index{Mapserver\_Export\_Plugin}

\section{Extension d'exportation Mapserver}
\label{docs/user_manual/plugins/plugins_mapserver_export:mapserver-export-plugin}\label{docs/user_manual/plugins/plugins_mapserver_export:index-0}\label{docs/user_manual/plugins/plugins_mapserver_export::doc}\label{docs/user_manual/plugins/plugins_mapserver_export:mapserver-export}
Vous pouvez utiliser QGIs pour composer votre carte en ajoutant et en arrangeant des couches, en modifiant leur représentation graphique, puis vous pouvez exporter le résultat sous la forme d'un fichier .map à destination de MapServer.

\begin{notice}{note}{Note:}
Pour l'instant, l'extension ne fonctionne qu'avec l'ancienne symbolique QGIS. La nouvelle symbolique n'est pas encore supportée.
\end{notice}


\subsection{Création du fichier de projet}
\label{docs/user_manual/plugins/plugins_mapserver_export:creating-the-project-file}
L'extension fonctionne sur un fichier de projet QGIS précédemment enregistré, et \textbf{non} sur le contenu actuel de la carte et de la légende. C'est souvent une source de confusion pour beaucoup. Comme décrit ci-dessous, vous avez besoin de réarranger les couches vecteurs et rasters que vous voulez utiliser dans MapServer et enregistrer l'état qui vous paraît satisfaisant dans un fichier de projet QGIS.
\phantomsection\label{docs/user_manual/plugins/plugins_mapserver_export:figure-mapserver-export-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{mapserver_export_qgis.png}
\caption{Arrange raster and vector layers for QGIS project file \includegraphics[width=1em]{nix.png}}\end{figure}

Dans cet exemple sont présentées les quatre étapes requises pour créer un fichier de projet qui pourra être utilisé pour créer un fichier de carte (mapfile) pour MapServer.Les fichiers vecteurs et rasters proviennent de l'échantillon de jeu de données de Quantum GIS {\hyperref[docs/user_manual/introduction/getting_started:label-sampledata]{\emph{Échantillon de données}}}.
\begin{enumerate}
\item {} 
Ajoutez la couche raster \code{landcover.tif} en cliquant sur le bouton \includegraphics[width=1.5em]{mActionAddRasterLayer.png} $^{\text{Ajouter une Couche Raster}}$.

\item {} 
Ajoutez la couche vecteur SHP \code{lakes.shp}, \code{majrivers.shp} et \code{airports.shp} depuis le jeu de données QGIS en cliquant sur le bouton \includegraphics[width=1.5em]{mActionAddNonDbLayer.png} $^{\text{Ajouter une couche Vecteur}}$.

\item {} 
Changer les couleurs et les symboles des données (voir Figure {\hyperref[docs/user_manual/plugins/plugins_mapserver_export:figure-mapserver-export-1]{figure\_mapserver\_export\_1}})

\item {} 
Enregistrez dans un nouveau fichier de projet nommé \code{mapserverproject.qgs} en utilisant \includegraphics[width=1.5em]{mActionFileSave.png} \emph{Fichier -\textgreater{} Enregistrer le projet}.

\end{enumerate}

\index{msexport}

\subsection{Création du fichier .map}
\label{docs/user_manual/plugins/plugins_mapserver_export:creating-the-map-file}\label{docs/user_manual/plugins/plugins_mapserver_export:index-1}
Pour utiliser l'extension Exportation Mapserver, vous devez charger l'extension en utilisant le Gestionnaire d'extension. (Voir Section {\hyperref[docs/user_manual/plugins/plugins:load-core-plugin]{\emph{Activer une extension principale}}}).
\phantomsection\label{docs/user_manual/plugins/plugins_mapserver_export:figure-mapserver-export-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=25em]{mapserver_export_dialog.png}
\caption{Export to MapServer Dialog \includegraphics[width=1em]{nix.png}}\end{figure}

\begin{tabulary}{\linewidth}{|L|L|}
\hline

\textbf{Fichier map}
 & 
Saisissez le chemin complet du fichier .map que vous voulez exporter. Vous pouvez utiliser le bouton sur la droite pour parcourir votre système.
\\

\textbf{Fichier projet Qgis}
 & 
Saisissez le chemin complet du fichier projet (.qgs) que vous voulez exporter. Vous pouvez utiliser le bouton sur la droite pour parcourir votre système.
\\

\textbf{Nom de la carte}
 & 
Un nom pour la carte. Ce nom préfixera toutes les images créées par le serveur.
\\

\textbf{Largeur de la carte}
 & 
Largeur en pixels de l'image générée.
\\

\textbf{Hauteur de la carte}
 & 
Hauteur en pixels de l'image générée.
\\

\textbf{Unitées de la carte}
 & 
Unités de mesure utilisées.
\\

\textbf{Type d'image}
 & 
Format de l'image générée par MapServer
\\

\textbf{Web Template}
 & 
Chemin complet vers le fichier MapServer template à utiliser
\\

\textbf{Web en-tête}
 & 
Chemin complet vers le fichier d'en-tête de MapServer à utiliser
\\

\textbf{Web bas de page}
 & 
Chemin complet vers le fichier de bas de page MapServer à utiliser
\\
\hline\end{tabulary}


Seuls les fichiers \emph{.map} et \code{fichier de projet QGIS} sont requis pour créer un fichier .map. Cependant les autres paramètres sont importants pour éviter d'obtenir un fichier inutilisable . Bien que QGIS soit en mesure de créer les fichiers .map, votre projet nécessite peut-être des adaptions pour obtenir le résultat escompté. Créons un fichier .map en utilisant le projet \code{mapserverproject.qgs} que nous avons créé (voir Figure {\hyperref[docs/user_manual/plugins/plugins_mapserver_export:figure-mapserver-export-2]{Figure\_mapserver\_export\_2}}):
\begin{enumerate}
\item {} 
Ouvrez l'extension en cliquant sur le bouton \includegraphics{mapserver_export.png} $^{\text{Exporter vers}}$ (voir figure {\hyperref[docs/user_manual/plugins/plugins_mapserver_export:figure-mapserver-export-2]{Figure\_mapserver\_export\_2}}).

\item {} 
Entrez le nom \code{qgisproject.map} pour votre nouveau fichier .map.

\item {} 
Sélectionnez le projet QGIS \code{mapserverproject.qgs} que vous venez d'enregistrer.

\item {} 
Entrez un nom (par exemple \code{MaCarte} pour la carte.

\item {} 
Entrez la taille de l'image souhaitée (par exemple 600 de largeur par 400 de hauteur).

\item {} 
Nos couches sont en mètres, l'unité de mesure sera donc le mètre.

\item {} 
Choisissez \emph{png} pour le type d'image.

\item {} 
Cliquez sur \textbf{{[}OK{]}} pour générer le nouveau fichier \code{qgisproject.map}. QGIS affiche le résultat de vos efforts.

\end{enumerate}
\phantomsection\label{docs/user_manual/plugins/plugins_mapserver_export:figure-mapserver-export-3}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{mapserver_export_success.png}
\caption{Export to MapServer Succesfull Dialog \includegraphics[width=1em]{nix.png}}\end{figure}

Vous pouvez visualiser le fichier .map dans un éditeur de texte. Si vous le faites, vous remarquerez que l'outil d'exportation ajoute les métadonnées nécessaires à l'utilisation du protocole WMS.

\index{shp2img}\index{FWTools}

\subsection{En cas de problème}
\label{docs/user_manual/plugins/plugins_mapserver_export:troubleshooting}\label{docs/user_manual/plugins/plugins_mapserver_export:index-2}
Si Mapserver émet des messages d'erreurs tels que:

\begin{Verbatim}[commandchars=\\\{\}]
loadSymbolSet(): Unable to access file. (./symbols/symbols.txt)
\end{Verbatim}

ou:

\begin{Verbatim}[commandchars=\\\{\}]
msLoadFontset(): Unable to access file. Error opening fontset ./fonts/fonts.txt.
\end{Verbatim}

Cela signifie que le fichier .map demande des fichiers de polices de caractères ou des symboles, mais que Mapserver ne les trouve pas.

Vous pouvez soit commenter les lignes contenant ces définitions dans le fichier .map (cela est possible si vous n'utilisez pas d'étiquettes ou de styles du fichier \code{symbols.txt}), soit créer ces fichiers (voir ci-dessous).

Le fichier \code{fonts.txt} le plus basique contient la ligne suivante, parce que la police Arial est utilisée pendant la création des fichier .map

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{c}{\PYGZsh{} either relative to the map file or a full path:}
\PYG{n}{arial} \PYG{o}{/}\PYG{n}{usr}\PYG{o}{/}\PYG{n}{share}\PYG{o}{/}\PYG{n}{fonts}\PYG{o}{/}\PYG{n}{truetype}\PYG{o}{/}\PYG{n}{msttcorefonts}\PYG{o}{/}\PYG{n}{arial}\PYG{o}{.}\PYG{n}{ttf}
\end{Verbatim}

Le fichier \code{symbols.txt} le plus basique contient la définition du cercle (car c'est la représentation par défaut des couches de points)

\begin{Verbatim}[commandchars=\\\{\}]
SYMBOLSET
    SYMBOL
    NAME "circle"
    TYPE ellipse
    FILLED true
    POINTS
    1 1
    END
    END
END
\end{Verbatim}


\subsection{Test du fichier .map}
\label{docs/user_manual/plugins/plugins_mapserver_export:testing-the-map-file}
Nous pouvons maintenant tester notre travail.

Si le fichier .map est accessible depuis Mapserver, vous pouvez utiliser une des adresses figurant dans la fenêtre de résultats de l'exportation.

Une autre possibilité est d'utiliser l'outil \textbf{shp2img} pour créer une image du fichier .map. L'utilitaire \textbf{shp2img} fait partie de MapServer et de FWTools. Pour créer une image de notre carte:
\begin{itemize}
\item {} 
Ouvrez une console de commande

\item {} 
Si vous n'avez pas sauvegardé votre fichier dans votre répertoire personnel, déplacez vous vers le bon dossier.

\item {} 
Lancez \code{shp2img -m qgisproject.map -o mapserver\textbackslash{}\_test.png} et affichez l'image

\end{itemize}

Une image PNG est créée avec toutes les couches du projet QGIS. De plus, l'étendue du PNG sera la même que celle du projet. Comme vous le voyez sur la figure {\hyperref[docs/user_manual/plugins/plugins_mapserver_export:figure-mapserver-export-4]{figure\_mapserver\_export\_4}}, toutes les informations, à l'exception des symboles des aéroports, sont incluses.
\phantomsection\label{docs/user_manual/plugins/plugins_mapserver_export:figure-mapserver-export-4}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{mapserver_export_test.png}
\caption{Test PNG created by shp2img with all MapServer Export layers \includegraphics[width=1em]{nix.png}}\end{figure}


\subsection{Utiliser le fichier .map}
\label{docs/user_manual/plugins/plugins_mapserver_export:using-map-file}
Si vous comptez utiliser ce fichier .map pour fournir un service WMS, vous n'aurez probablement rien d'autre à modifier. Par contre si vous comptez l'utiliser comme modèle ou dans une interface personnalisée vous aurez un peu plus d'adaptation à effectuer. Vous pouvez jeter un oeil sur cette vidéo de Christopher Schmidt à l'adresse suivante \emph{\textless{}http://openlayers.org/presentations/mappingyourdata/\textgreater{}}. La version utilisée de QGIS est 0.8 mais la méthode reste valable pour les version plus récentes.


\section{Extension d'Édition hors-ligne}
\label{docs/user_manual/plugins/plugins_offline_editing:offline-editing-plugin}\label{docs/user_manual/plugins/plugins_offline_editing::doc}\label{docs/user_manual/plugins/plugins_offline_editing:offlinedit}
Pour les collectes de données, il est commun d'aller sur le terrain avec un ordinateur ou un téléphone portable. De retour sur le réseau, les modifications doivent être synchronisées avec la source de données initiale, par exemple une base de données PostGIS. Si plusieurs personnes travaillent ensembles sur les mêmes jeux de données, il est difficile de fusionner les éditions à la main, même si les utilisateurs ne changent pas les mêmes entités.

L'extension \includegraphics[width=1.5em]{offline_editing_copy.png}$^{\text{Édition offline}}$ automatise la synchronisation en copiant le contenu d'une source de données (habituellement PostGIS or WFS-T) vers une base Spatialite et en stockant les éditions offlines dans des tables dédiées. Après s'être connecté de nouveau au réseau, il est possible d'appliquer les éditions offline aux jeux de données sources.


\subsection{Utiliser l'extension}
\label{docs/user_manual/plugins/plugins_offline_editing:using-the-plugin}\begin{itemize}
\item {} 
Ouvrez des couches vecteurs, par exemple d'une source de données PostGIS ou WFS-T

\item {} 
Sauvez-les dans un projet

\item {} 
Pressez le bouton  \includegraphics[width=1.5em]{offline_editing_copy.png}$^{\text{Convertir en projet offline}}$ et sélectionnez les couches à sauver. Le contenu des couches est sauvé dans des tables Spatialite.

\item {} 
Éditez les couches hors-ligne.

\item {} 
Après vous être connecté de nouveau au réseau, uploadez les modifications avec le bouton  \includegraphics[width=1.5em]{offline_editing_sync.png} $^{\text{Synchroniser}}$.

\end{itemize}
\phantomsection\label{docs/user_manual/plugins/plugins_offline_editing:figure-offline-editing-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{create_offline_project.png}
\caption{Create an offline project from PostGIS or WFS layers}\end{figure}


\section{Extension GeoRaster Oracle}
\label{docs/user_manual/plugins/plugins_oracle_raster:oracle-georaster-plugin}\label{docs/user_manual/plugins/plugins_oracle_raster::doc}\label{docs/user_manual/plugins/plugins_oracle_raster:oracle-raster}
Dans les bases de données Oracle, les informations rasters sont stockées au sein d'objets SDO\_GEORASTER disponibles avec l'extension Oracle Spatial. Dans QGIS, le support de l'\includegraphics[width=1.5em]{oracle_raster.png} $^{\text{Extension GeoRaster Oracle}}$ est apporté par GDAL et nécessite l'installation et l'utilisation des produits Oracle sur votre machine. Bien que ces produits soient propriétaires, Oracle les fournit gratuitement dans un but de test ou de développement. Voici un exemple assez simple quant au chargement d'images rasters en GeoRaster :

\begin{Verbatim}[commandchars=\\\{\}]
\$ gdal\_translate -of georaster input\_file.tif geor:scott/tiger@orcl
\end{Verbatim}

Le raster va être chargé dans la table par défaut, GDAL\_IMPORT, en tant que colonne nommée \code{RASTER}.


\subsection{Gérer les connexions}
\label{docs/user_manual/plugins/plugins_oracle_raster:managing-connections}
Tout d'abord, l'extension GeoRaster doit être activé dans le gestionnaire d'extension (voir setion {\hyperref[docs/user_manual/plugins/plugins:load-core-plugin]{\emph{Activer une extension principale}}}). Au premier chargement d'un GeoRaster dans QGIS, vous devrez instaurer une connexion vers la base de données Oracle contenant la donnée voulue. Pour ce faire commencez par cliquer sur le bouton \includegraphics[width=1.5em]{oracle_raster.png} $^{\text{Sélection d'un GeoRaster}}$ situé dans la barre d'outils, cela ouvrira la fenêtre de \emph{sélection Oracle Spatial GeoRaster}. Cliquez sur \textbf{{[}Nouveau{]}} puis spécifiez les paramètres de connexion (voir figure {\hyperref[docs/user_manual/plugins/plugins_oracle_raster:figure-oracle-raster-1]{Figure\_oracle\_raster\_1}}):
\begin{itemize}
\item {} 
\textbf{Nom} : Entrez un nom pour la connexion

\item {} 
\textbf{Instance de base de données} : Entrez le nom de la base données à laquelle vous désirez vous connecter

\item {} 
\textbf{Nom d'utilisateur} : Spécifier votre nom utilisateur nécessaire pour accéder à la base de données

\item {} 
\textbf{Mot de passe} : Le mot de passe associé à votre compte utilisateur

\end{itemize}
\phantomsection\label{docs/user_manual/plugins/plugins_oracle_raster:figure-oracle-raster-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{oracle_create_dialog.png}
\caption{Create Oracle connection dialog}\end{figure}

Dans la fenêtre principale \emph{GeoRaster Oracle Spatial}, utilisez la boîte déroulante pour choisir une connection, et cliquez sur \textbf{{[}Connecter{]}} pour accéder à la base de données. Vous pouvez également éditer les paramètres de la connection en cliquant sur \textbf{{[}Editer{]}}, ou supprimer la connection en choisissant \textbf{{[}Supprimer{]}}.


\subsection{Sélection d'un GeoRaster}
\label{docs/user_manual/plugins/plugins_oracle_raster:selecting-a-georaster}
Une fois que la connexion a été établie, la zone de sous-jeux de données affichera toutes les tables contenant une colonne GeoRaster dans un format compatible avec GDAL.

Cliquez sur l'un de ces sous-jeux de données puis sur \textbf{{[}Sélectionner{]}} pour choisir la table. Une nouvelle liste affiche maintenant les noms des colonnes GeoRaster dans cette table, il s'agit généralement d'une courte liste car la plupart des utilisateurs n'ont pas plus d'une ou deux colonnes GeoRaster dans une même table.

Cliquez sur l'une des sous-jeux puis sur \textbf{{[}Sélectionner{]}} pour choisir une combinaison d'une table et d'une colonne La fenêtre montrera alors toutes les lignes contenant un objet GeoRaster Vous remarquerez que la liste affichera la table de données raster et les identifiants Raster.

A tout moment la sélection peut être éditée manuellement pour pointer directement le GeoRaster voulu ou retourner au début pour prendre une autre table.
\phantomsection\label{docs/user_manual/plugins/plugins_oracle_raster:figure-oracle-raster-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{oracle_select_dialog.png}
\caption{Select Oracle GeoRaster dialog}\end{figure}

La zone de saisie de sélection peut servir à utilier une clause Where à la fin de la chaîne d'identification, p. ex. \code{geor:scott/tiger@orcl,gdal\_import,raster,geoid=}. Voir \href{http://www.gdal.org/frmt\_georaster.html}{http://www.gdal.org/frmt\_georaster.html} pour plus d'informations.


\subsection{Afficher un GeoRaster}
\label{docs/user_manual/plugins/plugins_oracle_raster:displaying-georaster}
En sélectionnant un GeoRaster depuis la liste, cette image sera chargée dans QGIS.

La fenêtre de \emph{Sélection de GeoRaster Oracle Spatial} peut maintenant être fermée, la connnexion sera conservée pour une prochaine ouverture, la même liste de sous-jeux de données sera ainsi disponible, ce qui facilitera l'affichage de nouvelles images dans le même contexte.

\begin{notice}{note}{Note:}
Les GeoRasters qui contiennent des tuiles/pyramides s'afficheront plus rapidement mais elles devront être générées hors de QGIS en utilisant Oracle PL/SQL ou gdaladdo.
\end{notice}

L'exemple suivant utilise \code{gdaladdo}:

\begin{Verbatim}[commandchars=\\\{\}]
gdaladdo georaster:scott/tiger@orcl,georaster\PYGZbs{}\_table,georaster,georid=6 \PYGZbs{}
-r nearest 2 4 6 8 16 32
\end{Verbatim}

Cet exemple utilise PL/SQL:

\begin{Verbatim}[commandchars=\\\{\}]
\$ sqlplus scott/tiger
SQL\textgreater{} DECLARE
 gr sdo\_georaster;
BEGIN
    SELECT image INTO gr FROM cities WHERE id = 1 FOR UPDATE;
    sdo\_geor.generatePyramid(gr, 'rLevel=5, resampling=NN');
    UPDATE cities SET image = gr WHERE id = 1;
    COMMIT;
END;
\end{Verbatim}


\section{Extension d'Analyse Raster de Terrain}
\label{docs/user_manual/plugins/plugins_raster_terrain:raster-terrain-analysis-plugin}\label{docs/user_manual/plugins/plugins_raster_terrain:rasterrain}\label{docs/user_manual/plugins/plugins_raster_terrain::doc}
L'extension d'analyse de terrain basée sur les rasters peut être utilisée pour calculer la pente, l'aspect, l'ombrage, le relief et la rugosité d'un modèle numérique d'élévation (DEM). Sa facilité d'utilisation et son interface graphique intuitive permettent de créer de nouvelles couches raster (voir figure {\hyperref[docs/user_manual/plugins/plugins_raster_terrain:figure-raster-terrain-1]{Figure\_raster\_terrain\_1}}).

Description de l'analyse:
\begin{itemize}
\item {} 
\textbf{Pente} : Calcule l'angle de la pente pour chaque cellule (en degrés, en se basant sur une estimation dérivée de 1er ordre).

\item {} 
\textbf{Aspect}: Calcule l'exposition (en degrés dans le sens horaire inverse et en commençant par 0 pour une direction nord).

\item {} 
\textbf{Ombrage} : crée une carte ombrée pour simulée l'apparence tridimensionnelle d'une carte en relief.

\item {} 
Facteur de rugosité : Une mesure quantitative de l'hétérogénéité du terrain, tel que décrit par Riley et al. (1999). Elle est calculée en tout point en mesurant les changement d'élévation dans une grille de 3 par 3 pixels.

\item {} 
\textbf{Relief} : crée une carte ombrée en relief à partir des données d'élévation. La méthode utilisée permet de choisir les couleurs de l'élévation en analyse la fréquence de distribution.

\end{itemize}
\phantomsection\label{docs/user_manual/plugins/plugins_raster_terrain:figure-raster-terrain-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{raster_terrain_dialog.png}
\caption{Raster Terrain Modelling Plugin (slope calculation)}\end{figure}


\subsection{Mettre en oeuvre l'extension}
\label{docs/user_manual/plugins/plugins_raster_terrain:using-the-plugin}\label{docs/user_manual/plugins/plugins_raster_terrain:raster-terrain-usage}\begin{enumerate}
\item {} 
Démarrez QGIS et charger un fichier raster \code{gtopo30} depuis la zone exemple de GRASS.

\item {} 
Chargez l'extension via le gestionnaire d'extension (voir section {\hyperref[docs/user_manual/plugins/plugins:load-core-plugin]{\emph{Activer une extension principale}}})

\item {} 
Sélectionnez une méthode d'analyse (p. ex. \emph{Raster \(\rightarrow\) Analyse de Terrain \(\rightarrow\) Pente}). La fenêtre \emph{Pente} apparaît comme indiqué figure {\hyperref[docs/user_manual/plugins/plugins_raster_terrain:figure-raster-terrain-1]{Figure\_raster\_terrain\_1}}.

\item {} 
Spécifiez un chemin de sortie et le type de fichier produit.

\item {} 
Cliquez sur le bouton \textbf{{[}OK{]}}.

\end{enumerate}


\section{Extension Carte de chaleur}
\label{docs/user_manual/plugins/plugins_heatmap::doc}\label{docs/user_manual/plugins/plugins_heatmap:heatmap-plugin}\label{docs/user_manual/plugins/plugins_heatmap:id1}
L'extension \includegraphics[width=1.5em]{heatmap.png} $^{\text{Carte de chaleur}}$ permet de créer une carte de chaleur à partir d'un couche de ponctuels. Une carte de chaleur est une carte raster montrant la densité ou l'amplitude d'une information relative au point. Le résultat se visualise sous la forme de ``points chauds''.


\subsection{Activer l'extension Carte de chaleur}
\label{docs/user_manual/plugins/plugins_heatmap:activate-the-heatmap-plugin}
Tout d'abord, cette extension principale doit être activée dans le Gestionnaire d'extensions (voir la Rubrique {\hyperref[docs/user_manual/plugins/plugins:load-core-plugin]{\emph{Activer une extension principale}}}). L'extension \includegraphics[width=1.5em]{heatmap.png} se trouve ensuite dans le menu Raster.

Si la barre de menu Raster n'est pas affichée, sélectionnez le menu \emph{Vue -\textgreater{} Barres d'outils -\textgreater{} Raster}.


\subsection{Utiliser l'extension Carte de chaleur}
\label{docs/user_manual/plugins/plugins_heatmap:using-the-heatmap-plugin}
Le bouton \includegraphics[width=1.5em]{heatmap.png} $^{\text{Carte de chaleur}}$ ouvre une fenêtre de l'extension (voir figure {\hyperref[docs/user_manual/plugins/plugins_heatmap:figure-heatmap-2]{figure\_heatmap\_2}}).

Cette fenêtre a les options suivantes:
\begin{itemize}
\item {} 
\textbf{Points en entrée} : Liste déroulante permettant le choix de la couche de points à traiter.

\item {} 
\textbf{Raster en sortie} : Utilisez le bouton \includegraphics{browsebutton.png} pour choisir le dossier et le nom du fichier raster à générer. Il n'est pas nécessaire de mettre une extension

\item {} 
\textbf{Format} : Choisissez ici le format de sortie. Bien que tous les formats reconnus par GDAL puissent être choisis, le format par défaut GeoTIFF est dans la plupart des cas celui le plus adapté.

\item {} 
\textbf{Rayon} : peut être exprimé en mètres ou en unités de carte. Le rayon ne doit pas être choisi trop petit, le rendu d'une carte de chaleur est d'autant meilleur que les points se chevauchent et indiquent ainsi les points chauds!

\item {} 
\textbf{Ratio de corruption} : indique à quelle vitesse la chaleur diminue à partir du centre.
\begin{itemize}
\item {} 
Quand la valeur est à 0(soit le minimum), la chaleur va être concentrée au centre du cercle et sera complète éteinte à son extrémité.

\item {} 
Quand la valeur est à 10 (valeur maximale), la chaleur sera concentrée  sur les bords du cercle et le centre sera complètement éteint. Des valeurs plus grandes sont autorisées, mais le rendu ne changera pas.

\item {} 
Quand la valeur est à 1, la chaleur est iuniforme sur tout le cercle.

\item {} 
Si le ratio est négatif, vous obtiendrez une carte de fraîcheur au lieu d'une carte de chaleur!

\end{itemize}

\end{itemize}

Le case \includegraphics{checkbox.png} \emph{Avancé} vous permet d'accéder à d'autres options.
\begin{itemize}
\item {} 
\textbf{Cellule} et \textbf{Colonne} permettent de changer la taille du pixel dans le raster créé. Un nombre plus important de lignes et de colonnes rendra les pixels plus petits et la taille du fichier en sortie sera plus importante. Le traitement sera plus long. A titre d'exemple, doubler le nombre de lignes double automatiquement le nombre de colonnes et la taille des cellules est divisée par 4, l'emprise du fichier raster créée restant constante!

\item {} 
\textbf{Taille en X} et \textbf{Taille en Y} détermine la taille du pixel dans le fichier raster en sortie et permet de changer le nombre de lignes et de colonnes.

\end{itemize}

La couche de points en entrée peut avoir des attributs permettant de créer la carte de chaleur:
\begin{itemize}
\item {} 
\textbf{Utiliser le rayon depuis}: identifie le champ indiquant le rayon à prendre en compte.

\item {} 
\textbf{Utiliser le poids depuis}: identifie le champ indiquant la pondération à utiliser.

\end{itemize}

Quand la couche raster de sortie est renseignée, le bouton \textbf{{[}OK{]}} peut être actionné pour créer la carte de chaleur. Dans un premier temps, cette couche est uniformément grise et son style doit être modifié pour la transformée en carte de chaleur.

\begin{notice}{warning}{Warning:}
\textbf{Changer les propriétés de taille du raster}

Changer les propriétés de taille du raster modifie le résultat de l'extension. Les zones de chaleur deviennent plus grandes.
\end{notice}


\subsection{Créer une carte de chaleur}
\label{docs/user_manual/plugins/plugins_heatmap:creating-a-heatmap}
Pour l'exemple suivant, nous utiliserons la couche \code{airports} fournie dans l'échantillon de jeux de données de QGIS (voir {\hyperref[docs/user_manual/introduction/getting_started:label-sampledata]{\emph{Échantillon de données}}}). Un excellent tutoriel sur les cartes de chaleur est également disponible à l'adresse \href{http://qgis.spatialthoughts.com/2012/07/tutorial-making-heatmaps-using-qgis-and.html}{http://qgis.spatialthoughts.com}.

Dans la figure {\hyperref[docs/user_manual/plugins/plugins_heatmap:figure-heatmap-1]{Figure\_Heatmap\_1}} sont affichés les aéroports de l'Alaska.
\phantomsection\label{docs/user_manual/plugins/plugins_heatmap:figure-heatmap-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{heatmap_start.png}
\caption{Airports of Alaska \includegraphics[width=1em]{osx.png}}\end{figure}
\begin{enumerate}
\item {} 
Sélectionnez le bouton \includegraphics[width=1.5em]{heatmap.png} $^{\text{Carte de chaleur}}$. La fenêtre de l'extension s'affiche (voir figure {\hyperref[docs/user_manual/plugins/plugins_heatmap:figure-heatmap-2]{Figure\_Heatmap\_2}}).

\item {} 
Dans le champs \emph{Points en entrée} \includegraphics{selectstring.png} sélectionner \code{airports} à partir de la liste déroulante indiquant les couches de points présentes dans le projet.

\item {} 
Dans le champ :guilabel:\code{Raster en sortie}, choisissez le répertoire et le nom du fichier à créer en cliquant sur le bouton \includegraphics{browsebutton.png}, par exemple \code{chaleur\_aeroports}. Il n'est pas nécessaire de mettre une extension de fichier.

\item {} 
Dans le champ \emph{Format}, choisissez  \code{GeoTIFF}.

\item {} 
Dans le champ \emph{Rayon}, mettez \code{1000000} mètres.

\item {} 
Vous pouvez laisser le \emph{Ratio de corruption} à sa valeur par défaut : \code{0.1}.

\item {} 
Cliquez sur \textbf{{[}OK{]}} pour créer et charger la nouvelle couche raster (voir figure {\hyperref[docs/user_manual/plugins/plugins_heatmap:figure-heatmap-3]{Figure\_Heatmap\_3}}).

\end{enumerate}
\phantomsection\label{docs/user_manual/plugins/plugins_heatmap:figure-heatmap-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{heatmap_dialog.png}
\caption{The Heatmap Dialog \includegraphics[width=1em]{osx.png}}\end{figure}

Le résultat après chargement de la carte de chaleur n'est probablement pas le résultat auquel on peut s'attendre. La surface est uniformément grise et ne montre aucune variation. Il est nécessaire de modifier l'apparence de cette couche afin de distinguer la carte de chaleur.
\phantomsection\label{docs/user_manual/plugins/plugins_heatmap:figure-heatmap-3}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{heatmap_loaded_grey.png}
\caption{The heatmap after loading looks like a grey surface \includegraphics[width=1em]{osx.png}}\end{figure}
\begin{enumerate}
\item {} 
Ouvrez les propriétés de la couche \code{chaleur\_aéroports} (sélectionnez la couche \code{chaleur\_aeroports}, faites un clic-droit et dans le menu qui apparaît, sélectionnez \emph{Propriétés}).

\item {} 
Sélectionnez l'onglet \emph{Style}.

\item {} 
Changez la \emph{Palette de couleur} \includegraphics{selectstring.png} de `Dégradé de gris' à `Pseudo-Couleurs'.

\item {} 
Appuyez sur \textbf{{[}Appliquer{]}}.

\item {} 
Allez sur l'onglet \emph{Transparence} et fixez la \emph{Tranparence globale} à 40\%.

\item {} 
Cliquez sur \textbf{{[}OK{]}}

\end{enumerate}

La figure {\hyperref[docs/user_manual/plugins/plugins_heatmap:figure-heatmap-4]{Figure\_Heatmap\_4}} montre le résultat obtenu.
\phantomsection\label{docs/user_manual/plugins/plugins_heatmap:figure-heatmap-4}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{heatmap_loaded_colour.png}
\caption{Final result of heatmap created of airports of Alaska \includegraphics[width=1em]{osx.png}}\end{figure}


\section{Extension Graphe routier}
\label{docs/user_manual/plugins/plugins_road_graph:roadgraph}\label{docs/user_manual/plugins/plugins_road_graph::doc}\label{docs/user_manual/plugins/plugins_road_graph:road-graph-plugin}
L'extension Graphe routier est une extension C++ pour QGIS, qui calcule le chemin le plus court entre deux points sur n'importe quelle couche de polylignes et trace ce chemin au-dessus du réseau routier.
\phantomsection\label{docs/user_manual/plugins/plugins_road_graph:figure-road-graph-2}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{roadgraph_sample.png}
\caption{Road Graph Plugin \includegraphics[width=1em]{nix.png}}\end{figure}

Fonctionnalités principales:
\begin{itemize}
\item {} 
calcule le chemin, sa longueur et le temps de trajet

\item {} 
optimise par longueur ou par temps de trajet

\item {} 
exporte le chemin en couche vectorielle

\item {} 
met en couleur les directions de la route (cela est lent et surtout utile pour déboguer et pour tester le paramétrage)

\end{itemize}

Vous pouvez utiliser n'importe quelle couche polylignes comme couche route dans n'importe quel format géré par QGIS. Deux lignes avec un point commun sont considérées comme connectées. Notez qu'il est obligatoire d'utiliser la projection de la couche comme projection du projet lors de l'édition de la couche route. Cela est dû au fait que le calcul de transformation des coordonnées entre différentes projections introduit des erreurs qui peuvent créer des discontinuités, même quand l'accrochage est utilisé.

Dans la table attributaire de la couche, les champs suivants peuvent être utilisés:
\begin{itemize}
\item {} 
vitesse sur la section de route — champs numériques ;

\item {} 
direction — n'importe quel type qui peut être écrit en chaîne de caractères. Les directions avant et arrière de la géométrie correspondent à une route à sens unique, les deux directions — une route à double sens

\end{itemize}

Si des champs n'ont pas de valeur ou n'existent pas — les valeurs par défaut sont utilisées. Vous pouvez les changer ainsi que certains paramétrages dans la fenêtre de paramétrage de l'extension.


\subsection{Usage}
\label{docs/user_manual/plugins/plugins_road_graph:using-the-plugin}
Après activation de l'extension, vous verrez un panneau supplémentaire sur la gauche de la fenêtre principale de QGIS. Maintenant, configurez l'extension dans la fenêtre \emph{paramétrage de l'extension du graphe routier} dans le menu \emph{Extension -\textgreater{} Graphe routier}.

Sélectionnez un point d'origine et un point de destination sur la couche du réseau routier et cliquez sur bouton \textbf{{[}Calculer{]}}.


\section{Extension Requête Spatiale}
\label{docs/user_manual/plugins/plugins_spatial_query:spatial-query}\label{docs/user_manual/plugins/plugins_spatial_query::doc}\label{docs/user_manual/plugins/plugins_spatial_query:spatial-query-plugin}
L'extension \includegraphics[width=1.5em]{spatialquery.png} $^{\text{Requête Spatiale}}$ permet de réaliser une requête spatiale (sélection d'entités) sur une couche cible en fonction d'une autre couche. Cette fonctionnalité est basée sur la bibliothèque GEOS, les opérations possibles dépendent de la couche source choisie.

Les opérateurs disponibles sont :
\begin{itemize}
\item {} 
Contient

\item {} 
Egale

\item {} 
Recouvre

\item {} 
Croise

\item {} 
Intersecte

\item {} 
Est disjoint

\item {} 
Touche

\item {} 
Est à l'intérieur

\end{itemize}


\subsection{Mettre en oeuvre l'extension}
\label{docs/user_manual/plugins/plugins_spatial_query:using-the-plugin}
Nous souhaitons par exemple trouver les régions dans le jeu de données Alaska qui ont des aéroports. Les étapes suivantes sont à effectuer :
\begin{enumerate}
\item {} 
Lancez QGIS et chargez les couches vectorielles \code{regions.shp} et \code{airports.shp}.

\item {} 
Activez l'extension Requête Spatiale dans le Gestionnaire d'extensions (voir section {\hyperref[docs/user_manual/plugins/plugins:load-core-plugin]{\emph{Activer une extension principale}}}) et cliquez sur le bouton \includegraphics[width=1.5em]{spatialquery.png} $^{\text{Requête Spatiale}}$ qui apparait dans la barre d'outils Extensions. La fenêtre de l'extension s'affiche.

\item {} 
Sélectionnez la couche des régions comme source et celle des aéroports comme référence.

\item {} 
Sélectionnez `A l'intérieur' comme opérateur et cliquez sur \textbf{{[}Appliquer{]}}.

\end{enumerate}

Vous obtenez alors une liste d'identifiants des entités satisfaisant la requête. Vous avez ensuite plusieurs options comme indiqué en figure {\hyperref[docs/user_manual/plugins/plugins_spatial_query:figure-spatial-query-1]{figure\_spatial\_query\_1}}.
\begin{itemize}
\item {} 
Cliquer sur \includegraphics[width=1.5em]{selectesubsetlayer.png} $^{\text{Créer une couche avec la liste des objets}}$

\item {} 
Sélectionner un identifiant de la liste et cliquer sur \includegraphics[width=1.5em]{selectcreatelayer.png} $^{\text{Créer une couche depuis la sélection}}$

\item {} 
Sélectionner `Enlever de la sélection actuelle' dans le champ \emph{Et utiliser le résultat pour} \includegraphics{selectstring.png}.

\item {} 
Vous pouvez également utiliser le \includegraphics{checkbox.png} \emph{Zoom sur l'objet} ou  \includegraphics{checkbox.png} \emph{Enregistrer les messages}.

\end{itemize}
\phantomsection\label{docs/user_manual/plugins/plugins_spatial_query:figure-spatial-query-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{spatial_query_sample.png}
\caption{Spatial Query analysis - regions contain airports \includegraphics[width=1em]{nix.png}}\end{figure}

\index{SPIT}\index{Shapefile\_to\_Postgis\_Import\_Tool}

\section{Extension SPIT}
\label{docs/user_manual/plugins/plugins_spit:spit-plugin}\label{docs/user_manual/plugins/plugins_spit:index-0}\label{docs/user_manual/plugins/plugins_spit::doc}\label{docs/user_manual/plugins/plugins_spit:label-spit}
QGIS est fourni avec une extension nommée SPIT (Shapefile to PostGIS Import Tool ou outil d'import Shapefile vers PostGIS). SPIT peut être utilisé pour charger plusieurs shapefiles simultanément et supporte les schémas. Pour utiliser SPIT, ouvrez le Gestionnaire d'extensions depuis le menu \emph{Extensions}, cochez la case \includegraphics{checkbox.png} \emph{Extension SPIT} and validez sur \textbf{OK}. Le bouton SPIT apparaîtra dans la barre des Extensions.

Pour importer un fichier shape, cliquez sur le bouton \includegraphics{spiticon.png} $^{\text{SPIT}}$ dans la barre d'outils pour afficher la fenêtre \emph{Importer des shapes dans PostgreSQL}. Choisissez la base de données PostGIS à laquelle vous souhaitez vous connecter et cliquez sur \textbf{Connecter}. Si vous les souhaitez, vous pouvez définir ou modifier les options d'importation. A présent, vous pouvez ajouter un ou plusieurs fichiers à la liste d'attente en cliquant sur le bouton \textbf{Ajouter}. Pour effectuer le traitement des fichiers, cliquez sur le bouton \textbf{OK}. La progression de l'importation ainsi que tout message d'erreur ou d'avertissement est affiché au fur et à mesure du traitement du fichier shape.
\phantomsection\label{docs/user_manual/plugins/plugins_spit:figure-spit-1}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=30em]{spit_plugin.png}
\caption{Using SPIT Plugin to import Shape files to PostGIS \includegraphics[width=1em]{nix.png}}\end{figure}
\phantomsection\label{docs/user_manual/plugins/plugins_spit:tip-importing-shapefiles}
\begin{notice}{tip}{Astuce:}
\textbf{L'importation de fichiers Shape contenant des mots réservés PostgreSQL}

Si un fichier Shape ajouté à la liste de traitement contient des champs correspondants à des mots réservés de PostgreSQL, une fenêtre apparaîtra indiquant l'état de chaque champ. Vous pouvez éditer les noms des champs avant l'importation et changer ceux en conflit avec des mots réservés (ou changer le nom d'autres champs). L'importation d'un fichier Shape ayant des mots réservés en tant que champs ne pourra de toute façon pas aboutir.
\end{notice}


\section{Extension SQL Anywhere}
\label{docs/user_manual/plugins/plugins_sql_anywhere:sqlanywhere}\label{docs/user_manual/plugins/plugins_sql_anywhere::doc}\label{docs/user_manual/plugins/plugins_sql_anywhere:sql-anywhere-plugin}
SQL Anywhere est un système de gestion de base de données relationnel propriétaire (SGBDR) édité par Sybase. SQL Anywhere inclut la gestion spatiale selon les standards de l'OGC et des fonctions internes pour exporter dans les formats KML, GML et SVG.
\phantomsection\label{docs/user_manual/plugins/plugins_sql_anywhere:figure-sql-anywhere}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{sql_anywhere.png}
\caption{SQL Anywhere dialog (KDE) \includegraphics[width=1em]{nix.png}}\end{figure}

L'extension \includegraphics[width=1.5em]{sqlanywhere.png} $^{\text{SQL Anywhere}}$ fournie un pilote de données natif à QGIS sous la licence GPL v3.  L'extension permet de se connecter à une base SQL Anywhere. La boîte de dialogue \emph{Ajouter une couche SQL Anywhere} est similaire dans ses fonctionnalités à celle pour PostGIS et SpatiaLite.


\section{Extension Statistiques de zone}
\label{docs/user_manual/plugins/plugins_zonal_statistics:zonal-statistics-plugin}\label{docs/user_manual/plugins/plugins_zonal_statistics::doc}\label{docs/user_manual/plugins/plugins_zonal_statistics:zonal-statistics}
Avec l'extension \includegraphics[width=1.5em]{raster-stats.png} $^{\text{Statistiques de zone}}$, il est possible d'analyser les résultats d'une classification thématique. Elle permet de calculer la valeur des pixels d'une couche raster à partir d'une couche vectorielle de polygones (voir figure {\hyperref[docs/user_manual/plugins/plugins_zonal_statistics:figure-zonal-statistics]{figure\_zonal\_statistics}}). Vous pouvez calculer la somme, la moyenne et le nombre total de pixels situés à l'intérieur d'un polygone. L'extension génère de nouveaux attributs dans la couche vectorielle. Ces attributs peuvent être préfixés avec une chaîne personnalisée.
\phantomsection\label{docs/user_manual/plugins/plugins_zonal_statistics:figure-zonal-statistics}\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=20em]{zonal_statistics.png}
\caption{Zonal statistics dialog (KDE) \includegraphics[width=1em]{nix.png}}\end{figure}


\chapter{Aide et support}
\label{docs/user_manual/preamble/help_and_support:help-and-support}\label{docs/user_manual/preamble/help_and_support::doc}

\section{Listes de diffusion}
\label{docs/user_manual/preamble/help_and_support:mailing-lists}\label{docs/user_manual/preamble/help_and_support:label-helpsupport}
QGIS est en cours de développement, par conséquent il ne fonctionne pas toujours comme prévu. La meilleure manière d'obtenir de l'aide est de rejoindre la liste de diffusion qgis-users, vos questions toucheront une plus large audience et les réponses profiteront à tous.


\subsection{qgis-users}
\label{docs/user_manual/preamble/help_and_support:qgis-users}
Cette liste est utilisée pour les discussions généralistes ainsi que pour des questions spécifiques en rapport avec l'installation et l'utilisation de QGIS. Vous pouvez inscrire à la liste de diffusion qgis-users en allant sur la page suivante : \href{http://lists.osgeo.org/mailman/listinfo/qgis-user}{http://lists.osgeo.org/mailman/listinfo/qgis-user}


\subsection{fossgis-talk-liste}
\label{docs/user_manual/preamble/help_and_support:fossgis-talk-liste}
Pour les germanophones, le FOSSGIS e.V met à disposition la liste fossgis-talk-liste pour discuter des SIG libres de manière générale, QGIS inclus. Vous pouvez vous y inscrire en allant sur la page suivante : \href{https://lists.fossgis.de/mailman/listinfo/fossgis-talk-liste}{https://lists.fossgis.de/mailman/listinfo/fossgis-talk-liste}


\subsection{qgis-developer}
\label{docs/user_manual/preamble/help_and_support:qgis-developer}
Si vous êtes un développeur et que vous faites face à un problème plus technique, il est préférable de rejoindre la liste de diffusion qgis-developer : \href{http://lists.osgeo.org/mailman/listinfo/qgis-developer}{http://lists.osgeo.org/mailman/listinfo/qgis-developer}


\subsection{qgis-commit}
\label{docs/user_manual/preamble/help_and_support:qgis-commit}
À chaque fois qu'un commit est réalisé sur le dépôt du code de QGIS un email est envoyé à cette liste. Si vous voulez être à jour de chaque changement au
code en cours, vous pouvez vous inscrire à cette liste : \href{http://lists.osgeo.org/mailman/listinfo/qgis-commit}{http://lists.osgeo.org/mailman/listinfo/qgis-commit}


\subsection{qgis-trac}
\label{docs/user_manual/preamble/help_and_support:qgis-trac}
Cette liste fournit une notification par courriel liée à la gestion du projet, incluant les rapports de bugs, tâches, et demandes de fonctionnalités. Vous pouvez vous inscrire à cette liste ici : \href{http://lists.osgeo.org/mailman/listinfo/qgis-trac}{http://lists.osgeo.org/mailman/listinfo/qgis-trac}


\subsection{qgis-community-team}
\label{docs/user_manual/preamble/help_and_support:qgis-community-team}
Cette liste reçoit les courriels des thématiques liées à la documentation, au contexte d'aide, au guide utilisateur, à ce qui est lié à Internet donc les sites, listes de diffusion, forums et efforts de traduction. Si vous voulez travailler sur le guide utilisateur, cette liste est un bon point de départ pour poser vos questions. Vous pouvez vous inscrire à cette liste ici : \href{http://lists.osgeo.org/mailman/listinfo/qgis-community-team}{http://lists.osgeo.org/mailman/listinfo/qgis-community-team}


\subsection{qgis-release-team}
\label{docs/user_manual/preamble/help_and_support:qgis-release-team}
Cette liste reçoit les courriels des thématiques comme les procédures de publication de version, paquetage binaire pour différents systèmes et annonce des nouvelles versions à un monde plus large. Vous pouvez vous inscrire à cette liste ici : \href{http://lists.osgeo.org/mailman/listinfo/qgis-release-team}{http://lists.osgeo.org/mailman/listinfo/qgis-release-team}


\subsection{qgis-tr}
\label{docs/user_manual/preamble/help_and_support:qgis-tr}
Cette list se concentre sur l'effort de traduction. Si vous voulez travailler à la traduction du manuel ou de l'interface, c'est un bon point de départ. Vous pouvez vous inscrire à cette liste ici : \href{http://lists.osgeo.org/mailman/listinfo/qgis-tr}{http://lists.osgeo.org/mailman/listinfo/qgis-tr}


\subsection{qgis-edu}
\label{docs/user_manual/preamble/help_and_support:qgis-edu}
Cette liste regroupe les travaux concernant l'apprentissage de QGIS (formations, cours). Vous pouvez vous inscrire à cette liste ici : \href{http://lists.osgeo.org/mailman/listinfo/qgis-edu}{http://lists.osgeo.org/mailman/listinfo/qgis-edu}


\subsection{qgis-psc}
\label{docs/user_manual/preamble/help_and_support:qgis-psc}
Cette liste est utilisée pour discuter des problèmes du Comité de Pilotage lié à l'ensemble de la gestion et de la direction de Quantum GIS. Vous pouvez vous inscrire à cette liste ici : \href{http://lists.osgeo.org/mailman/listinfo/qgis-psc}{http://lists.osgeo.org/mailman/listinfo/qgis-psc}

Vous êtes le bienvenue sur chacune de ces listes. Contribuez à la liste en répondant à des questions et en partageant vos expériences. Remarquez que les listes qgis-commit et qgis-trac ont été configurées pour notification seulement et n'acceptent pas de mail d'utilisateurs.


\section{IRC}
\label{docs/user_manual/preamble/help_and_support:irc}
Nous maintenons une présence sur IRC - rejoignez-nous sur le canal \#qgis sur irc.freenode.net. Faites preuve de patience avant d'obtenir une réponse puisque la plupart des personnes font autre chose et cela peut leur prendre un peu de temps pour remarquer votre question. Un support commercial pour  QGIS est disponible. Regardez la page du site \href{http://qgis.org/en/commercial-support.html}{http://qgis.org/en/commercial-support.html} pour plus d'informations.

Si vous ratez une discussion sur IRC, pas de problème ! Nous loguons toutes les discussions afin que vous puisiez facilement les suivre. Allez simplement sur \href{http://logs.qgis.org}{http://logs.qgis.org} et lisez les logs IRC.


\section{Suivi de bug}
\label{docs/user_manual/preamble/help_and_support:bugtracker}
Bien que la liste de diffusion utilisateur est utile pour des questions générales du type `Comment je fais ceci et cela dans QGIS ?', vous pouvez vouloir nous avertir de bugs dans QGIS. Vous pouvez soumettre un rapport de bug en utilisant le tracker de bug sur \href{http://hub.qgis.org/projects/quantum-gis/issues}{http://hub.qgis.org/projects/quantum-gis/issues}. Lors de la création d'un ticket pour un bug, fournissez s'il vous plait une adresse mail valide où nous pouvons vous demander des informations supplémentaires.

Garder en mémoire que votre bug peut ne pas avoir la priorité à laquelle vous vous attendiez (cela dépendra de sa sévérité). Certains bugs peuvent nécessiter du travail supplémentaire de la part des développeurs pour y remédier et la personne compétente n'est pas forcément disponible.

Les demandes de fonctionnalité peuvent être soumises également en utilisant le même système de ticket que pour les bugs. Assurez-vous de sélectionner le type \code{Feature}.

Si vous avez trouvé un bug et l'avez corrigé vous même, vous pouvez aussi soumettre un patch. Encore, le superbe système de ticket redmine sur \href{http://hub.qgis.org/projects/quantum-gis/issues}{http://hub.qgis.org/projects/quantum-gis/issues} dispose également de cette fonctionnalité. Sélectionnez \code{Patch supplied} dans le menu type et joingnez votre patch avant de soumettre le rapport. Un des développeurs le vérifiera et l'appliquera à QGIS. Ne vous alarmez pas si votre correctif n'est pas appliqué directement --- les développeurs peuvent être occupés sur d'autres tâches.


\section{Blog}
\label{docs/user_manual/preamble/help_and_support:blog}
La communauté QGIS tient également un blog sur \href{http://www.qgis.org/planet}{http://www.qgis.org/planet} qui publie d'intéressants articles à la fois pour les utilisateurs et les développeurs. Vos contributions sont les bienvenues !


\section{Extensions}
\label{docs/user_manual/preamble/help_and_support:plugins}
Le site internet \href{http://plugins.qgis.org}{http://plugins.qgis.org} sert de portail officiel pour les extensions QGIS. Il liste les extensions officielles, stables et expérimentales, de QGIS disponibles depuis le dépôt `Official QGIS Plugin Repository'.


\section{Wiki}
\label{docs/user_manual/preamble/help_and_support:wiki}
Enfin, nous maintenons un site web wiki sur \href{http://hub.qgis.org/projects/quantum-gis/wiki}{http://hub.qgis.org/projects/quantum-gis/wiki} où vous pouvez trouver diverses informations utiles liées au développement de QGIS, plan des versions, liens vers les sites de téléchargement, astuces de traduction des messages, etc. Parcourez le, il y a mille choses intéressantes !


\chapter{Appendix}
\label{docs/user_manual/appendices/appendices:appendix}\label{docs/user_manual/appendices/appendices::doc}
\index{license!GPL}

\section{GNU General Public License}
\label{docs/user_manual/appendices/appendices:index-0}\label{docs/user_manual/appendices/appendices:gpl-appendix}\label{docs/user_manual/appendices/appendices:gnu-general-public-license}
Version 2, June 1991

Copyright (C) 1989, 1991 Free Software Foundation, Inc.
59 Temple Place - Suite 330, Boston, MA  02111-1307, USA

Everyone is permitted to copy and distribute verbatim copies of this license
document, but changing it is not allowed.

Preamble

The licenses for most software are designed to take away your freedom to share
and change it. By contrast, the GNU General Public License is intended to
guarantee your freedom to share and change free software--to make sure the
software is free for all its users. This General Public License applies to
most of the Free Software Foundation's software and to any other program whose
authors commit to using it. (Some other Free Software Foundation software is
covered by the GNU Library General Public License instead.) You can apply it
to your programs, too.

When we speak of free software, we are referring to freedom, not price. Our
General Public Licenses are designed to make sure that you have the freedom to
distribute copies of free software (and charge for this service if you wish),
that you receive source code or can get it if you want it, that you can change
the software or use pieces of it in new free programs; and that you know you
can do these things.

To protect your rights, we need to make restrictions that forbid anyone to
deny you these rights or to ask you to surrender the rights. These
restrictions translate to certain responsibilities for you if you distribute
copies of the software, or if you modify it.

For example, if you distribute copies of such a program, whether gratis or for
a fee, you must give the recipients all the rights that you have. You must
make sure that they, too, receive or can get the source code. And you must
show them these terms so they know their rights.

We protect your rights with two steps: (1) copyright the software, and (2)
offer you this license which gives you legal permission to copy, distribute
and/or modify the software.

Also, for each author's protection and ours, we want to make certain that
everyone understands that there is no warranty for this free software. If the
software is modified by someone else and passed on, we want its recipients to
know that what they have is not the original, so that any problems introduced
by others will not reflect on the original authors' reputations.

Finally, any free program is threatened constantly by software patents. We
wish to avoid the danger that redistributors of a free program will
individually obtain patent licenses, in effect making the program proprietary.
To prevent this, we have made it clear that any patent must be licensed for
everyone's free use or not licensed at all.

The precise terms and conditions for copying, distribution and modification
follow.
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
\begin{enumerate}
\setcounter{enumi}{-1}
\item {} 
This License applies to any program or other work which contains a notice
placed by the copyright holder saying it may be distributed under the terms of
this General Public License. The ``Program'', below, refers to any such program
or work, and a ``work based on the Program'' means either the Program or any
derivative work under copyright law: that is to say, a work containing the
Program or a portion of it, either verbatim or with modifications and/or
translated into another language. (Hereinafter, translation is included
without limitation in the term ``modification''.) Each licensee is addressed as
``you''.

Activities other than copying, distribution and modification are not covered
by this License; they are outside its scope. The act of running the Program is
not restricted, and the output from the Program is covered only if its
contents constitute a work based on the Program (independent of having been
made by running the Program). Whether that is true depends on what the Program
does.

\item {} 
You may copy and distribute verbatim copies of the Program's source code as
you receive it, in any medium, provided that you conspicuously and
appropriately publish on each copy an appropriate copyright notice and
disclaimer of warranty; keep intact all the notices that refer to this License
and to the absence of any warranty; and give any other recipients of the
Program a copy of this License along with the Program.

You may charge a fee for the physical act of transferring a copy, and you may
at your option offer warranty protection in exchange for a fee.

\item {} 
You may modify your copy or copies of the Program or any portion of it,
thus forming a work based on the Program, and copy and distribute such
modifications or work under the terms of Section 1 above, provided that you
also meet all of these conditions:
\begin{enumerate}
\item {} 
You must cause the modified files to carry prominent notices stating
that you changed the files and the date of any change.

\item {} 
You must cause any work that you distribute or publish, that in whole
or in part contains or is derived from the Program or any part thereof, to be
licensed as a whole at no charge to all third parties under the terms of this
License.

\item {} 
If the modified program normally reads commands interactively when run,
you must cause it, when started running for such interactive use in the most
ordinary way, to print or display an announcement including an appropriate
copyright notice and a notice that there is no warranty (or else, saying that
you provide a warranty) and that users may redistribute the program under
these conditions, and telling the user how to view a copy of this License.
(Exception: if the Program itself is interactive but does not normally print
such an announcement, your work based on the Program is not required to print
an announcement.)

\end{enumerate}

These requirements apply to the modified work as a whole. If identifiable
sections of that work are not derived from the Program, and can be reasonably
considered independent and separate works in themselves, then this License,
and its terms, do not apply to those sections when you distribute them as
separate works. But when you distribute the same sections as part of a whole
which is a work based on the Program, the distribution of the whole must be on
the terms of this License, whose permissions for other licensees extend to the
entire whole, and thus to each and every part regardless of who wrote it.

Thus, it is not the intent of this section to claim rights or contest your
rights to work written entirely by you; rather, the intent is to exercise the
right to control the distribution of derivative or collective works based on
the Program.

In addition, mere aggregation of another work not based on the Program with
the Program (or with a work based on the Program) on a volume of a storage or
distribution medium does not bring the other work under the scope of this
License.

\item {} 
You may copy and distribute the Program (or a work based on it, under
Section 2) in object code or executable form under the terms of Sections 1 and
2 above provided that you also do one of the following:
\begin{enumerate}
\item {} 
Accompany it with the complete corresponding machine-readable source
code, which must be distributed under the terms of Sections 1 and 2 above on a
medium customarily used for software interchange; or,

\item {} 
Accompany it with a written offer, valid for at least three years, to
give any third party, for a charge no more than your cost of physically
performing source distribution, a complete machine-readable copy of the
corresponding source code, to be distributed under the terms of Sections 1 and
2 above on a medium customarily used for software interchange; or,

\item {} 
Accompany it with the information you received as to the offer to
distribute corresponding source code. (This alternative is allowed only for
noncommercial distribution and only if you received the program in object code
or executable form with such an offer, in accord with Subsection b above.)

\end{enumerate}

The source code for a work means the preferred form of the work for making
modifications to it. For an executable work, complete source code means all
the source code for all modules it contains, plus any associated interface
definition files, plus the scripts used to control compilation and
installation of the executable. However, as a special exception, the source
code distributed need not include anything that is normally distributed (in
either source or binary form) with the major components (compiler, kernel, and
so on) of the operating system on which the executable runs, unless that
component itself accompanies the executable.

If distribution of executable or object code is made by offering access to
copy from a designated place, then offering equivalent access to copy the
source code from the same place counts as distribution of the source code,
even though third parties are not compelled to copy the source along with the
object code.

\item {} 
You may not copy, modify, sublicense, or distribute the Program except as
expressly provided under this License. Any attempt otherwise to copy, modify,
sublicense or distribute the Program is void, and will automatically terminate
your rights under this License. However, parties who have received copies, or
rights, from you under this License will not have their licenses terminated so
long as such parties remain in full compliance.

\item {} 
You are not required to accept this License, since you have not signed it.
However, nothing else grants you permission to modify or distribute the
Program or its derivative works. These actions are prohibited by law if you do
not accept this License. Therefore, by modifying or distributing the Program
(or any work based on the Program), you indicate your acceptance of this
License to do so, and all its terms and conditions for copying, distributing
or modifying the Program or works based on it.

\item {} 
Each time you redistribute the Program (or any work based on the Program),
the recipient automatically receives a license from the original licensor to
copy, distribute or modify the Program subject to these terms and conditions.
You may not impose any further restrictions on the recipients' exercise of the
rights granted herein. You are not responsible for enforcing compliance by
third parties to this License.

\item {} 
If, as a consequence of a court judgment or allegation of patent
infringement or for any other reason (not limited to patent issues),
conditions are imposed on you (whether by court order, agreement or otherwise)
that contradict the conditions of this License, they do not excuse you from
the conditions of this License. If you cannot distribute so as to satisfy
simultaneously your obligations under this License and any other pertinent
obligations, then as a consequence you may not distribute the Program at all.
For example, if a patent license would not permit royalty-free redistribution
of the Program by all those who receive copies directly or indirectly through
you, then the only way you could satisfy both it and this License would be to
refrain entirely from distribution of the Program.

If any portion of this section is held invalid or unenforceable under any
particular circumstance, the balance of the section is intended to apply and
the section as a whole is intended to apply in other circumstances.

It is not the purpose of this section to induce you to infringe any patents or
other property right claims or to contest validity of any such claims; this
section has the sole purpose of protecting the integrity of the free software
distribution system, which is implemented by public license practices. Many
people have made generous contributions to the wide range of software
distributed through that system in reliance on consistent application of that
system; it is up to the author/donor to decide if he or she is willing to
distribute software through any other system and a licensee cannot impose that
choice.

This section is intended to make thoroughly clear what is believed to be a
consequence of the rest of this License.

\item {} 
If the distribution and/or use of the Program is restricted in certain
countries either by patents or by copyrighted interfaces, the original
copyright holder who places the Program under this License may add an explicit
geographical distribution limitation excluding those countries, so that
distribution is permitted only in or among countries not thus excluded. In
such case, this License incorporates the limitation as if written in the body
of this License.

\item {} 
The Free Software Foundation may publish revised and/or new versions of the
General Public License from time to time. Such new versions will be similar in
spirit to the present version, but may differ in detail to address new
problems or concerns.

Each version is given a distinguishing version number. If the Program
specifies a version number of this License which applies to it and ``any later
version'', you have the option of following the terms and conditions either of
that version or of any later version published by the Free Software
Foundation. If the Program does not specify a version number of this License,
you may choose any version ever published by the Free Software Foundation.

\item {} 
If you wish to incorporate parts of the Program into other free programs
whose distribution conditions are different, write to the author to ask for
permission. For software which is copyrighted by the Free Software Foundation,
write to the Free Software Foundation; we sometimes make exceptions for this.
Our decision will be guided by the two goals of preserving the free status of
all derivatives of our free software and of promoting the sharing and reuse of
software generally.

\end{enumerate}

NO WARRANTY
\begin{enumerate}
\setcounter{enumi}{10}
\item {} 
BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR
THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE
STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE
PROGRAM ``AS IS'' WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND
PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE,
YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.

\item {} 
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL
ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE
THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE
OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR
DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR
A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH
HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

\end{enumerate}

\textbf{Quantum GIS Qt exception for GPL}
\begin{quote}

In addition, as a special exception, the QGIS Development Team gives
permission to link the code of this program with the Qt library,
including but not limited to the following versions (both free and
commercial): Qt/Non-commerical Windows, Qt/Windows, Qt/X11, Qt/Mac, and
Qt/Embedded (or with modified versions of Qt that use the same license
as Qt), and distribute linked combinations including the two. You must
obey the GNU General Public License in all respects for all of the code
used other than Qt. If you modify this file, you may extend this
exception to your version of the file, but you are not obligated to do
so. If you do not wish to do so, delete this exception statement from
your version.
\end{quote}


\section{GNU Free Documentation License}
\label{docs/user_manual/appendices/appendices:gfl-appendix}\label{docs/user_manual/appendices/appendices:gnu-free-documentation-license}\begin{quote}

Version 1.3, 3 November 2008

Copyright  2000, 2001, 2002, 2007, 2008  Free Software Foundation, Inc

\textless{}\href{http://fsf.org/}{http://fsf.org/}\textgreater{}
\end{quote}

Everyone is permitted to copy and distribute verbatim copies of this
license document, but changing it is not allowed.

\textbf{Preamble}

The purpose of this License is to make a manual, textbook, or other
functional and useful document ``free'' in the sense of freedom: to
assure everyone the effective freedom to copy and redistribute it,
with or without modifying it, either commercially or noncommercially.
Secondarily, this License preserves for the author and publisher a way
to get credit for their work, while not being considered responsible
for modifications made by others.

This License is a kind of ``copyleft'', which means that derivative
works of the document must themselves be free in the same sense.  It
complements the GNU General Public License, which is a copyleft
license designed for free software.

We have designed this License in order to use it for manuals for free
software, because free software needs free documentation: a free
program should come with manuals providing the same freedoms that the
software does.  But this License is not limited to software manuals;
it can be used for any textual work, regardless of subject matter or
whether it is published as a printed book.  We recommend this License
principally for works whose purpose is instruction or reference.

\textbf{1. APPLICABILITY AND DEFINITIONS}

This License applies to any manual or other work, in any medium, that
contains a notice placed by the copyright holder saying it can be
distributed under the terms of this License.  Such a notice grants a
world-wide, royalty-free license, unlimited in duration, to use that
work under the conditions stated herein.  The \textbf{Document}, below,
refers to any such manual or work.  Any member of the public is a
licensee, and is addressed as ``\textbf{you}''.  You accept the license if you
copy, modify or distribute the work in a way requiring permission
under copyright law.

A ``\textbf{Modified Version}'' of the Document means any work containing the
Document or a portion of it, either copied verbatim, or with
modifications and/or translated into another language.

A ``\textbf{Secondary Section}'' is a named appendix or a front-matter section of
the Document that deals exclusively with the relationship of the
publishers or authors of the Document to the Document's overall subject
(or to related matters) and contains nothing that could fall directly
within that overall subject.  (Thus, if the Document is in part a
textbook of mathematics, a Secondary Section may not explain any
mathematics.)  The relationship could be a matter of historical
connection with the subject or with related matters, or of legal,
commercial, philosophical, ethical or political position regarding
them.

The ``\textbf{Invariant Sections}'' are certain Secondary Sections whose titles
are designated, as being those of Invariant Sections, in the notice
that says that the Document is released under this License.  If a
section does not fit the above definition of Secondary then it is not
allowed to be designated as Invariant.  The Document may contain zero
Invariant Sections.  If the Document does not identify any Invariant
Sections then there are none.

The ``\textbf{Cover Texts}'' are certain short passages of text that are listed,
as Front-Cover Texts or Back-Cover Texts, in the notice that says that
the Document is released under this License.  A Front-Cover Text may
be at most 5 words, and a Back-Cover Text may be at most 25 words.

A ``\textbf{Transparent}'' copy of the Document means a machine-readable copy,
represented in a format whose specification is available to the
general public, that is suitable for revising the document
straightforwardly with generic text editors or (for images composed of
pixels) generic paint programs or (for drawings) some widely available
drawing editor, and that is suitable for input to text formatters or
for automatic translation to a variety of formats suitable for input
to text formatters.  A copy made in an otherwise Transparent file
format whose markup, or absence of markup, has been arranged to thwart
or discourage subsequent modification by readers is not Transparent.
An image format is not Transparent if used for any substantial amount
of text.  A copy that is not ``Transparent'' is called \textbf{Opaque}.

Examples of suitable formats for Transparent copies include plain
ASCII without markup, Texinfo input format, LaTeX input format, SGML
or XML using a publicly available DTD, and standard-conforming simple
HTML, PostScript or PDF designed for human modification.  Examples of
transparent image formats include PNG, XCF and JPG.  Opaque formats
include proprietary formats that can be read and edited only by
proprietary word processors, SGML or XML for which the DTD and/or
processing tools are not generally available, and the
machine-generated HTML, PostScript or PDF produced by some word
processors for output purposes only.

The ``\textbf{Title Page}'' means, for a printed book, the title page itself,
plus such following pages as are needed to hold, legibly, the material
this License requires to appear in the title page.  For works in
formats which do not have any title page as such, ``Title Page'' means
the text near the most prominent appearance of the work's title,
preceding the beginning of the body of the text.

The ``\textbf{publisher}'' means any person or entity that distributes
copies of the Document to the public.

A section ``\textbf{Entitled XYZ}'' means a named subunit of the Document whose
title either is precisely XYZ or contains XYZ in parentheses following
text that translates XYZ in another language.  (Here XYZ stands for a
specific section name mentioned below, such as ``\textbf{Acknowledgements}'',
``\textbf{Dedications}'', ``\textbf{Endorsements}'', or ``\textbf{History}''.)
To ``\textbf{Preserve the Title}''
of such a section when you modify the Document means that it remains a
section ``Entitled XYZ'' according to this definition.

The Document may include Warranty Disclaimers next to the notice which
states that this License applies to the Document.  These Warranty
Disclaimers are considered to be included by reference in this
License, but only as regards disclaiming warranties: any other
implication that these Warranty Disclaimers may have is void and has
no effect on the meaning of this License.

\textbf{2. VERBATIM COPYING}

You may copy and distribute the Document in any medium, either
commercially or noncommercially, provided that this License, the
copyright notices, and the license notice saying this License applies
to the Document are reproduced in all copies, and that you add no other
conditions whatsoever to those of this License.  You may not use
technical measures to obstruct or control the reading or further
copying of the copies you make or distribute.  However, you may accept
compensation in exchange for copies.  If you distribute a large enough
number of copies you must also follow the conditions in section 3.

You may also lend copies, under the same conditions stated above, and
you may publicly display copies.

\textbf{3. COPYING IN QUANTITY}

If you publish printed copies (or copies in media that commonly have
printed covers) of the Document, numbering more than 100, and the
Document's license notice requires Cover Texts, you must enclose the
copies in covers that carry, clearly and legibly, all these Cover
Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on
the back cover.  Both covers must also clearly and legibly identify
you as the publisher of these copies.  The front cover must present
the full title with all words of the title equally prominent and
visible.  You may add other material on the covers in addition.
Copying with changes limited to the covers, as long as they preserve
the title of the Document and satisfy these conditions, can be treated
as verbatim copying in other respects.

If the required texts for either cover are too voluminous to fit
legibly, you should put the first ones listed (as many as fit
reasonably) on the actual cover, and continue the rest onto adjacent
pages.

If you publish or distribute Opaque copies of the Document numbering
more than 100, you must either include a machine-readable Transparent
copy along with each Opaque copy, or state in or with each Opaque copy
a computer-network location from which the general network-using
public has access to download using public-standard network protocols
a complete Transparent copy of the Document, free of added material.
If you use the latter option, you must take reasonably prudent steps,
when you begin distribution of Opaque copies in quantity, to ensure
that this Transparent copy will remain thus accessible at the stated
location until at least one year after the last time you distribute an
Opaque copy (directly or through your agents or retailers) of that
edition to the public.

It is requested, but not required, that you contact the authors of the
Document well before redistributing any large number of copies, to give
them a chance to provide you with an updated version of the Document.

\textbf{4. MODIFICATIONS}

You may copy and distribute a Modified Version of the Document under
the conditions of sections 2 and 3 above, provided that you release
the Modified Version under precisely this License, with the Modified
Version filling the role of the Document, thus licensing distribution
and modification of the Modified Version to whoever possesses a copy
of it.  In addition, you must do these things in the Modified Version:
\begin{enumerate}
\item {} 
Use in the Title Page (and on the covers, if any) a title distinct
from that of the Document, and from those of previous versions
(which should, if there were any, be listed in the History section
of the Document).  You may use the same title as a previous version
if the original publisher of that version gives permission.

\item {} 
List on the Title Page, as authors, one or more persons or entities
responsible for authorship of the modifications in the Modified
Version, together with at least five of the principal authors of the
Document (all of its principal authors, if it has fewer than five),
unless they release you from this requirement.

\item {} 
State on the Title page the name of the publisher of the
Modified Version, as the publisher.

\item {} 
Preserve all the copyright notices of the Document.

\item {} 
Add an appropriate copyright notice for your modifications
adjacent to the other copyright notices.

\item {} 
Include, immediately after the copyright notices, a license notice
giving the public permission to use the Modified Version under the
terms of this License, in the form shown in the Addendum below.

\item {} 
Preserve in that license notice the full lists of Invariant Sections
and required Cover Texts given in the Document's license notice.

\item {} 
Include an unaltered copy of this License.

\item {} 
Preserve the section Entitled ``History'', Preserve its Title, and add
to it an item stating at least the title, year, new authors, and
publisher of the Modified Version as given on the Title Page.  If
there is no section Entitled ``History'' in the Document, create one
stating the title, year, authors, and publisher of the Document as
given on its Title Page, then add an item describing the Modified
Version as stated in the previous sentence.

\item {} 
Preserve the network location, if any, given in the Document for
public access to a Transparent copy of the Document, and likewise
the network locations given in the Document for previous versions
it was based on.  These may be placed in the ``History'' section.
You may omit a network location for a work that was published at
least four years before the Document itself, or if the original
publisher of the version it refers to gives permission.

\item {} 
For any section Entitled ``Acknowledgements'' or ``Dedications'',
Preserve the Title of the section, and preserve in the section all
the substance and tone of each of the contributor acknowledgements
and/or dedications given therein.

\item {} 
Preserve all the Invariant Sections of the Document,
unaltered in their text and in their titles.  Section numbers
or the equivalent are not considered part of the section titles.

\item {} 
Delete any section Entitled ``Endorsements''.  Such a section
may not be included in the Modified Version.

\item {} 
Do not retitle any existing section to be Entitled ``Endorsements''
or to conflict in title with any Invariant Section.

\item {} 
Preserve any Warranty Disclaimers.

\end{enumerate}

If the Modified Version includes new front-matter sections or
appendices that qualify as Secondary Sections and contain no material
copied from the Document, you may at your option designate some or all
of these sections as invariant.  To do this, add their titles to the
list of Invariant Sections in the Modified Version's license notice.
These titles must be distinct from any other section titles.

You may add a section Entitled ``Endorsements'', provided it contains
nothing but endorsements of your Modified Version by various
parties---for example, statements of peer review or that the text has
been approved by an organization as the authoritative definition of a
standard.

You may add a passage of up to five words as a Front-Cover Text, and a
passage of up to 25 words as a Back-Cover Text, to the end of the list
of Cover Texts in the Modified Version.  Only one passage of
Front-Cover Text and one of Back-Cover Text may be added by (or
through arrangements made by) any one entity.  If the Document already
includes a cover text for the same cover, previously added by you or
by arrangement made by the same entity you are acting on behalf of,
you may not add another; but you may replace the old one, on explicit
permission from the previous publisher that added the old one.

The author(s) and publisher(s) of the Document do not by this License
give permission to use their names for publicity for or to assert or
imply endorsement of any Modified Version.

\textbf{5. COMBINING DOCUMENTS}

You may combine the Document with other documents released under this
License, under the terms defined in section 4 above for modified
versions, provided that you include in the combination all of the
Invariant Sections of all of the original documents, unmodified, and
list them all as Invariant Sections of your combined work in its
license notice, and that you preserve all their Warranty Disclaimers.

The combined work need only contain one copy of this License, and
multiple identical Invariant Sections may be replaced with a single
copy.  If there are multiple Invariant Sections with the same name but
different contents, make the title of each such section unique by
adding at the end of it, in parentheses, the name of the original
author or publisher of that section if known, or else a unique number.
Make the same adjustment to the section titles in the list of
Invariant Sections in the license notice of the combined work.

In the combination, you must combine any sections Entitled ``History''
in the various original documents, forming one section Entitled
``History''; likewise combine any sections Entitled ``Acknowledgements'',
and any sections Entitled ``Dedications''.  You must delete all sections
Entitled ``Endorsements''.

\textbf{6. COLLECTIONS OF DOCUMENTS}

You may make a collection consisting of the Document and other documents
released under this License, and replace the individual copies of this
License in the various documents with a single copy that is included in
the collection, provided that you follow the rules of this License for
verbatim copying of each of the documents in all other respects.

You may extract a single document from such a collection, and distribute
it individually under this License, provided you insert a copy of this
License into the extracted document, and follow this License in all
other respects regarding verbatim copying of that document.

\textbf{7. AGGREGATION WITH INDEPENDENT WORKS}

A compilation of the Document or its derivatives with other separate
and independent documents or works, in or on a volume of a storage or
distribution medium, is called an ``aggregate'' if the copyright
resulting from the compilation is not used to limit the legal rights
of the compilation's users beyond what the individual works permit.
When the Document is included in an aggregate, this License does not
apply to the other works in the aggregate which are not themselves
derivative works of the Document.

If the Cover Text requirement of section 3 is applicable to these
copies of the Document, then if the Document is less than one half of
the entire aggregate, the Document's Cover Texts may be placed on
covers that bracket the Document within the aggregate, or the
electronic equivalent of covers if the Document is in electronic form.
Otherwise they must appear on printed covers that bracket the whole
aggregate.

\textbf{8. TRANSLATION}

Translation is considered a kind of modification, so you may
distribute translations of the Document under the terms of section 4.
Replacing Invariant Sections with translations requires special
permission from their copyright holders, but you may include
translations of some or all Invariant Sections in addition to the
original versions of these Invariant Sections.  You may include a
translation of this License, and all the license notices in the
Document, and any Warranty Disclaimers, provided that you also include
the original English version of this License and the original versions
of those notices and disclaimers.  In case of a disagreement between
the translation and the original version of this License or a notice
or disclaimer, the original version will prevail.

If a section in the Document is Entitled ``Acknowledgements'',
``Dedications'', or ``History'', the requirement (section 4) to Preserve
its Title (section 1) will typically require changing the actual
title.

\textbf{9. TERMINATION}

You may not copy, modify, sublicense, or distribute the Document
except as expressly provided under this License.  Any attempt
otherwise to copy, modify, sublicense, or distribute it is void, and
will automatically terminate your rights under this License.

However, if you cease all violation of this License, then your license
from a particular copyright holder is reinstated (a) provisionally,
unless and until the copyright holder explicitly and finally
terminates your license, and (b) permanently, if the copyright holder
fails to notify you of the violation by some reasonable means prior to
60 days after the cessation.

Moreover, your license from a particular copyright holder is
reinstated permanently if the copyright holder notifies you of the
violation by some reasonable means, this is the first time you have
received notice of violation of this License (for any work) from that
copyright holder, and you cure the violation prior to 30 days after
your receipt of the notice.

Termination of your rights under this section does not terminate the
licenses of parties who have received copies or rights from you under
this License.  If your rights have been terminated and not permanently
reinstated, receipt of a copy of some or all of the same material does
not give you any rights to use it.

\textbf{10. FUTURE REVISIONS OF THIS LICENSE}

The Free Software Foundation may publish new, revised versions
of the GNU Free Documentation License from time to time.  Such new
versions will be similar in spirit to the present version, but may
differ in detail to address new problems or concerns.  See
\href{http://www.gnu.org/copyleft/}{http://www.gnu.org/copyleft/}.

Each version of the License is given a distinguishing version number.
If the Document specifies that a particular numbered version of this
License ``or any later version'' applies to it, you have the option of
following the terms and conditions either of that specified version or
of any later version that has been published (not as a draft) by the
Free Software Foundation.  If the Document does not specify a version
number of this License, you may choose any version ever published (not
as a draft) by the Free Software Foundation.  If the Document
specifies that a proxy can decide which future versions of this
License can be used, that proxy's public statement of acceptance of a
version permanently authorizes you to choose that version for the
Document.

\textbf{11. RELICENSING}

``Massive Multiauthor Collaboration Site'' (or ``MMC Site'') means any
World Wide Web server that publishes copyrightable works and also
provides prominent facilities for anybody to edit those works.  A
public wiki that anybody can edit is an example of such a server.  A
``Massive Multiauthor Collaboration'' (or ``MMC'') contained in the
site means any set of copyrightable works thus published on the MMC
site.

``CC-BY-SA'' means the Creative Commons Attribution-Share Alike 3.0
license published by Creative Commons Corporation, a not-for-profit
corporation with a principal place of business in San Francisco,
California, as well as future copyleft versions of that license
published by that same organization.

``Incorporate'' means to publish or republish a Document, in whole or
in part, as part of another Document.

An MMC is ``eligible for relicensing'' if it is licensed under this
License, and if all works that were first published under this License
somewhere other than this MMC, and subsequently incorporated in whole
or in part into the MMC, (1) had no cover texts or invariant sections,
and (2) were thus incorporated prior to November 1, 2008.

The operator of an MMC Site may republish an MMC contained in the site
under CC-BY-SA on the same site at any time before August 1, 2009,
provided the MMC is eligible for relicensing.

\textbf{ADDENDUM: How to use this License for your documents}

To use this License in a document you have written, include a copy of
the License in the document and put the following copyright and
license notices just after the title page:
\begin{quote}

Copyright © YEAR  YOUR NAME.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
A copy of the license is included in the section entitled ``GNU
Free Documentation License''.
\end{quote}

If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts,
replace the ``with ... Texts.'' line with this:
\begin{quote}

with the Invariant Sections being LIST THEIR TITLES, with the
Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST.
\end{quote}

If you have Invariant Sections without Cover Texts, or some other
combination of the three, merge those two alternatives to suit the
situation.

If your document contains nontrivial examples of program code, we
recommend releasing these examples in parallel under your choice of
free software license, such as the GNU General Public License,
to permit their use in free software.


\chapter{Bibliographie}
\label{docs/user_manual/literature_web/literature_and_web_references::doc}\label{docs/user_manual/literature_web/literature_and_web_references:literature-and-web-references}\label{docs/user_manual/literature_web/literature_and_web_references:literature-and-web}
GDAL-SOFTWARE-SUITE. Geospatial data abstraction library. htt://www.gdal.org, 2012.

GRASS-PROJECT. Geographic ressource analysis support system. \href{http://grass.osgeo.org}{http://grass.osgeo.org} , 2012.

MITCHELL, T. Web mapping illustrated, 2005.

NETELER, M., AND MITASOVA, H. Open source gis: A grass gis approach, 2008.

OGR-SOFTWARE-SUITE. Geospatial data abstraction library. \href{http://www.gdal.org/ogr}{http://www.gdal.org/ogr} , 2012.

OPEN-GEOSPATIAL-CONSORTIUM. Web map service (1.1.1) implementation specification. \href{http://portal.opengeospatial.org}{http://portal.opengeospatial.org}, 2002.

OPEN-GEOSPATIAL-CONSORTIUM. Web map service (1.3.0) implementation specification. \href{http://portal.opengeospatial.org}{http://portal.opengeospatial.org}, 2004.

POSTGIS-PROJECT. Spatial support for postgresql. \href{http://postgis.refractions.net/}{http://postgis.refractions.net/} , 2012.



\renewcommand{\indexname}{Index}
\printindex
\end{document}
