% Generated by Sphinx.
\def\sphinxdocclass{report}
\documentclass[a4paper,10pt,italian]{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}{Release}
\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}
\shorthandoff{"}
\maketitle
\tableofcontents
\phantomsection\label{docs/user_manual/index::doc}\phantomsection\label{docs/user_manual/index:qgis-manual-index-reference}



\chapter{Preamble}
\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}
Questo documento è la guida originale del software Quantim GIS, qui descritto. In molti casi, il software e l'hardware descritti in questo documento sono marchi registrati e sono pertanto soggetti ai relativi requisiti legali. Qauntum GIS è soggetto alla licenza GNU General Public License. Maggiori informazioni sono disponibili sulla homepage di Quantum GIS \href{http://www.qgis.org}{http://www.qgis.org}.

I dettagli, i dati, i risultati ecc. presenti n questo documento sono sati scritti e verificati al meglio delle conoscenze e della responsabilità degli autori e degli editori. Ciononostante, possono essere presetni errori nei contenuti.

Pertanto, nessun dato è soggetto ad alcun obbligo o garanzia. Gli autori, i redattori e gli editori non si assumono alcun obbligo o responsabilità per malfunzionamenti e loro conseguenze. Sono tutti invitati a segnalare eventuali errori.

Questo documento è stato scritto tramite reStructuredText. E' disponibile come codice sorgente reST tramite \href{https://github.com/qgis/QGIS-Documentation}{github} è disponibile online in formato HTML e PDF tramite \href{http://documentation.qgis.org}{http://documentation.qgis.org}. Versioni tradotte di questo documento possono anche essere scaricate in diversi formati dall'area di documentazione del progetto QGIS. Per ulteriori informazioni su come contribuire a questo documento e su come tradurlo, visitate l'indirizzo \href{http://www.qgis.org/wiki/}{http://www.qgis.org/wiki/}.

\textbf{Collegamenti presenti in questo dicumento}

Questo documento contiene collegamenti interni ed esterni. Cliccando su un collegamento interno ci si sposta all'interno del documento, mentre cliccando su un collegamento esterno si apre un indirizzo internet. In formato PDF, i collegamenti interni ed esterni sono mostrati in colore blu e sono gestiti dal browser del sistema. In frmato HTML, il browser gestisce e mostra entrambi allo stesso modo.

\textbf{Autori e redattori delle guide per l'utente, l'installazione e la programmazione in codice}

\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}

L'aggiornamento di questo manulae per l'utente è stato gentilmente sponsorizzato da \href{http://www.so.ch/departemente/bau-und-justiz/amt-fuer-geoinformation.html}{Kanton Solothurn}, Switzerland.

Copyright (c) 2004 - 2013 QGIS Development Team

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

\textbf{License of this document}

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
Appendix {\hyperref[docs/user_manual/appendices/appendices:gfl-appendix]{\emph{GNU Free Documentation License}}}.


\chapter{Convenzioni}
\label{docs/user_manual/preamble/conventions:label-conventions}\label{docs/user_manual/preamble/conventions::doc}\label{docs/user_manual/preamble/conventions:conventions}
Questa sezione descrive le convenzioni di rappresentazione grafica usate nel manuale. Le convenzioni sono le seguenti:

\textbf{Convenzioni per l’interfaccia grafica (GUI)}

Le convenzioni stilistiche per l’interfaccia grafica hanno lo scopo di imitarne l’effettivo aspetto. In generale, si è evitato di usare immagini o indicazioni che compaiono solo al passaggio del mouse sopra l’indicazione stessa, in modo che l’utente possa scorrere visivamente l’interfaccia grafica per trovare quello che più assomiglia all’istruzione rappresentata nel manuale.
\begin{itemize}
\item {} 
Opzioni da menu: \emph{Layer \(\rightarrow\) Aggiungi un layer raster} oppure \emph{Impostazioni \(\rightarrow\) Barre degli strumenti \(\rightarrow\) Digitalizzazione}

\item {} 
Strumenti: \includegraphics[width=1.5em]{mActionAddRasterLayer.png} $^{\text{￼ Aggiungi raster}}$

\item {} 
Pulsante: \textbf{{[}Salva come predefinito{]}}

\item {} 
Titolo casella di dialogo: \emph{Proprietà layer}

\item {} 
Scheda (tab): \emph{Generale}

\item {} 
Casella di controllo: \includegraphics{checkbox.png} \emph{Render}

\item {} 
Pulsante di scelta:  \includegraphics{radiobuttonon.png} \emph{Postgis SRID} \includegraphics{radiobuttonoff.png} \emph{EPSG ID}

\item {} 
Scelta numerica: \includegraphics{selectnumber.png}

\item {} 
Selezione testuale: \includegraphics{selectstring.png}

\item {} 
Carca file: \includegraphics{browsebutton.png}

\item {} 
Scelta colore: \includegraphics{selectcolor.png}

\item {} 
Barra di scorrimento: \includegraphics{slider.png}

\item {} 
Inserimento testo: \includegraphics{inputtext.png}

\end{itemize}

L’ombreggiatura caratterizza un componente della GUI cliccabile.

\textbf{Convenzioni per il testo o per la tastiera}

Il manuale include anche convenzioni relative al testo, all’inserimento da tastiera e alle parti di codice per indicare diverse entità come classi o metodi. Non hanno alcuna corrispondenza visuale con l’applicativo.
\begin{itemize}
\item {} 
Collegamenti web: \href{http://qgis.org}{http://qgis.org}

\item {} 
Combinazioni di tasti: premere \code{Ctrl+B} significa la pressione del tasto B mentre si tiene premuto il tasto Ctrl.

\item {} 
Nome di un file: \code{lakes.shp}

\item {} 
Nome di una classe: \textbf{NewLayer}

\item {} 
Metodo: \emph{classFactory}

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

\item {} 
Inserimento di testo da parte dell’utente al prompt dei comandi: \code{qgis -{-}help}

\end{itemize}

Le porzioni di codice sono indicate con un formato carattere a spaziatura fissa

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

\textbf{Istruzioni specifiche per sistema operativo}

Sequenze della GUI e piccole porzioni di testo possono essere formattate in sequenza lineare, ad es.: Clicca \includegraphics[width=1em]{nix.png} \includegraphics[width=1em]{win.png} \emph{File} \includegraphics[width=1em]{osx.png} \emph{QGIS  \(\rightarrow\) Esci per chiudere QGIS}.

Questa notazione indica che sui sistemi operativi Linux, Unix e Windows, bisogna cliccare innanzitutto sul menù File, quindi su Esci nel menu a tendina, mentre su Macintosh OSX bisogna cliccare prima sul menu QGIS, poi su Esci dal menu a tendina. Grosse porzioni di testo possono essere formattate come un elenco:
\begin{itemize}
\item {} 
\includegraphics[width=1em]{nix.png} fai questo;

\item {} 
\includegraphics[width=1em]{win.png} fai quello;

\item {} 
\includegraphics[width=1em]{osx.png} fai qualcos'altro.

\end{itemize}

o come paragrafi.

\includegraphics[width=1em]{nix.png} \includegraphics[width=1em]{osx.png} Fai questo e questo e questo. Quindi fai questo e questo, e questo... .

\includegraphics[width=1em]{win.png} Fai quello. Poi fai quello e quello, e quello, ... .

Le schermate riportate nella guida sono state create su diversi sistemi operativi, indicati da apposite icone alla fine della didascalia.


\chapter{Premessa}
\label{docs/user_manual/preamble/foreword::doc}\label{docs/user_manual/preamble/foreword:foreword}\label{docs/user_manual/preamble/foreword:label-forward}
Benvenuti nel meraviglioso mondo dei Sistemi Informativi Geografici (GIS)!

Quantum GIS (GIS) è un Sistema Informativo Geografico Open Source. Il progetto è nato nel maggio 2002 ed è stato costituito come progetto su Source Forge nel giugno dello stesso anno. Abbiamo lavorato sodo per rendere i GIS (software tradizionalmente costosi e soggetti a licenze proprietarie) una prospettiva accessibile a chiunque abbia un accesso basilare a un personal computer. Attualmente QGIS funziona su diverse piattaforme Unix, Windows e OS X. QGIS viene sviluppato utilizzando il tookt Qt (\href{http://qt.digia.com}{http://qt.digia.com}) e il linguaggio C++. Questo significa che QGIS trasmette una senzazione di utilizzo brillante, con un'interfaccia grafica (GUI) piacevole e semplice da usare.

QGIS punta ad essere un GIS  dotato delle più comuni funzioni e caratteristiche, e facile da usare. L'obiettivo iniziale era quello di fornire un viewer per dati GIS. QGIS ha raggiunto quel punto nella sua evoluzione in cui viene utilizzato da molti utenti per le loro esigenze di visualizzazione di dati geografici. QGIS supporta molti formati vettoriali e di tipo raster, il supporto a nuovi formati può essere facilmente ampliato usando l'achitettura dei plugin.

QGIS è rilasciato sotto licenza GNU General Public License (GPL). Questo significa che potete analizzare e modificare il codice sorgente, e garantisce che voi, i nostri felici utenti, possiate sempre aver accesso ad un programma GIS gratuito e che può essere modificato liberamente. Dovreste avere ricevuto una copia completa della licenza insieme alla vostra copia di QGIS, e potete sempre trovala nell'Appendice {\hyperref[docs/user_manual/appendices/appendices:gpl-appendix]{\emph{GNU General Public License}}}.

\index{documentation}
\begin{notice}{tip}{Suggerimento:}
\textbf{Documentazione aggiornata}

La versione più aggiornata di questo documento è disponibile nell'area documentazione del sito web QGIS, all'indirizzo \href{http://documentation.qgis.org}{http://documentation.qgis.org}
\end{notice}


\section{Introduzione al GIS}
\label{docs/user_manual/preamble/foreword:introduction-to-gis}
Un Sistema Informativo Geografico (GIS) (Mitchell 2005 {\hyperref[docs/user_manual/literature_web/literature_and_web_references:literature-and-web]{\emph{Literature and Web References}}}) é un insieme di software che permette di creare, visualizzare, interrogare ed analizzare dati geospaziali. Con dati geospaziali ci si riferisce ad informazioni sulla posizione geografica di un oggetto. Questo comporta spesso l'uso di coordinate geografiche, come i valori di latitudine o di longitudine. Un altro termine comunemente usato é dati spaziali, come lo sono anche: dati geografici, dati GIS, dati di posizione, dati di coordinate e dati di geometria spaziale.

Le applicazioni che usano dati geospaziali eseguono una varietà di funzioni. L'applicazione più facilmente comprensibile é la produzione di carte geografiche. I programmi di questo genere ricevono i dati geospaziali e li elaborano in un formato visualizzabile, di solito sullo schermo di un computer o su una pagina stampata. Le applicazioni possono generare carte statiche (una singola immagine) o carte dinamiche, che possono essere personalizzate dalla persona che le visualizza tramite un programma o una pagina web.

Molte persone pensano erroneamente che le applicazioni geospaziali si limitino a produrre carte geografiche, ma un'altra delle loro funzioni principali é l'analisi geospaziale. Alcune tipiche forme di analisi includono:
\begin{enumerate}
\item {} 
distanza fra punti geografici

\item {} 
il calcolo dell'area della superficie (ad es. in metri quadri) racchiusa entro una certa regione geografica

\item {} 
quali forme sono sovrapposte ad altre forme

\item {} 
il calcolo dell'area di sovrapposizione fra due forme

\item {} 
il numero di punti contenuti entro una certa distanza da un altro

\item {} 
e così via...

\end{enumerate}

Questo può sembrare semplicistico, ma può essere applicato a molte discipline in ogni sorta di modo. I risultati di un'analisi possono essere mostrati su una mappa, ma sono spesso riportati in forma tabellare, come supporto alle decisioni.

Il recente fenomeno dei servizi basati sulla geolocalizzazione promette di introdurre ogni sorta di altre caratteristiche, ma molte di queste saranno basate su una combinazione di mappe e analisi spaziale. Per esempio: il vostro telefono cellulare, che è in grado di tracciare la vostra posizione geografica. Col software appropriato a disposizione, il vostro cellulare può indicarvi i ristoranti raggiungibili a piedi dal punto in cui vi trovate. Pur essendo un'applicazione relativamente nuova della tecnologia della geolocalizzazione, essenzialmente non fa altro che analizzare dati geografici e comunicarvi il risultato dell'analisi compiuta su di essi.


\subsection{Perché è tutto così nuovo?}
\label{docs/user_manual/preamble/foreword:why-is-all-this-so-new}
In realtà non lo è. Ci sono molti nuovi dispositivi hardware che consentono servizi geospaziali in mobilità. Sono disponibili molte applicazioni geospaziali open source, ma l'esistenza di hardware e software dedicati non è nulla di nuovo. I ricevitori per il Sistema di Posizionamento Globale (GPS) stanno diventando comuni, ma sono diffusi in vari ambiti professionali da più di un decennio. Parimenti, anche gli strumenti desktop per l'analisi e la mappatura hanno costituito un mercato primario in ambito commerciale, concentrandosi principalmente su industrie come quella della gestione delle risorse naturali.

Quello che è nuovo è il modo in cui l'hardware e il software più recenti sono stati applicati. Gli utenti tradizionali degli strumenti di analisi e mappatura erano analisti GIS altamente addestrati, o tecnici della cartografia digitale esperti nell'uso di strumenti CAD. Ora, la potenza di calcolo degli home PC e dei pacchetti software open source (OSS) ha reso capaci eserciti di hobbysti, professionisti, sviluppatori web, ecc, di interagire coi dati geospaziali. La curva di apprendimento si è appiattita. I costi sono scesi. Il livello di saturazione della tecnologia geospaziale è cresciuto.

Come vengono conservati i dati geospaziali? In poche parole, al giorno d'oggi, vengono usati due tipi di dato. Questo in aggiunta al dato tabellare tradizionale, anch'esso ampiamente usato nelle applicazioni geospaziali.


\subsection{Dati Raster}
\label{docs/user_manual/preamble/foreword:raster-data}
Un tipo di dato geospaziale è chiamato dato raster, o più semplicemente ``un raster''. La forma di dato raster più facile da riconoscere è costituita dalle immagini satellitari o dalle foto aeree. L'ombreggiatura altimetrica o i modelli di elevazione del terreno sono anch'essi timpicamete rappresentati da dati raster. Qualunque tipo di caratteristica cartograrica può essere rappresentata da un dato raster, ma ci sono delle limitazioni.

Un raster è una griglia regolare costituita da celle o, in caso di immagini, da pixel. C'è un numero prefissato di righe e colonne. Ogni cella ha un valore numerico e ha una certa dimensione geografica (ad es. 30x30 metri).

Diversi raster sovrapposti vengono usati per rappresentare immagini che hanno più di un colore (ad es. un raster per ogni valore rosso, verde e blu, combinati per ottenere un'immagine a colori). Anche le immagini satellitari rappresentano dati in ``bande'' multiple. Ogni banda è essenzialmente un raster separato, sovrapposto spazialmente, che contiene una certa lunghezza d'onda della luce. Come potrete immaginare, un raster di grandi dimensioni occuperà molto spazio in memoria.

Un raster con celle più piccole fornisce un maggior dettaglio, ma occupa più spazio. Il trucco sta nel trovare il giusto equilibrio fra la dimensione della cella ai fini dell'archiviazione e la dimensione della cella ai fini della mappatura o dell'analisi cartografica.


\subsection{Dati vettoriali}
\label{docs/user_manual/preamble/foreword:vector-data}
Nelle applicazioni geospaziali sono usati anche i dati vettoriali. Se siete rimasti svegli durante le lezioni di trigonometria e sui sistemi di coordinate, sarete già abituati ad alcune qualità dei dati vettoriali. Nella loro definizione più semplice, i vettori sono un modo di descrivere un punto tramite un insieme di coordinate. Ogni coordinata fa riferimento a una posizione geografica usando un sistema di valori x e y.

Lo si può immaginare facendo riferimento a un piano cartesiano - i diagrammi con gli assi x,y che si vedevano a scuola. Potreste averli usati per rappresentare la diminuzione dei risparmi da metter da parte per la pensione, o l'aumento degli interessi composti del mutuo, ma il concetto è essenziale per la cartografia l'analisi dei dati geospaziali.

Ci sono diversi modi di rappresentare questo tipo di coordinate geografiche, in base al vostro scopo. Questa è un'intera area di studio che riserveremo per un'altra volta - le proiezioni cartografiche.

I dati vettoriali hanno tre forme, ognuna progressivamente più complessa e che è costruita partendo dalla precedente.
\begin{enumerate}
\item {} 
Punti - Una singola coppia di coordinate (x y) rappresenta un singolo punto geografico

\item {} 
Linee - Diverse coppie di coordinate (x$_{\text{1}}$ y$_{\text{1}}$, x$_{\text{2}}$ y$_{\text{2}}$, x$_{\text{3}}$ y$_{\text{3}}$, ... x$_{\text{n}}$ y$_{\text{n}}$) unite in un certo ordine, come se si disegnasse una linea dal Punto (x$_{\text{1}}$ y$_{\text{1}}$) al Punto (x$_{\text{2}}$ y$_{\text{2}}$) e così via. Le parti fra un punto e l'altro sono considerate segmenti di una linea. Questi hanno una data lunghezza e la linea viene definita dalla sua direzione in base all'ordine in cui si susseguono i punti. Tecnicamente, una linea è una singola coppia di punti connessi l'un l'altro, mentre una spezzata è una serie di linee connesse fra di loro.

\item {} 
Poligoni - Quando diverse linee sono unite da più di due punti, con l'ultimo punto che ha la stessa posizione del primo, si parla di poligono. Un triangolo, un cerchio, un rettangolo, ecc. sono tutti poligoni. La caratteristica principale dei poligoni è che racchiudono una definita area.

\end{enumerate}


\chapter{Caratteristiche}
\label{docs/user_manual/preamble/features::doc}\label{docs/user_manual/preamble/features:features}
QGIS offre molte delle comuni funzionalità GIS grazie alle sue caratteristiche di base e ai plugin. Per averne una prima visione, sono state brevemente riassunte in sei categorie.


\section{Visualizzazione dati}
\label{docs/user_manual/preamble/features:view-data}
E' possibile visualizzare e sovrapporre dati vettoriali e dati raster in diversi formati e proiezioni, senza che sia necessaria una conversione in un formato interno o comune. I formati supportati includono:
\begin{itemize}
\item {} 
Tabelle spaziali e viste tramite PostGIS, SpatiaLite e MSSQL Spatial, formati vettoriali supportati dalla libreria OGR, inclusi gli shapefile ESRI, MapInfo, SDTS, GML e molti altri, cfr. la sezione  {\hyperref[docs/user_manual/working_with_vector/index:label-workingvector]{\emph{Lavorare con i dati vettoriali}}}.

\item {} 
Formati raster e immagine supportati dalla libreria GDAL (Geospatial Data Abstraction Library), come GeoTiff, Erdas Img., ArcInfo Ascii Grid, JPEG, PNG e altri ancora, cfr. la sezione {\hyperref[docs/user_manual/working_with_raster/index:working-with-raster]{\emph{Lavorare con i dati raster}}}.

\item {} 
Dati raster e vettoriali GRASS dai relativi database (location/mapset), cfr. la sezione {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-grass]{\emph{Integrazione con GRASS GIS}}}.

\item {} 
Dati spaziali online distribuiti secondo gli standard OGC, Web Map Service (WMS) o Web Feature Service (WFS), cfr. la sezione {\hyperref[docs/user_manual/working_with_ogc/ogc_client_support:working-with-ogc]{\emph{Lavorare con i dati OGC}}}.

\item {} 
Dati OpenStreetMap, cfr. la sezione {\hyperref[docs/user_manual/osm/openstreetmap:plugins-osm]{\emph{OpenStreetMap}}}.

\end{itemize}


\section{Esplorare dati e comporre mappe}
\label{docs/user_manual/preamble/features:explore-data-and-compose-maps}
Si possono comporre mappe ed esplorare interattivamente i dati spaziali grazie a un'interfaccia grafica (GUI) facile da usare. I molti strumenti utili disponibili nella GUI includono:
\begin{itemize}
\item {} 
Browser QGIS

\item {} 
Proiezione on the fly

\item {} 
Composizione mappe

\item {} 
Pannello vista generale

\item {} 
Segnalibri spaziali

\item {} 
Funzioni di identificazione/selezione

\item {} 
Modifica/visualizzazione/ricerca degli attributi

\item {} 
Etichettatura degli oggetti

\item {} 
Modifica della simbologia vettoriale e raster

\item {} 
Aggiunta di un layer graticcio - al momento come decorazione tramite il plugin fTools

\item {} 
Decorare le mappe con l'indicatore del Nord, la barra della scala cartografica e un'etichetta per il copyright

\item {} 
Salvataggio e recupero dei progetti

\end{itemize}


\section{Creazione, modifica, gestione ed esportazione dati}
\label{docs/user_manual/preamble/features:create-edit-manage-and-export-data}
E'possibilie creare, modificare, gestire ed esportare mappe vettoriali in diversi formati. I dati Raster devono essere prima importati in GRASS. QGIS offre:
\begin{itemize}
\item {} 
Strumenti per la digitalizzazione per i formati OGR e per i layer vettoriali GRASS

\item {} 
Creazione e modifica di shapefile e di layer GRASS

\item {} 
Immagini geocodificate grazie al plugin Georeferencer

\item {} 
Strumenti GPS per importare ed esportare formati GPX, convertire altri formati GPS in GPX o scaricarli/caricarli direttamente su di una unità GPS (nella versione Linux, usb è stata aggiunta alla lista degli strumenti GPS)

\item {} 
Visualizzazione e modifica di dati OpenStreetMap

\item {} 
Creazione di layer PostGIS partendo da shapefile, grazie al plugin SPIT

\item {} 
Migliore gestione delle tabelle PostGIS

\item {} 
Gestione delle tabelle degli attributi vettoriali grazie alla nuova tabella attributi (cfr. lasezione {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-attribute-table]{\emph{Lavorare con la tabella degli attributi}}}) o al plugin Table Manager

\item {} 
Salvataggio di screenshot come immagini georiferite

\end{itemize}


\section{Analsi dei dati}
\label{docs/user_manual/preamble/features:analyse-data}
Si può eseguire un'analisi spaziale sui formati PostgreSQL/PostGIS e su altri formati OGR utilizzando il plugin fTools Python. Attualmente, QGIS offre strumenti per: analisi vettoriale, campionamento, geoporcessing, gestione delle geometrie e dei database. Si possono anche usare strumenti integrtati in GRASS, che includono la completa funzionalità di oltre 400 moduli GRASS (cf. sezione {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-grass]{\emph{Integrazione con GRASS GIS}}}). Oppure si può lavorare con SEXTANTE, che fornisce una potente architettura per l'analisi geospaziale, in grado di  richiamare da QGIS algoritmi di terze parti, come GDAL, SAGA, GRASS, fTools ed altri (cfr. la sezione {\hyperref[docs/user_manual/sextante/index:label-sextante]{\emph{SEXTANTE}}}).


\section{Pubblicazione di mappe su internet}
\label{docs/user_manual/preamble/features:publish-maps-on-the-internet}
QGIS può essere usto per esportare dati in un mapfile e quindi pubblicarli su internet usando un server web, grazie alla funzione UMN MapServer. QGIS può anche essere usato come client per WMS, WMS-C, o WFS e WFS-T, e come server WMS o WFS (cfr. la sezione {\hyperref[docs/user_manual/working_with_ogc/index:sec-ogc]{\emph{Lavorare con i dati OGC}}}).


\section{Estendere le funzionalità di QGIS tramite i plugin}
\label{docs/user_manual/preamble/features:extend-qgis-functionality-through-plugins}
QGIS può essere adattato alle vostre specifiche esigenze grazie all'architettura dei plugin. QGIS fornisce librerie che possono essere usate per creare plugin. Si possono anche creare nuove applicazioni in C++ o Python!


\subsection{Plugin nativi}
\label{docs/user_manual/preamble/features:core-plugins}\begin{enumerate}
\item {} 
Add Delimited Text Layer (carica e visualizza file di testo contenenti coordinate x,y)

\item {} 
Coordinate Capture (cattura le coordinate, tramite il mouse, nei diversi Sistemi di Riferimento Cartografico - CRS)

\item {} 
DB Manager (scambia, modifica e visualizza layer e tabelle; esegue query in SQL)

\item {} 
Diagram Overlay (inserisce diagrammi su un layer vettoriale)

\item {} 
Dxf2Shp Converter (converte file DXF in Shapefile)

\item {} 
GPS Tools (carica e importa dati GPS)

\item {} 
GRASS (integrazione con GRASS)

\item {} 
GDAL Tools (integrazione in QGIS degli strumenti GDAL)

\item {} 
Georeferencer GDAL (aggiunge ai raster informazioni sulla proiezione cartografica utilizzando GDAL)

\item {} 
Heatmap (genera raster con mappe tipo heatmap dai dati puntuali)

\item {} 
Interpolation (interpolazione basata sui vertici in un layer vettoriale)

\item {} 
Mapserver Export (esporta un file di progetto QGIS in formato MapServer)

\item {} 
Offline Editing (consente le modifiche offline e la sincronizzazione con un database)

\item {} 
OpenStreetMap (visualizzatore ed editor per i dati openstreetmap)

\item {} 
Supporto per Oracle Spatial GeoRaster

\item {} 
Plugin Installer (scarica e installa i plugin di QGIS in python)

\item {} 
Raster terrain analysis (analisi del terreno su raster)

\item {} 
Road graph (analisi di rete del percorso più breve)

\item {} 
SPIT (importa uno Shapefile in PostgreSQL/PostGIS)

\item {} 
SQL Anywhere Plugin (immagazzina layer vettoriali in un database SQL Anywhere)

\item {} 
Zonal statictics (esegue il contegio, la somma, la media del raster per ogni poligono di un layer vettoriale)

\item {} 
Spatial Query (esegue query spaziali su layer vettoriali)

\item {} 
eVIS (strumento per la visualizzazione di eventi)

\item {} 
fTools (strumento per l'analisi e la gestione di dati vettoriali)

\end{enumerate}


\subsection{Plugin esterni in Python}
\label{docs/user_manual/preamble/features:external-python-plugins}
QGIS offre un numero crescente di lugin esterni in python, che sono forniti dalla comunità di sviluppatori. Questi plugin risiedono nel repository ufficiale, e possono essere facilmente installati usando il Python Plugin Installer (cfr. la sezione {\hyperref[docs/user_manual/plugins/plugins:load-external-plugin]{\emph{Caricamento di un plugin esterno}}}).


\section{Novità nella versione 1.8}
\label{docs/user_manual/preamble/features:what-s-new-in-the-version-1-8}
Attenzione! Questa è la nostra `versione di punta'. Come tale, contiene nuove caratteristiche ed espande l'interfaccia di QGIS 1.0 e QGIS 1.7.0. Si raccomanda l'utilizzo di questa versione rispetto alle altre.

Questa versione include centinaia di correzioni agli errori, molte nuove caratteristiche e miglioramenti.

\textbf{Browser QGIS}

Un'applicazione stand alone e un nuovo pannello in QGIS. Il browser consente di navigare facilmente nel file system e nei dataset connessi (PostGIS, WFS, ecc.), avere una preview degli oggetti e trascinarli nelle finestre.

\textbf{DB Manager}

Il DB manager è ora ufficialmente parte del cuore di QGIS. Ora è possibile trascinare layer dal Browser QGIS nel DB Manager, importando il layer nel database spaziale. Si possono importare tabelle trascinandole da un database all'altro. Si può usare il DB Manager per eseguire query in SQL sul database spaziale e visualizzarne il risultato sotto forma di un layer. Si possono anche creare, modificare, cancellare e svuotare tabelle, per spostarle poi in un altro schema.

\textbf{Plugin Terrain Analysis}

E' stato aggiunto un nuovo plugin per l'analisi del terreno (con indici di pendenza, aspetto, ombreggiatura, rilievo e scabrosità).

\textbf{Nuovi tipi di simbolo per i layer}
\begin{itemize}
\item {} 
Retinatura con pattern a linee

\item {} 
Retinatura con pattern a punti

\item {} 
Rendering delle ellissi (esegue il rendering di ellissi, rettangoli, triangoli e croci)

\end{itemize}

\textbf{Nuovo repository per i plugin}

Attenzione, il vecchio repository non è più supportato, gli autori sono gentilmente invitati a spostare i loro plugin sul nuovo repository. La lista dei plugin QGIS è disponibile su \href{http://plugins.qgis.org/plugins/}{http://plugins.qgis.org/plugins/}.

\textbf{Ulteriori nuove caratteristiche}
\begin{itemize}
\item {} 
Supporto ai progetti annidati entro altri progetti, in modo da accorpare il contenuto proveniente da altri file progetto

\item {} 
Group Selected: opzione per raggruppare layer

\item {} 
Message Log: consente di tenere d'occhio i messaggi che QGIS genera durante il caricamento e l'operatività

\item {} 
Personalizzazione della GUI: consente di allestire un'interfaccia QGIS semplificata, nascondendo varie componenti dalla finestra principale e i widget dalle finestre di dialogo

\item {} 
Lo strumento Azione è ora accessibile dalla barra degli strumenti mappa, consente di cliccare su un vettore e di eseguire un'azione

\item {} 
Il nuovo selettore di scala: seleziona una scala da una lista predefinita

\item {} 
Pan To Selected: sposta la panoramica della mappa sull'oggetto selezionato; non cambia il livello di zoom

\item {} 
Copia e incolla gli stili fra i layer

\item {} 
Selezione CRS aggiornata

\item {} 
Definizione della legenda - indipendente dall'ordine di disegno

\item {} 
Supporto a MSSQL spaziale - ci si può connettere, usando QGIS, a un database spaziale gestito da un server Microsoft SQL

\item {} 
Composizione di stampa consente di avere linee multiple sugli elementi della legenda, usando un carattere specifico

\item {} 
Etichettatura basata su espressioni

\item {} 
Heatmap - un nuovo plugin nativo, aggiunto per generare mappe raster tipo heatmap partendo da dati puntuali

\item {} 
L'interfaccia per il tracciamento live GPS è stata rivista, correggendo molti errori e aggiungendovi molte migliorie

\item {} 
Il menù è stato leggermente riorganizzato - ora ci sono menù separati per Vettori, Raster e Web, molti plugin sono stati aggiornati e inseriti nei livelli principali di tali manù

\item {} 
Offser delle curve - è stato aggiunto un nuovo strumento di digitalizzazione per creare curve con un offset

\item {} 
Nuovi strumenti nel menù Vettori per addensare geometrie e costruire indici spaziali

\item {} 
Lo strumento Esporta/aggiungi geometria può esportare informazioni usando layer CRS, progetti CRS o misure ellissoidali

\item {} 
Un'alberatura per le regole basata su Modello/Vista per il rendering basato su regole

\item {} 
Miglioramenti nei Segnalibri Spaziali

\item {} 
Nuovi metadati per i Plugin presenti in metadata.txt

\item {} 
Provider per dati postgres: supporto per chiavi arbitrarie (incluse non numeriche e multi colonna), supporto per la richiesta din un certo tipo di geometria e/o srid in QgsDataSourceURI

\item {} 
Aggiunto gdal\_fillnodata al plugin GDALT

\item {} 
Supporto per i tipi di dato PostGIS TopoGeometry

\item {} 
Binding python per il campo simboli del layer vettoriale e aggiornamenti generali ai binding python

\item {} 
Aggiunto un programma Benchmark

\item {} 
Aggiunta la cache Row per la tabella attributi

\item {} 
Widget per generare UUID per la tabella attributi

\item {} 
Aggiunto il supporto per le vedute modificabili nei database SpatiaLite

\item {} 
aggiunto un widget basato su espressioni nel field calculator

\item {} 
Creazione di layer evento nella libreria analisi, utilizzando riferimenti lineari

\item {} 
Carica/salva stili di layer nel nuovo reder di simbologia da/verso un documento SLD

\item {} 
Il server QGIS può funzionare come un Server WFS

\item {} 
Il supporto al Client WFS è ora una caratteristica nativa di QGIS

\item {} 
Opzione per saltare la geometria WTK copiando da una tabella attributi

\item {} 
Supporto al caricamento di layer compressi in formato .zip e .gzip

\item {} 
La suit QGIS test ora passa tutti i test sulle principali piattaforme, inclusi i test notturni

\item {} 
E' possibile definire la misura delle tile nei layer WMS

\end{itemize}


\chapter{Come Iniziare}
\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}
Questo capitolo fornisce una veloce panoramica sull’installazione di QGIS, su alcuni dati campione scaricabili dal sito QGIS e su come avviare una prima semplice sessione in cui visualizzare layer raster e vettoriali.


\section{Installazione}
\label{docs/user_manual/introduction/getting_started:label-installation}\label{docs/user_manual/introduction/getting_started:installation}
L’installazione di QGIS è molto semplice. Pacchetti standard per l’installazione sono disponibili per MS Windows e Mac OS X. Per le distribuzioni GNU/Linux sono disponibili pacchetti binari (rpm e deb) o archivi software da aggiungere al gestore di installazione. Informazioni aggiornate possono essere reperite sul sito web di QGIS \href{http://download.qgis.org}{http://download.qgis.org}.


\subsection{Installazione da codice sorgente}
\label{docs/user_manual/introduction/getting_started:installation-from-source}
Se si rende necessario compilare QGIS da codice sorgente si può fare riferimento alla guida per la compilazione disponibile su \href{http://www.qgis.org/en/documentation/manuals.html}{http://www.qgis.org/en/documentation/manuals.html}. Le istruzioni per l’installazione sono anche distribuite con il codice sorgente di QGIS


\subsection{Installazione su supporti esterni}
\label{docs/user_manual/introduction/getting_started:installation-on-external-media}
QGIS permette di specificare un’opzione di percorso \code{-{-}configpath} che sovrascrive il percorso predefinito (es. /.qgis in Linux) per le configurazioni utente. In tal modo è possibile portare l’installazione di QGIS, comprensiva dei plugin e delle impostazioni, su un supporto di memoria esterno (es. penna USB).


\section{Dati campione}
\label{docs/user_manual/introduction/getting_started:label-sampledata}\label{docs/user_manual/introduction/getting_started:sample-data}
La guida utente contiene esempi basati sul set di dati campione di QGIS.

\includegraphics[width=1em]{win.png} L’installer per Windows comprende un’opzione per scaricare il set di dati campione di QGIS. Se selezionato, i dati verranno scaricati nella vostra cartella \emph{Documenti} e posizionati in una cartella denominata \emph{GIS Database}. Si può usare Windows Explorer per spostare questa cartella in qualunque altra posizione. Qualora non fosse stata selezionata l’opzione per installare il set di dati campione durante l’installazione iniziale di QGIS è possibile
\begin{itemize}
\item {} 
usare dati GIS già posseduti;

\item {} 
scaricare il set di dati dal sito di QGIS \href{http://download.qgis.org}{http://download.qgis.org}; oppure

\item {} 
disinstallare QGIS e reinstallarlo selezionando l’opzione per lo scaricamento dei dati, solo se la soluzione precedente non ha successo.

\end{itemize}

\includegraphics[width=1em]{nix.png} \includegraphics[width=1em]{osx.png} Per GNU/Linux e Mac OSX non sono ancora disponibili pacchetti di installazione del set di dati campione in formato rpm, deb or dmg. Per usare il set di dati campione scaricare il file \emph{qgis\_sample\_data} come archivio ZIP o TAR da \href{http://download.osgeo.org/qgis/data/}{http://download.osgeo.org/qgis/data/} e decomprimerlo sul vostro sistema. Il dataset Alaska include tutti i dati GIS usati come esempi e schermate nella guida utente, includendo anche un piccolo database GRASS. La proiezione usata per il set di dati di QGIS è Alaska Albers Equal Area con unità in piedi. Il codice EPSG di questa proiezione è 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}

Se s’intende usare QGIS come interfaccia per GRASS, sono disponibili delle LOCATION campione (ad es. Spearfish or South Dakota) sul sito ufficiale di GRASS GIS \href{http://grass.osgeo.org/download/data.php}{http://grass.osgeo.org/download/data.php}.


\section{Sessione di esempio}
\label{docs/user_manual/introduction/getting_started:sample-session}\label{docs/user_manual/introduction/getting_started:samplesession}
Ora che si è installato QGIS e si ha a disposizione un set di dati campione, dimostreremo una breve e semplice sessione di QGIS. Visualizzeremo un layer raster ed uno vettoriale. Useremo il layer raster dell’uso del suolo \emph{qgis\_sample\_data/raster/landcover.img} e il layer vettoriale dei laghi \emph{qgis\_sample\_data/gml/lakes.gml}.


\subsection{Avvio di QGIS}
\label{docs/user_manual/introduction/getting_started:start-qgis}\begin{itemize}
\item {} 
\includegraphics[width=1em]{nix.png} Avviare QGIS scrivendo: QGIS al prompt dei comandi, oppure se si utilizzano pacchetti binari precompilati, utilizzando il menu delle applicazioni.

\item {} 
\includegraphics[width=1em]{win.png} Avviare QGIS usando il menu Start o l’icona sul desktop, oppure facendo doppio click su un file di progetto QGIS.

\item {} 
\includegraphics[width=1em]{osx.png} Doppio click sull’icona nella cartella Applicazioni.

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

\subsection{Caricare dati raster e vettoriali dal set di dati campione}
\label{docs/user_manual/introduction/getting_started:load-raster-and-vector-layers-from-the-sample-dataset}\begin{enumerate}
\item {} 
Cliccare sull’icona  \includegraphics[width=1.5em]{mActionAddRasterLayer.png} $^{\text{Aggiungi Raster}}$.

\item {} 
Individuare la cartella \emph{qgis\_sample\_data/raster/}, selezionare il file ERDAS Img \emph{landcover.img} e cliccare \textbf{{[}Apri{]}}.

\item {} 
Se il file non appare nella lista, controllare se il tipo di file selezionato nel menu in basso della finestra di dialogo è corretto, in questo caso Immagine ERDAS ({\color{red}\bfseries{}*}.img, {\color{red}\bfseries{}*}.IMG).

\item {} 
Ora cliccare sull’icona  \includegraphics[width=1.5em]{mActionAddOgrLayer.png} $^{\text{Aggiungi Vettore}}$.

\item {} 
\includegraphics{radiobuttonon.png} \emph{File} deve essere selezionato come tipo di sorgente nella finestra di dialogo \emph{Aggiungi vettore} . Ora cliccare \textbf{{[}Sfoglia{]}} per selezionare il layer vettoriale.

\item {} 
Individuare la cartella \emph{qgis\_sample\_data/gml/}, selezionare ``GML'' dal menu tipo file, poi selezionare il file GML \emph{lakes.gml} e cliccare \textbf{{[}Apri{]}} , poi nella finestra di dialogo Aggiungi vettore cliccare \textbf{{[}OK{]}}.

\item {} 
Ingrandire un la vista su un’area a vostra scelta con alcuni laghi.

\item {} 
Fare doppio click sul layer lakes nella legenda per aprire la finestra \emph{Proprietà layer}.

\item {} 
Cliccare sulla scheda \emph{Stile} e selezionare blu come colore di riempimento.

\item {} 
Cliccare sulla scheda \emph{Etichette} e spuntare l’opzione \includegraphics{checkbox.png} \emph{Mostra etichette} per abilitare l’etichettatura. Scegliere il campo NOME come campo per l’etichetta.

\item {} 
Per migliorare la leggibilità dell’etichetta, è possibile aggiungere un contorno con sfondo colorato: \includegraphics{checkbox.png} spuntare \emph{Contorno etichette} e scegliere dimensione e colore del contorno.

\item {} 
Cliccare \textbf{{[}Applica{]}} , controllare se il risultato è buono ed infine premete il tasto \textbf{{[}OK{]}}.

\end{enumerate}

Visto come è facile visualizzare layer raster e vettoriali in QGIS ? Proseguiamo alla sezione seguente per imparare ulteriori funzioni, caratteristiche ed impostazioni.


\section{Avvio e chiusura di QGIS}
\label{docs/user_manual/introduction/getting_started:label-startingqgis}\label{docs/user_manual/introduction/getting_started:starting-and-stopping-qgis}
Nella sezione {\hyperref[docs/user_manual/introduction/getting_started:samplesession]{\emph{Sessione di esempio}}} abbiamo già imparato come avviare QGIS. Ripeteremo questa operazione qui per mostrare come QGIS fornisca ulteriori opzioni all’avvio da riga di comando.
\begin{itemize}
\item {} 
\includegraphics[width=1em]{nix.png} Assumendo che QGIS sia installato nel vostro PATH, lo si può avviare digitando: \code{qgis} al prompt dei comandi o facendo doppio click sul collegamento all’applicazione (o shortcut) sul desktop o nel menu delle applicazioni.

\item {} 
\includegraphics[width=1em]{win.png} Avviare QGIS usando il menu Avvio (Start) o il collegamento sul desktop, o facendo doppio click su un progetto QGIS precedentemente salvato.

\item {} 
\includegraphics[width=1em]{osx.png} Fare doppio click sull’icona QGIS nella cartella Applicazioni (Applications). Se si vuole avviare QGIS in una shell, eseguire /percorso-installazione-eseguibile/Contents/MacOS/Qgis.

\end{itemize}

Per uscire da QGIS, cliccare sul menu \emph{File} \includegraphics[width=1em]{osx.png} \emph{QGIS \(\rightarrow\) Esci}, o usare la scorciatoia da tastiera Ctrl+Q .


\section{Opzioni linea di comando}
\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 supporta un certo numero di opzioni se avviato da riga di comando. Per avere una lista delle opzioni possibili, digitare ``qgis –-help'' al prompt dei comandi. La sintassi d’uso di QGIS è la seguente:

\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}{Suggerimento:}
\textbf{Esempio di utilizzo delle opzioni da riga di comando}

QGIS può essere avviato specificando uno o più file di dati da riga di comando. Per esempio, assunto che ci si trovi nella directory qgis\_sample\_data, si può avviare QGIS con un layer vettoriale e un file raster inserendo il seguente comando: \code{qgis ./raster/landcover.img ./gml/lakes.gml}
\end{notice}

\textbf{Opzioni linea di comando} ``--snapshot''

L’opzione consente di creare uno snapshot in formato PNG della vista corrente. Questo può essere utile quando si hanno molti progetti e si vogliono generare schermate dai propri dati.

Il file PNG generato ha una risoluzione di 800x600 pixels. Questa può essere adattata usando gli argomenti da riga di comando ``--width'' e ``--height''. Dopo l’opzione ``--snapshot'' può essere specificato il nome del file con cui si vuole salvare l’immagine.

\textbf{Opzioni linea di comando} ``--lang''

L’interfaccia di QGIS si presenta nella lingua definita dalle impostazioni di localizzazione di sistema. Se si desidera l’interfaccia in un’altra lingua, lo si può specificare all’avvio. Ad esempio: ``--lang=en'' fa sì che QGIS si avvii localizzato in inglese. Un elenco delle lingue supportate è disponibile all’indirizzo \href{http://www.qgis.org/wiki/GUI\_Translation\_Progress}{http://www.qgis.org/wiki/GUI\_Translation\_Progress}

\textbf{Opzioni linea di comando} ``--project''

E’ possibile avviare QGIS anche con un file di progetto. Basta semplicemente aggiungere l’opzione da riga di comando ``--project'' seguita dal percorso e dal nome del progetto e QGIS si aprirà caricando tutti i layer indicati nel file specificato.

\textbf{Opzioni linea di comando} ``--extent''

Per fare sì che QGIS si avvii visualizzando una specifica porzione di mappa, è necessario specificare i limiti dell’estensione (bounding box) che si intende visualizzare secondo il seguente ordine, con ogni valore separato da virgole:

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

\textbf{Opzioni linea di comando} ``--nologo''

Questa opzione nasconde lo splash screen quando QGIS viene avviato.

\textbf{Opzioni linea di comando} ``--noplugins''

Se si verificano problemi con i plugin all’avvio di QGIS, è possibile evitare di caricarli. Saranno comunque disponibili in seguito nel Gestore plugin.

\textbf{Opzioni linea di comando} ``--nocustomization''

Usando questa opzione le personalizzazioni dell'interfaccia non verranno applicate all'avvio.

\textbf{Opzioni linea di comando} ``--optionspath''

Potreste avere più di una configurazione e con questa opzione potete decidere quale usare al momento di avviare QGIS. Si veda la Sezione 3.8 per controllare dove il vostro sistema operativo salva i file d’impostazione. Al momento non c’è modo di specificare in quale file salvare le impostazioni, per cui potete creare una copia del file di impostazione e rinominarlo.

\textbf{Opzioni linea di comando} ``--configpath''

Questa opzione è simile alla precedente, ma in più sovrascrive il percorso di default (\textasciitilde{}/.qgis) per le configurazioni utente e forza anche QSettings ad usare questo percorso. Questo permette all’utente, ad esempio, di portare l’installazione di QGIS su una flash drive (es. una chiave USB) insieme a tutti i plugin ed impostazioni.


\section{Progetti}
\label{docs/user_manual/introduction/getting_started:sec-projects}\label{docs/user_manual/introduction/getting_started:projects}
Lo stato di una sessione QGIS è considerato un progetto. È possibile lavorare su un progetto alla volta. Le impostazioni possono essere definite per ogni singolo progetto oppure di default per tutti i nuovi progetti (vedi sezione {\hyperref[docs/user_manual/introduction/qgis_configuration:gui-options]{\emph{Opzioni dell’interfaccia grafica (GUI)}}}). Lo stato della sessione corrente può essere salvato in un progetto usando la voce di menu \emph{File \(\rightarrow\)} \includegraphics[width=1.5em]{mActionFileSave.png} \emph{Salva progetto} o \emph{File \(\rightarrow\)} \includegraphics[width=1.5em]{mActionFileSaveAs.png} \emph{Salva progetto con nome}.

Per caricare progetti salvati usare \emph{File \(\rightarrow\)} \includegraphics[width=1.5em]{mActionFileOpen.png} \emph{Apri progetto} or \emph{File \(\rightarrow\) Apri progetti recenti}.

Se si vuole eliminare la sessione corrente e ricominciare da zero, scegliere \emph{File \(\rightarrow\)} \includegraphics[width=1.5em]{mActionFileNew.png} \emph{Nuovo progetto}. Ognuna di queste voci di menu chiederà se si vuole salvare la sessione corrente qualora fossero occorsi cambiamenti rispetto all’ultima volta in cui la stessa è stata aperta o salvata.

Le informazioni salvate nel file di progetto includono:
\begin{itemize}
\item {} 
Layers aggiunti

\item {} 
Proprietà dei layer, inclusa la loro rappresentazione grafica

\item {} 
Proiezione usata per la vista mappa

\item {} 
Ultima estensione della vista (scala e inquadramento)

\end{itemize}

Il file di progetto è salvato in formato XML, così da poter essere editato esternamente a QGIS con qualunque editor, se si conosce la sintassi. Il formato del file di progetto è stato modificato parecchie volte rispetto a quello delle precedenti versioni di QGIS, di conseguenza file di progetto salvati con precedenti versioni di QGIS potrebbero non funzionare più correttamente. Si può essere avvertiti preventivamente di ciò selezionando dalla scheda \emph{Generale} nel menu \emph{Impostazioni \(\rightarrow\) Opzioni}:

\includegraphics{checkbox.png} \emph{Richiedi di salvare i cambiamenti di progetto se necessario}

\includegraphics{checkbox.png} \emph{Avvisa quando viene aperto un file di progetto salvato con una vecchia versione di QGIS}


\section{Output}
\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}
Ci sono diversi modi per generare file di output da una sessione QGIS. Il primo è stato descritto alla Sezione {\hyperref[docs/user_manual/introduction/getting_started:sec-projects]{\emph{Progetti}}} e consiste nel salvataggio su file di progetto. Altri modi di produrre file di output sono ad esempio:
\begin{itemize}
\item {} 
L’opzione di menu \includegraphics[width=1.5em]{mActionSaveMapAsImage.png} \emph{Salva come immagine} permette di salvare la vista mappa come immagine in formato PNG o JPG: insieme all’immagine viene salvato anche un file di georeferenziazione (world file) con estensione rispettivamente PNGW o JPGW.

\item {} 
L’opzione di menu \emph{File \(\rightarrow\)} \includegraphics[width=1.5em]{mActionNewComposer.png} \emph{Nuova composizione di stampa} apre una finestra di dialogo dove è possibile impaginare e stampare la vista mappa (vedi sezione {\hyperref[docs/user_manual/print_composer/print_composer:label-printcomposer]{\emph{Compositore di stampe}}}).

\end{itemize}


\chapter{Interfaccia grafica di 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}
All’avvio di QGIS viene visualizzata l’interfaccia grafica riprodotta dalla seguente immagine (i numeri da 1 a 5 negli ovali gialli fanno riferimento alle cinque principali aree dell’interfaccia come di seguito specificato):
\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}{Nota:}
L’aspetto delle finestre (barra del titolo, ecc.) può apparire diverso a seconda del sistema operativo e del gestore di finestre utilizzato.
\end{notice}

L’interfaccia di QGIS è divisa in cinque aree:
\begin{enumerate}
\item {} 
Barra dei Menu

\item {} 
Barra degli Strumenti

\item {} 
Legenda

\item {} 
Vista Mappa

\item {} 
Barra di Stato

\end{enumerate}

Le cinque componenti dell’interfaccia di QGIS sono descritte con maggior dettaglio nelle sezioni seguenti. Due ulteriori sezioni descriveranno le scorciatoie da tastiera e la guida contestuale.


\section{Barra dei Menu}
\label{docs/user_manual/introduction/qgis_gui:label-menubar}\label{docs/user_manual/introduction/qgis_gui:menu-bar}
\index{menus}
La barra dei menu fornisce accesso alle varie caratteristiche di QGIS utilizzando un menu gerarchico standard. Le voci gerarchicamente più elevate e una sintesi di alcune opzioni di menu sono elencate di seguito, assieme alle icone degli strumenti corrispondenti così come appaiono nella barra degli strumenti ed alle scorciatoie da tastiera. Le scorciatoie da tastiera possono essere configurate manualmente (quelle presentate in questa sezione sono quelle predefinite),
usando lo strumento {[}\textbf{Configura le scorciatoie}{]} nel menu \emph{Modifica}.

Sebbene molte voci di menu abbiano uno strumento corrispondente e viceversa, i menu non sono organizzati esattamente come le barre degli strumenti. La barra degli strumenti che contiene la voce descritta è indicata dopo ogni voce di menu con l’aspetto di una casella di controllo (checkbox). Per ulteriori  informazioni su strumenti e barre degli strumenti si veda la Sezione {\hyperref[docs/user_manual/introduction/qgis_gui:label-toolbars]{\emph{Barra degli Strumenti}}}.


\subsection{File}
\label{docs/user_manual/introduction/qgis_gui:file}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Voce di Menu
} & \textsf{\relax 
Scorciatoia
} & \textsf{\relax 
Riferimento
} & \textsf{\relax 
Barra degli Strumenti
}\\
\hline
\includegraphics[width=1.5em]{mActionFileNew.png} \emph{Nuovo progetto}
 & 
\code{Ctrl+N}
 & 
see {\hyperref[docs/user_manual/introduction/getting_started:sec-projects]{\emph{Progetti}}}
 & 
\emph{File}
\\

\includegraphics[width=1.5em]{mActionFileOpen.png} \emph{Apri progetto}
 & 
\code{Ctrl+O}
 & 
see {\hyperref[docs/user_manual/introduction/getting_started:sec-projects]{\emph{Progetti}}}
 & 
\emph{File}
\\

\emph{Apri progetti recenti\(\rightarrow\)}
 & 

 & 
see {\hyperref[docs/user_manual/introduction/getting_started:sec-projects]{\emph{Progetti}}}
 & 

\\

\includegraphics[width=1.5em]{mActionFileSave.png} \emph{Salva progetto}
 & 
\code{Ctrl+S}
 & 
see {\hyperref[docs/user_manual/introduction/getting_started:sec-projects]{\emph{Progetti}}}
 & 
\emph{File}
\\

\includegraphics[width=1.5em]{mActionFileSaveAs.png} \emph{Salva progetto con nome}
 & 
\code{Ctrl+Shift+S}
 & 
see {\hyperref[docs/user_manual/introduction/getting_started:sec-projects]{\emph{Progetti}}}
 & 
\emph{File}
\\

\includegraphics[width=1.5em]{mActionSaveMapAsImage.png} \emph{Salva come immagine}
 & 

 & 
see {\hyperref[docs/user_manual/introduction/getting_started:sec-output]{\emph{Output}}}
 & 

\\

\includegraphics[width=1.5em]{mActionNewComposer.png} \emph{Nuova composizione di stampa}
 & 
\code{Ctrl+P}
 & 
see {\hyperref[docs/user_manual/print_composer/print_composer:label-printcomposer]{\emph{Compositore di stampe}}}
 & 
\emph{File}
\\

\includegraphics[width=1.5em]{mActionComposerManager.png} \emph{Gestore di stampe}
 & 

 & 
see {\hyperref[docs/user_manual/print_composer/print_composer:label-printcomposer]{\emph{Compositore di stampe}}}
 & 
\emph{File}
\\

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

 & 
see {\hyperref[docs/user_manual/print_composer/print_composer:label-printcomposer]{\emph{Compositore di stampe}}}
 & 

\\

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

 & 

\\
\hline\end{tabulary}



\subsection{Modifica}
\label{docs/user_manual/introduction/qgis_gui:edit}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Voce di Menu
} & \textsf{\relax 
Scorciatoia
} & \textsf{\relax 
Riferimento
} & \textsf{\relax 
Barra degli Strumenti
}\\
\hline
\includegraphics[width=1.5em]{mActionUndo.png} \emph{Annulla}
 & 
\code{Ctrl+Z}
 & 
see {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Digitalizzazione avanzata}}}
 & 
\emph{Digitalizzazione avanzata}
\\

\includegraphics[width=1.5em]{mActionRedo.png} \emph{Ripristina}
 & 
\code{Ctrl+Shift+Z}
 & 
see {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Digitalizzazione avanzata}}}
 & 
\emph{Digitalizzazione avanzata}
\\

\includegraphics[width=1.5em]{mActionEditCut.png} \emph{Taglia geometrie}
 & 
\code{Ctrl+X}
 & 
see {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-edit-existing-layer]{\emph{Modifica di un layer esistente}}}
 & 
\emph{Digitalizzazione}
\\

\includegraphics[width=1.5em]{mActionEditCopy.png} \emph{Copia elementi}
 & 
\code{Ctrl+C}
 & 
see {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-edit-existing-layer]{\emph{Modifica di un layer esistente}}}
 & 
\emph{Digitalizzazione}
\\

\includegraphics[width=1.5em]{mActionEditPaste.png} \emph{Incolla elementi}
 & 
\code{Ctrl+V}
 & 
see {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-edit-existing-layer]{\emph{Modifica di un layer esistente}}}
 & 
\emph{Digitalizzazione}
\\

\includegraphics[width=1.5em]{mActionCapturePoint.png} \emph{Inserisci punto}
 & 
\code{Ctrl+.}
 & 
see {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-edit-existing-layer]{\emph{Modifica di un layer esistente}}}
 & 
\emph{Digitalizzazione}
\\

\includegraphics[width=1.5em]{mActionEditPaste.png} \emph{Muovi elemento/i}
 & 

 & 
see {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-edit-existing-layer]{\emph{Modifica di un layer esistente}}}
 & 
\emph{Digitalizzazione}
\\

\includegraphics[width=1.5em]{mActionDeleteSelected.png} \emph{Elimina il selezionato}
 & 

 & 
see {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-edit-existing-layer]{\emph{Modifica di un layer esistente}}}
 & 
\emph{Digitalizzazione}
\\

\includegraphics[width=2em]{mActionSimplify.png} \emph{Semplifica geometria}
 & 

 & 
see {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Digitalizzazione avanzata}}}
 & 
\emph{Digitalizzazione avanzata}
\\

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

 & 
see {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Digitalizzazione avanzata}}}
 & 
\emph{Digitalizzazione avanzata}
\\

\includegraphics[width=2em]{mActionAddIsland.png} \emph{Aggiungi una parte}
 & 

 & 
see {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Digitalizzazione avanzata}}}
 & 
\emph{Digitalizzazione avanzata}
\\

\includegraphics[width=2em]{mActionDeleteRing.png} \emph{Elimina buco}
 & 

 & 
see {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Digitalizzazione avanzata}}}
 & 
\emph{Digitalizzazione avanzata}
\\

\includegraphics[width=2em]{mActionDeletePart.png} \emph{Elimina parte}
 & 

 & 
see {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Digitalizzazione avanzata}}}
 & 
\emph{Digitalizzazione avanzata}
\\

\includegraphics[width=1.5em]{mActionReshape.png} \emph{Modifica la forma}
 & 

 & 
see {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Digitalizzazione avanzata}}}
 & 
\emph{Digitalizzazione avanzata}
\\

\includegraphics[width=1.5em]{mActionEditCut.png} \emph{Taglia geometrie}
 & 

 & 
see {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Digitalizzazione avanzata}}}
 & 
\emph{Digitalizzazione avanzata}
\\

\includegraphics[width=1.5em]{mActionSplitFeatures.png} \emph{Spezza elemento}
 & 

 & 
see {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Digitalizzazione avanzata}}}
 & 
\emph{Digitalizzazione avanzata}
\\

\includegraphics[width=1.5em]{mActionMergeFeatures.png} \emph{Unisci le geometrie selezionate}
 & 

 & 
see {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Digitalizzazione avanzata}}}
 & 
\emph{Digitalizzazione avanzata}
\\

\includegraphics[width=1.5em]{mActionMergeFeatures.png} \emph{Unisci gli attributi delle geometrie selezionate}
 & 

 & 
see {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Digitalizzazione avanzata}}}
 & 
\emph{Digitalizzazione avanzata}
\\

\includegraphics[width=1.5em]{mActionNodeTool.png} \emph{Strumento vertici}
 & 

 & 
see {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-edit-existing-layer]{\emph{Modifica di un layer esistente}}}
 & 
\emph{Digitalizzazione}
\\

\includegraphics[width=1.5em]{mActionRotatePointSymbols.png} \emph{Ruota i simboli per i punti}
 & 

 & 
see {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Digitalizzazione avanzata}}}
 & 
\emph{Digitalizzazione avanzata}
\\
\hline\end{tabulary}






Quando si attiva la modalità \includegraphics[width=1.5em]{mActionToggleEditing.png} $^{\text{Modifica}}$ per un layer, ulteriori voci vengono aggiunte nel menu \emph{Modifica} in funzione del tipo di geometria (punto, linea o poligono).


\subsection{Modifica (extra)}
\label{docs/user_manual/introduction/qgis_gui:edit-extra}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Voce di Menu
} & \textsf{\relax 
Scorciatoia
} & \textsf{\relax 
Riferimento
} & \textsf{\relax 
Barra degli Strumenti
}\\
\hline
\includegraphics[width=1.5em]{mActionCapturePoint.png} \emph{Inserisci punto}
 & 

 & 
see {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-edit-existing-layer]{\emph{Modifica di un layer esistente}}}
 & 
\emph{Digitalizzazione}
\\

\includegraphics[width=1.5em]{mActionCapturePoint.png} \emph{Inserisci linea}
 & 

 & 
see {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-edit-existing-layer]{\emph{Modifica di un layer esistente}}}
 & 
\emph{Digitalizzazione}
\\

\includegraphics[width=1.5em]{mActionCapturePoint.png} \emph{Inserisci poligono}
 & 

 & 
see {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-edit-existing-layer]{\emph{Modifica di un layer esistente}}}
 & 
\emph{Digitalizzazione}
\\
\hline\end{tabulary}



\subsection{Vista Mappa}
\label{docs/user_manual/introduction/qgis_gui:view}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Voce di Menu
} & \textsf{\relax 
Scorciatoia
} & \textsf{\relax 
Riferimento
} & \textsf{\relax 
Barra degli Strumenti
}\\
\hline
\includegraphics[width=1.5em]{mActionPan.png} \emph{Sposta mappa}
 & 

 & 

 & 
\emph{Navigazione mappa}
\\

\includegraphics[width=1.5em]{mActionZoomFullExtent.png} \emph{Zoom sulla selezione}
 & 

 & 

 & 
\emph{Navigazione mappa}
\\

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

 & 
\emph{Navigazione mappa}
\\

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

 & 
\emph{Navigazione mappa}
\\

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

 & 
see {\hyperref[docs/user_manual/introduction/general_tools:sec-selection]{\emph{Selezionare e deselezionare elementi}}}
 & 
\emph{Attributi}
\\

\includegraphics[width=1.5em]{mActionIdentify.png} \emph{Informazioni elementi}
 & 
\code{Ctrl+Shift+I}
 & 

 & 
\emph{Attributi}
\\

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

 & 
see {\hyperref[docs/user_manual/introduction/general_tools:sec-measure]{\emph{Misurazioni}}}
 & 
\emph{Attributi}
\\

\includegraphics[width=1.5em]{mActionZoomFullExtent.png} \emph{Zoom completo}
 & 
\code{Ctrl+Shift+F}
 & 

 & 
\emph{Navigazione mappa}
\\

\includegraphics[width=1.5em]{mActionZoomFullExtent.png} \emph{Zoom sul layer}
 & 

 & 

 & 
\emph{Navigazione mappa}
\\

\includegraphics[width=1.5em]{mActionZoomFullExtent.png} \emph{Zoom sulla selezione}
 & 
\code{Ctrl+J}
 & 

 & 
\emph{Navigazione mappa}
\\

\includegraphics[width=1.5em]{mActionZoomLast.png} \emph{Ultimo Zoom}
 & 

 & 

 & 
\emph{Navigazione mappa}
\\

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

 & 

 & 
\emph{Navigazione mappa}
\\

\includegraphics[width=1.5em]{mActionZoomOut.png} \emph{Rimpicciolisci}
 & 

 & 

 & 
\emph{Navigazione mappa}
\\

\emph{Proprietà \(\rightarrow\)}
 & 

 & 
see {\hyperref[docs/user_manual/introduction/general_tools:decorations]{\emph{Decorazioni}}}
 & 

\\

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

 & 

 & 
\emph{Attributi}
\\

\includegraphics[width=1.5em]{mActionNewBookmark.png} \emph{Nuovo segnalibro}
 & 
\code{Ctrl+B}
 & 
see {\hyperref[docs/user_manual/introduction/general_tools:sec-bookmarks]{\emph{Segnalibri geospaziali}}}
 & 
\emph{Attributi}
\\

\includegraphics[width=1.5em]{mActionShowBookmarks.png} \emph{Mostra segnalibri}
 & 
\code{Ctrl+Shift+B}
 & 
see {\hyperref[docs/user_manual/introduction/general_tools:sec-bookmarks]{\emph{Segnalibri geospaziali}}}
 & 
\emph{Attributi}
\\

\includegraphics[width=1.5em]{mActionDraw.png} \emph{Aggiorna}
 & 
\code{Ctrl+R}
 &  & 
\emph{Navigazione mappa}
\\

\emph{Slider per la scala delle tiles}
 & 

 & 
see {\hyperref[docs/user_manual/working_with_ogc/ogc_client_support:tilesets]{\emph{Set di tile}}}
 & 
\emph{Scala delle tiles}
\\
\hline\end{tabulary}



\subsection{Layer}
\label{docs/user_manual/introduction/qgis_gui:layer}
\begin{longtable}{|l|l|l|l|}
\hline
\textsf{\relax 
Voce di Menu
} & \textsf{\relax 
Scorciatoia
} & \textsf{\relax 
Riferimento
} & \textsf{\relax 
Barra degli Strumenti
}\\
\hline\endfirsthead

\multicolumn{4}{c}%
{{\textsf{\tablename\ \thetable{} -- continua dalla pagina precedente}}} \\
\hline
\textsf{\relax 
Voce di Menu
} & \textsf{\relax 
Scorciatoia
} & \textsf{\relax 
Riferimento
} & \textsf{\relax 
Barra degli Strumenti
}\\
\hline\endhead

\hline \multicolumn{4}{|r|}{{\textsf{Continua alla pagina successiva}}} \\ \hline
\endfoot

\endlastfoot


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

 & 
see {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-create-shape]{\emph{Creare nuovi layer vettoriali}}}
 & 
\emph{Gestione layer}
\\

\emph{Includi layer e gruppi}
 & 

 & 
see {\hyperref[docs/user_manual/introduction/general_tools:nesting-projects]{\emph{Progetti nidificati}}}
 & 

\\

\includegraphics[width=1.5em]{mActionAddNonDbLayer.png} \emph{Aggiungi vettore}
 & 
\code{Ctrl+Shift+V}
 & 
see {\hyperref[docs/user_manual/working_with_vector/index:label-workingvector]{\emph{Lavorare con i dati vettoriali}}}
 & 
\emph{Gestione layer}
\\

\includegraphics[width=1.5em]{mActionAddNonDbLayer.png} \emph{Aggiungi raster}
 & 
\code{Ctrl+Shift+R}
 & 
see {\hyperref[docs/user_manual/working_with_raster/supported_data:load-raster]{\emph{Caricare dati raster in QGIS}}}
 & 
\emph{Gestione layer}
\\

\includegraphics[width=1.5em]{mActionAddLayer.png} \emph{Aggiungi vettore PostGIS}
 & 
\code{Ctrl+Shift+D}
 & 
see {\hyperref[docs/user_manual/working_with_vector/supported_data:label-postgis]{\emph{Layer PostGIS}}}
 & 
\emph{Gestione layer}
\\

\includegraphics[width=1.5em]{mActionAddSpatiaLiteLayer.png} \emph{Aggiungi un layer Spatialite}
 & 
\code{Ctrl+Shift+L}
 & 
see {\hyperref[docs/user_manual/working_with_vector/supported_data:label-spatialite]{\emph{Layer SpatiaLite}}}
 & 
\emph{Gestione layer}
\\

\includegraphics[width=1.5em]{mActionAddNonDbLayer.png} \emph{Aggiungi un vettore MSSQL}
 & 
\code{Ctrl+Shift+M}
 & 
see {\hyperref[docs/user_manual/working_with_vector/supported_data:label-mssql]{\emph{Layer Spatial MSSQL}}}
 & 
\emph{Gestione layer}
\\

\includegraphics[width=1.5em]{mActionAddNonDbLayer.png} \emph{Aggiungi vettore WMS}
 & 
\code{Ctrl+Shift+W}
 & 
see {\hyperref[docs/user_manual/working_with_ogc/ogc_client_support:ogc-wms]{\emph{Client WMS}}}
 & 
\emph{Gestione layer}
\\

\includegraphics[width=1.5em]{mActionAddSpatiaLiteLayer.png} \emph{Aggiungi layer testo delimitato}
 & 

 & 
see {\hyperref[docs/user_manual/plugins/plugins_delimited_text:label-dltext]{\emph{Plugin Testo Delimitato}}}
 & 
\emph{Gestione layer}
\\

\includegraphics[width=1.5em]{gps_importer.png} \emph{Crea nuovo vettore GPX}
 & 

 & 
see {\hyperref[docs/user_manual/working_with_gps/plugins_gps:plugin-gps]{\emph{Plugin GPS}}}
 & 
\emph{Gestione layer}
\\

\includegraphics[width=1.5em]{oracle_raster.png} \emph{Aggiungi layer Oracle GeoRaster}
 & 

 & 
see {\hyperref[docs/user_manual/plugins/plugins_oracle_raster:oracle-raster]{\emph{Plugin Oracle Spatial GeoRaster}}}
 & 
\emph{Gestione layer}
\\

\includegraphics[width=1.5em]{sqlanywhere.png} \emph{Add SQL Anywhere Layer}
 & 

 & 
see {\hyperref[docs/user_manual/plugins/plugins_sql_anywhere:sqlanywhere]{\emph{Plugin SQL Anywhere}}}
 & 
\emph{Gestione layer}
\\

\includegraphics[width=1.5em]{wfs.png} \emph{Aggiungi vettore WFS}
 & 

 & 

 & 
\emph{Gestione layer}
\\

\includegraphics[width=1.5em]{mActionEditCopy.png} \emph{Copia elementi}
 & 

 & 
see {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-style-tab]{\emph{Scheda Stile}}}
 & 

\\

\includegraphics[width=1.5em]{mActionEditPaste.png} \emph{Incolla elementi}
 & 

 & 
see {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-style-tab]{\emph{Scheda Stile}}}
 & 

\\

\includegraphics[width=1.5em]{mActionOpenTable.png} \emph{Apri tabella attributi}
 & 

 & 

 & 
\emph{Attributi}
\\

\includegraphics[width=1.5em]{mActionFileSave.png} \emph{Salva modifiche}
 & 

 & 

 & 
\emph{Digitalizzazione}
\\

\includegraphics[width=1.5em]{mActionToggleEditing.png} \emph{Modifica}
 & 

 & 

 & 
\emph{Digitalizzazione}
\\

\emph{Salva come...}
 & 

 & 

 & 

\\

\emph{Salva selezione come vettore...}
 & 

 & 
See {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-attribute-table]{\emph{Lavorare con la tabella degli attributi}}}
 & 

\\

\includegraphics[width=1.5em]{mActionRemoveLayer.png} \emph{Elimina layer}
 & 
\code{Ctrl+D}
 & 

 & 

\\

\emph{Imposta SR del/i layer}
 & 
\code{Ctrl+Shift+C}
 & 

 & 

\\

\emph{Imposta SR progetto dal layer}
 & 

 & 

 & 

\\

\emph{Proprietà}
 & 

 & 

 & 

\\

\emph{Interrogazione}
 & 

 & 

 & 

\\

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

 & 

 & 

\\

\includegraphics[width=1.5em]{mActionInOverview.png} \emph{Aggiungi alla panoramica}
 & 
\code{Ctrl+Shift+O}
 & 

 & 
\emph{Gestione layer}
\\

\includegraphics[width=1.5em]{mActionAddAllToOverview.png} \emph{Aggiungi tutto alla panoramica}
 & 

 & 

 & 

\\

\includegraphics[width=1.5em]{mActionAddAllToOverview.png} \emph{Rimuovi tutto alla panoramica}
 & 

 & 

 & 

\\

\includegraphics[width=1.5em]{mActionShowAllLayers.png} \emph{Mostra tutti i layer}
 & 
\code{Ctrl+Shift+U}
 & 

 & 
\emph{Gestione layer}
\\

\includegraphics[width=1.5em]{mActionShowAllLayers.png} \emph{Nascondi tutti i layer}
 & 
\code{Ctrl+Shift+H}
 & 

 & 
\emph{Gestione layer}
\\
\hline\end{longtable}



\subsection{Impostazioni}
\label{docs/user_manual/introduction/qgis_gui:settings}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Voce di Menu
} & \textsf{\relax 
Scorciatoia
} & \textsf{\relax 
Riferimento
} & \textsf{\relax 
Barra degli Strumenti
}\\
\hline
\emph{Pannelli \(\rightarrow\)}
 & 

 & 
see {\hyperref[docs/user_manual/introduction/qgis_configuration:sec-panels-and-toolbars]{\emph{Pannelli e Barre degli strumenti}}}
 & 

\\

\emph{Barre degli strumenti \(\rightarrow\)}
 & 

 & 
see {\hyperref[docs/user_manual/introduction/qgis_configuration:sec-panels-and-toolbars]{\emph{Pannelli e Barre degli strumenti}}}
 & 

\\

\emph{Schermo intero}
 & 
\code{Ctrl-F}
 & 

 & 

\\

\includegraphics[width=1.5em]{mActionProjectProperties.png} \emph{Proprietà progetto}
 & 
\code{Ctrl+Shift+P}
 & 
see {\hyperref[docs/user_manual/introduction/getting_started:sec-projects]{\emph{Progetti}}}
 & 

\\

\includegraphics[width=1.5em]{mActionCustomProjection.png} \emph{SR personalizzato}
 & 

 & 
see {\hyperref[docs/user_manual/working_with_projections/working_with_projections:sec-custom-projections]{\emph{Sistemi di riferimento personalizzati}}}
 & 

\\

\emph{Gestore di stili}
 & 

 & 
see {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-style-manager]{\emph{Gestore stile}}}
 & 

\\

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

 & 

 & 

\\

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

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

\\

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

 & 
see {\hyperref[docs/user_manual/introduction/qgis_configuration:gui-options]{\emph{Opzioni dell’interfaccia grafica (GUI)}}}
 & 

\\

\emph{Opzioni di snap}
 & 

 & 

 & 

\\
\hline\end{tabulary}



\subsection{Plugins}
\label{docs/user_manual/introduction/qgis_gui:plugins}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Voce di Menu
} & \textsf{\relax 
Scorciatoia
} & \textsf{\relax 
Riferimento
} & \textsf{\relax 
Barra degli Strumenti
}\\
\hline
\includegraphics[width=1.5em]{mActionShowPluginManager.png} \emph{Recupero lugin python}
 & 

 & 
see {\hyperref[docs/user_manual/plugins/plugins:plugins]{\emph{Plugin di QGIS}}}
 & 

\\

\includegraphics[width=1.5em]{mActionShowPluginManager.png} \emph{Gestione plugins}
 & 

 & 
see {\hyperref[docs/user_manual/plugins/plugins:managing-plugins]{\emph{Gestione dei plugin}}}
 & 

\\

\emph{Console python}
 & 

 & 

 & 

\\

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

 & 
see {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-grass]{\emph{Integrazione con GRASS GIS}}}
 & 
\emph{GRASS}
\\
\hline\end{tabulary}



\subsection{Vector}
\label{docs/user_manual/introduction/qgis_gui:vector}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Voce di Menu
} & \textsf{\relax 
Scorciatoia
} & \textsf{\relax 
Riferimento
} & \textsf{\relax 
Barra degli Strumenti
}\\
\hline
\emph{Strumenti di Analisi \(\rightarrow\)}
 & 

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

\\

\emph{Cattura coordinate \(\rightarrow\)}
 & 

 & 
see {\hyperref[docs/user_manual/plugins/plugins_coordinate_capture:coordcapt]{\emph{Plugin Cattura coordinate}}}
 & 

\\

\emph{Strumenti di gestione dati \(\rightarrow\)}
 & 

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

\\

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

 & 
see {\hyperref[docs/user_manual/plugins/plugins_dxf2shape_converter:dxf2shape]{\emph{Plugin Dxf2Shp Converter}}}
 & 
\emph{Vettore}
\\

\emph{Strumenti di geometria \(\rightarrow\)}
 & 

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

\\

\emph{Strumenti di Geoprocessing \(\rightarrow\)}
 & 

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

\\

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

 & 
see {\hyperref[docs/user_manual/working_with_gps/plugins_gps:plugin-gps]{\emph{Plugin GPS}}}
 & 
\emph{Vettore}
\\

\emph{Strumenti di ricerca \(\rightarrow\)}
 & 

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

\\

\emph{Road Graph (grafo strade) \(\rightarrow\)}
 & 

 & 
see {\hyperref[docs/user_manual/plugins/plugins_road_graph:roadgraph]{\emph{Plugin grafo strade}}}
 & 

\\

\emph{Interrogazione spaziale \(\rightarrow\)}
 & 

 & 
see {\hyperref[docs/user_manual/plugins/plugins_spatial_query:spatial-query]{\emph{Plugin Spatial Query}}}
 & 
\emph{Vettore}
\\
\hline\end{tabulary}



\subsection{Raster}
\label{docs/user_manual/introduction/qgis_gui:raster}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Voce di Menu
} & \textsf{\relax 
Scorciatoia
} & \textsf{\relax 
Riferimento
} & \textsf{\relax 
Barra degli Strumenti
}\\
\hline
\emph{Calcolatore raster}
 & 

 & 
see  {\hyperref[docs/user_manual/working_with_raster/raster_calculator:sec-raster-calc]{\emph{Calcolatore raster}}}
 & 

\\

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

 & 
see {\hyperref[docs/user_manual/plugins/plugins_georeferencer:georef]{\emph{Plugin Georeferenziatore}}}
 & 
\emph{Raster}
\\

\emph{Mappa di concentrazione \(\rightarrow\)}
 & 

 & 
see {\hyperref[docs/user_manual/plugins/plugins_heatmap:heatmap-plugin]{\emph{Plugin Mappa di concentrazione}}}
 & 
\emph{Raster}
\\

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

 & 
see {\hyperref[docs/user_manual/plugins/plugins_interpolation:interpol]{\emph{Plugin Interpolazione}}}
 & 
\emph{Raster}
\\

\includegraphics[width=1.5em]{dem.png} \emph{Analisi geomorfologica}
 & 

 & 
see {\hyperref[docs/user_manual/plugins/plugins_raster_terrain:rasterrain]{\emph{Plugin Analisi geomorfologica}}}
 & 

\\

\emph{Statistiche zonali \(\rightarrow\)}
 & 

 & 
see {\hyperref[docs/user_manual/plugins/plugins_zonal_statistics:zonal-statistics]{\emph{Plugin Statistica zonale}}}
 & 
\emph{Raster}
\\

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

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

\\

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

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

\\

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

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

\\

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

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

\\

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

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

\\

\emph{Impostazioni GdalTools}
 & 

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

\\
\hline\end{tabulary}



\subsection{Database}
\label{docs/user_manual/introduction/qgis_gui:database}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Voce di Menu
} & \textsf{\relax 
Scorciatoia
} & \textsf{\relax 
Riferimento
} & \textsf{\relax 
Barra degli Strumenti
}\\
\hline
\emph{DB manager \(\rightarrow\)}
 & 

 & 
see {\hyperref[docs/user_manual/plugins/plugins_db_manager:dbmanager]{\emph{Plugin DB Manager}}}
 & 
\emph{Database}
\\

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

 & 
see {\hyperref[docs/user_manual/plugins/plugins_evis:evis]{\emph{Plugin eVis}}}
 & 
\emph{Database}
\\

\emph{Editing offline \(\rightarrow\)}
 & 

 & 
see {\hyperref[docs/user_manual/plugins/plugins_offline_editing:offlinedit]{\emph{Plugin Offline Editing}}}
 & 
\emph{Database}
\\

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

 & 
see {\hyperref[docs/user_manual/plugins/plugins_spit:label-spit]{\emph{Plugin SPIT}}}
 & 
\emph{Database}
\\
\hline\end{tabulary}



\subsection{Web}
\label{docs/user_manual/introduction/qgis_gui:web}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Voce di Menu
} & \textsf{\relax 
Scorciatoia
} & \textsf{\relax 
Riferimento
} & \textsf{\relax 
Barra degli Strumenti
}\\
\hline
\emph{MapServer Export ... \(\rightarrow\)}
 & 

 & 
see {\hyperref[docs/user_manual/plugins/plugins_mapserver_export:mapserver-export]{\emph{Plugin MapServer Export}}}
 & 
\emph{Web}
\\

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

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



\subsection{Guida}
\label{docs/user_manual/introduction/qgis_gui:help}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Voce di Menu
} & \textsf{\relax 
Scorciatoia
} & \textsf{\relax 
Riferimento
} & \textsf{\relax 
Barra degli Strumenti
}\\
\hline
\includegraphics[width=1.5em]{mActionHelpContents.png} \emph{Contenuti della guida}
 & 
\code{F1}
 & 

 & 
\emph{Guida}
\\

\includegraphics[width=1.5em]{whats_this.png} \emph{What's This?}
 & 
\code{Shift+F1}
 & 

 & 
\emph{Guida}
\\

\emph{Documentazione sulle API}
 & 

 & 

 & 

\\

\includegraphics[width=1.5em]{mActionQgisHomePage.png} \emph{Home Page di QGIS}
 & 
\code{Ctrl+H}
 & 

 & 

\\

\includegraphics[width=1.5em]{mActionCheckQgisVersion.png} \emph{Controlla versione di QGIS}
 & 

 & 

 & 

\\

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

 & 

 & 

\\

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

 & 

 & 

\\
\hline\end{tabulary}




\includegraphics[width=1em]{nix.png} Gli oggetti della barra dei Menu elencati sopra sono quelli di default se si usa KDE come ambiente desktop. In GNOME, non è presente il menu Impostazioni e i suoi oggetti si possono trovare:

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

\includegraphics[width=1.5em]{mActionProjectProperties.png} \emph{Proprietà progetto}
 & 
\emph{File}
\\

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

\includegraphics[width=1em]{mActionOptions.png} \emph{Configura scorciatoie}
 & 
\emph{Modifica}
\\

\emph{Gestore di stili}
 & 
\emph{Modifica}
\\

\includegraphics[width=1.5em]{mActionCustomProjection.png} \emph{SR personalizzato}
 & 
\emph{Modifica}
\\

\emph{Pannelli \(\rightarrow\)}
 & 
\emph{Visualizza}
\\

\emph{Barre degli strumenti \(\rightarrow\)}
 & 
\emph{Visualizza}
\\

\emph{Schermo intero}
 & 
\emph{Visualizza}
\\

\emph{Slider per la scala delle tiles}
 & 
\emph{Visualizza}
\\

\emph{Tracciamento GPS in tempo reale}
 & 
\emph{Visualizza}
\\
\hline\end{tabulary}



\section{Barra degli Strumenti}
\label{docs/user_manual/introduction/qgis_gui:label-toolbars}\label{docs/user_manual/introduction/qgis_gui:toolbar}
\index{toolbar}
Le barre degli strumenti forniscono accesso alla maggior parte delle medesime funzioni presenti nei menu, oltre a funzioni addizionali per interagire con la mappa. Ogni oggetto della barra degli strumenti ha un aiuto a comparsa (popup). Lasciando il cursore del mouse sopra l’icona verrà visualizzata una breve descrizione della funzione fornita da quello strumento.

Ogni barra può essere spostata secondo le preferenze personali. Inoltre ognuna di esse può essere disattivata dal menu contestuale cliccando con il tasto destro del mouse sulla barra degli strumenti (leggi {\hyperref[docs/user_manual/introduction/qgis_configuration:sec-panels-and-toolbars]{\emph{Pannelli e Barre degli strumenti}}}).

\index{layout toolbars}
\begin{notice}{tip}{Suggerimento:}
\textbf{Ripristinare le barre degli strumenti}

Se avete accidentalmente disattivato tutte le barre strumenti, potete ripristinarle dalla voce di menu \emph{Visualizza \(\rightarrow\) Barre degli strumenti \(\rightarrow\)}. Se una barra degli strumenti scompare in Windows, il che sembra succedere di tanto in tanto, è necessario rimuovere \code{\textbackslash{}HKEY\_CURRENT\_USER\textbackslash{}Software\textbackslash{}QuantumGIS\textbackslash{}qgis\textbackslash{}UI\textbackslash{}state} dal registro. Quando si riavvia qgis viene ripristinato lo stato di default e le barre degli strumenti sono nuovamente visibili.
\end{notice}


\section{Legenda}
\label{docs/user_manual/introduction/qgis_gui:map-legend}\label{docs/user_manual/introduction/qgis_gui:label-legend}
\index{legend}
L’area di legenda è usata per impostare la visibilità e l’ordine di sovrapposizione dei layer. La casella di controllo in ogni legenda può essere usata per attivare/disattivare la visibilità di un layer.

\index{layer visibility}
Un layer può essere selezionato e trascinato in modo da modificarne la visibilità (z-ordering). Z-ordering significa che i layer in cima alla legenda coprono nella mappa quelli sottostanti.

I layer presenti nella legenda possono essere organizzaati in gruppi. Ci sono due modi per farlo:
\begin{enumerate}
\item {} 
Cliccare con il tasto destro del mouse nell’area di legenda e selezionare \emph{Aggiungi gruppo \(\rightarrow\)}, quindi assegnare un nome al gruppo e premere il tasto \code{Invio}. Ora è possibile cliccare e trascinare layer esistenti all’interno del gruppo.

\item {} 
Selezionare alcuni layer, cliccare con il tasto destro e selezionare \emph{Gruppo selezionato}. I layer selezionati saranno automaticamenti spostati in un nuovo gruppo.

\end{enumerate}

Per rimuovere un layer da un gruppo è possibile cliccare e trascinare il layer al di fuori dello stesso o in alternativa cliccare con il tasto destro del mouse sul layer e selezionare \emph{Muovi fuori dal gruppo  \(\rightarrow\)}. I gruppi possono essere nidificati all’interno di altri gruppi.

La casella di controllo di un gruppo può essere usata per mostrare/nascondere tutti i layer del gruppo con un singolo clic.

Il contenuto del menu contestuale varia a seconda che si faccia click col tasto destro del mouse su un layer raster o vettoriale. Per i layer vettoriali di GRASS la voce di menu \includegraphics[width=1.5em]{mActionToggleEditing.png} $^{\text{Modifica}}$ non è abilitata. Si veda la sezione {\hyperref[docs/user_manual/grass_integration/grass_integration:grass-digitizing]{\emph{Digitalizzare e modificare layer vettoriali GRASS}}} per informazioni su come modificare layer vettoriali GRASS.

\textbf{Menu contestuale per i raster}
\begin{itemize}
\item {} 
\emph{Zoom all’estensione del layer \(\rightarrow\)}

\item {} 
\emph{Zoom alla scala migliore (100 \%) \(\rightarrow\)}

\item {} 
\emph{Aggiungi alla panoramica \(\rightarrow\)}

\item {} 
\emph{Rimuovi \(\rightarrow\)}

\item {} 
\emph{Imposta il SR del layer \(\rightarrow\)}

\item {} 
\emph{Imposta SR progetto dal layer}

\item {} 
\emph{Proprietà}

\item {} 
\emph{Rinomina \(\rightarrow\)}

\item {} 
\emph{Copia stile}

\item {} 
\emph{Aggiungi nuovo gruppo \(\rightarrow\)}

\item {} 
\emph{Espandi tutto \(\rightarrow\)}

\item {} 
\emph{Racchiudi tutto \(\rightarrow\)}

\item {} 
\emph{Aggiorna l'ordine del disegno}

\end{itemize}

Inoltre, a seconda della posizione e della selezione del layer
\begin{itemize}
\item {} 
\emph{Crea un elemento al livello più alto}

\item {} 
\emph{Gruppo selezionato}

\end{itemize}



\textbf{Menu contestuale per i vettori}
\begin{itemize}
\item {} 
\emph{Zoom all’estensione del layer \(\rightarrow\)}

\item {} 
\emph{Aggiungi alla panoramica \(\rightarrow\)}

\item {} 
\emph{Rimuovi \(\rightarrow\)}

\item {} 
\emph{Imposta il SR del layer \(\rightarrow\)}

\item {} 
\emph{Imposta SR progetto dal layer}

\item {} 
\emph{Apri tabella attributi}

\item {} 
\emph{Modifica (non disponibile per i layer GRASS)}

\item {} 
\emph{Salva come}

\item {} 
\emph{Salva selezione come}

\item {} 
\emph{Interrogazione}

\item {} 
\emph{Mostra totale elementi}

\item {} 
\emph{Proprietà}

\item {} 
\emph{Rinomina \(\rightarrow\)}

\item {} 
\emph{Copia stile}

\item {} 
\emph{Aggiungi nuovo gruppo \(\rightarrow\)}

\item {} 
\emph{Espandi tutto \(\rightarrow\)}

\item {} 
\emph{Racchiudi tutto \(\rightarrow\)}

\item {} 
\emph{Aggiorna l'ordine del disegno}

\end{itemize}

Inoltre, a seconda della posizione e della selezione del layer
\begin{itemize}
\item {} 
\emph{Crea un elemento al livello più alto}

\item {} 
\emph{Gruppo selezionato}

\end{itemize}



\textbf{Menu contestuale per i gruppi di layer}
\begin{itemize}
\item {} 
\emph{Zoom al gruppo}

\item {} 
\emph{Rimuovi \(\rightarrow\)}

\item {} 
\emph{Imposta il SR di gruppo}

\item {} 
\emph{Rinomina \(\rightarrow\)}

\item {} 
\emph{Aggiungi nuovo gruppo \(\rightarrow\)}

\item {} 
\emph{Espandi tutto \(\rightarrow\)}

\item {} 
\emph{Racchiudi tutto \(\rightarrow\)}

\item {} 
\emph{Aggiorna l'ordine del disegno}

\end{itemize}

È possibile selezionare più di un layer o gruppo allo stesso tempo tenendo premuto il tasto \code{Ctrl} e selezionando con il tasto sinistro del mouse. Tutti i layer così selezionati possono essere spostati contemporaneamente in un nuovo gruppo.

E' possibile anche rimuovere uno o più layer gruppi selezionandoli prima con il tasto \code{Ctrl} e premendo successivamente \code{Ctrl D}. In questo modo tutti i layer selezionati saranno rimossi dalla lista.


\subsection{Lavorare con la Legenda indipendentemente dall'ordine dei layer}
\label{docs/user_manual/introduction/qgis_gui:working-with-the-legend-independent-layer-order}
Dalla versione 1.8 di QGIS, grazie ad un widget, è possibile impostare una legenda indipendentemente dall'ordine di disegno. Si può attivare questa opzione dal menu \emph{Visualizza \(\rightarrow\) Pannelli} e determinare l'ordine di disegno dei layer nella zona di visualizzazione. Cosi facendo si possono ordinare i layer in base, per esempio all'importanza, pur mantenendo l'ordine di visualizzazione iniziale corretto (vedi {\hyperref[docs/user_manual/introduction/qgis_gui:figure-layer-order]{figure\_layer\_order}}). Spuntando la casella \includegraphics{checkbox.png} \emph{control rendering order} collocata sotto l'elenco dei layer è possibile ritornare al comportamento iniziale.
\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{Vista Mappa}
\label{docs/user_manual/introduction/qgis_gui:map-view}\label{docs/user_manual/introduction/qgis_gui:label-mapview}
Questa è l’area in cui le mappe vengono visualizzate. La mappa visualizzata in questa finestra sarà il risultato dei layer vettoriali e/o raster che si è scelto di caricare (vedere le sezioni che seguono per ulteriori informazioni su come caricare i layer). La zona di visualizzazione della mappa può essere modificata (spostando la messa a fuoco dell’esposizione della mappa ad un’altra regione) ed è possibile effettuare operazioni di zoom in ed out (+ e -). Varie altre operazioni sono descritte nella sezione relativa alla barra dei menu. La vista nell’area di mappa e la legenda sono strettamente legate l’un l’altra: le mappe che vengono visualizzate riflettono i cambiamenti fatti nella area della legenda.

\index{zoom mouse wheel}
\begin{notice}{tip}{Suggerimento:}
\textbf{ZOOM IN E ZOOM OUT CON LA ROTELLA DEL MOUSE}

Per le operazioni di zoom è anche possibile utilizzare la rotella del mouse. Posizionando il puntatore del mouse nell’area di visualizzazione delle mappe si aumenta lo zoom girando la rotella verso lo schermo, lo si riduce girandola nel verso contrario. La posizione del puntatore costituisce il centro per l’ingrandimento. Il comportamento della funzione di zoom con la rotella del mouse può essere regolata dalla scheda \emph{Map tools} sotto il menu \emph{Impostazioni \(\rightarrow\) Opzioni} .
\end{notice}

\begin{notice}{tip}{Suggerimento:}
\textbf{MUOVERE LA MAPPA CON I TASTI FRECCIA E LA BARRA SPAZIATRICE}

\index{pan arrow keys}
È possibile usare i tasti freccia per muovere la mappa. Posizionando il puntatore del mouse nell’area di visualizzazione delle mappe, ci si muove verso Est con la freccia destra, verso Ovest con quella sinistra, verso Nord con la freccia su e verso Sud con la freccia giù. Si può spostare la mappa anche tenendo premuta la barra spaziatrice e muovendo il mouse.
\end{notice}
\phantomsection\label{docs/user_manual/introduction/qgis_gui:label-mapoverview}

\section{Barra di Stato}
\label{docs/user_manual/introduction/qgis_gui:label-statusbar}\label{docs/user_manual/introduction/qgis_gui:status-bar}
La barra di stato mostra le coordinate di mappa (es. metri o gradi decimali) alla posizione del mouse. Nella barra di stato a sinistra del visore delle  coordinate è presente un piccolo pulsante che consente di passare dalla visione delle coordinate al movimento del mouse alla visione delle coordinate dell’estensione della vista mappa.

Accanto al display di visualizzazione delle coordinate si trova il display della scala. Questo mostra la scala della vista mappa. Sia ingrandendo che rimpicciolendo la scala, QGIS mostrerà la scala corrente. Dalla versione 1.8 di QGIS è possibile scegliere fra scale predefinite da 1:500 a 1:1000000.

Una barra di avanzamento nella barra di stato mostra il progredire della visualizzazione di ogni layer nella vista mappa. In alcuni casi, come quando vengono raccolte informazioni statistiche su layer raster, questa barra è utilizzata per mostrare lo stato di tali processi, in genere molto lunghi.

Se è disponibile un nuovo plugin o un aggiornamento ad un plugin installato, nella barra di stato apparirà un avviso. L’icona \includegraphics[width=1.5em]{mIconStopRendering.png} disattiva temporaneamente la visualizzazione dei layer nella vista mappa (Sezione {\hyperref[docs/user_manual/introduction/general_tools:redraw-events]{\emph{Visualizzazione}}}). L'icona \includegraphics[width=1.5em]{mIconStopRendering.png} Nella parte destra della barra di stato è presente una casella di controllo che, se attivata, può essere usata per impedire temporaneamente la visualizzazione dei layer.

All’estrema destra della barra di stato appare il codice EPSG del SR del progetto corrente; cliccando sull’icona a forma di proiettore subito a destra del codice EPSG è possibile accedere alle proprietà del SR stesso.

\begin{notice}{tip}{Suggerimento:}
\textbf{IMPOSTARE CORRETTAMENTE LA SCALA DELLA MAPPA}

\index{scale calculate}
I gradi sono l'unità di misura predefinita di QGIS, quindi le coordinate di ciascun layer verranno visualizzate in gradi decimali. Per ottenere valori di scala corretti, è possibile cambiarli manualmente in unità metriche nella scheda \emph{Generale} sotto il menu \emph{Impostazioni \(\rightarrow\) Proprietà progetto} oppure è possibile scegliere un Sistema di riferimento (SR) cliccando sull'icona \includegraphics[width=1.5em]{mIconProjectionDisabled.png} $^{\text{Stato SR}}$ nell'angolo in basso a destra della barra di stato. In quest'ultimo caso le unità di misura sono impostate secondo le caratteristiche delle proprietà del progetto, ad esempio `+units=m'.
\end{notice}


\chapter{Strumenti generali}
\label{docs/user_manual/introduction/general_tools::doc}\label{docs/user_manual/introduction/general_tools:general-tools}

\section{Scorciatoie da tastiera}
\label{docs/user_manual/introduction/general_tools:shortcuts}\label{docs/user_manual/introduction/general_tools:keyboard-shortcuts}
\index{Scorciatoie da tastiera}
QGIS fornisce delle scorciatoie da tastiera predefinite per molte delle sue funzionalità: queste sono disponibili  nella sezione {\hyperref[docs/user_manual/introduction/qgis_gui:label-menubar]{\emph{Barra dei Menu}}}. Inoltre, l{}`opzione di menu \emph{Impostazioni \(\rightarrow\)} \emph{Configura scorciatoie \(\rightarrow\)} permette di modificare le scorciatoie da tastiera predefinite e di aggiungerne delle nuove.
\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 configurazione è molto semplice; basta selezionare una funzionalità di interesse e cliccare \textbf{{[}Cambia{]}}, \textbf{{[}Elimina{]}} or \textbf{{[}Selezione predefinita{]}}. Le configurazioni possono essere salvate in un file XML e caricate in un’altra installazione di QGIS.


\section{Guide contestuali}
\label{docs/user_manual/introduction/general_tools:context-help}\label{docs/user_manual/introduction/general_tools:id1}
\index{Guide contestuali}
Quando si ha necessità di maggiori informazioni su una funzionalità specifica è possibile utilizzare la guida contestuale disponibile in molte finestre di dialogo. Si noti che nel caso di plugin di terze parti la guida contestuale potrebbe rimandare ad una pagina web dedicata.


\section{Visualizzazione}
\label{docs/user_manual/introduction/general_tools:rendering}\label{docs/user_manual/introduction/general_tools:redraw-events}
\index{Visualizzazione}
Come impostazione di default QGIS ricarica nella vista tutti i layer visibili ogni qualvolta la vista vieneaggiornata. Gli eventi che causano l’aggiornamento della vista includono:
\begin{itemize}
\item {} 
Aggiunta di un layer

\item {} 
Spostamento, ingrandimento o riduzione (pan e zoom)

\item {} 
Ridimensionamento della finestra di QGIS

\item {} 
Cambiamento della visibilità di uno o più layer

\end{itemize}

QGIS consente di controllare il processo di resa a video in diverse maniere.


\subsection{Visualizzazione in funzione della scala}
\label{docs/user_manual/introduction/general_tools:scale-dependent-rendering}
\index{Rendering scale dependent}
La visualizzazione in funzione della scala consente di specificare la scala minima e massima rispettivamenteal di sotto e al di sopra della quale un layer resta visibile. Per impostare la visualizzazione in funzione dellascala, aprire la finestra di dialogo \emph{Properties} facendo doppio click sul layer nella legenda. Nella scheda \emph{Generale} spuntare la casella di controllo \includegraphics{checkbox.png}\emph{Visualizza in funzione della scala} e impostare i valori per la scala massima e minima.

I valori di scala possono essere determinati usando prima lo zoom sul layer per il quale si vuole impostarel’opzione e prendendo successivamente nota del valore di scala visualizzato nella barra di stato di QGIS.

\index{Scale}

\subsection{Controllare la visualizzazione della mappa}
\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}
La visualizzazione della mappa può essere controllata nei seguenti modi:


\subsubsection{Sospensione della visualizzazione}
\label{docs/user_manual/introduction/general_tools:label-suspendrender}\label{docs/user_manual/introduction/general_tools:suspending-rendering}
Per sospendere la resa a video, cliccare sulla casella di controllo \includegraphics{checkbox.png} \emph{Aggiorna} in basso a destra della barra di stato. Quando la casella  \includegraphics{checkbox.png} \emph{Aggiorna} non è selezionata, QGIS non ridisegna la vista quando si verifica uno degli eventi precedentemente descritti alla Sezione {\hyperref[docs/user_manual/introduction/general_tools:redraw-events]{\emph{Visualizzazione}}}. Casi in cui si potrebbe voler sospendere la visualizzazione a video includono:
\begin{itemize}
\item {} 
Aggiunta di molti layer ed applicazione di uno stile visuale prima della visualizzazione

\item {} 
Aggiunta di uno o più layer di grosse dimensioni e impostazione di una scala prima della visualizzazione

\item {} 
Aggiunta di uno o più layer di grossa dimensione e zoom ad un’area specifica prima della visualizzazione

\item {} 
Combinazioni delle precedenti

\end{itemize}

La selezione della casella di controllo \includegraphics{checkbox.png} \emph{Aggiorna} abilita la visualizzazione e causa l’immediato aggiornamento della vista mappa.


\subsubsection{Controllare la visibilità dei layer quando sono caricati}
\label{docs/user_manual/introduction/general_tools:setting-layer-add-option}\label{docs/user_manual/introduction/general_tools:label-settinglayer}
Può essere scelta l’opzione di caricare i nuovi layer senza che essi vengano immediatamente resi a video.Ciò significa che quando si aggiungerà un layer al progetto, la casella di controllo per la visibilità nella legendasarà disabilitata di default. Per impostare questa opzione, scegliere l’opzione di menu \emph{Impostazioni \(\rightarrow\) Opzioni \(\rightarrow\)} e cliccare sulla scheda \emph{Visualizzazione in corso}. Deselezionare la casella di controllo \includegraphics{checkbox.png} \emph{Per impostazione predefinita i nuovi layer aggiunti alla mappa vengono visualizzati subito}. Ogni layer aggiunto alla mappa sarà quindi spento (invisibile) di default.


\subsubsection{Fermare la visualizzazione}
\label{docs/user_manual/introduction/general_tools:stopping-rendering}
\index{Rendering halting}\phantomsection\label{docs/user_manual/introduction/general_tools:label-stoprender}
Per fermare la visualizzazione della mappa premere il tasto ESC. Si bloccherà cosi l{}`aggiornamento della vista e la mappa rimarrà parzialmente disegnata. Dopo aver premuto il tasto ESC potrebbe passare un po{}` di tempo affinchè l{}`interruzione della visualizzazione della mappa sia effettiva.

\begin{notice}{note}{Nota:}
Al momento non è possibile interrompere la visualizzazione in corso: questa opzione è stata disabilitata nella porta qt4 a causa di diversi problemi dell{}`interfaccia utente (UI).
\end{notice}


\subsubsection{Aggiornamento della mappa durante la visualizzazione}
\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}
Può essere impostata un’opzione per aggiornare la mappa man mano che gli elementi del layer vengono letti. Di default QGIS non traccia alcun elemento a video fino a che l’intero layer non sia stato letto. Per aggiornare la visualizzazione man mano che gli elementi vengono letti dall’archivio, selezionare la voce di menu \emph{Impostazioni\(\rightarrow\) Opzioni \(\rightarrow\)} e cliccare sulla scheda \emph{Visualizzazione in corso}. Impostare il numero di elementi che si desidera vengano letti prima che lo schermo venga aggiornato. Un valore pari a 0 disabilita l’aggiornamento durante il disegno degli oggetti (impostazione predefinita). Un valore troppo basso diminuisce le prestazioni in quanto la mappa viene continuamente aggiornata man mano che gli elementi del layer vengono letti. Un valore suggerito è 500.


\subsubsection{Modificare la qualità della visualizzazione}
\label{docs/user_manual/introduction/general_tools:label-renderquality}\label{docs/user_manual/introduction/general_tools:influence-rendering-quality}
\index{rendering quality}
Vi sono due opzioni per modificare la qualità della visualizzazione. Dal menu \emph{Impostazione \(\rightarrow\) Opzioni \(\rightarrow\)} cliccare sulla scheda \emph{Visualizzazione in corso} e selezionare o deselezionare le seguenti caselle di controllo.
\begin{itemize}
\item {} 
\includegraphics{checkbox.png} \emph{Rendi le linee meno irregolari a spese delle prestazioni}

\item {} 
\includegraphics{checkbox.png} \emph{Risolvi problemi con i poligoni riempiti non correttamente}

\end{itemize}


\section{Misurazioni}
\label{docs/user_manual/introduction/general_tools:measuring}\label{docs/user_manual/introduction/general_tools:sec-measure}
\index{measure}
È possibile effettuare misure unicamente nei sistemi di coordinate piane (es. UTM). Se la mappa caricata è definita in un sistema di coordinate geografiche (es. latitudine/longitudine), il risultato della misura di linee o di aree sarà errato. Per misurare è quindi necessario impostare correttamente il sistema di coordinate della mappa (si veda la Sezione {\hyperref[docs/user_manual/working_with_projections/working_with_projections:label-projections]{\emph{Lavorare con le proiezioni}}}). Tutti i moduli di misura usano inoltre le opzioni di snapping del modulo di digitalizzazione. Questo è utile se si desidera misurare lungo linee o aree di layer vettoriali.

Per selezionare uno strumento di misura cliccare su \includegraphics[width=1.5em]{mActionMeasure.png} e scegliere lo strumento che si intende utilizzare.


\subsection{Misurare lunghezze, aree ed angoli}
\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 è in grado di fornire la misura della distanza reale tra due punti in funzione di uno specifico ellissoide. Ciò può essere configurato con l’opzione di menu \emph{Impostazioni \(\rightarrow\) Opzioni \(\rightarrow\)} cliccando sulla scheda \emph{Strumenti mappa} e scegliendo l’ellissoide appropriato. Qui sarà possibile definire il colore elastico e l’unità di misura preferita (metri o piedi). Lo strumento consentirà allora di cliccare punti sulla mappa: la misura di ogni segmento verrà mostrata nella finestra dello strumento insieme alla misura totale. Per terminare la misura cliccare con il tasto destro del mouse.
\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} Questo strumento consente di misurare aree; la finestra mostrerà unicamente l’area totale misurata.In aggiunta, lo strumento di misura farà lo snap sul layer selezionato al momento, nel caso il layer abbia definita la sua tolleranza di snap (Sezione {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:snapping-tolerance]{\emph{Settare la tolleranza dello snapping e il raggio di ricerca degli elementi}}}). Se, quindi, si vuole misurare esattamente lungo una linea o un poligono è necessario prima definire la tolleranza di snap, poi selezionare il layer. In questo modo, quando vengono usati gli strumenti di misura, ogni click del mouse (all’interno della tolleranza definita) si aggancerà a quel layer.
\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} È possibile misurare angoli tramite lo strumento Misura angoli. Cliccare e disegnare il primo segmento dell’angolo, poi spostare il mouse per disegnare l’angolo stesso; la misura apparirà in una finestra popup.
\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{Selezionare e deselezionare elementi}
\label{docs/user_manual/introduction/general_tools:select-and-deselect-features}\label{docs/user_manual/introduction/general_tools:sec-selection}
QGIS fornisce diversi strumenti per la selezione di elementi nella vista mappa. Per selezionare uno o più elementi cliccare \includegraphics[width=1.5em]{mActionSelect.png} e scegliere lo strumento di interesse:
\begin{itemize}
\item {} 
\includegraphics[width=1.5em]{mActionSelect.png} $^{\text{Seleziona il singolo elemento}}$

\item {} 
\includegraphics[width=1.5em]{mActionSelectRectangle.png} $^{\text{Seleziona elementi con un rettangolo}}$

\item {} 
\includegraphics[width=1.5em]{mActionSelectPolygon.png} $^{\text{Seleziona elementi con un poligono}}$

\item {} 
\includegraphics[width=1.5em]{mActionSelectFreehand.png} $^{\text{Seleziona elementi a mano libera}}$

\item {} 
\includegraphics[width=1.5em]{mActionSelectRadius.png} $^{\text{Seleziona elementi con un cerchio}}$

\end{itemize}

Per deselezionare tutti gli elementi selezionati cliccare su \includegraphics[width=1.5em]{mActionDeselectAll.png} $^{\text{Deselect features from all layers}}$.


\section{Decorazioni}
\label{docs/user_manual/introduction/general_tools:id2}\label{docs/user_manual/introduction/general_tools:decorations}
Le decorazioni includono l{}`Etichetta Copyright, la Freccia Nord e la Barra di scala. Sono usati per decorare la mappa aggiungendo elementi cartografici.

\begin{notice}{note}{Nota:}
Prima di QGIS 1.8 le stesse funzionalità erano fornite dal Plugin Decorazione.
\end{notice}


\subsection{Etichetta Copyright}
\label{docs/user_manual/introduction/general_tools:copyright-label}
\includegraphics[width=1.5em]{copyright_label.png} \emph{Etichetta Copyright} aggiunge un{}`Etichetta Copyright personalizzata in base al testo che si preferisce far apparire sulla mappa.
\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 {} 
Seleziona dal menu \emph{Visualizza \(\rightarrow\) Decorazioni\(\rightarrow\) Etichetta copyright}. Si aprirà un{}`altra finestra (vedi {\hyperref[docs/user_manual/introduction/general_tools:figure-decorations-1]{figure\_decorations\_1}}).

\item {} 
Digitare il testo che si vuole aggiungere alla mappa. Si può usare codice HTML come mostrato nell’esempio

\item {} 
Scegliere il posizionamento dell’etichetta dal menu a tendina \emph{Posizione} \emph{In basso a destra}

\item {} 
Assicurasi che la casella di controllo \includegraphics{checkbox.png} \emph{Abilita etichetta di Copyright} sia selezionata

\item {} 
Cliccare \textbf{{[}OK{]}}

\end{enumerate}

Nell’esempio (default) il simbolo di copyright è seguito dalla data ed è posto nell{}`angolo in basso a destra della vista.


\subsection{Freccia Nord}
\label{docs/user_manual/introduction/general_tools:north-arrow}
\includegraphics[width=1.5em]{north_arrow.png} \emph{North Arrow} aggiunge alla mappa una semplice freccia indicante il nord. Al momento c’è un solo stile disponibile. Si può modificare manualmente l’angolo della freccia o lasciare che QGIS imposti automaticamente la direzione. Per il posizionamento della freccia si hanno quattro possibilità, corrispondenti ai quattro angoli della mappa.
\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{Barra di Scala}
\label{docs/user_manual/introduction/general_tools:scale-bar}
\includegraphics[width=2.5em]{scale_bar.png} \emph{Scale Bar} aggiunge una semplice barra di scala alla mappa. Si può controllare lo stile ed il posizionamento, come anche l’etichettatura della scala.
\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 supporta solamente la visualizzazione della scala nella stessa unità di misura della mappa. Se l’unità di misura dei layer è il metro, non si può creare una barra di scala in piedi. Allo stesso modo, se si usano gradi decimali, non si può creare una barra di scala che mostri le distanze in metri.

Per aggiungere una barra di scala:
\begin{enumerate}
\item {} 
Selezionare dal menu \emph{Visualizzazione \(\rightarrow\) Decorazioni\(\rightarrow\) Barra di scale}. Si aprirà cosi una finestra di dialogo (see {\hyperref[docs/user_manual/introduction/general_tools:figure-decorations-3]{figure\_decorations\_3}})

\item {} 
Scegliere il posizionamento dal menu a tendina \emph{Posizionamento} \emph{In basso a sinistra}

\item {} 
Scegliere lo stile dalla lista \emph{Stile della Barra di Scala} \emph{Porta in basso}

\item {} 
Scegliere il colore della barra di scala \emph{Colore della barra} \emph{black} o usare il colore nero di default

\item {} 
Impostare la dimensione della barra e la sua etichetta \emph{Dimensione della barra} \emph{30 gradi}

\item {} 
Assicurarsi che la casella di controllo \includegraphics{checkbox.png} \emph{Abilitare barra di scala} sia selezionata

\item {} 
Se si vuole, scegliere di arrotondare automaticamente il numero quando la mappa viene ridimensionata \includegraphics{checkbox.png} \emph{Arrotonda automaticamente il numero durante il ridimensionamento}

\item {} 
Cliccare \textbf{{[}OK{]}}

\end{enumerate}

\begin{notice}{tip}{Suggerimento:}
\textbf{Impostazioni delle decorazioni}

Quando si salva un progetto .qgs, ogni impostazione relativa alle decorazioni viene salvata nello stesso progetto e ripristinata alla successiva apertura del file .qgs.
\end{notice}
\phantomsection\label{docs/user_manual/introduction/general_tools:sec-annotations}
\index{annotation}

\section{Note testuali}
\label{docs/user_manual/introduction/general_tools:annotation-tools}\label{docs/user_manual/introduction/general_tools:index-12}
Lo strumento \includegraphics[width=1.5em]{mActionTextAnnotation.png} note nella barra degli attributi permette di posizionare del testo formattato sulla vista mappa di QGIS. Scegliere lo strumento note e cliccare nella vista mappa.
\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}

Facendo doppio-click sull’elemento aggiunto sulla mappa dallo strumento note si ha accesso ad una finestra di dialogo con varie opzioni. C’è un editor di testo semplificato per l’inserimento del testo formattato; è possibile scegliere se vincolare il testo alla mappa o solo allo schermo.

Il testo può essere spostato secondo le proprie esigenze tramite lo strumento \includegraphics[width=1.5em]{mActionFormAnnotation.png} muovi nota.


\subsection{Nota con modulo}
\label{docs/user_manual/introduction/general_tools:form-annotations}
È possibile creare moduli note personalizzati. Lo strumento \includegraphics[width=1.5em]{mActionFormAnnotation.png} Note con modulo è utile per visualizzare gli attributi di un layer vettoriale in un modulo personalizzato qt designer(Figura {\hyperref[docs/user_manual/introduction/general_tools:figure-custom-annotation]{figure\_custom\_annotation}}). È simile alla finestra dello strumento ’Informazioni elementi’, ma il tutto viene mostrato in una nota. Si veda il blog \href{http://blog.qgis.org/node/143}{http://blog.qgis.org/node/143} per maggiori dettagli.
\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}{Nota:}
Nota: Premendo \code{Ctrl+T} con uno strumento nota attivo (Nota testuale, Nota con modulo, Muovi nota) lo stato di visualizzazione delle note si inverte: se sono visibili diventano invisibili e viceversa.
\end{notice}


\section{Segnalibri geospaziali}
\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}
I segnalibri geospaziali consentono di memorizzare una posizione geografica alla quale ritornare in un secondo momento.


\subsection{Creazione di un segnalibro}
\label{docs/user_manual/introduction/general_tools:creating-a-bookmark}
Per creare un segnalibro:
\begin{enumerate}
\item {} 
Usare lo zoom o muovere la mappa all’estensione d’interesse.

\item {} 
Selezionare la voce di menu \emph{Visualizza\(\rightarrow\) Nuovo segnalibro\(\rightarrow\)} oppure premere \code{Ctrl-B}.

\item {} 
Inserire un nome descrittivo per il segnalibro (fino a 255 caratteri).

\item {} 
Cliccare su \textbf{{[}OK{]}} per aggiungere il segnalibro o \textbf{{[}Close{]}} per uscire senza aggiungere il segnalibro.

\end{enumerate}

Si noti che è possibile avere più di un segnalibro con lo stesso nome.


\subsection{Uso e gestione dei segnalibri}
\label{docs/user_manual/introduction/general_tools:working-with-bookmarks}
Per usare o gestire i segnalibri, selezionare la voce di menu \emph{Visualizza\(\rightarrow\) Mostra segnalibri \(\rightarrow\)}. La finestra \emph{Segnalibri geospaziali} consente di usare lo zoom a un segnalibro o di eliminarne uno. Non è possibile editare il nome o le coordinate di un segnalibro.


\subsection{Zoom a un segnalibro}
\label{docs/user_manual/introduction/general_tools:zooming-to-a-bookmark}
Dalla finestra \emph{Segnalibri geospaziali}, selezionare il segnalibro desiderato cliccando su di esso, quindi cliccare su \textbf{{[}Zoom A{]}}. Si può usare lo zoom su un segnalibro anche facendo doppio click su di esso.


\subsection{Cancellare un segnalibro}
\label{docs/user_manual/introduction/general_tools:deleting-a-bookmark}
Per cancellare un segnalibro dalla finestra  \emph{Segnalibri geospaziali}, cliccare su di esso e poi sul pulsante \textbf{{[}Elimina{]}}. Confermare la scelta cliccando su \textbf{{[}OK{]}} o annullare l’eliminazione cliccando su \textbf{{[}Close{]}}.


\section{Progetti nidificati}
\label{docs/user_manual/introduction/general_tools:nesting-projects}\label{docs/user_manual/introduction/general_tools:id3}
\index{nesting projects}
Per includere file di progetti diversi all{}`interno del proprio progetto, scegliere \emph{Layer \(\rightarrow\) Includi layer e gruppi \(\rightarrow\)}.


\subsection{Layers inclusi}
\label{docs/user_manual/introduction/general_tools:embedding-layers}
La finestra di dialogo permette di scegliere quali layer di altri progetti includere:
\begin{enumerate}
\item {} 
Scegliere \includegraphics{browsebutton.png} per cercare un altro progetto del dataset Alaska.

\item {} 
Selezionare il file progetto grassland. E{}` possibile vedere il contenuto del progetto (Figura figure\_embed\_dialog).

\item {} 
Premere \code{Ctrl} e cliccare sui layer grassland e regioni. I layers sono aggiunti sia nella legenda che nella vista della mappa.

\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}

Non si possono modificare le proprietà, come stile e etichette, dei layers aggiunti.

\textbf{Eliminare i layers}

Cliccare con il tasto destro sul layer aggiunto e scegliere \includegraphics[width=1.5em]{mActionRemoveLayer.png} \emph{Rimuovi}.


\chapter{Configurazione di QGIS}
\label{docs/user_manual/introduction/qgis_configuration:qgis-configuration}\label{docs/user_manual/introduction/qgis_configuration::doc}
QGIS è altamente configurabile attraverso i menu \emph{Impostazioni \(\rightarrow\)} e \emph{Visualizza \(\rightarrow\)}. Scegliere rispettivamente fra  Opzioni, Personalizzazione e Pannelli, Barre degli strumenti.


\section{Pannelli e Barre degli strumenti}
\label{docs/user_manual/introduction/qgis_configuration:sec-panels-and-toolbars}\label{docs/user_manual/introduction/qgis_configuration:panels-and-toolbars}
Nel menu \emph{Pannelli \(\rightarrow\)} è possibile attivare e disattivare i widgets di QGIS. Il menu \emph{Barre degli strumenti \(\rightarrow\)} offre la possibilità di attivare e disattivare gruppi di icone nella barra degli strumenti di QGIS (see {\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}{Suggerimento:}
\textbf{Panoramica}

Il pannello di panoramica della mappa fornisce una vista completa dei layer aggiunti ad essa. Può essere selezionato nel menu \emph{Visualizza \(\rightarrow\) Pannelli}. All’interno della panoramica è presente un rettangolo che mostra l’estensione corrente della mappa. Ciò permette di determinare rapidamente quale area della mappa si sta attualmente osservando. Si noti che le etichette non sono visualizzate nella panoramica anche se i layer hanno la funzione di visualizzazione delle etichette attiva. Cliccando e trascinando nella panoramica il rettangolo rosso che mostra l’estensione corrente della vostra vista, la mappa si sposta di conseguenza.
\end{notice}

\begin{notice}{tip}{Suggerimento:}
\textbf{Messaggi di log}

Dalla versione 1.8 di QGIS è possibile tenere traccia dei messaggi di QGIS. E' possibile attivare la casella di controllo \includegraphics{checkbox.png}\emph{Messaggi di log} nel menu \emph{Visualizza \(\rightarrow\) Pannelli} e seguire cosi i messaggi relativi alle varie operazioni nella scheda \emph{Generale} e \emph{Plugin}.
\end{notice}


\section{Proprietà progetto}
\label{docs/user_manual/introduction/qgis_configuration:project-properties}
Nella finestra delle proprietà del progetto sotto \includegraphics[width=1em]{nix.png} \emph{File \(\rightarrow\) Proprietà progetto} o \includegraphics[width=1em]{win.png} \emph{Impostazioni \(\rightarrow\) Proprietà progetto}  possono essere impostate opzioni specifiche del progetto. Queste includono:
\begin{itemize}
\item {} 
Nella scheda \emph{Generale}  il titolo del progetto, il colore di selezione e dello sfondo, le unità di misura e l’opzione per salvare i percorsi relativi ai layer. È possibile impostare le unità di misura (usato solo quando la riproiezione è disabilitata) e la precisione per le cifre decimali.

\item {} 
La scheda \emph{Sistema di riferimento (SR)} permette di scegliere il sistema di proiezione delle coordinate e di abilitare la riproiezione al volo dei layer vettoriali quando vengono visualizzati layer con differenti SR.

\item {} 
La scheda \emph{Layer interrogabil} permette di definire i layer che risponderanno allo strumento di interrogazione. (Vedere il paragrafo Strumenti mappa nella sezione {\hyperref[docs/user_manual/introduction/qgis_configuration:gui-options]{\emph{Opzioni dell’interfaccia grafica (GUI)}}} per abilitare l’interrogazione di layer multipli.)

\item {} 
La scheda \emph{Server WMS} permette di definire le informazioni del Service Capabilities, l’Estensione pubblicata e le Restrizioni dei sistemi di coordinate del mapserver QGIS. Attivando \includegraphics{checkbox.png} \emph{Aggiungi geometria WKT alle informazioni di risposta dell’oggetto} il layer WMS risulterà interrogabile.

\end{itemize}


\section{Opzioni dell’interfaccia grafica (GUI)}
\label{docs/user_manual/introduction/qgis_configuration:options}\label{docs/user_manual/introduction/qgis_configuration:gui-options}
\includegraphics[width=1em]{mActionOptions.png} Alcune opzioni di base per QGIS possono essere impostate nella finestra \emph{Opzioni}. Selezionare la voce di menu  \emph{Impostazioni \(\rightarrow\)} \includegraphics[width=1em]{mActionOptions.png} \emph{Opzioni}. Le schede nelle quali possono essere regolate le opzioni sono:


\subsection{Generale}
\label{docs/user_manual/introduction/qgis_configuration:general-tab}\begin{itemize}
\item {} 
\includegraphics{checkbox.png} \emph{Richiedi di salvare i cambiamenti di progetto se necessario}

\item {} 
\includegraphics{checkbox.png} \emph{Avvisa quando viene aperto un file di progetto salvato con una vecchia versione di QGIS}

\item {} 
Cambia il colore della selezione e dello sfondo

\item {} 
Cambia lo stile di QGIS

\item {} 
Tema delle icone (scelta tra `default', `classic' e `gis')

\item {} 
Dimensione delle icone (scelta tra 16, 24 e 32).

\item {} 
Carattere

\item {} 
Azione eseguita in legenda sul comando doppio-click (scelta tra Apri proprietà del layer e Apri tabella degli attributi).

\item {} 
\includegraphics{checkbox.png} \emph{Rendi maiuscoli i nomi dei layer nella legenda}

\item {} 
\includegraphics{checkbox.png} \emph{Visualizza i nomi degli attributi della classificazione nella legenda}

\item {} 
\includegraphics{checkbox.png} \emph{Crea le icone raster nella legenda}

\item {} 
\includegraphics{checkbox.png} \emph{Nascondi lo splash screen all’avvio}

\item {} 
\includegraphics{checkbox.png} \emph{Mostra suggerimenti all’avvio}

\item {} 
\includegraphics{checkbox.png} \emph{Apri i risultati di un’interrogazione in una finestra agganciata (richiede il riavvio di QGIS)}

\item {} 
\includegraphics{checkbox.png} \emph{Apri le opzioni di snap in una finestra agganciata (richiede il riavvio di QGIS)}

\item {} 
\includegraphics{checkbox.png} \emph{Apri la tabella degli attributi in una finestra agganciata (richiede il riavvio di QGIS)}

\item {} 
\includegraphics{checkbox.png} \emph{Aggiungi un layer PostGIS con un doppio click e seleziona la modalità estesa}

\item {} 
\includegraphics{checkbox.png} \emph{Aggiungi nuovi layer al gruppo selezionato}

\item {} 
\includegraphics{checkbox.png} \emph{Copia la geometria in formato WKT dalla tabella degli attributi}

\item {} 
Comportamento della tabella attributi (scelta tra Mostra tutti gli elementi, Mostra gli elementi selezionati, Mostra gli elementi sulla mappa corrente)

\item {} 
Cache riga attributi tabella

\item {} 
Mostra i valori NULL come

\item {} 
\emph{Richiedi i sublayer raster} \includegraphics{selectstring.png}. Alcuni sublayers raster di supporto - vengono chiamati subdatasets in GDAL. Un esempio sono i file netcdf - se ci sono diverse variabili netcdf, GDAL riconosce ogni variabile come un subdataset. L'opzione permette di controllare la gestione dei sublayers quando uno di questi viene aperto. Vengono proposte diverse scelte:
\begin{itemize}
\item {} 
`Sempre': chiede sempre (se sono presenti sublayers)

\item {} 
`Se necessario' chiede se il layer non ha contorni, ma ha sublayers

\item {} 
`Mai' non chiede mai, non verrà caricato niente

\item {} 
`Carica tutto' non chiede niente, ma carica tutti i sublayers

\end{itemize}

\item {} 
\emph{Ricerca elementi validi nella finestra del browser}  \includegraphics{selectstring.png}. L'opzione `Controlla l'esensione' è stata pensata per velocizzare il caricamento di una cartella, l'operazione potrebbe richiedere diverso tempo se l'opzione `Controlla il contenuto del file' è attivata e vi sono molti file (decine o centinaia).

\item {} 
\emph{Ricerca contenuto dei file compressi (.zip) nella finestra del browser} \includegraphics{selectstring.png}. Anche questa opzione è stata pensata per velocizzare il caricamento di una cartella. E' possibile scegliere fra:
\begin{itemize}
\item {} 
`Scansione base': controlla che l'estensione sia supportata da uno dei driver

\item {} 
`Scansione completa': apre ogni file per verificare che ogni file sia valido

\item {} 
`Passthru' non usare questa opzione, sarà rimossa nella prossima versione di QGIS

\end{itemize}

\end{itemize}


\subsection{GDAL}
\label{docs/user_manual/introduction/qgis_configuration:gdal-tab}
GDAL è una libreria di scambio dati per file raster. In questa scheda potete scegliere quali driver di GDAL usare per un caricare un file raster poiché a volte sono disponibili più driver GDAL.


\subsection{Plugins}
\label{docs/user_manual/introduction/qgis_configuration:plugins-tab}\begin{itemize}
\item {} 
Percorsi da aggiungere per cercare ulteriori librerie plugin C++.

\end{itemize}


\subsection{Visualizzazione in corso}
\label{docs/user_manual/introduction/qgis_configuration:rendering-tab}\begin{itemize}
\item {} 
\includegraphics{checkbox.png} \emph{Per impostazione i nuovi layer aggiunti alla mappa vengono visualizzati subito}

\item {} 
Numero di geometrie da disegnare prima di aggiornare lo schermo.

\item {} 
\includegraphics{checkbox.png} \emph{Usa il caching di disegno quando possibile per velocizzare la visualizzazione}

\item {} 
\includegraphics{checkbox.png} \emph{Rendi le linee meno irregolari a spese delle prestazioni}

\item {} 
\includegraphics{checkbox.png} \emph{Risolvi problemi con i poligoni riempiti non correttamente}

\item {} 
\includegraphics{checkbox.png} \emph{Utilizza la nuova generazione di simboli per la visualizzazione}

\item {} 
Definisci le impostazioni per la visualizzazione raster: `selezione banda RGB', \includegraphics{checkbox.png} \emph{Usa deviazione standard} e `migliora contrasto'

\item {} 
Percorso(i) dove cercare i simboli SVG (Scalable Vector Symbols)

\end{itemize}

È possibile definire se salvare i percorsi alle texture svg in modalità assoluta o relativa nella scheda \emph{Generale} del menu \emph{Impostazioni \(\rightarrow\) Proprietà progetto}.


\subsection{Strumenti mappa}
\label{docs/user_manual/introduction/qgis_configuration:map-tools-tab}\begin{itemize}
\item {} 
L’impostazione Modalità determina quali layer saranno mostrati attraverso lo strumento ’Informazioni elementi’. Passando a ``Top down'' o ``Il primo attivo'' invece di ``Layer in uso'' gli attributi di tutti i layer selezionabili (Si veda la Sezione Proprietà progetto in: {\hyperref[docs/user_manual/introduction/getting_started:sec-projects]{\emph{Progetti}}} sulle modalità di impostazione dei layer selezionabili) saranno visibili tramite lo strumento Informazioni elementi.

\item {} 
\includegraphics{checkbox.png} \emph{Apri il modulo degli elementi se viene identificato un un singolo elemento}

\item {} 
Specificare il raggio di ricerca come percentuale della larghezze della mappa

\item {} 
Ellissoide per calcoli di distanza

\item {} 
Colore elastico

\item {} 
Posizioni decimali

\item {} 
\includegraphics{checkbox.png} \emph{Mantieni le unità di base}

\item {} 
\includegraphics{radiobuttonon.png} \emph{Unità di misura preferita (Metri o Piedi)}

\item {} 
\includegraphics{radiobuttonon.png} \emph{Unità preferita per gli angoli (Gradi, Radianti o Gradi Decimali)}

\item {} 
Define \emph{Mouse wheel action} \includegraphics{selectstring.png} (`Zoom', `Zoom and recenter',
`Zoom to mouse cursor', `Nothing')

\item {} 
Fattore di zoom

\end{itemize}


\subsection{Sovrapposizioni}
\label{docs/user_manual/introduction/qgis_configuration:overlays-tab}\begin{itemize}
\item {} 
\emph{Definizione dell’algoritmo di posizionamento} \includegraphics{selectstring.png} delle etichette, dei simobli e dei diagrammi (scelta tra `Punto centrale', `Catena', `Catena tabu', `Popmusic', `Tabu popmusic', `Catena popmusic')

\end{itemize}


\subsection{Digitalizzazione}
\label{docs/user_manual/introduction/qgis_configuration:digitizing-tab}\begin{itemize}
\item {} 
Colore e spessore della linea

\item {} 
\emph{Modalità di snap predefinita} \includegraphics{selectstring.png} (`al vertice', `al segmento' o `entrambe')

\item {} 
Tolleranza di snapping predefinita in unità di mappa o in pixel

\item {} 
Raggio di ricerca per le modifiche dei vertici in unità di mappa o in pixel

\item {} 
\includegraphics{checkbox.png} \emph{Utilizza indicatori solo per le geometrie selezionate}

\item {} 
\emph{Stile indicatore} \includegraphics{selectstring.png} (`croce' (predefinita), `cerchio semitrasparente' o `nessuno') e della \emph{dimensione per gli indicatori} dei vertici.

\item {} 
\includegraphics{checkbox.png} \emph{Non aprire la finestra degli attributi dopo la creazione di ogni geometria}

\item {} 
\includegraphics{checkbox.png} \emph{Ripeti i valori degli attributi usati per ultimi}

\item {} 
\emph{Verifica le geometrie} La digitalizzazione di linee o poligoni complessi con molti nodi può determinare una visualizzazione molto lenta. Questo accade perché la procedura di verifica di default in QGIS impiega molto tempo. Per velocizzare questo processo è possibile selezionare la validazione delle geometrie GEOS (partendo da GEOS 3.3) oppure è possibile disattivarla del tutto. La validazione delle geometrie effettuata da GEOS è molto veloce, lo svantaggio è che verrà riportato solamente il primo problema geometrico rilevato.

\end{itemize}

Le 3 opzioni successive si riferiscono allo strumento \includegraphics[width=1.5em]{mActionOffsetCurve.png} $^{\text{Curva di offset}}$ in {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Digitalizzazione avanzata}}}. Attraverso i vari settaggi è possibile influenzare la forma della linea di offset. Queste opzioni sono possibili da GEOS 3.3.
\begin{itemize}
\item {} 
Stile di unione per l'offset

\item {} 
Segmenti di quadrante per l'offset

\item {} 
Limite di smussatura per l'offset

\end{itemize}


\subsection{SR}
\label{docs/user_manual/introduction/qgis_configuration:crs-tab}
La scheda SR è divisa in due aree. La prima permette di impostare il SR predefinito per i nuovi progetti.
\begin{itemize}
\item {} 
Inizia un nuovo progetto sempre con questo SR.

\item {} 
\includegraphics{checkbox.png} \emph{Effettua sempre la riproiezione al volo}

\end{itemize}

La seconda area permette di definire cosa accade quando un nuovo layer viene creato o quando viene caricato un layer senza SR.
\begin{itemize}
\item {} 
\includegraphics{radiobuttonoff.png} \emph{Richiedi SR}

\item {} 
\includegraphics{radiobuttonoff.png} \emph{Usa il SR del progetto}

\item {} 
\includegraphics{radiobuttonon.png} \emph{Utilizza come predefinito il SR visualizzato sotto}

\end{itemize}


\subsection{Lingua}
\label{docs/user_manual/introduction/qgis_configuration:locale-tab}\begin{itemize}
\item {} 
\includegraphics{checkbox.png} \emph{Sovrascrivi lingua in uso}

\item {} 
Informazioni sulla lingua correntemente impostata nel sistema

\end{itemize}


\subsection{Rete}
\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{Utilizza un proxy per l’accesso web}, definizione di host, porta, utente e password.

\item {} 
Definizione del \emph{Tipo proxy} \includegraphics{selectstring.png}.
\begin{itemize}
\item {} 
\emph{Default Proxy}:Il proxy è determinato sulla base delle impostazioni in uso del proxy dell’applicazione

\item {} 
\emph{Socks5Proxy}: Proxy generico per ogni tipo di connessione. Supporta TCP, UDP, associazione a una porta (connessione in entrata) e autenticazione.

\item {} 
\emph{HttpProxy}: Realizzato usando il comando ``CONNECT'', supporta solamente connessioni TCP in uscita; supporta l’autenticatione.

\item {} 
\emph{HttpCachingProxy}: Realizzato usando normali comandi HTTP, è utile solamente nel contesto di richieste HTTP

\item {} 
\emph{FtpCachingProxy}: Realizzato usando un proxy FTP, è utile solamente nel contesto di richieste FTP

\end{itemize}

\item {} 
Impostazioni della cache (cartella e dimensione)

\item {} 
Indirizzo di ricerca WMS (Quello predefinito è ``\href{http://geopole.org/wms/search?search=\%1\&type=rss}{http://geopole.org/wms/search?search=\%1\&type=rss}'')

\item {} 
Timeout per le richieste di rete in ms - predefinito 60000

\end{itemize}

Si possono escludere alcuni URL aggiungendole nella casella di testo al di sotto delle impostazioni del proxy (see {\hyperref[docs/user_manual/introduction/qgis_configuration:figure-network-tab]{Figure\_Network\_Tab}}) premendo il pulsante \textbf{{[}Aggiungi{]}} . In seguito fare doppio click nel campo URL appena creato e inserire l’URL che si desidera escludere dall’utilizzo del proxy. Ovviamente il pulsante \textbf{{[}Rimuovi{]}} elimina l’elemento selezionato.

Per informazioni più dettagliate sulle diverse impostazioni del proxy, si prega di fare riferimento al manuale della documentazione delle librerie QT suhttp://doc.trolltech.com/4.5/qnetworkproxy.html\#ProxyType-enum.

\begin{notice}{tip}{Suggerimento:}
\textbf{UTILIZZO DEI PROXY}

L’utilizzo dei proxy può a volte essere complicato. E’ utile testare i tipi di proxy succitati e controllare il loro funzionamento nel vostro caso specifico.
\end{notice}

Queste opzioni possono essere modificate in funzione delle proprie esigenze. Alcuni cambiamenti potrebbero richiedere il riavvio di QGIS prima di essere attivi.
\begin{itemize}
\item {} 
\includegraphics[width=1em]{nix.png} Le impostazioni sono salvate in un file di testo: \$HOME/.config/QuantumGIS/qgis.conf

\item {} 
\includegraphics[width=1em]{osx.png} Le impostazioni vengono collocate in: \$HOME/Library/Preferences/org.qgis.qgis.plist

\item {} 
\includegraphics[width=1em]{win.png} Le impostazioni vengono inserite nel registro di sistema alla voce:

\end{itemize}

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


\section{Personalizzazione}
\label{docs/user_manual/introduction/qgis_configuration:sec-customization}\label{docs/user_manual/introduction/qgis_configuration:customization}
Lo strumento di personalizzazione è una nuova implementazione di QGIS 1.8. Permette di attivare/disattivare praticamente qualunque elemento dell'interfaccia di QGIS. Questa possibilità è molto utile se sono stati installati molti plugins che vengono usati raramente e che riempiono lo schermo.
\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}

Il menu Personalizzazione di QGIS è diviso in cinque gruppi. In \includegraphics{checkbox.png} \emph{Docks} si trovano le finestre dock. Queste sono applicazioni che possono essare avviate e usate come finestre mobili, fisse oppure possono essere incorporate nella finestra principale di QGIS come se fossero dei widget (see also {\hyperref[docs/user_manual/introduction/qgis_configuration:sec-panels-and-toolbars]{\emph{Pannelli e Barre degli strumenti}}}). In \includegraphics{checkbox.png} \emph{Menu} è possibile nascondere funzioni all'interno della Barra dei Menu. In \includegraphics{checkbox.png} \emph{Barra di stato} è possibile disattivare caratteristiche come le informazioni sulle coordinate. In \includegraphics{checkbox.png} \emph{Barra degli strumenti} è possibile attivare/disattivare le icone della barra degli strumenti di QGIS e in \includegraphics{checkbox.png} \emph{Widgets} si possono attivare/disattivare i diversi pannelli presenti in QGIS.

Con \includegraphics[width=1.5em]{mActionSelect.png} \emph{Passa ai widget per la cattura nell'applicazione principale} è possibile cliccare sugli elementi di QGIS che si intendono  nascondere dall'interfaccia e trovarli nel menu Personalizzazione (see {\hyperref[docs/user_manual/introduction/qgis_configuration:figure-customization]{figure\_customization}}). E' possibile anche salvare i diversi setaggi a seconda dei diversi utilizzi. Prima che i cambiamenti diventino effettivi è necessario riavviare QGIS.


\chapter{Lavorare con le proiezioni}
\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 consente all’utente di definire un sistema di riferimento - SR - (Coordinate Reference System, ovvero Sistema di Riferimento delle Coordinate) globale o a livello di singolo progetto per i layer privi di un SR predefinito. Consente inoltre di definire sistemi di coordinate personalizzati e supporta la riproiezione al volo (on-the-fly, OTF) dei layer vettoriali. Tutte queste caratteristiche permettono all’utente di visualizzare contemporaneamente e correttamente sovrapposti i layer aventi SR differenti.


\section{Panoramica sul supporto alle proiezioni}
\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 supporta all’incirca 2.700 SR. Le definizioni di ognuno di questi SR sono memorizzate in un database SQLite che viene installato con QGIS. Normalmente non è necessario manipolare il database direttamente, infatti questa operazione può causare il malfunzionamento del supporto alla proiezione. I SR personalizzati sono salvati in un database utente. Si veda la Sezione {\hyperref[docs/user_manual/working_with_projections/working_with_projections:sec-custom-projections]{\emph{Sistemi di riferimento personalizzati}}} per informazioni sulla gestione dei SR personalizzati.

\index{EPSG}\index{IGNF}\index{European\_Petroleom\_Search\_Group}
\index{Institut\_Geographique\_National\_de\_France}
I SR disponibili in QGIS sono basati su quelli definiti dall’European Petroleum Survey Group - EPSG - e dall’Institut Geographique National francese (IGN) e sono per lo più tratti dalle tabelle di riferimento spaziale di GDAL. Gli identificatori EPSG sono presenti nel database e possono essere usati per richiamare e definire i SR in QGIS.

Per usare la riproiezione al volo (OTF), i dati devono contenere informazioni sul proprio sistema di riferimento oppure bisogna definire un SR a livello layer o a livello di progetto o globale. Per i layer PostGIS, QGIS usa l’identificatore del riferimento spaziale specificato al momento della creazione del layer. Per i dati supportati da OGR, QGIS fa affidamento sulla presenza di un mezzo, specifico per ciascun formato, che definisce il SR. Nel caso degli shapefile, ad esempio, si stratta di un file contenente l’indicazione del SR in formato Well Known Text (WKT). Il file della proiezione ha lo stesso nome dello shapefile, ma ha estensione prj. Per esempio uno shapefile chiamato \code{alaska.shp}. avrà un corrispondente file di proiezione chiamato \code{alaska.prj}.

Ogni volta che si seleziona un nuovo SR, le unità utilizzate per il layer verranno automaticamente aggiornate nella scheda \emph{Generale} della finestra di dialogo \includegraphics[width=1em]{mActionOptions.png} \emph{Proprietà progetto} sotto il menu \emph{Modifica} (Gnome, OSX) o \emph{Impostazioni} (KDE, Windows).

\index{default\_CRS}

\section{Specificare una proiezione}
\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 imposta il SR di ogni nuovo progetto su quello definito a livello globale: il SR globale predefinito è EPSG:4326 - WGS 84 (proj=longlat +ellps=WGS84 +datum=WGS84 +no\_defs). Il SR predefinito può essere modificato tramite il pulsante \textbf{{[}Scegli...{]}} mostrato in figura {\hyperref[docs/user_manual/working_with_projections/working_with_projections:figure-projection-1]{figure\_projection\_1}}: tale impostazione varrà per tutte le sessioni successive di QGIS.
\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}

When you use layers that do not have a CRS, you need to define how
QGIS responds to these layers. This can be done globally or
project-wide in the \emph{CRS} tab under \emph{Edit \(\rightarrow\)} \includegraphics[width=1em]{mActionOptions.png}
\emph{Options} (Gnome, OSX) or \emph{Settings \(\rightarrow\)} \includegraphics[width=1em]{mActionOptions.png}
\emph{Options} (KDE, Windows).

Le opzioni mostrate in figura {\hyperref[docs/user_manual/working_with_projections/working_with_projections:figure-projection-1]{figure\_projection\_1}} sono:
\begin{itemize}
\item {} 
\includegraphics{radiobuttonoff.png} \emph{Richiedi SR}

\item {} 
\includegraphics{radiobuttonoff.png} \emph{Usa il SR del progetto}

\item {} 
\includegraphics{radiobuttonon.png} \emph{Utilizza come predefinito SR visualizzato sotto}

\end{itemize}

Per definire il SR di un layer privo di tale informazione, si può anche agire nella scheda \emph{Generale} della finestra di dialogo delle proprietà dei raster (Sezione {\hyperref[docs/user_manual/working_with_raster/raster_properties:label-generaltab]{\emph{Scheda generale}}}) e dei vettori (Sezione {\hyperref[docs/user_manual/working_with_vector/vector_properties:vectorgeneraltab]{\emph{Scheda Generale}}}). Se il SR è già stato definito, lo stesso verrà mostrato come nella Figura {\hyperref[docs/user_manual/working_with_vector/vector_properties:figure-vector-properties-1]{\emph{Vector Layer Properties Dialog }}} .

\begin{notice}{tip}{Suggerimento:}
\textbf{SR NELLA LEGENDA}

Il menu contestuale dei layer in legenda (tasto destro sul nome del layer) (Sezione {\hyperref[docs/user_manual/introduction/qgis_gui:label-legend]{\emph{Legenda}}}) fornisce due scorciatoie per l’impostazione del SR: \emph{Imposta il SR del layer} apre direttamente la finestra per la scelta del sistema di riferimento (figura {\hyperref[docs/user_manual/working_with_projections/working_with_projections:figure-projection-2]{figure\_projection\_2}}), mentre \emph{Imposta il SR del progetto dal layer} imposta il SR del progetto sulla base di quello del layer
\end{notice}


\section{Definire la riproiezione al volo (OTF)}
\label{docs/user_manual/working_with_projections/working_with_projections:define-on-the-fly-otf-reprojection}
QGIS supporta la riproiezione al volo (OTF) sia per i raster che per i vettori, ma l’opzione non è abilitata di default. Per usare la riproiezione OTF, bisogna attivare  la casella di controllo \includegraphics{checkbox.png} \emph{Abilita la riproiezione al volo} nella scheda \emph{SR} della finestra di dialogo \includegraphics[width=1.5em]{mActionProjectProperties.png} \emph{Proprietà  progetto}.

Ci sono tre modi per aprire questa finestra:
\begin{enumerate}
\item {} 
Selezionare \includegraphics[width=1em]{mActionOptions.png} \emph{Proprietà progetto} dal menu \emph{Modifica} (Gnome, OSX) o \emph{Impostazioni} (KDE, Windows) menu.

\item {} 
Fare click sull'icona \includegraphics{geographic.png} $^{\text{Stato SR}}$ nell’angolo in basso a destra della barra di stato.

\item {} 
Turn OTF on by default, by selecting the \emph{CRS} tab of the
\emph{Options} dialog and selecting \includegraphics{checkbox.png}
\emph{Enable `on the fly' reprojection by default}.

\end{enumerate}

Se è già stato caricato un layer e si vuole abilitare la riproiezione, è buona norma aprire la scheda \emph{Sistema di riferimento (SR)} della finestra di dialogo \emph{Proprietà progetto} selezionare nell’elenco il SR attualmente impostato, quindi attivare la casella di controllo \includegraphics{checkbox.png} \emph{Abilita la riproiezione al volo}. Ogni layer caricato successivamente sarà riproiettato al volo nel SR mostrato affianco al pulsante \includegraphics{geographic.png} $^{\text{Stato SR}}$.

\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}

La scheda \emph{Sistema di riferimento (SR)} della finestra di dialogo \emph{Proprietà progetto} contiene cinque importanti componenti, illustrati in figura {\hyperref[docs/user_manual/working_with_projections/working_with_projections:figure-projection-2]{Figure\_projection\_2}} e di seguito descritti.
\begin{enumerate}
\item {} 
\textbf{Enable on the fly CRS transformation} -
this checkbox is used to enable or disable OTF projection. When off, each
layer is drawn using the coordinates as read from the data source and the
components described below are inactive.When on, the coordinates in each
layer are projected to the coordinate reference system defined for the map canvas.

\item {} 
\textbf{Sistema di Riferimento} - è la lista di tutti i SR supportati da QGIS, inclusi i sistemi di coordinate geografiche, piane e quelli personalizzati. Per usare un SR, selezionarlo dalla lista espandendo il gruppo appropriato. Il SR attivo è quello preselezionato.

\item {} 
\textbf{Stringa Proj4} - è la stringa SR usata dal motore di proiezione Proj4. È un testo di sola lettura, a solo scopo informativo.

\item {} 
\textbf{Filter} - if you know the EPSG code, the identifier or the name
for a Coordinate Reference System, you can use the search feature to find it.
Enter the EPSG code, the identifier or the name.

\item {} 
\textbf{Sistemi di riferimento usati di recente} - se ci sono dei SR che vengono usati frequentemente, essi verranno visualizzati in questa sezione della finestra di dialogo.  Basta fare click su una voce per impostare il SR associato.

\end{enumerate}

\begin{notice}{tip}{Suggerimento:}
\textbf{Finestra di dialogo Proprietà del progetto}

Se si apre la finestra di dialogo \emph{Proprietà progetto} dal menu \emph{Modifica} (Gnome, OSX) o \emph{impostazioni} (KDE, Windows), bisogna fare click sulla scheda \emph{Sistema di riferimento (SR)} per visualizzare le impostazioni del SR.

La stessa finestra può essere aperta con l'icona \includegraphics{geographic.png} \emph{Stato SR}.
\end{notice}


\section{Sistemi di riferimento personalizzati}
\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}
Se in QGIS non si trova il sistema di riferimento di cui si necessita, è possibile definirne uno personalizzato: selezionare \includegraphics[width=1.5em]{mIconNew.png}\emph{SR personalizzato} dal menu \emph{Modifica} (Gnome, OSX) o \emph{Impostazioni} (KDE, Windows).I SR  personalizzati sono salvati nel database utente di QGIS. Oltre ai SR personalizzati, questo database contiene anche i segnalibri geospaziali e altri dati personalizzati dall’utente.
\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}
La definizione di un SR personalizzato in QGIS richiede una buona comprensione delle librerie Proj.4. Per iniziare, fare riferimento al documento Cartographic Projection Procedures for the UNIX Environment -  A User’s Manual di Gerald I. Evenden, U.S. Geological Survey Open-File Report 90-284, 1990 (disponibile
all’indirizzo \href{ftp://ftp.remotesensing.org/proj/OF90-284.pdf}{ftp://ftp.remotesensing.org/proj/OF90-284.pdf} ).

Questo manuale descrive l’uso di \code{proj.4} e delle relative utilità da riga di comando. I parametri cartografici usati da \code{proj.4} sono descritti nel manuale e sono identici a quelli usati da QGIS.

La finestra di dialogo \emph{Definizione Sistema Riferimento Spaziale Personalizzato} richiede solo due parametri per definire un SR personalizzato:
\begin{enumerate}
\item {} 
un nome descrittivo e

\item {} 
i parametri cartografici in formato PROJ.4.

\end{enumerate}

Per creare un nuovo SR, fare click sul pulsante \includegraphics[width=1.5em]{mIconNew.png} $^{\text{nuovo}}$ e inserire il nome descrittivo e i parametri. Successivamente salvare il SR facendo click sul pulsante \includegraphics[width=1.5em]{mActionFileSave.png} $^{\text{Salva}}$.

Si noti che la voce \emph{Parametri} deve iniziare con un blocco \code{+proj=}, per rappresentare il nuovo SR.

È possibile testare i parametri SR per vedere se danno risultati validi facendo click sul pulsante \textbf{{[}Calcola{]}} nella sezione Prova, dopo aver incollato i parametri SR personalizzati nel campo Parametri. Quindi, inserire dei valori noti di latitudine e longitudine nel sistema WGS 84 rispettivamente nei campi Nord e Est. Fare click su \textbf{{[}Calcola{]}} e confrontare i risultati con i valori noti nel SR personalizzato.

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

\chapter{QGIS Browser}
\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}
QGIS Browser è un nuovo pannello che permette di navigare facilmente nel database. E' possibile accedere ai file vettoriali comuni (ESRI shapefile o MapInfo file), ai database (come PostGIS o MMSQL Spatial) e alle connessioni WMS/WFS. Si possono anche vedere i dati di GRASS (per caricare i dati di GRASS in QGIS vedi see {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-grass]{\emph{Integrazione con GRASS GIS}}}).
\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}

Si può usare QGIS Browser per vedere un'anteprima dei dati. La funzione di trascinamento rende molto facile la visualizzazione dei dati nella Legenda e nella Vista mappa.
\begin{enumerate}
\item {} 
Per attivare QGIS Browser: cliccare con il tasto destro sulla barra degli strumenti e scegliere \includegraphics{checkbox.png}\emph{Browser}.

\item {} 
Trascinare il pannello nella finestra della Legenda.

\item {} 
Cliccare sulla scheda \emph{Browser}.

\item {} 
Navigare nel database e scegliere la cartella contenente i file vettoriali qgis\_sample\_data.

\item {} 
Tenendo premuto il tasto \code{Shift} cliccare su airports.shp e alaska.shp .

\item {} 
Tenendo premuto il tasto sinistro del mouse, trascinare i file nella mappa.

\item {} 
Cliccare con il tasto destro su un layer e scegleire \emph{Imposta il SR del progetto dal layer}. Per ulteriori informazione vedi {\hyperref[docs/user_manual/working_with_projections/working_with_projections:label-projections]{\emph{Lavorare con le proiezioni}}}.

\item {} 
Cliccare su \includegraphics[width=1.5em]{mActionZoomFullExtent.png} \emph{Zoom completo} per rendere visibili tutti i layer.

\end{enumerate}

E' possibile avviare QGIS Browser anche come applicazione standalone.

\textbf{Avviare qgis browser}
\begin{itemize}
\item {} 
\includegraphics[width=1em]{nix.png} Digitare ``qbrowser'' nella finestra del terminale.

\item {} 
\includegraphics[width=1em]{win.png} Avviare QGIS Browser usando il menu Start oppure il collegamento sul desktop oppure facendo doppio click su un file di progetto di QGIS.

\item {} 
\includegraphics[width=1em]{osx.png} QGIS browser non è disponibile nella cartella Applicazioni, ma è molto facile renderlo tale. In Finder usare \emph{Vai \(\rightarrow\) Vai alla mappa...} e cercare la cartella  \code{/Applications/QGIS.app/Contents/MacOS/bin}. Usare la combinazione di tasti \code{option - command} e tenendo premuto il tasto sinistro del mouse, trascinare \textbf{qbrowser.app} nella cartella Applicazioni. Questo procedimento creerà un collegamento che potrà essere usato per avviare QGIS Browser.

\end{itemize}

In {\hyperref[docs/user_manual/qgis_browser/qgis_browser:figure-browser-standalone-metadata]{figure\_browser\_standalone\_metadata}} si possono vedere le potenti funzionalità di QGIS Browser. La scheda \emph{Param} fornisce i dettagli del percorso dei set di dati come li fornirebbero PostGIS o MSSQL Spatial. La scheda \emph{Metadata} contiene le informazioni generali sui file (vedi {\hyperref[docs/user_manual/working_with_vector/vector_properties:vectormetadatatab]{\emph{Scheda Metadati}}}). Con la scheda \emph{Preview} è possibile vedere un'anteprima del file prima di importarlo nel progetto di QGIS. E' infine possibile vedere un'anteprima degli attributi dei file grazie alla scheda \emph{Attributes}.


\chapter{Lavorare con i dati vettoriali}
\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{Formati supportati}
\label{docs/user_manual/working_with_vector/supported_data:supported-data-formats}\label{docs/user_manual/working_with_vector/supported_data::doc}
QGIS usa la libreria OGR per l’accesso in lettura e scrittura a diversi formati di dati vettoriali (il supporto per i file vettoriali di GRASS e PostgreSQL è fornito da plugin nativi di QGIS), come shapefile ESRI, formati file MapInfo e Microstation, Postgis, Spatialite, database spaziali Oracle e molti altri. I file vettoriali possono essere caricati in modalità lettura anche in formato zip e gzip. Alla data di questa guida la libreria OGR supporta 69 formati vettoriali (vedi OGR-SOFTWARE-SUITE {\hyperref[docs/user_manual/literature_web/literature_and_web_references:literature-and-web]{\emph{Literature and Web References}}}). La lista completa è disponibile all’indirizzo \href{http://www.gdal.org/ogr/ogr\_formats.html}{http://www.gdal.org/ogr/ogr\_formats.html}.

\begin{notice}{note}{Nota:}
Alcuni dei formati elencati all’indirizzo citato potrebbero non essere supportati da QGIS per diverse ragioni: ad esempio, alcuni richiedono librerie esterne commerciali o l’installazione di GDAL/OGR nel proprio sistema è avvenuta senza scegliere il supporto per uno specifico formato. Solo i formati adeguatamente testati appariranno nella lista di tipi di file al momento del caricamento di un vettore dentro QGIS. Altri formati, non testati, possono essere caricati selezionando \code{*.*}.
\end{notice}

La sezione Section {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-grass]{\emph{Integrazione con GRASS GIS}}} illustra come lavorare con i dati di GRASS.

Questa sezione descrive come lavorare con diversi formati comuni: Shapefile ESRI, layer PostGIS e layer SpatialLite. Molti degli strumenti disponibili in QGIS funzionano allo stesso modo con le differenti sorgenti di dati vettoriali (ad es. l’identificazione, la selezione, le funzioni per le etichette e gli attributi).

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

\subsection{Shapefile 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}
Il formato di file usato come predefinito in QGIS è lo shapefile ESRI. Il supporto al formato è fornito dalla libreria \index{OGR Simple Feature Library}OGR Simple Feature Library (\href{http://www.gdal.org/ogr/}{http://www.gdal.org/ogr/}).

Uno shapefile consiste di un minimo di tre file:
\begin{enumerate}
\item {} 
\code{.shp} file contente le geometrie.

\item {} 
\code{.dbf} file contenente gli attributi in formato dBase.

\item {} 
\code{.shx} file d'indice.

\end{enumerate}

Idealmente dovrebbe essere presente un altro file con estensione .prj, che contiene le informazioni sulla proiezione dello shapefile. Ci possono essere ulteriori file che compongono il dataset in formato shape. Peruno sguardo più ravvicinato al formato shapefile si raccomanda di prendere visione delle specifiche tecniche del formato disponibili sul sito \href{http://www.esri.com/library/whitepapers/pdfs/shapefile.pdf}{http://www.esri.com/library/whitepapers/pdfs/shapefile.pdf}.


\subsubsection{Caricare uno 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} Per caricare uno shapefile, avviare QGIS e cliccare sul pulsante \includegraphics[width=1.5em]{mActionAddNonDbLayer.png} $^{\text{Aggiungi vettore}}$ o semplicemente digitare \code{Ctrl+Shift+V}. Si aprirà una nuova finestra (vedi {\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}

Nella finestra di dialogo successiva selezionare \includegraphics{radiobuttonon.png} \emph{File} e cliccare sul pulsante \textbf{{[}Sfoglia{]}}. Si aprirà una finestra di dialogo standard (vedi {\hyperref[docs/user_manual/working_with_vector/supported_data:figure-vector-2]{figure\_vector\_2}}) che consente di cercare nel filesystem lo shapefile o qualunque altro dato vettoriale si intenda caricare. La casella di selezione \emph{Tipo file} \includegraphics{selectstring.png} consente di preselezionare alcuni formati supportati da OGR.

Se lo si desidera, può essere inoltre selezionata la codifica (encoding) da utilizzare per lo 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}

Selezionando uno shapefile dalla lista e cliccando su \textbf{{[}Open{]}} esse viene caricato in QGIS. La figura  {\hyperref[docs/user_manual/working_with_vector/supported_data:figure-vector-3]{Figure\_vector\_3}} mostra come appare l’interfaccia di QGIS dopo aver caricato il file \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}{Suggerimento:}
\textbf{Colori dei layer}

Quando un layer viene aggiunto alla mappa, gli viene assegnato un colore a caso. Aggiungendo più layer in
una sola volta, ad ognuno di essi viene assegnato un colore differente.
\end{notice}

Una volta caricato lo shapefile, si può interagire con la mappa usando gli strumenti di navigazione. Per
cambiare la rappresentazione di un layer, aprire la finestra di dialogo \emph{Proprietà layer} facendo doppio click sul nome del layer e quindi sulla scheda Stile o cliccando con il tasto destro sul nome del layer nella legenda e scegliendo \emph{Proprietà} dal menu contestuale. Si veda la Sezione {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-style-tab]{\emph{Scheda Stile}}} per ulteriori informazioni su come settare la simbologia dei layer vettoriali.
\phantomsection\label{docs/user_manual/working_with_vector/supported_data:tip-load-from-external-drive-osx}
\begin{notice}{tip}{Suggerimento:}
\textbf{Caricare layer e progetti da drive esterni in OS X}

In OS X i drive esterni non vengono elencati come atteso selezionando \emph{File \(\rightarrow\) Apri progetto}. Stiamo lavorando alla creazione di un dialogo apri/salva nativo OSX; come soluzione  temporanea è possibile digitare ’/Volume’ nella casella Nome file e cliccare \code{invio}. Sarà così possibile utilizzare i drive esterni.
\end{notice}


\subsubsection{Ottimizzare le prestazioni}
\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}
Per migliorare le prestazioni di disegno di uno shapefile, può essere creato un indice spaziale. Un indice spaziale migliora la velocità di disegno quando si usano le funzioni di zoom e di spostamento. Gli indici spaziali usati da QGIS hanno estensione \code{.qix}.

Per creare un indice, seguire queste indicazioni:
\begin{itemize}
\item {} 
Caricare uno shapefile.

\item {} 
Aprire la finestra di dialogo \emph{proprietà layer} facendo doppio click sul nome dello shapefile nella legenda o cliccando su di esso con il tasto destro e scegliendo la voce \emph{Proprietà} dal menu contestuale.

\item {} 
Nella scheda \emph{Generale} cliccare sul pulsante \textbf{{[}Crea indice spaziale{]}}.

\end{itemize}


\subsubsection{Problemi nel caricare un file .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}
Se si carica uno shapefile con associato un file .prj e QGIS non riesce a leggere le informazioni di proiezione, è necessario inserire manualmente queste informazioni nella scheda \emph{Generale} della finestra di dialogo \emph{Proprietà layer}. Ciò è dovuto al fatto che spesso i file .prj non forniscono i parametri di proiezione completi, come richiesto da QGIS ed elencati nella finestra di dialogo \emph{SR}.

Per cui quando in QGIS si crea un nuovo shapefile, vengono creati due differenti file di proiezione. Un file \code{.prj} con un insieme limitato di parametri compatibile con il software della ESRI, e un file .qpj che memorizza l’insieme completo di parametri del SR utilizzato. Quando QGIS trova un file \code{.qpj} utilizza quest’ultimo invece del file \code{.prj}.

\index{MapInfo}

\subsection{Caricare un layer 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} Per caricare un file Mapinfo, cliccare nella barra strumenti sul pulsante \includegraphics[width=1.5em]{mActionAddNonDbLayer.png} $^{\text{Aggiungi vettore}}$ o digitare \code{Ctrl+Shift+V}, cambiare il filtro nel menu a tendina a \emph{Tipo file {[}OGR{]} MapInfo (*.mif *.tab *.MIF *.TAB)} \includegraphics{selectstring.png} e selezionare il layer che si intende caricare.

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

\subsection{Caricare una coverage binaria ArcInfo}
\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} Per caricare una coverage binaria ArcInfo cliccare nella barra strumenti sul pulsante \includegraphics[width=1.5em]{mActionAddNonDbLayer.png} $^{\text{Aggiungi vettore}}$ o digitare \code{Ctrl+Shift+V} per aprire la finestra di dialogo \emph{Add Vector Layer}. Selezionare \includegraphics{radiobuttonon.png} \emph{Cartella} e \emph{Tipo Coverage binaria Arc/info} \includegraphics{selectstring.png}, scorrere il filesystem per individuare la cartella contenente i file della coverage e selezionarla.

Allo stesso modo è possibile caricare file vettoriali strutturati in cartelle nel formato di trasferimento UK National Transfer Format o anche nel formato TIGER del US Census Bureau.

\index{PostGIS}\index{PostgreSQL}

\subsection{Layer 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}
I layer PostGIS sono memorizzati in database PostgreSQL. I vantaggi nell’uso di PostGIS stanno nelle capacità fornite di creazione dell’indice spaziale, di filtraggio e di interrogazione. Usando PostGIS, le fuzioni vettoriali come la selezione e l’identificazione in QGIS lavorano con maggiore precisione che con i layer OGR in QGIS.

\index{Connection\_Manager}

\subsubsection{Creare una connessione}
\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 prima volta in cui viene usata una fonte dati PostGIS, bisogna creare una connessione al database PostgreSQL che contiene i dati. Cliccare nella barra degli strumenti sul pulsante \includegraphics[width=1.5em]{mActionAddLayer.png} $^{\text{Aggiungi vettore PostGIS}}$ oppure selezionare l'opzione \includegraphics[width=1.5em]{mActionAddLayer.png} \emph{Aggiungi vettore PostGIS...} dal menu \emph{Layer} o digitare \code{Ctrl+Shift+D}. E' inoltre possibile utilizzare la finestra di dialogo \emph{Aggiungi vettore} e selezionare \includegraphics{radiobuttonon.png} \emph{Database}. Si aprirà la finestra di dialogo \emph{Aggiungi tabella(e) PostGIS}. Per accedere al gestore della connessione cliccare sul tasto \textbf{{[}Nuovo{]}} per far comparire la finestra di dialogo \emph{Crea una nuova connessione PostGIS}. I parametri richiesti per la connessione sono:
\begin{itemize}
\item {} 
\textbf{Nome}: Nome della connessione. Può essere uguale a quello del \emph{Database}

\item {} 
\textbf{Servizio}: Parametri del servizio da usare alternativamente a host/porta (e potenzialmente database). Ciò può essere definito in \code{pg\_service.conf}

\item {} 
\textbf{Host}: Nome del server che ospita il database. Deve essere un host con indirizzo raggiungibile, lo stesso che potrebbe essere usato per aprire una connessione telnet o per fare il ping all’host. Se il database è sullo stesso computer sul quale è installato QGIS, inserire semplicemente \emph{`localhost'}.

\item {} 
\textbf{Porta}: Numero della porta sulla quale il database PostgreSQL è in ascolto. La porta predefinita è 5432.

\item {} 
\textbf{Database}: Nome del database.

\item {} 
\textbf{Modalità SSL}: Si noti che è possibile ottenere una notevole velocità di visualizzazione dei layer PostGIS disabilitando la connessione SSL. Sono disponibili le seguenti opzioni:
\begin{itemize}
\item {} 
disabilitato: connessione SSL non criptata

\item {} 
permesso: tenta una connessione non SSL, se questa fallisce ne tenta una SSL

\item {} 
preferito (default): tenta una connessione SSL, se questa fallisce ne prova una non SSL;

\item {} 
richiesto: solo connessione SSL.

\end{itemize}

\item {} 
\textbf{Nome utente}: Nome dell'utente che accede al database.

\item {} 
\textbf{Password}: Password usata dallo \emph{Username} per collegarsi al database.

\end{itemize}

Come opzione, possono essere attivate le seguenti caselle di controllo:
\begin{itemize}
\item {} 
\includegraphics{checkbox.png} \emph{Salva nome utente}

\item {} 
\includegraphics{checkbox.png} \emph{Salva Password}

\item {} 
\includegraphics{checkbox.png} \emph{Cercare solamente nella tabella geometry\_columns}

\item {} 
\includegraphics{checkbox.png} \emph{Cerca solamente nello schema}

\item {} 
\includegraphics{checkbox.png} \emph{Mostra anche tabelle senza geometria}

\item {} 
\includegraphics{checkbox.png} \emph{Usa i metadati stimati della tabella}

\end{itemize}

Quando tutti i parametri sono impostati, la connessione può essere testata cliccando sul pulsante \textbf{{[}Test Connessione{]}}.
\phantomsection\label{docs/user_manual/working_with_vector/supported_data:tip-settings-security}
\begin{notice}{tip}{Suggerimento:}
\textbf{Impostazioni utente e sicurezza}

A seconda dell'ambiente informatico, la memorizzazione delle password nelle impostazioni di QGIS può essere un rischio per la sicurezza. Le impostazioni personalizzate di QGIS sono salvate in modo diverso in base al sistama operativo:
\begin{itemize}
\item {} 
\includegraphics[width=1em]{nix.png}, le impostazioni sono salvate nella cartella home dell'utente nel file \code{.qgis/}.

\item {} 
\includegraphics[width=1em]{win.png}, le impostazioni sono salvate nel registro di sistema.

\end{itemize}
\end{notice}


\subsubsection{Caricare un layer 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} Una volta definita una connessione, si possono caricare layer dal database PostgreSQL. Ovviamente questo richiede avere dati in PostgreSQL. Si veda la Sezione {\hyperref[docs/user_manual/working_with_vector/supported_data:vector-import-data-in-postgis]{\emph{Importare dati in PostgreSQL}}} per informazioni su come importare dati nel database.

Per caricare layer da PostGIS, seguire i seguenti passaggi:
\begin{itemize}
\item {} 
Se la finestra di dialogo \emph{Aggiungi tabella(e) PostGIS} non è già aperta, cliccare nella barra degli strumenti sul pulsante \includegraphics[width=1.5em]{mActionAddLayer.png} $^{\text{Aggiungi vettore PostGIS}}$.

\item {} 
Scegliere la connessione dal menu a tendina e cliccare su \textbf{{[}Connetti{]}}.

\item {} 
Selezionare/deselezionare \includegraphics{checkbox.png} \emph{Mostra tabelle senza geometria}

\item {} 
Opzionalmente usare \includegraphics{checkbox.png} \emph{Opzioni ricerca} per definire quali elementi caricare dal layer oppure utilizzare \textbf{{[}Crea query{]}} per avviare la finestra di dialogo \emph{Query builder}.

\item {} 
Individuare il layer che si vuole aggiungere nella lista di quelli disponibili.

\item {} 
Selezionare il layer cliccando sul nome. E' possibile selezionare più layer tenendo premuto il tasto \code{Shift} mentre si seleziona. Si veda la sezione {\hyperref[docs/user_manual/working_with_vector/query_builder:vector-query-builder]{\emph{Costruttore di interrogazioni}}} per informazioni su come usare il Query builder PostgreSQL per definire una selezione al momento del caricamento.

\item {} 
Cliccare sul tasto \textbf{{[}Aggiungi{]}} per aggiungere il layer alla mappa.

\end{itemize}
\phantomsection\label{docs/user_manual/working_with_vector/supported_data:tip-postgis-layers}
\begin{notice}{tip}{Suggerimento:}
\textbf{Layer PostGIS}

Di solito un layer PostGIS è definito da un record nella tabella geometry\_columns. Dalla versione 0.9.0 in
avanti, QGIS può caricare layer che non hanno tale record nella tabella geometry\_columns. Ciò vale sia per le tabelle che per le viste. La definizione di una vista spaziale fornisce un mezzo molto potente per visualizzare i dati. Fare riferimento al manuale PostgreSQL per informazioni su come creare le viste.
\end{notice}


\subsubsection{Alcuni dettagli sui layer 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}
Questa sezione contiene alcuni dettagli su come QGIS accede ai layer PostgreSQL. La maggior parte delle volte QGIS dovrebbe semplicemente fornire una lista di tabelle del database che possono essere caricate e caricarle su richiesta. Tuttavia, se avete difficoltà a caricare una tabella di PostgreSQL in QGIS, le informazioni seguenti possono aiutare a capire tutti i messaggi di QGIS e a dare un’indicazione su come cambiare la definizione di tabella o di vista di PostgreSQL per permettere a QGIS di caricarla.

QGIS richiede che i layer di PostgreSQL contengano una colonna che possa essere usata come chiave unica per il layer. Per le tabelle questo significa che esse devono contenere una chiave primaria o una colonna con un vincolo unico. QGIS richiede che questa colonna sia di tipo int4 (un numero intero di 4 byte). Le prestazioni saranno migliori se la colonna è indicizzata (notare che le chiavi primarie sono automaticamente indicizzate in PostgreSQL).

Se il layer di PostgreSQL è una vista, esistono gli stessi requisiti, ma le viste non hanno chiavi primarie o
colonne con i vincoli unici su di loro. In questo caso QGIS proverà a trovare una colonna nella vista che
provenga da una colonna appropriata della tabella. Ciò viene fatto analizzando la definizione SQL della vista; ci sono diversi aspetti di SQL che sono ignorati da QGIS (es. l’uso di alias di tabelle e colonne generate da funzioni SQL).

Se non viene trovata alcuna colonna adatta, QGIS non caricherà il layer. Se questo accade, la soluzione è di alterare la vista in modo che includa una colonna adatta (di tipo int4 e una chiave primaria o un vincolo unico, preferibilmente indicizzato).

\index{shp2pgsql}\phantomsection\label{docs/user_manual/working_with_vector/supported_data:loading-postgis-data}

\subsection{Importare dati in 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}
I dati possono essere importati in PostgeSQL/PostGIS utilizzando diversi strumenti, come ad esempio il plugin SPIT oppure attraverso linea di comando shp2pgsql o ogr2ogr.


\subsubsection{Plugin SPIT}
\label{docs/user_manual/working_with_vector/supported_data:spit-plugin}\label{docs/user_manual/working_with_vector/supported_data:id1}
QGIS include un plugin denominato \includegraphics{spiticon.png} $^{\text{SPIT}}$ (Shapefile to PostGIS Import Tool). SPIT può essere usato per caricare più shapefile contemporaneamente e include il supporto per gli schemi. La sezione {\hyperref[docs/user_manual/plugins/plugins_spit:label-spit]{\emph{Plugin SPIT}}} fornisce maggiori informazioni.


\subsubsection{shp2pgsql}
\label{docs/user_manual/working_with_vector/supported_data:shp2pgsql}
PostGIS include un programma di utilità chiamato \textbf{shp2pgsql} che può essere usato per importare shapefile in un database PostGIS. Per esempio, per importare lo shapefile chiamato \code{lakes.shp} nel database PostgreSQL chiamato \code{gis\_data}, usare il comando seguente:

\begin{Verbatim}[commandchars=\\\{\}]
shp2pgsql -s 2964 lakes.shp lakes\_new \textbar{} psql gis\_data
\end{Verbatim}

Questo comando crea un nuovo layer chiamato \code{lakes\_new} nel database \code{gis\_data}. Il nuovo layer avrà un identificatore di riferimento spaziale (Spatial Reference Identifier - SRID) di 2964. Si veda la sezione {\hyperref[docs/user_manual/working_with_projections/working_with_projections:label-projections]{\emph{Lavorare con le proiezioni}}} per ulteriori informazioni sui sistemi di riferimento spaziale e le proiezioni.

\index{pgsql2shp}\phantomsection\label{docs/user_manual/working_with_vector/supported_data:tip-export-from-postgis}
\begin{notice}{tip}{Suggerimento:}
\textbf{Esportare dati da PostGIS}

Oltre allo strumento per l’importazione \textbf{shp2pgsql}, esiste uno strumento per l’esportazione di dati PostGIS come shapefile: \textbf{pgsql2shp}. Lo strumento è incluso nella versione di PostGIS corrente.
\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}
Oltre a \textbf{shp2pgsql} e \textbf{SPIT} c’è un altro strumento per caricare dati in PostGIS: \textbf{ogr2ogr}. \textbf{ogr2ogr} fa parte della versione di GDAL installata.

Per importare uno shapefile in PostGIS con \textbf{ogr2ogr} digitare il seguente comando:

\begin{Verbatim}[commandchars=\\\{\}]
ogr2ogr -f "PostgreSQL" PG:"dbname=postgis host=myhost.de user=postgres \PYGZbs{}
password=topsecret" alaska.shp
\end{Verbatim}

L'espressione importerà lo shapefile \code{alaska.shp} nel database PostGIS \emph{postgis} usando l'utente \emph{postgres} e la password \emph{topsecret} sull'host \emph{myhost.it}.

Notare che OGR deve essere compilato con il supporto a PostgreSQL per poter effettuare tale operazione. La presenza del supporto a PostgreSQL-PostGIS può essere verificata digitando da riga di comando

\begin{Verbatim}[commandchars=\\\{\}]
ogrinfo --formats \textbar{} grep -i post
\end{Verbatim}

Qualora si volesse usare il comando interno di PostgreSQL \textbf{COPY} al posto del metodo predefinito \textbf{INSERT INTO}, bisogna settare le variabili d'ambiente come segue (su piattaforme \includegraphics[width=1em]{nix.png} e \includegraphics[width=1em]{osx.png}):

\begin{Verbatim}[commandchars=\\\{\}]
export PG\_USE\_COPY=YES
\end{Verbatim}

\textbf{ogr2ogr} non crea indici spaziali come \textbf{shp2pgsl}. Bisogna crearli manualmente, usando il comando SQL \textbf{CREATE INDEX} dopo l'importazione, come passaggio aggiuntivo (sezione {\hyperref[docs/user_manual/working_with_vector/supported_data:vector-improving-performance]{\emph{Migliorare le prestazioni}}}).
\phantomsection\label{docs/user_manual/working_with_vector/supported_data:label-improve}

\subsubsection{Migliorare le prestazioni}
\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}
Richiamare dati geografici da un database PostgreSQL può richiedere molto tempo, specialmente se il server dei dati si trova in rete. È possibile migliorare le prestazioni di resa a video di layer PostgreSQL assicurandosi di creare un indice spaziale \index{PostGIS spatial index}PostGIS spatial index su ogni layer nel database. PostGIS supporta la creazione di un indice \index{GiST (indice dell’albero generalizzato di ricerca, Generalized Search Tree)}GiST (indice dell’albero generalizzato di ricerca, Generalized Search Tree) per velocizzare le ricerche spaziali di dati (le informazioni su GIST fanno riferimento alla documentazione di PostGIS disponibile all'indirizzo \href{http://postgis.refractions.net}{http://postgis.refractions.net}).

La sintassi per la creazione di un indice GiST è:

\begin{Verbatim}[commandchars=\\\{\}]
CREATE INDEX [indexname] ON [tablename]
  USING GIST ( [geometryfield] GIST\_GEOMETRY\_OPS );
\end{Verbatim}

Si noti che per tabelle molto grandi, la creazione dell’indice può richiedere parecchio tempo. Non appena
l’indice è stato creato, bisognerebbe effettuare un \code{VACUUM ANALYZE}. Si veda la documentazione di PostGIS (POSTGIS-PROJECT {\hyperref[docs/user_manual/literature_web/literature_and_web_references:literature-and-web]{\emph{Literature and Web References}}}) per ulteriori informazioni.

Segue un esempio di come creare un indice 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{Layer vettoriali a cavallo dei 180° di longitudine}
\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}
Molti software GIS non gestiscono appropriatamente le mappe vettoriali, con sistema di riferimento geografico (lat/lon), \index{a cavallo della linea di longitudine 180 degrees}a cavallo della linea di longitudine 180 degrees (\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}). Se si apre una di tali mappe in QGIS vedremmo distanti aree geografiche che sono in realtà vicine tra di loro.Nella figura {\hyperref[docs/user_manual/working_with_vector/supported_data:figure-vector-4]{Figure\_vector\_4}} il piccolo punto all’estrema sinistra della vista mappa (Chatham Islands) dovrebbe essere all’interno della griglia subito alla destra dell’isola principale della Nuova Zelanda.
\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}

Come soluzione è possibile trasformare i valori di longitudine utilizzando PostGIS e la funzione \textbf{ST\_Shift\_Longitude}. La funzione legge ogni punto/vertice di ogni elemento in una geometria e se la coordinata di longitudine è \textless{} 0° , gli aggiunge  360° . Il risultato sarà una versione 0° - 360° dei dati, che verranno poi tracciati su una mappa centrata a 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{Guida all'uso}
\label{docs/user_manual/working_with_vector/supported_data:usage}\begin{itemize}
\item {} 
Importare i dati in PostGIS ({\hyperref[docs/user_manual/working_with_vector/supported_data:vector-import-data-in-postgis]{\emph{Importare dati in PostgreSQL}}}) utilizzando per esempio SPIT

\item {} 
Utilizzare l’interfaccia da linea di comando di PostGIS per dare il seguente comando (nell’esempio -``TABLE'' è il nome della tabella PostGIS)

\code{gis\_data=\# update TABLE set the\_geom=ST\_Shift\_Longitude(the\_geom);}

\item {} 
Se il comando ha esito positivo, si riceverà una notifica di conferma circa il numero di elementi aggiornati
e sarà possibile caricare i dati e vedere le differenze (figura {\hyperref[docs/user_manual/working_with_vector/supported_data:figure-vector-5]{Figure\_vector\_5}})

\end{itemize}

\index{Spatialite}\index{SQLite}

\subsection{Layer 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} Per caricare dei dati da un database SpatiaLite cliccare sullo strumento \includegraphics[width=1.5em]{mActionAddSpatiaLiteLayer.png} $^{\text{Aggiungi un layer SpatiaLite}}$ o selezionare l'opzione \includegraphics[width=1.5em]{mActionAddSpatiaLiteLayer.png} \emph{Aggiungi un layer SpatiaLite...} dal menu \emph{Layer} oppure digitare \code{Ctrl+Shift+L}. Si aprirà una finestra di dialogo che permette di accedere ai dati di un database SpatiaLite già connesso a QGIS oppure di definire la connessione ad un nuovo database: per connettersi ad un nuovo database cliccare su \textbf{{[}Nuovo{]}} e selezionare il database SpatiaLite, un file con l'estensione \code{.sqlite}.

Per salvare, invece, un layer vettoriale in formato SpatialLite, cliccare con il tasto destro del mouse sul layer nella legenda e selezionare l’opzione \emph{Salva con nome...}, definire il nome del file in uscita, selezionare SQLite con formato e il SR, aggiungere \code{SPATIALITE=YES} nel riquadro Sorgente dati delle opzioni di creazione OGR. Si veda inoltre \href{http://www.gdal.org/ogr/drv\_sqlite.html}{http://www.gdal.org/ogr/drv\_sqlite.html}.

QGIS supporta anche viste modificabili in SpatiaLite.


\subsubsection{Creare un nuovo layer SpatiaLite}
\label{docs/user_manual/working_with_vector/supported_data:creating-a-new-spatialite-layer}
Per creare un nuovo layer SpatiaLite, riferirsi alla sezione {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:vector-create-spatialite]{\emph{Creare un nuovo layer 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}{Suggerimento:}
\textbf{SpatiaLite data management plugin}

Per la gestione dei dati SpatiaLite è inoltre possibile usare diversi plugin Python: SpatiaLite Manager o DB Manager. Questi possono essere scaricati e installati grazie al menu Recupero plugin Python.
\end{notice}


\subsection{Layer Spatial MSSQL}
\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 fornisce un supporto nativo per MS SQL 2008. Il pulsante \includegraphics[width=1.5em]{mActionAddMssqlLayer.png} $^{\text{Aggiungi un vettore MSSQL}}$ fa parte della nuova barra degli strumenti ed è anche disponibile nel menu di QBrowser, nel quale è possibile importare i dati semplicemente trascinandoli.


\section{Proprietà dei layer vettoriali}
\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 finestra di dialogi \emph{Proprietà layer} fornisce informazioni sul layer, sulla sua rappresentazione grafica (stile) e sulle opzioni di visualizzazione delle etichette. Inoltre, se il layer vettoriale è stato caricato da un archivio dati PostgreSQL/PostGIS, è possibile modificare l’espressione SQL che lo ha generato tramite la finestra di dialogo \emph{Costruttore di interrogazioni} nella scheda \emph{Generale}. Per accedere alla finestra di dialogo \emph{Proprietà layer}, fare doppio click sul layer nella legenda o click con il tasto destro sul layer e selezionare \emph{Proprietà} dal menu contestuale.
\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{Scheda Stile}
\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} A partire dalla versione 1.4.0 QGIS utilizza una nuova simbologia per migliorare e in prospettiva sostituire la vecchia simbologia. QGIS 1.8 utilizza in modalità predefinita la nuova simbologia: questa fornisce diversi miglioramenti e nuove funzionalità.

Una descrizione della vecchia simbologia è disponibile nella Sezione {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-old-symbology]{\emph{Vecchia simbologia}}}.

La nuova simbologia utilizza tre tipi di simboli: indicatore (per i punti), linea (per le linee) e riempimento (per i poligoni). I simboli possono consistere di uno o più layer simbolo. È possibile impostare il colore di un simbolo e tale colore sarà poi assegnato a tutti i layer simbolo. Alcuni layer possono avere il colore non modificabile; ciò è utile quando si imposta il colore per un simbolo multi-layer. Allo stesso modo, è possibile impostare lo spessore per i simboli linea e la dimensione e la rotazione dei simboli indicatore.

\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{Tipi di layer simbolo}
\begin{itemize}
\item {} 
Layer di punti
\begin{itemize}
\item {} 
\textbf{Indicatore carattere}: visualizzazione tramite caratteri.

\item {} 
\textbf{Indicatore semplice}: visualizzazione tramite indicatori hard-coded.

\item {} 
\textbf{Indicatore SVG}: visualizzazione tramite immagini SVG.

\item {} 
\textbf{Ellisse}: visualizzatore tramite forme geometriche derivanti dagli attributi.

\item {} 
\textbf{Campo vettoriale}: visualizzazione tramite campi vettoriali derivanti dagli attributi.

\end{itemize}

\item {} 
Layer di linee
\begin{itemize}
\item {} 
\textbf{Decorazione linea}: aggiunge una decorazione alla linea (es. una freccia per indicare la direzione).

\item {} 
\textbf{Linea di evidenziazione}: una linea visualizzata tramite la ripetizione di simboli indicatore.

\item {} 
\textbf{Linea semplice}: visualizzazione tipica con spessore, colore e stile del tratto.

\end{itemize}

\item {} 
Layer di poligoni
\begin{itemize}
\item {} 
\textbf{Riempimento con centroide}: visualizza un indicatore semplice sul centroide.

\item {} 
\textbf{Riempimento SVG}: campisce un poligono con un simbolo SVG.

\item {} 
\textbf{Riempimento semplice}: campitura tipica con colore, stile e bordo.

\item {} 
\textbf{Riempimento a pattern lineare}: riempie un poligono con un pattern lineare.

\item {} 
\textbf{Riempimento a pattern puntuale}: riempie un poligono con un pattern di punti.

\item {} 
\textbf{Cornice: Decorazione linea}: aggiunge una decorazione alle linee (es. una freccia per indicare la
direzione).

\item {} 
\textbf{Cornice: Linea di evidenziazione}: usa un indicatore hard-coded come bordo di un’area.

\item {} 
\textbf{Cornice: Linea semplice}: definisce spessore, colore e stile del tratto per il bordo di un’area.

\end{itemize}

\end{itemize}

\index{Color\_ramps}
\textbf{Scala di colori}

Le scale di colori servono a definire il range di colori usati dai visualizzatori. Il colore del simbolo sarà definito in funzione della scala di colori.

Ci sono tre tipi di scale di colori:
\begin{itemize}
\item {} 
\textbf{Gradiente}: gradiente lineare.

\item {} 
\textbf{Casuale}: generazione casuale di colori da un’area specifica dello spazio dei colori.

\item {} 
\textbf{ColorBrewer}: utilizza uno schema di colori ed un numero definito di classi di colore.

\end{itemize}

Le scale di colori possono essere create nella scheda \emph{Scala di colori} dalla finestra di dialogo \emph{Gestore stile} cliccando su \textbf{{[}Aggiungi{]}} (vedi sezione {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-style-manager]{vector\_style\_manager}} ).

\textbf{Stili}

Uno stile raggruppa un insieme di vari simboli e scale di colori. È possibile definire dei simboli personalizzati ed utilizzarli senza doverli ricreare ogni volta. Gli elementi (simboli e scale di colori) di uno stile hanno sempre associato un nome che ne facilita la ricerca e la gestione. In QGIS è presente almeno uno stile predefinito (modificabile) e l’utente può crearne dei nuovi. Nella parte bassa della scheda Stile ci sono quattro pulsanti che permettono di gestire gli stili: usare \textbf{{[}Ripristina stile predefinito{]}} per tornare alle impostazioni di default, \textbf{{[}Salva come predefinito{]}} per salvare i propri stili, \textbf{{[}Caricamento stile...{]}} per caricare gli stili personali e \textbf{{[}Salva stile{]}} per salvare gli stili creati. Gli stili possono essere trasferiti anche da un layer all'altro. Attivare un layer e selezionare \emph{Layer \(\rightarrow\)} \includegraphics[width=1.5em]{mActionEditCopy.png} \emph{Copia stile}. Selezionare un altro layer e scegliere  \emph{Layer \(\rightarrow\)} \includegraphics[width=1.5em]{mActionEditPaste.png} \emph{Incolla stile}.

\index{Renderers}
\textbf{Visualizzatori}

Un visualizzatore è responsabile della rappresentazione di un elemento con un simbolo. Ci sono quattro tipi di visualizzatori: simbolo singolo, categorizzato (colore unico nelle vecchia simbologia), graduato e tramite regole. Non è presente un visualizzatore di colore continuo in quanto esso è semplicemente un caso speciale del visualizzatore graduato. I visualizzatori categorizzato e graduato sono definiti specificando un simbolo ed una scala di colori.
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:vector-new-symbology}
\textbf{Lavorare con la simbologia di nuova generazione}

Nella scheda \emph{Stile} è posibile selezionare uno dei quattro visualizzatori: simbolo singolo, categorizzato, graduato e tramite regole. Per ogni categoria di dato (punto, linea e poligono) sono disponibili i diversi tipi di layer simbolo (vedi {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-symbol-types]{vector\_symbol\_types}}). In funzione del visualizzatore scelto, scegliendo la scheda \emph{Stile}, vengono mostrate le impostazioni e le opzioni differenti, di seguito descritte. Attraverso il pulsante \textbf{{[}Gestore di stili{]}} la simbologia di nuova generazione permette di accedere al Gestore stil con il quale è possibile modificare, rimuovere e aggiungere altra simbologia.
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:tip-change-multiple-symbols}
\begin{notice}{tip}{Suggerimento:}
\textbf{Selezionare e cambiare simboli multipli}

La simbologia di nuova generazione permette di selezionare simboli multipli e cambiarne il colore, la trasparenza, la dimensione e lo spessore.
\end{notice}

\index{Single\_Symbol\_Renderer}\index{Renderer\_Single\_Symbol}
\textbf{Visualizzatore Simbolo singolo}

Il visualizzatore Simbolo singolo rappresenta tutti gli elementi di un layer tramite un unico simbolo definito dall’utente. Le diverse opzioni della scheda \code{Stile} variano in funzione tipo di layer, ma tutti i tipi condividono la seguente struttura. Nella parte in alto a sinistra della scheda è presente un’anteprima del simbolo. Nella parte inferiore è presente una lista di simboli già definiti per lo stile in uso. Il simbolo può essere modificato cliccando su \textbf{{[}Cambia{]}} sotto l’anteprima, che apre la finestra di dialogo \emph{Proprietà simbolo}, oppure cliccando su \textbf{{[}Cambia{]}} a destra dell'anteprima, che apre la finestra di dialogo \emph{Colore}.
\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}

Nella scheda \emph{Stile} è possibile impostare la trasparenza e le unità (millimetri o unità di mappa) per la dimensione della scala; è inoltre possibile utilizzare una dimensione della scala in funzione dei dati e la rotazione (pulsante \textbf{{[}Avanzato{]}} vicino a \textbf{{[}Salva con stile{]}}). Il pulsante  \emph{Livelli simbolo \(\rightarrow\)} permette di abilitare e definire l’ordine in cui i layer di simboli sono visualizzati (se i simboli consistono di più di un layer).

Fatte tutte le modifiche di interesse, il simbolo può essere aggiunto alla lista degli Stili salvati (tramite il pulsante \textbf{{[}Salva come stile{]}}) e riutilizzato successivamente. Inoltre si può usare il pulsante \textbf{{[}Salva come stile{]}} per salvare il simbolo come un file di stile di QGIS (.qml) oppure come un file SLD (.sld). Con l'attuale versione 1.8 di QGIS i file SLD possono essere esportati per ogni tipo di visualizzatore: simbolo singolo, categorizzato, graduato o tramite regole. Tuttavia, quando i file SLD vengono importati, viene creata sia un visualizzatore simbolo singolo che tramite regole. Questo significa che gli stili categorizzato e graduato vengono convertiti nello stile tramite regole. Se si vogliono mantenere quei tipi di visualizzatori, è necessario passare al formato QML. A volte risulta essere molto comoda la possibilità di convertire cosi facilmente questi stili nello stile tramite regole.

\index{Categorized\_Renderer}\index{Renderer\_Categorized}
\textbf{Visualizzatore Categorizzato}

Il visualizzatore Categorizzato rappresenta tutti gli elementi di un layer tramite un unico simbolo definito dall’utente, con i colori che riflettono il valore di un attributo specifico. La scheda \emph{Stile} permette di selezionare:
\begin{itemize}
\item {} 
L’attributo (Colonna)

\item {} 
Il simbolo (Simbolo)

\item {} 
Il colore (Scala di colori)

\end{itemize}

Con il pulsante \textbf{{[}Avanzato{]}} in basso a destra, è possibile impostare il campo di rotazione e il campo di dimensione della scala. Per comodità, la lista nella parte inferiore della scheda elenca i valori di tutti gli attributi, inclusi i siboli con i quali verranno visualizzati.

L'esempio in figura {\hyperref[docs/user_manual/working_with_vector/vector_properties:figure-symbology-2]{figure\_symbology\_2}} mostra la finestra di dialogo per la visualizzazione categorizzata del layer rivers dei dati campione di 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}
È possibile creare una scala di colori personalizzata selezionando \emph{Nuova scala di colori} dal menu a discesa Scala di colori. Si aprirà la finestra di dialogo ’Tipo di scala di colori’, con le opzioni: Gradiente, Casuale, ColorBrewer. Una volta selezionato il tipo, la finestra successiva permette di impostare le varie opzioni della scala di colori. Si veda figure\_symbology\_3\_per un esempio di una scala di colori personalizzata.
\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{Quantile}
\textbf{Visualizzatore Graduato}

Il visualizzatore Graduato rappresenta tutti gli elementi di un layer tramite un unico simbolo definito dall’utente, con i colori che riflettono la classificazione di un attributo di interesse.
\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}

Come il Visualizzatore Simbolo categorizzato, permette di impostare la rotazione e la dimensione della scala in base a campi specifici.

La scheda \emph{Stile} permette di selezionare:
\begin{itemize}
\item {} 
L’attributo (Colonna)

\item {} 
Il simbolo (Simbolo)

\item {} 
I colori (Scala di colori)

\end{itemize}

Inoltre, è possibile specificare il numero di classi (Classi) ed il tipo di classificazione (Modo). Sono disponibilii seguenti tipi di classificazione:
\begin{itemize}
\item {} 
Intervalli uguali

\item {} 
Quantile

\item {} 
Natural Breaks (Jenks)

\item {} 
Deviazione standard

\item {} 
Pretty Breaks

\end{itemize}

Il box nella parte inferiore della scheda \emph{Stile} elenca le classi con i vari range, le etichette ed i simboli con cui verranno rappresentate.

L'esempio in figura {\hyperref[docs/user_manual/working_with_vector/vector_properties:figure-symbology-4]{figure\_symbology\_4}} mostra la finestra di dialogo per la visualizzazione categorizzata del layer rivers deidati campione di QGIS.

\index{Rule-based\_Rendering}\index{Rendering\_Rule-based}
\textbf{Visualizzatore Tramite regole}

Il visualizzatore Tramite regole rappresenta tutti gli elementi di un layer tramite simboli basati su regole, con i colori che riflettono la classificazione di un attributo di interesse. Le regole si basano su istruzioni SQL, che possono essere create con il Query Builder. È possibile creare raggruppamenti per regole in base ad un filtro o in funzione della scala ed è possibile definire il comportamento con ’Enable symbol levels’ oppure con ’Use only first matched’.

L'esempio in figura {\hyperref[docs/user_manual/working_with_vector/vector_properties:figure-symbology-5]{figure\_symbology\_5}} mostra la finestra di dialogo per la visualizzazione tramite regole del layer rivers dei dati campione di QGIS.

Per creare una regola, premere `+' per attivare una riga esistente, cliccare su nuova regola e premere il pulsante \textbf{{[}Modifica{]}}. Nella finestra \emph{Proprietà delle regole} è possibile impostare un'etichetta per la regola. Cliccare \includegraphics{browsebutton.png} per aprire il Costruttore di stringhe. Nella \textbf{Lista delle funzioni} cliccare su \emph{Campi e valori} per vedere tutti gli attributi della tabella degli attributi. Per aggiungere un attributo nella casella \textbf{Espressioni}, fare doppio click sul rispettivo nome dalla lista \emph{Campi e valori}. Si possono usare i vari campi, valori e funzioni per costruire l'espressione desiderata, oppure è possibile scriverla direttamente nella casella (vedi {\hyperref[docs/user_manual/working_with_vector/field_calculator:vector-field-calculator]{\emph{Calcolatore di campi}}}).
\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{Visualizzatore Spostamento punto}

Il visualizzatore Spostamento punto permette di visualizzare gli elementi di un layer di punti anche se hanno la stessa posizione. I simboli vengono posizionati lungo un cerchio di spostamento intorno al centro del simbolo.
\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{Proprietà simbolo}

La finestra di dialogo Proprietà simbolo permette di impostare varie proprietà di un simbolo. Nella parte in basso a sinistra della finestra è disponibile un’anteprima del simbolo, così come apparirà nella vista mappa; sopra l’anteprima c’è la lista dei Layer simbolo. Per accedere alla finestra di dialogo \emph{Proprietà simbolo}, cliccare su \textbf{{[}} \includegraphics[width=1em]{mActionOptions.png} \textbf{Cambia...{]}} nella scheda \emph{Stile} della finestra di dialogo \emph{Proprietà layer}.

È possibile aggiungere e rimuovere layer simbolo, cambiare al posizione dei layer oppure bloccare i layer ai cambiamenti di colore. Nella parte destra della finestra di dialogo è possibile gestire le impostazioni di un layer simbolo selezionato nella lista Layer simbolo. L’impostazione più importante è \emph{Tipo layer del simbolo} \includegraphics{selectstring.png} che permette di scegliere il tipo di layer. Le opzioni dipendono dal tipo di vettore (Punti, Linee, Poligoni). Le opzioni del tipo layer del simbolo sono descritte nella sezione {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-symbol-types]{vector\_symbol\_types}}. E' possible cambiare le proprietà del layer del layer nella parte destra della finestra. Per esempio se è stato scelto un simbolo SVG per un layer di punti è possibile cambiarne il colore usando il pulsante \emph{Color}.
\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{Gestore stile}
\label{docs/user_manual/working_with_vector/vector_properties:style-manager}\label{docs/user_manual/working_with_vector/vector_properties:vector-style-manager}
Il Gestore stile è una piccola applicazione di supporto alla gestione degli stili e delle loro componenti (simboli e scale di colori). Il gestore elenca i simboli e le scale di colori di uno stile e permette di modificarli, rimuoverli o aggiungerne di nuovi. Per aprire il Gestore stile cliccare su \emph{Impostazioni \(\rightarrow\) Gestore di stili} nel menu principale oppure è possibile accedervi tramite la scheda \emph{Stile}.
\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{Vecchia simbologia}
\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}{Nota:}
QGIS 1.8 supporta ancora la vecchia simbologia, sebbene sia raccomandato l’uso della simbologia di
nuova generazione descritta in {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-new-symbology]{vector\_new\_symbology}}, la vecchia simbologia sarà rimossa a partire dal prossimo rilascio di QGIS.
\end{notice}

Per utilizzare la vecchia simbologia cliccare su \textbf{{[}Vecchia simbologia{]}} nella scheda \emph{Stile} della finestra di dialogo \emph{Proprietà layer}.

E' possibile usare la vecchia simbologia in modalità predefinita disattivando \includegraphics{checkbox.png} \emph{Utilizza la nuova generazione di simboli per la visualizzazione} nella scheda  \emph{Visualizzaione} in \emph{Impostazioni} \includegraphics[width=1em]{mActionOptions.png} \emph{Opzioni}.

\index{Old\_Symbology\_Renderers}\index{Renderers\_Old\_Symbology}
La vecchia simbologia di QGIS mette a disposizione i seguenti visualizzatori:
\begin{itemize}
\item {} 
\textbf{Simbolo singolo} - lo stesso stile è applicato a tutti gli elementi del vettore.

\item {} 
\textbf{Simbolo graduato} - lo stile applicato ai diversi elementi dipende dal valore di un campo particolare della tabella associata.

\item {} 
\textbf{Colore continuo} - gli elementi del layer sono mostrati con una gradazione di colori compresa entro due estremi specificati in base ai valori numerici di uno specifico campo.

\item {} 
\textbf{Valore univoco} - gli oggetti sono classificati in base ai valori unici di un campo della tabella associata, ad ogni valore viene assegnata una simbologia differente.

\end{itemize}

Per \index{modificare la simbologia}modificare la simbologia di un layer, fare semplicemente doppio click sulla relativa voce di legenda per fare apparire la finestra di dialogo \emph{Proprietà layer}.

\index{Fill\_Style}\index{Fill\_Color}\index{Outline\_Options}
\textbf{Opzioni per lo stile}

In questa finestra di dialogo è possibile scegliere lo stile di rappresentazione del layer vettoriale. Secondo l’opzione di visualizzazione scelta tra quelle descritte precedentemente si ha la possibilità di classificare anche gli elementi della mappa.

Le seguenti opzioni dovrebbero essere disponibili per pressoché tutte le simbologie:
\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{Colore di riempimento} - colore di riempimento degli elementi.

\item {} 
\textbf{Opzioni linea esterna}
\begin{itemize}
\item {} 
Stile bordo - tipo di tratteggio del bordo degli elementi. Si può anche impostare l’opzione Nessuno per escludere la rappresentazione del contorno.

\item {} 
Colore bordo - colore del bordo degli elementi.

\item {} 
Spessore bordo - larghezza della linea di contorno.

\end{itemize}

\end{itemize}

Lo stile di layer, una volta impostato, può essere salvato in un file (con estensione  \code{*.qml}): cliccare sul pulsante \textbf{{[}Salva stile...{]}}. Il pulsante \textbf{{[}Caricamento stile...{]}}, invece, carica un file si stile precedentemente salvato.

Se si desidera usare sempre un particolare stile quando il layer viene caricato, cliccare su  \textbf{{[}Salva come predefinito{]}} per rendere predefinito lo stile impostato. Inoltre, se si effettuano modifiche delle quali non si è soddisfatti, cliccare su \textbf{{[}Ripristina stile predefinito{]}} per ritornare allo stile predefinito precedentemente impostato.

\index{Vector\_Transparency}\index{Transparency\_Vector}
\textbf{Applicare la trasparenza ad un vettore}

QGIS permette di impostare la trasparenza per ogni layer vettoriale tramite la barra \emph{Trasparenza} \includegraphics{slider.png} nella scheda \emph{Stile}. La trasparenza permette la visualizzazione di più òayer vettoriali sovrapposti.

\index{Style\_Manager}\index{Manage\_Symbols}\index{Manage\_Color\_Ramps}
\index{Labeling\_Engine}\index{Labeling\_New}\index{Labeling\_Old}

\subsection{Scheda Etichette}
\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} Così come per la simbologia, anche per le etichette QGIS 1.8 mette a disposizione due modalità di gestione: di vecchia e di nuova generazione. La scheda \emph{Etichette} ancora contiene l’etichettatura di vecchia generazione. L’etichettatura di nuova generazione è  implementata con una nuova applicazione che sostituirà la vecchia simbologia nella prossima versione di QGIS.

Si raccomanda di utilizzare l’etichettatura di nuova generazione descritta nella Sezione {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-new-labeling]{\emph{Nuova etichettatura}}}.

La vecchia scheda \emph{Etichette} consente di abilitare la visualizzazione delle etichette associate agli elementi del layer e controlla una serie di opzioni legate al posizionamento, allo stile e ad altre caratteristiche delle etichette. Come esempio visualizzeremo le etichette dello shapefile lakes del QGIS sample dataset:
\begin{enumerate}
\item {} 
Caricare lo shapefile \code{alaska.shp} e il file GML \code{lakes.gml} in QGIS

\item {} 
Usare lo zoom su un’area a scelta contenente alcuni laghi

\item {} 
Rendere attivo il layer \code{lakes} cliccando su di esso nella legenda

\item {} 
Aprire la finestra di dialogo \emph{Proprietà layer}

\item {} 
Cliccare sulla scheda \emph{Etichette}

\item {} 
Selezionare la casella di controllo \includegraphics{checkbox.png} \emph{Mostra etichette} per abilitarne la visualizzazione

\item {} 
Choose the field to label with. We will use
\emph{Field containing label} \includegraphics{selectstring.png} \code{NAMES}

\item {} 
Inserire un’etichetta di default per gli elementi del layer lakes che non hanno nome. Questa etichetta verrà quindi usata ogni volta che QGIS dovrà etichettare un lago al quale non corrisponde nessun valore nel campo NAMES.

\item {} 
Nel caso di etichette molto lunghe, selezionare \includegraphics{checkbox.png}\emph{Multiline labels?}: QGIS cercherà di posizionare l'etichetta opportunamente. Una nuova linea corrispone al \textbf{singolo} carattere \code{\textbackslash{}n}, (non a due caratteri separati, come il simbolo \code{\textbackslash{}} seguita dal carattere \code{n}). Per inserire una nuova linea in un campo degli attributi configurare il widget modifica in modo che sia riconosciuto come testo (non come linea).

\item {} 
Cliccare su \textbf{{[}Applica{]}}.

\end{enumerate}

Adesso sono visualizzate le etichette. Il loro aspetto non è probabilmente gradevole, potrebbero essere troppo grandi e posizionate male in relazione al simbolo dei laghi.

Clicca allora su \textbf{{[}Carattere{]}} e \textbf{{[}Colore{]}} per impostare il tipo di carattere e il colore. È possibile anche cambiare l’angolo e la posizione delle etichette testuali.

Per modificare la posizione del testo rispetto agli elementi:
\begin{enumerate}
\item {} 
Cambiare la posizione selezionando una delle opzioni disponibili nel gruppo \emph{Posizionamento}. Nel caso preso in esame, scegliere l'opzione \includegraphics{radiobuttonon.png} \emph{Destra}.

\item {} 
la voce \code{Dimensione carattere} consente di selezionare tra \includegraphics{radiobuttonon.png} \emph{Punti} o \includegraphics{radiobuttonoff.png} \emph{Unità mappa}.

\item {} 
Cliccare su \textbf{{[}Applica{]}} per visualizzare i cambiamenti senza chiudere la finestra di dialogo.

\end{enumerate}

Ora l’aspetto sarà migliore, ma le etichette appaiono ancora troppo vicine all’indicatore della loro posizione. Per sistemare il problema è possibile utilizzare l’opzione \code{Offset}: aggiungendo uno spostamento in X pari a 5 le etichette verranno scostate dall’indicatore della loro posizione e rese più leggibili. Ovviamente più è grandel’indicatore o il carattere, maggiore sarà lo scostamento da applicare.

Aggiungiamo infine un buffer sulle etichette cliccando sulla voce \code{Contorno}. In questo modo verrà aggiunto uno sfondo attorno alle lettere per farle risaltare maggiormente. Per mettere un buffer alle etichette dei laghi procedere come di seguito:
\begin{enumerate}
\item {} 
Abilitare la casella di controllo \includegraphics{checkbox.png} \emph{Contorno etichette}.

\item {} 
Scegliere una dimensione (spessore) del buffer.

\item {} 
Scegliere un colore per il buffer cliccando sul pulsante \textbf{{[}Colore{]}}. È inoltre possibile assegnare una trasparenza in percentuale al buffer.

\item {} 
Cliccare su \textbf{{[}Applica{]}} per vedere i cambiamenti.

\end{enumerate}

Modificare eventualmente i cambiamenti fino a quando non si è soddisfatti del risultato, cliccando su \textbf{{[}Applica{]}} dopo ogni modifica.

In genere un buffer di 1 punto fornisce risultati esteticamente gradevoli. Si noti che è anche possibile specificare la dimensione del buffer in unità della mappa se ciò rende più agevole l’impostazione.

Le rimanenti voci della scheda \emph{Etichette} consentono di controllare l’aspetto delle etichette usando, se adeguatamente preparati, gli attributi del layer. Le voci della scheda \code{Avanzato} consentono di settare tutti i parametri delle etichette facendo riferimento a campi della tabella del layer.

Si noti che la scheda \emph{Etichette} fornisce un’\code{Anteprima} nella quale viene mostrata l’etichetta predefinita.

\index{New\_Labeling}\index{Smart\_Labeling}

\subsection{Nuova etichettatura}
\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}
La nuova applicazione \includegraphics[width=1.5em]{mActionLabeling.png} $^{\text{Etichettatura}}$ richiede solo pochi parametri, ma gestisce in maniera intelligente l’etichettatura dei layer vettoriali; supporta, inoltre, i layer trasformati al volo. Questa applicazione sostituirà l’etichettatura di vecchia generazione di QGIS, descritta nella sezione {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-labels-tab]{\emph{Scheda Etichette}}} e supporta anche le riproiezioni al volo dei layer.

\textbf{Utilizzare la nuova etichettatura}
\begin{enumerate}
\item {} 
Avviare QGIS e caricare un vettore.

\item {} 
Attivare il layer nella legenda e cliccare sull’icona \includegraphics[width=1.5em]{mActionLabeling.png} $^{\text{Etichettatura}}$ nel menu degli strumenti di QGIS.

\end{enumerate}

\textbf{Etichettare layer di punti}

Come prima cosa selezionare la casella di controllo \includegraphics{checkbox.png} \emph{Etichetta questo layer} e scegliere un campo della tabella degli attributi da usare per l’etichettatura.Cliccare \includegraphics{browsebutton.png} se si desidera che le etichette si basino su espressioni. Nella scheda \emph{Avanzato} è possibile definire lo stile del testo e la visibilità in funzione della scala:(vedi {\hyperref[docs/user_manual/working_with_vector/vector_properties:figure-labels-1]{Figure\_labels\_1}} ). Scegliere la scheda \emph{Avanzato} per impostare il posizionamento e la priorità delle etichette. E' anche possibile scegliere se etichettare ogni parte delle geometrie multi-parte oppure se limitare l'etichettatura in funzione della grandezza dell'elemento. La scheda \emph{Impostazioni definite dai dati} permette di definire le etichette in base agli attributi del layer stesso.
\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{Etichettare layer di linee}

Come prima cosa selezionare la casella di controllo \includegraphics{checkbox.png} \emph{Etichetta questo layer} e scegliere un campo della tabella degli attributi da usare per l’etichettatura. Anche in questo caso è possibile scegliere se le etichette si devono basare su espressioni. Ulteriori opzioni sono disponibili nella scheda \emph{Avanzato} (vedi {\hyperref[docs/user_manual/working_with_vector/vector_properties:figure-labels-2]{Figure\_labels\_2}} ).
\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{Etichettare layer di poligoni}

Come prima cosa selezionare la casella di controllo \includegraphics{checkbox.png} \emph{Etichetta questo layer} e scegliere un campo della tabella degli attributi da usare per l’etichettatura.  In seguito è possibile definire il posizionamento dell’etichetta, la distanza, lo stile del testo, la priorità, la visibilità in funzione della scala, se etichettare ogni parte delle geometrie multi-parte, e se gli elementi devono comportarsi come ostacoli per le etichette ({\hyperref[docs/user_manual/working_with_vector/vector_properties:figure-labels-3]{Figure\_labels\_3}} ).
\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{Posizionamento etichette}

Cliccando sul pulsante \textbf{{[}Impostazioni{]}} nella scheda \emph{Avanzato} è possibile selezionare la modalità di ricerca per il posizionamento ottimale delle etichette. Le modalità disponibili sono: Catena, Popmusic tabu, Catena popmusic, Catena tabu popmusic e 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}

Nella finestra di dialogo è possibile definire il numero di candidati, se mostrare tutte le etichette (incluse quelle che collidono) e se mostrare le etichette possibili (per debugging).

\textbf{Parole chiave in campi attributo per l’etichettatura}

È possibile usare alcune parole chiave in campi attributo dedicati per il posizionamento delle etichette.
\begin{itemize}
\item {} 
\textbf{Per l’allineamento orizzontale}: \code{left}, \code{center}, \code{right}

\item {} 
\textbf{Per l’allineamento verticale}: \code{bottom}, \code{base}, \code{half}, \code{top}

\item {} 
\textbf{Colori specificati in motazione SVG}, e.g. \#ff0000

\item {} 
\textbf{Per bold, underlined, strikeout e italic}: 0 = false 1 = true

\end{itemize}

Combinazioni tipo \code{base right} oppure \code{bottom left} è possibile che funzionino.


\subsection{Scheda Campi}
\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} Con la scheda \emph{Campi} è possibile gestire gli attributi di un layer. I pulsanti \includegraphics[width=1.5em]{mActionNewAttribute.png} $^{\text{Nuova colonna}}$ e \includegraphics[width=1.5em]{mActionDeleteAttribute.png} $^{\text{Elimina colonna}}$ possono essere usati se il layer è in modalità \includegraphics[width=1.5em]{mActionToggleEditing.png} $^{\text{Modifica}}$.

Allo stato attuale possono essere aggiunte/rimosse solo colonne di layer PostGIS. La libreria OGR supporta l’aggiunta di nuove colonne e la rimozione, se si ha installata la versione 1.9 o superiore di GDAL.

\textbf{Widget modifica}




\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}

Nella scheda \emph{Campi} è presente una colonna \code{widget modifica}: questa può essere usata per definire valori o intervalli di valori permessi per gli attributi. Cliccando su \textbf{{[}Modifica valore{]}} si apre una finestra di dialogo dove è possibile definire diversi widget:
\begin{itemize}
\item {} 
\textbf{Modifica valore}: widget predefinito. Supporta testo semplice o numeri per attributi numerici.

\item {} 
\textbf{Classificazione}: visualizza una combo-box contenente i valori utilizzati per la classificazione, qualora il tipo di legenda (nella scheda \emph{Stile}) sia stato impostato su `valore unico'.

\item {} 
\textbf{Intervallo}: permette di definire un numero di valori per un intervallo specifico. Il widget di modifica può utilizzare un cursore o una casella di selezione.

\item {} 
\textbf{Valori unici}: l’utente può selezionare uno dei valori già utilizzati negli attributi. Se editabile, una linea modificata ha la possibilità di autocompletamento; in caso contrario viene presentata una combo box.

\item {} 
\textbf{Nome file}: semplifica la selezione di file attraverso una finestra di dialogo di scelta.

\item {} 
\textbf{Mappa valori}: combo-box con oggetti predefiniti. Il valore è archiviato negli attributi, la descrizione presentata nel combo-box. I valori possono essere definiti manualmente o caricati da un layer o da un file csv.

\item {} 
\textbf{Enumerazione}: apre una combo-box con i valori che possono essere utilizzati. È supportato solo dal provider postgres.

\item {} 
\textbf{Immutabile}: l’attributo è di sola lettura, non può essere modificato.

\item {} 
\textbf{Nascosto}: l’attributo è invisibile all’utente.

\item {} 
\textbf{Checkbox}: mostra una casella di controllo e si può definire quale attributo è aggiunto alla colonna quando la casella è attivata.

\item {} 
\textbf{Modifica testo}: apre un campo di modifica di testo che permette di usare linee multiple.

\item {} 
\textbf{Calendario}: apre un widget calendario per inserire una data. La colonna deve essere di tipo testuale.

\item {} 
\textbf{Relazione valore}: offre i valori di una tabella in una combobox. Si possono selezionare layer, colonna chiave e colonna valore.

\item {} 
\textbf{Generatore UUID}: genera un campo UUID (Universally Unique Idetifiers) di sola lettura, se il campo è vuoto.

\end{itemize}


\subsection{Scheda Generale}
\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} The \emph{Generale} è sostanzialmente simile a quella dei raster. Ci sono diverse opzioni disponibili:
\begin{itemize}
\item {} 
Cambiare il nome di visualizzazione del layer

\item {} 
Selezionare un campo di visualizzazione che dovrà essere usato dalla finestra \emph{Informazioni elementi}

\item {} 
Definire una precisa Interfaccia di modifica utente per il layer vettoriale scritta con lo strumento Qt Creator IDE (\href{http://qt.digia.com/Product/Developer-Tools/}{http://qt.digia.com/Product/Developer-Tools/})

\item {} 
Creare un \emph{indice spaziale} (solo per formati supportati da OGR)

\item {} 
Aggiungere un \emph{Init function} per il layer. Questi sovrascriveranno i widget di inizializzazione di QGIS se presenti

\item {} 
\emph{Aggiorna estensione} del layer

\item {} 
Vedere o cambiare la proiezione del layer vettoriale, cliccando su \emph{Specifica SR}

\end{itemize}

Inoltre si può attivare la casella \includegraphics{checkbox.png} \emph{Visualizza in funzione della scala}, impostare opzioni di codifica e con il pulsante \textbf{{[}Costruttore interrogazioni{]}} si può creare un sottoinsieme di caratteristiche che si vogliono visualizzare (si veda la sezione {\hyperref[docs/user_manual/working_with_vector/query_builder:sec-selection-query]{\emph{Selezione}}}).
\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{Scheda Metadati}
\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} The \emph{Metadata} tab contains general information about the layer,
including specifics about the type and location, number of features, feature
type, and the editing capabilities. The \emph{Extents} section, providing
layer extent information, and the \emph{Layer Spatial Reference System}
section, providing information about the CRS of the layer. This is a quick way
to get information about the layer.

In aggiunta si possono aggiungere o modificare titoli per il layer e per altre informazioni. Queste informazioni verranno salvate nel file di progetto di QGIS per sessioni future e saranno utilizzate da 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{Scheda Azioni}
\label{docs/user_manual/working_with_vector/vector_properties:actions-tab}
\includegraphics[width=2em]{action.png} QGIS offre la possibilità di effettuare azioni sulla base degli attributi associati ai singoli elementi del layer vettoriale. Questo permette di effettuare un elevato numero di azioni, per esempio, lanciare un programma con argomenti costruiti tramite gli attributi delle geometrie o passando i parametri ad uno strumento di web reporting.
\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}

Definire delle azioni è utile quando si intende lanciare un’applicazione esterna o la visualizzazione di una pagina web sulla base di uno o più valori associati al layer vettoriale. Ci sono 6 tipologie di azioni che possono essere usate nel seguente modo:
\begin{itemize}
\item {} 
Le azioni Generic, Mac, Windows e Unix fanno partire un processo esterno,

\item {} 
Le azioni Python eseguno un espressione python,

\item {} 
Le azioni Generic e Python sono visibili ovuntue,

\item {} 
Le azioni Mac, Windows e Unix sono visibili sono sulle rispettive piattaforme (cioè è possibile definire tre azioni, ma l'utente vedrà i risultati solamente sulla piattaforma dalla quale è stato lanciato l'editor).

\end{itemize}

Ci sono diversi esempi inclusi nel dialogo ed è possibile caricarli cliccando su \textbf{{[}Aggiungi azioni predefinite{]}}. Un esempio è eseguire una ricerca basata su un valore degli attributi. Questo concetto è spiegato nella discussione seguente.

\index{Actions}\index{Attribute\_Actions}
\textbf{Definire le azioni}

Le azioni legate agli attributi sono definite dalla finestra di dialogo \emph{Proprietà layer}. Per impostare un’azione, aprire la finestra di dialogo \emph{Proprietà layer} e cliccare sulla scheda \emph{Azioni}. Selezionare `Generico' come tipo e fornire un nome descrittivo dell'azione. L’azione in sé deve contenere il nome o il percorso di una applicazione che verrà eseguita quando l’azione viene richiamata. L’azione può venire fatta dipendere da uno o più campi della tabella attributi. Quando essa è richiamata ogni stringa testuale che inizia con \code{\%} seguita dal nome di un campo della tabella attributi verrà rimpiazzata dal valore di quel campo. I caratteri speciali \code{\%\%} saranno rimpiazzati dal valore del campo nell’elemento selezionato con lo strumento Informazioni elementi disponibile nella barra strumenti o dalla tabella attributi (vedi il paragrafo {\hyperref[docs/user_manual/working_with_vector/vector_properties:using-actions]{using\_actions}} below).Le virgolette ('') possono essere usate per raggruppare il testo in un singolo argomento da passare al programma, allo scripto al comando che si intende eseguire. Le virgolette saranno ignorate se precedute dalla barra inversa.

Se sono presenti nomi di campi che possono essere interpretati come sotto-stringhe di altri nomi di campi (ad es. \code{col1} e \code{col10}) è necessario racchiudere il nome (e il carattere \%) tra parentesi quadre (ad es. \code{{[}\%col10{]}}). Ciò impedirà che il nome di campo \code{\%col10} possa essere confuso con \code{\%col1} con uno \code{0} alla fine. Le virgolette saranno rimosse da QGIS man mano che vengono inseriti i valori del campo al posto dell’espressione. Se si vuole che i campi sostituiti vengano racchiusi entro parentesi quadre, aggiungere una seconda coppia di parentesi quadre in questo modo: \code{{[}{[}\%col10{]}{]}}.

La finestra di dialogo \emph{Informazione sui risultati} che compare quando si usa lo strumento \emph{Informazioni elementi} ha una voce (Derivato) che contiene informazioni dipendenti dal tipo di layer interrogato. Si può accedere ai valori di questa voce similmente a come si accede ai valori di campo della tabella attributi anteponendo al nome di campo disponibile alla voce (Derivato) l’espressione \code{(Derivato}). Per esempio un layer puntuale
ha due sotto-voci \code{X} e \code{Y} e il valore di essi può essere usato nell’azione con l’espressione \code{\%(Derivato).X} e \code{\%(Derivato).Y}. Gli attributi derivati sono disponibili solo nella finestra  \emph{Informazione sui risultati} e non dalla finestra \emph{Tabella degli attributi}.

Due \index{esempi di azioni}esempi di azioni sono di seguito indicati:
\begin{itemize}
\item {} 
\code{konqueror http://www.google.com/search?q=\%nam}

\item {} 
\code{konqueror http://www.google.com/search?q=\%\%}

\end{itemize}

Nel primo esempio, il browser konqueror viene richiamato con un URL da aprire. L’URL crea una ricerca Google sul valore del campo \code{nam} nel layer vettoriale. Si noti che il programma o lo script richiamato dall’azione deve essere nel path impostato come variabile d’ambiente oppure bisogna fornire il percorso completo all’eseguibile. Per sicurezza, è possibile riscrivere il primo esempio come: \code{/opt/kde3/bin/konqueror http://www.google.com/search?q=\%nam}. In questo modo si è sicuri che l’applicazione konqueror sarà eseguita quando si richiama l’azione.

Nel secondo esempio viene usata la notazione \%\% che non richiede l’indicazione di un particolare
campo. Quando si richiama l’azione, il \%\% sarà rimpiazzato dal valore selezionato con lo strumento Informazioni elementi o nella tabella degli attributi.
\phantomsection\label{docs/user_manual/working_with_vector/vector_properties:using-actions}
\textbf{Uso delle azioni}

Le azioni possono essere richiamate sia dalla finestra \emph{Informazioni sui risultati} che da quella della \emph{Tabella degli attributi}. (Si ricorda che queste finestre possono essere aperte rispettivamente cliccando sullo strumento \includegraphics[width=1.5em]{mActionIdentify.png} $^{\text{Informazioni elementi}}$ \includegraphics[width=1.5em]{mActionOpenTable.png} $^{\text{Apri tabella degli attributi}}$ o \includegraphics[width=1.5em]{mAction.png} $^{\text{Avvia azione sull'elemento}}$). Per eseguire l’azione, fare click con il tasto destro del mouse sul record e scegliere azione dal menu contestuale. Le azioni sono indicate nel menu a contestuale dal nome assegnatogli in fase di definizione dell’azione. Cliccare sull’azione che si vuole eseguire.

Se si vuole eseguire un’azione che usa la notazione \%\%, cliccare con il tasto destro del mouse sul valore di campo che si desidera passare all’azione nella finestra di dialogo \emph{Informazioni sui risultati} o in quella \emph{Tabella degli attributi}.

In questo altro esempio viene illustrato come estrarre dati da un layer vettoriale per inserirli in un file usando la shell di sistema bash e il comando \code{echo} (dunque funzionerà solo su \includegraphics[width=1em]{nix.png} e forse su \includegraphics[width=1em]{osx.png}). Il layer in questione ha i seguenti campi nella tabella attributi: nome della specie \code{taxon\_name}, latitudine \code{lat} e longitudine \code{long}. Si vuole eseguire una selezione spaziale delle specie (taxon) presenti in determinate posizioni esportando i risultati in un file di testo per le posizioni selezionate (evidenziate in giallo nella vista mappa di QGIS). L’azione in grado di assolvere lo scopo è la seguente:

\begin{Verbatim}[commandchars=\\\{\}]
bash -c "echo \PYGZbs{}"\%taxon\_name \%lat \%long\PYGZbs{}" \textgreater{}\textgreater{} /tmp/species\_localities.txt"
\end{Verbatim}

Selezionando alcune posizioni, l’esecuzione dell’azione precedente su ognuna di esse genera un file in uscita che avrà l’aspetto seguente:

\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}

Come esercizio si può creare un’azione che generi una ricerca su Google sul layer \code{lakes}. Innanzitutto è necessario determinare la sintassi da impiegare nell’URL per eseguire una ricerca basata su una parola chiave. L’espressione si ricava facilmente eseguendo una ricerca dalla pagina di Google, la pagina dei risultati avrà un indirizzo, visibile nella barra indirizzi del browser, del tipo: \href{http://google.com/search?q=qgis}{http://google.com/search?q=qgis}, in cui \code{QGIS} è la parola ricercata. Forniti di questa informazione, si può procedere nel seguente modo:
\begin{enumerate}
\item {} 
Assicurarsi che il layer \code{lakes} sia caricato.

\item {} 
Aprire la finestra di dialogo \emph{Proprietà layer} facendo doppio click sul layer o cliccando su di esso nella legenda con il tasto destro del mouse e scegliendo \emph{Proprietà} dal menu contestuale.

\item {} 
Cliccare sulla scheda \emph{Azioni}.

\item {} 
Inserire un nome descrittivo per l’azione, ad esempio \code{Google}.

\item {} 
Fornire il nome di un programma esterno da eseguire nell’azione. In questo caso useremo il browser Firefox. Se il programma non si trova in uno dei percorsi di sistema definiti dalla variabile d’ambiente PATH, bisogna specificare il percorso completo all’eseguibile.

\item {} 
Far seguire il nome del programma esterno dall’URL usato per la ricerca su Google senza includere la parola ricercata, ovvero: \code{http://google.com/search?q=}

\item {} 
A questo punto il testo nel campo \emph{Azioni} dovrebbe apparire così: \code{firefox http://google.com/search?q=}

\item {} 
Cliccare sul menu a tendina contenente i nomi dei campi della tabella associata al layer \code{lakes},
posizionato immediatamente a sinistra del pulsante \textbf{{[}Inserisci campo{]}}.

\item {} 
Dall'elenco apparso scegliere \emph{Cattura dell'output} \includegraphics{selectstring.png} select `NAMES' e cliccare su \textbf{{[}Insert Field{]}}.

\item {} 
A questo punto il testo nel campo \emph{Azioni} dovrebbe apparire così: {\color{red}\bfseries{}{}`{}`}firefox \href{http://google.com/search}{http://google.com/search}?q=\%NAMES{}`

\item {} 
Per completare l'azione cliccare sul pulsante \textbf{{[}Inserisci l'azione{]}}.

\end{enumerate}

Questo completa la definizione dell’azione che è così pronta per essere usata. La formulazione finale dell’azione dovrebbe apparire così:
\begin{quote}

\code{firefox http://google.com/search?q=\%NAMES}
\end{quote}

A questo punto l’azione è pronta per essere usata. Chiudere la finestra \emph{Proprietà layer} e usare lo zoom su un’area a scelta. Assicurarsi che il layer \code{lakes} sia attivo ed identificare con l’apposito strumento un lago. Nella finestra risultante dovrebbe essere visibile l’azione:
\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}

Cliccando sull’azione, viene lanciato Firefox all’URL \href{http://www.google.com/search?q=Tustumena}{http://www.google.com/search?q=Tustumena}. È anche possibile aggiungere ulteriori campi all’azione, inserendo un \code{+} alla fine della stringa che definisce l’azione, selezionando quindi un altro campo e cliccando sul pulsante \textbf{{[}Inserisci campo{]}}. Nell’esempio seguito finora semplicemente non c’è alcun altro campo sul quale avrebbe senso fare una ricerca.

È possibile definire più di un’azione per ogni layer, ognuna di esse verrà mostrata nella finestra
\emph{Informazioni sui risultati}.

Si possono immaginare molti tipi di azione. Ad esempio se un layer di punti rappresenta le posizioni alle quali sono state scattate foto o alle quali corrispondono immagini e il nome dei file di tali foto o immagini, è possibile creare un’azione per lanciare un visualizzatore che mostri l’immagine. Le azioni possono essere usate anche per lanciare report sul web per uno o più campi della tabella attributo, definendole allo stesso modo dell’esempio per la ricerca con Google.

Si possono fare esempi anche molto più complicati, per esempio su come usare le azioni \textbf{Python}.

Normalmente quando usiamo un'azione per aprire un file con un'applicazione esterna, si può usare un percorso assoluto o relativo. Nel secondo caso, il percorso è relativo alla posizione del file eseguibile del programma esterno. Ma cosa succede se è necessario usare un percorso relativo al layer selezionato (basato su un file, come uno shapefile o spatialite)? Ecco il trucco:

\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}

bisogna ricordare che l'azione è del tipo \emph{Python} e per il nostro scopo è necessario cambiare le variabili \emph{command} e \emph{imagerelpath}.

Ma come si procede se il percorso relativo deve essere relativo al file di progetto (salvato)? Il codice  per l'azione Python sarà:

\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 altro esempio di azione Python è quello che permette di aggiungere nuovi layer al progetto. In questo esempio aggiungeremo sia un file vettoriale che uno raster. Il nome dei file da aggiungere al progetto e il nome da assegnare ai layer è fornito dai dati (\emph{filename} e \emph{layname} sono nomi di colonne della tabella dagli attributi del vettore dove l'azione è stata creata):

\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}

Per aggiungere un raster (in questo esempio un'immagine tif), diventa:

\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{Scheda Join}
\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} La scheda \emph{Joins} permette di effettuare un join tra una tabella di attributi ed un layer vettoriale, indicando il layer da unire, il campo unione ed il campo di destinazione. Attualmente QGIS permette il join di tabelle nei formati supportati da OGR, testo delimitato e del provider PostgreSQL (Figura {\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}

Il dialogo del join vettoriale fornisce le opzioni:
\begin{itemize}
\item {} 
\includegraphics{checkbox.png} \emph{Layer unito in memoria virtuale}

\item {} 
\includegraphics{checkbox.png} \emph{Crea un indice nel campo unito}

\end{itemize}


\subsection{Scheda Diagrammi}
\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} La scheda \emph{Diagrammi} permette di sovrapporre un grafico ad un layer vettoriale (Figura {\hyperref[docs/user_manual/working_with_vector/vector_properties:figure-diagrams-1]{figure\_diagrams\_1}}).

L’implementazione corrente dei diagrammi supporta grafici a torta e diagrammi testo e permette di scalare linearmente il grafico in funzione di un attributo. Il posizionamento del grafico interagisce con l’etichettatura di nuova generazione, in questo modo, eventuali confilitti fra diagrammi ed etichette vengono automaticamente risolti. Inoltre la posizione dei grafici può essere fissata dall'utente.
\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}

Segue un esempio di creazione di un grafico delle temperature sovrapposto al layer alaska; entrambi i layer sono disponibili nei dati campione di QGIS (Sezione  {\hyperref[docs/user_manual/introduction/getting_started:label-sampledata]{\emph{Dati campione}}}).
\begin{enumerate}
\item {} 
Cliccare sull'icona \includegraphics[width=1.5em]{mActionAddOgrLayer.png} $^{\text{Aggiungi vettore}}$ e caricare i due vettori \code{alaska.shp} e \code{climate.shp}.

\item {} 
Doppio clicl sul layer \code{climate} nella legenda per aprire la finestra di dialogo \emph{Proprietà layer}.

\item {} 
Cliaccare sulla scheda \emph{Diagrammi}, attivare \emph{Visualizza diagrammi} e dalla combobox \emph{Tipo di diagramma} \includegraphics{selectstring.png} selezionare `Diagramma testo'

\item {} 
Come colore di sfondo scegliere un blu chiaro e scegliere la grandezza fissa di 18 mm.

\item {} 
Si può optare per una posizione intorno al punto.

\item {} 
Il grafico dovrà mostrare i valori delle tre colonne: \code{T\_F\_JAN}, \code{T\_F\_JUL} e \code{T\_F\_MEAN}. Selezionare \code{T\_F\_JAN} come attributo e cliccare sul pulsante verde \textbf{{[}+{]}}, poi selezionare \code{T\_F\_JUL} ed infine \code{T\_F\_MEAN}.

\item {} 
Cliccare su \textbf{\{Applica{]}} per visualizzare il diagramma nella finestra principale di QGIS.

\item {} 
Ora è possibile adattare la dimensione del grafico oppure cambiare il colore facendo doppio click sul valore del colore nel campo degli attributi. La figura {\hyperref[docs/user_manual/working_with_vector/vector_properties:figure-diagrams-2]{Figure\_diagrams\_2}} mostra un esempio.

\item {} 
Premere \textbf{{[}Ok{]}} per concludere l'operazione.

\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}

Inoltre nella finestra \emph{Impostazioni \(\rightarrow\) Opzioni} è presente la scheda \code{Sovrapposizione} dove è possibile selezionare l'algoritmo di posizionamento del diagramma. Il metodo del punto centrale è quello generico, mentra gli altri algoritmi usando le librerie PAL. Questi considerano gli oggetti dei diagrammi e le etichette in layer diversi. Per ulteriori informazioni guardare la sezone {\hyperref[docs/user_manual/plugins/plugins_diagram_overlay:diagram-overlay]{\emph{Plugin Diagramma sovrapposto}}}.


\section{Modifica}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:editing}\label{docs/user_manual/working_with_vector/editing_geometry_attributes::doc}
QGIS supporta la modifica di layer vettoriali OGR, PostGIS e Spatialite.

\begin{notice}{note}{Nota:}
The procedure for editing GRASS layers is different - see Section
{\hyperref[docs/user_manual/grass_integration/grass_integration:grass-digitizing]{\emph{Digitalizzare e modificare layer vettoriali GRASS}}} for details.
\end{notice}
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:tip-concurrent-edits}
\begin{notice}{tip}{Suggerimento:}
\textbf{Modifiche concorrenti}

Questa versione di QGIS non effettua alcuna verifica sulla possibilità che più utenti stiano effettuando contemporaneamente modifiche sullo stesso layer, è quindi l’ultimo utente che effettua il salvataggio ad apportare le modifiche definitive.
\end{notice}

\index{Snapping}\index{Snapping\_Tolerance}

\subsection{Settare la tolleranza dello snapping e il raggio di ricerca degli elementi}
\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}
Prima di editare vertici, è molto importante sia impostare il livello di snapping che il valore del raggio di ricerca al fine di gestire in maniera ottimale la modifica delle geometrie di un layer vettoriale.


\subsubsection{Tolleranza di snapping}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:id1}
La tolleranza di snapping è la distanza entro la quale QGIS \code{cerca} il vertice e/o segmento più vicino al quale si cerca di agganciarsi quando si crea un nuovo vertice o si sposta un vertice esistente. Se non si è entro la tolleranza di snapping, QGIS lascerà il vertice creato o spostato nella posizione in cui si rilascia il pulsante del mouse invece di agganciarlo ad un vertice e/o segmento esistente. La tolleranza di snapping influenza tutti gli strumenti che lavorano con una tolleranza.
\begin{enumerate}
\item {} 
La tolleranza di snapping può essere impostata a livello dell’intero progetto scegliendo la voce di menu \emph{Impostazioni \(\rightarrow\)} \includegraphics[width=1em]{mActionOptions.png} \emph{Opzioni}. Su Mac andare su \emph{QIS \(\rightarrow\)} \includegraphics[width=1em]{mActionOptions.png} \emph{Preferenze...}, su Linux: \emph{Modifica \(\rightarrow\)} \includegraphics[width=1em]{mActionOptions.png} \emph{Opzioni}. Nella scheda  \emph{Digitalizzazione} è possibile impostare la modalità di snap predefinita tra snap al vertice, al segmento o entrambe. Si può anche definire una tolleranza di snapping e un raggio di ricerca per la modifica di un vertice, in unità di mappa o in pixel. Impostando i valori in pixel, invece che in unità di mappa, si evita di dover modificare la tolleranza in seguito ad operazioni di zoom. Nel nostro progetto di digitalizzazione (con il dataset Alaska), definiamo la tolleranza di snap in metri. I risultati possono variare, ma alla scala 1:10000 il valore di circa 100 metri dovrebbe andare bene.

\item {} 
È anche possibile impostare una tolleranza di snapping per singolo layer scegliendo la voce di menu \emph{Impostazioni \(\rightarrow\)} (oppure \emph{File \(\rightarrow\)}) \emph{Opzioni si snap...} (figura {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:figure-edit-1]{figure\_edit\_1}} ).

\end{enumerate}

Da notare che la tolleranza di snap per un singolo layer sovrascrive la tolleranza globale impostata nella scheda Digitalizzazione. Se è necessario modificare un layer ed impostare lo snap per i suoi vertici, allora abilitare la tolleranza di snap solamente sul layer richiesto. Diminuire la tolleranza di snap globale a un livello più basso ed assicurarsi che sia selezionatala casella di controllo per il layer.
\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{Raggio di ricerca}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:search-radius}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-2}
Il raggio di ricerca è la distanza che QGIS usa per \code{cercare} il vertice più vicino che si sta provando a spostare quando si clicca nella mappa. Se non si è entro il raggio di ricerca, QGIS non troverà né selezionerà alcun vertice e mostrerà un avvertimento in una finestra pop-up. La tolleranza di snapping e il raggio di ricerca sono impostati in unità di mappa o in pixel e potrebbe essere necessario fare diversi tentativi prima di trovare l’impostazione migliore. Se si specifica una tolleranza troppo alta, QGIS potrebbe agganciare il vertice sbagliato, specialmente se si ha a che fare con molti vertici vicini all’area in cui si sta effettuando la modifica. Impostando invece un raggio di ricerca troppo piccolo impedirà a QGIS di trovare alcuna geometria da spostare.

Il raggio di ricerca per la modifica di vertici può essere definito in unità del layer dalla scheda \emph{Digitalizzazione} sotto il menu \emph{Impostazioni \(\rightarrow\)} \includegraphics[width=1em]{mActionOptions.png} \emph{Opzioni}, sotto lo stesso percorso dal quale è possibile impostare la tolleranza di snapping a livello di progetto.

\index{Zoom\_In Zoom\_Out}\index{Pan}\index{Map\_Navigation}

\subsection{Zoom e spostamento}
\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}
Prima di editare un layer sarebbe opportuno ingrandire la vista mappa su un’area di interesse, al fine di evitare una lunga attesa per la visualizzazione di tutti i vertici della mappa.

Oltre ad utilizzare le icone \includegraphics[width=1.5em]{mActionPan.png} $^{\text{Sposta mappa}}$ e \includegraphics[width=1.5em]{mActionZoomIn.png} $^{\text{Ingrandisci}}$ /  \includegraphics[width=1.5em]{mActionZoomOut.png} $^{\text{Rimpicciolisci}}$ è possibile interagire con la mappa con la rotellina del mouse, la barra spaziatrice e i tasti freccia della tastiera.


\subsubsection{Zoom e spostamento con la rotella del mouse}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:zooming-and-panning-with-the-mouse-wheel}
Per spostarsi nella mappa cliccare sulla rotella del mouse e trascinare, mentre per lo zoom basta ruotare la stessa. Posizionare il cursore nell’area di mappa e ruotare la rotellina verso di sé per ridurre e verso lo schermo per ingrandire. La posizione del puntatore del mouse determinerà il centro dell’area da ingrandire. È possibile personalizzare il comportamento della rotella del mouse nella scheda \emph{Strumenti mappa} alla voce di menu \emph{Impostazioni \(\rightarrow\)} \includegraphics[width=1em]{mActionOptions.png} \emph{Opzioni}.


\subsubsection{Spostamento con i tasti freccia}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:panning-with-the-arrow-keys}
È possibile spostare la vista mappa anche con i tasti freccia della tastiera. Posizionare il mouse nella vista mappa e cliccare la freccia destra per spostarsi verso est, la freccia sinistra per spostarsi verso ovest, la freccia in su per spostarsi verso nord e la freccia in giù per spostarsi verso sud.

È anche possibile tenere premuta la barra spaziatrice mentre si sposta il mouse per spostare la vista mappa e usare i tasti \code{PgUp} e \code{PgDown} per aumentare o ridurre l’ingrandimento senza interrompere la sessione di digitalizzazione.

\index{Topological\_Editing}

\subsection{Modifiche topologiche}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-4}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:topological-editing}
Oltre alle opzioni di snap a livello di singolo layer, la finestra di dialogo \emph{Opzioni di snap...} permette di impostare altre funzionalità topologiche. È possibile selezionare le opzioni \includegraphics{checkbox.png} \emph{Abilita la modifica topologica} e/o \includegraphics{checkbox.png} \emph{Evita inters.}: quest’ultima evita l’intersezione di nuovi poligoni.

\index{Shared\_Polygon\_Boundaries}

\subsubsection{Abilitare la modifica topologica}
\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'opzione \includegraphics{checkbox.png} \emph{Abilita la modifica topologica} serve a mantenere bordi comuni tra poligoni adiacenti durante l’editazione. QGIS individua un bordo condiviso in un insieme di poligoni e tutto ciò che si deve fare è spostare il vertice una volta sola: QGIS si occuperà di aggiornare i bordi di poligoni adiacenti.

\index{Avoid\_Intersections\_Of\_Polygons}

\subsubsection{Evitare le intersezioni per i nuovi poligoni}
\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}
L'opzione \includegraphics{checkbox.png} \emph{Evita inters.} impedisce l’intersezione di poligoni adiacenti, rendendone più spedita la digitalizzazione. Se si ha già un poligono, è possibile con questa opzione abilitata, digitalizzare un secondo poligono in modo che entrambi si intersechino; QGIS taglierà automaticamente il secondo lungo il bordo comune, con il vantaggio che l’utente non deve digitalizzare tutti i vertici coincidenti.

\index{Digitizing}

\subsection{Modifica di un layer esistente}
\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}
Al fine di evitare modifiche involontarie, i dati sono caricati in QGIS in modalità solo lettura. Comunque, è sempre possibile modificare un layer se ciò è consentito dallo specifico fornitore di dati e se il dato medesimo è anche scrivibile (ovvero i file non sono in modalità sola lettura). Le funzioni di modifica di layer sono più versatili quando sono applicate a dati immagazzinati in database PostgreSQL/PostGIS.

In QGIS sono presenti due barre strumenti distinte per la modifica dei vettori, una di base e l’altra avanzata, quest’ultima descritta nella Sezione {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-advanced-edit]{\emph{Digitalizzazione avanzata}}}. Entrambe le barre possono essere attivate/disattivate sotto \emph{Visualizza \(\rightarrow\) Barra degli strumenti \(\rightarrow\)}. Gli strumenti di base offrono le seguenti funzionalità:
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:table-editing}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Icona
} & \textsf{\relax 
Azione
} & \textsf{\relax 
Icona
} & \textsf{\relax 
Azione
}\\
\hline
\includegraphics[width=1.5em]{mActionToggleEditing.png}
 & 
Attiva modifica
 & 
\includegraphics[width=1.5em]{mActionCapturePoint.png}
 & 
Aggiunge elementi: Inserisci punto
\\

\includegraphics[width=1.5em]{mActionCaptureLine.png}
 & 
Aggiunge elementi: Inserisci linea
 & 
\includegraphics[width=1.5em]{mActionCapturePolygon.png}
 & 
Aggiunge elementi: Inserisci poligono
\\

\includegraphics[width=1.5em]{mActionMoveFeature.png}
 & 
Muove elementi
 & 
\includegraphics[width=1.5em]{mActionNodeTool.png}
 & 
Strumento vertici
\\

\includegraphics[width=1.5em]{mActionDeleteSelected.png}
 & 
Elimina elementi selezionati
 & 
\includegraphics[width=1.5em]{mActionEditCut.png}
 & 
Taglia elementi
\\

\includegraphics[width=1.5em]{mActionEditCopy.png}
 & 
Copia elementi
 & 
\includegraphics[width=1.5em]{mActionEditPaste.png}
 & 
Incolla elementi
\\

\includegraphics[width=1.5em]{mActionFileSave.png}
 & 
Salva modifiche
 &  & \\
\hline\end{tabulary}

\begin{quote}

Strumenti di base per la modifica di layer vettoriali
\end{quote}

Ogni sessione di modifica è inizializzata dall’opzione \includegraphics[width=1.5em]{mActionToggleEditing.png} $^{\text{Modifica}}$, che può essere attivata e disattivata nel menù contestuale che si apre cliccando con il tasto destro del mouse sul nome del layer nella legenda.

In alternativa, è possibile usare il pulsante  \index{Modifica}Modifica \includegraphics[width=1.5em]{mActionToggleEditing.png} $^{\text{Modifica}}$. Quando il layer è in modalità modifica, i vertici In alternativa, è possibile usare il pulsante sono contrassegnati da indicatori (croci o cerchi semitrasparenti) e altri strumenti sono attivati nella barra degli strumenti di modifica.
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:tip-save-regularly}
\begin{notice}{tip}{Suggerimento:}
\textbf{Salvataggio ad intervalli regolari}

Ricordarsi di usare \includegraphics[width=1.5em]{mActionFileSave.png} $^{\text{Salva modifiche}}$ regolarmente, in modo da consentire il salvataggio delle modifiche recenti e per verificare che le stesse siano accettate dalla fonte di dati.
\end{notice}


\subsubsection{Aggiungere elementi}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:adding-features}
È possibile usare gli strumenti \includegraphics[width=1.5em]{mActionCapturePoint.png} $^{\text{Inserisci punto}}$, \includegraphics[width=1.5em]{mActionCaptureLine.png} $^{\text{Inserisci linea}}$ o \includegraphics[width=1.5em]{mActionCapturePolygon.png} $^{\text{Inserisci poligono}}$ per porre il puntatore di QGIS in modalità digitalizzazione.

Per ogni elemento, bisogna dapprima digitalizzare la geometria e successivamente inserire gli attributi. Per digitalizzare la geometria, cliccare con il tasto sinistro del mouse nella vista mappa per creare il primo punto del nuovo elemento.

Per linee e poligoni, continuare a cliccare con il tasto sinistro per ogni ulteriore vertice che si desidera inserire. Quando è terminato l’inserimento dei vertici o dei punti, cliccare con il tasto destro in qualunque punto della mappa per confermare di aver terminato l’inserimento della geometria dell’elemento.

Apparirà quindi la finestra degli attributi che consentirà di inserire le informazioni per l’elemento appena creato (figura {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:figure-edit-2]{Figure\_edit\_2}}). Nella scheda \emph{Digitalizzazione} della voce di menu \emph{Impostazioni \(\rightarrow\) Opzioni} è possibile attivare/disattivare le due opzioni \includegraphics{checkbox.png} \emph{Non aprire la finestra degli attributi dopo la creazione di ogni geometria} \includegraphics{checkbox.png} \emph{Ripeti i valori degli attributi usati per ultimi}.
\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}

Per spostare degli elementi utilizzare lo strumento \includegraphics[width=1.5em]{mActionMoveFeature.png} $^{\text{Muovi elemento/i}}$.
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:tip-attributes-types}
\begin{notice}{tip}{Suggerimento:}
\textbf{Tipologie di attributo}

Relativamente agli shapefile, la modifica del tipo di attributo è validata durante l’inserimento, per cui non è ovviamente possibile inserire un numero in una colonna testuale quando compare la finestra di dialogo \emph{Attributi} e viceversa. Qualora si avesse tale necessità, è necessario modificare gli attributi in un secondo momento per mezzo della finestra di dialogo  \emph{Tabella degli attributi}.
\end{notice}

\index{Node\_Tool}

\subsubsection{Strumento vertici}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-9}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:node-tool}
Sia per i layer PostgreSQL/PostGIS che per gli shapefile, lo \includegraphics[width=1.5em]{mActionNodeTool.png} $^{\text{Strumento vertici}}$ fornisce capacità di modifica dei vertici simili ai programmi CAD. È possibile selezionare più vertici contemporaneamente e spostarli e/o cancellarli con un’unica operazione. Lo strumento supporta la modifica topologica e lavora anche con la proiezione al volo attiva; se non trova nessun elemento apre una finestra di avviso che suggerisce di controllare le impostazioni di snapping.

Pertanto, è importante impostare \emph{Impostazioni \(\rightarrow\)} \includegraphics[width=1em]{mActionOptions.png} \emph{Opzioni \(\rightarrow\) Digitalizzazione \(\rightarrow\)} \emph{Raggio di ricerca:} \includegraphics{selectnumber.png} ad un valore superiore a zero (per esempio 10). Altrimenti QGIS non è in grado di gestire adeguatemente la modifica dei vertici.
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:tip-vertex-markers}
\begin{notice}{tip}{Suggerimento:}
\textbf{Indicatori dei vertici}

The current version of QGIS supports three kinds of vertex-markers:
Semi transparent circle, Cross and None. To change the marker style,
choose \includegraphics[width=1em]{mActionOptions.png} \emph{Options} from the
\emph{Settings} menu and click on the \emph{Digitizing}
tab and select the appropriate entry.
\end{notice}


\subsubsection{Operazioni di base}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:basic-operations}
\index{Nodes}\index{Vertices}\index{Vertex}
Attivare lo strumento \includegraphics[width=1.5em]{mActionNodeTool.png} $^{\text{Strumento vertici}}$ e selezionare un elemento cliccandoci sopra: un riquadro rosso apparirà su ogni vertice dell’elemento.
\begin{itemize}
\item {} 
\textbf{Selecting vertices}: You can select vertices by clicking on them one
at a time, by clicking on an edge to select the vertices at both ends, or
by clicking and dragging a rectangle around some vertices. When a vertex
is selected its color changes to blue. To add more vertices to the current
selection, hold down the \code{Ctrl} key while clicking. Hold down
\code{Ctrl} or \code{Shift} when clicking to toggle the selection state of
vertices (vertices that are currently unselected will be selected as usual,
but also vertices that are already selected will become unselected).

\item {} 
\textbf{Aggiungere vertici}: per aggiungere un vertice fare doppio click nei pressi di un bordo. Si noti che il vertice apparirà sul bordo e non alla posizione del cursore del mouse.

\item {} 
\textbf{Eliminare vertici}: per eliminare un vertice selezionato basta premere il tasto \code{Delete}. Si noti che non è possibile eliminare un intero elemento tramite lo strumento \includegraphics[width=1.5em]{mActionNodeTool.png} $^{\text{Strumento vertici}}$; QGIS manterrà un numero minimo di vertici per il tipo di elemento su cui si sta lavorando. Per eliminare completamente un elemento, usare lo strumento \includegraphics[width=1.5em]{mActionDeleteSelected.png} $^{\text{Elimina il selezionato}}$.

\item {} 
\textbf{Spostare vertici}: selezionare i vertici di interesse, quindi cliccare e trascinare nella direzione verso la quale si intende spostare i vertici; i vertici saranno spostati tutti insieme. Se lo snap è attivo, l’intera selezionare può essere agganciata al vertice e/o linea più vicina.

\end{itemize}

Ogni cambiamento operato con lo strumento vertici è memorizzato nel dialogo Annulla. Tutte le operazioni supportano le modifiche topologiche (se attivate) ed è possibile operare con la proiezione a volo attiva. Lo strumento vertici offre, inoltre, la possibilità di ottenere informazioni su un vertice lasciando semplicemente il cursore del mouse sul vertice di interesse.


\subsubsection{Tagliare, copiare ed incollare elementi}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:cutting-copying-and-pasting-features}
Gli elementi selezionati possono essere tagliati, copiati ed incollati tra layer dello stesso progetto di QGIS a patto che anche per il layer di destinazione sia stata abilitata la modalità di modifica tramite l’opzione \includegraphics[width=1.5em]{mActionToggleEditing.png} $^{\text{Modifica}}$.

\index{CSV}\index{WKT}
Gli elementi possono essere anche incollati in applicazioni esterne in formato testo: gli elementi verranno rappresentati nel formato CSV con le informazioni della geometria espresse nel formato testo OGC Well Known Text (WKT).

Le funzioni di copia/incolla sono utili quando si devono modificare più layer copiando le modifiche effettuate in uno di questi negli altri. Supponendo, ad esempio, di voler lavorare su un layer contenente solo alcuni laghi, diventa molto più agevole creare un nuovo layer vuoto nel quale incollare gli elementi dei quali necessitiamo invece di lavorare sul layer \code{big\_lakes} contenente 5000 elementi.

Dovremo quindi effettuare le seguenti operazioni:
\begin{enumerate}
\item {} 
Caricare il layer dal quale vogliamo copiare gli elementi (layer sorgente)

\item {} 
Caricare o creare il layer nel quale vogliamo incollare gli elementi copiati (layer di destinazione)

\item {} 
Impostare entrambi i layer in modalità modifica

\item {} 
Rendere attivo il layer sorgente cliccando sul relativo nome nella legenda

\item {} 
Attivare lo strumento \includegraphics[width=1.5em]{mActionSelect.png} $^{\text{Seleziona il singolo elemento}}$ per selezionare gli elementi dal layer sorgente

\item {} 
Cliccare sullo stumento \includegraphics[width=1.5em]{mActionEditCopy.png} $^{\text{Copia elementi}}$

\item {} 
Rendere attivo il layer di destinazione cliccando sul relativo nome nella legenda

\item {} 
Attivare lo strumento \includegraphics[width=1.5em]{mActionEditPaste.png} $^{\text{Incolla elementi}}$

\item {} 
Terminare le modifiche e salvare

\end{enumerate}

Se il layer sorgente e quello di destinazione hanno un diverso schema (nomi e tipi dei campi) QGIS popola, se presenti, i campi comuni e ignora il resto. Se non è importante che vengano copiati anche gli attributi nel layer di destinazione, si può non prestare attenzione a come viene definito lo schema della tabella attributi, altrimenti è necessario definirlo in modo che lo schema del layer sorgente e quello del layer di destinazione combacino.
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:tip-projections-and-pasting}
\begin{notice}{tip}{Suggerimento:}
\textbf{Congruenza degli elementi incollati}

Se il layer sorgente e quello di destinazione usano lo stesso sistema di proiezione, gli elementi incollati saranno assolutamente identici a quelli del layer di origine. Nel caso in cui invece la proiezione del layer di destinazione sia differente QGIS non garantisce che la geometria sia identica a causa del pur ridotto errore di arrotondamento introdotto nel passaggio da un sistema di proiezione all’altro.
\end{notice}


\subsubsection{Cancellare elementi selezionati}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:deleting-selected-features}
Se si vuole eliminare un intero poligono, è possibile farlo selezionando dapprima l’elemento che intendiamo cancellare con lo strumento \includegraphics[width=1.5em]{mActionSelect.png} $^{\text{Seleziona il singolo elemento}}$: è possibile anche selezionare più poligoni contemporaneamente. Una volta definita la selezione, usare lo strumento \includegraphics[width=1.5em]{mActionDeleteSelected.png} $^{\text{Elimina il selezionato}}$ per cancellare la selezione.

Anche lo strumento \includegraphics[width=1.5em]{mActionEditCut.png} $^{\text{Taglia geometrie}}$ può essere usato per eliminare elementi: tali elementi vengono spostati in un blocco appunti spaziale. In questo modo è possibile annullare l’operazione incollando nuovamente gli elementi tagliati con lo strumento \includegraphics[width=1.5em]{mActionEditPaste.png} $^{\text{Incolla elementi}}$,  fornendo in ultima analisi almeno un livello di annullamento. Gli strumenti taglia, copia e incolla lavorano sugli elementi selezionati, consentendo quindi di lavorare su più di un elemento alla volta.
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:tip-deleting-features}
\begin{notice}{tip}{Suggerimento:}
\textbf{Supporto alla cancellazione di elementi}

Quando si modificano shapefile, la cancellazione di elementi funziona solo se QGIS è compilato con una versione di GDAL pari a 1.3.2 o superiore, come accade per le versioni compilate per OS X e Windows disponibili sul sito.
\end{notice}


\subsubsection{Salvare i layer modificati}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:saving-edited-layers}
When a layer is in editing mode, any changes remain in the memory of QGIS.
Therefore they are not committed/saved immediately to the data source or disk.
If you want to save edits to the current layer but want to continue editing
without leaving the editing mode, you can click the \includegraphics[width=1.5em]{mActionFileSave.png}
$^{\text{Save Edits}}$ button. When you turn editing mode off with the
\includegraphics[width=1.5em]{mActionToggleEditing.png} $^{\text{Toggle editing}}$ (or quit QGIS for that matter),
you are also asked if you want to save your changes or discard them.

Se le modifiche non possono essere salvate (ad es. perché il disco di destinazione è pieno o gli attributi contengono valori esterni agli estremi ammissibili), lo stato della memoria di QGIS è preservato, consentendo dunque di correggere gli errori e riprovare il salvataggio.
\phantomsection\label{docs/user_manual/working_with_vector/editing_geometry_attributes:tip-data-integrity}
\begin{notice}{tip}{Suggerimento:}
\textbf{Integrità dei dati}

È buona norma fare un back-up del dato originale prima di procedere alla modifica. Per quando siano stati fatti molti sforzi da parte dei programmatori di QGIS per preservare l’integrità del dato, non vi è alcuna garanzia che ciò avvenga.
\end{notice}


\subsection{Digitalizzazione avanzata}
\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 
Icona
} & \textsf{\relax 
Azione
} & \textsf{\relax 
Icona
} & \textsf{\relax 
Azione
}\\
\hline
\includegraphics[width=1.5em]{mActionUndo.png}
 & 
Annulla
 & 
\includegraphics[width=1.5em]{mActionRedo.png}
 & 
Ripristina
\\

\includegraphics[width=2em]{mActionSimplify.png}
 & 
Semplifica geometrie
 & 
\includegraphics[width=2em]{mActionAddRing.png}
 & 
Aggiungi buco
\\

\includegraphics[width=2em]{mActionAddIsland.png}
 & 
Aggiungi una parte
 & 
\includegraphics[width=2em]{mActionDeleteRing.png}
 & 
Elimina buco
\\

\includegraphics[width=2em]{mActionDeletePart.png}
 & 
Elimina parte
 & 
\includegraphics[width=1.5em]{mActionReshape.png}
 & 
Modifica la forma
\\

\includegraphics[width=1.5em]{mActionOffsetCurve.png}
 & 
Curva di offset
 & 
\includegraphics[width=1.5em]{mActionSplitFeatures.png}
 & 
Spezza elemento
\\

\includegraphics[width=1.5em]{mActionMergeFeatures.png}
 & 
Unisci le geometrie selezionate
 & 
\includegraphics[width=1.5em]{mActionRotatePointSymbols.png}
 & 
Ruota i simboli per i punti
\\

\includegraphics[width=1.5em]{mActionMergeFeatures.png}
 & 
Unisci gli sttributi delle geometrie selezionate
 &  & \\
\hline\end{tabulary}

\begin{quote}

Barra degli strumenti di digitalizzazione avanzata
\end{quote}


\subsubsection{Annullare e rispristinare}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:undo-and-redo}
Gli strumeti \includegraphics[width=1.5em]{mActionUndo.png} $^{\text{Annulla}}$ e \includegraphics[width=1.5em]{mActionRedo.png} $^{\text{Ripristina}}$ permettono di annullare/ripristinare le modifiche ad un layer vettoriale. Inoltre, è disponibile un widget che memorizza e mostra tutte le operazioni annulla/ripristina (Figura {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:figure-edit-3]{Figure\_edit\_3}}). Per attivare il widget cliccare con il tasto destro del mouse sulla barra degli strumenti ed attivare la casella di controllo Annulla/Ripristina. Annulla/Ripristina è comunque attivo, anche se il widget non è visibile.
\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}

Cliccando su Annulla, tutti gli elementi e gli attributi vengono riportati al loro stato precedente. Le modifiche effettuate con strumenti diversi da quelli per la digitalizzazione (es. un plugin), potrebbero non essere annullabili.

Se nel widget Annulla/Ripristina si clicca su una determinata operazione, tutti gli elementi saranno riportati allo stato successivo all’operazione selezionata.


\subsubsection{Semplifica geometrie}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:simplify-feature}
Lo strumento \includegraphics[width=2em]{mActionSimplify.png} $^{\text{Semplifica geometrie}}$ permette di ridurre il numero di vertici di un elemento, preservandone la geometria: un elemento selezionato con lo strumento sarà evidenziato da una linea di semplificazione rossa, inoltre verrà mostrato a schermo un cursore (Tolleranza linea di semplificazione). Muovendo il cursore, la linea di semplificazione cambia e mostra la forma che assumerà l’elemento che si sta semplificando. Per memorizzare la geometria semplificata, cliccare su \textbf{{[}OK{]}} . Se una geometria non può essere semplificata (come nel caso di un multi-poligono), verrà mostrato un messaggio di errore.


\subsubsection{Aggiungi buco}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:add-ring}
Si possono digitalizzare nuovi poligoni all’interno di poligoni esistenti, al fine di creare un buco all’interno di questi ultimi, scegliendo lo strumento \includegraphics[width=2em]{mActionAddRing.png} $^{\text{Aggiungi buco}}$. In questo modo solo l’area compresa tra i bordi del poligono interno e di quello esterno verrà evidenziata come poligono ad anello.


\subsubsection{Aggiungi una parte}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:add-part}
Lo strumento \includegraphics[width=2em]{mActionAddIsland.png} $^{\text{Aggiungi una parte}}$ permette di aggiungere una parte ad un multi-poligono; la nuova parte va digitalizzata all’esterno del poligono selezionato.


\subsubsection{Elimina buco}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:delete-ring}
Lo strumento \includegraphics[width=2em]{mActionDeleteRing.png} $^{\text{Elimina buco}}$ permette di eliminare un buco all’interno di un poligono. Lo strumento funziona esclusivamente con layer di poligoni. Nessuna azione viene effettuata se lo strumento viene usato sul bordo esterno di un poligono. Prima di selezionare i vertici di un buco, impostare adeguatamente la tolleranza.


\subsubsection{Elimina parte}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:delete-part}
Lo strumento \includegraphics[width=2em]{mActionDeletePart.png} $^{\text{Elimina parte}}$ permette di eliminare parti da geometrie multi-parte (multi-punto, multilinea, multi-poligono); lo strumento non ha effetto sull’ultima parte aggiunta. Prima di selezionare i vertici di una parte, impostare adeguatamente la tolleranza.


\subsubsection{Modifica la forma}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:reshape-features}
Lo strumento \includegraphics[width=1.5em]{mActionReshape.png} $^{\text{Modifica forma}}$ permette di modificare la forma di elementi a geometria lineare e poligonale tracciando una nuova linea: la porzione di elemento tra i due punti di intersezione con la nuova linea sarà rimpiazzata dalla forma di quest’ultima. Prestare particolare attenzione ad utilizzare lo strumento con i poligoni: limitarsi a piccole porzioni di poligono. La nuova forma non può intersecare più buchi, altrimenti si generano poligoni non validi.

Per modificare, ad esempio, il bordo di un poligono basta cliccare un primo punto all’interno del poligono, cliccare un secondo punto all’esterno del poligono, tracciare il profilo della nuova forma, rientrare nel poligono e cliccare con il tasto destro del mouse per terminare l’operazione. Lo strumento aggiungerà automaticamente nuovi nodi laddove la nuova linea interseca il bordo del poligono. È, inoltre, possibile rimuovere parte di un poligono iniziando la nuova linea all’esterno del poligono, aggiungendo vertici all’interno e terminando la linea all’esterno con il tasto destro del mouse.

\begin{notice}{note}{Nota:}
Lo strumento potrebbe alterare la posizione iniziale di un poligono o di una linea chiusa, per cui nodo iniziale e nodo finale potrebbero non coincidere. Per molte applicazioni tale fatto non è un problema rilevante, ma è opportuno tenerne conto.
\end{notice}


\subsubsection{Dividere elementi}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:offset-curves}
Il nuovo strumento di digitalizzazione \includegraphics[width=1.5em]{mActionOffsetCurve.png} $^{\text{Curva di offset}}$ sposta parallelamente linee e buchi di poligoni. Lo strumento può essere utilizzato sia per modificare il layer che per effettuare modifiche di sfondo (vengono create cosi delle copie delle linee / anelli che vengono aggiunte al layer modificato). E' ideale per creare linee di distanza: la misura dello spostamento compare nella parte bassa dello schermo.

\index{Split\_Features}

\subsubsection{Spezza elemento}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:index-14}\label{docs/user_manual/working_with_vector/editing_geometry_attributes:split-features}
È possibile dividere degli elementi tramite lo strumento \includegraphics[width=1.5em]{mActionSplitFeatures.png} $^{\text{Spezza elemento}}$ e tracciando una linea attraverso l’elemento di interesse.

\index{Merge\_Selected\_Features}

\subsubsection{Unire elementi}
\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}
Lo strumento \includegraphics[width=1.5em]{mActionMergeFeatures.png} $^{\text{Unisci le geometri selezionate}}$ permette di unire elementi con bordi condivisi e stessi attributi.

\index{Merge\_Attributes\_of\_Selected\_Features}

\subsubsection{Unire attributi di elementi}
\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}
Lo strumento \includegraphics[width=1.5em]{mActionMergeFeatures.png} $^{\text{Unisci gli attributi degli elementi selezionati}}$ permette di unire gli attributi di elementi con bordi condivisi e stessi attributi senza però, unirne i bordi.

\index{Rotate\_Point\_symbols}

\subsubsection{Ruota i simboli per i punti}
\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}
Attualmente lo strumento \includegraphics[width=1.5em]{mActionRotatePointSymbols.png} $^{\text{Ruota i simboli per i punti}}$ è supportato dalla sola simbologia di vecchia generazione. Esso permette di cambiare la rotazione di un simbolo per punti qualora sia stata definita una colonna rotazione nella tabella degli attributi di un layer puntuale (scheda \emph{Stile} della finestra di dialogo \emph{Proprietà layer}. In caso contrario lo strumento non è attivo.
\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}

Per modificare la rotazione, selezionare un elemento puntuale nella vista mappa e ruotarlo tenendo premuto il tasto sinistro del mouse; apparirà una freccia rossa ed il valore di rotazione (Figura  {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:figure-edit-4]{Figure\_edit\_4}}). Al termine dell’operazione, il valore di rotazione nella tabella degli attributi sarà aggiornato di conseguenza.

\begin{notice}{note}{Nota:}
Se si tiene premuto il tasto \code{Ctrl}, la rotazione avverrà per step di 15 gradi.
\end{notice}

\index{Create\_New\_Layers}\index{New\_Shapefile\_Layer}

\subsection{Creare nuovi layer vettoriali}
\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 permette di creare shapefile e layer SpatiaLite. La creazione di layer GRASS è supportata dal plugin di GRASS. Per ulteriori informazioni sulla creazione di layer GRASS fare riferimento alla sezione {\hyperref[docs/user_manual/grass_integration/grass_integration:creating-new-grass-vectors]{\emph{Creare un nuovo layer vettoriale GRASS}}}.


\subsubsection{Creare un nuovo Shapefile}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:creating-a-new-shapefile-layer}
Per creare un nuovo layer shapefile selezionare \emph{Nuovo \(\rightarrow\)} \includegraphics[width=1.5em]{mActionNewVectorLayer.png} \emph{Nuovo layer shapefile...} dal menu \emph{Layer}. Apparirà la finestra di dialoto \emph{Nuovo vettore} mostrata in figura {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:figure-edit-5]{Figure\_edit\_5}}. Scegliere il tipo di geometria (Punto, Linea o Poligono) ed il sistema di riferimento (SR).

Si noti che QGIS non supporta la creazione di elementi 2.5D (ad es. elementi con coordinate XYZ) o il conteggio degli elementi.
\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}

Per completare la creazione del nuovo layer shapefile vanno specificati gli attributi, definendone nome e tipo e cliccando su \textbf{{[}Aggiungi alla lista degli attributi{]}}. La colonna ’id’ è aggiunta automaticamente da QGIS, ma può essere eliminata. Allo stato attuale sono supportati solo attributi  \emph{Tipo: Numeri decimali} \includegraphics{selectstring.png}, \emph{Type: Numeri interi} \includegraphics{selectstring.png}, e \emph{Type: Testo} \includegraphics{selectstring.png} . in funzione del tipo di attributo è possibile definire larghezza e precisione. Una volta definiti gli attributi, cliccare su \textbf{{[}OK{]}} e assegnare un nome allo shapefile. QGIS aggiungerà automaticamente l’estensione .shp al nome indicato. Una volta creato il layer, lo stesso sarà aggiunto alla vista mappa e potrà essere modificato come descritto alla precedente Sezione {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-edit-existing-layer]{\emph{Modifica di un layer esistente}}}.

\index{New\_Spatialite\_Layer}

\subsubsection{Creare un nuovo layer 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}
Per creare un nuovo layer spatialite selezionare \emph{Nuovo \(\rightarrow\)} \includegraphics[width=1.5em]{mActionNewVectorLayer.png} \emph{Nuovo layer SpatiaLite...} dal menu \emph{Layer}.Apparirà la finestra di dialogo \emph{Nuovo layer SpatiaLite} mostrata in figura {\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}

Selezionare un database Spatialite esistente o crearne uno nuovo tramite il pulsante \includegraphics{browsebutton.png} alla destra del campo ’Database’. Indicare un nome per il nuovo layer, definire il tipo di layer ed il sistema di riferimento (EPSG SRID). Se richiesto, è possibile creare una chiave primaria autoincrementale selezionando \includegraphics{checkbox.png} \emph{Crea una chiave primaria autoincrementale}.

Per definire la tabella degli attributi del nuovo layer, indicare nome e tipo dell’attributo desiderato e cliccare su \textbf{{[}Aggiungi alla tabella degli attributi{]}} quindi cliccare su \textbf{{[}OK{]}}. Una volta creato
il layer, lo stesso sarà aggiunto alla vista mappa e potrà essere modificato come descritto alla precedente sezione {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-edit-existing-layer]{\emph{Modifica di un layer esistente}}}.

I layer Spatialite possono essere gestiti attraverso DB Manager, vedi sezione {\hyperref[docs/user_manual/plugins/plugins_db_manager:dbmanager]{\emph{Plugin DB Manager}}}.

\index{Work\_with\_Attribute\_Table}

\subsection{Lavorare con la tabella degli attributi}
\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 tabella degli attributi mostra gli elementi di un layer. Ogni riga nella tabella rappresenta un elemento ed ogni colonna un attributo. Gli elementi possono essere cercati, selezionati, spostati e modificati.

Per aprire la tabella degli attributi di un layer vettoriale, rendere attivo il layer e selezionare l’opzione \includegraphics[width=1.5em]{mActionOpenTable.png} \emph{Apri tabella attributi} dal menu \emph{Layer}. Lo stesso risultato si ottiene cliccando con il tasto destro del mouse soprail layer in legenda e selezionando \includegraphics[width=1.5em]{mActionOpenTable.png} \emph{Apri tabella degli attributi} dal menu contestuale.

Si aprirà la finestra di dialogo mostrata in Figura {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:figure-attributes-1]{figure\_attributes\_1}}: il titolo della finestra, inoltre, mostra il numero di elementi selezionati sul totale degli elementi del layer.
\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{Selezionare elementi nella tabella degli attributi}
\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{Ogni riga selezionata} nella tabella degli attributi mostra gli attributi di un elemento selezionato nel layer. Se l’insieme di elementi selezionati nella vista mappa viene modificato, la selezione viene aggiornata anche nella tabella e viceversa. Allo stesso modo, se cambia l'insieme delle righe selezionate nella tabella degli attributi, cambierà anche la visualizzazione degli elementi nella vista mappa.

Le righe possono essere selezionate cliccando sul numero alla loro sinistra. Si possono selezionare \textbf{righe multiple} tenendo premuto il tasto \code{Ctrl}. È possibile selezionare un \textbf{sottoinsieme di righe} tenendo premuto \code{Shift} e cliccando sulle due righe che delimitano il sottoinsieme di interesse. Spostare il cursore del mouse e cliccare nelle celle della tabella non modifica la selezione. Cambiare la selezione della vista mappa non modifica la posizione del cursore nella tabella.

Le righe della tabella possono essere ordinate in funzione degli attributi. Cliccare sull’intestazione dell’attributo rispetto al quale si intende ordinare la tabella: una piccola freccia a destra del nome dell’attributo indicherà il verso dell’ordinamento (freccia in su per ordinamento crescente, freccia in giù per ordinamento decrescente).

Per effettuare una \textbf{ricerca per attributo} su un solo attributo, selezionare la colonna di interesse dal menu a cascata a sinistra del pulsante \emph{Cerca}, inserire il testo da ricercare nella casella e cliccare su \textbf{{[}Cerca {]}}. Le righe che soddisfano la stringa di ricerca saranno selezionate, mentre il numero totale di righe trovate apparirà nella barra del titolo della tabella degli attributi e nella barra di stato della finestra principale. Per la ricerca avanzata cliccare su Ricerca avanzata {\color{red}\bfseries{}\textbar{}}browsebutton : il pulsante aprirà il Costruttore di interrogazioni descritto nella sezione {\hyperref[docs/user_manual/working_with_vector/query_builder:vector-query-builder]{\emph{Costruttore di interrogazioni}}}.

Per visualizzare solo le righe selezionate usare l’opzione \includegraphics{checkbox.png} \emph{Mostra solo i selezionati}. Per ricercare solo nelle righe selezionate usare l'opzione \includegraphics{checkbox.png} \emph{Cerca solo i selezionati}. La casella di controllo \includegraphics{checkbox.png} \emph{Maiusc/minusc} abilita la ricerca sensibile al carattere. Gli altri pulsanti, in basso a sinistra, hanno le seguenti funzionalità:
\begin{itemize}
\item {} 
\includegraphics[width=1.5em]{mActionOpenTable.png} $^{\text{Unselect all}}$ anche con \code{Ctrl+U}

\item {} 
\includegraphics[width=1.5em]{mActionSelectedToTop.png} $^{\text{Muovi selezione in alto}}$ anche con \code{Ctrl+T}

\item {} 
\includegraphics[width=1.5em]{mActionInvertSelection.png} $^{\text{Inverti selezione}}$ anche con \code{Ctrl+S}

\item {} 
\includegraphics[width=1.5em]{mActionCopySelected.png} $^{\text{Copia le righe selezionate nel blocco appunti}}$ anche con \code{Ctrl+C}

\item {} 
\includegraphics[width=1.5em]{mActionZoomToSelected.png} $^{\text{Zoom mappa alle righe selezionate}}$ anche con \code{Ctrl+J}

\item {} 
\includegraphics[width=1.5em]{mActionZoomToSelected.png} $^{\text{Zoom mappa alle righe selezionate}}$ anche con \code{Ctrl+P}

\item {} 
\includegraphics[width=1.5em]{mActionToggleEditing.png} $^{\text{Modalità modifica}}$ per modificare singoli valori della tabella e per abilitare le funzionalità di seguito descritte. Anche con \code{Ctrl+E}

\item {} 
\includegraphics[width=1.5em]{mActionDeleteSelected.png} $^{\text{Elimina gli elementi selezionati}}$ anche con \code{Ctrl+D}

\item {} 
\includegraphics[width=1.5em]{mActionNewAttribute.png} $^{\text{Nuova colonna}}$ per layer PostGIS ed OGR con GDAL versione \textgreater{}= 1.6. Anche con \code{Ctrl+W}

\item {} 
\includegraphics[width=1.5em]{mActionDeleteAttribute.png} $^{\text{Elimina colonna}}$ per layer PostGIS ed OGR con GDAL versione \textgreater{}= 1.9. Anche con  \code{Ctrl+L}

\item {} 
\includegraphics[width=1.5em]{mActionCalculateField.png} $^{\text{Apri il calcolatore di campi}}$ anche con \code{Ctrl+I}

\end{itemize}

\begin{notice}{tip}{Suggerimento:}
\textbf{Geometrie WKT}

Se si desiderano visualizzare gli attributi in un programma esterno (per esempio Excel), usare il pulsante \includegraphics[width=1.5em]{mActionCopySelected.png} $^{\text{Copia le righe selezionate nel blocco appunti}}$. E' possibile copiare le informazioni senza le geometrie del layer vettoriale disattivando \emph{Impostazioni \(\rightarrow\) Opzioni \(\rightarrow\)} scheda Generale \includegraphics{checkbox.png} \emph{Copia la geometria in formato WKT dalla tabella degli attributi}.
\end{notice}


\subsubsection{Salvare elementi selezionati come nuovo layer}
\label{docs/user_manual/working_with_vector/editing_geometry_attributes:save-selected-features-as-new-layer}
Gli elementi selezionati possono essere salvati in uno dei formati vettoriali supportati da OGR, anche con sistema di riferimento diverso da quello del layer di origine. Cliccare con il tasto destro del mouse sul layer in legenda e selezionare \emph{Salva selezione con nome \(\rightarrow\)} dal menu contestuale: quindi definire il nome, il formato ed il sistema di riferimento del file di output (Sezione  {\hyperref[docs/user_manual/introduction/qgis_gui:label-legend]{\emph{Legenda}}}). È anche possibile specificare le opzioni di creazione OGR.

\index{Non\_Spatial\_Attribute\_Tables}

\subsubsection{Lavorare con tabelle di attributi non spaziali}
\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 permette di caricare tabelle di dati non spaziali nei formati supportati da OGR, dal fornitore PostgreSQL e in testo delimitato. Una volta caricata, la tabella viene elencata nella legenda e può essere aperta con \includegraphics[width=1.5em]{mActionOpenTable.png} $^{\text{Apri tabella degli attributi}}$ ed editata come qualsiasi altra tabella di layer.

Ad esempio, è possibile usare una colonna di una tabella non spaziale per definire il valore o un intervallo di valori di attributi ammissibili per un layer vettoriale durante la digitalizzazione. Per ulteriori informazioni riferirsi al widget di modifica nella Sezione {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-attributes-tab]{\emph{Scheda Campi}}}.

\index{Query\_Builder}

\section{Costruttore di interrogazioni}
\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}
Il costruttore di interrogazioni permette di definire un sottoinsieme di una tabella, tramite la clausola di condizione SQL ’WHERE’, per poi visualizzarlo nella vista mappa ed eventualmente salvarlo come nuovo shapefile.


\subsection{Interrogazione}
\label{docs/user_manual/working_with_vector/query_builder:query}
Aprire la tabella degli attributi con il pulsante \includegraphics[width=1.5em]{mActionOpenTable.png} $^{\text{Apri tabella attibuti}}$ e cliccare su \textbf{{[}Ricerca avanzata{]}} per aprire il \emph{Costruttore di interrogazioni}. Si immagini per esempio di avere il layer \code{città} con un attributo \code{popolazione} e di essre interessati all'insieme di città con una popolazione superiore a 100000 abitanti. Per ottenere tale insieme di città è sufficiente utilizzare la clausola SQL di condizione \code{popolazione \textgreater{} 100000}. La figura {\hyperref[docs/user_manual/working_with_vector/query_builder:figure-attributes-2]{Figure\_attributes\_2}} mostra un esempio del costruttore di query popolato con i dati provenienti da un layer PostGIS ed attributi memorizzati in PostgreSQL. Le sezioni Campi, Valori e Operatori aiutano nella costruzione delle clausole 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 sezione \textbf{Campi} elenca gli attributi della tabella: per aggiungere un attributo nella casella delle clausole SQL fare doppio click sullo stesso, quindi usare le altre sezioni (Valori e Operatori) per completare la clausola. In alternativa è possibile scrivere direttamente la query nella casella delle clausole.

La sezione \textbf{Valori} Per avere l’elenco di tutti i valori di un attributo, selezionare quest’ultimo nella sezione Campi e cliccare su \textbf{{[}Tutto{]}}. Per avere un elenco dei primi 25 valori univoci di un attributo, selezionare quest'ultimo nella sezione Campi e cliccare su \textbf{{[}Campione{]}}. Per aggiungere un valore nella casella delle clausole SQL fare doppio click sul suo nome nella sezione Valori.

La sezione \textbf{Operatori} elenca tutti gli operatori utilizzabili. Per aggiungere un operatore nella casella delle clausole SQL basta un click singolo. Sono disponibili operatori relazionali (\code{=}, \code{\textgreater{}}, ...), operatori per confrontare stringhe di testo (\code{LIKE}) ed operatori logici (\code{AND}, \code{OR}, ...).

Il pulsante \textbf{{[}Test{]}} mostra un messaggio contenente il numero di elementi che soddisfano la query impostata oppure un messaggio di errore se la query non è sintatticamente corretta.  Il pulsante \textbf{{[}Cancella{]}} elimina in testo inserito nella casella delle clausole SQL. I pulsanti  \textbf{{[}Salva{]}} e \textbf{{[}Carica{]}} permettono rispettivamente di salvare o caricare query SQL. Il pulsante \textbf{{[}OK{]}} chiude la finestra di dialogo e seleziona gli elementi che soddisfano la query. Il pulsante \textbf{{[}Cancellla{]}} chiude la finestra di dialogo senza modificare la selezione.
\phantomsection\label{docs/user_manual/working_with_vector/query_builder:tip-sql-layer-definition}
\begin{notice}{tip}{Suggerimento:}
\textbf{Cambiare la definizione di un layer}

È possibile cambiare la definizione di un layer tramite una query SQL. Aprire la finestra di dialogo \emph{Proprietà layer} (doppio click sul layer in legenda) a cliccare su \textbf{{[}Costruttore di interrogazioni{]}} nella scheda \emph{Generale}. Vedi la sezione {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-properties-dialog]{\emph{Proprietà dei layer vettoriali}}} per maggiori informazioni.
\end{notice}

\index{Select\_using\_Query}

\subsection{Selezione}
\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}
Con QGIS è possibile selezionare elementi per mezzo di un’interfaccia simile a quella del costruttore di interrogazioni vista in {\hyperref[docs/user_manual/working_with_vector/query_builder:vector-query-builder]{\emph{Costruttore di interrogazioni}}}. Lo scopo della selezione mediante interrogazione è di evidenziare solo gli elementi di un layer che soddisfano particolari criteri.

Un'altra possibilità è quella di selezionare un layer e facendo click con il tasto destro scegliere \emph{Interrogazione ...}. Costruendo un'interrogazione SQL in questo modo, verranno visualizzati solamente gli elementi che soddisfano i criteri di ricerca, mentre quelli che non corrispondono ai criteri di ricerca verranno nascosti dalla vista. La stessa funzione è disponibile dalla finestra di dialogo \emph{Proprietà layer}, scegliendo la scheda  \emph{Generale} e cliccando sul pulsante \textbf{{[}Costruttore interrogazioni{]}}. Questa modalità di interrogazione può essere usata con tutti i fornitori di dati vettoriali supportati.


\subsection{Salvare elementi selezionati come nuovo layer}
\label{docs/user_manual/working_with_vector/query_builder:save-selected-features-as-new-layer}
Gli elementi selezionati possono essere in uno dei formati vettoriali supportati da OGR, anche con sistema di riferimento diverso da quello del layer di origine. Cliccare con il tasto destro del mouse sul layer in legenda e selezionare \emph{Salva la selezione con nome \(\rightarrow\)} dal menu contestuale: quindi definire il nome, il formato ed il sistema di riferimento del file di output (vedi sezione {\hyperref[docs/user_manual/introduction/qgis_gui:label-legend]{\emph{Legenda}}}). È anche possibile specificare le opzioni di creazione OGR.

\index{Field\_Calculator}\index{Calculator\_Field}\index{Derived\_Fields}

\section{Calcolatore di campi}
\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}
Il pulsante \includegraphics[width=1.5em]{mActionCalculateField.png} $^{\text{Apri il calcolatore di campi}}$ presente nella tabella degli attributi permette di operare calcoli sulla base di funzioni definite e/o dei valori degli attributi esistenti, per esempio è possibile calcolare il perimetro o l'area di un poligono. Il risultato delle
operazioni può essere salvato in una nuova colonna attributo oppure essere usato per aggiornare i valori di una colonna esistente.

Per poter aprire il calcolatore di campi bisogna impostare il layer in modalità di modifica (vedi figura {\hyperref[docs/user_manual/working_with_vector/field_calculator:figure-attributes-3]{figure\_attributes\_3}}). Nella finestra di dialogo del \emph{Calcolatore di campi} è possibile scegliere se aggiornare un campo esistente, aggiornare gli elementi selezionati oppure creare un nuovo campo in cui salvare i risultati delle operazioni di calcolo.
\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}

Per aggiungere un nuovo campo bisogna indicare il nome, il tipo di campo (intero, decimale, testo) e la larghezza. Per il tipo \emph{Numero decimale} è anche possibile definire la precisione, ossia il numero di cifre dopo la virgola: ad esempio per un campo con larghezza 10 e precisione 3 si avranno 6 cifre prima della virgola, quindi la virgola ed infine 3 cifre decimali (see {\hyperref[docs/user_manual/working_with_vector/field_calculator:figure-attributes-3]{figure\_attributes\_3}}).

La \textbf{Lista delle funzioni} contiene, oltre alle funzioni, anche la lista dei campi e valori. La casella \textbf{Aiuto per la funzione scelta} fornisce una descrizione della funzione selezionata. La casella \textbf{Espressione} mostra l'espressione creata tramite la \textbf{Lista delle funzioni}. Gli operatori più comuni sono raggruppati nella sezione \textbf{Operatori}.

La sezione \emph{Campi e valori} presente nella casella \textbf{Lista delle funzioni} elenca tutti gli attributi della tabella. Per aggiungere un attributo nella casella \textbf{Espressioni} fare doppio click sullo stesso, quindi usare le altre sezioni (campi e valori, operatori e le altre funzioni) per completare l'espressione; alternativamente è possibile scriverla direttamente nella casella. Per visionare i valori di un campo è sufficiente cliccare con il tasto destro sul campo desiderato. E' possibile scegliere fra \emph{Carica primi 10 valori univoci} oppure \emph{Carica tutti i valori univoci}. Nella parte destra apparirà la lista dei \textbf{Valori del campo} con i valori univoci elencati. Per aggiungere un valore alla casella \textbf{Espressione} basta fare doppio click sul suo nome dalla casella \textbf{Valori del campo}.

Le sezioni \emph{Operatori}, \emph{Matematica}, \emph{Conversioni}, \emph{Stringa}, \emph{Geometria} e \emph{Record} contengono molte funzioni. \emph{Operatori} fornisce operatori matematici. Per funzioni matematiche cercare in \emph{Matematica}. La sezione \emph{Conversioni} permette di convertire un tipo di dato in un altro (per esempio da numero intero a numero reale).Le funzioni riguardanti le stringhe sono disponibili in \emph{Stringa}. La sezione \emph{Geometria} contiene le funzioni per gli oggetti geometrici mentre grazie alla sezione \emph{Record} è possibile aggiungere una numerazione al dataset (esempio numero della riga). Per aggiungere una funzione alla casella \textbf{Espressione} cliccare su \textgreater{} e fare doppio click sulla funzione scelta.

Segue un breve esempio di utilizzo del calcolatore per calcolare la lunghezza degli elementi del layer \code{railroads} presenti nel dataset di QGIS:
\begin{enumerate}
\item {} 
Caricare in QGIS lo shapefile \code{railroads.shp} e cliccare su \includegraphics[width=1.5em]{mActionOpenTable.png} $^{\text{Apri tabella attributi}}$.

\item {} 
Attivare la modalità \includegraphics[width=1.5em]{mActionToggleEditing.png} $^{\text{Modifica}}$ e aprire il \includegraphics[width=1.5em]{mActionCalculateField.png} $^{\text{Calcolatore di campi}}$.

\item {} 
Spuntare \includegraphics{checkbox.png} \emph{Crea un nuovo campo} per abilitare la creazione di un nuovo campo.

\item {} 
Nominare il campo \code{length}, impostare \code{numero decimale} come tipo, 10 come larghezza e 3 come precisione.

\item {} 
Cliccare sulla funzione \code{length} presente nella sezione \emph{Geometria} per aggiungerla come {\color{red}\bfseries{}{}`{}`}\$lenght{}`{}`nella casella espressione e cliccare su \textbf{{[}OK{]}}.

\item {} 
Adesso la nuova colonna \code{length} è presente nella tabella degli attributi.

\end{enumerate}

Le funzioni disponibili sono di seguito elencate.

\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}

E' possibile accedere alle varie caselle del calcolatore di camp: \textbf{Lista delle funzioni}, \textbf{Aiuto per la funzione scelta}, \textbf{Operatori} e \textbf{Espressione}, sia attraverso la visualizzazione tramite regole presente nella scheda stile delle proprietà del layer, sia attraverso la modalità di impostazione di etichettatura cliccando \includegraphics{browsebutton.png} accessibile dal pulsante \includegraphics[width=1.5em]{mActionLabeling.png} $^{\text{Etichettatura}}$.


\chapter{Lavorare con i dati 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{Lavorare con i dati 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}
Questa Sezione descrive come visualizzare ed impostare le proprietà dei dati raster. QGIS usa la libreria \index{GDAL}GDAL per l’accesso in lettura/scrittura a formati raster, tipo Arc/Info Binary Grid, Arc/Info ASCII Grid, GeoTIFF, Erdas Imagine e molti altri.Il supporto ai raster GRASS è fornito da un plugin nativo di QGIS. Dati raster possono essere caricati in QGIS in sola lettura da file zip e gzip.

Alla data del presente documento, la libreria GDAL supporta più di 100 formati raster (vedi GDAL-SOFTWARE-SUITE {\hyperref[docs/user_manual/literature_web/literature_and_web_references:literature-and-web]{\emph{Literature and Web References}}}). La lista completa è
disponibile alla pagina web \href{http://www.gdal.org/formats\_list.html}{http://www.gdal.org/formats\_list.html}.

\begin{notice}{note}{Nota:}
Per varie ragioni, QGIS potrebbe non gestire alcuni dei formati elencati nella pagina web citata. Ad esempio, alcuni formati richiedono la presenza di librerie commerciali di terze parti oppure l’installazione di GDAL potrebbe essere avvenuta senza il supporto al formato che si intende usare. Quando si carica un raster in QGIS solo i formati ben testati appariranno nell’elenco dei tipi di file; altri formati non testati possono essere caricati selezionando l'opzione \code{{[}GDAL{]} Tutti i file (*)}.
\end{notice}

Per caricare e lavorare con dati raster di GRASS, fare riferimento alla Sezione {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-grass]{\emph{Integrazione con GRASS GIS}}}.


\subsection{Cosa sono i dati raster?}
\label{docs/user_manual/working_with_raster/supported_data:what-is-raster-data}
I dati raster sono matrici di celle discrete che rappresentano elementi della superficie terrestre o dell’ambiente al di sopra o al di sotto di essa. Ogni cella nella matrice raster ha la stessa dimensione e le celle sono solitamente rettangolari (in QGIS saranno sempre rettangolari). Esempi tipici di dati raster sono quelli provenienti dal telerilevamento come le fotografie aeree, le immagini da satellite e dati modellati come le matrici dell’elevazione.

I dati raster di solito non hanno associato un database contenente i dati descrittivi di ogni cella, diversamente dai dati vettoriali, e sono geocodificati in base alla risoluzione del pixel e alle coordinate x/y di un angolo del raster. Questo permette a QGIS il posizionamento corretto dei dati nella vista mappa.

Per posizionare e visualizzare correttamente un raster, QGIS legge le informazioni di georeferenziazione incorporate nel file del raster (ad es.  \index{GeoTiff}GeoTiff) o gestite in un apposito file noto come world file.

\index{loading\_raster}

\subsection{Caricare dati raster in 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}
I layer raster possono essere caricati tramite lo strumento \includegraphics[width=1.5em]{mActionAddRasterLayer.png} $^{\text{Aggiungi Layer}}$ o scegliendo la voce di menu:\emph{Layer --\textgreater{}} \includegraphics[width=1.5em]{mActionAddRasterLayer.png} \emph{Aggiungi raster}. È possibile caricare più di un layer alla volta tenendo premuto il tasto \code{Control} o \code{Shift} e selezionando con il mouse più elementi nella finestra di dialogo \emph{Apri un raster supportato da GDAL}.

Quando il layer è caricato è possibile cliccare sul suo nome nella legenda con il tasto destro del mouse per selezionare ed attivare opzioni specifiche, o per aprire la finestra per l’impostazione delle proprietà del layer raster.

\textbf{Menu contestuale per layer raster}
\begin{itemize}
\item {} 
\emph{Zoom all'estensione del layer}

\item {} 
\emph{Zoom alla scala migliore (100\%)}

\item {} 
\emph{Aggiungi alla panoramica}

\item {} 
\emph{Rimuovi}

\item {} 
\emph{Set Layer CRS}

\item {} 
\emph{Imposta il SR del progetto dal layer}

\item {} 
\emph{Proprietà}

\item {} 
\emph{Rinomina}

\item {} 
\emph{Copia lo stile}

\item {} 
\emph{Add New Group}

\item {} 
\emph{Espandi tutto}

\item {} 
\emph{Comprimi tutto}

\item {} 
\emph{Aggiorna l'ordine del disegno}

\end{itemize}


\section{Proprietà raster}
\label{docs/user_manual/working_with_raster/raster_properties:raster-properties-dialog}\label{docs/user_manual/working_with_raster/raster_properties::doc}
Per visualizzare ed impostare le proprietà di un layer raster, fare doppio click sul nome del raster nella legenda o cliccare su di esso con il tasto destro e scegliere \emph{Proprietà} dal menu contestuale:

Verrà così aperta la finestra \emph{Proprietà layer}, (vedi {\hyperref[docs/user_manual/working_with_raster/raster_properties:figure-raster-1]{figura\_raster\_1}}).

Ci sono diverse schede nella finestra:
\begin{itemize}
\item {} 
\emph{Stile}

\item {} 
\emph{Trasparenza}

\item {} 
\emph{Mappa colore}

\item {} 
\emph{Generale}

\item {} 
\emph{Metadati}

\item {} 
\emph{Piramidi}

\item {} 
\emph{Istogramma}

\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{Scheda stile}
\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 può rendere a video i raster in due modi:
\begin{enumerate}
\item {} 
Banda singola - una sola banda dell’immagine è resa in scala di grigi, o in pseudo colore o ancora in freak out.

\item {} 
Tre bande di colore - tre bande dell’immagine, ognuna rappresentante la componente rosso o verde o blu, vengono composte per creare un’immagine a colori.

\end{enumerate}

È possibile invertire i colori in modo che i quelli chiari diventino scuri e viceversa selezionando la casella di controllo \includegraphics{checkbox.png} \emph{Inverti mappa colore}.

\textbf{Banda singola grigia}

Selezionando questa opzione vengono offerte due possibilità tra le quali scegliere. Innanzitutto se il layer è multibanda è possibile scegliere quale banda si desidera venga  impiegata per la resa a video.

La seconda opzione offre una selezione di mappe colore preimpostate per la resa a video.

Le scelte possibili disponibili nel menu a tendina sono \emph{Mappa colore} \includegraphics{selectstring.png}

\index{Pseudocolore}\index{Freak\_out}\index{Grayscale}\begin{itemize}
\item {} 
Scala di grigi (predefinito)

\item {} 
Pseudocolore

\item {} 
Freak Out

\item {} 
Scheda Mappa colore

\end{itemize}

Quando viene selezionata l'opzione \emph{Mappa colore} \includegraphics{selectstring.png}, la scheda  \emph{Mappa colore} è abilitata. Si vedano ulteriori informazioni al Capitolo {\hyperref[docs/user_manual/working_with_raster/raster_properties:label-colormaptab]{\emph{Scheda Mappa colore}}}.

QGIS restringe la visualizzazione dei dati per mostrare soltanto le celle i cui valori ricadono all’interno di una deviazione standard definita per il layer.

Ciò può essere utile quando nella griglia raster si hanno una o due celle con valori estremamente alti: questi hanno un impatto negativo sulla resa a video del raster. Tale  opzione è disponibile solo per immagini in pseudo colore o freak out.

\textbf{Tra bande di colore}

Questa opzione offre un considerevole numero di possibilità di modifica dell’aspetto del raster. Ad esempio è possibile cambiare il normale ordine RGB delle bande.

È possibile anche applicare una scala di colori in base ai valori min/max del raster.

\begin{notice}{tip}{Suggerimento:}
\textbf{Visualizzare una singola banda di un raster multibanda}

Il modo corretto di visualizzare ad es. la sola banda rossa di un’immagine multibanda non è quello di impostare le bande verde e blu a ``Non impostato'', ma di impostare il tipo di immagine come scala di grigi e quindi scegliere il rosso come banda da usare per il grigio.
\end{notice}

\index{Contrast\_enhancement}
\textbf{Miglioramento contrasto}

\begin{notice}{note}{Nota:}
Se viene aggiunto un raster di GRASS l'opzione \emph{Miglioramento contrasto} sarà sempre selezionata automaticamente su \emph{Stira a MinMax} anche se le impostazioni generali di QGIS dovessero essere diverse.
\end{notice}

\index{Transparency}

\subsection{Scheda Trasparenza}
\label{docs/user_manual/working_with_raster/raster_properties:transparency-tab}\label{docs/user_manual/working_with_raster/raster_properties:index-3}
QGIS offre la possibilità di visualizzare ogni layer raster ad un diverso grado di trasparenza. Per settare una Trasparenza globale, impostare il cursore a scorrimento al livello di trasparenza desiderato in maniera tale da consentire la visualizzazione degli eventuali layer sottostanti. L’uso di questa impostazione può essere molto utile nei casi in cui si desideri sovrapporre più di un layer raster, ad es. ad una mappa delle ombreggiature del rilievo (shaded relief-map) una mappa raster contenente delle classificazioni, così da dare a quest’ultima un aspetto tridimensionale.

Inoltre la sezione Nessun valore consente invece di definire la trasparenza per un certo valore del raster, che sarà quindi letto come un campo privo di dati del tipo \emph{NODATA}. Ciò può essere fatto manualmente o cliccando sull'icona \includegraphics[width=1.5em]{mActionContextHelp.png} $^{\text{Aggiungi un valore dal display}}$.

È possibile definire la trasparenza in maniera ancora più dettagliata e personalizzata nelle sezione \emph{Opzioni di trasparenza personalizzate}, nella quale è possibile impostare il grado di trasparenza di ogni singola cella (o pixel).

Ad esempio se si volesse utilizzare quest’ultima sezione per evidenziare l’acqua del raster \code{landcover.tif} con una trasparenza del 20 \%, bisognerà seguire la seguente procedura:
\begin{enumerate}
\item {} 
Caricre il file raster: Load the rasterfile \code{landcover}.

\item {} 
Aprire la finestra di dialogo guilabel:\emph{Proprietà} facendo doppio click sul nome del layer nella legenda o cliccando su di esso con il tasto destro del mouse e scegliendo \emph{Proprietà} dal menu contestuale.

\item {} 
Selezionare la scheda \emph{Trasparenza}

\item {} 
Cliccare sul pulsante \includegraphics[width=1.5em]{mActionNewAttribute.png} $^{\text{Aggiungi un valore manualmente}}$. Nella lista pixel apparirà una nuova riga.

\item {} 
Inserire il valore del raster per il quale si desidera modificare la trasparenza (si supponga 0 per questo esempio) e si imposti la trasparenza al 20\%.

\item {} 
Cliccare sul pulsante  \textbf{{[}Applica{]}} per visualizzare il risultato.

\end{enumerate}

È possibile ripetere i passaggi 4 e 5 per impostare ulteriori valori con una trasparenza personalizzata.

Impostare la trasparenza personalizzata è alquanto semplice, ma la procedura può risultare laboriosa specie se si hanno molti valori da impostare. Per ovviare a tale complicazione, è possibile salvare la lista delle impostazioni di trasparenza cliccando sul pulsante \includegraphics[width=1.5em]{mActionFileSave.png} $^{\text{Esporta su file}}$ per non ripetere la procedura. Il pulsante \includegraphics[width=1.5em]{mActionFolder.png} $^{\text{Importa da file}}$, infatti, carica il file salvato e applica le impostazioni al raster selezionato.


\subsection{Scheda Mappa colore}
\label{docs/user_manual/working_with_raster/raster_properties:label-colormaptab}\label{docs/user_manual/working_with_raster/raster_properties:colormap}
\index{Scheda Mappa colore}
La scheda \emph{Mappa colore} viene abilitata solo quando si imposta la resa a video del raster come Banda singola grigia nella scheda \emph{Stile} (Capitolo {\hyperref[docs/user_manual/working_with_raster/raster_properties:label-symbology]{\emph{Scheda stile}}}).

\index{Color\_interpolation}\index{Discrete}
Sono disponibili tre modalità di interpolazione del colore:
\begin{enumerate}
\item {} 
Discrete

\item {} 
Lineare

\item {} 
Esatto

\end{enumerate}

Il pulsante \textbf{{[}Aggiungi elemento{]}} aggiunge un colore alla tabella dei colori sottostante. \textbf{{[}Cancella elemento{]}} elimina un colore dalla tabella dei colori. \textbf{{[}Ordina{]}} ordina la tabella dei colori in funzione dei valori dei pixel della colonna Valore. Facendo doppio click su un valore della colonna Valore è possibile specificare o modificare il valore stesso. Facendo doppio click sulla casella colorata a fianco del valore editato (colonna colore) appare la finestra di dialogo  \emph{Seleziona colore} che permette di selezionare il colore da applicare a tutte le celle raster (o pixel) il cui valore corrisponde a quello appena editato. Inoltre è possibile aggiungere o modificare l'etichetta per ogni colore. Questo valore però non sarà mostrato utilizzando lo strumento Informazioni elementi.

In alternativa è possibile cliccare sul pulsante \includegraphics[width=1.5em]{mActionNewAttribute.png} $^{\text{Carica mappa colore dalla banda}}$,con il quale viene caricata, se viene trovata o se disponibile, la tabella dei colori dalla banda. Si possono usare i pulsanti \includegraphics[width=1.5em]{mActionFileOpen.png} $^{\text{Carica mappa colore della banda}}$ o \includegraphics[width=1.5em]{mActionFileSave.png} $^{\text{Esporta mappa colore su file}}$ rispettivamente per caricare o salvare i colori scelti per una sessione futura.

La sezione  \emph{Genera nuova mappa colore} consente di creare nuove mappe colore per categoria. È sufficiente impostare il \emph{Numero di elementi} \includegraphics{selectnumber.png} e cliccare poi su  \emph{Classifica}. Attualmente è supportato il solo \emph{Modo di classificazione} \includegraphics{selectstring.png} `Equal Interval'


\subsection{Scheda generale}
\label{docs/user_manual/working_with_raster/raster_properties:general-tab}\label{docs/user_manual/working_with_raster/raster_properties:label-generaltab}
La scheda \emph{Generale} visualizza le informazioni di base sui raster selezionati, incluso il percorso alla sorgente dati e il nome (modificabile a piacere) visualizzato in legenda. Viene inoltre mostrata una miniatura del layer, la legenda dei simboli e la gamma di colori.

È qui possibile attivare la funzione che setta la visibilità del layer in base alla scala della mappa, attivando l’apposita casella di controllo ed impostando l’intervallo di scale entro il quale si vuole che il layer venga reso a video.

Viene inoltre fornita l’indicazione del sistema di riferimento spaziale (SR) impostato per il layer raster in formato stringa PROJ.4. Il SR è modificabile cliccando sul pulsante  \textbf{{[}Cambia{]}}.

\index{Metadata}

\subsection{Scheda Metadati}
\label{docs/user_manual/working_with_raster/raster_properties:metadata-tab}\label{docs/user_manual/working_with_raster/raster_properties:index-6}
La scheda \emph{Metadati} mostra una serie di informazioni sul layer raster, come ad es. le statistiche riguardanti ogni banda. Le statistiche sono disponibili in questa scheda solo dopo averle raccolte cliccando nella scheda  \emph{Istogramma} e sul pulsante  \textbf{{[}Aggiorna{]}} in basso a destra (capitolot {\hyperref[docs/user_manual/working_with_raster/raster_properties:label-histogram]{\emph{Scheda Istogramma}}}).

This tab is mainly for information. You cannot change any values printed
inside this tab.

\index{Pyramids}

\subsection{Scheda Piramidi}
\label{docs/user_manual/working_with_raster/raster_properties:pyramids-tab}\label{docs/user_manual/working_with_raster/raster_properties:index-7}
I layer raster ad alta risoluzione possono rallentare notevolmente l’esplorazione della mappa in QGIS. Creando copie a bassa risoluzione dei dati (piramidi) le prestazioni possono venire incrementate notevolmente in quanto QGIS sceglierà la risoluzione migliore in funzione del fattore di zoom.

Per creare piramidi è necessario avere i permessi in scrittura nella cartella contenente il dato originale: in questa cartella verranno salvate le copie a bassa risoluzione.

Sono disponibili i seguenti metodi di ricampionamento:
\begin{itemize}
\item {} 
Media

\item {} 
Vicino più prossimo (metodo Nearest Neighbour)

\end{itemize}

Quando viene attivata la casella di controllo \includegraphics{checkbox.png} \emph{Crea piramidi interne se possibile} QGIS crea e memorizza le piramidi direttamente nel file raster, invece di copie multiple separate.

Si evidenzia che la costruzione delle piramidi può alterare il dato originale in maniera irreversibile, quindi si raccomanda di fare una copia di backup del raster di partenza prima di eseguire l’operazione.


\subsection{Scheda Istogramma}
\label{docs/user_manual/working_with_raster/raster_properties:label-histogram}\label{docs/user_manual/working_with_raster/raster_properties:histogram-tab}
\index{Histogram}
La scheda \emph{Istogramma} consente di visualizzare la distribuzione delle bande di colore nel layer raster. Tali statistiche sono generate automaticamente nel momento in cui si accede alla scheda \emph{Istogramma}. È possibile selezionare quale banda mostrare nel diagramma selezionandola nella lista sulla sinistra della scheda. E' possibile salvare l'istogramma come immagine premendo sul pulsante \includegraphics[width=1.5em]{mActionFileSave.png}.


\section{Calcolatore 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 finestra di dialogo \emph{Calcolatore Raster} del menu  \emph{Raster} (vedi {\hyperref[docs/user_manual/working_with_raster/raster_calculator:figure-raster-2]{figure\_raster\_2}}) permette di effettuare calcoli sulla base dei valori dei pixel di raster esistenti. Il risultato viene salvato in un nuovo layer raster in uno dei formati supportati da 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 sezione \textbf{Bande raster} elenca i layer raster caricati in QGIS che possono essere utilizzati. Per aggiungere un raster nella casella Espressione del calcolatore raster, fare doppio click sul suo nome in Bande raster. Si possono usare gli operatori per costruire un’espressione o scriverla direttamente nella casella delle espressioni.

Nella sezione \textbf{Layer di risultato} va definito il nome del raster risultato. Si può poi definire l’estensione dell’area di calcolo che ne determinerà la risoluzione, basandosi sul layer di imput, su coordinate X,Y o sul numero di colonne e di righe. Se il layer in input ha una risoluzione diversa, i valori saranno ricampionati con l’algoritmo del vicino più prossimo.

La sezione \textbf{Operatori} elenca gli operatori disponibili. Per aggiungere un operatore alla casella Espressione del calcolatore raster, cliccare sull’icona ad esso relativa. Sono disponibili operazioni matematiche (+ , - , * . . . ), funzioni trigonometriche (sin, cos, tan, . . . ), operatori logici (AND, OR). Ulteriori funzioni verranno incluse in futuro!

Selezionando la casella di controllo  \includegraphics{checkbox.png} \emph{Aggiungi al progetto} il layer risultato sarà aggiunto alla legenda e potrà essere visualizzato nella vista mappa.


\subsection{Esempi}
\label{docs/user_manual/working_with_raster/raster_calculator:examples}
\textbf{Convertire calori di elevazione da metri a piedi}

Per creare un raster con altimetria in piedi a partire da un raster con altimetria in metri è necessario utilizzare il fattore di conversione di 3,28 piedi per metro. L'espressione è:

\begin{Verbatim}[commandchars=\\\{\}]
elevation@1 * 3.28
\end{Verbatim}

\textbf{Utilizzare una mascheratura}

Se si vuole utilizzare una mascheratura su parte del raster, perchè si è interessati solo ai valori di altezza superiori allo 0, è possibili utilizzare l'espresisone seguente che crea la maschera e applica i risultati in un solo passaggio.

\begin{Verbatim}[commandchars=\\\{\}]
(elevation@1 \textgreater{}= 0) * elevation@1
\end{Verbatim}

Per ogni cella maggiore o uguale a 0 si imposta il valore a 1, altrimenti a 0. Questo crea la maschera al volo.


\chapter{Lavorare con i dati 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{Lavorare con i dati 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 supporta sorgenti di dati WMS e WFS.


\subsection{Cosa sono i dati OGC}
\label{docs/user_manual/working_with_ogc/ogc_client_support:what-is-ogc-data}
\index{Open\_Geospatial\_Consortium}\index{OGC}
L’Open Geospatial Consortium (OGC), è un’organizzazione internazionale che raggruppa più di 300 organizzazioni commerciali, governative, nonprofit e di ricerca. I suoi membri sviluppano e implementano standard per contenuti e servizi geospaziali, analisi GIS e scambio dati.

OGC ha elaborato un numero crescente di specifiche per la descrizione di un modello dati di base per elementi geografici: le specifiche sono orientate a garantire l’interoperabilità nell’ambito della tecnologia geospaziale. Ulteriori informazioni all’indirizzo \href{http://www.opengeospatial.org/}{http://www.opengeospatial.org/}.

\index{WMS}\index{WFS}\index{WCS}\index{CAT}\index{SFS}\index{GML}
Importanti specifiche OGC sono:
\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}

Ad oggi i servizi OGC-sono sempre più di uso comune per scambiare dati geografici fra differenti implementazioni GIS. QGIS ora può gestire tre delle specifiche esposte sopra, SFS (tramite il supporto a PostgreSQL/PostGIS, vedi Sezione {\hyperref[docs/user_manual/working_with_vector/supported_data:label-postgis]{\emph{Layer PostGIS}}}), WFS e WMS come 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{Panoramica sul servizio 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 può agire come client WMS, nel rispetto delle specifiche 1.1, 1.1.1 e 1.3. È stato particolarmente testato nei confronti di server accessibili pubblicamente quali DEMIS e JPL OnEarth.

I server WMS rispondono alle richieste da parte dei client (ad es. QGIS) di una mappa raster di una determinata estensione, con un determinato insieme di layer, simboli e trasparenze. Il server WMS quindi consulta le sue risorse (locali o remote), genera il raster e lo invia al client in formato raster, per QGIS tipicamente come immagini JPEG o PNG.

WMS è un servizio REST (Representational State Transfer) piuttosto che un servizio web completo. Come tale, si può prendere l’URL (indirizzo del server con specifiche) generato da QGIS e usarlo in un browser web per ottenere la stessa immagine che QGIS usa internamente. Questo può essere utile per identificare le cause di eventuali problemi, dato che esistono vari tipi di server WMS e ciascuno ha la sua propria interpretazione degli standard WMS.

I layer WMS possono essere aggiunti molto semplicemente, una volta disponibile l’indirizzo (URL) per accedere al server WMS, una connessione adatta e posto che il server usi HTTP come meccanismo di trasferimento dati.


\subsubsection{Selezionare un server 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}
Al primo utilizzo di un servizio WMS in QGIS non sono presenti server predefiniti.

Si può avviare lo strumento cliccando sul pulsante e \includegraphics[width=1.5em]{mActionAddWmsLayer.png} $^{\text{Aggiungi layer WMS}}$ nella barra strumenti, oppure sulla voce di menu  \emph{Layer \(\rightarrow\) Aggiungi layer.WMS...}.

Si aprirà la finestra di dialogo: \emph{Aggiungi Layer da server}. È possibile aggiungere alcuni server cliccando sul pulsante \textbf{{[}Aggiungi server predefiniti{]}}. Verranno quindi aggiunti due server WMS, il server di DM Solutions Group ed il server di Lizardtech. Per definire un nuovo server WMS nella sezione \emph{Layer}, cliccare su  \textbf{{[}Nuovo{]}} ed inserire i parametri di connessione al server WMS desiderato, seguendo le indicazioni della tabella \_OGC\_1\_:
\phantomsection\label{docs/user_manual/working_with_ogc/ogc_client_support:table-ogc-1}
\begin{tabulary}{\linewidth}{|L|L|}
\hline

Nome
 & 
Un nome per la connessione. Tale nome verrà utilizzato nel menù a discesa di scelta dei server in modo da distinguere i vari WMS.
\\

URL
 & 
URL del server che fornisce i dati. Deve essere un indirizzo raggiungibile nello stesso formato che verrebbe usato per aprire una commessione telnet o pingare un host.
\\

Username
 & 
Nome utente per accedere un WMS protetto. Questo parametro è opzionale.
\\

Password
 & 
Password per accedere ad un WMS protetto. Questo parametro è opzionale.
\\

Ignora URI GetMap
 & 
\includegraphics{checkbox.png} \emph{Ignora la URI GetMap riportata nelle capabilities}. Viene utilizzato URI del campo URL precedente.
\\

Ignora URI GetFeatureInfo
 & 
\includegraphics{checkbox.png} \emph{Ignora la URI GetFeatureInfo riportata nelle capabilities}. Viene utilizzato URI del campo URL precedente
\\
\hline\end{tabulary}


Table OGC 1: Parametri di connessione WMS

\index{Proxy}\index{proxy-server}
È possibile, se necessario, impostare i parametri di un proxy per ricevere i servizi WMS da internet. Selezionare la voce di menu \emph{Impostazioni \(\rightarrow\) Opzioni} e cliccare sulla scheda  \emph{Rete}, nella quale è possibile inserire le impostazioni abilitando la casella di controllo \includegraphics{checkbox.png} \emph{Utilizza un proxy per l’accesso web}. Assicuratevi di scegliere il tipo di proxy corretto dal menù a discesa \emph{Tipo proxy} \includegraphics{selectstring.png}.

Una volta creata la connessione al server WMS, essa sarà memorizzata e disponibile per le successive sessioni di QGIS.

\begin{notice}{tip}{Suggerimento:}
A PROPOSITO DI INDIRIZZI DEI SERVER WMS

Quando si inserisce l’indirizzo URL del server assicurarsi di usare l’indirizzo di base. Ad esempio non bisogna inserire frammenti tipo request=GetCapabilities o version=1.0.0 nell’indirizzo.
\end{notice}


\subsubsection{Caricare layer 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}
Una volta compilati correttamente i campi, si può premere sul pulsante \textbf{{[}Connetti{]}} per ottenere le capabilities del server: in esse sono inclusi i formati immagine, i layer disponibili e i sistemi di proiezione forniti dal server. Considerato che si tratta di operazioni in rete, la velocità nella risposta dipenderà dalla qualità della connessione verso il server WMS. Mentre si scaricano i dati dal server, l’avanzamento dell’operazione viene visualizzato nella porzione inferiore sinistra della finestra.

Il vostro schermo adesso deve essere simile a quello rappresentato alla {\hyperref[docs/user_manual/working_with_ogc/ogc_client_support:figure-ogr-1]{figura\_OGR\_1}}, che mostra la risposta fornita dal server WMS di 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{Codifica immagine}

La sezione \emph{Codifica immagine} elenca i formati supportati sia dal client che dal server. La scelta è in funzione dei propri requisiti di accuratezza.

\begin{notice}{tip}{Suggerimento:}
\textbf{Codifica immagine}

Un server WMS offre normalmente la scelta fra immagini JPEG o PNG. Il formato JPEG è un formato di compressione lossy, mentre il formato PNG riproduce fedelmente i dati raster.

È preferibile utilizzare il formato JPEG per dati di natura fotografica e/o se la perdita parziale di qualità dell'immagine non causa problemi. Questa scelta riduce normalmente di 5 volte il volume di dati trasferiti rispetto al fomrato PNG.

L'uso del formato PNG permette una visualizzazione più precisa ed è da utilizzare se non vi sono problemi per l'incremento dei dati trasferiti.
\end{notice}

\textbf{Opzioni}

La sezione Opzioni mette a disposizione il campo testo  \emph{Nome layer} per associare un nome al layer WMS: tale nome apparirà nella legenda a caricamento avvenuto.

Sotto il nome del layer è possibile definire la \emph{Dimensione delle tile}, (per esempio 256x256) in modo da dividere la richiesta WMS in richieste multiple.

Il campo \emph{Limite di elementi per GetFeatureInfo} definisce quali elementi del server interrogare.

Selezionando un layer WMS dalla lista appare un campo con il sistema di proiezione predefinito dal server. Se il pulsante  \textbf{{[}Cambia...{]}} è attivo, allora è possibile selezionare un altro SR fornito dal server.

\textbf{Ordine dei Layer}

La sezione \emph{Ordine layer} elenca i diversi layer disponibili sul server WMS a cui si è connessi. Si può notare che alcuni layer sono espandibili e questo significa che quei layer possono essere visualizzati con diversi stili.

È possibile selezionare più layer in una volta, ma solo uno stile di visualizzazione per layer. Quando più layer sono selezionati questi vengono combinati dal server ed inviati a QGIS in una sola volta.

\begin{notice}{tip}{Suggerimento:}
\textbf{Ordine dei layer WMS}

layer WMS caricati sono sovrapposti in base all’ordine in cui sono elencati nella sezione Layer, dall’alto verso il basso. Se si desidera cambiare l’ordine di visualizzazione, usare la scheda \emph{Ordine layer}.
\end{notice}
\phantomsection\label{docs/user_manual/working_with_ogc/ogc_client_support:ogc-wms-transparency}
\textbf{Trasparenza}

In questa versione di QGIS l'impostazione della \emph{Trasparenza globale} che si imposta da Layer \emph{Proprietà...} è impostata per essere sempre attiva, se disponibile.

\index{WMS\_layer\_transparency}
\begin{notice}{tip}{Suggerimento:}
\textbf{Trasparenza dei layer WMS}

La possibilità di rendere trasparenti i layer WMS dipende dalla codifica tramite la quale sono stati caricati: PNG e GIF gestiscono la trasparenza mentre il JPEG no.
\end{notice}

\textbf{Sistema di Riferimento}

\index{Coordinate\_Reference\_System}\index{SRS}\index{CRS}
Sistema di riferimento delle coordinate (Coordinate Reference System) è il termine OGC per una proiezione in QGIS.

Ogni layer WMS può essere restituito in molteplici SR, in funzione delle capacità del server.

Per scegliere uno dei SR disponibili, cliccare su \textbf{{[}Cambia...{]}} per fare apparire una finestra simile a quella della Figura Proiezioni 3 in {\hyperref[docs/user_manual/working_with_projections/working_with_projections:label-projections]{\emph{Lavorare con le proiezioni}}}. La differenza principale è che saranno mostrati solo i SR supportati dal server al quale si è connessi.


\subsubsection{Cercare un Server}
\label{docs/user_manual/working_with_ogc/ogc_client_support:server-search}\label{docs/user_manual/working_with_ogc/ogc_client_support:serversearch}
Con QGIS è anche possibile ricercare server WMS. La {\hyperref[docs/user_manual/working_with_ogc/ogc_client_support:figure-ogc-2]{Figura\_OGC\_2}} mostra la nuova scheda  \emph{Cerca server} della finestra di dialogo  \emph{Aggiungi layer dal server}.
\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}

Inserire una stringa di ricerca e cliccare sul pulsante \textbf{{[}Cerca{]}}: i risultati saranno elencati nella sottostante tabella. Per utilizzare uno dei risultati, selezionarlo nella tabella e cliccare su \textbf{{[}Aggiungi riga alla lista WMS{]}}. Il server verrà automaticamente aggiunto alla lista dei server nella scheda \emph{Layer}: cliccare su {\color{red}\bfseries{}**}{[}Connetti{]}**per ottenere la lista di layer forniti dal server.

Si tratta fondamentalmente di un frontend alle API of \href{http://geopole.org}{http://geopole.org}.


\subsubsection{Set di tile}
\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}
Quando si usa un servizio WMS-C (Cached WMS) come ad esempio  \href{http://labs.metacarta.com/wms-c/Basic.py}{http://labs.metacarta.com/wms-c/Basic.py} si attiva la scheda \emph{Set di tile} , che fornisce informazioni sulle dimensione, il formato ed il SR dei tile. In combinazione con tale opzione è possibile utilizzare la voce di menu \emph{Visualizza \(\rightarrow\) Slider per la scala delle tiles}, che mette a disposizione le scale fornite dal server di tile.


\subsubsection{Uso dello strumento di identificazione}
\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}
Una volta aggiunto un server WMS, e se uno dei layer disponibili è interrogabile, è possibile usare lo strumento \includegraphics[width=1.5em]{mActionIdentify.png} $^{\text{Informazioni elementi}}$ per selezionare un pixel sulla mappa, determinando una interrogazione verso il server WMS. La formattazione del risultato dell'interrogazione fatta dipende dal server WMS utilizzato.
\phantomsection\label{docs/user_manual/working_with_ogc/ogc_client_support:ogc-wms-properties}
\textbf{Proprietà del server}

\index{WMS\_properties}
Una volta aggiunto un server WMS, è possibile visualizzarne le proprietà cliccando con il tasto destro sul suo nome nella legenda e selezionando \emph{Proprietà}.
\phantomsection\label{docs/user_manual/working_with_ogc/ogc_client_support:ogc-wms-properties-metadata}
\textbf{Scheda Metadati}

\index{WMS\_metadata}
La scheda \emph{Metadati{}`mostra molte informazioni sul server WMS: tali informazioni sono fornite dal server stesso in risposta alla richiesta di GetCapabilities fatta da QGIS quando si connette ad esso. Molte definizioni possono essere dedotte leggendo gli standard WMS (vediOPOPEN-GEOSPATIAL-CONSORTIUM :ref:{}`literature\_and\_web}). Qui seguono alcune definizioni utili:
\begin{itemize}
\item {} 
\textbf{Proprietà del server}
\begin{itemize}
\item {} 
\textbf{Versione WMS} --- La versione WMS supportata dal server.

\item {} 
\textbf{Formati immagine} ---  Elenco dei tipi MIME che il server può fornire per disegnare la mappa. QGIS permette l'utilizzo di qualunque formato sia supportato dalle librerie Qt contro le quali è compilato, che sono solitamente almeno \code{image/png} ed \code{image/jpeg}.

\item {} 
\textbf{Interroga formati} --- L’elenco dei tipi MIME con i quali il server può fornire risposta quando si usa lo strumento Informazioni elementi. Attualmente QGIS supporta il tipo \code{text-plain}.

\end{itemize}

\item {} 
\textbf{Propertà layer}
\begin{itemize}
\item {} 
\textbf{Selezionato} --- Indica se il layer era selezionato quando il server è stato aggiunto al progetto.

\item {} 
\textbf{Visibilità} --- Indica se il layer è stato impostato come visibile in legenda. (funzione non ancora utilizzata in questa versione di QGIS.)

\item {} 
\textbf{Può interrogare} ---Indica se il layer fornisce o meno informazioni se si usa lo strumento Informazioni elementi.

\item {} 
\textbf{Può essere trasparente} --- Indica se il layer può essere o meno reso trasparente a video. Questa versione di QGIS farà sempre uso della trasparenza se questa voce visualizza{}`{}` Sì{}`{}` e se il formato immagine la supporta

\item {} 
\textbf{Può ingrandire} --- Indica se il layer può o meno essere ingrandito dal server. Questa versione di QGIS suppone che tutti i layer WMS abbiano questa opzione settata su  {\color{red}\bfseries{}{}`{}`}Sì {\color{red}\bfseries{}{}`{}`}. Layers carenti in questa impostazione potrebbero essere resi a video in modo anomalo.

\item {} 
\textbf{Conteggio a cascata} --- I server WMS possono fungere da proxy per altri server WMS dai quali ottengono i dati raster per un certo layer. La voce mostra quindi quante richieste per questo layer vengono inoltrate ai nodi per ottenere un risultato.

\item {} 
\textbf{Larghezza fissa, Altezza fissa} --- Indica se il layer ha o meno una dimensione del pixel fissata alla sorgente. Questa versione di QGIS assume che tutti i layer WMS abbiano vuota questa voce. Layers con impostazioni diverse potrebbero essere resi a video in modo anomalo.

\item {} 
\textbf{Perimetro WGS 84} --- Estensione del layer in coordinate WGS84. Alcuni server WMS non settano questo parametro correttamente (ad es. usano coordinate UTM invece di WGS84). In questo caso sembrerà che la vista iniziale del layer sia ad uno \code{zoom molto ridotto}. Bisognerebbe informare di questi errori il webmaster del server WMS, il quale li dovrebbe identificare come elementi WMS XML \code{LatLonBoundingBox}, \code{EX\_GeographicBoundingBox} o SR:84 \code{BoundingBox}.

\item {} 
\textbf{Disponibilità in CRS} --- Sistemi di riferimento nel quale il layer può essere rappresentato dal server WMS, elencati nel formato nativo WMS.

\item {} 
\textbf{Disponibile in stile} --- Stili visuali applicabili al layer dal server WMS.

\end{itemize}

\end{itemize}


\subsubsection{Limitazioni del 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}
Non tutte le possibili funzionalità WMS sono state incluse in questa versione di QGIS. Le eccezioni più rilevanti sono le seguenti.

\textbf{Modificare le impostazioni del layer WMS}

Una volta completata la procedura mostrata dalla finestra  \includegraphics[width=1.5em]{mActionAddWmsLayer.png} $^{\text{Aggiungi layer WMS}}$, non è più possibile modificarne i parametri. Una possibile soluzione è quella di eliminare il layer completamente e ricaricarlo reimpostando i parametri.

\textbf{Server WMS che richiedono un’autenticazione}

Attualmente sono accessibili server pubblici e server protetti. È possibile accedere ai server protetti con autenticazione pubblica. Opzionalmente è possibile inserire le proprie credenziali. Si veda Sezione  {\hyperref[docs/user_manual/working_with_ogc/ogc_client_support:ogc-wms-servers]{\emph{Selezionare un server WMS}}} per i dettagli.

\index{InteProxy}\index{Secured\_OGC\_Authentication}
\begin{notice}{tip}{Suggerimento:}
\textbf{Accesso ai layer OCG protetti}

Qualora fosse necessario accedere a layer protetti con password, è possibile usare InteProxy come proxy trasparente, che supporta molti metodi di autenticazione. Ulteriori informazioni sono fornite dal manuale di InteProxy al sito web \href{http://inteproxy.wald.intevation.org}{http://inteproxy.wald.intevation.org}.
\end{notice}

\index{QGIS\_mapserver}\index{WMS\_1.3.0}
\begin{notice}{tip}{Suggerimento:}
\textbf{WMS Mapserver QGIS}

A partire dalla versione 1.7.0, in QGIS è stato implementato un server WMS 1.3.0. Ulteriori informazioni nel Capitolo {\hyperref[docs/user_manual/working_with_ogc/ogc_server_support:label-qgisserver]{\emph{QGIS Server}}}.
\end{notice}


\subsection{Client WFS e 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}
In QGIS, un layer WFS si comporta come un qualsiasi altro layer vettoriale. È possibile identificare, selezionare elementi e visualizzare la tabella attributi. A partire da QGIS 1.6.0 è, inoltre, possibile editare il layer se il server lo supporta (WFS-T).

Normalmente la procedura per l’aggiunta di un layer WFS è molto simile a quella vista per i WMS. La differenza sta nel fatto che non vi sono server predefiniti, di conseguenza è necessario aggiungere manualmente quelli noti.

\textbf{Caricare un layer WFS}

Come esempio è possibile caricare il server WFS DM Solutions e mostrare un layer. L’indirizzo da inserire è: \href{http://www2.dmsolutions.ca/cgi-bin/mswfs\_gmap}{http://www2.dmsolutions.ca/cgi-bin/mswfs\_gmap}
\begin{enumerate}
\item {} 
Cliccare sullo strumento \includegraphics[width=1.5em]{wfs.png} $^{\text{Aggiungi layer WFS}}$ nella barra dei layer ed apparirà la finsetra di dialogo  \emph{Aggiungi layer WFS da server}

\item {} 
Cliccare su \textbf{{[}Nuovo{]}}

\item {} 
Inserire il nome `DM Solutions'

\item {} 
Inserire l’indirizzo precedentemente indicato

\item {} 
Cliccare su \textbf{{[}OK{]}}

\item {} 
Selezionare \emph{Connessione server DM Solutions} \includegraphics{selectstring.png} dal menù a tendina

\item {} 
Cliccare su \textbf{{[}Connetti{]}}

\item {} 
Attendere la ricezione dell’elenco dei layer

\item {} 
Selezionare dalla lista il layer  \emph{Parks}

\item {} 
Cliccare su \textbf{{[}Applica{]}} per aggiungere il layer alla mappa

\end{enumerate}

Si noti che i settaggi del proxy impostati nelle preferenze vengono riconosciuti.
\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}

Si noti che l’avanzamento della ricezione dei dati viene visualizzato nella parte inferiore sinistra della finestra principale di QGIS. Quando il layer è caricato, è possibile identificare e selezionare alcuni elementi e visualizzare la tabella attributi.

Questo significa che attualmente è supportato solo WFS 1.0.0. Al momento non vi sono stati ancora molti test relativi a versioni di WFS basate su altri server. In caso di problemi con il plugin, non esitare a contattare il team di sviluppo. Si veda la sezione {\hyperref[docs/user_manual/preamble/help_and_support:label-helpsupport]{\emph{Le Mailing list}}} per ulteriori informazioni sulle mailinglist.

\begin{notice}{tip}{Suggerimento:}
\textbf{Cercare server WFS}

È possibile ricercare ulteriori server WFS tramite Google o altro motore di ricerca preferito. Ci sono anche diversi elenchi di URL pubblici, alcuni dei quali aggiornati e altri non più manutenuti.
\end{notice}

\index{QGIS\_Server}\index{FastCGI}\index{CGI}\index{Common\_Gateway\_Interface}

\section{QGIS Server}
\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}
QGIS Server è un’implementazione WMS 1.3 open source con caratteristiche molto avanzate per la produzione di carte tematiche. QGIS Server è un’applicazione FastCGI/CGI (Common Gateway Interface) scritta in C++ e lavora in accoppiata ad un server web (es. Apache, Lighttpd). QGIS Server è supportato dai progetti europei Orchestra e Sany e dalla città di Uster in Svizzera.

\index{SLD}\index{SLD/SE}
Utilizza QGIS come backend per la restituzione delle mappe e per le operazioni gis. Inoltre viene usata la libreria Qt per la grafica e per la piattaforma indipendente di programmazione C++. A differenza di altri server WMS, QGIS Server usa regole cartografiche come linguaggio di configurazione, sia per la configurazione a livello server che per le configurazioni utente.

\index{Publish\_to\_Web\_plugin}
Inoltre, QGIS Server mette a disposizione il plugin `Pubblica sul web' che permette di esportare un progetto di QGIS desktop in un progetto web per QGIS Server, con i layer e i simboli prescelti (con regole di visualizzazione cartografica espresse in SLD).

Dato che QGIS desktop e QGIS Server usano le stesse librerie, le mappe pubblicate sul web hanno la stessa visualizzazione di quelle in locale. Il plugin Pubblica sul Web, al momento, supporta una simbolizzazione di base, mentre per visualizzazioni cartografiche più complesse, è necessario configurare le regole manualmente. Dato che la consfigurazione si basa sulle  specifiche dello \href{http://www.opengeospatial.org/standards/sld}{standard SLD} e sue estensioni c'è solo un linguaggio da apprendere, cosa che semplifica enormemente l'operazione complessa di creare mappe per il web.

In uno dei prossimi manuali sarà fornito un esempio per configurare un server QGIS. Per adesso si raccomanda la lettura dei materiali disponibili ad uno dei seguenti URL:
\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{Installazione di esempio su 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}
Di seguito è brevemente descritta un’installazione di esempio su Debian Squeeze. Anche molti altri OS hanno pacchetti precompilati per QGIS Server. Se si ha necessità di compilare da codice sorgente, riferirsi agli indirizzi web appena citati.

Oltre a qgis e qgis-mapserver, è necessario avere installato un server web, come ad esempio apache2. È possibile installare tutti i pacchetti necessari, e relative dipendenze, con aptitude o apt-get install. Dopo l’installazione bisogna verificare il corretto funzionamento del server web e di qgis server. Assicurarsi che apache sia stato avviato con \code{/etc/init.d/apache2 start}, aprire un browser ed andare su URL: \code{http://localhost}: se tutto è correttamente configurato dovrebbe apparire il messaggio ’It works!’.

Passare quindi a testare l’installazione di QGIS server. Il file \code{qgis\_mapserv.fcgi}, disponibile in \code{/usr/lib/cgi-bin/qgis\_mapserv.fcgi} fornisce un WMS standard con visualizzati i confini dell'Alaska. Caricare il WMS in QGIS con l’URL {\color{red}\bfseries{}{}`{}`}\href{http://localhost/cgi-bin/qgis\_mapserv.fcgi}{http://localhost/cgi-bin/qgis\_mapserv.fcgi} {\color{red}\bfseries{}{}`{}`}, così come descritto nella Sezione {\hyperref[docs/user_manual/working_with_ogc/ogc_client_support:ogc-wms-servers]{\emph{Selezionare un server 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{Creare un WMS/WFS da un progetto 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}
Per offrire un servizio WMS/WFS si parte dalla creazione di un progetto QGIS contenente alcuni dati: come esempio verranno utilizzati gli shapefile ’regions’ e ’airport’ da qgis\_sample\_dataset. Caricare in QGIS gli shapefile e definirne colori, stili e SR.
\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}

Aprire la scheda \code{WMS Server} sotto \emph{Impostazioni \(\rightarrow\) Proprietà progetto} e definire i campi generali con `Service Capabilities'. Per le \code{WMS Capabilities} definire le `Restrizioni dei sistemi di coordinate' e l' `Estensione pubblicata'. Inoltre è possibile attivare la casella di controllo \includegraphics{checkbox.png} \emph{Aggiungi geometria WKT alle informazioni di risposta dell’oggetto} se si vuole rendere il layer interrogabile. Per \code{WFS Capabilities} è semplicemente necessario selezionare i layer che si intendono caricare come WFS. Salvare la sessione in un file di progetto \code{alaska.qgs}. Per rendere disponibile il progetto come WMS/WFSTo, creare una cartella in \code{/usr/lib/cgi-bin/project} con privilegi di amministratore e aggiungere il file di progetto \code{alaska.qgs} e una copia del file \code{qgis\_mapserv.fcgi}.

Ora non resta che testare i progetti WMS e WFS; aggiungere il WMS e il WFS come descritto nella sezione in {\hyperref[docs/user_manual/working_with_ogc/ogc_client_support:ogc-wms-layers]{\emph{Caricare layer WMS}}} e {\hyperref[docs/user_manual/working_with_ogc/ogc_client_support:ogc-wfs]{\emph{Client WFS e WFS-T}}}. L'URL è:

\begin{Verbatim}[commandchars=\\\{\}]
http://localhost/cgi-bin/project/qgis\_mapserv.fcgi
\end{Verbatim}


\chapter{Lavorare con i dati GPS}
\label{docs/user_manual/working_with_gps/index::doc}\label{docs/user_manual/working_with_gps/index:working-with-gps-data}

\section{Plugin 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{Cos'è un GPS?}
\label{docs/user_manual/working_with_gps/plugins_gps:what-is-gps}\label{docs/user_manual/working_with_gps/plugins_gps:whatsgps}
Il sistema di posizionamento globale GPS è basato sui satelliti, che permettono a chiunque sia dotato di un ricevitore GPS, di individuare esattamente la sua posizione in qualunque zona del mondo. Il GPS è utilizzato come strumento di aiuto nella navigazione, per esempio negli aereoplani, nelle navi e anche dagli escursionisti. Il ricevitore GPS sfrutta il segnale dei satelliti per calcolare latitudine, longitudine e (qualche volta) l'altitudine. Alcuni ricevitori possono memorizzare la posizione (chiamata \emph{waypoints}), la sequanza di posizioni che costituiscono una \emph{route} e una traccia o \emph{track} dei movimenti che il ricevitore ha effettuato nel tempo. Waypoints, routes, e tracks sono le tre caratteristiche di base dei dati GPS. QGIS visualizza le posizioni come layer di punti, mentre i percorsi e le tracce sono visualizzati come layer di linee.


\subsection{Caricamento dei dati GPS da file}
\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}
Ci sono una dozzina di formati di file diversi per memorizzare dati GPS. Il formato utilizzato da QGIS è chiamato GPX (GPs eXchange format), il quale è un formato standard di interscambio che puo contenere svariati numeri di posizioni, percorsi e tracce nello stesso file.

Per caricare un file GPX è necessario installare il plugin \emph{Plugins \(\rightarrow\)} \includegraphics[width=1.5em]{mActionShowPluginManager.png} \emph{Gestione Plugin...} aprendo la finestra di dialogo Gestione Plugin. Spuntare la casella \includegraphics{checkbox.png} \emph{Strumenti GPS}. Quando il plugin è installato verranno visualizzati nella barra degli strumenti due pulsanti che rappresentano dei piccoli palamari GPS. Un esempio di file GPX è disponibile nel dataset campione \code{qgis\_sample\_data/gps/national\_monuments.gpx} vedi sezione {\hyperref[docs/user_manual/introduction/getting_started:label-sampledata]{\emph{Dati campione}}} per maggiori informazioni sul dataset campione:
\begin{itemize}
\item {} 
\includegraphics[width=1.5em]{gps_importer.png} $^{\text{Creazione di un nuovo layer GPX}}$

\item {} 
\includegraphics[width=1.5em]{gps_importer.png} $^{\text{Strumenti GPS}}$

\end{itemize}

Per lavorare con i dati GPS viene formito un file GPX di esempio disponibile nel dataset di QGIS: file:\emph{qgis\_sample\_data/gps/national\_monuments.gpx}. Vedi sezione {\hyperref[docs/user_manual/introduction/getting_started:label-sampledata]{\emph{Dati campione}}} per maggiori informazioni sul data set.
\begin{enumerate}
\item {} 
Cliccando sull'icona \includegraphics[width=1.5em]{gps_importer.png} $^{\text{Strumenti GPS}}$ verrà aperta la finestra \emph{Carica file GPX} (vedi {\hyperref[docs/user_manual/working_with_gps/plugins_gps:figure-gps-1]{figure\_GPS\_1}}).

\item {} 
Navigare all'interno della cartella \code{qgis\_sample\_data/gps/}, selezionare il file GPX \code{national\_monuments.gpx} e cliccare \textbf{{[}Apri{]}}.

\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}

Utilizzare \textbf{{[}Browse...{]}} il pulsante per selezionare il file GPX, e poi utilizzare le caselle per selezionare il tipo di dati che si desidera caricare dal file GPX. Ogni tipo di dato sarà caricato in layer separati quando viene premuto il pulsante \textbf{{[}OK{]}}. Il file \code{national\_monuments.gpx} include solamente le posizioni dei punti.

\begin{notice}{note}{Nota:}
Il dispositivo GPS permette di immagazzinare i dati in diversi sistemi di coordinate. Quando viene scaricato un file GPX (dal dispositivo GPS o da un sito web) e successivamente viene caricato in Quantum GIS, è necessario assicurarsi che i dati immagazzinati nel file GPX siano proiettati nel sistema WGS84 (latitudine/longitudine). Questo è quello che si aspetta Quantum GIS ed è la specifica ufficiale dei dati GPX. Vedere://www.topografix.com/GPX/1/1/
\end{notice}


\subsection{GPSBabel}
\label{docs/user_manual/working_with_gps/plugins_gps:gpsbabel}
Dal momento che QGIS utilizza i file GPX è necessario convertire gli altri formati GPS nel formato GPX. Questo puo essere fatto per un gran numero di formati utilizzando il software gratuito GPSBabel, che è disponibile al sito \href{http://www.gpsbabel.org}{http://www.gpsbabel.org}. Questo software è in grado inoltre di trasferire dati GPS tra il computer e il dispositivo GPS. QGIS utilizza GPSBabel per eseguire queste operazioni, perciò è raccomandato installare il software. Tuttavia, se si desidera solamente caricare dati GPS da un file GPX già esistente, non sarà necessario utilizzare il software. La versione 1.2.3 di GPSBabel lavora bene con QGIS, ma si dovrebbe lavorare senza problemi anche con le versioni precedenti.


\subsection{Importare dati GPS}
\label{docs/user_manual/working_with_gps/plugins_gps:importing-gps-data}
Per importare dati GPS da un file che non ha l'estensione GPX, si utilizza lo strumento \emph{Importa altri file} nella finestra Strumenti GPS. Qui è possibile selezionare il file (e il tipo di file), le caratteristiche che si desiderano importare dal file stesso., dove si desidera salvare il file GPX convertito e rinominare il nuovo layer che verrà generato. Da notare che alcuni formati di dati GPS non supportano tutte e tre le tipologie di dati, così per alcuni formati sarà opportuno scegliere tra uno o due tipologie di dati.


\subsection{Scaricare dati GPS da un dispositivo}
\label{docs/user_manual/working_with_gps/plugins_gps:downloading-gps-data-from-a-device}
QGIS utilizza GPSBabel per scaricare dati da un dispositivo GPS, e caricarli direttamente come nuovi layer vettoriali. Per questo si utilizza  \emph{Scarica dal GPS} strumento presente nella finestra di dialogo Strumenti GPS (vedi {\hyperref[docs/user_manual/working_with_gps/plugins_gps:figure-gps-2]{Figure\_GPS\_2}}). Qui, è possibile selezionare il tipo di dispositivo GPS, la porta alla quale il dispositivo è connesso (o la porta USB se il GPS supporta questa opzione), il tipo di dati che si desidera scaricare, il file GPX che contiene i dati da scaricare, e il nome del nuovo layer.
\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}

GPSBabel comunica con il GPS in base al tipo di dispositivo che viene selezionato nel menu. Se nessuna delle opzioni disponibili è compatibile con il proprio dispositivo GPS è possibile creare un nuovo tipo (vedi sezione \emph{definisci-nuovo-dispositivo}).

La porta potrebbe essere sia il nome del file o qualche altro nome che il sistema operativo del proprio computer riconosce come porta fisica  alla quale è connesso il dispositivo GPS. Questo potrebbe essere semplicemente il nome di una porta usb, nel caso di dispositivi abilitati per l'usb.
\begin{itemize}
\item {} 
\includegraphics[width=1em]{nix.png} Nei sistemi Linux è qualcosa di simile a \code{/dev/ttyS0} or \code{/dev/ttyS1}

\item {} 
\includegraphics[width=1em]{win.png} Su Windows è simile a \code{COM1} or \code{COM2}.

\end{itemize}

Quando si clicca su \textbf{{[}OK{]}} i dati saranno scaricati dal dispositivo e appariranno come nuovi layer in QGIS.


\subsection{Caricare dati GPS sul dispositivo}
\label{docs/user_manual/working_with_gps/plugins_gps:uploading-gps-data-to-a-device}
C'è anche la possibilità di caricare dati vettoriali da QGIS al dispositivo GPS utilizzando lo strumento \emph{Carica su GPS} presente sempre nella finestra di dialogo Strumenti GPS. Per effettuare questa operazione è necessario semplicemente selzionare il layer che si desidera caricare (che deve essere un layer GPX), il dispositivo GPS utilizzato, e la porta (o l'usb) alla quale il dispositivo è collegato. Come per lo scaricamento dei dati, anche per il caricamento è possible specificare un nuovo tipo di dispositivo se tra quelli della lista non è presente quello che si sta utilizzando.

Questo strumento è molto utile in combinazione con le capacità di editing dei dati vettoriali di QGIS. Permette di cariacare una mappa, creare delle posizioni o dei percorsi, e successivamente caricare questi dati nel dispositivo per poi utilizzarli in campagna.


\subsection{Definire un nuovo tipo di dispositivo}
\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}
Ci sono molteplici tipologie di dispositivi GPS. Gli sviluppatori non possono programmare tutti i dispositivi, perciò se si ha un dispositivo che non è presente nel menu a tendina delle finiestre \emph{Scarica dal GPS} e \emph{Carica su GPS}, è possibile configurare personalmente il proprio dispositivo. Per fare questo è possibile utilizzare l'editor dei dispositivi GPS, che si avvia cliccando sul bottone \textbf{{[}Modifica periferiche{]}} sia nella finestra di download che in quella di upload.

Per definire un nuovo dispositivo è necessario semplicemente cliccare il pulsante \textbf{{[}New device{]}}, inserire il nome, il comando di download e di upload del dispositivo, e cliccare il pulsante \textbf{{[}Update device{]}}. Il nome sarà inserito nella lista delle periferiche GPS sia nella finesta di download che nella finestra di upload e potrà essere selezionato. Il comando di download è il comando che viene utilizzato per scaricare i dati dal dispositivo come file GPX. Questo solitamente sarà un comando di GPSBabel, ma è possibile utilizzare altre strighe di comando con le quali è possibile creare un file GPX. QGIS rimpiazzerà i tasti \code{\%type}, \code{\%in}, e \code{\%out} quando il comando verrà lanciato.

\code{\%type} sarà interpretato come \code{-w} se si stanno scaricando dei waypoints, \code{-r} se si stanno scaricando delle routes e \code{-t} se si stanno scaricando dei trcks. Questi sono dei comandi opzionali con i quali è possibile dire a GPSBabel quali tipologie di file GPS si deisdera scaricare.

\code{\%in} indica il nome della porta selezionata nella finestra di download mentre \code{\%out} indica il nome del file GPX nel quale verranno salvati i dati. Dunque quando viene creato un nuovo dispositivo il seguente comando di download \code{gpsbabel \%type -i garmin -o gpx \%in \%out} (questo è il comando di download per la tipologia di dispositivi predefiniti `Garmin serial') verrà utilizzato per scaricare waypoints dalla porta \code{/dev/ttyS0} all'interno del file GPX \code{output.gpx}, QGIS leggerà la stringa e avvierà il comando \code{gpsbabel -w -i garmin -o gpx /dev/ttyS0 output.gpx}.

Il comando di upload è il comando che viene utilizzato per caricare dati sul dispositivo. Vengono utilizzati i stessi tasti, ma \code{\%in} è utilizzato per indicare il nome del file GPX che contiene il layer in caricamento, e \code{\%out} viene sostituito dal nome della porta.

E' possibile avere più informazioni su GPSBabel e sulle opzioni di comando disponibili al sito \href{http://www.gpsbabel.org}{http://www.gpsbabel.org}.

Una volta che è stato creato un nuovo dispositivo apparirà nel menù lista dei dispositivi sia nello strumento di downloads che nello strumento di upload.


\section{Tracciamento live GPS}
\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}
Per attivare il tracciamento live del GPS tramite QGIS è necessario selezionare \emph{Settings \(\rightarrow\)} \includegraphics{checkbox.png} \emph{Informazioni GPS}. Si aprirà una finestra ancorata nella parte sinistra del video.

Ci sono 4 possibili schermate nella finestra di tracciamento GPS:
\begin{itemize}
\item {} 
\includegraphics[width=1.5em]{mActionToggleEditing.png} Posizione coordinate GPS ed inserimento manuale di vertici e caratteristiche.

\item {} 
\includegraphics[width=1.5em]{gpstrack_barchart.png} Potenza del segnale di connessione del GPS ai satelliti.

\item {} 
\includegraphics[width=1.5em]{gpstrack_polarchart.png} Schermata delle coordinate polari del GPS che mostrano la posizione dei satelliti.

\item {} 
\includegraphics[width=1em]{mActionOptions.png} Opzioni di visualizzazione GPS (vedi {\hyperref[docs/user_manual/working_with_gps/live_GPS_tracking:figure-gps-options]{figura\_gps\_options}}).

\end{itemize}

Con un ricevitore GPS collegato(deve essere supportato dal sistema operativo) e con un semplice click su  \textbf{{[}Connetti{]}} il GPS viene collegato a QGIS. Con un secondo click (stavolta \textbf{{[}Disconnetti{]}}) il GPS viene disconnesso dal computer. Per i sistemi GNU/Linux il supporto gpsd è integrato nel sistema di connessione di molti ricevitori GPS. Perciò è necessario per prima cosa configurare le proprietà di gpsd per connettere il GPS al computer.

\begin{notice}{warning}{Avvertimento:}
Se si desidera registrare la propria posizione nello schermo è necessario creare un nuovo layer vettoriale ed entrare nella modalità di editing in modo da registrare il percorso.
\end{notice}


\subsection{Posizione e attributi aggiuntivi}
\label{docs/user_manual/working_with_gps/live_GPS_tracking:position-and-additional-attributes}
\includegraphics[width=1.5em]{mActionToggleEditing.png} Nel momento in cui il GPS sta ricevendo il segnale dei satelliti è possibile visualizzarne la propria posizione in termini di latitudine longitudine e quota, insieme ad altri attributi aggiuntivi.
\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{Potenza del segnale GPS}
\label{docs/user_manual/working_with_gps/live_GPS_tracking:gps-signal-strength}
\includegraphics[width=1.5em]{gpstrack_barchart.png} Con questa schermata è possibile vedere la potenza del seganale dei satelliti dai quali si sta ricevendo il segnale.
\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{Finestra delle coordinate polari del GPS}
\label{docs/user_manual/working_with_gps/live_GPS_tracking:gps-polar-window}
\includegraphics[width=1.5em]{gpstrack_polarchart.png} Se si desidera visualizzare la posizione dei satelliti nel cielo, è necessario passare alla visualizzazione polare. E' possibile anche vedere il numero identificativo ID dei satelliti dai cui il ricevitore sta ricevendo il segnale.
\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{Opzioni GPS}
\label{docs/user_manual/working_with_gps/live_GPS_tracking:gps-options}
\includegraphics[width=1em]{mActionOptions.png} Nel caso di problemi di connessione, è possibile passare a:
\begin{itemize}
\item {} 
\includegraphics{radiobuttonon.png} \emph{Autodetect}

\item {} 
\includegraphics{radiobuttonon.png} \emph{Internal},

\item {} 
\includegraphics{radiobuttonon.png} \emph{Serial device}

\item {} 
\includegraphics{radiobuttonon.png} \emph{gpsd} (selzionare l'Host la Porta ai quali è connseeo il dispositivo GPS).

\end{itemize}

Cliccare nuovamente \textbf{{[}Connect{]}} per iniziare la connessione al ricevitore 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}

You can activate \includegraphics{checkbox.png} \emph{Automatically save added features}
when you are in editing mode. Or you can can activate \includegraphics{checkbox.png}
\emph{Automatically add points} to the map canvas with a certain width
and color.

Una volta attivata \includegraphics{checkbox.png} \emph{Cursor} è possibile utilizzare un dispositivo di scottimento \includegraphics{slider.png} per ridurre o aumentare la posizione del cursore nello schermo.

Attivando \includegraphics{radiobuttonon.png} \emph{Map centering} è possibile decidere in che modo la schermata dovrà essere aggiornata. Questo include `always', `when leaving' se le coordinate registrate escono fuori dall'estensione della schermata, o `never' se rientrano nell'estensione della mappa.

Infine è possibile attivare \includegraphics{checkbox.png} \emph{Log file} e definire un percorso e un file dove registrare i messaggi a riguardo del tracciamento GPS.

Se si desidera impostare delle caratteristiche manuali è necessario tornare indietro \includegraphics[width=1.5em]{mActionToggleEditing.png}  $^{\text{Position}}$ e cliccare su \textbf{{[}Add Point{]}} or \textbf{{[}Add track point{]}}.

\index{GRASS}

\chapter{Integrazione con GRASS GIS}
\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}
Il plugin GRASS consente l’accesso ai dati e alle funzioni di GRASS GIS (vedi GRASS-PROJECT {\hyperref[docs/user_manual/literature_web/literature_and_web_references:literature-and-web]{\emph{Literature and Web References}}}) , inclusa la visualizzazione di layer raster e vettoriali, la digitalizzazione di layer vettoriali, la modifica degli attributi, la creazione di nuovi vettori e l’analisi di dati GRASS 2D e 3D tramite più di 300 moduli GRASS.

Questa sezione contiene un’introduzione sulle funzionalità del plugin e qualche esempio sulla gestione e l’utilizzo di dati GRASS. Quando viene abilitato il plugin GRASS, come descritto alla Sezione {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-starting-grass]{\emph{Avviare il plugin GRASS}}}, le seguenti funzionalità sono disponibili nella barra degli strumenti GRASS:
\begin{itemize}
\item {} 
\includegraphics[width=1.5em]{grass_open_mapset.png} $^{\text{Apri mapset}}$

\item {} 
\includegraphics[width=1.5em]{grass_new_mapset.png} $^{\text{Nuovo mapset}}$

\item {} 
\includegraphics[width=1.5em]{grass_close_mapset.png} $^{\text{Chiudi mapset}}$

\item {} 
\includegraphics[width=1.5em]{grass_add_vector.png} $^{\text{Aggiungi vettore GRASS}}$

\item {} 
\includegraphics[width=1.5em]{grass_add_raster.png} $^{\text{Aggiungi raster GRASS}}$

\item {} 
\includegraphics[width=1.5em]{grass_new_vector_layer.png} $^{\text{Crea nuovo vettore GRASS}}$

\item {} 
\includegraphics[width=1.5em]{grass_edit.png} $^{\text{Modifica vettore GRASS}}$

\item {} 
\includegraphics[width=1.5em]{grass_tools.png} $^{\text{Apri strumenti GRASS}}$

\item {} 
\includegraphics[width=1.5em]{grass_region.png} $^{\text{Visualizza la regione di GRASS attuale}}$

\item {} 
\includegraphics[width=1.5em]{grass_region_edit.png} $^{\text{Modifica la regione di GRASS attuale}}$

\end{itemize}

\index{GRASS!Start Plugin}

\section{Avviare il plugin 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}
Per usare le funzioni GRASS e/o visualizzare layer raster e vettoriali in formato GRASS in QGIS, bisogna prima selezionare e caricare il plugin GRASS con il gestore di plugin. Cliccare su \emph{Plugins \(\rightarrow\)} \includegraphics[width=1.5em]{mActionShowPluginManager.png} \emph{Gestione plugins}, selezionare \includegraphics{checkbox.png} \emph{GRASS} e cliccare su \textbf{{[}OK{]}}.

Ora è possibile caricare layer raster e vettoriali da una \code{LOCATION} GRASS esistente
(sezione {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-load-grassdata]{\emph{Caricare layer raster e vettoriali GRASS}}}).È anche possibile creare una nuova \code{LOCATION} GRASS in QGIS (sezione {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-create-loc]{\emph{Creare una nuova LOCATION GRASS}}}) e importarci dati raster e vettoriali (sezione {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-import-loc-data]{\emph{Importare dati nelle LOCATION GRASS}}}) per ulteriori analisi con gli strumenti GRASS (sezione {\hyperref[docs/user_manual/grass_integration/grass_integration:subsec-grass-toolbox]{\emph{Gli strumenti GRASS}}}).


\section{Caricare layer raster e vettoriali GRASS}
\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}
Con il plugin GRASS, possono essere caricati layer raster o vettoriali usando il pulsante appropriato nella barra strumenti. Come esempio si consideri il set di dati Alaska (Sezione {\hyperref[docs/user_manual/introduction/getting_started:label-sampledata]{\emph{Dati campione}}}) che contiene una \code{LOCATION} GRASS campione contenente tre layer vettoriali e una mappa di altitudine raster.
\begin{enumerate}
\item {} 
Creare una nuova cartella \code{grassdata}, nella quale scaricare il set di dati Alaska denominato \code{qgis\_sample\_data.zip} dall'indirizzo web \href{http://download.osgeo.org/qgis/data/}{http://download.osgeo.org/qgis/data/} e decomprimere il file nella cartella \code{grassdata}.

\item {} 
Avviare QGIS

\item {} 
If not already done in a previous QGIS session, load the GRASS plugin
clicking on \emph{Plugins \(\rightarrow\)} \includegraphics[width=1.5em]{mActionShowPluginManager.png}
\emph{Manage Plugins} and activate \includegraphics{checkbox.png} \emph{GRASS}.
The GRASS toolbar appears in the QGIS main window.

\item {} 
Nella barra degli strumenti GRASS, cliccare sull'icona \includegraphics[width=1.5em]{grass_open_mapset.png}$^{\text{Apri mapset}}$ per aprire la finestra \code{Scegli mapset GRASS}.

\item {} 
Alla voce \code{Gisdbase} inserire il’indirizzo completo o navigare fino alla cartella  \code{grassdata} appena creata.

\item {} 
Dovrebbe ora essere possibile selezionare la \emph{LOCATION} \includegraphics{selectstring.png} \code{alaska} e il \emph{MAPSET} \includegraphics{selectstring.png} \code{demo}.

\item {} 
Cliccare su \textbf{{[}OK{]}}. Si noti che ora alcuni degli strumenti precedentemente disabilitati sono divenuti attivi.

\item {} 
Cliccare su \includegraphics[width=1.5em]{grass_add_raster.png} $^{\text{Aggiungi raster GRASS}}$, scegliere la mappa denominata \code{gtopo30} e cliccare su \textbf{{[}OK{]}}. Verrà visualizzato il layer delle quote del terreno.

\item {} 
Cliccare su \includegraphics[width=1.5em]{grass_add_vector.png} $^{\text{Aggiungi vettore GRASS}}$, selezionare la mappa denominata \code{alaska} e cliccare su \textbf{{[}OK{]}}. Il confine Alaska verrà sovrapposto alla mappa \code{gtopo30}. Ora è possibile adattare le proprietà del layer come descritto nel capitolo {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-properties-dialog]{\emph{Proprietà dei layer vettoriali}}}, ovvero cambiare la trasparenza, il colore di riempimento e del contorno dell'elemento.

\item {} 
Caricare anche gli altri due layer vettoriali denominati \code{rivers} e \code{airports} e modificarne le proprietà.

\end{enumerate}

As you see, it is very simple to load GRASS raster and vector layers in QGIS.
See following sections for editing GRASS data and creating a new \code{LOCATION}.
More sample GRASS \code{LOCATIONs} are available at the GRASS website at
\href{http://grass.osgeo.org/download/data.php}{http://grass.osgeo.org/download/data.php}.

\begin{notice}{tip}{Suggerimento:}
\textbf{Caricare dati GRASS}

Se si presentano problemi nel caricare dati o QGIS termina inaspettatamente, assicurarsi di aver caricato il plugin GRASS correttamente come descritto alla Sezione {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-starting-grass]{\emph{Avviare il plugin GRASS}}}.
\end{notice}


\section{LOCATION e MAPSET in GRASS}
\label{docs/user_manual/grass_integration/grass_integration:grass-location-and-mapset}\label{docs/user_manual/grass_integration/grass_integration:sec-about-loc}
GRASS organizza i propri dati in cartelle alle quali si fa riferimento con la denominazione GISDBASE. Queste cartelle, spesso chiamate \code{grassdata}, devono essere create prima di iniziare a lavorare con il plugin GRASS in QGIS. In queste directory, i dati GRASS sono organizzati per progetti inseriti in sottocartelle chiamate \code{LOCATION}. Ogni \code{LOCATION} è definita da un sistema di coordinate, da una proiezione e dall’estensione geografica. La \code{LOCATION} può avere a sua volta molte sottocartelle denominate \code{MAPSET} usate per suddividere il progetto in diversi argomenti, sottoregioni o spazi di lavoro per i diversi membri del team che vi sta lavorando (Neteler \& Mitasova 2008 {\hyperref[docs/user_manual/literature_web/literature_and_web_references:literature-and-web]{\emph{Literature and Web References}}}). Per analizzare layer raster e vettoriali con i moduli GRASS, bisogna importarli in una \code{LOCATION} GRASS (tuttavia con i moduli di GRASS \code{r.external} e \code{v.external} è possibile creare dei collegamenti a database supportati da GDAL/OGR senza doverli importare. Questa funzione non è consigliabile a chi si sta avvicinando a GRASS e non verrà descritta di seguito).
\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{Creare una nuova LOCATION 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}
Per questo e per tutti i successivi esempi riguardanti GRASS GIS verrà usata la \code{LOCATION alaska} campione, nel sistema di riferimento Albers Equal Area, unità di misura in metri e creata dal set di dati campione di QGIS. Sarà utile scaricare ed installare il set di dati sul proprio computer ({\hyperref[docs/user_manual/introduction/getting_started:label-sampledata]{\emph{Dati campione}}}).
\begin{enumerate}
\item {} 
Avviare QGIS e assicurarsi che il plugin GRASS sia caricato

\item {} 
Visualizzare lo shapefile \code{alaska.shp} (sezione {\hyperref[docs/user_manual/working_with_vector/supported_data:vector-load-shapefile]{\emph{Caricare uno shapefile}}}) dal dataseti di dati alaska {\hyperref[docs/user_manual/introduction/getting_started:label-sampledata]{\emph{Dati campione}}}.

\item {} 
Nella barra strumenti GRASS, cliccare sull'icona \includegraphics[width=1.5em]{grass_new_mapset.png}$^{\text{Nuovo mapset}}$ per avviare la procedura guidata.

\item {} 
Selezionare la cartella contenente il database GRASS (GISDBASE) denominata \code{grassdata} o crearne una nuova in cui ospitare la nuova \code{LOCATION} usando il gestore di file installato sul proprio computer. Cliccare su \textbf{{[}Next{]}}.

\item {} 
Per creare un nuovo \code{MAPSET} in una \code{LOCATION} esistente (sezione {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-add-mapset]{\emph{Aggiungere un nuovo MAPSET}}}) o per creare una nuova \code{LOCATION},  selezionare l'opzione \includegraphics{radiobuttonon.png}\emph{Crea nuova location} (figura {\hyperref[docs/user_manual/grass_integration/grass_integration:figure-grass-location-2]{figure\_grass\_location\_2}}).

\item {} 
Inserire il nome della \code{LOCATION} - nell'esempio abbiamo usato alaska e cliccare su \textbf{{[}Next{]}}.

\item {} 
Definire la proiezione cliccando sull'opzione \includegraphics{radiobuttonon.png}\emph{Proiezione} per abilitare l'elenco delle proiezioni.

\item {} 
Scegliere la proiezione Albers Equal Area Alaska (feet). Siccome ne conosciamo l’identificativo EPSG 2964, inserirlo nella casella di ricerca. (Nota: se si vuole ripetere il processo per un’altra \code{LOCATION} e non si è memorizzato l’identificativo EPSG della proiezione, cliccare sull’icona \includegraphics[width=1.5em]{mIconProjectionEnabled.png} $^{\text{Stato SR}}$ a destra della barra di stato (sezione {\hyperref[docs/user_manual/working_with_projections/working_with_projections:label-projections]{\emph{Lavorare con le proiezioni}}})).

\item {} 
Cliccare su \emph{Trova} e inserire 2964 per selezionare la proiezione.

\item {} 
Cliccare su \textbf{{[}Next{]}}.

\item {} 
Per definire l’estensione della regione predefinita, bisogna inserire i limiti della \code{LOCATION} verso nord, sud, est e ovest. Nel nostro esempio cliccare semplicemente sul pulsante \emph{Imposta estensione attuale di QGIS}, per applicare l’estensione del layer caricato \code{alaska.shp} come estensione predefinita della regione GRASS.

\item {} 
Cliccare su \textbf{{[}Next{]}}.

\item {} 
Abbiamo anche bisogno di definire un \code{MAPSET} interno alla \code{LOCATION}. Il nome è a scelta, nell'esempio abbiamo usato demo. Quando si crea una nuova LOCATION, GRASS crea automaticamente un MAPSET speciale chiamato PERMANENT designato a contenere i dati di base del progetto, l’estensione spaziale predefinita e la definizione del sistema di coordinate (Neteler \& Mitasova 2008 {\hyperref[docs/user_manual/literature_web/literature_and_web_references:literature-and-web]{\emph{Literature and Web References}}})

\item {} 
Controllare il riassunto per assicurarsi che le impostazioni siano corrette e cliccare su \textbf{{[}Finish{]}}.

\item {} 
La nuova \code{LOCATION alaska} e i \code{MAPSETs demo} e \code{PERMANENT} vengono creati. Il set di lavoro impostato per il lavoro corrente è il \code{MAPSETs demo}.

\item {} 
Si noti che alcuni strumenti della barra di GRASS precedentemente disabilitati sono ora attivi.

\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}

Per quanto possa sembrare lunga, questa procedura costituisce un modo veloce per creare una \code{LOCATION}. La \code{LOCATION alaska} è ora pronta per l'importazione dei dati (sezione {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-import-loc-data]{\emph{Importare dati nelle LOCATION GRASS}}}). È possibile usare dati raster e vettoriali della \code{LOCATION alaska} del set di dati QGIS alaska ({\hyperref[docs/user_manual/introduction/getting_started:label-sampledata]{\emph{Dati campione}}}) e procedere alla sezione {\hyperref[docs/user_manual/grass_integration/grass_integration:label-vectmodel]{\emph{Il modello dati vettoriale di GRASS}}}.


\subsection{Aggiungere un nuovo MAPSET}
\label{docs/user_manual/grass_integration/grass_integration:adding-a-new-mapset}\label{docs/user_manual/grass_integration/grass_integration:sec-add-mapset}
Ogni utente ha accesso in scrittura solo ai \code{MAPSET} GRASS che ha creato. Ciò implica che oltre ad accedere ai propri MAPSET, l’utente può anche leggere i dati contenuti nei \code{MAPSET} creati da altri, ma può modificare o rimuovere solo i dati nei suoi \code{MAPSET}.

Tutti i \code{MAPSET} includono un file denominato \code{WIND} nel quale sono memorizzate le coordinate dei limiti della regione e la risoluzione spaziale impostata per i raster (Neteler \& Mitasova 2008 {\hyperref[docs/user_manual/literature_web/literature_and_web_references:literature-and-web]{\emph{Literature and Web References}}}, sezione {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-grass-region]{\emph{Lo strumento Regione di GRASS}}})).
\begin{enumerate}
\item {} 
Avviare QGIS e assicurarsi che il plugin GRASS sia caricato

\item {} 
Nella barra degli strumenti GRASS, cliccare sull’icona \includegraphics[width=1.5em]{grass_new_mapset.png} $^{\text{Nuovo mapset}}$ per avviare la procedura guidata di creazione del \code{MAPSET}.

\item {} 
Selezionare la cartella GRASS (GISDBASE) \code{grassdata} con il nome \code{LOCATION alaska}, nel quale si vuole aggiungere un ulteriore \code{MAPSET}, che chiameremo test.

\item {} 
Cliccare su \textbf{{[}Next{]}}.

\item {} 
Con questa procedura possiamo creare un nuovo \code{MAPSET} all'interno di una \code{LOCATION} esistente e creare anche una nuova \code{LOCATION} contemporaneamento. Cliccare sull'opzione \includegraphics{radiobuttonon.png}\emph{Selezionare location} (figura {\hyperref[docs/user_manual/grass_integration/grass_integration:figure-grass-location-2]{figure\_grass\_location\_2}}) e cliccare su \textbf{{[}Next{]}}.

\item {} 
Inserire il nome \code{text} per il nuovo \code{MAPSET}. Più in basso nella finestra è visibile una lista di \code{MAPSETs} esistenti e i relativi proprietari.

\item {} 
Cliccare su \textbf{{[}Next{]}}, controllare il riassunto per assicurarsi che le impostazioni siano corrette e cliccare su \textbf{{[}Finish{]}}.

\end{enumerate}


\section{Importare dati nelle LOCATION 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}
Questa Sezione fornisce un esempio su come importare dati raster e vettoriali nella \code{LOCATION} GRASS \code{alaska} fornita dal set di dati QGIS alaska. Verrà usata la mappa raster dell’uso del suolo \code{landcover.img} e il file vettoriale GML \code{lakes.gml}.
\begin{enumerate}
\item {} 
Avviare QGIS e assicurarsi che il plugin GRASS sia caricato

\item {} 
In the GRASS toolbar, click the \includegraphics[width=1.5em]{grass_open_mapset.png}$^{\text{Open
MAPSET}}$ icon to bring up the \code{MAPSET} wizard.

\item {} 
Select as GRASS database the folder \code{grassdata} in the QGIS
alaska dataset, as \code{LOCATION alaska}, as \code{MAPSET}
\code{demo} and click \textbf{{[}OK{]}}.

\item {} 
Cliccare ora sullo strumento \includegraphics[width=1.5em]{grass_tools.png} $^{\text{Apri strumenti GRASS}}$. Apparirà la finestra degli strumenti di GRASS (sezione {\hyperref[docs/user_manual/grass_integration/grass_integration:subsec-grass-toolbox]{\emph{Gli strumenti GRASS}}}).

\item {} 
Per importare la mappa raster \code{landcover.img}, cliccare sul modulo \code{r.in.gdal} nella scheda \emph{Albero moduli}. Questo modulo GRASS consente l’importazione di file supportati da GDAL in una \code{LOCATION} GRASS. Apparirà la finestra di dialogo del modulo  \code{r.in.gdal}.

\item {} 
Navigare nella cartella \code{raster} nel set di dati QGIS alaska e selezionare il file \code{landcover.img}.

\item {} 
Come nome del raster in uscita inserire \code{landcover\_grass} e cliccare su \textbf{{[}Esegui{]}}. Nella scheda \emph{Output} è possibile verificare l'avanzamento del comando GRASS \code{r.in.gdal -o input=/path/to/landcover.img output=landcover\_grass}.

\item {} 
Quando compare la dicitura \textbf{Operazione conclusa con successo} cliccare sul pulsante \textbf{{[}Visualizza output{]}}. Il layer raster \code{landcover\_grass} è ora importato in GRASS e verrà visualizzato nella vista mappa di QGIS.

\item {} 
Per importare il vettore \code{lakes.gml}, usare il modulo \code{v.in.ogr} nella scheda \emph{Albero moduli}. Questo modulo GRASS consente di importare i formati vettoriali supportati da OGR in una \code{LOCATION} GRASS. Apparirà la finestra di dialogo \code{v.in.ogr}.

\item {} 
Navigare alla cartella \code{gml} nel set di dati QGIS alaska e selezionare il file \code{lakes.gml} come file OGR.

\item {} 
Come nome del vettore in uscita inserire \code{lakes\_grass} e cliccare su \textbf{{[}Esegui{]}}.In questo esempio è possibile trascurare altre opzioni. Nella scheda \emph{Output} è possibile verificare l'avanzamento del comando GRASS \code{v.in.ogr -o dsn=/path/to/lakes.gml output=lakes\_grass}.

\item {} 
Quando compare la dicitura \textbf{Operazione conclusa con successo} cliccare sul pulsante \textbf{{[}Visualizza output{]}}. Il layer vettoriale \code{lakes\_grass} è ora importato in GRASS e verrà visualizzato nella vista mappa di QGIS.

\end{enumerate}


\section{Il modello dati vettoriale di 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}
È importante comprendere il modello dati vettoriale di GRASS, per gestire nella maniera ottimale le attività di digitalizzazione.

\index{GRASS!digitizing}
In generale, GRASS usa un modello dati vettoriale topologico.

\index{GRASS!topology}
Questo significa che le aree non sono rappresentate con poligoni chiusi singoli, ma da uno o più contorni (boundary). Un contorno tra due aree adiacenti è digitalizzato una sola volta e condiviso da entrambe le aree. Perché un’area sia topologicamente corretta, i contorni devono essere connessi senza soluzione di continuità. Un’area è identificata (ed etichettata) dal suo \textbf{centroide}.

Oltre a contorni e centroidi, una mappa vettoriale può contenere anche punti e linee. Tutti questi elementi possono essere compresenti in un singolo layer vettoriale e saranno rappresentati con ’livelli’ differenti in una mappa vettoriale GRASS. Quindi in GRASS con ’layer’ non s’intende una mappa raster o vettoriale bensì un livello all’interno di un dato vettoriale. Questa è una distinzione molto importante da tenere presente (Sebbene sia possibile mescolare elementi geometrici di diverso tipo (punti, linee, contorni e centroidi), ciò è abbastanza insolito e perfino in GRASS viene usato solo in casi speciali come ad es. quando si esegue l’analisi di una rete vettoriale. Di solito è preferibile che elementi geometrici diversi vengano digitalizzati su file distinti).

È possibile salvare più ’livelli’ in un set di dati vettoriale. Per esempio campi, foreste e laghi possono essere salvati in un vettore. Foreste e laghi adiacenti possono condividere lo stesso contorno, ma avranno tabelle degli attributi distinte. È anche possibile assegnare attributi ai contorni. Ad esempio se il contorno tra un lago ed una foresta è una strada, questa può avere una diversa tabella degli attributi.

Il livello di un elemento è definito layer in GRASS. Layer è il numero che indica se c’è più di un gruppo geometrico nel set di dati vettoriale, ad es. se la geometria è foresta o lago. Attualmente tale indice può essere solo un numero, in versioni di GRASS successive saranno supportati anche stringhe di testo.

Gli attributi degli elementi geometrici possono essere memorizzati nella \code{LOCATION} GRASS in formato DBase o SQLITE3 o in database esterni come PostgreSQL, MySQL, Oracle, ecc.

\index{GRASS!attribute storage}
Gli attributi contenuti nelle tabelle del database sono collegati alla geometria per il tramite di un valore ’category’.

\index{GRASS!attribute linkage}
’Category’ (key, ID) è un valore intero collegato alle primitive geometriche ed è usato come collegamento ad una colonna chiave nella tabella del database.

\begin{notice}{tip}{Suggerimento:}
\textbf{Conoscere il modello dati vettoriale di GRASS}

Il miglior modo per capire il modello dati vettoriale di GRASS e le sue capacità è quello di scaricare una delle molte guide (tutorial) di GRASS nelle quali tale modello è descritto più approfonditamente. Si veda \href{http://grass.osgeo.org/gdp/manuals.php}{http://grass.osgeo.org/gdp/manuals.php} per informazioni, libri e guide in diverse lingue.
\end{notice}

\index{GRASS|see{Creating new vectors;editing;creating a new layer}}

\section{Creare un nuovo layer vettoriale 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}
Per creare un nuovo layer vettoriale GRASS tramite il plugin GRASS cliccare sullo strumento  \includegraphics[width=1.5em]{grass_new_vector_layer.png} $^{\text{Crea un nuovo vettore GRASS}}$. Inserire un nome nella casella di testo e iniziare la digitalizzazione di punti, linee o poligoni, seguendo la procedura descritta alla sezione {\hyperref[docs/user_manual/grass_integration/grass_integration:grass-digitizing]{\emph{Digitalizzare e modificare layer vettoriali GRASS}}}.

In GRASS è possibile gestire ogni tipo di geometria (punti, linee ed aree) in un singolo layer, in quanto viene impiegato un modello dati vettoriale topologico; di conseguenza non è necessario definire a priori il tipo di geometria che si intende utilizzare per un nuovo vettore. In questo il modello dati di GRASS si differenzia ad esempio dal formato shapefile di QGIS, che usa un modello vettoriale denominato Simple Feature (sezione {\hyperref[docs/user_manual/working_with_vector/editing_geometry_attributes:sec-create-shape]{\emph{Creare nuovi layer vettoriali}}}).

\begin{notice}{tip}{Suggerimento:}
\textbf{Creare una tabella attributi per un nuovo layer vettoriale GRASS}

Se si desidera assegnare attributi alla geometria digitalizzata, accertarsi di definire lo schema della tabella prima di iniziare a digitalizzare (figura {\hyperref[docs/user_manual/grass_integration/grass_integration:figure-grass-digitizing-5]{figure\_grass\_digitizing\_5}}).
\end{notice}


\section{Digitalizzare e modificare layer vettoriali 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}
Gli strumenti di digitalizzazione per i layer vettoriali GRASS sono accessibili con l'icona\textbar{}grass\_edit\textbar{} $^{\text{Modifica vettore GRASS}}$ nella barra degli strumenti GRASS. Assicurarsi di caricare un vettoriale GRASS e che esso sia selezionato nella legenda prima di attivare lo strumento di digitalizzazione. La figura {\hyperref[docs/user_manual/grass_integration/grass_integration:figure-grass-digitizing-2]{figure\_grass\_digitizing\_2}} mostra la finestra di dialogo degli strumenti di digitalizzazione GRASS che viene mostrata quando si clicca sullo strumento di modifica. Gli strumenti e le impostazioni di questa barra saranno discussi nelle
sezioni seguenti.

\begin{notice}{tip}{Suggerimento:}
\textbf{Digitalizzare poligoni in GRASS}

Per creare poligoni in GRASS, bisogna iniziare con il digitalizzarne i contorni, impostando preliminarmente il modo Nessuna categoria. Una volta chiuso il poligono, aggiungere un centroide (punto dell’etichetta) all’interno del contorno chiuso impostando preliminarmente la modalità Prossimo non in uso. Questa procedura è necessaria in quanto il modello di dati vettoriale topologico collega le informazioni sull’attributo del poligono
sempre al centroide e non al contorno.
\end{notice}
\phantomsection\label{docs/user_manual/grass_integration/grass_integration:label-grasstoolbar}
\textbf{Barra degli strumenti di digitalizzazione}

Nella figura {\hyperref[docs/user_manual/grass_integration/grass_integration:figure-grass-digitizing-1]{figure\_grass\_digitizing\_1}} sono mostrate le icone della barra degli strumenti per la digitalizzazione del plugin GRASS. La tabella {\hyperref[docs/user_manual/grass_integration/grass_integration:table-grass-digitizing-1]{table\_grass\_digitizing\_1}} mostra le funzioni disponibili.
\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 
Icona
} & \textsf{\relax 
Strumento
} & \textsf{\relax 
Azione
}\\
\hline
\includegraphics[width=1.5em]{grass_new_point.png}
 & 
Nuovo punto
 & 
Digitalizza un nuovo punto
\\

\includegraphics[width=1.5em]{grass_new_line.png}
 & 
Nuova linea
 & 
Digitalizza una nuova linea
\\

\includegraphics[width=1.5em]{grass_new_boundary.png}
 & 
Nuovo contorno
 & 
Digitizalizza nuovo contorno (annullare selezionando un altro strumento)
\\

\includegraphics[width=1.5em]{grass_new_centroid.png}
 & 
Nuovo centroide
 & 
Digitalizza un nuovo centroide (imposta l’etichetta per un’area esistente)
\\

\includegraphics[width=1.5em]{grass_move_vertex.png}
 & 
Sposta vertice
 & 
Sposta un vertice di una linea o contorno esistente in una nuova posizione
\\

\includegraphics[width=1.5em]{grass_add_vertex.png}
 & 
Aggiungi vertice
 & 
Aggiunge un vertice ad una linea o contorno esistente
\\

\includegraphics[width=1.5em]{grass_delete_vertex.png}
 & 
Elimina vertice
 & 
ancella vertici da linee e contorni esistenti (confermare l’eliminazione del vertice selezionato cliccando una seconda volta)
\\

\includegraphics[width=1.5em]{grass_move_line.png}
 & 
Sposta elemento
 & 
Sposta il contorno, la linea, il punto o il centroide selezionato in una nuova posizione
\\

\includegraphics[width=1.5em]{grass_split_line.png}
 & 
Dividi linea
 & 
Divide una linea o un contorno in due parti nel punto selezionato
\\

\includegraphics[width=1.5em]{grass_delete_line.png}
 & 
Elimina elemento
 & 
Elimina un contorno, una linea, un punto o un centroide esistente (confermare cliccando una seconda volta)
\\

\includegraphics[width=1.5em]{grass_edit_attributes.png}
 & 
Modifica attributi
 & 
Modifica gli attributi dell’elemento selezionato (si noti che ad un elemento possono essere associati più attributi, si veda sopra)
\\

\includegraphics[width=1.5em]{grass_close_edit.png}
 & 
Chiudi
 & 
Chiude la sessione e salva lo stato attuale (ricostruisce la topologia)
\\
\hline\end{tabulary}

\begin{quote}

Tabella Strumenti per la digitalizzazione in GRASS
\end{quote}

\textbf{Scheda Categoria}

\index{GRASS!category settings}
La scheda \emph{Category} consente di definire il modo in cui i valori della categoria verranno assegnati al nuovo elemento geometrico.
\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{Modalità}: modalità con la quale viene assegnata la categoria (colonna cat della tabella) alle geometrie digitalizzate.
\begin{itemize}
\item {} 
Prossimo non in uso - applica il primo valore non utilizzato in ordine numerico crescente.

\item {} 
Inserimento manuale - definizione manuale della categoria da assegnare all’elemento.

\item {} 
Nessuna categoria - non assegna alcun valore all’elemento. Questa modalità è in genere usata ad esempio per i contorni dei poligoni ai quali la categoria viene collegata tramite il centroide.

\end{itemize}

\item {} 
\textbf{Categoria}- Il numero (ID) inserito o visualizzato viene associato ad ogni elemento digitalizzato. Viene usato per collegare ogni elemento geometrico ai relativi attributi.

\item {} 
\textbf{Layer} - Ogni elemento geometrico può essere collegato con molteplici tabelle attributo usando diversi livelli (“layer”) secondo il modello GRASS: il numero del layer predefinito è 1.

\end{itemize}

\begin{notice}{tip}{Suggerimento:}
\textbf{Creare un livello GRASS aggiuntivo con QGIS}

Se si vogliono aggiungere ulteriori livelli al set di dati, inserire semplicemente un numero nel campo `Layer' e dare invio. Nella scheda Tabella sarà a questo punto possibile creare il nuovo schema degli attributi da associare a questo livello.
\end{notice}
\phantomsection\label{docs/user_manual/grass_integration/grass_integration:label-settingtab}
\textbf{Scheda Preferenze}

\index{GRASS!snapping tolerance}
La scheda \emph{Preferenze} consente di impostare la tolleranza per l’aggancio automatico tra elementi (snapping) in pixels dello schermo. La soglia definisce a quale distanza massima nuovi punti o linee sono agganciati ad altri nodi esistenti. Ciò aiuta ad evitare interruzioni o incroci tra contorni. Il valore preimpostato è 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{Scheda Simbologia}

\index{GRASS!symbology settings}
La scheda \emph{Simbologia} consente di visualizzare e impostare la simbologia e i colori dei vari tipi geometrici nei vari stati topologici (ad es. contorni aperti/chiusi).
\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{Scheda Tabella}

\index{GRASS!table editing}
La scheda \emph{Tabella{}`fornisce informazioni sulla struttura della tabella per un determinato livello. È possibile aggiungere nuove colonne ad una tabella attributi esistente o creare un nuovo schema tabella per un nuovo layer vettoriale GRASS o per un nuovo livello (sezione  :ref:{}`creating\_new\_grass\_vectors}).
\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}{Suggerimento:}
\textbf{Permessi di modifica in GRASS}

È necessario essere il proprietario del \code{MAPSET} GRASS che si vuole editare. Non è possibile modificare dati in un \code{MAPSET} del quale non si è proprietari, anche se si possiedono su di esso permessi in scrittura.
\end{notice}


\section{Lo strumento Regione di 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}
L’impostazione di una regione (ovvero di una porzione di spazio geografico nella quale operare) è molto importante in GRASS, specialmente quando si lavora con dati raster. L’analisi vettoriale non è limitata all’impostazione della regione ma interessa tutta l’estensione del layer. Tutti i raster di nuova creazione avranno l’estensione e la risoluzione spaziale della regione GRASS definita, indipendentemente dalla loro estensione e risoluzione originale. L’impostazione corrente della regione GRASS è salvata nel file \code{\$LOCATION/\$MAPSET/WIND} che ne definisce i limiti nord, sud est e ovest, il numero di righe e colonne e la risoluzione spaziale in senso orizzontale e verticale.

È possibile abilitare/disabilitare la visualizzazione della regione di GRASS nella vista mappa in QGIS usando il pulsante \includegraphics[width=1.5em]{grass_region.png} $^{\text{Visualizza la regione di GRSS attuale}}$.

\index{GRASS!region display}
Con lo strumento \includegraphics[width=1.5em]{grass_region_edit.png} $^{\text{Modifica la regione di GRAS attuale}}$ è possibile aprire una finestra di dialogo per cambiare le impostazioni correnti della regione e la simbologia con la quale il rettangolo che la rappresenta viene visualizzato nella vista mappa di QGIS. Inserire i nuovi limiti della regione e la risoluzione e cliccare su \textbf{{[}OK{]}} . Lo strumento consente anche di selezionare l’estensione della regione interattivamente con il mouse nella vista mappa di QGIS. Cliccando con il tasto sinistro del mouse nella vista mappa si imposta il primo angolo del rettangolo che definirà la regione e cliccando in un altro punto lo si chiuderà: cliccare su \textbf{{[}OK{]}} per confermare.

\index{GRASS!region editing}
Il modulo GRASS \code{g.region} mette a disposizione molti più parametri per definire l’estensione della regione e la risoluzione con la quale si vuole condurre l’analisi raster. Si possono usare questi parametri tramite lo strumento GRASS appropriato {\hyperref[docs/user_manual/grass_integration/grass_integration:subsec-grass-toolbox]{\emph{Gli strumenti GRASS}}}.


\section{Gli strumenti 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}
Cliccando su \includegraphics[width=1.5em]{grass_tools.png} $^{\text{Apri strumenti GRASS}}$ si ha accesso alle funzionalità dei moduli GRASS con i quali lavorare nella \code{LOCATION} e nel \code{MAPSET} impostati. Per usare gli strumenti di GRASS è necessario aprire una \code{LOCATION} e un \code{MAPSET} sui quali si abbiano permessi di scrittura (in genere concessi se si è l’utente che ha creato il \code{MAPSET}). Ciò è necessario in quanto i nuovi layer raster o vettoriali creati durante l’analisi devono poter essere scritti nella \code{LOCATION} e nel \code{MAPSET} selezionati.
\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 shell di GRASS fornisce accesso a praticamente tutti gli oltre 330 moduli GRASS in modalità riga di comando. Per offrire un ambiente di lavoro maggiormente user-friendly, circa 200 di questi moduli e loro relative funzionalità sono presentati in finestre di dialogo. Questi moduli sono raggruppati in blocchi tematici: è disponibile una funzione di ricerca.


\subsection{Lavorare con i moduli GRASS}
\label{docs/user_manual/grass_integration/grass_integration:grass-modules}\label{docs/user_manual/grass_integration/grass_integration:working-with-grass-modules}
La shell di GRASS fornisce accesso a praticamente tutti gli oltre 300 moduli GRASS in modalità riga di comando. Per offrire un ambiente di lavoro maggiormente user-friendly, circa 200 di questi moduli e loro relative funzionalità sono presentati in finestre di dialogo. Questi moduli sono raggruppati in blocchi tematici: è disponibile una funzione di ricerca.

È possibile trovare la lista completa dei moduli GRASS accessibili tramite l’interfaccia grafica di QGIS nel wiki di GRASS: \href{http://grass.osgeo.org/wiki/GRASS-QGIS\_relevant\_module\_list}{http://grass.osgeo.org/wiki/GRASS-QGIS\_relevant\_module\_list}.

È possibile personalizzare il contenuto della finestra di dialogo degli strumenti GRASS: la procedura è descritta nella sezione {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-toolbox-customizing]{\emph{Personalizzare gli strumenti GRASS}}}.

Come mostrato in figura {\hyperref[docs/user_manual/grass_integration/grass_integration:figure-grass-toolbox-1]{figure\_grass\_toolbox\_1}} , è possibile ricercare il modulo GRASS desiderato per aree tematiche nella scheda \emph{Albero moduli} o nella scheda \emph{Lista moduli} che permette la ricerca per parola chiave.

Clicking on a graphical module icon a new tab will be added to the toolbox dialog
providing three new sub-tabs \emph{Options}, \emph{Output} and \emph{Manual}.

\textbf{Opzioni}

La scheda \emph{Opzioni} fornisce una finestra semplificata nel quale di solito è possibile selezionare un layer raster o vettoriale ed inserire ulteriori opzioni specifiche per l’esecuzione del modulo.
\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}

Per mantenere la leggibilità della finestra non sempre sono presenti tutte le opzioni: qualora si volessero usare ulteriori parametri per il modulo è necessario avviare la shell di GRASS ed eseguire il modulo dalla riga di comando.

Una nuova caratteristica di QGIS 1.8.0 è il supporto per un pulsante \emph{Mostra le opzioni avanzate} nella scheda \emph{Opzioni} della finestra di dialogo semplificata di un modulo. Al momento tale funzionalità è disponibile per pochi moduli, ma probabilmente sarà estesa ad altri moduli nelle prossime versioni di QGIS. Ciò permetterà di sfruttare appieno le potenzialità dei moduli di GRASS senza dover usare la shell.

\textbf{Output}
\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}

The \emph{Output} tab provides information about the output status of the
module. When you click the \textbf{{[}Run{]}} button, the module switches to the
\emph{Output} tab and you see information about the analysis process. If
all works well, you will finally see a \code{Successfully finished} message.

\textbf{Manuale}
\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}

La scheda \emph{Manuale} mostra la pagina di aiuto in formato HTML del modulo GRASS scelto: permette di verificare la disponibilità di ulteriori parametri o ottenere una conoscenza più approfondita delle operazioni che il modulo può eseguire. Alla fine di ogni pagina di manuale vi sono ulteriori collegamenti al \code{Main Help index}, al \code{Thematic index} o al \code{Full index}. Questi link forniscono le stesse informazioni che si avrebbero usando il modulo  \code{g.manual}.

\index{GRASS!display results}
\begin{notice}{tip}{Suggerimento:}
\textbf{Mostrare i risultati immediatamente}

Se si desidera visualizzare il risultato di un’analisi immediatamente nella vista mappa, è possibile cliccare sul pulsante Visualizza Output nella porzione inferiore della scheda.
\end{notice}


\subsection{Esempi di utilizzo di moduli GRASS}
\label{docs/user_manual/grass_integration/grass_integration:grass-module-examples}
Gli esempi che seguono mostrano le potenzialità di alcuni moduli GRASS.


\subsubsection{Creare curve di livello}
\label{docs/user_manual/grass_integration/grass_integration:creating-contour-lines}
Come primo esempio, deriviamo le curve di livello a partire da un modello digitale di elevazione (DEM): si assume che la \code{LOCATION} Alaska sia impostata come descritto nella sezione {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-import-loc-data]{\emph{Importare dati nelle LOCATION GRASS}}}.
\begin{itemize}
\item {} 
Aprire la ’location’ Alaska cliccando su \includegraphics[width=1.5em]{grass_open_mapset.png} $^{\text{Apri mapset}}$ .

\item {} 
Caricare il DEM \code{gtopo30} cliccando su \includegraphics[width=1.5em]{grass_add_raster.png} $^{\text{Aggiungi raster GRASS}}$ e selezionare \code{gtopo30} dal mapset demo.

\item {} 
Aprire gli strumenti GRASS con \includegraphics[width=1.5em]{grass_tools.png} $^{\text{Apri strumenti GRASS}}$.

\item {} 
Nell'albero dei moduli cliccare su \emph{Raster \(\rightarrow\) Gestione superficie \(\rightarrow\) Genera curve di livello vettoriali}.

\item {} 
Cliccando su \textbf{r.contour} si aprirà la finstra di dialogo dello strumento com spiegato in {\hyperref[docs/user_manual/grass_integration/grass_integration:grass-modules]{\emph{Lavorare con i moduli GRASS}}}. Il raster \code{gtopo30} dovrebbe apparire in \emph{Nome della mappa raster in input}.

\item {} 
Inserire in \emph{Incrementa fra le isoipse} \includegraphics{selectnumber.png} il valore 100. (per creare curve di livello ad intervalli di 100 metri)

\item {} 
Inserire in \emph{Nome del vettoriale in output} il nome \code{ctour\_100}.

\item {} 
Cliccare su \textbf{{[}Esegui{]}} ed attendere fino alla comparsa del messaggio \code{Operazione conclusa con successo}: quindi cliccare su \textbf{{[}Visualizza{]}} risultato e su \textbf{{[}Chiudi{]}}.

\end{itemize}

Dal momento che la regione è pittosto estesa, il comando richiede del tempo. Una volta terminata l'operazione è possibile modificare le proprietà del nuovo layer vettoriale come descritto in {\hyperref[docs/user_manual/working_with_vector/vector_properties:vector-properties-dialog]{\emph{Proprietà dei layer vettoriali}}}.

Ingrandendo una porzione della mappa in un’area più montagnosa si potrà notare come le curve di livello appaiano spigolose. In GRASS è disponibile il modulo \textbf{v.generalize} per alterare leggermente un vettore senza modificarne la forma generale: il modulo utilizza diversi algoritmi, ognuno per uno scopo specifico. Alcuni algoritmi (es. Douglas Peuker e Vertex reduction) semplificano una linea rimuovendo alcuni vertici: il risultato sarà più veloce da caricare. Tale tipo di algoritmo è ad esempio molto utile nel caso in cui si abbia una mappa vettoriale molto dettagliata, ma si sta lavorando ad una scala molto piccola per cui tanto dettaglio non è necessario.

\index{GRASS!display results}
\begin{notice}{tip}{Suggerimento:}
\textbf{Semplifica geometrie}

Si noti che lo strumento \emph{Semplifica geometrie} di fTools opera allo stesso modo dell’algoritmo Douglas-Peuker di \textbf{v.generalize}.
\end{notice}

Ad ogni modo, lo scopo dell’esempio è diverso: le curve di livello create con \code{r.contour} hanno angoli molto acuti che devono essere smussati. Tra gli algoritmi di \textbf{v.generalize} Chaikens (o anche Hermite splines) fa al caso nostro. Si noti che l’algoritmo potrebbe \textbf{aggiungere} dei vertici, rendendo il caricamento della mappa ancora più lento.
\begin{itemize}
\item {} 
Aprire gli strumenti di GRASS e lanciare il modulo \emph{Vettore \(\rightarrow\) Elabora mappa \(\rightarrow\) Generalizzazione} e cliccare su \textbf{v.generalize}.

\item {} 
Controllare che `ctour\_100' appaia come \emph{Nome della mappa vettoriale in input}.

\item {} 
Scegliere Chaiken's come algoritmo di generalizzazione ed inserire il \emph{Nome del vettoriale in output} `ctour\_100\_smooth' e cliccare su \textbf{{[}Esegui{]}}.

\item {} 
Il processo richiederà un po' di tempo. Una volta che viene visualizzato \code{Operazione conclusa con successo}, cliccare su \textbf{{[}Visualizza output{]}} e poi su \textbf{{[}Chiudi{]}}.

\item {} 
È possibile modificare il colore del layer vettoriale in modo da renderlo ben visibile sul raster si sfondo. Si potrà notare come le curve di livello ora appaiano meno spigolose.

\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}{Suggerimento:}
\textbf{Altri usi di r.contour}

La procedura appena descritta può essere usata in situazioni equivalenti. Se si ha un raster delle
precipitazioni, ad esempio, si può usare r.contour per derivare le isoiete (curve a precipitazione costante).
\end{notice}


\subsubsection{Creare un rilievo ombreggiato con effetto 3D}
\label{docs/user_manual/grass_integration/grass_integration:creating-a-hillshade-3d-effect}
Ci sono diversi modi per visualizzare dati di elevazione e dare un effetto 3D alla vista. L’uso delle curve di livello è uno dei metodi più utilizzato, sopratutto nella produzione di mappe topografiche. Un altro modo consiste nell’utilizzare l’ombreggiatura. L’ombra viene derivata da un DEM, calcolando prima pendenze ed orientamento, poi simulando la posizione del sole nel cielo per assegnare un valore di riflettanza per ogni cella del raster: in tal modo le pendenze in ombra saranno più scure di quelle esposte al sole.
\begin{itemize}
\item {} 
Caricare il raster \code{gtopo30}, aprire gli strumenti di GRASS e lanciare il modulo \emph{Analisi spaziali \(\rightarrow\) Analisi geomorfologica}.

\item {} 
Cliccare \textbf{r.shaded.relief} per aprire il modulo.

\item {} 
Impostare l'\emph{azimuth} \includegraphics{selectnumber.png} da 270 a 315.

\item {} 
Inserire \code{gtopo30\_shade} per il nuovo raster delle ombreggiature e cliccare su \textbf{{[}Esegui{]}}.

\item {} 
Quando il processo sarà completato, aggiungere il raster ombreggiatura alla vista mappa.

\item {} 
Il nuovo raster verrà visualizzato in scala di grigi: per vedere contemporaneamente l’ombreggiatura ed i colori di \code{gtopo30}, portare \code{gtopo30\_shade} sotto \code{gtopo30} nella legenda, quindi aprire le  \emph{Proprietà} di \code{gtopo30}, andare nella scheda \emph{Trasparenza} ed impostare il livello di trasparenza al 25\%.

\end{itemize}

Si dovrebbe vedere \code{gtopo30} \textbf{sopra} la mappa di ombreggiatura in scala di grigi. Per riuscire a visualizzare appieno gli effetti dell'ombreggiatura, deselezionare \code{gtopo30\_shade}.

\textbf{Usare la shell di GRASS}

Il plugin GRASS è orientato principalmente agli utenti che non conoscono GRASS ed i suoi moduli, con relative opzione, per cui molti moduli non mostrano tutte le possibili opzione ed altri non sono affatto presenti. La shell di GRASS consente di accedere ai moduli che non appaiono nell’interfaccia grafica ed alle opzioni aggiuntive di quelli che invece ci sono. Il seguente esempio mostra l’uso di un’opzione del modulo \textbf{r.shaded.relief}.
\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}

The module \textbf{r.shaded.relief} can take a parameter \code{zmult} which multiplies
the elevation values relative to the X-Y coordinate units so that the hillshade
effect is even more pronounced.
\begin{itemize}
\item {} 
Caricare \code{gtopo30} ed aprire la shell di GRASS. Nella shell scrivere il comando \code{r.shaded.relief map=gtopo30 shade=gtopo30\_shade2 azimuth=315 zmult=3} e premere \textbf{{[}invio{]}}.

\item {} 
Quando il comando ha terminato, spostarsi nella scheda \emph{Browse} della finestra di dialogo degli strumenti GRASS e fare doppio click sul nuovo raster \code{gtopo30\_shade2} per visualizzarlo in QGIS.

\item {} 
Impostare le proprietà del raster così come descritto in precedenza. L'effetto 3D dovrebbe apparire più pronunciato rispetto alla mappa creata in precedenza.

\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{Statistiche raster in una mappa vettoriale}
\label{docs/user_manual/grass_integration/grass_integration:raster-statistics-in-a-vector-map}
Il prossimo esempio tratta di un modulo GRASS che può aggregare dati raster ed aggiungere colonne di statistiche per ogni poligono di una mappa vettoriale.
\begin{itemize}
\item {} 
Importare in GRASS lo shapefile trees nella cartella \code{shapefiles} {\hyperref[docs/user_manual/grass_integration/grass_integration:sec-import-loc-data]{\emph{Importare dati nelle LOCATION GRASS}}}.

\item {} 
Prima di proseguire bisogna aggiungere i centroidi ai poligoni per farne delle aree vettoriali secondo il modello dati di GRASS.

\item {} 
Aprire gli strumenti di GRASS e lanciare il modulo \emph{Vettore \(\rightarrow\) Gestisci elementi}, e aprire il modulo \textbf{v.centroids}.

\item {} 
Inserire come \emph{Nome del vettoriale in output} `forest\_areas' e lanciare il modulo.

\item {} 
Caricare{}`{}`forest\_areas{}`{}` e visualizzare le categorie - deciduous, evergreen, mixed - con colori differenti. Aprire le \emph{Proprietà} del layer, andare nella scheda \emph{Stile}, scegliere \emph{Stile} \includegraphics{selectstring.png} `Categorizzato' e impostare `VEGDESC' come campo di classificazione. (sezione \emph{sec\_symbology}).

\item {} 
Aprire il modulo \emph{Vettore \(\rightarrow\) Aggiornamento di un vettore} da altre mappe.

\item {} 
Cliccare su \textbf{v.rast.stats} per aprire il modulo e inserire \code{gtopo30} e \code{forest\_areas}.

\item {} 
Inserire \emph{column prefix} \code{elev}, e cliccare su \textbf{{[}Esegui{]}}: l'operazione potrebbe durare molto tempo.

\item {} 
Aprire la tabella degli attributi di \code{forest\_areas} e verificare come sianto state aggiunte diverse nuove colonne, come ad esempio \code{elev\_min}, \code{elev\_max}, \code{elev\_mean} per ogni tipo di poligono.

\end{itemize}


\subsection{Lavorare con il browser delle LOCATION GRASS}
\label{docs/user_manual/grass_integration/grass_integration:working-with-the-grass-location-browser}
\index{GRASS toolbox!Browser}
Un'altra utile funzione tra quelle presenti negli strumenti GRASS è il browser delle \code{LOCATION}. In figura {\hyperref[docs/user_manual/grass_integration/grass_integration:figure-grass-module-7]{figure\_grass\_module\_7}} è possibile vedere un esempio che mostra la \code{LOCATION} impostata e i relativi \code{MAPSETs}.

Nella parte sinistra della finestra del browser si può navigare attraverso tutti i \code{MAPSETs} contenuti nella \code{LOCATION} impostata. La porzione di destra mostra invece alcuni metadati del raster o del vettoriale selezionato, come la risoluzione, l’estensione spaziale, la fonte del dato, il percorso alla tabella attributi associata per i dati vettoriali e lo storico comandi che ha generato quel dato.
\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 barra degli strumenti nella scheda \emph{Browser} offre i seguenti strumenti per la gestione della \code{LOCATION}:
\begin{itemize}
\item {} 
\includegraphics[width=1.5em]{grass_add_map.png} \emph{Aggiungi la mappa selezionata all'area di lavoro}

\item {} 
\includegraphics[width=1.5em]{grass_copy_map.png} \emph{Copia la mappa selezionata}

\item {} 
\includegraphics[width=1.5em]{grass_rename_map.png} \emph{Rinomina la mappa selezionata}

\item {} 
\includegraphics[width=1.5em]{grass_delete_map.png} \emph{Elimina la mappa selezionata}

\item {} 
\includegraphics[width=1.5em]{grass_set_region.png} \emph{Imposta la regione corrente con la mappa selezionata}

\item {} 
\includegraphics[width=1.5em]{grass_refresh.png} \emph{Aggiorna}

\end{itemize}

Gli strumenti \includegraphics[width=1.5em]{grass_rename_map.png} \emph{Rinomina la mappa selezionata} e \includegraphics[width=1.5em]{grass_delete_map.png} \emph{Elimina la mappa selezionata} funzionano solo su mappe contenute nel \code{MAPSET} attivo. Tutti gli altri strumenti funzionano anche con layer raster e vettoriali di altri \code{MAPSET}.


\subsection{Personalizzare gli strumenti 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}
Praticamente tutti i moduli GRASS possono essere aggiunti nella finestra di dialogo degli strumenti GRASS. Per incorporare i file XML di configurazione dei moduli è fornita un’interfaccia XML nella quale è possibile definire l’aspetto del modulo e i parametri da visualizzare nella finestra di dialogo degli strumenti.

Un esempio di file XML che genera il modulo \code{v.buffer} (v.buffer.qgm) ha il seguente aspetto:

\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}

Il parser legge questa definizione e crea una nuova scheda nella finestra di dialogo degli strumenti GRASS quando si seleziona il modulo. Informazioni più dettagliate su come aggiungere moduli, cambiare i gruppi di moduli ecc. sono reperibile sul Wiki di QGIS all’indirizzo \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}
Il progetto OpenStreetMap (OSM) si sta ampiamente diffondendo, sopratutto in quei paesi dove non si hanno a disposizione dati geografici liberi. L’obiettivo di OSM è la creazione di una mappa aggiornabile e libera del mondo a partire da dati GPS, foto aeree e conoscenza locale. Per supportare tale obiettivo, QGIS mette a disposizione un plugin che permette di lavorare con i dati OSM.

Il plugin offre le principali funzionalità per la manipolazione dei dati OSM; download/upload dei dati, salvataggio, modifica. Nell’implementare il plugin, il team di sviluppo ha preso ispirazione dagli editor di dati OSM esistenti, nell’obiettivo di combinare le loro funzionalità in un unico prodotto.

La sezione seguente, fornisce una breve introduzione ai principi del progetto OSM.

Parti del paragrafo che segue sono riprese dal sito web di OpenStreetMap: \href{http://www.openstreetmap.org}{http://www.openstreetmap.org} \textless{}\href{http://www.openstreetmap.org}{http://www.openstreetmap.org}\textgreater{}.


\section{Il progetto OpenStreetMap}
\label{docs/user_manual/osm/openstreetmap:the-openstreetmap-project}
L’obiettivo di OSM è la creazione di una mappa aggiornabile e libera del mondo a partire da dati GPS, foto aeree e conoscenza locale. Il progetto è stato iniziato perché molti dati geografici hanno restrizioni legali e tecniche, che impediscono il loro utilizzo in maniera creativa e produttiva. I dati di OSM e le immagini da esse derivate sono, invece, disponibili sotto la licenza Creative Commons Attribution ShareAlike 2.0.
\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 si è ispirato a progetti tipo Wikipedia: la mappa di OSM (Figura  {\hyperref[docs/user_manual/osm/openstreetmap:figure-openstreetmap-1]{Figure\_OpenStreetMap\_1}} ) mostra una ben visibile scheda \emph{Edit} e viene mantenuto lo storico di tutte le modifiche effettuate. Gli utenti registrati possono caricare track GPS ed editare dati vettoriali utilizzando gli editor disponibili.

La ’primitiva dati’ di OSM è una classe oggetto che può essere memorizzata via API nel server. I tre tipi di dati supportati sono: \textbf{Node} (nodo), \textbf{Way} (via) e \textbf{Relation} (relazione).
\begin{itemize}
\item {} 
Un \textbf{nodo} è una coppia latitudine/longitudine di coordinate: è il punto di partenza per la costruzione di tutti gli altri elementi ed è un elemento esso stesso (POI - Point of Interest).

\item {} 
Una \textbf{via} è un elenco di almeno due nodi che descrivono un elemento lineare, es. una strada. I nodi possono essere parte di più ’vie’.

\item {} 
Una \textbf{relazione} è un gruppo di zero o più primitive con ruoli associati. È usata per specificare il rapporto tra oggetti e per modellare un oggetto astratto.

\end{itemize}

Queste primitive sono usate per definire diversi elementi logici di una mappa (’Point Of Interest’, ’Street’, ’Tram Line’, ’Bus Stop’ etc.). Gli elementi di mappa sono ben noti nella comunità OSM e sono memorizzati tramite etichette basate su una chiave ed un valore. I dati OSM sono solitamente distribuiti in formato XML, che è usato anche per la comunizazione con i server OSM.


\section{QGIS - Connessione a OSM}
\label{docs/user_manual/osm/openstreetmap:qgis-osm-connection}\label{docs/user_manual/osm/openstreetmap:id1}
La prima parte di questa sezione descrive come le primitive OSM sono visualizzate QGIS. Come precedentemente descritto, i dati OSM consistono di ’node’, ’way’ e ’relation’. In QGIS le tre primitive vengono visualizzate con differenti tipi di layer: punti, linee, poligoni. Non è possibile rimuovere uno di questi layer e lavorare con i rimanenti.
\begin{itemize}
\item {} 
Un \textbf{layer di punti} visualizza i soli elementi di tipo ’node’ che non sono parte di ’way’.

\item {} 
Un \textbf{layer di linee} visualizza gli elementi di tipo ’way’ non chiusi (a formare poligoni): nessuna delle ’way’ inizia e finisce nello stesso ’node’.

\item {} 
Un \textbf{layer di poligoni} visualizza tutte le ’way’ non incluse nel layer di linee, cioè le linee chiuse.

\end{itemize}

In aggiunta alle tre primitive OSM appena descLe \textbf{Relation} non sono visualizzate come layer vettoriale in quanto servono a definire le connessioni tra le altre primitive dati: dopo che un punto/linea/poligono è individuato sulla mappa, il plugin mostra un elenco delle relazioni di cui l’elemento è parte.

Ha richiesto un notevole impegno tentare di collegare i dati OSM con gli strumenti di modifica standard di QGIS. Tali strumenti sono fatti per modificare un singolo layer alla volta, a prescindere dal tipo di elemento: ciò significa che se i dati OSM venissero caricati in QGIS tramite il plugin, sarebbe teoricamente possibile modificare i layer di punti, di linee, di poligoni separatamente con gli strumenti standard.

Un layer di linee consiste di due diversi tipi di elementi OSM, ’node’ e ’way’. Nel formato OSM, una ’way’ è composta di ’node’; se si modifica un layer di linee, ad esempio cambiando la forma di qualche elemento, tale azione influenza anche i ’node’ che sono parte dello stesso.

Gli strumenti di modifica standard di QGIS non sono in grado di gestire tale tipo di relazioni e inviare correttamente le modifiche alla banca dati OSM. Il layer di linee non tiene traccia di quali ’node’ sono parte di quale ’way’: lo stesso problema si ha con i layer di poligoni.

Per tale ragione, il plugin OSM necessita dei propri strumenti di modifica, tramite i quali le modifiche ai layer OSM vengono gestiti correttamente. Gli strumenti di modifica del plugin permettono di creare/muovere/eliminare punti, linee, poligoni, relazioni.

\begin{notice}{note}{Nota:}
\textbf{Nota}: Per creare una connessione tra il plugin OSM e gli strumenti di modifica standard di QGIS, sarebbero necessarie modifiche a livello di codice.
\end{notice}


\section{Installazione}
\label{docs/user_manual/osm/openstreetmap:installation}
Il plugin OpenStreetMap è un plugin core di QGIS. Se il supporto a python è abilitato, il plugin può essere attivato nel gestore di plugin, come descritto nella Sezione {\hyperref[docs/user_manual/plugins/plugins:load-core-plugin]{\emph{Abilitare un Plugin Core}}}.


\section{Interfaccia utente di base}
\label{docs/user_manual/osm/openstreetmap:basic-user-interface}
In seguito all’attivazione del plugin OSM, ed al caricamento di alcuni dati, nel menu delle barra degli strumenti di QGIS appaiono diverse icone OSM, insieme alla nuova componente grafica mostrata in Figura {\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{Pannello Elemento OSM}
\label{docs/user_manual/osm/openstreetmap:osm-features-widget}
Il pannello Elemento OSM consente di identificare gli elementi OSM, fornendo informazioni sul tipo di elemento, sul suo identificatore, su chi l’ha modificato e quando: in esso sono, inoltre, presenti tutti gli strumenti di modifica, di seguito descritti. Il pannello è inizialmente disabilitato: viene abilitato al caricamento di dati OSM.


\subsection{Pannello Storico modifiche OSM}
\label{docs/user_manual/osm/openstreetmap:osm-undo-redo-widget}
Il pannello ’Storico modifiche OSM’ permette di annullare/ripristinare le modifiche più recenti. Oltre ai pulsanti classici di annulla/ripristina, mostra una lista con una breve descrizione delle operazioni di modifica più recenti. Il pannello, inizialmente nascosto, può essere attivato con l’apposito pulsante del pannello Elemento OSM.


\subsection{Icone nel menu della barra degli strumenti}
\label{docs/user_manual/osm/openstreetmap:toolbar-menu-icons}
\includegraphics[width=1.5em]{osm_load.png} $^{\text{Load OSM from file}}$ permette di caricare dati da file OSM in XML.

\includegraphics[width=1.5em]{osm_featureManager.png} $^{\text{Show/Hide OSM Feature Manager}}$ permette di visualizzare/nascondere l’Elemento OSM. L' Elemento OSM è un pannello che aiuta ad identificare e modificare gli elementi OSM.

\includegraphics[width=1.5em]{osm_download.png} $^{\text{Download OSM data}}$ per scaricare dati dai server di OpenStreetMap.

\includegraphics[width=1.5em]{osm_upload.png} $^{\text{Upload OSM data}}$ permette di salvare le modifiche ai dati correnti.

\includegraphics[width=1.5em]{osm_import.png} $^{\text{Import data from a layer}}$ permette di importare dati da layer vettoriali: è necessario caricare almeno un layer vettoriale e selezionare alcuni dati OSM.

\includegraphics[width=1.5em]{osm_save.png} $^{\text{Save OSM to file}}$ permette di salvare dati OSM in un file XML.

Informazioni più dettagliate sui vari elementi, comandi e maschere di dialogo, possono essere rinvenute nelle relative sezioni di questo capitolo, in relazione alla loro funzione (modifica, identificazione, ecc..).


\section{Caricare dati OSM}
\label{docs/user_manual/osm/openstreetmap:loading-osm-data}
La prima azione dopo aver lanciato il plugin consiste nell’aprire alcuni dati da un file OSM: i dati OSM possono essere importati come shapefile o scaricati dai server di OSM. Qui di seguito ci si riferisce alla prima modalità.

Per caricare dati da un file utilizzare l’icona \includegraphics[width=1.5em]{osm_load.png} $^{\text{Load OSM from file}}$: se l'icona non è visualizzata, il plugin potrebbe essere stato disabilitato durante l'installazione di QGIS. Abilitarlo da \emph{Visualizza\(\rightarrow\) Barre degli strumenti \(\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}

La funzione dei suoi elementi è spiegata di seguito.

\textbf{File OpenStreetMap da caricare}:Cliccare sul pulsante \includegraphics{browsebutton.png} per selezionare il file .{}`.osm{}` da cui si vogliono caricare i dati.

\textbf{Aggiungi colonne per i tag}: permette di creare una connessione tra OSM e QGIS. Ogni elemento OSM ha alcune etichette (coppia chiave-valore) che ne definiscono le proprietà: anche ogni elemento di un layer vettoriale di QGIS ha i propri attributi (chiave-valore). Con questa opzione è possibile definire quali proprietà degli oggetti OSM devono essere visibili quando si visualizzano le informazioni dell’elemento QGIS.

\textbf{Sostituisci i dati in uso}: attivando l’opzione, i nuovi dati sostituiscono quelli su cui l’utente stava precedentemente lavorando. Se si sta caricando dati OSM per la prima volta, l’opzione non è attiva.

\textbf{Usa un visualizzatore personalizzato}: consente di determinare quanti dettagli della mappa visualizzare (si può scegliere tra Small scale, Medium scale, Large scale). Usare \emph{Small scale} per visualizzare il massimo dei dettagli e compiere delle modifiche ai dati. QGIS 1.8.0 non supporta il cambiamento dinamico del visualizzatore.

Cliccare su \textbf{{[}OK{]}} per caricare i dati: l’operazione potrebbe richiedere alcuni minuti nel caso il file fosse caricato per la prima volta.


\section{Visualizzare dati OSM}
\label{docs/user_manual/osm/openstreetmap:viewing-osm-data}
Una volta caricati i dati è possibile ottenere informazioni sui vari elementi tramite l’icona \includegraphics[width=1.5em]{osm_identify.png} $^{\text{Informazioni elemento}}$ nel pannello Elemento OSM. In questo modo è possibile esplorare facilmente tutte gli oggetti sulla mappa. Posizionando il cursore del mouse su un elemento di interesse, le informazioni relative vengono mostrate nel pannello suddetto: nella vista mappa l’elemento risulta evidenziato. Un collegamento dinamico sulla mappa consente inoltre all'utente di identificare facilmente l' elemento correntemente selezionato.

La scheda \emph{Proprietà} del pannello Elemento OSM contiene tutte le etichette dell’elemento: la scheda \emph{Relazioni} mostra, invece, tutte le relazioni connesse all’elemento in questione.

Si noti che allontanando il cursore del mouse dall’elemento di interesse, le relative informazioni scompaiono: cliccando con il tasto sinistro del mouse sull’elemento, invece, le informazioni restano visibili sino ad un successivo click.

Spesso nel punto in cui si clicca potrebbero essere presenti più elementi, specialmente nel caso di incroci di strade. In questa situazione, anche se sono mostrate le informazioni di un solo elemento (marcato dal collegamento dinamico), il plugin mantiene in memoria le informazioni di tutti: E' quindi possibile (sempre in modalità ``pausa'') scorrere le informazioni degli altri elementi con cliccando con il tasto-destro e selezionando i successivi.


\section{Modificare dati OSM}
\label{docs/user_manual/osm/openstreetmap:editing-basic-osm-data}
Si intendano per ``dati di base'' gli elementi OSM ’node’ e ’way’ non relazionali. Per le modifiche di elementi relazionali fare riferimento alla sezione dedicata.

La modifica dei dati di base è una delle caratteristiche sostanziali del plugin OSM. È possibile rimuovere/aggiungere elementi di base, modificarne le proprietà, la posizione, la forma. Tutti i cambiamenti sono elencati nel pannello ’Storico modifiche OSM’ e possono essere facilmente caricati sui server di OSM.


\subsection{Cambiare l’etichetta di un elemento}
\label{docs/user_manual/osm/openstreetmap:changing-feature-tags}
Il cambiamento dell’etichetta di un elemento OSM viene fatto direttamente nella tabella delle etichette: tale tabella si trova nel pannello Elemento OSM, ma per visualizzarla bisogna preventivamente usare lo strumento \includegraphics[width=1.5em]{osm_identify.png} $^{\text{Informazioni elemento}}$. Ricordarsi di selezionare preventivamente l'elemento.
\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}

Per cambiare il valore di un’etichetta, fare doppio-click in una casella della colonna ’Value’ ed inserire, o selezionare, il nuovo valore. Per rimuovere un’etichetta selezionarne la riga e cliccare su \includegraphics[width=1.5em]{osm_removeTag.png} $^{\text{Remove selected tags}}$ in fondo alla tabella sulla destra.

Per inserire una nuova etichetta, inserire chiave e valore nell’ultima riga della tabella, dove appare la scritta `\textless{}next tag value\textgreater{}’: non è possibile cambiare la chiave di un coppia ’key/value’ esistente. Una serie di menu a tendina permettono di selezionare tra i valori tipici di una specifica chiave.


\subsection{Creare punti}
\label{docs/user_manual/osm/openstreetmap:point-creation}
Per creare un nuovo punto, cliccare su \includegraphics[width=1.5em]{osm_createPoint.png} $^{\text{Crea punto}}$, quindi sulla mappa. Se il cursore del mouse passa sopra qualche elemento della mappa, l’elemento viene evidenziato e le sue informazioni appaiono nel pannello Elemento OSM; se si clicca sulla mappa quando una linea o un poligono sono evidenziati, il nuovo punto viene creato direttamente su questi elementi e sarà, quindi, parte di essi (è attiva una funzionalità di snap). Non si può creare un punto su un punto esistente: il plugin mostrerà il seguente messaggio:
\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}

Il meccanismo che aiuta l'utente a selezionare una linea o un poligono si chiama ``snap''. Se si intende creare un punto molto vicino ad un elemento esistente, ma non su di esso, bisogna disabilitare la funzionalità di snap: tenere premuto \code{Ctrl} prima di cliccare sulla mappa.


\subsection{Creare linee}
\label{docs/user_manual/osm/openstreetmap:line-creation}
Per creare una nuova linea, cliccare su \includegraphics[width=1.5em]{osm_createLine.png} $^{\text{Crea linea}}$, quindi sulla mappa. Ogni click con tasto sinistro crea un vertice della nuova linea: per terminare la creazione di una linea basta cliccare con il tasto destro.

\begin{notice}{note}{Nota:}
\textbf{Nota}: Non è possibile creare una linea con meno di due vertici: in tal caso l'operazione viene ignorata. Se si clicca con il tasto destro del mouse dopo un solo click con il tasto sinistro, nessuna linea viene creata.
\end{notice}

Lo snap è attivo su ogni vertice della mappa - punti del layer di punti e tutte le componenti delle linee e dei poligoni. Per disattivare lo snap tenere premuto \code{Ctrl} prima di cliccare sulla mappa.


\subsection{Creare poligoni}
\label{docs/user_manual/osm/openstreetmap:polygon-creation}
Per creare un nuovo poligono, cliccare su\textbar{}osm\_createPolygon\textbar{} $^{\text{Create polygon}}$, quindi sulla mappa. Ogni click con tasto sinistro sarà un vertice del nuovo poligono: per terminare la creazione di una linea basta cliccare con il tasto destro. Non possono essere creati poligoni con meno di tre vertici. Lo snap è attivo su ogni vertice della mappa - punti (su un layer di punti) e su tutte le componenti delle linee e dei poligoni. Per disattivare lo snap tenere premuto \code{Ctrl} prima di cliccare sulla mappa.


\subsection{Spostare un elemento}
\label{docs/user_manual/osm/openstreetmap:map-feature-moving}
Per spostare un elemento cliccare su \includegraphics[width=1.5em]{osm_move.png} $^{\text{Muovi elemento}}$: posizionarsi nella mappa, portare il cursore del mouse sull’elemento che si intende spostare, cliccare con il tasto sinistro, portare l’elemento nella nuova posizione e cliccare di nuovo con il tasto sinistro. Nel caso si fosse selezionato l’elemento sbagliato, non effettuare il secondo click con il tasto sinistro: cliccando con il tasto destro, l’elemento sarà automaticamente riportato nella sua posizione originale.

Se si sposta una elemento connesso con altri elementi, le loro relazioni non saranno modificate: gli altri elementi si autoadatteranno alla nuova posizione dell’elemento cui sono relazionati.

Anche per questa operazione è disponibile la funzionalità di snap:
\begin{itemize}
\item {} 
– quando si muove un punto singolo (cioè che non è parte di una linea/poligono), lo snap è attivo su tutti i vertici ed i segmenti in mappa.

\item {} 
– quando si muove un punto che è parte di una linea/poligono, lo snap è attivo su tutti i vertici ed i segmenti in mappa, tranne i vertici degli elementi di cui il punto fa parte.

\item {} 
– quando si muove una linea/poligono, lo snap è attivo su tutti i vertici in mappa. Si noti che il plugin cerca di basare lo snap sui 3 vertici della linea/poligono da spostare più vicini al cursore del mouse, altrimenti l’operazione sarebbe estremamente lenta. Per disattivare lo snap tenere premuto \code{Ctrl} prima di cliccare sulla mappa.

\end{itemize}


\subsection{Eliminare un elemento}
\label{docs/user_manual/osm/openstreetmap:map-feature-removing}
Per eliminare un elemento selezionarlo con Informazioni elemento e cliccare su Rimuovi elemento . Rimuovendo una linea/poligono, vengono rimossi anche tutti i punti che ne fanno parte (ma che non fanno parte di altre linee/poligoni).

Quando si rimuove un punto che fa parte di una linea/poligono, il punto è rimosso e la forma degli elementi cui apparteneva si modifica: la nuova geometria avrà meno vertici della precedente.

Se il punto da eliminare fa parte di un poligono con soli tre vertici, la nuova geometria del poligono avrà due vertici; ma siccome non possono esistere poligoni con due vertici, il tipo di elemento viene modificato automaticamente convertito in linea.

Se il punto faceva parte di una linea con due vertici, la nuova geometria della linea avrà un solo punto. E siccome non possono esistere linee di un solo punto, il tipo di elemento viene modificato in punto.


\section{Modificare le relazioni}
\label{docs/user_manual/osm/openstreetmap:editing-osm-relation}\label{docs/user_manual/osm/openstreetmap:editing-relations}
Le relazioni permettono di organizzare più elementi in gruppi ed assegnare loro proprietà comuni, in modo da poter modellare qualsiasi oggetto di mappa: es. confini di una regione come gruppo di ’way’ (linee) e ’node’ (punti), percorsi di un bus, etc. Ogni membro di una relazione ha un suo ruolo specifico.
Il plugin di QGIS offre un buon supporto alle relazioni OSM.
Di seguito viene riportato come esaminare, creare, aggiornare o rimuovere una relazione.


\subsection{Esaminare una relazione}
\label{docs/user_manual/osm/openstreetmap:id2}\label{docs/user_manual/osm/openstreetmap:examining-relation}
Per esaminare una relazione, selezionare prima un suo membro, quindi aprire la scheda \emph{Relazioni} del pannello Elemento OSM, dove saranno elencate tutte le relazioni di cui l’elemento è parte. Selezionare una di esse per avere il dettaglio delle informazioni. Nella prima tabella, ’Tag relazione’, sono visualizzate le proprietà della relazione selezionata. Nella tabella ’Membri della relazione’ sono elencati i membri della relazione, cioè tutti gli elementi connessi dalla relazione selezionata. Cliccando su uno dei membri, lo stesso viene evidenziato in mappa.


\subsection{Creare una relazione}
\label{docs/user_manual/osm/openstreetmap:relation-creation}
Vi sono due modalità con cui è possibile creare una relazione:
\begin{enumerate}
\item {} 
Usare il pulsante \includegraphics[width=1.5em]{osm_createRelation.png}$^{\text{Crea relazione}}$ del pannello Elemento OSM.

\item {} 
Usare il pulsante \emph{Aggiungi relazione} nella scheda \includegraphics[width=1.5em]{osm_addRelation.png}$^{\text{Relazioni}}$ del pannello Elemento OSM.

\end{enumerate}

In entrambi i casi apparirà una finestra di dialogo.  Nel secondo caso, l’elemento selezionato è automaticamente considerato il primo membro della relazione ed il dialogo è precompilato in minima parte. Selezionare un tipo di relazione, tra quelle predefinite e disponibili nel menu a tendina, o crearne una nuova, quindi inserire le etichette della relazione e selezionare i suoi membri.

Una volta selezionato un tipo di relazione, cliccare su \includegraphics[width=1.5em]{osm_generateTags.png} $^{\text{Genera i tags}}$: nel riquadro ’Proprietà’ saranno elencate le etichette tipiche per il tipo di relazione. Inserire i valori nella colonna ’Value’ Per inserire i membri della relazione è possibile scrivere direttamente i loro identificatori, tipi e ruoli oppure usare il pulsante \includegraphics[width=1.5em]{osm_identify.png} $^{\text{Scegli un membro sulla mappa}}$. Cliccare su \emph{Crea} per terminare l’operazione.

Solo una volta scelto il tipo, etichetta e membro, la finestra di dialogo può ricevere conferma. Il plugin creerà quindi una nuova relazione.


\subsection{Modificare una relazione}
\label{docs/user_manual/osm/openstreetmap:changing-relation}
Per modificare una relazione esistente, selezionarla innanzitutto come visto nella precedente sezione ’Esaminare una relazione’, quindi cliccare su \includegraphics[width=1.5em]{osm_editRelation.png} $^{\text{Modifica relazione}}$. Nella finestra di dialogo \emph{Edit OSM relation} è possibile modificare le etichette, i membri o il tipo di relazione: cliccare su \emph{Save} per salvare i cambiamenti.


\section{Scaricare dati OSM}
\label{docs/user_manual/osm/openstreetmap:downloading-osm-data}
Per scaricare dati dal server di OpenStreetMap cliccare su \includegraphics[width=1.5em]{osm_download.png}$^{\text{Download OSM data}}$. Qualora il pulsante non fosse disponibile nell’interfaccia di QGIS, la barra degli strumenti OpenStreetMap potrebbe essere stata disattivata durante l'installazione di QGIS. Per attivarla cliccare su: menuselection:\emph{Visualizza --\textgreater{} Barre degli Strumenti --\textgreater{}OpenStreetMap} . Apparirà quindi la finestra di dialogo \emph{Download dati OSM} per fornire le seguenti funzionalità:
\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{Estensione}: permette di impostare l’area da scaricare, indicando le coordinate i gradi di latitudine e longitudine. Prestare attenzione a non indicare un’area troppo vasta: il server di OpenStreetMap ha delle restrizioni sulla quantità di dati scaricabili. Ulteriori informazioni sull’estensione dei dati sono disponibili cliccando su \includegraphics[width=1.5em]{osm_questionMark.png} $^{\text{?}}$.

\textbf{Download in}: il percorso alla cartella in cui salvare i dati. Niente panico nel caso in cui non ci si ricordi la struttura dell'.hard disk.il bottone di navigazione \includegraphics{browsebutton.png} è pronto per aiutarvi.

\textbf{Apri i dati automaticamente una volta scaricati}: permette di definire se caricare i dati non appena scaricati. Se non si desidera caricare subito i dati disattivare l’opzione: i dati potranno essere caricati in un secondo momento cliccando su \includegraphics[width=1.5em]{osm_load.png} $^{\text{Load OSM from file}}$.

\textbf{Sostituisci i dati in uso}: l’opzione è disponibile solo se lo è anche \includegraphics{radiobuttonon.png} \emph{Apri i dati automaticamente una volta scaricati}. Attivando l’opzione, i dati scaricati andranno a sostituire quelli presenti nella vista mappa di QGIS: i layer presenti nella vista mappa saranno rimossi e sostituiti dai nuovi. Quando si avvia QGIS e si scaricano dati OSM per la prima volta, l’opzione non è attiva, in quanto non c’è nulla da sostituire.

\textbf{Usa un visualizzatore personalizzato}:l’opzione è  attiva solo se lo è anche \includegraphics{radiobuttonon.png} \emph{Apri i dati automaticamente una volta scaricati}. Determinare quanti dettagli della mappa visualizzare (scelta tra Small scale, Medium scale, Large scale). Usare \emph{Small scale} per visualizzare il massimo dei dettagli e compiere delle operazioni di modifica. QGIS 1.8.0 non supporta il cambiamento dinamico dello stile del visualizzatore.

Cliccare su \textbf{{[}Download{]}} per avviare il processo di download dei dati.

Una finestra di dialogo mostra la percentuale di download. Qualora ci fossero errori, un’ulteriore finestra mostra il tipo di errore occorso. A completamento del download, le varie finestre di chiudono automaticamente.


\section{Caricare i dati sul server OSM}
\label{docs/user_manual/osm/openstreetmap:uploading-osm-data}
Il caricamento dei dati sul server OSM riguarda i dati visualizzati nella vista mappa di QGIS: prima di caricare i dati assicurarsi che nella vista mappa siano visualizzati i dati corretti.

Per caricare i dati sul server OSM, cliccare su  \includegraphics[width=1.5em]{osm_upload.png}$^{\text{Upload OSM data}}$. Qualora il pulsante non fosse disponibile nell’interfaccia di QGIS, la barra degli strumenti OpenStreetMap potrebbe essere disattivata: per attivarla cliccare su \emph{Visualizza \(\rightarrow\) Barre degli Strumenti \(\rightarrow\) OpenStreetMap}. Verrà aperta la finestra di dialogo \textbf{{[}Invia dati a OSM{]}}.
\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}

In alto nella finestra è possibile verificare la correttezza dei dati che si sta caricando. Nella tabella vengono elencati i cambiamenti che si stanno apportando, mentre sono riportate separatamente delle statistiche per ogni tipo di elemento.

In ’Commenti alle tue modifiche’ è possibile inserire delle informazioni aggiuntive: elencare brevemente le modifiche apportate. Compilare i campi ’Account OSM’ per l’autenticazione sul server: per creare un account OSM visitare la pagina web \href{http://www.openstreetmap.org}{http://www.openstreetmap.org} \textless{}\href{http://www.openstreetmap.org}{http://www.openstreetmap.org}\textgreater{}. Infine, cliccare \textbf{{[}Upload{]}} per avviare il processo di invio dei dati.


\section{Salvare i dati OSM}
\label{docs/user_manual/osm/openstreetmap:saving-osm-data}
Per salvare dati in un file XML, cliccare su \includegraphics[width=1.5em]{osm_save.png}$^{\text{Save OSM to file}}$. Qualora il pulsante non fosse disponibile nell’interfaccia di QGIS, la barra degli strumenti OpenStreetMap potrebbe essere disattivata: per attivarla cliccare su \emph{Visualizza \(\rightarrow\) Barre degli Strumenti \(\rightarrow\) OpenStreetMap}. Verrà aperta la finestra di dialogo \textbf{{[}Salva OSM{]}}.
\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}

Selezionare gli elementi da salvare come file XML, ed il file stesso cui salvarli, dopodichè cliccare su \textbf{{[}Ok{]}} per avviare il processo. La versione OSM del file XML è la 0.6: gli elementi non vengono ordinati.

Si noti che verranno salvati i soli dati non solo dalla vista mappa. Linee e poligoni sono salvati interamente, anche se sono visualizzati solo in parte: per ogni linea/poligono anche tutti i suoi vertici sono salvati.


\section{Importare dati in OSM}
\label{docs/user_manual/osm/openstreetmap:import-osm-data}
Per importare dati in OSM da un layer vettoriale non-OSM seguire le seguenti istruzioni: selezionare i dati OSM, cliccando su uno dei layer, e cliccare su \includegraphics[width=1.5em]{osm_import.png}$^{\text{Import data from a layer}}$. Qualora il pulsante non fosse disponibile nell’interfaccia di QGIS, la barra degli strumenti OpenStreetMap potrebbe essere disattivata: Per attivarla cliccare su \emph{Visualizza \(\rightarrow\) Barre degli Strumenti \(\rightarrow\) OpenStreetMap}.

Potrebbe apparire la seguente finestra di dialogo:
\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 questo caso la finestra informa che non sono attualmente disponibili in QGIS layer vettoriali da cui importare dati. L'importazione può infatti avvenire solamente da layer caricati. Caricare quindi un layer vettoriale e riprovare (ricordandosi di selezionare il layer OSM in legenda):
\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}

Cliccare su {[}OK{]} per avviare il processo o su {[}Cancel{]} per annullare.


\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{Introduzione}
\label{docs/user_manual/sextante/intro:introduction}\label{docs/user_manual/sextante/intro::doc}
Questo capitolo introduce SEXTANTE, la potente infrastruttura di QGIS per l'analisi geospaziale. SEXTANTE è un ambiente di elaborazione geografica che può essere usato per richiamare algoritmi nativi o prodotti da terze parti all'interno di QGIS, rendendo la vostra analisi spaziale maggiomrnte produttiva e facile da portare a termine.

Nelle sezioni che seguono vedremo come usare gli elementi grafici di SEXTANTE e sfruttare al massimo le loro potenzialità


\subsection{Elementi di base dell'interfaccia grafica di SEXTANTE}
\label{docs/user_manual/sextante/intro:basic-elements-of-the-sextante-gui}
Ci sono quattro elementi fondamentali nell'interfaccia grafica di SEXTANTE che potete usare per eseguire gli algoritmi disponibili per scopi diversi. La scelta di uno strumento o l'altro dipenderà dal tipo di analisi da eseguire e dalle peculiaritàdi ogni progetto e ogni utente. Tutti {[}gli algoritmi{]} (ad esclusione dell'interfaccia per i processi non interattivi che è chiamata dalla cassetta degli attrazzi, come vedremo nel seguito) possono essere selezionati dal menu \emph{SEXTANTE} (vedrete più di quattro elementi. Quelli rimanenti non servono per eseguire algoritmi e verranno spiegati di seguito).
\begin{itemize}
\item {} 
La cassetta degli attrezzidi SEXTANTE. É l'elemento principale dell'interfaccia grafica di SEXTANTE, è usata per eseguire singoli algoritmi o avviare processi non interattivi su quell'algoritmo.

\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 {} 
IL modellatore grafico di SEXTANTE. Molteplici algoritmi possono essere combinati graficamente usando il modellatore per definire un flusso di lavoro creando una singola procedura che contiene diversi sottoprocessi

\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 {} 
Il gestore della cronologia di SEXTANTE. Tutte le azioni eseguite usando uno degli elementi precedentemente menzionati sono salvati in un registro cronoloogico e possono essere facilmente riprodotti in qualsiasi momento mediante questo gestore

\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 {} 
Il gestore dell'interfaccia per le procedure non interattive. Questa interfaccia vi consente di eseguire processi non interattivi e/o automatizzare l'esecuzione di un singolo algoritmo su molteplici insiemi di dati.

\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}

Nelle sezioni seguenti rivedremo in dettaglio ciascuno di questi elementi.


\section{La cassetta degli attrezzi di SEXTANTE}
\label{docs/user_manual/sextante/toolbox:the-sextante-toolbox}\label{docs/user_manual/sextante/toolbox::doc}

\subsection{Introduzione}
\label{docs/user_manual/sextante/toolbox:introduction}
La cassetta degli attrezzi (\emph{Toolbox}) è l'elemento principale della interfaccia grafica di SEXTANTE e quello che probabilmente userete quotidianamente nella vostra attività. Esso mostra la lista degli algoritmi disponibili raggruppati in differenti blocchi ed è il punto di partenza per eseguire singoli processi o (batch) processi che implicano l'esecuzione dello stesso algoritmo su diversi insiemi di dati di ingresso.
\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 cassetta degli attrezzi (toolbox) contiene tutti gli algoritmi disponibili divisi in gruppi. Ogni gruppo rappresenta un cosiddetto fornitore di algoritmi che è un insieme di algoritmi provenienti dalla stessa sorgente, ad esempio una applicazione di terze parti con capacità di elaborazione geospaziale. Alcuni di questi gruppi presentano algoritmi di una di queste applicazioni di terze parti (come SAGA, GRASS, o R),mentre altre contengono algoritmi codificati direttamente con elementi di SEXTANTE. Attualmente questi gestori usano tutti codice di plugins già esistenti di QGIS (più specificatamente della libreria vettoriale fTools distribuita con QGIS e del plugin mmqgis che potete installare con il Plugin Manager),rendendoli più utili in quanto possono essere eseguiti da elementi quali il modellatore o il (batch processing interface) che descriveremo fra breve.

Inoltre potete trovare due altri fornitori, precisamente `Modelli' e `Scripts'.Questi fornitori contengono gli algoritmi  creati dall'utente e vi consentono di definire il vostro flusso di lavoro e le attività di elaborazione. Destineremo una sezione intera a loro fra poco.

Nella parte superiore della cassetta degli attrezzi (toolbox) trovate una casella di testo; per ridurre il numero degli algoritmi elencati e rendere più agevole la ricerca di quello che state cercando, potete digitare una parola o una frase nella casella; vedrete che appena digitate il numero degli algoritmi in elene si riduce solo a quelli il cui nome contiene il testo che avete digitato.

Per eseguire un algoritmo è sufficiente cliccare due volte sul nome nella cassetta degli attrezzi (toolbox).


\subsection{La configurazione dell'algoritmo}
\label{docs/user_manual/sextante/toolbox:the-algorithm-dialog}
Eseguito il doppio click sul nome dell'algoritmo che volete eseguire, apparirà una finestra di dialogo come quella mostrata sotto (in questo caso si tratta della finestra di dialogo corrispondente all'algoritmo ``indice di convergenza'' di SAGA).
\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}

La finestra serve a definire i valori di ingresso di cui l'algoritmo ha bisogno per la sua esecuzione. Esso mostra una tabella dove occorre definire i valori di ingresso ed i parametri di configurazione. La finestra ovviamente ha contenuto diverso in dipendenza delle richieste dell'algoritmo da eseguire ed è creata automaticamente in base a queste necessità. A sinistra è indicato il nome del parametro, sulla destra il valore assegnato allo stesso.

Nonostante il numero e tipo dei parametri dipende dalle caratteristiche dell'algoritmo, la struttura è simile per tutti. I parametri che trovate nella tabella possono essere uno dei seguenti tipi.
\begin{itemize}
\item {} 
Layer raster, da selezionare da una lista di quelli disponibili (correntemente aperti) in QGIS. Il selettore contiene anche un bottone all'estremità destra per consentirvi di selezionare nomi di files relativi a layers al momento non caricati in QGIS.

\item {} 
Layer vettoriali, da selezionare dalla lista di quelli disponibili in QGIS. Possono essere selezionati, esattamente come per i layers raster, anche layers al momento non caricati inQGIS, purchè l'algoritmo non richieda la selezione di un attributo dalla relativa tabella; in tal caso possono essere selezionati solo layers aperti poichè la loro apertura è necessaria per disporre del nomi disponibili dei campi.

Vedrete un bottone per ogni selettore di layer; se l'algoritmo ne contiene parecchi, sarete in grado di attivarne uno. Se il  bottone di un layer è attivato l'algoritmo sarà eseguito iterativamente su ognuno degli oggetti del layer. Vedremo meglio questo tipo di esecuzione alla fine di questa sezione.

\item {} 
Tabella, da scegliere fra tutte quelle disponibili in QGIS. Tabelle contenenti dati non geografici sono caricate in QGIS come layer vettoriali e di fatto sono trattate come tali dal programma. Attualmente l'elenco delle tabelle disponibili visualizzato perchè richiesto dall'algoritmo diSEXTANTE che state eseguendo, si limita a tabelle contenute in file dei formati dBase (\code{.dbf}) o Comma-Separated Values (\code{.csv}).

\item {} 
Opzione, da scegliere in una lista di possibili opzioni.

\item {} 
Valore numerico, da inserire nella casella di testo. Vedrete un pulsante a fianco; premendolo apparirà una finestra di dialogo che vi permette di inserire un'espressione matematica, così potete usarlo come un piccolo calcolatore. Potrete aggiungere alle vostre espressioni alcune opportune variabili di QGIS, questo vi consentirà di selezionare valori provenienti da ogni variabile quali ad es. dimensioni di cella di un layer o l'estrema coordinata settentrionale di un altro.

\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 intervallo con i suoi valori minimo e massimo da inserire in due caselle di testo.

\item {} 
Stringa di testo, da inserire nell'apposita casella.

\item {} 
Campo, da scegliere fra gli attributi di un layer vettoriale o una singola tabella selezionata con un altro parametro.

\item {} 
Sistema di Riferimento delle Coordinate (CRS). Potete digitare il codice EPSG direttamente nella casella di testo, o selezionarlo dall'elenco che apparirà quando premete il pulsante sul lato destro

\item {} 
Regione, da inserire mediante i suoi estremi \code{xmin}, \code{xmax}, \code{ymin}, \code{ymax}.Premendo il pulsante sulla destra apparirà una finestra a discesa che vi consentirà le due possibilità di usare la regione attualmente definita nella finestra grafica o di modificarla descrivendo un rettangolo con il mouse.
\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}

Se scegliete la prima opzione verrà mostrata una finestra come la seguente.
\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}

Se scegliete la seconda la finestra dei parametri sparirà, così da consentirvi il trascinemanto del mouse sulla finestra grafica. Una volta selezionato il rettangolo, la finestra di dialogo riapparirà completa dei limiti della regione appena definita.
\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 {} 
Lista di elementi (sia layer raster, layer vettoriali o tabelle), fra quelli disponibili in QGIS da cui selezionare. Per eseguire la selezione premere il piccolo pulsante sul lato sinistro della riga corrispondente per far apparire una finestra di dialogo come la seguente.
\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 {} 
Piccola tabella da completare a cura dell'utente. Queste sono usate per definire parametri tipo tabelle di riferimento o {[}convolution kernels{]}  adesempio.

Cliccare il bottone sul lato destro per vedere la tabella e aggiornare i suoi valori.
\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}

A seconda dell'algoritmo in uso, il numero delle righe può essere modificato o no, usando i pulsanti sul lato destro della finestra.

\end{itemize}

Troverete un pulsante di \textbf{{[}Help{]}} nella parte bassa della finestra di parametri. Se disponible, verrà mostrato un file di aiutoper darvi informazioni ulteriori sugli algoritmi e descrizioni dettagliate del significato di ogni parametro. Sfortunatamente molti algoritmi difettano di buona documentazione per cui se avete voglia di contribuire al progetto, questo è un buon punto di partenza.


\subsubsection{Nota sulle proiezioni}
\label{docs/user_manual/sextante/toolbox:a-note-on-projections}
SEXTANTE --- ed anche molte delle applicazioni esterne di cui SEXTANTE mette a disposizione gli algoritmi ---- non eseguono alcuna riproiezione e presumono che tutti loro siano già in un sistema di riferimento comune, pronti per essere elaborati. Ogni volta che usate molteplici layer in ingresso, sia vettoriali che raster, è vostro compito assicurarvi che siano nello stesso sistema di coordinate.

Fate attenzione che, a causa della capacità di riproiezione al volo di QGIS, per quanto due layer potrebbero sovrapporsi e combaciare, questo potrebbe non essere vero se si usano i loro sistemi di riferimento originari senza trasformarli in un sistema comune. Questa trasformazione va fatta manualmente dopo di che occorre usare il risultato come layer di ingresso per SEXTANTE. Ricordate che l'operazione di trasformazione può essere eseguita in SEXTANTE che contiene gli strumenti adeguati.


\subsection{Dati generati dagli algoritmi di SEXTANTE}
\label{docs/user_manual/sextante/toolbox:data-objects-generated-by-sextante-algorithms}
I dati generati da SEXTANTE possono essere dei seguenti tipi:
\begin{itemize}
\item {} 
Layer raster

\item {} 
Layer vettoriale

\item {} 
Tabella

\item {} 
File HTML (usato per risultati testuali e grafici)

\end{itemize}

Sono tutti salvati su disco (non ci sono risultati in memoria) e la tabella dei parametri contiene caselle di testo per ognuno di essi dove potete digitare il percorso di salvataggio. Il percorso contiene le informazioni necessarie per salvare il risultato da qualche parte. Nella maggior parte dei casi salverete in un file, però l'architettura di SEXTANTE vi permette qualsiasi altro metodo di salvataggio; ad es. un layer vettoriale può essere salvato in un database o inviato ad un server remoto mediante il servizio WFS-T. Benchè tali soluzioni non siano completamente implementate, SEXTANTE è pronto per usarle e ci aspettiamo di aggiungere nuove funzionalità nel breve futuro.

Per selezionare un percorso di salvataggio premete il pulsante a destra della casella di testo. Questo aprirà una finestra di dialogo dove potete selezionare il percorso desiderato. Le estensioni di file previste sono visualizzate nel selettore di formato della finestra di dialogo, a seconda del tipo di risultato e di algoritmo impiegato.

Il formato del risultato è definito dall'estensione del file. I file disponibili dipendono da quelli previsti dallo stesso algoritmo. Per selezionare un formato basta evidenziare la corrispondente estensione (o aggiungerla se state digitando direttamente il percorso). Se l'estensione non corrisponde a nessuna di quelle previste, sarà aggiunta una estensione prefissata (normalmente file:\emph{.dbf} per le tabelle, \code{.tif} per layer raster e \code{.shp} per quelli vettoriali) e la tabella o il layer saranno salvati nel corrispondente formato.

Se non fornite nessun nome di file, il risultato sarà salvato in un file provvisorio nel corrispondente formato; il file sarà cancellato alla chiusura di QGIS (assicuratevi di ciò quando salvate il vostro progetto e questo contiene dei file provvisori).

Potete definire una cartella standard per i dati in uscita. Andate nella finestra di configurazione (potete accedervi dal menu \emph{SEXTANTE}) e nel gruppo \emph{Generale} troverete il parametro \emph{Cartella di uscita} ; questa cartella sarà usata come percorso predefinito ogni volta che fornite un nome di file senza percorso (ad es. \code{mio\_file.shp}) ad un algoritmo.

Oltre ai layer raster ed alle tabelle, SEXTANTE genera anche grafici e testi come file HTML. Questi risultati sono visualizzati alla fine dell'elaborazione in a nuova finestra.Questa finestra conterrà i risultati prodotti da SEXTANTE nella sessione in corso e possono essere visualizzati in ogni momento selezionando dal menu \emph{SEXTANTE \(\rightarrow\) SEXTANTE visualizzatore di risultati}.

Alcune applicazioni esterne possono avere file di uscita (senza limitazioni particolari sulle estensioni), ma questi non appartengono a nessuna delle categoria precedenti. Questi file non saranno elaborati da QGIS (aperti e/o inclusi nel progetto corrente), perchè corrispondenti il più delle volte a formati non adatti a QGIS. Questo è, per esempio, il caso dei file LAS usato per i dati LiDAR; i file saranno creati, ma questi non saranno visualizzati nella vostra sessione di lavoro QGIS.

Per tutti gli altri tipi di file, avete una casella di spunta per dire a SEXTANTE se il file, una volta generato dall'algoritmo, deve essere aperto o no; in condizioni normali tutti i file sono aperti.

SEXTANTE non gestisce i risultati in file opzionali, pertanto tutti saranno salvati su disco; ma se non siete interessati ad un particolare risultato, potete lasciare vuota la sua casella di spunta in modo che si comporti come un file opzionale (per quanto il layer è comunque creato, se lasciate la casella di testo vuota, il risultato sarà salvato in un file provvisorio e cancellato alla chiusura di QGIS)


\subsection{La configurazione di SEXTANTE}
\label{docs/user_manual/sextante/toolbox:configuring-sextante}
Come è stato detto, il menu di configurazione dà accesso ad una nuova finestra dove potete configurare il modo di lavorare di SEXTANTE. I parametri di configurazione sono raggruppati in blocchi che potete selezionare sul lato sinistro della finestra.

Oltre alla già ricordata casella \emph{Cartella di uscita}, il blocco \emph{Generale} contiene parametri per definire le modalità di visualizzazione dei layer di SEXTANTE (cioè i layer generati usando gli algoritmi delle varie componenti di SEXTANTE). Dovete creare lo stile che volete usare con QGIS, salvarlo in un file ed inserire  il percorso di questo file nell'apposito parametro in modo che SEXTANTE lo usi. Ogni volta che SEXTANTE carica un layer e lo aggiunge alla finestra grafica di QGIS, il layer sarà visualizzato con quello stile.

Gli stili di visualizazione possono essere configurati singolarmente per ogni algortimo e per ogni risultato. Basta premere sul nome dell'algoritmo nella cassetta degli attrezzi e selezionare \emph{Modifica degli stili di restituzione} ; vedrete apparire una finestra di dialogo come la seguente.
\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}

Selezionate il file di stile (\code{.qml}) che volete assegnare ad ogni risultato e premete \textbf{{[}OK{]}}.

Altri parametri di configurazione nel gruppo \emph{Generale} sono spiegate sotto:
\begin{itemize}
\item {} 
\textbf{Usate i nomi di file come nomi di layer}. Il nome di ogni risultato creato da SEXTANTE è definito dall'algoritmo che lo genera. In alcuni casi si può usare un nome fisso in modo che sarà usato lo stesso file indipendentemente dal layer in ingresso. In altri casi il nome può dipendere dal nome del file in ingresso o da qualche parametro usato nell'esecuzione dell'algoritmo. Se la casella di spunta è attivata, il nome sarà preso invece dal nome del file di uscita. Attenzione che se il risultato è salvato su un file provvisorio, questo avrà un nome lungo e senza significato apparente, questo per evitare collisioni con altri file esistenti.

\item {} 
\textbf{Usate solo oggetti selezionati}. Se è attivata questa opzione, ogni volta che usate un layer vettoriale come ingresso per un algoritmo, solo i suoi oggetti selezionati saranno presi in considerazione. Se il layer non ha oggetti selezionati, verranno considerati tutti.

\end{itemize}

Oltre al blocco \emph{Generale} nella finestra di dialogo, ne troverete uno per ogni gestore di algoritmi. Essi contengono una casella \emph{Attivazione} che potete usare per far apparire o meno gli algoritmi nella cassetta degli attrezzi. Inoltre alcuni gestori di algoritmi hanno elementi specifici di configurazione che saranno spiegati successivamente quando saranno trattati praticolari gestori.


\section{Il modellatore grafico di SEXTANTE}
\label{docs/user_manual/sextante/modeler:the-sextante-graphical-modeler}\label{docs/user_manual/sextante/modeler::doc}

\subsection{Introduzione}
\label{docs/user_manual/sextante/modeler:introduction}
Il \emph{modellatore grafico} consente di creare modelli complessi mediante un'interfaccia semplice e facile. Quando lavorate con un GIS, molte operazioni di analisi non sono isolate, ma inserite in una catena di operazioni. Mediante il modellatore grafico questa catena di processi può essere combinata in un solo processo; in questo modo è più facile e conveniente eseguirlo come singolo processo invece di successivi processi basati su differenti dataset di input. Indipendentemente dal numero di passaggi e dai differenti algoritmi coinvolti, esso è eseguito come un singolo algoritmo, risparmiando quindi tempo e fatica, specialmente nel caso di modelli di grandi dimensioni.

Il modellatore può essere aperto dal menu \emph{SEXTANTE}, ma anche dalla cassetta degli attrezzi. Nel ramo \emph{Modellatore} dell'albero degli algoritmi troverete un gruppo denominato \emph{Attrezzi} che contiene una opzione chiamata \emph{Crea un nuovo modello}.

Il modellatore ha un'area grafica di lavoro dove sono visualizzati la struttura del modello ed il flusso delle operazioni che lo rappresenta. Si può usare un pannello con due riquadri sulla sinistra della finestra per aggiungere nuovi elementi al modello.
\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}

La creazione di un modello comporta due passaggi:
\begin{enumerate}
\item {} 
Definizione dei dati di ingresso necessari. Queste informazioni saranno aggiunte alla finestra dei parametri in modo che l'utente possa configurare valori appropriati durante l'esecuzione del modello. Il modello stesso è un algoritmo di SEXTANTE, per cui la finestra dei parametri è generata automaticamente come accade per tutti gli algoritmi inclusi in SEXTANTE.

\item {} 
Definizione del flusso operativo. Usando i dati di ingresso configurati per il modello, il flusso è definito aggiungendo gli algoritmi e decidendo quali fra questi dati usare o se invece usare dati prodotti da algoritmi precedentemente inseriti nel modello.

\end{enumerate}


\subsection{Definizione dei dati di ingresso}
\label{docs/user_manual/sextante/modeler:definition-of-inputs}
Il primo passo per creare un modello è definire i dati in ingresso di cui necessita. Nella casella \emph{inputs} alla sinistra della finestre del modellatore si trovano questi elementi:
\begin{itemize}
\item {} 
Layer raster

\item {} 
Layer vettoriali

\item {} 
Stringhe di testo

\item {} 
Campi di tabelle

\item {} 
Tabelle

\item {} 
Valori numerici

\item {} 
Valori logici (booleani)

\end{itemize}

Premendo due volte con il mouse su uno di questi elementi, apparirà una finestra di dialogo per definire le sue caratteristiche. A seconda del parametro stesso, la finestra conterrà un solo elemento (la descrizione che è quello che l'utente vede durante l'esecuzione del modello) o più elementi. Ad esempio, aggiungendo un valore numerico, come si può vedere nella figura seguente, oltre alla descrizione del parametro, dovrete definire un valore di partenza ed un intervallo di valori validi.
\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}

Per ogni dato di ingresso aggiunto, appare un nuovo elemento nel pannello grafico del modellatore.
\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{Definizione del flusso operativo}
\label{docs/user_manual/sextante/modeler:definition-of-the-workflow}
Una volta definiti i dati ingresso, occorre decidere gli algoritmi da applicare ad essi. Gli algoritmi si trovano nella casella \emph{Algoritmi}, raggruppati allo stesso modo come nella cassetta degli attrezzi.
\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}

Per aggiungere un algoritmo, premete due volte con il mouse sul suo nome. Verrà mostrata una finestra di dialogo con un contenuto simile a quello della finestra che SEXTANTE fa apparire quando si esegue l'algoritmo dalla cassetta degli attrezzi. Quello che vedete di seguit si riferisce all'algoritmo `Indice di convergenza' di SAGA, lo stesso di cui abbiamo parlato nel capitolo dedicato alla cassetta degli attrezzi di 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}

Come potete vedere, esistono alcune differenze. Al posto della casella usata per definire il percorso del file per i layer risultanti, appare una semplice casella di testo. Se il layer generato dall'algoritmo è solo un risultato temporaneo da usare come dato di ingresso per un altro algoritmo e non deve essere conservato come risultato finale, non modificate la casella. Digitando qualcosa nella stessa significa che è un risultato finale ed il testo che avete fornito sarà la descrizione del risultato, quello che l'utente vedrà durante l'esecuzione dell'algoritmo.

Anche la selezione dei valori di ogni parametro è un po' diversa, in quanto vi sono importanti differenze fra il contesto del modellatore e quello della cassetta degli attrezzi. Vediamo come introdurre il valore per ogni tipo di parametro.
\begin{itemize}
\item {} 
Layer (raster e vettoriali) e tabelle. Devono essere selezionate da una lista, ma in questo caso i valori possibili non sono i layer o le tabelle correntemente aperte in QGIS, bensì la lista dei dati di ingresso del modello corrispondente per tipo, o altri layer e tabelle generate da algoritmi già aggiunti al modello.

\item {} 
Valori numerici. Si possono inserire valori direttamente nella casella, ma si possono anche scegliere da una lista i valori numeri di ingresso per il modello. In questo caso, il parametro prenderà il valore inserito dall'utente quando esegue il modello.

\item {} 
Stringhe. Come nel caso dei valori numerici, si possono inserire stringhe o selezionarle (da un elenco).

\item {} 
Campi di tabelle. I campi della tabella principale o del layer sono ignoti al momento del progetto, in quanto dipendono dalle scelte dell'utente nel momento di esecuzione del modello. Per definire il valore di questo parametro, digitate il nome del campo direttanente nella casella di testo, oppure selezionate un campo di tabella già esistente nel modello. La validità del campo selezionato sarà controllato da SEXTANTE in fase di esecuzione.

\end{itemize}

Una volta assegnati valori corretti a tutti i parametri, premete \textbf{{[}OK{]}} e l'algoritmo sarà aggiunto al pannello grafico. Sarà collegato a tutti gli altri elementi del pannello, sia algoritmi sia dati, che forniscono oggetti usati dall'algoritmo come dati di ingresso.
\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}

Gli elementi possono essere spostati nel pannello grafico per modificare la visualizzazione della struttura del modello e renderla più chiara ed intuitiva. I collegamenti fra gli elementi vengono aggiornati automaticamente.

Potete eseguire il vostro algoritmo in ogni momento premendo il pulsante \textbf{{[}Run{]}}. Tuttavia, per poterlo usare dalla cassetta degli attrezzi, occorre salvarlo e chiudere la finestra di dialogo del modellatore in modo da consentire al sistema di aggiornare la configurazione.


\subsection{Salvataggio e caricamento di modelli}
\label{docs/user_manual/sextante/modeler:saving-and-loading-models}
Usate il pulsante \textbf{{[}Salvataggio{]}} per salvare il modello corrente ed il pulsante \textbf{{[}Apri{]}} per aprire un modello esistente. I modelli sono salvati con l'estensione \code{.model}. Se il modello è già stato salvato {[}dalla finestra del modellatore{]} non vi sarà chiesto il nome del file perchè esiste già un file associato al modello e verrà usato quello.

Prima di salvare un modello, dovete inserire un nome ed un gruppo per esso usando le caselle di testo nella parte alta della finestra.

I modelli salvati nella cartella \code{modelli} (quella predefinita quando vi si chiede il nome del file dove salvare il modello) appariranno nella cassetta degli attrezzi, nel corrispondente gruppo. Quando si attiva la cassetta degli attrezzi, SEXTANTE cerca nella cartella \code{modelli} i file con l'estensione \code{.model} e carica il modello che contengono. Poichè un modello è anch'esso un algoritmo di SEXTANTE, può essere aggiunto alla cassetta degli attrezzi come qualsiasi altro algoritmo.

La cartella del modellatore può essere definita nella finestra di configurazione di SEXTANTE, sotto il gruppo \emph{Modellatore}.

I modelli presenti nella cartella dei modelli appariranno non solo nella cassetta degli attrezzi, ma anche nell'albero degli algoritmi nel pannello \emph{Algoritmi} della finestra del modellatore. Questo significa che potete incorporare un modello come parte di un modello più grande, esasttamente come aggiungete qualsiasi altro algoritmo.

In alcuni casi, SEXTANTE potrebbe non essere in grado di caricare un modello perchè non trova tutti gli algoritmi inclusi nella sua definizione. Se usate un certo algoritmo come parte del vostro modello, questo deve essere disponibile (cioè deve apparire nella cassetta degli attrezzi) per essere in grado di caricare quel modello. La disattivazione di un gestore di algoritmi nella finestra di configurazione di SEXTANTE renderà tutti quegli algoritmi inusabili, creando problemi nel caricamento dei modelli. Ricordatevene quando avete delle noie nel caricamento o nella esecuzione di modelli.


\subsection{Aggiornare il modello}
\label{docs/user_manual/sextante/modeler:editing-a-model}
Potete modificare il modello mentre lo state creando, ridefinendo il flusso e le relazioni fra gli algoritmi e i dati che definiscono il modello stesso.

Se premete il tasto destro del mouse su un algoritmo nel grafico che rappresenta il modello, apparirà un menu come quello sotto riportato:
\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}

Selezionando l'opzione \emph{Cancella} si cancellerà l'algoritmo selezionato. Un algoritmo può essere cancellato soltanto se non vi sono altri algoritmi dipendenti. Cioè se il risultato dell'algoritmo non è usato da un altro algoritmo. Se provate a rimuove un algoritmo da cui ne dipendono altri, SEXTANTE mostrerà un messaggio di avviso come quello che vedete sotto:
\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}

Selezionando l'opzione \emph{Modifica} o semplicemente premendo due volte sull'icona dell'algoritmo apparirà la finestra dei parametri dell'algoritmo in modo che possiate cambiarne i valori. Non tutti i valori disponibili nel modello appariranno in questo caso come dati disponibili. Layer o valori generati ad un passaggio successivo del flusso del modello che possono causare dipendenze circolari non saranno disponibili.

Selezionate i nuovi valori e premete il pulsante \textbf{{[}OK{]}} come al solito. La connessione fra gli elementi del modello cambieranno di conseguenza anche nel pannello grafico.


\subsection{Abilitare e disabilitare gli algortimi}
\label{docs/user_manual/sextante/modeler:activating-and-deactivating-algorithms}
Gli algoritmi possono essere disattivati nel modellatore, così non saranno eseguiti quando il modello sarà lanciato. Questo può essere sfruttato per mettere a punto una parte del modello o quando non avete bisogno di tutti i risultati generati dal modello.

Per disattivare un algoritmo, premete il tasto destro del mouse sulla sua icona nel pannello grafico e spuntate l'opzione \emph{Disattivazione}. Vedrete che ora l'algoritmo sarà presentato con un'etichetta rossa sotto il nome che indica che questo non è attivo.
\begin{figure}[htbp]
\centering
\capstart

\includegraphics[width=15em]{deactivated.png}
\caption{Deactivate \includegraphics[width=1em]{win.png}}\end{figure}

Anche gli algoritmi dipendenti (direttamente o indirettamente) da quell'algoritmo appariranno come disattivati in quanto non possono ora essere eseguiti.

Per abilitare un algoritmo basta premere sulla sua icona col pulsante destro del mouse e selezionare l'opzione \emph{Abilitare}.


\subsection{Informazioni ed aiuto per l'aggiornamento del modello}
\label{docs/user_manual/sextante/modeler:editing-model-help-files-and-meta-information}
Potete documentare i vostri modelli in SEXTANTE. Premete il pulsante \textbf{{[}Edit model help{]}} ed apparirà una finestra di dialogo come la seguente.
\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}

Sul lato destro vedrete una semplice pagina HTML, creata usando la descrizione dei parametri di ingresso e di uscita dell'algoritmo, oltre ad informazioni integrative come una descrizione generale o il suo autore. La prima volta che aprite il gestore di aiuto tutte queste descrizioni sono vuote, ma potete modificarle usando gli elementi sul lato sinistro della finestra. Selezionate un elemento nella parte alta e quindi scrivete la sua descrizione nella casella sotto.

L'informazione di aiuto del modello è salvata nella stessa cartella insieme al modello stesso. Non dovete preoccuparvi del suo salvataggio perchè è eseguito automaticamente.


\subsection{A proposito degli algoritmi disponibili}
\label{docs/user_manual/sextante/modeler:about-available-algorithms}
Noterete che alcuni algoritmi che potete eseguire dalla cassetta degli attrezzi non appaiono nella lista di quelli disponibili quando state creando un modello. Per essere incluso in un modello, un algoritmo deve avere una semantica corretta, così come essere correttamente collegato con gli altri nel flusso di lavoro. Se un algoritmo non ha una semantica corretta (ad esempio, se il numero dei layer generati non può essere conosciuto anticipatamente) allora non è possibile usarlo all'interno del modello e quindi non può apparie nella lista di quelli che potere trovare nella finestra del modellatore.

Inoltre, vedrete nel modellatore qualche algoritmo che non trovate nella cassetta degli attrezzi. Questi algoritmi sono fatti per essere usati esclusivamente come parte di un modello e non sono utili in altri contesti. L'algoritmo `Calcolatore' è un esempiodi questi. Esso è un semplice calcolatore aritmetico che potete usare per modificare valori numerici (inseriti dall'utente o generati da qualche altro algoritmo). Questi strumenti sono utili all'interno di un modello, ma al di fuori di quel contesto non hanno molto senso.


\subsection{I modelli di SEXTANTE come codice Python}
\label{docs/user_manual/sextante/modeler:sextante-models-as-python-code}
\emph{Questa funzionalità non è al momento disponibile}

Vicino al pannello che contiene lo schema grafico del modello, ne vedrete un altro contenente un codice Python che esegue lo stesso compito del modello. Usando quel codice, potete creare delle istruzioni a linea di comando (le spiegheremo più tardi in questo stesso manuale) e modificarle per inserire azioni e funzioni disponibili nel modellatore grafico, come iterazioni e strutture condizionali.

Questa caratteristica è anche molto utile per imparare ad usare SEXTANTE da linea di comando e come creare algoritmi di SEXTANTE usando codice Python, così potete usarla come strumento di apprendimento quando cominciate a creare le vostre istruzioni per SEXTANTE.

Troverete un pulsante sotto il testo che contiene il codice Python. Premetelo per creare direttamente un nuovo comando da quel codice, senza doverlo copiare ed incollare nel gestore dei comandi di SEXTANTE.


\section{L'interfaccia di SEXTANTE per eseguire processi in modalità ``batch''}
\label{docs/user_manual/sextante/batch::doc}\label{docs/user_manual/sextante/batch:the-sextante-batch-processing-interface}

\subsection{Introduzione}
\label{docs/user_manual/sextante/batch:introduction}
Gli algoritmi di SEXTANTE (compresi i modelli) possono essere eseguiti come un processo batch. Questo significa che possono essere eseguiti usando non un singolo set di input ma anche più di uno, eseguendo l'algoritmo tutte le volte che è necessario. Ciò si rivela utile quando si ha bisogno di processare grandi quantità di dati, dal momento che non è necessario lanciare ogn volta l'algoritmo dalla toolbox.

Per eseguire un algoritmo come un processo batch, selezionarlo e col pulsante di destra del mouse scegliere la voce \emph{Execute as batch process} dal menu che apparirà.
\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 tabella dei parametri}
\label{docs/user_manual/sextante/batch:the-parameters-table}
Eseguire un processo batch è un'operazione simile ad un'esecuzione singola di un algoritmo. Devono essere definiti i valori dei parametri, ma in questo caso, è necessario definire non solo un singolo valore per ciascunodi essi, ma invece un set di valori, uno per ogni volta che l'algoritmo deve essere eseguito. I valori sono introdotti per mezzo di una tabella del tipo di quella mostrata oltre.
\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}

Ogni riga di tale tabella rappresenta una sinola esecuzione dell'algoritmo ed ogni cella contiene il valore di uno dei parametri caratteristici dell'algoritmo. In un certo senso, è simile alla finestra di dialogo dei parametri utilizzata quando si lancia un algoritmo dalla toolbox, ma organizzata in maniera differente.

Come impostazione predefinita, la tabella contiene solo due righe. E' possiile aggiungere o cancellare righe utilizzando i pulsanti posti nella parte inferiore della finestra.

Una volta definita la dimensione della tabella, deve essere riempita coi valori desiderati.


\subsection{Compilazione della tabella dei parametri}
\label{docs/user_manual/sextante/batch:filling-the-parameters-table}
Per la maggior parte dei parametri, scegliere il valore appropriato è banale. Basta semplicemente scrivere il valore o selezionarlo dalla lista delle opzioni disponibili, a seconda del tipo di parametro stesso.

Le principali differenze si hanno per parametri che sono layer o tabelle e per il percorso di salvataggio dei risultati. Per quanto riguarda input rappresentati da layer e tabelle, quando un algoritmo è eseguito come parte di un processo batch, i dati di input sono caricati direttemente da file e non a partire dai temi già aperti in QGIS. Per questo motivo, qualunque algoritmo può essere eseguito in modalità batch anche se nessun tema è stato ancora caricato e l'algoritmo non può essere lanciato dalla toolbox.

Il nome dei file per i dati di input può essere digitato direttamente oppure, meglio, cliccando sul pulsante sul lato destro della cella che apre una classica finestra di dialogo per la scelta di un file. Possono essere selezionati più file insieme. Se il parametro di input rappresenta un dato singolo e sono selezionati diversi file, ciascuno di essi sarà inserito in righe separate, aggiungendone di nuove se necessario. Se il parametro di input prevede più dati, tutti i file selezionati saranno aggiunti in un'unica cella, separati da punto e virgola (\code{;}).

I risultati sono sempre salvati in un file permanente e, a differenza di quando un algoritmo è lanciato dalla toolbox, non è permesso il loro salvataggio in un file temporaneo. E' possibile digitare direttamente il nome del file di output oppure utilizzare la finestra di dialogo della scelta dei file che compare quando si clicca sul buttone di accompagnamento.

Una volta selezionato il file di output, appare una nuova finestra di dialogo che permette l'autocompletamento delle altre celle nella stessa colonna (stesso parametro).
\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}

Se si mantiene il valore predefinito (`Do not autocomplete'), SEXTANTE metterà il nome del file selezionato nella cella selezionata dalla tabella dei parametri. Se viene selezionata una qualunque delle altre opzioni, tutte le celle sottostanti quella selezionata saranno riempite automaticamente basandosi sul criterio definito. In questo modo, è molto più agevole riempire la tabella e il processo batch può essere definito con meno sforzo.

Il riempimento automatico può essere fatto semplicemente aggiungendo numeri correlati al percorso del file selezionato o aggiungendo il valore di un altro campo alla stessa riga. Ciò è particolarmente utile per dare un nome ai dati di output che sia in accordo con quello dei dati di input.
\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{Esecuzione di un processo batch}
\label{docs/user_manual/sextante/batch:executing-the-batch-process}
Per eseguire un processo batch, una volta introdotti tutti i valori necessari, semplicemente cliccare su \textbf{{[}OK{]}}. SEXTANTE mostrerà l'avanzamento del processo di batch globale nella barra di avanzamento posta nella parte inferiore della finestra di dialogo.


\section{Uso di SEXTANTE dalla console}
\label{docs/user_manual/sextante/console:using-sextante-from-the-console}\label{docs/user_manual/sextante/console::doc}

\subsection{Introduzione}
\label{docs/user_manual/sextante/console:introduction}
La console permette ad utenti esperti di aumentare la propria produttività e di eseguire operazioni complesse che non possono essere eseguite utilizzando uno qualsiasi degli altri elementi dell'interfaccia grafica di SEXTANTE. I modelli che richiamano diversi algoritmi possono essere definiti utilizzando l'interfaccia della riga di comando, e le operazioni aggiuntive, come i loop e le frasi condizionali possono essere aggiunte per creare flussi di lavoro più flessibili e potenti.

Non c'è una console di SEXTANTE in QGIS, ma tutti i comandi di SEXTANTE sono disponibili invece dalla console Python interna presente in QGIS. Ciò significa che è possibile incorporare quei comandi nella console di lavoro e connettere gli algoritmi di SEXTANTE a tutte le altre funzioni (compresi i metodi derivanti dalle API di QGIS) da lì disponibili.

Il codice che è possibile eseguire dalla console Python, anche se chiama un qualsiasi modulo di SEXTANTE, può essere convertito in un nuovo algoritmo di SEXTANTE che in seguito sarà possibile chiamare dalla finestra degli strumenti, il modellatore grafico o qualsiasi altro componente di SEXTANTE, proprio come si fa con qualunque algoritmo di SEXTANTE. Infatti, alcuni algoritmi che si possono trovare nella casella degli strumenti, come tutti quelli del gruppo \emph{mmqgis}, sono semplici script.

In questo capitolo si spiegherà come utilizzare SEXTANTE dalla console Python di QGIS ed anche come scrivere un algoritmo in Python.


\subsection{Chiamata di SEXTANTE dalla console Python}
\label{docs/user_manual/sextante/console:calling-sextante-from-the-python-console}
La prima cosa da fare è importare le funzioni di SEXTANTE con la seguente istruzione:

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{g+gp}{\PYGZgt{}\PYGZgt{}\PYGZgt{} }\PYG{k+kn}{import} \PYG{n+nn}{sextante}
\end{Verbatim}

Fondamentalmente, c'è solo una cosa (interessante) che si può fare con SEXTANTE dalla console: eseguire un algoritmo. Ciò viene fatto usando il comando {}`{}` runalg () {}`{}` , che prende il nome dell'algoritmo da eseguire come primo parametro, e poi un numero variabile di parametri aggiuntivi che dipendono da ciò che è richiesto dall'algoritmo. Quindi la prima cosa da sapere è il nome dell'algoritmo da eseguire. Questo non è il nome che è riportato nella finestra degli strumenti, ma un nome univoco da richiamare nella da riga di comando. Per trovare il nome corretto dell'algoritmo, è possibile utilizzare il comando  {}`{}` algslist () {\color{red}\bfseries{}{}`{}`}. Digitare la seguente istruzione:

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{g+gp}{\PYGZgt{}\PYGZgt{}\PYGZgt{} }\PYG{n}{sextante}\PYG{o}{.}\PYG{n}{alglist}\PYG{p}{(}\PYG{p}{)}
\end{Verbatim}

Il risultato dovrebbe essere.

\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}

Questa è la lista di tutti gli algoritmi disponibili in ordine alfabetico, con il corrispondente nome da utilizzare nella riga di comando.

È possibile utilizzare una stringa come parametro per questo comando. Invece di restituire l'elenco completo degli algoritmi, verranno visualizzati solo quelli che includono tale stringa. Se, per esempio, si sta cercando un algoritmo per calcolare la pendenza da un DEM, si digiti  {\color{red}\bfseries{}{}`{}`}alglist (``slope'') '' per ottenere il seguente risultato:

\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}

Il risultato potrebbe cambiare a seconda degli algoritmi che sono disponibili.

È più facile ora trovare l'algoritmo che si sta cercando e il suo nome da utilizzare nella riga di comando, in questo caso {}`{}` saga: slopeaspectcurvature {\color{red}\bfseries{}{}`{}`}.

Una volta che si conosce il nome dell'algoritmo da utilizzare nella riga di comando, la prossima cosa da fare è conoscere la giusta sintassi per eseguirlo. Ciò significa conoscere quali sono i parametri necessari e l'ordine in cui essi devono essere dichiarati quando si esegue il comando {}`{}` runalg () {}`{}` . SEXTANTE ha un comando per descrivere un algoritmo in dettaglio, che può essere usato per ottenere un elenco dei parametri che un algoritmo richiede e gli output che genererà. È possibile utilizzare il comando  {}`{}` alghelp (nome\_algoritmo) {\color{red}\bfseries{}{}`{}`}. Utilizzare il nome dell'algoritmo nella riga di comando, non il nome descrittivo completo.

Chiamando la funzione \code{saga:slopeaspectcurvature} come parametro, si otterrà la seguente descrizione.

\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}

Ora si ha tutto il necessario per eseguire qualsiasi algoritmo. Come già accennato, vi è solo un unico comando per eseguire algoritmi: {}`{}` runalg () {\color{red}\bfseries{}{}`{}`}. La sua sintassi è la seguente:

\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}

L'elenco dei parametri e degli output da aggiungere dipende dall'algoritmo che si desidera eseguire, ed è esattamente la lista che il comando {}`{}` alghelp () {}`{}` restituisce, nello stesso ordine, come mostrato.

A seconda del tipo di parametro, i valori vengono introdotti in modo diverso. Di seguito, una rapida rassegna di come introdurre i valori per ciascun tipo di parametro di input
\begin{itemize}
\item {} 
Layer raster, layer vettoriale o tabella. Basta usare una stringa con il nome che identifica l'oggetto da utilizzare (il nome che ha nell'area di legenda di QGIS ) o il nome di un file (se il layer corrispondente non è aperto, sarà aperto, ma non aggiunto alla mappa ). Se si dispone di un'istanza di un oggetto di QGIS che rappresenta il layer, è anche possibile utilizzarla come parametro. Se l'input è opzionale e non si desidera utilizzare alcun dato, utilizzare {\color{red}\bfseries{}{}`{}`}None {\color{red}\bfseries{}{}`{}`}.

\item {} 
Selezione. Se un algoritmo ha un parametro di selezione, il valore di tale parametro deve essere inserito come valore intero. Per conoscere le opzioni disponibili, è possibile utilizzare il comando {\color{red}\bfseries{}{}`{}`}algoptions {\color{red}\bfseries{}{}`{}`}, come mostrato nel seguente esempio:

\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}

In questo caso, l'algoritmo ha uno di questi parametri con 7 opzioni, ordinate a partire da zero.

\item {} 
Input multipli. Il valore è una stringa con i descrittori degli input separati da virgola. Come nel caso di singoli layer o tabelle, ogni descrittore di input ingresso può essere il nome dell'oggetto, o il suo percorso sul disco.

\item {} 
Campo di una Tabella da XXX. Inserire una stringa con il nome del campo da utilizzare. Il parametro è sensibile alle lettere maiuscole

\item {} 
Tabella fissa. Digitare l'elenco di tutti i valori della tabella, separati da virgole e racchiusi tra virgolette. I valori iniziano dalla riga superiore e vanno da sinistra a destra. È inoltre possibile utilizzare una matrice 2D dei valori che rappresenta la tabella.

\item {} 
Sistema di Riferimento per le Coordinate (Coordinate Reference System, CRS). Inserire il codice EPSG per indicare il sistema di riferimento desiderato.

\item {} 
Estensione. È necessario utilizzare una stringa con i valori di \code{xmin}, \code{xmax}, \code{ymin} e \code{ymax} separati da virgole.

\end{itemize}

Parametri booleani, di file, di stringa e numerici non hanno bisogno di ulteriori spiegazioni.

I parametri di input, come stringhe o valori numerici o booleani hanno valori di default. Per utilizzarli, usare {\color{red}\bfseries{}{}`{}`}None {\color{red}\bfseries{}{}`{}`}nella voce del parametro corrispondente.

Per per salvare i dati di output, digitare il percorso del file da utilizzare, così come viene fatto nella finestra degli strumenti. Se si desidera salvare il risultato in un file temporaneo, utilizzare {\color{red}\bfseries{}{}`{}`}None {\color{red}\bfseries{}{}`{}`}. L'estensione del file determina il formato del file. Se si immette un'estensione del file non inclusa tra quelle supportate dall'algoritmo, verrà utilizzato il formato di file predefinito per il tipo di output e sarà aggiunta al percorso del file specificato la sua estensione corrispondente .

A differenza di quando un algoritmo viene eseguito dalla finestra degli strumenti, se si esegue lo stesso algoritmo dalla console Python, gli output non vengono aggiunti alla vista mappa. Se si desidera aggiungere un output alla vista, bisogna farlo dopo l'esecuzione dell'algoritmo. Per fare ciò, è possibile utilizzare i comandi API QGIS, o, ancora più semplicemente, utilizzare uno dei comandi forniti da SEXTANTE per tale compito.

Il comando {}`{}` runalg () {}`{}` restituisce un dizionario con i nomi di output (quelli indicati nella descrizione dell'algoritmo) come chiavi e i percorsi dei file di quegli output come valori. Per aggiungere tutti gli output generati da un algoritmo, si può utilizzare il comando {}`{}` loadFromAlg () {}`{}` che processa il dizionario. È anche possibile caricare un singolo layer passando il suo percorso del file al comando {}`{}` load() {\color{red}\bfseries{}{}`{}`}.


\subsection{Creare script e lanciarli dalla finestra degli strumenti}
\label{docs/user_manual/sextante/console:creating-scripts-and-running-them-from-the-toolbox}
È possibile creare i propri algoritmi, scrivendo il relativo codice Python e aggiungendo qualche riga in più per fornire ulteriori informazioni necessarie a SEXTANTE. Il comando \emph{Create new script} si trova sotto il  gruppo strumenti nel blocco degli Script, nella finestra degli strumenti. Fare doppio clic su di esso per aprire la finestra di dialogo dell'editor di script. È lì che si deve digitare il codice. Salvando lo script nella cartella \code{scripts} (è quella di default quando si apre la finestra di dialogo Salva file), con estensione \code{.py} , automaticamente si creerà l'algoritmo corrispondente.

Il nome dell'algoritmo (quello si vedrà nella finestra degli strumenti) viene creato dal nome del file, rimuovendo la sua estensione e sostituendoi trattini bassi con spazi vuoti.

Ad esempio, quello seguente è il codice che calcola l'Indice di Umidità Topografica (Topographic Wetness Index, TWI) direttamente da un DEM

\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}

Come si può vedere, si tratta di tre algoritmi, tutti provenienti da SAGA. L'ultimo calcola il TWI, ma ha bisogno del layer dell'inclinazioe e del layer della flow accumulation. Non essendo disponibili direttamente ed avendo a disposizione il DEM, possono essere calcolati richiamando i corrispondenti algoritmi di SAGA.

La parte del codice in cui avviene questo processo non è difficile da capire, una volta lette le sezioni precedenti di questo capitolo. Le prime linee, tuttavia, hanno bisogno di qualche spiegazione aggiuntiva. Esse forniscono a SEXTANTE le informazioni di cui ha bisogno per trasformare il codice in un algoritmo che può essere eseguito da uno dei suoi componenti, come la finestra degli strumenti  o il modellatore grafico.

Queste linee iniziano con un doppio simbolo di commento Python ed hanno la seguente struttura:

\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}

Ecco un elenco di tutti i tipi di parametri che SEXTANTE supporta nei suoi scrpt, la loro sintassi ed alcuni esempi.
\begin{itemize}
\item {} 
\code{raster}. Un layer raster

\item {} 
\code{vector}. Un layer vettoriale

\item {} 
\code{table}. Una tabella

\item {} 
\code{number}. Un valore numerico. Deve essere indicato un valore di default. Ad esempio, \code{depth=number 2.4}

\item {} 
\code{string}. Una stringa di testo. Come nel caso dei valori numerici, deve essere indicato un valore di default. Ad esempio, \code{name=string Victor{}`{}`{}`{}`number}

\item {} 
\code{boolean}. Un valore booleano. Aggiungere \code{True} o \code{False} dopo di esso per indicare il valore di default. Ad esempio, \code{verbose=boolean True}

\item {} 
\code{multiple raster}. Un insieme di layer raster di input.

\item {} 
\code{multiple vector}. A set of input vector layers.

\item {} 
\code{field}. Un campo nella tabella degli attributi di un layer vettoriale. Il nome del layer deve essere aggiunto dopo il tag \code{field}.  Ad esempio, una volta dichiarato il layer vettoriale di input con \code{mylayer=vector}, si può usare \code{myfield=field mylayer} per aggiungere come parametro un campo di quel layer.

\item {} 
\code{folder}. Una cartella

\item {} 
\code{file}. Un nome di un file

\end{itemize}

Il nome del parametro è il nome che verrà mostrato all'utente durante l'esecuzione dell'algoritmo, ed è anche il nome della variabile da utilizzare nel codice dello script. Il valore immesso dall'utente per quel parametro sarà assegnato a una variabile con quel nome.

Quando mostra all'utente il nome del parametro, SEXTANTE lo modifica per migliorare il suo aspetto, sostituendo i trattini bassi con spazi vuoti. Così, per esempio, se si desidera che l'utente visualizzi un parametro denominato {}`{}` Un valore numerico{}`{}`, è possibile utilizzare il nome della variabile {}`{}` Un\_valore\_numerico {\color{red}\bfseries{}{}`{}`}.

I valori dei layer e delle tabelle sono stringhe contenenti il percorso del file dell'oggetto corrispondente. Per trasformarle in un oggetto di QGIS, è possibile utilizzare la funzione {\color{red}\bfseries{}{}`{}`}sextante.getObjectFromUri () {}`{}` funzione. Anche input multipli hanno un valore della stringa, che contiene il percorso di gli oggetti selezionati, separati da punto e virgola.

Gli output sono definiti in maniera simile, usando i seguenti tag:
\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}

Il valore assegnato alle variabili di otput è sempre una stringa con un percorso file. Esso corrisponde al percorso di un file temporaneo nel caso in cui l'utente non ha specificato alcun file di output.

Quando si dichiara un output, SEXTANTE cercherà di aggiungerlo QGIS una volta che l'algoritmo è finito. Questa è la ragione per cui, anche se il comando {}`{}` runalg () {}`{}` non carica i layer che produce, il layer finale del TWI verrà caricato, poiché è salvato nel file scelto dall'utente, che è il valore dell'output corrispondente.

Non usare il comando {}`{}` load() {}`{}` negli algoritmi di script, ma solo quando si lavora con la linea di comando. Se un layer viene creato come output di un algoritmo, esso dovrebbe essere dichiarato come tale. In caso contrario,  l'algoritmo nel modellatore non potrà essere utilizzato correttamente, dal momento che la sua sintassi (come definita dai tag spiegato sopra) non corrisponde a ciò che l'algoritmo in realtà crea.

Output nascosti (numeri e stringhe) non hanno un valore. È invece l'utente che deve assegnare loro un valore. Per farlo, è sufficiente impostare il valore di una variabile con il nome utilizzato per dichiarare quell'output. Per esempio, se è stata usata questa dichiarazione,

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{c}{\PYGZsh{}\PYGZsh{}average=output number}
\end{Verbatim}

la riga seguente imposterà il valore dell'output a 5:

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{n}{average} \PYG{o}{=} \PYG{l+m+mi}{5}
\end{Verbatim}

Oltre ai tag per i parametri e gli output, è anche possibile definire il gruppo in cui verrà mostrato l'algoritmo, utilizzando il tag {}`{}` group {\color{red}\bfseries{}{}`{}`}.

Se l'algoritmo impiega molto tempo per elaborare, è una buona idea informare l'utente. Si dispone di due comandi globali denominati {\color{red}\bfseries{}{}`{}`}progress {\color{red}\bfseries{}{}`{}`}con due metodi disponibile : {}`{}` setText (testo) {}`{}` e {}`{}` setPercentage (percent) {}`{}` per modificare il testo e la barra di avanzamento.

Con SEXTANTE sono forniti diversi esempi. Si prega di controllarli per vedere alcuni esempi reali di come creare algoritmi che utilizzano questa funzione di SEXTANTE. È possibile fare clic destro su un qualsiasi algoritmo di script e selezionare select \emph{Edit script} per modificare il codice o solo per vederlo.


\subsection{Documentare gli script}
\label{docs/user_manual/sextante/console:documenting-your-scripts}
Come nel caso dei modelli, è possibile creare una documentazione aggiuntiva per gli script, per spiegare che cosa fanno e come usarli. Nella finestra di modifica dello script si trova un pulsante \textbf{{[}Edit script help{]}}. Fare clic su di esso e si aprirà una finestra di editing dell'help. Controllare il capitolo sul modellatore grafico per sapere di più su questa finestra di dialogo e come usarla.

I file della guida vengono salvati nella stessa cartella dello stesso script, aggiungendo l'estensione \code{.help} al nome del file. Si noti che è possibile modificare la guida dello script prima di salvarlo per la prima volta. Se in seguito si chiude la finestra di modifica dello script senza salvare lo script (cioè la si scarta), il contenuto già scritto della guida verrà perso. Se lo script è già stato salvato ed è associato ad un nome di file, il salvataggio è fatto automaticamente.


\section{Il gestore della cronologia di SEXTANTE}
\label{docs/user_manual/sextante/history::doc}\label{docs/user_manual/sextante/history:the-sextante-history-manager}

\subsection{La cronologia di SEXTANTE}
\label{docs/user_manual/sextante/history:the-sextante-history}
Ogni volta che eseguite un algoritmo di SEXTANTE, le informazioni sul processo sono salvate dal gestore della cronologia (di SEXTANTE). Insieme sono salvati anche i parametri usati, la data ed il tempo di esecuzione.

In questo modo è comodo tenere traccia, controllare tutto il lavoro sviluppato usando SEXTANTE e riprodurlo in tutta facilità.

Il gestore della cronologia di SEXTANTE è un insieme di registri raggruppati per data di esecuzione, ciò che rende facile trovare l'informazione su uno specifico algoritmo eseguito in un particolare momento.
\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}

L'informazione sul processo è conservata come una espressione a linea di comando, anche se l'algoritmo è stato avviato dalla cassetta degli attrezzi. Questo lo rende utile anche per coloro che stanno imparando come usare l'interfaccia a linea di comando, in quanto possono richiamare un algoritmo usando la cassetta degli attrezzi e poi controllare il gestore cronologico per vedere come lo stesso algoritmo dovrebbe essere invocato dalla linea di comando.

Oltre a poter scorrere la lista del registro, è possibile rieseguire i processi semplicemente premendo due volte il loro nome con il mouse.

Durante l'esecuzione degli algoritmi, SEXTANTE comunica con l'utente usando altri gruppi del registro, specificatamente \emph{Errori}, \emph{Avvertenze} e \emph{Informazioni}. Nel caso qualcosa non funzioni correttamente, uno sguardo a \emph{Errori} può aiutarvi a capire cosa sta succedendo. Se contattate uno sviluppatore di SEXTANTE per riportare un difetto o un errore, l'informazione di questo gruppo gli sarà molto utile per trovare quello che non funziona.

Se eseguite algoritmi di terze parti, questo è fatto normalmente richiamando la loro interfaccia a linea di comando che comunica con l'utente attraverso il video. Per quanto questa informazione (in SEXTANTE) non è visualizzata , una copia completa è salvata nel gruppo \emph{Informazioni} ogni volta che lanciate quell'algoritmo. Se ad esempio, avete dei problemi eseguendo un algoritmo di SAGA cercate nella voce `SAGA uscita di controllo dell'esecuzione' per controllare tutti i messaggi generati da SAGA e cercare di trovare la spiegazione del problema.

Alcuni algoritmi, anche se possono produrre un risultato con i dati di ingresso forniti, possono aggiungere commenti o informazioni aggiuntive a \emph{Avvertenze} nel caso riscontrino potenziali problemi derivanti da quei dati, in modo da avvertirvi. Assicuratevi di controllare questi messaggi ogni volta che ricevete risultati inaspettati.


\section{Configurazione di applicazioni esterne}
\label{docs/user_manual/sextante/3rdParty:configuring-external-applications}\label{docs/user_manual/sextante/3rdParty::doc}

\subsection{Introduzione}
\label{docs/user_manual/sextante/3rdParty:introduction}
SEXTANTE può essere esteso usando applicazioni aggiuntive richiamate dall'interno di SEXTANTE; al momento sono supportati: SAGA, GRASS,OrfeoToolBox e R oltre a qualche altra applicazione a linea di comando che fornisce funzionalità di analisi spaziale; Algoritmi che si appoggiano ad applicazoni esterne sono gestite dal proprio gestore.

Questo capitolo vi mostrerà come configurare SEXTANTE per includere queste applicazioni addizionali e vi spiegherà alcune prestazioni particolari degli algoritmi basati su di esse. Una volta configurato il sistema, sarete in grado di eseguire algoritmi esterni da ogni componente di SEXTANTE tipo il toolbox o il modellatore grafico, esattamente come ogni altro geoalgoritmo di SEXTANTE.

Inizialmente tutti gli algoritmi contenuti in applicazioni esterne non distribuite con QGIS non sono abilitate. Potete abilitarle nella finestra di configurazione di SEXTANTE. Assicuratevi che la corrispondente applicazione sia installata sul vostro sistema; l'abilitazione del gestore dell'algoritmo senza aver installato la corrispondente applicazione farà apparire l'algoritmo nella toolbox, ma genererà un errore quando cercherete di eseguirlo.

Questo dipende dal fatto che le descrizioni degli algoritmi (necessari a creare i parametri di configurazione ed a fornire a SEXTANTE le necessarie informazioni sugli stessi) non sono incluse nelle applicazioni ma in SEXTANTE; cioè sono parte di SEXTANTE, così le avete nella vostra installazione anche se non avete installato nessun altro software, tuttavia per il funzionamento è necessario aver installato sul vostro sistema i binari dell'applicazione.


\subsubsection{Nota sui formati dei files}
\label{docs/user_manual/sextante/3rdParty:a-note-on-file-formats}
Quando si usa un software esterno, l'apertura di un file in QGIS non garantisce che il file venga aperto e trattato esattamente come nell'altro software. Nella maggior parte dei casi il file sarà letto in QGIS,ma in alcuni casi potrebbe non esserlo. Quando si usano   databases o formati di files particolari, sia raster che vettoriali, potrebbe capitare qualche problema. Se ciò accade, assicuratevi di usare file in formati noti e riconosciuti da entrambi i programmi e controllate nella console (nello storico dei comandi o nel registro di controllo) per approfondire ciò che è andato storto.

L'uso di mappe raster di GRASS, ad esempio, è uno dei casi in cui potreste avere problemi e non riuscire a concludere il vostro lavoro nel caso doveste usare un algoritmo esterno per elaborare tale mappa. Per questo motivo queste mappe non appariranno disponibili per gli algoritmi di SEXTANTE (stiamo lavorando per risolvere questo problema, abbiate fiducia che arriverà presto).

D'altra parte non dovreste aver alcun problema con le mappe vettoriali in quantoSEXTANTE provvede automaticamente alla conversione in un formato adatto al programma esterno prima di passare la mappa. Questo aumenta il tempo di elaborazione che potrebbe diventare significativo con mappe di grande dimensione, quindi non stupitevi se richiede più tempo elaborare una mappa fornita da una connessione DB rispetto ad una di pari dimensione in formato SHP.

I gestori che non usano applicazioni esterne possono elaborare ogni mappa compatibile con QGIS perchè usano questo per aprirla.

Per quanto riguarda i formati di uscita le mappe raster posso essere salvate come files TIFF (\code{.tif}) mentre le mappe vettoriali sono salvate come files SHP. Questi sono stati scelti come ``lingua franca'' fra le applicazioni esterne e QGIS. Se scegliete un nome di file diverso dai precedenti, sarà modificato nel formato standard con l'aggiunta del suffisso adatto.

Nel casodi GDAL il numero di formati di uscita supportati è maggiore. Quando aprite la finestra di dialogo vedrete che avete a disposizione più formati (con le corrispondenti estensioni). Per maggiori informazioni sui formati di file supportati controllate la documentazione di GDAL.


\subsubsection{Nota sulla selezione con mappe vettoriali}
\label{docs/user_manual/sextante/3rdParty:a-note-on-vector-layer-selections}
Normalmente quando un programma esterno tratta una mappa vettoriale,elabora tutti gli oggetti presenti, anche nel caso sia stata attivata una selezione parziale in QGIS. Potete limitare l'esecuzione del programma solo agli oggetti selezionati spuntando la casella \emph{Usa i comandi esterni sugli oggetti selezionati} presente nel gruppo \emph{Generale}. In tal caso ogni volta che eseguirete un programma esterno che usa mappe vettoriali gli oggetti selezionati saranno esportati in una nuova mappa; sarà questa ad essere elaborata dal programma.

Ricordate che selezionando questa opzione una mappa senza selezione attiva verrà tratta come una mappa con  tutti gli oggetti selezionati, non come una mappa vuota.


\subsection{SAGA}
\label{docs/user_manual/sextante/3rdParty:saga}
Per poter eseguire gli algoritmi di SAGA attraverso SEXTANTE dovete avere SAGA installato nel vostro sistema e configurato opportunamente SEXTANTE in modo che possa trovare gli eseguibili di SAGA. In particolare per eseguire gli algoritmi di SAGA sono necessari i suoi eseguibili a linea di comando. Gli eseguibili di SAGA non sono inclusi in SEXTANTE, quindi dovete scaricare ed installare il software direttamente. Controllate il sito web di SAGA per maggiori informazioni. E' necessaria la versione SAGA 2.0.8.

Una volta installallato SAGA e nel caso stiate usando Windows, aprite la finestra di configurazione di SEXTANTE; nella casella \emph{SAGA} troverete una casella \emph{cartella di SAGA}; inserite il percorso della cartella dove avete installato SAGA; chiudete la finestra di configurazione ed avete SAGA pronto per essere usato in SEXTANTE.

Nel caso stiate usando Linux, questo non è necessario e non vedrete queste cartelle; al contrario dovrete assicurarvi che SAGA sia correttamente installato nel vostro sistema e che la cartella di installazione sia aggiunta alla variabile di ambiente PATH; aprite una console e date l'istruzione \code{saga\_cmd} per controllare che il sistema riesca a trovare la cartella dove SAGA è stato installato.


\subsubsection{Le limitazioni del sistema di griglia di Saga}
\label{docs/user_manual/sextante/3rdParty:about-saga-grid-system-limitations}
Numerosi algoritmi di SAGA che operano su diversi layers raster, richiedono che gli stessi abbiano la stessa griglia, cioè che abbiano la stessa estensione geografica e la stessa dimensione di cella, in modo che la loro griglia coincida. Quando usate algoritmi SAGA da SEXTANTE non dovete preoccuparvi della loro estensione e della loro cella; quando date in pasto a SAGA parecchi layers raster  SEXTANTE li ricampiona ad una griglia comune e quindi li passa a SAGA, a meno che gli algoritmi di SAGA siano in grado di operare direttamente su layer con griglie diverse.

La definizione della griglia comune è controllata dall'utente, troverete parecchi parametri nello gruppo SAGA della finestra di configurazione; ci sono due modi definire la griglia voluta:
\begin{itemize}
\item {} 
Configurazione manuale: potete definire i valori dei seguenti parametri:
\begin{itemize}
\item {} 
dimensione minima della cella in X

\item {} 
dimensione massima della cella in X

\item {} 
dimensione minima della cella in Y

\item {} 
dimensione massima della cella in Y

\item {} 
Ricampionamento della dimensione di cella

\end{itemize}

Attenzione: SEXTANTE ricampionerà il layer in ingresso a questa griglia anche se non coincidente.

\item {} 
Configurazione automatica in funzione del layer in ingresso: per selezionare questa opzione basta spuntare la casella \emph{Usa la minima griglia che copre i layers per il ricampionamento}; tutte gli altri parametri di configurazione verranno trascurati e verrà usata l'estensione minima che ingloba tutti il ayers (inviluppo); la dimensione di cella sarà quella massima dei layers in ingresso.

\end{itemize}

Per gli algoritmi che non operano su molteplici layers o che non necessitano di un'unica griglia, non verrà operato alcun campionamento.


\subsubsection{Limitazioni per i raster multi-banda}
\label{docs/user_manual/sextante/3rdParty:limitations-for-multi-band-layers}
Diversamente da QGIS, SAGA non ha supporto per i raster multibanda. Per usare raster multibanda (ad es. come immagini RGB o multispettrali) dovete prima scomporli in raster mono banda; per farciò potete usare l'algoritmo `SAGA/Grid - Tools/Split RGB image' (che crea 3 immagini da un RGB) o l'algoritmo `SAGA/Grid - Tools/Extract band' (per estrarre una singola banda).


\subsubsection{Limitazioni nella dimensionedi cella}
\label{docs/user_manual/sextante/3rdParty:limitations-in-cellsize}
SAGA presume che i layers raster abbiano la stessa dimensione di cella sia in direzione X che in Y, se state lavorando con layer di cella rettangolare, potreste ottenere risultati inaspettati; in tal caso SEXTANTE emetterà un avviso nel log di SEXTANTE per indicare che il layer in ingresso potrebbe non essere adatto per essere elaborato da SAGA.


\subsubsection{Registrazioni di controllo}
\label{docs/user_manual/sextante/3rdParty:logging}
Quando SEXTANTE chiama SAGA, lo fa attraverso l'interfaccia a linea di comando , passando una lista di istruzioni per completare tutte le operazioni richieste. SAGA mostra la progressione dell'attività visualizzando informazioni sulla console compresa la stima percentuale dell'attività già eseguita, insieme ad informazioni aggiuntive; queste informazioni sono filtrate da SEXTANTE e usate per aggiornare la barra di stato durante l'esecuzione dei comandi.

Sia i comandi impartiti da SEXTANTE che le informazioni emesse da SAGA possono essere registrate insieme alle altre registrazioni di controllo di SEXTANTE; queste potrebbero rivelarsi utili per seguire in dettaglio quello che avviene mentre SEXTANTE esegue gli algoritmi di SAGA; troverete due caselle di spunta \emph{Stampa dei messaggi in console} e \emph{Rigestrazione della esecuzione dei comandi} per attivare il meccanismo di registrazione.

Alcuni altri gestori che usano applicazioni esterne mediante istruzioni a linea di comando hanno opzioni simili, quindi le potreste trovare in altre situazioni della configurazione di SEXTANTE.


\subsection{R e gli scripts R}
\label{docs/user_manual/sextante/3rdParty:r-and-r-scripts}
R è integrato in SEXTANTE in modo diverso da SAGA perchè non c'è un insieme predefinito di algoritmi che potete lanciare (salvo alcuni casi); al contrario dovete scrivere i vostri scripts e chiamare i comandi di R esattamente come fareste in R e in modo molto simile a quanto abbiamo detto nel capitolo dedicato agli scripts diSEXTANTE. Questo capitolo vi mostra la sintassi da usare per chiamare i comandi di R dall'interno di SEXTANTE e come usare gli oggetti di SEXTANTE (layers,tabelle) in questo.

La prima cosa da fare,come abbiamo già detto per SAGA, è dire a SEXTANTE dove sono installati gli eseguibili di R. Potete farlo usando la casella \emph{cartella di R} nella finestra di configurazione di SEXTANTE. Una volta configurato questo parametro potete cominciare a creare i vostri scripts per R ed a eseguirli.

Ancora una volta, la cosa è diversa in Linux e dovete solo assicurarvi che la cartelladiR sia inclusa nella variabile di ambiente PATH; se eseguendo il comando \code{R} in una console, R si avvia, allora siete pronti per partire.

Per aggiungere un nuovo algoritmo che chiama una funzione di R (o un più complesso script che avete sviluppato e vorreste averlo disponibile in SEXTANTE) dovete creare uno script che dica a SEXTANTE come eseguire quell'operazione ed attivare i corrispondenti comandi di R.

I files di script hanno l'estensione \code{.rsx} e crearliè molto facile se avete la conoscenza basilare della sintassi di Re delle sue regole di scripting; devono essere salvati nella cartella di R; potete configurare tale cartella nel gruppo di configurazione di R (disponibile nella finestra di dialogo di SEXTANTE), esattamente come per la cartella dei normali script di SEXTANTE.

Diamo uno sguardo ad uno script molto semplice che chiama la funzione di R ``spsample'' per creare una griglia casuale all'interno dei confini dei poligoni (di un polygon layer); questa funzione appartiene al pacchetto ``maptools''. Poichè la gran parte degli algoritmi che vorrete incorporare in SEXTANTE useranno o genereranno dati spaziali, la conoscenza dei pacchetti spaziali tipo ``maptools'' e specialmente ``sp'' è obbligatoria.

\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}

Le prime linee, che partono con una coppia di simboli di commento del Python (\#\#) comunicano a SEXTANTE i valori di ingresso degli algoritmi descritti nel file ed i valori di uscita che genereranno. Essi usano la stessa sintassi degli script di SEXTANTE che abbiamo già visto, quindi non li ripeteremo quì; controllate la corrispondente sezione per maggiori ragguagli.

Quando dichiarate un parametro di ingresso, SEXTANTE usa quell'informazione per due scopi:creare l'interfaccia per la richiesta all'utente del valore di quel parametro e creare una corrispondente variabile di R che può essere passata successivamente ai comandi di R.

Nel precedente esempio abbiamo dichiarato un valore di ingresso di tipo ``vettore'' chiamato ``polyg''. Nell'esecuzione dell'algoritmo SEXTANTE aprirà in R il layer selezionato dall'utente e lo memorizzerà in una variabile di nome ``polyg'', quindi il nome del parametro è anche il nome della variabile che si usa in R per accedere al valore del parametro (di conseguenza evitate di usare parole riservate di R come nomi di parametro).

Elementi spaziali tipo layer vettoriali e raster sono letti usando i comandi \code{readOGR()} e \code{readGDAL()} (non dovete preoccuparvene in quanto ci penserà SEXTANTE ad aggiungere tali comandi al vostro file di descrizione) e salvati come oggetti {\color{red}\bfseries{}{}`{}`}Spatial*DataFrame{}`{}`I campi di una tabella sono salvati come stringhe contenenti il nome del campo selezionato.

Le tabelle sono aperte usando il comando \code{read.csv()}.Se la tabella non è in formato CSV sarà preventivamente convertita in tale formato prima di essere importata in R.

Detto ciò, ora possiamo capire la prima linea del nostro script di esempio (la prima senza il segno di commento in Python).

\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 variabile \code{polygon} contiene un oggetto \code{SpatialPolygonsDataFrame} così può essere usato per chiamare la funzione \code{spsample}  o similmente la funzione \code{numpoints} che indica il numero di punti da aggiungere alla griglia creata.

Avendo dichiarato un risultato di tipo vettore chiamato \code{out}, dobbiamo creare una variabile di nome \code{out} e memorizzarvi un oggetto \code{Spatial*DataFrame} (in questo caso un \code{SpatialPointsDataFrame}). Potete usare qualsiasi nome per le variabili intermedie, assicuratevi però che la variabile contenente il risultato finale abbia lo stesso nome con cui l'avete dichiarata e che contenga un valore appropriato.

In questo caso il risultato ottenuto dalla funzione \code{spsample} deve essere convertito esplicitamente in un oggetto \code{SpatialPointsDataFrame} in quanto è nativamente un oggetto di classe \code{ppp} che non è una classe adatta per SEXTANTE.

Se il vostro algoritmo non genera un layer ma un risultato testuale, dovete dire a SEXTANTE che volete attivare la console una volta finita l'elaborazione. Per farlo iniziate la linea di comando che produce il risultato che volete visualizzare con il carattere \code{\textgreater{}} (maggiore di); il risultato di tutti gli altri comandi non sarà mostrato. Ad esempio quì c'è il file di descrizione di un algoritmo che esegue un test di normalità su un dato campo (colonna) degli attributi di un layer vettoriale:

\begin{Verbatim}[commandchars=\\\{\}]
\#\#layer=vector
\#\#field=field layer
\#\#nortest=group
library(nortest)
\textgreater{}lillie.test(layer[[field]])
\end{Verbatim}

Il risultato dell'ultima linea sarà stampato,ma il risultato della prima no (e nemmeno quelli delle altre linee aggiunte automaticamente da SEXTANTE).

Se il vostro algoritmo produce qualche tipo di risultato grafico (usando la funzione \code{plot()}) dovete aggiungere la linea seguente:

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{c}{\PYGZsh{}\PYGZsh{}showplots}
\end{Verbatim}

Questo provocherà la redirezione di tutti i risultati grafici di R verso un file temporaneo che potrà essere aperto ad avvenuta esecuzione di R.

I risultati sia grafici che testuali saranno visualizzati nel gestore dei risultati di SEXTANTE.

Per maggiori informazioni controllate gli script forniti con SEXTANTE; la maggior parte di essi sono molto semplici e vi aiuteranno moltissimo a capire come costruire i vostri.


\subsection{GRASS}
\label{docs/user_manual/sextante/3rdParty:grass}
La configurazione di GRASS non è molto differente da quella di SAGA. Per prima cosa occorre definire, ma solo nel caso di Windows, il percorso della cartella di GRASS; Inoltre occorre definire la shell di interfaccia normalmente \code{msys.exe}  che si trova in molte distribuzioni di GRASS per Windows) ed il suo percorso.

Normalmente SEXTANTE cerca di configurare il suo connettore per GRASS per usare la distribuzione inclusa in QGIS; questo dovrebbe funzionare senza problemi nella maggior parte dei casi, ma se riscontrate dei problemi, avete la possibilità di agire manualmente. Inoltre se volete usare una versionedi GRASS differente, potete cambiare la configurazione per indirizzarla verso il percorso della cartella dove avete salvato la versionedi GRASS che volete usare. Per un corretto funzionamento degli algoritmi è richiesta la versione 6.4 d iGrass.

Se state usando Linux dovete solo assicurarvi che GRASS è correttamente installato e che può essere attivato senza problemi da una console.

Gli algoritmi di GRASS usano una regione per le loro elaborazioni.Questa regione può essere definita manualmente, usando valori simili a quelli usati per la configurazione di SAGA, o automaticamente, prendendo ogni volta la minima estensione geografica che contiene i layers usati per il calcolo. Se preferite questo funzionamento spuntate la casella  \emph{Usa la minima regione} disponibile nei parametri di configurazione di GRASS.

GRASS contiene dei files di aiuto che descrivono ogni algoritmo. Se spuntate la casella \emph{GRASS cartella di aiuto}  SEXTANTE l'aprirà quando userete il bottone \textbf{{[}Visualizza aiuto{]}} della finestra dei parametri dell'algoritmo.

L'ultimo parametro da configurare è legato al mapset. È necessanio un mapset. per eseguire GRASS e SEXTANTE ne crea uno provvisorio per ogni esecuzione. Dovete segnalare a SEXTANTE se state usando coordinate geografiche (lat/lon) o proiettate.


\subsection{GDAL}
\label{docs/user_manual/sextante/3rdParty:gdal}
Per eseguire GDAL non è necessaria alcuna configurazione perchè è già incorporato in QGIS e SEXTANTE preleva da lì la propria configurazione.


\subsection{Orfeo ToolBox}
\label{docs/user_manual/sextante/3rdParty:orfeo-toolbox}
Gli algoritmi di Orfeo ToolBox (OTB) possono essere usatiin SEXTANTE seavete OTB installato sul vostro sistema e configurato opportunamente SEXTANTE in modo che possa trovare tutti i files necessari (comandi a linea e librerie). Prendete nota che gli eseguibili di SEXTANTE non sono inclusi in SEXTANTE,per cui dovete scaricarli ed installarli da soli. Controllate il sito di OTB per maggiori informazioni.

Una volta installato OTB, avviate QGIS, aprite la finestra di configurazione di SEXTANTE e inserite il gestore degli algoritmi di OTB. Nella casella \emph{Orfeo Toolbox (analisi di immagini)} troverete ogni parametro relativo a OTB; per prima cosa assicuratevi che gli algoritmi di OTB sono abilitati.

Quindi configurate il percorso della cartella che contiene i comandi e le librerie di OTB:
\begin{itemize}
\item {} 
\includegraphics[width=1em]{nix.png} normalmente \emph{OTB cartella dell'applicazione} punta a \code{/usr/lib/otb/applications} e \emph{OTB cartella dei comandi} è \code{/usr/bin}

\item {} 
\includegraphics[width=1em]{win.png} se usate l'installatore OSGeo4W allora installate il pacchetto \code{otb-bin} ed inserite \code{C:\textbackslash{}OSGeo4W\textbackslash{}apps\textbackslash{}orfeotoolbox\textbackslash{}applications} come \emph{OTB cartella dell'applicazione} e \code{C:\textbackslash{}OSGeo4W\textbackslash{}bin} come \emph{OTB cartella dei comandi}

\end{itemize}


\subsection{TauDEM}
\label{docs/user_manual/sextante/3rdParty:taudem}
Per installare questo gestore dovete installare gli strumenti di TauDEM a linea di comando.


\subsubsection{Windows}
\label{docs/user_manual/sextante/3rdParty:windows}
Per le istruzioni di installazione e gli eseguibili precompilati per sistemi a 32bit e 64bit visitate il \emph{sito TauDEM \textless{}http://hydrology.usu.edu/taudem/taudem5.0/downloads.html\textgreater{}}. \textbf{IMPORTANTE}: servono gli eseguibili della versione 5.0.6, la versione 5.2 non è al momento supportata.


\subsubsection{Linux}
\label{docs/user_manual/sextante/3rdParty:linux}
Per molte distribuzioni Linux non sono disponibili pacchetti precompilati così dovete compilare TauDEM da soli. Poichè TauDEM usa MPICH2, per prima cosa dovete installarlo mediante il vostro gestore dei pacchetti preferito. TauDEM lavora bene anche con OpenMPI, quindi potete usare questo in sostituzione di MPICH2.

Scaricate i sorgenti di TauDEM 5.0.6 dal sito \textless{}\href{http://hydrology.usu.edu/taudem/taudem5.0/TauDEM5PCsrc\_506.zip}{http://hydrology.usu.edu/taudem/taudem5.0/TauDEM5PCsrc\_506.zip}\textgreater{}{}` e scompattate i files in qualche cartella.

Aprite il file \code{linearpart.h} ed aggiungete dopo la linea

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{c}{\PYGZsh{}include \PYGZdq{}mpi.h\PYGZdq{}}
\end{Verbatim}

aggiungete una nuova linea con

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{c}{\PYGZsh{}include \PYGZlt{}stdint.h\PYGZgt{}}
\end{Verbatim}

così avrete

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{c}{\PYGZsh{}include \PYGZdq{}mpi.h\PYGZdq{}}
\PYG{c}{\PYGZsh{}include \PYGZlt{}stdlib.h\PYGZgt{}}
\end{Verbatim}

Salvate le modifiche e chiudete il file. Ora aprite il file \code{tiffIO.h}, cercate la linea \code{\#include "stdint.h"} e sostituite gli apostrofi (\code{""}) con \code{\textless{}\textgreater{}}, così avrete

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{c}{\PYGZsh{}include \PYGZlt{}stdint.h\PYGZgt{}}
\end{Verbatim}

Salvate le modifiche e chiudete il file.Create la cartella di compilazione e spostatevi in essa

\begin{Verbatim}[commandchars=\\\{\}]
mkdir build
cd build
\end{Verbatim}

Preparate la vostra compilazione con il comando

\begin{Verbatim}[commandchars=\\\{\}]
CXX=mpicxx cmake -DCMAKE\_INSTALL\_PREFIX=/usr/local ..
\end{Verbatim}

e quindi compilate

\begin{Verbatim}[commandchars=\\\{\}]
\PYG{n}{make}
\end{Verbatim}

Infine per installare TauDEM in \code{/usr/local/bin} eseguite

\begin{Verbatim}[commandchars=\\\{\}]
sudo make install
\end{Verbatim}

\index{Create\_Maps}
\index{Layout\_Maps}
\index{Compose\_Maps}

\chapter{Compositore di stampe}
\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}
Il compositore di stampe fornisce funzionalità per la creazione di layout di stampa in continua evoluzione. Consente di aggiungere al layout elementi come la vista mappa, la legenda, la barra di scala, immagini esterne, forme e campi testuali. È possibile cambiare le dimensioni, raggruppare, allineare e spostare ogni elemento e regolarne le proprietà. Il risultato può essere stampato (anche come Postscript e PDF), esportato come immagine o come disegno vettoriale in formato SVG. Il layout, inoltre, può essere salvato come modello e caricato in altre sessioni di QGIS. Si veda l’elenco degli strumenti nella tabella {\hyperref[docs/user_manual/print_composer/print_composer:table-composer-1]{table\_composer\_1}}:

\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 
Icona
} & \textsf{\relax 
Azione
} & \textsf{\relax 
Icona
} & \textsf{\relax 
Azione
}\\
\hline &  &  & \\

\includegraphics[width=1.5em]{mActionFolder.png}
 & 
Caraica da modello
 & 
\includegraphics[width=1.5em]{mActionFileSaveAs.png}
 & 
Salva come modello
\\

\includegraphics[width=1.5em]{mActionSaveMapAsImage.png}
 & 
Esporta come immagine
 & 
\includegraphics[width=1.5em]{mActionSaveAsPDF.png}
 & 
Esporta come PDF
\\

\includegraphics[width=1.5em]{mActionSaveAsSVG.png}
 & 
Esporta come SVG
 & 
\includegraphics[width=1.5em]{mActionFilePrint.png}
 & 
Stampa
\\

\includegraphics[width=1.5em]{mActionZoomFullExtent.png}
 & 
Vista ad estensione massima
 & 
\includegraphics[width=1.5em]{mActionZoomIn.png}
 & 
Ingrandisci
\\

\includegraphics[width=1.5em]{mActionZoomOut.png}
 & 
Rimpicciolisci
 & 
\includegraphics[width=1.5em]{mActionDraw.png}
 & 
Aggiorna la vista
\\

\includegraphics[width=1.5em]{mActionUndo.png}
 & 
Annulla l'ultimo cambiamento
 & 
\includegraphics[width=1.5em]{mActionRedo.png}
 & 
Rispristina l'ultimo cambiamento
\\

\includegraphics[width=1.5em]{mActionAddMap.png}
 & 
Aggiungi mappa
 & 
\includegraphics[width=1.5em]{mActionAddImage.png}
 & 
Aggiungi immagine
\\

\includegraphics[width=1.5em]{mActionLabel.png}
 & 
Aggiungi etichetta
 & 
\includegraphics[width=1.5em]{mActionAddLegend.png}
 & 
Aggiungi nuova legenda vettoriale
\\

\includegraphics[width=1.5em]{mActionScaleBar.png}
 & 
Aggiungi nuova barra di scala
 & 
\includegraphics[width=1.5em]{mActionAddBasicShape.png}
 & 
Aggiungi forma base
\\

\includegraphics[width=1.5em]{mActionAddArrow.png}
 & 
Aggiungi freccia
 & 
\includegraphics[width=1.5em]{mActionOpenTable.png}
 & 
Aggiungi tabella attributi
\\

\includegraphics[width=1.5em]{mActionSelectPan.png}
 & 
Scegli/Sposta oggetto
 & 
\includegraphics[width=1.5em]{mActionMoveItemContent.png}
 & 
Sposta contenuto elemento
\\

\includegraphics[width=1.5em]{mActionGroupItems.png}
 & 
Raggruppa oggetti
 & 
\includegraphics[width=1.5em]{mActionUngroupItems.png}
 & 
Rimuovi raggruppamento
\\

\includegraphics[width=1.5em]{mActionRaiseItems.png}
 & 
Muovi in alto
 & 
\includegraphics[width=1.5em]{mActionLowerItems.png}
 & 
Muovi in basso
\\

\includegraphics[width=1.5em]{mActionMoveItemsToTop.png}
 & 
Porta in cima
 & 
\includegraphics[width=1.5em]{mActionMoveItemsToBottom.png}
 & 
Porta in fondo
\\

\includegraphics[width=1.5em]{mActionAlignLeft.png}
 & 
Allinea a sinistra
 & 
\includegraphics[width=1.5em]{mActionAlignRight.png}
 & 
Allinea a destra
\\

\includegraphics[width=1.5em]{mActionAlignHCenter.png}
 & 
Allinea su asse verticale
 & 
\includegraphics[width=1.5em]{mActionAlignVCenter.png}
 & 
Allinea su asse orizzontale
\\

\includegraphics[width=1.5em]{mActionAlignTop.png}
 & 
Allinea in alto
 & 
\includegraphics[width=1.5em]{mActionAlignBottom.png}
 & 
Allinea in basso
\\
\hline\end{tabulary}


Strumenti del Compositore di Stampe

Tutti gli strumenti di Composizione di Stampa sono accessibili sia dai menu che dalla barra degli strumenti. La barra degli strumenti può essere disattivata cliccando con il tasto destro del mouse direttamente sulla barra.

\index{Composer\_Template}
\index{Map\_Template}

\section{Aprire un nuovo modello di stampa}
\label{docs/user_manual/print_composer/print_composer:index-5}\label{docs/user_manual/print_composer/print_composer:open-a-new-print-composer-template}
Prima di iniziare a lavorare con il compositore di stampe, è necessario caricare alcuni layer raster e vettoriali nella vista mappa di QGIS e regolarne le proprietà secondo le proprie esigenze. Una volta effettuate tutte le impostazioni e applicata la simbologia cliccare sul pulsante \includegraphics[width=1.5em]{mActionNewComposer.png} $^{\text{Nuova composizione di stampa}}$ oppure cliccare su \emph{File \(\rightarrow\) Nuova composizione di stampa}.


\section{Usare il compositore di stampe}
\label{docs/user_manual/print_composer/print_composer:using-print-composer}
Aprendo il compositore di stampe viene visualizzato un foglio bianco al quale aggiungere mappa, legenda, barra di scala, immagini, forme e testo. La figura {\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-1]{Figure\_composer\_1}} mostra la vista iniziale del compositore di stampe prima dell’aggiunta di un qualunque elemento, con la modalità \includegraphics{checkbox.png} \emph{Snap alla griglia} attivata.
\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}

Il compositore di stampe presenta tre schede:
\begin{itemize}
\item {} 
La scheda \emph{Generale} consente di impostare la dimensione del foglio, l’orientamento e la qualità di stampa del file in uscita in dpi e le modalità di snap. Si noti che la casella di controllo \includegraphics{checkbox.png} \emph{Snap alla griglia} funziona solo se si è impostata una risoluzione \textgreater{} 0. Inoltre, è possibile attivare la casella di controllo \includegraphics{checkbox.png} \emph{Stampa come raster}: tutti gli elementi saranno rasterizzati prima della stampa o del salvataggio come Postscript o PDF.

\item {} 
La scheda \emph{Oggetto} mostra le proprietà dell'elemento selezionato nel layout di stampa.Cliccare sull'icona \includegraphics[width=1.5em]{mActionSelectPan.png} $^{\text{Seleziona/Sposta oggetto}}$ per selezionare un elemento (ad es. legenda, barra di scala o etichetta testuale) nel layout. Cliccare dunque sulla scheda \emph{Oggetto} e personalizzare le impostazioni dell'elemento selezionato.

\item {} 
La scheda \emph{Storico comandi} mostra la storia di tutti i cambiamenti attuati nel layout di stampa. È possibile cancellare e ripristinare più cambiamenti con un semplice click del mouse.

\end{itemize}

Possono essere aggiunti diversi elementi al compositore ed è anche possibile avere più di una mappa o legenda o barra di scala nel layout di stampa. Ogni elemento ha le sue proprietà e, nel caso delle viste mappa, la propria estensione. Per eliminare un elemento dal layout di stampa usare i tasti e \code{Canc} o \code{Backspace}.


\section{Aggiungere una mappa al layout nel compositore di stampe}
\label{docs/user_manual/print_composer/print_composer:adding-a-current-qgis-map-canvas-to-the-print-composer}
Per aggiungere una mappa, cliccare sul pulsante \includegraphics[width=1.5em]{mActionAddMap.png} $^{\text{Aggiungi mappa}}$ nella barra strumenti del compositore di stampe e tracciare sul layout un rettangolo in cui inserire la mappa. La modalità di visualizzazione della mappa può essere impostata nella scheda \emph{Oggetto}:
\begin{itemize}
\item {} 
\textbf{Rettangolo} visualizza un rettangolo vuoto con la scritta `La mappa verrà stampata Rettangolo qui'.

\item {} 
\textbf{Cache} disegna la mappa alla risoluzione corrente dello schermo. Se si ingrandisce/rimpiccolisce la finestra del compositore, la mappa non viene ridisegnata, ma l’immagine viene scalata.

\item {} 
\textbf{Visualizza} a differenza del metodo cache, in questo caso se si ridimensiona la finestra del compositore, la mappa viene ridisegnata.

\end{itemize}

\textbf{Cache} è la modalità predefinita per ogni nuovo compositore di mappe.

È possibile ridimensionare la mappa in un momento successivo cliccando sul pulsante \includegraphics[width=1.5em]{mActionSelectPan.png} $^{\text{Seleziona/Sposta oggetto}}$, selezionando un elemento e trascinando una delle maniglie blu agli angoli della mappa. Una volta selezionata una mappa, è possibile regolarne ulteriori proprietà nella scheda \emph{Opzioni}.

Per spostare l’area visualizzata nella vista mappa, cliccare sul pulsante \includegraphics[width=1.5em]{mActionMoveItemContent.png} $^{\text{Sposta contenuto oggetto}}$ e spostare la vista nella cornice della vista mappa trascinando con il tasto sinistro del mouse premuto. È possibile \includegraphics[width=1.5em]{mIconLock.png} $^{\text{bloccare/sbloccare}}$ la posizione di un elemento nel layout di stampa selezionando e facendo click sullo stesso con il tasto destro del mouse, oppure attivando la casella di controllo \includegraphics{checkbox.png} \emph{Blocca i layer per la mappa} nella seziona Mappa della scheda \emph{Oggetto}.

\begin{notice}{note}{Nota:}
QGIS permette di utilizzare le etichette del nuovo plugin etichette anche nel compositore di stampe, anche se le stesse non vengono scalate correttamente: in alcuni casi potrebbe essere necessario utilizzare le etichette di vecchia generazione.
\end{notice}


\subsection{Oggetto Mappa --- Mappa ed Estensione mappa}
\label{docs/user_manual/print_composer/print_composer:map-item-properties-tab-map-and-extents-dialog}
\textbf{Finestra di dialogo Mappa}

La finestra di dialogo \emph{Mappa} presente nella scheda \emph{Oggetti} fornisce le seguenti funzionalità (figura {\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 sezione \textbf{{[}Anteprima{]}} permette di impostare la modalità di anteprima come descritto precedentemente. Cliccare su \textbf{{[}Aggiorna{]}} anteprima per salvare le modifiche.

\item {} 
La sezione \textbf{Mappa} permette di dimensionare gli elementi della mappa specificandone altezza e larghezza o la scala. Il campo \emph{Rotazione} \includegraphics{selectnumber.png} permette di ruotare il contenuto dell’elemento mappa in senso orario per gradi. Si noti che è possibile aggiungere un reticolato delle coordinate solo se il valore di rotazione è impostato a 0. Si possono, inoltre, attivare le caselle di controllo \includegraphics{checkbox.png} \emph{Blocca i layer per la mappa} e \includegraphics{checkbox.png} \emph{Disegna elementi sulla mappa}.

\end{itemize}

Se si apportano delle modifiche nella vista mappa di QGIS, è possibile aggiornare la vista nel compositore di stampe cliccando sul pulsante \textbf{{[}Aggiorna anteprima{]}} .

\textbf{Finestra di dialogo Estensione mappa}

La finstra di dialogo \emph{Estensione mappa} fornisce le seguenti funzionalità (figura {\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 sezione \textbf{{[}Estensione mappa{]}} permette di impostare l’estensione della mappa tramite valori minimo/massimo in X e Y o cliccando sul pulsante \textbf{{[}Imposta all’estensione della mappa{]}}.

\end{itemize}

Se si apportano delle modifiche nella vista mappa di QGIS, è possibile aggiornare la vista nel compositore di stampe selezionando l’elemento mappa e cliccando sul pulsante \textbf{{[}Aggiorna anteprima{]}} della sezione Mappa della scheda \emph{Oggetto} (figura {\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-2]{figure\_composer\_2}} a)).


\subsection{Oggetto Mappa --- Reticolato ed Opzioni generali}
\label{docs/user_manual/print_composer/print_composer:map-item-properties-tab-grid-and-general-options-dialog}
\index{Grid!Map\_Grid}
\textbf{Finestra di dialogo Reticolato}

La finestra di dialogo \emph{Reticolato} fornisce le seguenti funzionalità (figura {\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 casella di controllo \includegraphics{checkbox.png} \emph{Mostra reticolato} permette di sovrapporre una griglia sull’elemento mappa, specificandone tipo (Solido o Croce), intervallo ed offset in X e Y, spessore, colore.

\item {} 
La casella di controllo \includegraphics{checkbox.png} \emph{Scrivi le coordinate} permette di aggiungere le coordinate alla cornice della griglia. Le coordinate possono essere visualizzate all’interno o all’esterno della cornice, in verticale e/o n orizzontale; è inoltre possibile specificare il carattere, la distanza dalla mappa e la precisione delle coordinate.

\end{itemize}

\textbf{Finestra di dialogo Opzioni generali}

La finestra di dialogo \emph{Opzioni generali} fonrisce le seguenti funzionalità (figura {\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 {} 
E' possibile impostare colore e spessore esterno della cornice e colore ed opacità dello sfondo dell’elemento mappa. Il pulsante \textbf{{[}Posizione e dimensione{]}} apre la finestra di dialogo
\emph{Definisci posizione oggetto} che permette di impostare la posizione dell’elemento mappa tramite punti di riferimento o tramite coordinate. La casella di controllo \includegraphics{checkbox.png} \emph{Mostra cornice} permette di definire se visualizzare o meno la cornice di un elemento. L'opzione \emph{ID oggetto} permette creare un collegamento con altri oggetti di altri compositori di stampa.

\end{itemize}


\section{Aggiungere altri elementi al compositore di stampa}
\label{docs/user_manual/print_composer/print_composer:adding-other-elements-to-the-print-composer}
Oltre ad aggiungere una mappa al layout di stampa, è anche possibile aggiungere, spostare e personalizzare legenda, barra di scala, immagini ed etichette.


\subsection{Oggetto etichetta - Etichetta ed Opzioni generali}
\label{docs/user_manual/print_composer/print_composer:label-item-properties-tab-label-and-general-options-dialog}
Per aggiunger un'etichetta, cliccare su \includegraphics[width=1.5em]{mActionLabel.png} $^{\text{Aggiungi etichetta}}$, posizionare gli elementi con il tasto sinistro del mouse sul layout di stampa e personalizzarli nella scheda Etichette.

\textbf{Finestra di dialogo Etichetta}

La finestra di dialogo \emph{Etichetta} fornisce le seguenti funzionalità:
\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 {} 
La finestra di dialogo \emph{Etichetta} permette di inserire un testo al layout di stampa. È possibile impostare allineamento, carattere, colore e margine dell’etichetta.

\end{itemize}

\textbf{Finestra di dialogo Opzioni generali}

La finestra di dialogo \emph{Opzioni generali} fornisce le seguenti funzionalità:
\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 {} 
E' possibile impostare colore e spessore per la cornice dell’etichetta, impostare un colore di sfondo e l’opacità. Il pulsante \emph{Posizione e dimensione} apre la finestra di dialogo \emph{Definisci posizione oggetto} che permette di impostare la posizione dell’etichetta tramite punti di riferimento o tramite coordinate. La casella di controllo \includegraphics{checkbox.png} \emph{Mostra cornice} permette di definire se visualizzare o meno la cornice di un elemento.

\end{itemize}


\subsection{Oggetto immagine - Opzioni immagine ed Opzioni generali}
\label{docs/user_manual/print_composer/print_composer:image-item-properties-tab-picture-options-and-general-options-dialog}
Per aggiungere un'immagine, cliccare su \includegraphics[width=1.5em]{mActionSaveMapAsImage.png} $^{\text{Aggiungi immagine}}$, posizionare gli elementi con il tasto sinistro del mouse sul layout di stampa e personalizzarli nella relativa sezione nella scheda \emph{Oggetto}.

\index{Picture\_database}
\index{Rotated\_North\_Arrow}
\textbf{Finestra di dialogo Opzioni immagine}

La finestra di dialogo \emph{Opzioni immagine} fornisce le seguenti funzionalità (figura {\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-5]{figure\_composer\_5}} a):
\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 {} 
Il campo \textbf{Anteprima} mostra le immagini memorizzate nella cartella selezionata.

\item {} 
La sezione \textbf{Options} permette di impostare larghezze, altezza e rotazione dell’immagine. È anche possibile inserire un percorso ad un file immagine. Attivando la casella di controllo \includegraphics{checkbox.png} \emph{Sincronizza con la mappa}, si sincronizza la rotazione dell’immagine con quella dell'oggetto mappa.

\item {} 
La sezione \textbf{Cerca cartelle} permettere di selezionare ed aggiungere alla banca dati delle immagini le cartelle contenenti immagini in formato SVG.

\end{itemize}

\textbf{Finestra di dialogo Opzioni generali}

La finestra di dialogo \emph{Opzioni generali} fornisce le seguenti funzionalità:
\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 {} 
E' possibile impostare colore e spessore per la cornice dell’immagine, impostare un colore di sfondo e l’opacità. Il pulsante \textbf{{[}Posizione e dimensione{]}} apre la finestra di dialogo \emph{Definisci posizione oggetto} che permette di impostare la posizione dell’etichetta tramite punti di riferimento o tramite coordinate. La casella di controllo \includegraphics{checkbox.png} \emph{Mostra cornice} permette di definire se visualizzare o meno la cornice di un elemento.

\end{itemize}

\index{Map\_Legend}

\subsection{Oggetto legenda - Generale, Oggetti legenda ed Opzioni oggetto}
\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}
Per aggiunger una legenda, cliccare su \includegraphics[width=1.5em]{mActionAddLegend.png} $^{\text{Aggiungi nuova legenda vettoriale}}$, posizionare gli elementi con il tasto sinistro del mouse sul layout di stampa e personalizzarli nella relativa sezione nella scheda \emph{Oggetto}.

\textbf{Finestra di dialogo Generale}

La finestra di dialogo \emph{Generale} fornisce le seguenti funzionalità (figura {\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 {} 
E' possibile inserire un titolo per la legenda ed impostare i caratteri del titolo stesso, oltre che dei vari elementi della legenda (layer, gruppi, etc.). È possibile cambiare dimensione ai simboli di legenda ed inserire layer, simboli, etichette.Dalla versione 1.8 di QGIS è possibile modificare il carattere del titolo della legenda.

\end{itemize}

\textbf{Finestra di dialogo Oggetti legenda}

La finestra di dialogo \emph{Oggetti legenda} fornisce le seguenti funzionalità (figura {\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 {} 
La finestra elenca tutti gli elementi della legenda e permette di modificare (ordine e nome), rimuovere e ripristinare gli elementi stessi. Se si apportano delle modifiche alla simbologia nella vista mappa di QGIS, è possibile aggiornare la legenda nel compositore di stampe cliccando sul pulsante \textbf{{[}Aggiorna{]}}. L’ordine degli elementi può essere cambiato con i pulsanti \textbf{{[}Su{]}} e \textbf{{[}Giù{]}} oppure trascinandoli con il mouse.

\end{itemize}

\textbf{Finestra di dialogo Opzioni generali}

La finestra di dialogo \emph{Opzioni generali} fornisce le seguenti funzionalità (figura {\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 {} 
E' possibile impostare colore e spessore per la cornice della legenda, impostare un colore di sfondo e l’opacità. Il pulsante \textbf{{[}Posizione e dimensione{]}} apre la finestra di dialogo \emph{Definisci posizione oggetto} che permette di impostare la posizione dell’etichetta tramite punti di riferimento o tramite coordinate. La casella di controllo \includegraphics{checkbox.png} \emph{Mostra cornice} permette di definire se visualizzare o meno la cornice di un elemento.

\end{itemize}

\index{Scalebar!Map\_Scalebar}

\subsection{Oggetto Scala - Barra di scala ed Opzioni generali}
\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}
Per aggiungere una barra di scala, cliccare su \includegraphics[width=1.5em]{mActionScaleBar.png} $^{\text{Aggiungi nuova barra di scala}}$ , posizionare gli elementi con il tasto sinistro del mouse sul layout di stampa e personalizzarli nella relativa sezione nella scheda \emph{Oggetto}.

\textbf{Finestra di dialogo Barra di scala}

La finestra di dialogo \emph{Barra di scala} fornisce le seguenti funzionalità (figura {\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 {} 
Permette di impostare la dimensione del segmento della barra di scala, le unità di mappa e quanti segmenti unitari usare a sinistra e a destra dello 0.

\item {} 
È possibile definire lo stile della barra come riquadro singolo o doppio, con tacche verticali o numerico.

\item {} 
È possibile definire altezze, spessore linee, etichette e riquadro della barra, aggiungere etichette per l’unità di misura ed impostare carattere e colore.

\end{itemize}

\textbf{Finestra di dialogo Opzioni generali}

La finestra di dialogo \emph{Opzioni generali} fornisce le seguenti funzionalità (figura {\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-7]{figure\_composer\_7}} b)):
\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 {} 
E' possibile impostare colore e spessore per la cornice della barra di scala, impostare un colore di sfondo e l’opacità. Il pulsante \textbf{{[}Posizione e dimensione{]}} apre la finestra di dialogo \emph{Definisci posizione oggetto} che permette di impostare la posizione dell’etichetta tramite punti di riferimento o tramite coordinate. La casella di controllo \includegraphics{checkbox.png} \emph{Mostra cornice} permette di definire se visualizzare o meno la cornice di un elemento.

\end{itemize}


\section{Strumenti per l’esplorazione del layout di stampa}
\label{docs/user_manual/print_composer/print_composer:navigation-tools}
Per l’esplorazione del layout nel compositore di stampe sono forniti quattro strumenti:
\begin{itemize}
\item {} 
\includegraphics[width=1.5em]{mActionZoomIn.png} $^{\text{Ingrandisci}}$

\item {} 
\includegraphics[width=1.5em]{mActionZoomOut.png} $^{\text{Rimpicciolosci}}$

\item {} 
\includegraphics[width=1.5em]{mActionZoomFullExtent.png} $^{\text{Vista ad estensione massima}}$

\item {} 
\includegraphics[width=1.5em]{mActionDraw.png} $^{\text{Aggiorna la vista}}$, che serve nel caso in cui la vista nel layout non rispecchi quanto presente nella vista mappa di QGIS

\end{itemize}

\index{Revert\_Layout\_Actions}

\section{Strumenti Annulla e Ripristina}
\label{docs/user_manual/print_composer/print_composer:revert-and-restore-tools}\label{docs/user_manual/print_composer/print_composer:index-11}
Durante la creazione di un layout di stampa è possibile annullare e ripristinare dei cambiamenti tramite gli strumenti:
\begin{itemize}
\item {} 
\includegraphics[width=1.5em]{mActionUndo.png} $^{\text{Annulla l'ultimo cambiamento}}$

\item {} 
\includegraphics[width=1.5em]{mActionRedo.png} $^{\text{Ripristina l'ultimo cambiamento}}$

\end{itemize}

oppure tramite la scheda \emph{Storico dei comandi} (figura {\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-9]{figure\_composer\_9}}).
\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{Aggiungere forme di base e frecce}
\label{docs/user_manual/print_composer/print_composer:add-basic-shape-and-arrow}
È possibile aggiungere al layout di stampa forme geometriche (Ellisse, Rettangolo, Triangolo) e frecce.

La finestra di dialogo \emph{Forma} permette di tracciare un’ellisse, un rettangolo o un triangolo sul layout di stampa. È possibile impostare bordo, colore di riempimento e rotazione.
\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}

La finestra di dialogo \emph{Freccia} permette di tracciare una freccia sul layout di stampa. È possibile impostare colore, bordo, spessore, indicatore. Inoltre si possono usare simboli SVG dopo averli selezionati da una specifica cartella.
\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{Aggiungere valori dalla tabella degli attributi}
\label{docs/user_manual/print_composer/print_composer:add-attribute-table-values}
È possibile aggiungere parti di una tabella attributi al layout di stampa.

\textbf{Finestra di dialogo Tabella}

La finstra di dialogo \emph{Tabella} fornisce le seguenti funzionalità (figura {\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 {} 
Permette di selezionare un layer vettoriale e le colonne della tabella degli attributi. È possibile visualizzare le colonne attributo in ordine crescente o decrescente.

\item {} 
È possibile impostare il numero massimo di righe da visualizzare e scegliere se mostrare solo gli attributi degli elementi visibili nella mappa sul layout di stampa.

\item {} 
È, infine, possibile impostare le caratteristiche della griglia della tabella, l’intestazione ed il carattere.

\end{itemize}

\textbf{Finestra di dialogo Opzioni generali}

La finestra di dialogo \emph{Opzioni generali} fonrisce le seguenti funzionalità (figura {\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 {} 
E' possibile impostare colore e spessore esterno della cornice e colore ed opacità dello sfondo dell’elemento mappa. Il pulsante \textbf{{[}Posizione e dimensione{]}} apre la finestra di dialogo
\emph{Definisci posizione oggetto} che permette di impostare la posizione dell’elemento mappa tramite punti di riferimento o tramite coordinate. La casella di controllo \includegraphics{checkbox.png} \emph{Mostra cornice} permette di definire se visualizzare o meno la cornice di un elemento. L'opzione \emph{ID oggetto} permette creare un collegamento con altri oggetti di altri compositori di stampa.

\end{itemize}


\section{Muovere in alto, muovere in basso ed allineare elementi}
\label{docs/user_manual/print_composer/print_composer:raise-lower-and-align-elements}
Le funzionalità per muovere in alto o in basso gli elementi del layout di stampa sono nel menu \includegraphics[width=1.5em]{mActionRaiseItems.png} $^{\text{Muovi gli oggetti selezionati}}$: selezionare un elemento dal layout di stampa e scegliere la funzionalità richiesta dal menu citato (tabella {\hyperref[docs/user_manual/print_composer/print_composer:table-composer-1]{table\_composer\_1}}).

Diverse funzionalità di allineamento sono presenti nel menu \includegraphics[width=1.5em]{mActionAlignLeft.png} $^{\text{Allinea gli oggetti selezionati}}$ (tabella {\hyperref[docs/user_manual/print_composer/print_composer:table-composer-1]{table\_composer\_1}}): selezionare alcuni elementi dal layout di stampa e scegliere la funzionalità richiesta dal menu citato.

\index{Printing!Export\_Map}

\section{Creazione di file in uscita}
\label{docs/user_manual/print_composer/print_composer:creating-output}\label{docs/user_manual/print_composer/print_composer:index-12}
{\hyperref[docs/user_manual/print_composer/print_composer:figure-composer-22]{Figure\_composer\_22}} mostra il compositore di stampe con un layout di stampa completo di ognuno degli elementi precedentemente descritti.
\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}
Il compositore di stampe consente di creare diversi formati in uscita ed è possibile definirne la risoluzione (qualità di stampa) e il formato pagina:
\begin{itemize}
\item {} 
L'ciona \includegraphics[width=1.5em]{mActionFilePrint.png} $^{\text{Stampa}}$ consente di stampare il layout su una stampante collegata o su un file PDF o Postscript.

\item {} 
L'icona \includegraphics[width=1.5em]{mActionSaveMapAsImage.png} $^{\text{Esporta come immagine}}$ esporta il layout in diversi formati immagine come PNG, BPM, TIF, JPG,...

\item {} 
L'icona \includegraphics[width=1.5em]{mActionSaveAsPDF.png} $^{\text{Esporta come PDF}}$ esporta il layout in formato PDF.

\item {} 
L'icona \includegraphics[width=1.5em]{mActionSaveAsSVG.png} $^{\text{Esporta come SVG}}$ salva il layout di stampa in formato SVG (Scalable Vector Graphic).

\end{itemize}

\begin{notice}{note}{Nota:}
Attualmente il supporto SVG è ad un livello molto iniziale. Il problema non è di QGIS, ma nella sottostante libreria Qt. Ci si augura che questo problema venga risolto nelle prossime versioni della libreria.
\end{notice}

\index{Composer\_Manager}

\section{Salvare e caricare un layout di stampa}
\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}
L'icona \includegraphics[width=1.5em]{mActionFileSaveAs.png} $^{\text{Salva come modello}}$ consente di salvare lo stato della sessione del compositore di stampe come modello in un file con estensione \code{.qpt}. L’icona \includegraphics[width=1.5em]{mActionFolder.png} $^{\text{Carica da modello}}$ consente di caricare il modello salvato in un’altra sessione.

Il pulsante \includegraphics[width=1.5em]{mActionComposerManager.png} $^{\text{Gestore di stampe}}$ nel menu \emph{File} permette di aggiungere un nuovo modello di stampa e di gestire i modelli esistenti.
\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{Plugin di QGIS}
\label{docs/user_manual/plugins/plugins_index::doc}\label{docs/user_manual/plugins/plugins_index:plugins}
\index{plugins}

\section{Plugin di 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 è stato progettato con un’architettura estensibile tramite plugin. Ciò permette di aggiungere nuove caratteristiche e funzioni all’applicazione. Molte delle caratteristiche in QGIS sono in effetti implementate come plugin di base \textbf{Core} o \textbf{Esterni}.

\index{plugins!types}\begin{itemize}
\item {} 
I \textbf{Plugin Core} sono mantenuti dal team di sviluppo di QGIS e fanno automaticamente parte di ogni distribuzione QGIS. Sono scritti in uno dei due seguenti linguaggi: C++ o Python. Ulteriori informazioni riguardanti i plugin core sono disponibili nella sezione {\hyperref[docs/user_manual/plugins/core_plugins:core-plugins]{\emph{Uso dei plugin di base di QGIS}}}

\item {} 
\textbf{Plugin Esterni} sono scritti in Python. Sono memorizzati in archivi esterni e mantenuti dai singoli autori. Possono essere aggiunti a QGIS usando \emph{l'Installatore di plugin Python}. Ulteriori informazioni riguardanti i plugin esterni sono disponibili nella sezione {\hyperref[docs/user_manual/plugins/plugins:load-external-plugin]{\emph{Caricamento di un plugin esterno}}}.

\end{itemize}


\subsection{Gestione dei plugin}
\label{docs/user_manual/plugins/plugins:id1}\label{docs/user_manual/plugins/plugins:managing-plugins}
La gestione dei plugin consiste nella loro abilitazione o disabilitazione usando il \emph{Gestore plugin}. I plugin esterni devono prima essere installati usando \emph{l'Installatore di plugin Python}. Per attivare/disattivare i plugin esterni, una volta installati, si usa \emph{Gestore plugin}.


\subsubsection{Abilitare un Plugin Core}
\label{docs/user_manual/plugins/plugins:loading-a-qgis-core-plugin}\label{docs/user_manual/plugins/plugins:load-core-plugin}
L’abilitazione di un Plugin Core si ottiene dal menu principale \emph{Plugins \(\rightarrow\) Gestione plugins}

\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}

The \emph{Plugin Manager} lists all the available plugins and their status
(loaded or unloaded), including all core plugins and all external plugins that
have been installed and automatically activated using the \emph{Python Plugin
Installer} (see Section {\hyperref[docs/user_manual/plugins/plugins:load-external-plugin]{\emph{Caricamento di un plugin esterno}}}). Those plugins that are
already loaded have a check mark to the left of their name. {\hyperref[docs/user_manual/plugins/plugins:figure-plugins-1]{Figure\_plugins\_1}}
shows the \emph{Plugin Manager} dialog.

Per abilitare un plugin cliccare sulla casella di controllo e cliccare su \textbf{{[}OK{]}}. Lo stato dei plugin, attivo/disattivo, viene memorizzato quanto si termina una sessione di QGIS, in modo tale che al successivo riavvio, i plugin vengano automaticamente caricati.

\index{crashes}
\begin{notice}{tip}{Suggerimento:}
\textbf{Blocco dei plugin}

Se QGIS si blocca all’avvio, la colpa potrebbe essere di un plugin. È possibile disabilitare il caricamento dei plugin modificando il file delle impostazioni (sezione {\hyperref[docs/user_manual/introduction/qgis_configuration:gui-options]{\emph{Opzioni dell’interfaccia grafica (GUI)}}}). Una volta individuate le impostazioni dei plugin, bisogna impostare il valore di ognuno su \code{false} in modo da impedirne il caricamento.

\includegraphics[width=1em]{nix.png} Per esempio per disabilitare il plugin Testo delimitato, la modifica da effettuare sul file \code{\$HOME/.config/QuantumGIS/qgis.conf} in Linux dovrebbe apparire così: \code{Add Delimited Text Layer=false}.

Eseguire l’operazione per tutti i {[}Plugin{]} della sezione, avviare successivamente QGIS ed aggiungere i plugin uno alla volta tramite il \emph{Gestore plugin} per determinare quale stia causando il problema.
\end{notice}


\subsubsection{Caricamento di un plugin esterno}
\label{docs/user_manual/plugins/plugins:load-external-plugin}\label{docs/user_manual/plugins/plugins:loading-an-external-qgis-plugin}
I plugin Esterni sono scritti in Python e risiedono negli archivi `Ufficiali' di QGIS, oppure in vari archivi esterni mantenuti dai singoli autori. Gli archivi `Ufficiali' di QGIS sono aggiunti in modo predefinito in \emph{Recupero Plugin Python}.

Documentazione dettagliata, versione minima di QGIS richiesta, pagina web, autori ed altro sono disponibili per gli archivi `Ufficiali' di QGIS all'indirizzo \href{http://plugins.qgis.org/plugins/}{http://plugins.qgis.org/plugins/}. Per gli archivi esterni, le informazioni potrebbero essere fornite insieme al plugin stesso. In linea generale non è inclusa in questo manuale.

\begin{notice}{note}{Nota:}
Aggiornamenti dei plugin Core potrebbero essere forniti in archivi esterni.
\end{notice}

\begin{notice}{note}{Nota:}
fTool, Mapserver Export e l’Installatore dei plugin sono plugin Python, ma sono anche parte del codice di QGIS, quindi vengono automaticamente caricati e abilitati nel gestore di plugin (sezione {\hyperref[docs/user_manual/plugins/plugins:load-external-plugin]{\emph{Caricamento di un plugin esterno}}}).
\end{notice}

Attualmente sono disponibili 150 plugin esterni dagli archivi `Ufficiali' di QGIS. Alcuni di questi plugin offrono funzionalità comuni richieste da molti utenti (es. visualizzare e modificare dati Open Street Map o caricare layer di Google Map), mentre altri plugin offrono funzionalità molto specialistiche (es. Calculate economic pipe diameters for water supply networks).

È oltremodo intuitivo cercare plugin esterni tramite parola chiave, scegliere un archivio o impostare un filtro in funzione dello stato dei plugin (installato o non installato). La ricerca e il filtraggio vengono fatti nel gestore dei plugin (Figura {\hyperref[docs/user_manual/plugins/plugins:figure-plugins-2]{figure\_plugins\_2}}).

\begin{notice}{tip}{Suggerimento:}
\textbf{Aggiungere ulteriori archivi}

Per aggiunger un archivio esterno, aprire l'installatore di plugin (\emph{Plugins \(\rightarrow\) Recupero Plugin Python}), andare nella scheda \emph{Repositories}, e cliccare su \textbf{{[}Aggiungi{]}}. Per modificare/eliminare un archivio cliccare rispettivamente sui pulsanti \textbf{{[}Modifica...{]}} e \textbf{{[}Elimina{]}}.
\end{notice}

Per integrare un plugin esterno in QGIS è necessario:
\begin{itemize}
\item {} 
Scaricare il plugin dall’archivio tramite \emph{l'Installatore Plugin Python} (sezione {\hyperref[docs/user_manual/plugins/plugins:python-plugin-installer]{\emph{Uso dell’installatore di Plugin Python}}}): il plugin verrà aggiunto alla lista dei plugin disponibili nel \emph{Gestore Plugin} e caricato automaticamente.

\end{itemize}


\subsubsection{Uso dell’installatore di Plugin Python}
\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}
Per scaricare ed installare un plugin python esterno, cliccare su \emph{Plugins \(\rightarrow\)} \includegraphics[width=1.5em]{plugin_installer.png} \emph{Recupero Plugin Python}: si aprirà la finestra di dialogo \emph{Installatore plugin} (figura {\hyperref[docs/user_manual/plugins/plugins:figure-plugins-2]{figure\_plugins\_2}}) con la scheda \emph{Plugins}, contenente la lista sia di tutti i plugin python disponibili negli archivi remoti sia di quelli installati.
\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}

Ogni plugin può essere:
\begin{itemize}
\item {} 
\textbf{non installato} - significa che il plugin è disponibile nell’archivio remoto, ma non ancora installato. Per installarlo, selezionarlo dalla lista e cliccare su \textbf{{[}Installa plugin{]}}.

\item {} 
\textbf{nuovo} - significa che il plugin è nuovo tra quelli disponibili nell’archivio.

\item {} 
\textbf{installato} - il plugin è installato. Se è anche disponibile in qualsiasi archivio remoto il pulsante
\textbf{{[}Reinstalla plugin{]}} è abilitato. Se la versione disponibile in remoto è più vecchia di quella installata, appare invece il pulsante \textbf{{[}Downgrade plugin{]}}.

\item {} 
\textbf{aggiornabile} - il plugin è installato, ma è disponibile in una versione più recente. I pulsanti \textbf{{[}Aggiorna plugin{]}} e \textbf{{[}Aggiorna tutti{]}} sono abilitato.

\item {} 
\textbf{non valido} - il plugin è installato, ma è inutilizzabile. La ragione è spiegata nella descrizione del plugin.

\end{itemize}

\textbf{Scheda plugin}

Per installare un plugin, selezionarlo dalla lista e cliccare su \textbf{{[}Installa plugin{]}}. Il plugin è attivato ed installato nella sua propria directory.
\begin{itemize}
\item {} 
\includegraphics[width=1em]{nix.png} Linux ed altri 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}

Se l’installazione va a buon fine, compare un messaggio di conferma.

Se l’installazione fallisce ne viene indicata la ragione. I problemi più frequenti sono correlati a errori di connessione e/o moduli Python mancanti. Nel primo caso basta attendere e riprovare in un secondo momento, nel secondo è necessario installare nel sistema operativo i moduli Python mancanti. In Linux, i moduli più richiesti dovrebbero essere disponibili nel gestore dei pacchetti.
Per istruzioni sull’installazione in Windows, visitare la pagine web del modulo.

Se si usa un proxy, può essere necessario configurarlo in \emph{Modifica \(\rightarrow\) Opzioni} (Gnome, OSX) o \emph{Impostazioni \(\rightarrow\) Opzioni} (KDE, Windows){}`, scheda \emph{Rete}.

Il pulsante \textbf{{[}Disinstalla{]}} il plugin è abilitato solo se il plugin selezionato è installato e non è un plugin Core. Da notare che se si è installato un aggiornamento di un plugin core, si può sempre disinstallare tale aggiornamento con il pulsante \textbf{{[}Disinstalla{]}} il plugin e ritornare alla versione contenuta nel pacchetto di installazione di Quantum GIS, ma il plugin non può essere disinstallato.

\textbf{Scheda Repository}

La scheda \emph{Repositories}, contiene una lista di archivi di plugin disponibili per l’installazione. Come impostazione predefinita viene usato solamente l’archivio ufficiale di QGIS. Si possono aggiungere archivi messi a disposizione dagli utenti, incluso l’archivio centrale QGIS Contributed Repository ed altri archivi esterni, usando il pulsante \textbf{{[}Aggiungi...{]}} . Questi archivi contengono un gran numero di plugin non mantenuti dal Team di Sviluppo di QGIS, pertanto quest’ultimo non se può assumere la responsabilità. Si può anche gestire la lista dei plugin manualmente, cioè aggiungere, rimuovere o editare le singole voci. È possibile disabilitare temporaneamente un particolare archivio usando il pulsante \textbf{{[}Modifica...{]}}.

\textbf{Scheda Opzioni}

Nella scheda \emph{Opzioni} si possono configurare le impostazioni dell' \emph{Installatore di plugin}. La casella di controllo \includegraphics{checkbox.png} \emph{Controlla aggiornamenti all'avvio} indica a QGIS di cercare automaticamente aggiornamenti di plugin e novità. Se questa opzione è abilitata, tutti i repository elencati e abilitati nella scheda \emph{Repositories} vengono controllati ogni volta che il programma viene avviato. È possibile modificare la frequenza di controllo degli aggiornamenti usando il menu a cascata: sono disponibili le opzioni una volta al giorno e una volt al mese. Se è disponibile un nuovo plugin o un aggiornamento di quelli installati, compare una notifica nella barra di stato. Se la casella di controllo non è attivata, la ricerca di aggiornamenti e novità avviene solo quando viene lanciato \emph{l'Installatore di plugin}.

Sebbene l’installatore di plugin sia in grado di gestire porte diverse dalla 80, alcune connessioni internet possono causare degli errori nel tentativo di controllare automaticamente gli aggiornamenti. In questo caso, può esser visibile durante l’intera sessione di QGIS un indicatore \emph{Looking for new plugins...} nella barra di stato che può causare il blocco del programma alla chiusura. Per aggirare il problema, disattivare gli aggiornamenti automatici.

Inoltre, è possibile specificare il tipo di plugin da elencare nell' \emph{Installatore di plugin}. Sotto \emph{Plugin disponibili}, si può specificare:
\begin{itemize}
\item {} 
\includegraphics{radiobuttonon.png} \emph{Mostra solo i plugin provenienti da repository ufficiali}

\item {} 
\includegraphics{radiobuttonoff.png} \emph{Mostra tutti i plugin esclusi quelli marcati come sperimentali}

\item {} 
\includegraphics{radiobuttonoff.png} \emph{Mostra tutti i plugin, compresi quelli marcati come sperimentali}

\end{itemize}

\begin{notice}{tip}{Suggerimento:}
\textbf{Utilizzo dei plugin sperimentali}

I plugin sperimentali non sono generalmente adatti al lavoro produttivo. Questi plugin sono in fase prematura di sviluppo e sono da considerare `incompleti' o quali `idee concettuali'. Il team di sviluppo di QGIS sconsiglia l’installazione di questi plugin, a meno che non si intenda usarli per attività di test.
\end{notice}

\index{data providers}

\subsection{Fornitori di dati}
\label{docs/user_manual/plugins/plugins:index-7}\label{docs/user_manual/plugins/plugins:data-providers}
I Fornitori dati sono plugin `speciali' che danno accesso ad un archivio di dati. Di default, QGIS supporta i layer PostGIS e gli archivi di dati su disco supportati dalla libreria GDAL/OGR: un plugin fornitore di dati estende la capacità di QGIS di utilizzare altre fonti di dati.

Tali plugin sono registrati automaticamente all’avvio di QGIS. Non sono gestiti dal gestore di plugin, ma usati dietro le quinte quando un tipo di dati viene aggiunto come layer in QGIS.


\section{Uso dei plugin di base di 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 
Icona
} & \textsf{\relax 
Plugin
} & \textsf{\relax 
Descrizione
} & \textsf{\relax 
Riferimento guida
}\\
\hline
\includegraphics[width=1.5em]{delimited_text.png}
 & 
Aggiungi layer testo delimitato
 & 
Carica e mostra file di testo delimitato che contengono coordinate X e Y
 & 
{\hyperref[docs/user_manual/plugins/plugins_delimited_text:label-dltext]{\emph{Plugin Testo Delimitato}}}
\\

\includegraphics[width=1.5em]{coordinate_capture.png}
 & 
Cattura Coordinate
 & 
Cattura le coordinate del mouse usando un SR diverso
 & 
{\hyperref[docs/user_manual/plugins/plugins_coordinate_capture:coordcapt]{\emph{Plugin Cattura coordinate}}}
\\

\includegraphics[width=1.5em]{dbmanager.png}
 & 
DB Manager
 & 
Gestisce i database con QGIS
 & 
{\hyperref[docs/user_manual/plugins/plugins_db_manager:dbmanager]{\emph{Plugin DB Manager}}}
\\


 & 
Diagramma sovrapposto
 & 
Un plugin che disegna un diagramma sopra un layer vettoriale
 & 
{\hyperref[docs/user_manual/plugins/plugins_diagram_overlay:diagram-overlay]{\emph{Plugin Diagramma sovrapposto}}}
\\

\includegraphics[width=1.5em]{dxf2shp_converter.png}
 & 
Convertitore DXF2Shape
 & 
Converte da dxf a shp
 & 
{\hyperref[docs/user_manual/plugins/plugins_dxf2shape_converter:dxf2shape]{\emph{Plugin Dxf2Shp Converter}}}
\\

\includegraphics[width=1.5em]{event_id.png}
 & 
eVis
 & 
Uno strumento di visualizzazione di eventi. Visualizza immagini associate agli elementi di un vettore
 & 
{\hyperref[docs/user_manual/plugins/plugins_evis:evis]{\emph{Plugin eVis}}}
\\

\includegraphics[width=1.5em]{ftools_logo.png}
 & 
fTools
 & 
Strumenti per l'analisi e la gestione di dati vettoriali
 & 
{\hyperref[docs/user_manual/plugins/plugins_ftools:ftools]{\emph{Plugin fTools}}}
\\

\includegraphics[width=1.5em]{gps_importer.png}
 & 
Strumenti GPS
 & 
Strumenti per caricare e importare dati GPS
 & 
{\hyperref[docs/user_manual/working_with_gps/plugins_gps:plugin-gps]{\emph{Plugin GPS}}}
\\

\includegraphics[width=1.5em]{grasslogo.png}
 & 
GRASS
 & 
Attiva i potenti strumenti di GRASS
 & 
{\hyperref[docs/user_manual/grass_integration/grass_integration:sec-grass]{\emph{Integrazione con GRASS GIS}}}
\\

\includegraphics[width=1.5em]{raster-info.png}
 & 
Strumenti GDAL
 & 
Strumenti raster: interfaccia grafica semplificata per l’utilizzo dei programmi GDAL più comuni
 & 
{\hyperref[docs/user_manual/plugins/plugins_gdaltools:label-plugingdaltools]{\emph{Plugin GDALTools}}}
\\

\includegraphics[width=1.5em]{georeferencer.png}
 & 
Georeferenziatore raster (GDAL)
 & 
Georeferenzia raster tramite GDAL
 & 
{\hyperref[docs/user_manual/plugins/plugins_georeferencer:georef]{\emph{Plugin Georeferenziatore}}}
\\

\includegraphics[width=1.5em]{heatmap.png}
 & 
Mappa di concentrazione
 & 
Crea una mappa raster di concentrazione a partire da un vettore di punti
 & 
{\hyperref[docs/user_manual/plugins/plugins_heatmap:heatmap-plugin]{\emph{Plugin Mappa di concentrazione}}}
\\

\includegraphics[width=1.5em]{interpolation.png}
 & 
Plugin di interpolazione
 & 
Un plugin per l’interpolazione basata sui vertici di un vettore
 & 
{\hyperref[docs/user_manual/plugins/plugins_interpolation:interpol]{\emph{Plugin Interpolazione}}}
\\

\includegraphics{mapserver_export.png}
 & 
Plugin MapServer Export
 & 
Esporta un progetto QGIS in un file mappa MapServer
 & 
{\hyperref[docs/user_manual/plugins/plugins_mapserver_export:mapserver-export]{\emph{Plugin MapServer Export}}}
\\

\includegraphics[width=1.5em]{offline_editing_copy.png}
 & 
Offline Editing
 & 
Consente l’editing offline e la sincronizzazione con il database
 & 
{\hyperref[docs/user_manual/plugins/plugins_offline_editing:offlinedit]{\emph{Plugin Offline Editing}}}
\\

\includegraphics[width=1.5em]{osm_load.png}
 & 
OpenStreetMap
 & 
Visualizza e modifica dati OpenStreetMap
 & 
{\hyperref[docs/user_manual/osm/openstreetmap:plugins-osm]{\emph{OpenStreetMap}}}
\\

\includegraphics[width=1.5em]{oracle_raster.png}
 & 
Oracle Spatial Georaster
 & 
Accede a Oracle Spatial GeoRasters
 & 
{\hyperref[docs/user_manual/plugins/plugins_oracle_raster:oracle-raster]{\emph{Plugin Oracle Spatial GeoRaster}}}
\\

\includegraphics[width=1.5em]{plugin_installer.png}
 & 
Installatore di plugin
 & 
Scarica ed installa i plugin python di QGIS
 & 
{\hyperref[docs/user_manual/plugins/plugins:python-plugin-installer]{\emph{Uso dell’installatore di Plugin Python}}}
\\

\includegraphics[width=1.5em]{raster_terrain.png}
 & 
Plugin per l’analisi geomorfologica
 & 
Un plugin per l’analisi geomorfologica basata su raster
 & 
{\hyperref[docs/user_manual/plugins/plugins_raster_terrain:rasterrain]{\emph{Plugin Analisi geomorfologica}}}
\\


 & 
Plugin grafo strade
 & 
Trova il percorso più breve
 & 
{\hyperref[docs/user_manual/plugins/plugins_road_graph:roadgraph]{\emph{Plugin grafo strade}}}
\\

\includegraphics{spiticon.png}
 & 
SPIT
 & 
Shapefile PostGIS Import Tool: strumento per importare shapefile in PostGIS
 & 
{\hyperref[docs/user_manual/working_with_vector/supported_data:loading-postgis-data]{\emph{Importare dati in PostgreSQL}}}
\\

\includegraphics[width=1.5em]{sqlanywhere.png}
 & 
Plugin SQL Anywhere
 & 
Salva vettori in un database SQL anywhere
 & 
{\hyperref[docs/user_manual/plugins/plugins_sql_anywhere:sqlanywhere]{\emph{Plugin SQL Anywhere}}}
\\

\includegraphics[width=1.5em]{spatialquery.png}
 & 
Plugin di interrogazione spaziale
 & 
Un plugin per effettuare interrogazioni spaziali su dati vettoriali
 & 
{\hyperref[docs/user_manual/plugins/plugins_spatial_query:spatial-query]{\emph{Plugin Spatial Query}}}
\\

\includegraphics[width=1.5em]{raster-stats.png}
 & 
Statistiche zonali
 & 
Calcola statistiche raster per ogni poligono di un vettore
 & 
{\hyperref[docs/user_manual/plugins/plugins_zonal_statistics:zonal-statistics]{\emph{Plugin Statistica zonale}}}
\\
\hline\end{tabulary}



\section{Plugin Cattura coordinate}
\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}
Il plugin Cattura Coordinate permette di mostrare sulla mappa coordinate in due sistemi di riferimento distinti.
\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 {} 
Avviare QGIS, aprire le proprietà del progetto \includegraphics[width=1em]{mActionOptions.png} \emph{Proprietà progetto} nel menu \emph{Impostazioni} (KDE, Windows) o \emph{File} (Gnome, OSX) e scegliere la scheda \emph{Sistema di riferimento (SR)}. In alternativa, cliccare sull'icona \includegraphics[width=1.5em]{mIconProjectionEnabled.png} $^{\text{Stato SR}}$ nell'angolo in basso a destra della barra di stato.

\item {} 
Attivare \includegraphics{checkbox.png} \emph{Abilita la riproiezione al volo} e selezionare un sistema di coordinate proiettate a scelta (sezione {\hyperref[docs/user_manual/working_with_projections/working_with_projections:label-projections]{\emph{Lavorare con le proiezioni}}}).

\item {} 
Attivare il plugin Cattura Coordinate nel nel Gestore dei plugins (sezione {\hyperref[docs/user_manual/plugins/plugins:load-core-plugin]{\emph{Abilitare un Plugin Core}}}) ed assicurarsi che il dialogo sia visibile verificando che \includegraphics{checkbox.png} \emph{Cattura coordinate}, in \emph{Visualizza \(\rightarrow\) Pannelli}, sia selezionato. La finestra di dialogo Cattura Coordinate è mostrata in figura {\hyperref[docs/user_manual/plugins/plugins_coordinate_capture:figure-coordinate-capture-1]{figure\_coordinate\_capture\_1}}.

\item {} 
Cliccare su \includegraphics{geographic.png} $^{\text{Clicca per selezionare il SR da usare durante la visualizzazione delle coordinate}}$ e selezionare un SR diverso da quello selezionato precedentemente.

\item {} 
Cliccare su \textbf{{[}Start capture{]}} per iniziare la cattura delle coordinate. Cliccare un punto nella mappa e il plugin mostrerà le coordinate espresse nei due SR selezionati.

\item {} 
Per abilitare la tracciatura via mouse delle coordinate selezionate l'icona \includegraphics[width=1.5em]{tracking.png} $^{\text{Clicca per abilitare la tracciatura mouse...}}$.

\item {} 
Le coordinate selezionate possono essere copiate negli appunti.

\end{enumerate}


\section{Plugin 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}
Il plugin DB Manager fa parte dei plugin core di QGIS e in futuro prenderà il posto dei plugin SPIT e PostGIS Manager, inoltre integra tutti i formati database supportati da QGIS in un'unica interfaccia grafica. Il plugin \includegraphics[width=1.5em]{dbmanager.png} $^{\text{DB Manager}}$ ha diverse caratteristiche. E' possibile trascinare i layer da QGIS Browser direttamente in DB Manager e questo importerà i layer nel database spaziale. Si possono spostare tabelle fra diversi database spaziali che in seguito verranno importate. Si può usare DB Manager per lanciare interrogazioni SQL e aggiungere i risultati in QGIS come layer di interrogazioni.
\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}

Il menu \emph{Database} permette di collegarsi a un database esistente, di lanciare la finestra SQL e di uscire dal plugin DB Manager. Il menu \emph{Schema} include strumenti per creare o eliminare schemi (vuoti) e, se la topologia è disponibile (es. PostGIS 2), di iniziare una \emph{Vista topologica}.Il menu \emph{Table} permette di creare, modificare ed eliminare tabelle e viste. Inoltre è anche possibile svuotare tabelle e muoverle verso un altro schema. Infine si può lanciare una ``Vacuum Analyze'' e aggiungere una ``Versioning Support'' a una tabella.

La finestra \emph{Tree} elenca tutti i database supportati da QGIS. E' possibile collegarsi al database con un doppio click. Con il tasto destro del mouse si possono rinominare ed eliminare schemi e tabelle esistenti. Le tabelle possono essere aggiunte in QGIS anche dal menu contestuale.

Se si è connessi a un database, compaiono tre schede nella finestra \textbf{principale} di DB Manager. La scehda \emph{Info} fornisce informazioni sulla tabella e sulle geometrie. Permette inoltre di effettuare una ``Vacuum Analyze'' e di creare un indice spaziale, se non è presente, pe la tabella selezionata. La scheda \emph{Table} mostra tutti gli attributi e con la scheda \emph{Preview} si può vedere un'anteprima della geometria.


\section{Plugin Testo Delimitato}
\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}
Il plugin permette di caricare un file di testo delimitato come layer in QGIS.


\subsection{Requisiti}
\label{docs/user_manual/plugins/plugins_delimited_text:requirements}
Per visualizzare un file di testo delimitato come layer, il testo deve contenere:
\begin{enumerate}
\item {} 
Una riga di intestazione per i nomi dei campi. Questa deve essere la prima riga del file di testo.

\item {} 
La riga di intestazione deve contenere un campo X ed uno Y. Questi campi possono avere qualsiasi nome.

\item {} 
Le coordinate x e y devono essere specificate come numeri. Il sistema di coordinate non è importante.

\end{enumerate}

Come esempio di un file di testo valido importiamo il file di punti quotati \code{elevp.csv} presente nel dataset campione di QGIS (sezione {\hyperref[docs/user_manual/introduction/getting_started:label-sampledata]{\emph{Dati campione}}}):

\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}

Alcune note circa il file di testo:
\begin{enumerate}
\item {} 
Il file di testo usato come esempio usa \code{;} (punto e virgola) come delimitatore. Qualsiasi carattere può essere usato per delimitare i campi.

\item {} 
La prima riga è la riga intestazione. Essa contiene i campi \code{X}, \code{Y} e \code{ELEV}.

\item {} 
Nessun tipo di virgoletta (\code{"}) dev’essere usata per delimitare i campi di testo.

\item {} 
Le coordinate x sono contenuto nel campo \code{X}.

\item {} 
Le coordinate y sono contenuto nel campo \code{Y}.

\end{enumerate}


\subsection{Utilizzo del plugin}
\label{docs/user_manual/plugins/plugins_delimited_text:using-the-plugin}
Attivare il plugin come descritto nella sezione {\hyperref[docs/user_manual/plugins/plugins:managing-plugins]{\emph{Gestione dei plugin}}}.

Cliccare sulla nuova icona della barra dei plugin \includegraphics[width=1.5em]{delimited_text.png} $^{\text{Aggiungi layer di testo delimitato}}$ per aprire la finestra di dialogo \emph{Delimited Text}, mostrata in figura {\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}

Selezionare il file \code{qgis\_sample\_data/csv/elevp.csv} da importare cliccando su \textbf{{[}Sfoglia{]}}. Una volta caricato il file, il plugin cerca di processarlo usando l'ultimo delimitatore utilizzato, in questo caso un punto e virgola (\code{;}). È fondamentale selezionare il giusto delimitatore. Per cambiare delimitatore usare \code{\textbackslash{}t} (questa è un’espressione per il carattere tab).

Selezionare i campi \code{X} e \code{Y} dai menu a tendina ed il campo WKT per le informazioni sul sistema di riferimento (se disponibile). Assegnare un nome al layer (es. \code{elevp}) ed aggiungere il layer alla vista mappa cliccando su \textbf{{[}OK{]}} (figura {\hyperref[docs/user_manual/plugins/plugins_delimited_text:figure-delimited-text-1]{figure\_delimited\_text\_1}}).


\section{Plugin Diagramma sovrapposto}
\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} Il plugin \emph{Diagramma sovrapposto} permette di sovrapporre un grafico su un file vettoriale (figura {\hyperref[docs/user_manual/plugins/plugins_diagram_overlay:figure-overlay-1]{figure\_overlay\_1}}). Il plugin fornisce caratteristiche non ancora implementate nella scheda \emph{Diagrammi}, descritta nella sezione {\hyperref[docs/user_manual/working_with_vector/vector_properties:sec-diagram]{\emph{Scheda Diagrammi}}}.

Il plugin \emph{Diagramma sovrapposto} deve essere attivato dal Gestore plugin (vedi {\hyperref[docs/user_manual/plugins/plugins:load-core-plugin]{\emph{Abilitare un Plugin Core}}}) prima di poter essere utilizzato. Comparirà quindi come scheda \emph{Overlay} nella finestra di dialogo \emph{Proprietà layer} vicino all'altra scheda \emph{Diagrammi}.
\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}

La scheda \emph{Overlay} supporta grafici a torta, istogrammi e simboli SVG.

In modo simile alla scheda \emph{Diagrammi} è riportato un esempio in cui il layer alaska viene sovrapposto con un diagramma a torta di dati climatici provenienti da un altro layer vettoriale. Entrambi i layer provengono dal dataset di esempio di QGIS (sezione {\hyperref[docs/user_manual/introduction/getting_started:label-sampledata]{\emph{Dati campione}}}).
\begin{enumerate}
\item {} 
Per prima cosa cliccare su \includegraphics[width=1.5em]{mActionAddOgrLayer.png} $^{\text{Aggiungi vettore}}$ e caricare i due file \code{alaska.shp} e \code{climate.shp} dal dataset di QGIS.

\item {} 
Aprire la finestra di dialogo \emph{Proprietà layer} facendo doppio click su layer \code{climate}.

\item {} 
Cliccare sulla scheda \emph{Overlay}, attivare \includegraphics{checkbox.png} \emph{Visualizza diagrammi} e scegliere `Grafico a torta' dalla combo-box \emph{Tipo di diagramma} \includegraphics{selectstring.png}.

\item {} 
I dati si riferiscono alle tre colonne \code{T\_F\_JAN}, \code{T\_F\_JUL} e \code{T\_F\_MEAN}. Selezionare come attributo \code{T\_F\_JAN} e cliccare sul pulsante \textbf{{[}Aggiungi{]}} poi effetuare la stessa procedura con \code{T\_F\_JUL} e \code{T\_F\_MEAN}.

\item {} 
La dimensione del diagramma è basata sulla scala di classificazione degli attributi. Scegliere \code{T\_F\_JUL}, cliccare su \textbf{{[}Trova valore massimo{]}} e impostare \code{20}. Scegliere `millimetri' da \emph{Unità della dimensione} \includegraphics{selectstring.png}.

\item {} 
Cliccare su \textbf{{[}Applica{]}} per vedere i diagrammi nella finestra principale di QGIS.

\item {} 
E' possibile adattare la grandezza del diagramma oppure cambiar il colore facendo doppio click sulla barra del colore. un esempio è data dalla figura {\hyperref[docs/user_manual/plugins/plugins_diagram_overlay:figure-overlay-2]{Figure\_overlay\_2}}.

\item {} 
Cliccare su \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}

Si può scegliere l'algoritmo di posizionamento del diagramma dalla scheda \code{Overlay} nel menu \emph{Impostazioni \(\rightarrow\) Opzioni}. Il metodo `Punto centrale' è un metodo generico, se ne possono scegliere altri della libreria PAL. Questi ultimi tengono in considerazione gli oggetti del diagramma e le etichette dei diversi layers.


\section{Plugin Dxf2Shp Converter}
\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}
Il plugin dxf2shape permette di convertire dati vettoriali dal formato DXF al formato shapefile. Vanno impostati i seguenti parametri:
\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{File DXF in Input}: il percorso del file DXF da convertire

\item {} 
\textbf{File di output}: il nome dello shapefile in output

\item {} 
\textbf{Tipo di file in output}: il tipo di file in output (scelta tra polilinea, poligono o punto).

\item {} 
\textbf{Esporta le etichette di testo}: se selezionata, viene creato uno shapefile di punti. La tabella dbf associata conterrà informazioni circa i campi ``TESTO'' trovati nel file dxf e le stringhe di testo stesse.

\end{itemize}


\subsection{Utilizzo del plugin}
\label{docs/user_manual/plugins/plugins_dxf2shape_converter:using-the-plugin}\begin{enumerate}
\item {} 
Avviare QGIS, attivare il plugin Dxf2Shape dal gestore dei plugin (sezione {\hyperref[docs/user_manual/plugins/plugins:load-core-plugin]{\emph{Abilitare un Plugin Core}}}) e cliccare sull'icona \includegraphics[width=1.5em]{dxf2shp_converter.png} $^{\text{Convertitore Dxf2Shape}}$ che compare nella barra dei plugin. La finestra di dialogo del plugin Dxf2Shape appare come mostrato in figura {\hyperref[docs/user_manual/plugins/plugins_dxf2shape_converter:figure-dxf2shape-1]{Figure\_dxf2shape\_1}}.

\item {} 
Caricare il file DXF da convertire, inserire un nome per lo shapefile in output ed il tipo.

\item {} 
Abilitare la casella di controllo \includegraphics{checkbox.png} \emph{Esporta le etichetto di testo} , se si vuole creare un layer addizionale di punti con le etichette.

\item {} 
Cliccare su \textbf{{[}OK{]}}.

\end{enumerate}


\section{Plugin 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}
Il plugin eVis è stato sviluppato dalla ’Biodiversity Informatics Facility’ del ’American Museum of Natural History’s (AMNH) Center for Biodiversity and Conservation (CBC) (questa sezione è derivata da Horning, N., K. Koy, P. Ersts. 2009. eVis (v1.1.0) User’s Guide. American Museum of Natural History,Center for Biodiversity and Conservation. Disponibile all pagina web \href{http://biodiversityinformatics.amnh.org/}{http://biodiversityinformatics.amnh.org/}, rilasciato con licenza GNU FDL). Il plugin permette di collgare fotografie geocodificate (ovvero provviste di informazioni su latitudine e longitudine) e altri documenti con i dati vettoriali in QGIS.

Nella nuova versione di QGIS, eVis è installato automaticamente; come tutti gli altri plugin può essere abilitato/disabilitato tramite il gestore dei plugin (sezione {\hyperref[docs/user_manual/plugins/plugins:managing-plugins]{\emph{Gestione dei plugin}}}).

Il plugin consta di tre moduli, Connessione Database, ID evento, Browser evento che permettono di collegare a vettori in QGIS foto ed altri documenti geocodificati (es. con coordinate X,Y o lat/long).


\subsection{Browser evento}
\label{docs/user_manual/plugins/plugins_evis:evis-browser}\label{docs/user_manual/plugins/plugins_evis:event-browser}
Il modulo mette a disposizione le funzionalità per visualizzare foto geocodificate collegate ad elementi vettoriali della vista mappa di QGIS, come un layer di punti creati direttamente in QGIS o il risultato di una query. Gli elementi vettoriali devono avere associati attributi che ne descrivono la localizzazione ed il nome del file contenente le foto: opzionalmente l’orientamento della macchina fotografica. Il layer vettoriale deve essere caricato in QGIS prima di poter usare il Browser evento.


\subsubsection{Aprire il modulo Browser evento}
\label{docs/user_manual/plugins/plugins_evis:launch-the-event-browser-module}\label{docs/user_manual/plugins/plugins_evis:evis-launch-browser}
Per aprire la finestra di dialogo del modulo, cliccare sul pulsante \includegraphics[width=1.5em]{event_browser.png} $^{\text{Sfoglia evento eVis}}$ oppure \emph{Database \(\rightarrow\) eVis \(\rightarrow\) Sfoglia evento eVis}. Si aprirà una finestra generica \emph{Browser evento}.

Sono presenti tre schede nella parte alta della finestra \emph{Browser evento}. La scheda \emph{Visualizza} serve a visualizzare le foto ed i relativi attributi. La scheda \emph{Opzioni} contiene una serie di impostazioni del plugin. La scheda \emph{Configura applicazioni esterne} serve a gestire una tabella di estensioni di file ed applicazioni associate per permettere ad eVis di visualizzare documenti ed altre immagini.


\subsubsection{Scheda Visualizza}
\label{docs/user_manual/plugins/plugins_evis:evis-display-window}\label{docs/user_manual/plugins/plugins_evis:understanding-the-display-window}
La scheda \emph{Visualizza} è usata per visualizzare le foto ed i relativi attributi.
\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{Area di visualizzazione dell’immagine}: è il riquadro inferiore della scheda.

\item {} 
\textbf{Ingrandisci}: ingrandisce l’immagine per avere più dettagli. Se l’immagine è troppo grande per l’area di visualizzazione, compaiono delle barre di scorrimento.

\item {} 
\textbf{Rimpicciolisci}: rimpicciolisce l’immagine.

\item {} 
\textbf{Zoom completo}: visualizza tutta l'immagine.

\item {} 
\textbf{Finestra degli attributi}: è il riquadro superiore della finestra. Qui sono mostrate le informazioni del punto associato alla foto che si sta visualizzando. Se il file associato al punto non è un’immagine ed il tipo di file è definito nella scheda \emph{Configura applicazioni esterne}, facendo doppio-click sul suo percorso viene avviata l’applicazione adatta a gestire quel tipo di file. Se l'estensione del file è riconosciuta, l'attributo sarà mostrato in verde.

\item {} 
\textbf{Pulsanti per la navigazione}: usare i pulsanti Precedente all’altro.

\item {} 
\textbf{Indicatore elemento}: l’intestazione indica quale elemento è visualizzato ed il numero di elementi disponibili.

\end{enumerate}


\subsubsection{Scheda Opzioni}
\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 {} 
Percorso file: menu a tendina che permette di selezionare l’attributo contenente il percorso o l’URL della foto o altro documento da visualizzare. In caso di percorso relativo, attivare la casella di controllo \includegraphics{checkbox.png} \emph{Il percorso è relativo}: il percorso di base del percorso relativo può essere indicato nella casella di testo ’Percorso base’. Informazioni di dettaglio sulle diverse opzioni per specificare la localizzazione di un file sono disponibili nella sezione {\hyperref[docs/user_manual/plugins/plugins_evis:evis-specifying]{\emph{Specificare la localizzazione ed il nome di una foto}}}.

\item {} 
\textbf{Informazioni bussola}: menu a tendina che permette di selezionare l’attributo contenente l’orientamento della macchina fotografica.

\item {} 
\textbf{Offset bussola}: può essere usato per compensare la declinazione. Attivare \includegraphics{radiobuttonon.png} \emph{Manuale} per inserire i valori di offset nella casella di testo oppure attivare \includegraphics{radiobuttonon.png} \emph{Da Attributo} per selezionare l’attributo contenente i valori di offset. La declinazione est deve essere inserita usando valori positivi: in valori negativi, invece, la declinazione ovest.

\item {} 
\textbf{Percorso base}: il percorso di base utilizzato dal percorso relativo definito in Figura {\hyperref[docs/user_manual/plugins/plugins_evis:figure-evis-2]{Figure\_eVis\_2}} (A).

\item {} 
\textbf{Sostituisci percorso}: se attivo, soltanto il nome del file in A sarà aggiunto al percorso di base.

\item {} 
\textbf{Applica il percorso dell’immagine} se attivo, le stesse regole di percorso definito per le foto saranno applicate a documenti tipo video, testo, audio.

\item {} 
\textbf{Ricorda questa impostazione}: se attivo, i valori associati saranno salvati per la sessione successiva quando la finestra verrà chiusa o quando verrà premuto il pulsante \textbf{{[}Salva{]}}.

\item {} 
\textbf{Ripristina}: reimposta il campo al valore predefinito.

\item {} 
\textbf{Restore defaults}: riporta tutti i campi alle impostazioni predefinite.

\item {} 
\textbf{Salva}: salva le impostazioni senza chiudere la scheda \emph{Opzioni}.

\end{enumerate}


\subsubsection{Configura applicazioni esterne}
\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{Tabella riferimento file}: una tabella contenente i vari tipi di file utilizzati da eVis. Ogni tipo file necessita di un’estensione e di un percorso all’applicazione in grado di gestirlo. Ciò permette di aprire diversi tipi di file come filmati, suoni e documenti testuali, oltre che solo immagini.

\item {} 
\textbf{Aggiungi nuovo tipo file}: aggiunge un nuovo tipo di file (estensione ed applicazione).

\item {} 
\textbf{Elimina riga corrente}: elimina il tipo di file selezionato in tabella.

\end{enumerate}


\subsection{Specificare la localizzazione ed il nome di una foto}
\label{docs/user_manual/plugins/plugins_evis:evis-specifying}\label{docs/user_manual/plugins/plugins_evis:specifying-the-location-and-name-of-a-photograph}
La localizzazione ed il nome di una foto possono essere memorizzati tramite un percorso relativo o assoluto o tramite un URL se la foto risiede su un server web: seguono degli esempi dei vari approcci (Tabella {\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{Specificare la localizzazione ed il nome di altri documenti}
\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}
Altri documenti come testo, video e audio possono essere visualizzati e gestiti da eVis, basta assicurarsi di aver impostato per ogni tipo di file estensione e applicazione nella scheda  \emph{Configura applicazioni esterne} della finestra di dialogo \emph{Browser evento}; è, inoltre, necessario disporre del percorso o URL del file nella tabella attributi di un layer vettoriale. Come regola addizionale, se l’URL non contiene l’estensione del tipo file, è possibile anteporre l’estensione all’URL secondo il formato \code{estensione:URL}. L’URL è preceduto dall’estensione file e dal segno : (due punti) (Tabella {\hyperref[docs/user_manual/plugins/plugins_evis:evis-examples]{evis\_examples}}).


\subsection{Utilizzo del Browser evento}
\label{docs/user_manual/plugins/plugins_evis:using-the-generic-event-browser}\label{docs/user_manual/plugins/plugins_evis:evis-using-browser}
Se tutto è correttamente impostato, lanciando il \emph{Browser evento} verrà visualizzata una foto. Se la foto non appare è necessario aggiustare qualche parametro nella finestra \emph{Opzioni}.

Se nella tabella attributi si fa riferimento ad un documento (o ad un’immagine in un formato non supportato da eVis) ed il tipo di file è stato configurato nella scheda \emph{Configura applicazioni esterne}, il campo contente il percorso al file è evidenziato in verde: per aprire il documento, fare doppio-click sul testo evidenziato in verde. Se un documento è configurato nella tabella degli attributi, ma il testo non appare evidenziato in verde, è necessario aggiustare il nome del file nella scheda \emph{Configura applicazioni esterne}. Se invece l'evidenziatura è presente, ma facendo doppio click il file non si apre, allora è necessario aggiustare qualche parametro nella scheda \emph{Opzioni}.

Se non si è specificato l'orientamento della fotocamera, nella scheda \emph{Opzioni} compare un asterisco rosso sul vettore associato alla fotografia. Se l'orientamento è specificato, allora comparirà una freccia che punterà nella direzione indicata dal valore della bussola. La freccia sarà centrata sul punto associato con la fotografia o con altri documenti.

Pe chiudere la finestra \emph{Browser evento} cliccare sul pulsante \textbf{{[}Chiudi{]}} presente nella scheda \emph{Visualizza}.


\subsection{Strumento ID evento}
\label{docs/user_manual/plugins/plugins_evis:evis-id-tool}\label{docs/user_manual/plugins/plugins_evis:event-id-tool}
Il modulo ’ID evento’ permette di visualizzare una foto cliccando su un elemento nella vista mappa di QGIS. L’elemento vettoriale deve avere associati gli attributi contenenti la localizzazione ed il nome del file della foto: il layer deve essere caricato in QGIS prima di aprire il modulo.


\subsubsection{Aprire ID Evento}
\label{docs/user_manual/plugins/plugins_evis:launch-the-event-id-module}\label{docs/user_manual/plugins/plugins_evis:evis-launch-id}
Per aprire il modulo cliccare su \includegraphics[width=1.5em]{event_id.png} $^{\text{Strumento ID evento}}$ oppure \emph{Plugins \(\rightarrow\) eVis \(\rightarrow\) Strumneto ID evento}: sul cursore del mouse apparirà una `i', ad indicare che lo strumento è attivo.

Per visualizzare le foto associate agli elementi vettoriali presenti nella vista mappa di QGIS, cliccare su un elemento di interesse; la foto verrà mostrata nel ’Browser evento’. Nel caso fossero disponibili più foto per lo stesso punto, è comunque possibile scorrerle tutte tramite i pulsanti \textbf{{[}Precedente{]}} e \textbf{{[}Avanti{]}}. Altre opzioni di controllo sono presenti nella sezione ref:\emph{evis\_browser}.


\subsection{Connessione database eVis}
\label{docs/user_manual/plugins/plugins_evis:database-connection}\label{docs/user_manual/plugins/plugins_evis:evis-database}
Il modulo Connessione Database permette di connettersi ed interrogare un database o altre risorse ODBC, es. un foglio di calcolo.

eVis può connettersi direttamente a quattro tipi di database: Microsoft Access, PostgreSQL, MySQL, SQLITE. Può leggere dati da connessioni ODBC (es. una tabella Excel): in tal caso è necessario configurare il driver ODBC per il sistema operativo in uso.


\subsubsection{Aprire Connessione Database}
\label{docs/user_manual/plugins/plugins_evis:launch-the-database-connection-module}\label{docs/user_manual/plugins/plugins_evis:evis-launch-database}
Per aprire il modulo cliccare su \includegraphics[width=1.5em]{evis_connect.png} $^{\text{Connessione database eVis}}$ oppure \emph{Plugins \(\rightarrow\) eVis \(\rightarrow\) Connessione database eVis}. La finestra di dialogo \emph{Connessione Database} presenta tre schede: \emph{Query predefinite}, \emph{Connessione Database} e \emph{Query SQL}. La \emph{Console di Output} mostra lo stato di un'azione avviata da altra sezioni del modulo.


\subsubsection{Connessione Database}
\label{docs/user_manual/plugins/plugins_evis:connect-to-a-database}\label{docs/user_manual/plugins/plugins_evis:evis-connect-database}
Aprire la scheda \emph{Connessione Database}, cliccare su \emph{Tipo Database} \includegraphics{selectstring.png} e selezionare il tipo di database al quale ci si vuole collegare. Se necessario, si possono inserire \emph{Username} e \emph{Password}.

Inserire il server del database in \emph{Host Database}: l’opzione non è disponibile per i database “MSAccess”. Se il database si trova sul desktop, allora inserire “localhost”.

Inserire il nome del database in \emph{Nome Database}. In caso di connessione ``ODBC'' è necessario inserire il nome della fonte dati.

Una volta configurati tutti i parametri cliccare su \textbf{{[}Connetti{]}}: la \emph{Console di Output} informa dell’esito dell’operazione, sia positivo che negativo.
\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{Tipo di Database}: per specificare il tipo di database cui connettersi.

\item {} 
\textbf{Host Database}: nome host del database.

\item {} 
\textbf{Porta}: numero della porta di connessione in caso di database MYSQL o PostgreSQL.

\item {} 
\textbf{Nome Database}: nome del database.

\item {} 
\textbf{Connetti}: pulsante di connessione.

\item {} 
\textbf{Console di Output}: finestra dei messaggi sullo stato della connessione.

\item {} 
\textbf{Nome utente}: nome utente in caso di database protetto.

\item {} 
\textbf{Password}: password in caso di database protetto.

\item {} 
\textbf{Query Predefinite}: scheda “Query Predefinite”.

\item {} 
\textbf{Connessione Database}: scheda “Connessione Database”.

\item {} 
\textbf{Query SQL}: scheda “Query SQL”.

\item {} 
\textbf{Help}: mostra la guida in linea.

\item {} 
\textbf{OK}: chiude Connessione Database .

\end{enumerate}


\subsubsection{Eseguire query SQL}
\label{docs/user_manual/plugins/plugins_evis:running-sql-queries}\label{docs/user_manual/plugins/plugins_evis:evis-running-sql}
Le query SQL permettono di estrarre informazioni da un database o da una risorsa ODBC. In eVis il risultato di una query è una layer vettoriale aggiunto alla vista mappa di QGIS. Cliccare su \emph{Query SQL{}`per visualizzare l’interfaccia per le query. Un utile tutorial sulla sintassi SQL è disponibile alla pagina web http://www.w3schools.com/sql. Ad esempio, per estrarre tutti i dati da una tabella Excel: {}`{}`select * from {[}sheet1\${]}{}`} dove \code{sheet1} è il nome del foglio di lavoro.

Per eseguire una query cliccare su \textbf{{[}Esegui Query{]}} : in caso di esito positivo si aprirà la finestra di dialogo \emph{Scegli file Database} altrimenti la \emph{Console di Output} mostrerà un messaggio di errore.

Nella finestra \emph{Scegli file Database} assegnare un nome al nuovo layer che sarà creato dai risultati della query.
\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{Query SQL}: è il riquadro per inserire le query SQL.

\item {} 
\textbf{Esegui Query}: pulsante per mandare in esecuzione una query.

\item {} 
\textbf{Console di Output}: mostra i messaggi relativi all’esecuzione delle query.

\item {} 
\textbf{Help}: mostra la guida in linea.

\item {} 
\textbf{OK}: chiude \emph{Connessione Database}.

\end{enumerate}

Usare \emph{Coordinata X} \includegraphics{selectstring.png} e \emph{Coordinata Y} \includegraphics{selectstring.png} per selezionare i campi del database che contengono le coordinate \code{X} (o longitudine) e \code{Y} (or latitudine). Cliccare su \textbf{{[}OK{]}} per visualizzare il nuovo layer nella vista mappa di QGIS.

Per salvare il nuovo layer è possibile usare il comando QGIS `Salva come...' (click tasto-destro sul nome
del layer in legenda)

\begin{notice}{tip}{Suggerimento:}
\textbf{Creare un layer vettoriale da un foglio di lavoro Microsoft Excel}

Quando si crea un layer vettoriale da un file Excel potrebbero notarsi degli (“0”) non voluti in alcune righe nella tabella degli attributi: la causa è da rilevarsi nell’abitudine di cancellare valori in Excel tramite il tasto \code{Backspace}. Per correggere il problema, bisogna aprire il Excel e usare \emph{Modifica \(\rightarrow\) Elimina} per rimuovere le righe non necessarie dal file. Per evitare il problema si possono semplicemente eliminare le righe dal foglio di lavoro Excel usando \emph{Modifica \(\rightarrow\) Elimina} prima di salvare il file.
\end{notice}


\subsubsection{Eseguire query predefinite}
\label{docs/user_manual/plugins/plugins_evis:running-predefined-queries}\label{docs/user_manual/plugins/plugins_evis:evis-predefined}
Nella scheda \emph{Query Predefinite} è possibile caricare query da file esterni in XML. Questa possibilità è molto utile se non si ha molta dimestichezza con il linguaggio SQL.

Per caricare query predefinite, cliccare su \includegraphics[width=1.5em]{evis_file.png} $^{\text{Apri File}}$: quando una query è caricata, il titolo della stessa appare nel menu a tendina sotto \emph{Apri File} e una breve descrizione è visualizzata nella casella di testo sottostante.

Selezionare la query che si intende usare e aprire la scheda \emph{Query SQL} per vedere che la query è stata caricata nella finestra. Se è la prima volta che si sta lanciando una query, assicurarsi di essere connessi al database.

Cliccare su \textbf{{[}Esegui Query{]}} nella scheda \emph{Query SQL} per eseguire il comando. Se la query ha avuto successo si aprirà la finestra \emph{Seleziona file Database}. Al contrario, se la query non ha avuto successo, apparirà un messaggio di errore nella \emph{Console di Output}.
\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{Apri File}: permette di selezionare il file XML contenente le query predefinite.

\item {} 
\textbf{Query predefinite}: elenco delle query disponibili nel file XML.

\item {} 
\textbf{Descrizione query}: breve descrizione della query derivata dal file XML.

\item {} 
\textbf{Console di Output}: mostra i messaggi relativi all’esecuzione delle query.

\item {} 
\textbf{Help}: mostra la guida in linea.

\item {} 
\textbf{OK}: chiude Connessione Database .

\end{enumerate}
\phantomsection\label{docs/user_manual/plugins/plugins_evis:evis-xml-tags}

\subsubsection{Formato XML per le query predefinite di 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}
Tag XML letti da eVis

\begin{tabulary}{\linewidth}{|L|L|}
\hline
\textsf{\relax 
Tag
} & \textsf{\relax 
Descrizione
}\\
\hline
query
 & 
Definisce l’inizio e la fine di una istruzione di query.
\\

shortdescription
 & 
Breve descrizione della query che viene mostrata nel menu a tendina di eVis.
\\

description
 & 
Descrizione più dettagliata che viene mostrata nella casella ’Descrizione query’ di eVis.
\\

databasetype
 & 
Tipo di database come definito in ’Tipo Database’ nella scheda Connessione Database .
\\

databaseport
 & 
La porta di connessione come definito in ’Porta’ nella scheda Connessione Database .
\\

databasename
 & 
Il nome del database come definito in ’Nome Database’ nella scheda Connessione Database.
\\

databaseusername
 & 
Nome utente come definito in ’Nome utente’ nella scheda Connessione Database.
\\

databasepassword
 & 
Password come definito in’Nome utente’nella scheda Connessione Database
\\

sqlstatement
 & 
Il comando SQL.
\\

autoconnect
 & 
Valore “true”(vero) o “false”(falso): in caso di “true”, i tag sopra elencati saranno usati per connettersi automaticamente al database, senza avviare la procedura di Connessione Database .
\\
\hline\end{tabulary}


Segue un esempio completo di file XML contenente tre query:

\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{Plugin 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}
Il plugin fTools fornisce una risorsa comprensiva delle più comuni operazioni GIS basate su vettori, senza la necessità di software addizionale, librerie e soluzioni complesse: il plugin mette a disposizione una suite di funzioni di analisi veloci e funzionali.

Tools è installato di default nelle nuove versioni di QGIS e, come tutti gli altri plugin, può essere disabilitato nel gestore dei plugin (sezione {\hyperref[docs/user_manual/plugins/plugins:load-core-plugin]{\emph{Abilitare un Plugin Core}}}). Se abilitato, fTools aggiunge il nuovo menu \emph{Vettore} all’interfaccia di QGIS: questo nuovo menu offre funzioni di ricerca, analisi, geoprocessamento, gestione.
\phantomsection\label{docs/user_manual/plugins/plugins_ftools:ftools-function}
\index{Strumenti di Analisi}

\subsection{Strumenti di Analisi}
\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{Icona}
} & \textsf{\relax 
\textbf{Strumento}
} & \textsf{\relax 
\textbf{Azione}
}\\
\hline
\includegraphics[width=1.5em]{matrix.png}
 & 
Matrice di distanza
 & 
Misura le distanze tra due layer di punti e fornisce il risultato come a) Matrice di distanza lineare, b) Matrice di distanza standard, c) Sintesi matrice di distanza. Può limitare i calcoli ai ’k’ punti più vicini.
\\

\includegraphics[width=1.5em]{sum_lines.png}
 & 
Somma lunghezze linee
 & 
Calcola la somma della lunghezza di tutte le linee per ogni poligono di un layer di poligoni.
\\

\includegraphics[width=1.5em]{sum_points.png}
 & 
Punti nel poligono
 & 
Calcola il numero di punti che ricadono all’interno di ogni poligono di un layer di poligoni.
\\

\includegraphics[width=1.5em]{unique.png}
 & 
Lista valori unici
 & 
Elenca i valori unici di un campo di un layer vettoriale
\\

\includegraphics[width=1.5em]{basic_statistics.png}
 & 
Statistiche di base
 & 
Calcola statistiche di base, es. media, deviazione standard, somma, di un campo di un layer vettoriale.
\\

\includegraphics[width=1.5em]{neighbour.png}
 & 
Analisi vicino più prossimo
 & 
Calcola delle statistiche per valutare il livello di clustering in un layer vettoriale di punti
\\

\includegraphics[width=1.5em]{mean.png}
 & 
Media coordinata(e)
 & 
Calcola il centro medio (media normale o pesata) di un layer vettoriale o di un’insieme di elementi ed in funzione di un campo con ID unico.
\\

\includegraphics[width=1.5em]{intersections.png}
 & 
Intersezioni linee
 & 
Calcola l’intersezione tra linee e restituisce il risultato in uno shapefile di punti. Utile per localizzare intersezioni fra strade e ponti; ignora le intersezioni con una lunghezza \textgreater{} 0.
\\
\hline\end{tabulary}


fTools - Strumenti di Analisi

\index{Strumenti di Ricerca}

\subsection{Strumenti di Ricerca}
\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{Icona}
} & \textsf{\relax 
\textbf{Strumento}
} & \textsf{\relax 
\textbf{Azione}
}\\
\hline
\includegraphics[width=1.5em]{random_selection.png}
 & 
Selezione casuale
 & 
Seleziona in maniera casuale \code{n} o \code{n\%} di elementi
\\

\includegraphics[width=1.5em]{sub_selection.png}
 & 
Selezione casuale con un sottoinsieme
 & 
Selezione casuale in un sottoinseme tramite campo ID unico.
\\

\includegraphics[width=1.5em]{random_points.png}
 & 
Punti casuali
 & 
Genera punti pseudo-random.
\\

\includegraphics[width=1.5em]{regular_points.png}
 & 
Punti regolari
 & 
Genera una griglia regolare di punti su un’area specifica e la esporta come shapefile di punti.
\\

\includegraphics[width=1.5em]{vector_grid.png}
 & 
Reticolo vettoriale
 & 
Genera una griglia di linee o di poligoni con spaziatura definita dall’utente.
\\

\includegraphics[width=1.5em]{select_location.png}
 & 
Seleziona per posizione
 & 
Seleziona elementi in base alla loro posizione relativa ad un altro layer: crea una nuova selezione oppure aggiunge/sottrae alla selezione corrente.
\\

\includegraphics[width=1.5em]{layer_extent.png}
 & 
Poligono dall'estensione del layer
 & 
Crea un poligono rettangolare dall’estensione di un layer raster o vettoriale.
\\
\hline\end{tabulary}


fTools - Strumenti di Ricerca


\subsection{Strumenti di Geoprocessing}
\label{docs/user_manual/plugins/plugins_ftools:geoprocessing-tools}
\begin{tabulary}{\linewidth}{|L|L|L|}
\hline
\textsf{\relax 
\textbf{Icona}
} & \textsf{\relax 
\textbf{Strumento}
} & \textsf{\relax 
\textbf{Azione}
}\\
\hline
\includegraphics[width=1.5em]{convex_hull.png}
 & 
Poligono/i convesso/i
 & 
Crea il poligono minimo convesso di un layer vettoriale o poligoni minimi convessi sulla base di un campo in input.
\\

\includegraphics[width=1.5em]{buffer.png}
 & 
Buffer
 & 
Crea buffer intorno ad un elemento in funzione di una distanza impostata o di un campo in input.
\\

\includegraphics[width=1.5em]{intersect.png}
 & 
Intersezione
 & 
Sovrappone due layer e ne restituisce uno nuovo contenente la superficie di intersezione dei layer di input.
\\

\includegraphics[width=1.5em]{union.png}
 & 
Unione
 & 
Sovrappone due layer e ne restituisce uno nuovo contenente la superficie totale dei layer di input.
\\

\includegraphics[width=1.5em]{sym_difference.png}
 & 
Differenza simmetrica
 & 
Sovrappone due layer e ne restituisce uno nuovo contenente la superficie dei layer di input tranne la loro intersezione.
\\

\includegraphics[width=1.5em]{clip.png}
 & 
Clip
 & 
Sovrappone due layer e ne restituisce uno nuovo contenente la superficie che interseca il clip layer.
\\

\includegraphics[width=1.5em]{difference.png}
 & 
Differenza
 & 
Sovrappone due layer e ne restituisce uno nuovo contenente la superficie che non interseca il clip layer.
\\

\includegraphics[width=1.5em]{dissolve.png}
 & 
Dissolvenza
 & 
Unisce elementi sulla base di un campo in input: gli elementi con lo stesso valore sono combinati in un elemento unico.
\\
\hline\end{tabulary}


fTools - Strumenti di Geoprocessing


\subsection{Strumenti di Geometria}
\label{docs/user_manual/plugins/plugins_ftools:geometry-tools}
\begin{tabulary}{\linewidth}{|L|L|L|}
\hline
\textsf{\relax 
\textbf{Icona}
} & \textsf{\relax 
\textbf{Strumento}
} & \textsf{\relax 
\textbf{Azione}
}\\
\hline
\includegraphics[width=1.5em]{check_geometry.png}
 & 
Controlla validità geometria
 & 
Controlla poligoni per verificare la presenza di intersezioni e buchi chiusi e risolvere l’ordine dei nodi.
\\

\includegraphics[width=1.5em]{export_geometry.png}
 & 
Estrai/Aggiungi colonne geometriche
 & 
Aggiunge informazioni sulla geometria a layer di punti (XCOORD, YCOORD), di linee (LENGTH), di poligoni (AREA, PERIMETER).
\\

\includegraphics[width=1.5em]{centroids.png}
 & 
Centroidi di poligoni
 & 
Calcola i centroidi per ogni poligono di un layer di input.
\\

\includegraphics[width=1.5em]{delaunay.png}
 & 
Triangolazione di Delaunay
 & 
Calcola la triangolazione di Delaunay per un layer di punti in input.
\\
 & 
Poligoni di Voronoi
 & 
Calcola i poligoni di Voronoi per un layer di punti in input.
\\

\includegraphics[width=1.5em]{simplify.png}
 & 
Semplifica geometrie
 & 
Generalizza linee e/o poligoni con un algoritmo modificato di Douglas-Peucker.
\\
 & 
Infittisci geometrie
 & 
Infittisce linee o poligoni aggiungendo dei vertici
\\

\includegraphics[width=1.5em]{multi_to_single.png}
 & 
Da parti multiple a parti singole
 & 
Converte elementi multi-parte in più elementi semplici. Crea linee e poligoni semplici.
\\

\includegraphics[width=1.5em]{single_to_multi.png}
 & 
Da parti singole a parti multiple
 & 
Unisce più elementi in un elemento multi-parte sulla base di un campo in input.
\\

\includegraphics[width=1.5em]{to_lines.png}
 & 
Da poligoni a linee
 & 
Converte poligoni in linee, poligoni multi-parte in linee semplici.
\\

\includegraphics[width=1.5em]{to_lines.png}
 & 
Da linee a poligoni
 & 
Converte linee in poligoni, linee multi-parte in poligoni semplici.
\\

\includegraphics[width=1.5em]{extract_nodes.png}
 & 
Estrai vertici
 & 
Estrae vertici da layer di linee e poligoni e restituisce un nuovo layer di punti.
\\
\hline\end{tabulary}


fTools - Strumenti di Geometria

\begin{notice}{note}{Nota:}
Lo strumento \emph{Semplifica geometrie} può essere usato per rimuovere vertici doppi in layer di linee o di poligoni. Il trucco è impostare il valore 0 per il parametro \emph{Tolleranza di semplificazione}.
\end{notice}


\subsection{Strumenti di Gestione Dati}
\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{Icona}
} & \textsf{\relax 
\textbf{Strumento}
} & \textsf{\relax 
\textbf{Azione}
}\\
\hline
\includegraphics[width=1.5em]{define_projection.png}
 & 
Definisci proiezione in uso
 & 
Specifica il SR per gli shapefile senza SR associato.
\\

\includegraphics[width=1.5em]{join_location.png}
 & 
Unisci attributi per posizione
 & 
Aggiunge attributi ad un layer vettoriale sulla base di relazioni spaziali. Attributi di un layer vengono aggiunti alla tabella attributi di un altro layer: il risultato è salvato come nuovo shapefile.
\\

\includegraphics[width=1.5em]{split_layer.png}
 & 
Dividi vettore
 & 
Divide il layer di input in più layer separati sulla base di un campo in input.
\\

\includegraphics[width=1.5em]{merge_shapes.png}
 & 
Unisci shapefile
 & 
Unisce più shapefile in un unico shapefile sulla base del tipo di layer (punti, linee, poligoni).
\\
 & 
Crea indice spaziale
 & 
Crea un indice spaziale per i formati supportati da OGR.
\\
\hline\end{tabulary}


fTools - Strumenti di Gestione Dati


\section{Plugin 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{Cos’è GDALTools?}
\label{docs/user_manual/plugins/plugins_gdaltools:what-is-gdaltools}\label{docs/user_manual/plugins/plugins_gdaltools:whatsgdal}
Il plugin GDALTools fa da interfaccia grafica ad una collezione di strumenti GDAL (Geospatial Data Abstraction Library), \href{http://gdal.osgeo.org}{http://gdal.osgeo.org}: es. strumenti per interrogare, riproiettare, unire raster in vari formati. Sono inclusi strumenti per derivare da un DEM dati tipo curve di livello, pendenze, ombreggiature o anche per collegare in un raster virtuale diversi file raster (Virtual Raster Tile in XML). Tutti questi strumenti sono disponibili quando il plugin è installato e attivato.


\subsubsection{La libreria GDAL}
\label{docs/user_manual/plugins/plugins_gdaltools:the-gdal-library}
La libreria GDAL consiste di un insieme di programmi da linea di comando, ognuno con una vasta lista di opzioni. Gli utenti che si trovano a loro agio lavorando con un terminale preferiranno usare gli strumenti GDAL da riga di comando ed avranno cosi accesso a tutte le opzioni. Il plugin GDALTools offre anche una semplice interfaccia per utilizzare tali programmi, visualizzando solo le opzioni più utilizzate.


\subsection{Lista degli strumenti 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{Proiezioni}
\label{docs/user_manual/plugins/plugins_gdaltools:projections}
\begin{tabulary}{\linewidth}{|L|L|}
\hline

\includegraphics[width=1.5em]{warp.png} \emph{Riproiezione}
 & 
Questo programma permette di riproiettare in uno qualsiasi dei sistemi supportati: può, inoltre, utilizzare i GCP memorizzati in un’immagine. Per ulteriori informazioni visitare la pagina web di GDAL website \href{http://www.gdal.org/gdalwarp.html}{http://www.gdal.org/gdalwarp.html}
\\

\includegraphics[width=1.5em]{projection-add.png} \emph{Assegna proiezione}
 & 
Questo strumento permette di assegnare una proiezione a un file raster georeferenziato che però manca di questa informazione. E' anche possibile cambiare la proiezione a un file che ne ha già una. Inoltre è possibile lavorare su un singolo file oppure su un'intera cartella. Per ulteriori informazioni visitare \href{http://www.gdal.org/gdalwarp.html}{http://www.gdal.org/gdalwarp.html}
\\

\includegraphics[width=1.5em]{projection-export.png} \emph{Estrai proiezione}
 & 
Grazie a questo strumento è possibile estrarre le informazioni sulla proiezione sia di un singolo file che di un'intera cartella. Viene creato sia il \code{.prj} che il \code{.wld}.
\\
\hline\end{tabulary}



\paragraph{}
\label{docs/user_manual/plugins/plugins_gdaltools:id1}

\subsubsection{Conversione}
\label{docs/user_manual/plugins/plugins_gdaltools:conversion}
\begin{tabulary}{\linewidth}{|L|L|}
\hline

\includegraphics[width=1.5em]{rasterize.png} \emph{Rasterizzazione}
 & 
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{Poligonizzazione}
 & 
Questo programma crea poligoni vettoriali a partire da insiemi di pixel connessi di un raster che hanno lo stesso valore. Ogni poligono creato porta un attributo corrispondente al valore dei pixel che lo hanno generato. Il formato file predefinito per l’output è lo shapefile (vedi anche \href{http://www.gdal.org/gdal\_polygonize.html}{http://www.gdal.org/gdal\_polygonize.html})
\\

\includegraphics[width=1.5em]{translate.png} \emph{Conversione formati}
 & 
Questo programma converte raster tra formati diversi: il processo può comprendere operazioni di ricampionamento, ridimensionamento etc. Per ulteriori informazioni visitare \href{http://www.gdal.org/gdal\_translate.html}{http://www.gdal.org/gdal\_translate.html}
\\

\includegraphics[width=1.5em]{raster-rgb.png} \emph{Da RGB a PCT}
 & 
Questo programma calcola la mappa colore pseudo-colore ottimale per un’immagine RGB: l’immagine viene convertita in pseudo-colore utilizzando la mappa colore calcolata. Tale conversione usa l’algoritmo di Floyd-Steinberg per massimizzare la qualità visuale dell’output (vedi anche \href{http://www.gdal.org/rgb2pct.html}{http://www.gdal.org/rgb2pct.html})
\\

\includegraphics[width=1.5em]{raster-rgb.png} \emph{Da PCT a RGB}
 & 
Questo programma converte una banda pseudo-colore in un file RGB, in un formato a scelta. Per ulteriori informazioni vedere \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{Estrazione}
\label{docs/user_manual/plugins/plugins_gdaltools:extraction}
\begin{tabulary}{\linewidth}{|L|L|}
\hline

\includegraphics[width=1.5em]{contour.png} \emph{Curve di livello}
 & 
Questo programma deriva un file vettoriale di curve di livello a partire da un DEM. Ulteriori informazioni su \href{http://www.gdal.org/gdal\_contour.html}{http://www.gdal.org/gdal\_contour.html}.
\\

\includegraphics[width=1.5em]{raster-clip.png} \emph{Clipper}
 & 
Questo strumento permette di estrarre una porzione di un raster; è possibile scegliere l'estensione oppure la porzione estratta può essere ritagliata su un altro layer (mask). Altre informazioni su \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{Analisi}
\label{docs/user_manual/plugins/plugins_gdaltools:analysis}
\begin{tabulary}{\linewidth}{|L|L|}
\hline

\includegraphics[width=1.5em]{sieve.png} \emph{Filtro}
 & 
Questo programma rimuove poligoni raster più piccoli di un dato valore soglia (in pixel) e li sostituisce con il valore del pixel del poligono vicino più grande: il risultato può essere salvato nel raster esistente o in un nuovo file. Ulteriori informazioni su \href{http://www.gdal.org/gdal\_sieve.html}{http://www.gdal.org/gdal\_sieve.html} .
\\

\includegraphics[width=1.5em]{nearblack.png} \emph{Sposta al nero/bianco}
 & 
Questo programma scansiona un’immagine e cerca di impostare tutti i pixel sui bordi che sono “quasi neri” (o “quasi bianchi”) in modo che siano del tutto neri (o bianchi). Spesso viene utlizzato per ``correggere'' le foto aeree ``lossy compressed'' in modo che i pixel colorati siano visti come trasparenti durante la mosaicizzazione. Informazioni su \href{http://www.gdal.org/nearblack.html}{http://www.gdal.org/nearblack.html} .
\\

\includegraphics[width=1.5em]{fillnodata.png} \emph{Riempimento nullo}
 & 
Questo strumento riempie la regione raster selezionata (aree nodata) con valori di pixel interpolat da aree vicino all'area. Ulteriori informazioni su \href{http://www.gdal.org/gdal\_fillnodata.html}{http://www.gdal.org/gdal\_fillnodata.html}.
\\

\includegraphics[width=1.5em]{proximity.png}\emph{Prossimità}
 & 
Questo programma genera una mappa raster di prossimità, che mostra la distanza dal centro di ogni pixel al centro del pixel più vicino scelto come target. Visitare \href{http://www.gdal.org/gdal\_proximity.html}{http://www.gdal.org/gdal\_proximity.html} per ulteriori informazioni.
\\

\includegraphics[width=1.5em]{grid.png} \emph{Interpolazion}
 & 
Questo programma crea una griglia raster da dati sparsi OGR. I dati di input saranno interpolati al fine di individuare i nodi della griglia raster: sono disponibili vari metodi  di interpolazione. Lo strumento è descritto sulla pagina \href{http://www.gdal.org/gdal\_grid.html}{http://www.gdal.org/gdal\_grid.html} .
\\

\includegraphics[width=1.5em]{gdal_dem.png} \emph{DEM analisi geomorfologica}
 & 
Questo programma permette operazioni di analisi e visualizzazione di DEM. Può generare un rilievo ombreggiato, la pendenza, l’orientamento, oppure calcolare l’indice di asperità del terreno e l’indice di posizione geografica per tutti i formati raster di elevazione supportati da GDAL. Altre informazioni su \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{Miscellanea}
\label{docs/user_manual/plugins/plugins_gdaltools:miscellaneous}
\begin{tabulary}{\linewidth}{|L|L|}
\hline

\includegraphics[width=1.5em]{vrt.png} \emph{Crea raster virtuale}
 & 
Questo programma costruisce un VRT (Virtual Raster), ovvero un mosaico di vari raster. Vedi anche \href{http://www.gdal.org/gdalbuildvrt.html}{http://www.gdal.org/gdalbuildvrt.html} .
\\

\includegraphics[width=1.5em]{merge.png} \emph{Unione}
 & 
Questo programma mosaica un insieme di raster: tutti i raster devono essere nello stesso sistema di riferimento ed avere lo stesso numero di bande, anche se possono parzialmente sovrapporsi ed essere a diversa risoluzione. Nelle aree di sovrapposizione, l'ultima immagine sarà copiata sopra la precedente. Lo strumento è descritto anche su \href{http://www.gdal.org/gdal\_merge.html}{http://www.gdal.org/gdal\_merge.html} .
\\

\includegraphics[width=1.5em]{raster-info.png} \emph{Informazioni}
 & 
Questo programma elenca una serie di informazioni su un raster. Informazioni su \href{http://www.gdal.org/gdalinfo.html}{http://www.gdal.org/gdalinfo.html}.
\\

\includegraphics[width=1.5em]{raster-overview.png} \emph{Crea panoramica}
 & 
Questo programma -gdaladdo- permette di creare anteprime -piramidi- di immagini con diversi metodi di ricampionamento. Altre informazioni su \href{http://www.gdal.org/gdaladdo.html}{http://www.gdal.org/gdaladdo.html} .
\\

\includegraphics[width=1.5em]{tileindex.png} \emph{Indice delle tile}
 & 
Questo programma genera uno shapefile con un record per ogni file raster in input, un attributo contenente il nome del file e una geometria poligonale che delinea il raster. Ulteriori informazioni su \href{http://www.gdal.org/gdaltindex.html}{http://www.gdal.org/gdaltindex.html} .
\\
\hline\end{tabulary}



\section{Plugin Georeferenziatore}
\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}
Il Plugin Georeferenziatore è uno strumento per generare file di georeferenziazione (world file) per i raster. Permette di georeferenziare raster in sistemi di coordinate geografiche e proiettate, creando un GeoTiff oppure associandogli un world file. L’approccio di base del plugin è quello di individuare punti del raster per i quali sia possibile determinare accuratamente le coordinate.

\textbf{Features}

\index{Georeferencer tools}\phantomsection\label{docs/user_manual/plugins/plugins_georeferencer:table-georeferencer-1}
\begin{tabulary}{\linewidth}{|L|L|L|L|}
\hline
\textsf{\relax 
Icona
} & \textsf{\relax 
Azione
} & \textsf{\relax 
Icona
} & \textsf{\relax 
Azione
}\\
\hline &  &  & \\

\includegraphics[width=1.5em]{mActionAddRasterLayer.png}
 & 
Carica un raster
 & 
\includegraphics[width=1.5em]{mActionStartGeoref.png}
 & 
Avvia la georeferenziazione
\\

\includegraphics[width=1.5em]{mActionGDALScript.png}
 & 
Genera uno script GDAL
 & 
\includegraphics[width=1.5em]{mActionFileOpen.png}
 & 
Carica punti GCP (Ground Control Point)
\\

\includegraphics[width=1.5em]{mActionFileSave.png}
 & 
Salva punti GCP
 & 
\includegraphics[width=1em]{mActionOptions.png}
 & 
Imposta la trasformazione
\\

\includegraphics[width=1.5em]{mActionCapturePoint.png}
 & 
Aggiunge un nuovo punto
 & 
\includegraphics[width=1.5em]{mActionDeleteSelected.png}
 & 
Elimina un punto
\\

\includegraphics[width=1.5em]{mActionMoveFeature.png}
 & 
Sposta un punto GCP
 & 
\includegraphics[width=1.5em]{mActionPan.png}
 & 
Sposta la vista
\\

\includegraphics[width=1.5em]{mActionZoomIn.png}
 & 
Ingrandisce la vista
 & 
\includegraphics[width=1.5em]{mActionZoomOut.png}
 & 
Rimpicciolisce la vista
\\

\includegraphics[width=1.5em]{mActionZoomToLayer.png}
 & 
Zoom sul layer
 & 
\includegraphics[width=1.5em]{mActionZoomLast.png}
 & 
Zoom precedente
\\

\includegraphics[width=1.5em]{mActionZoomNext.png}
 & 
Zoom successivo
 & 
\includegraphics[width=2.5em]{mActionLinkGeorefToQGis.png}
 & 
Collega il georeferenziatore a QGIS
\\

\includegraphics[width=2.5em]{mActionLinkQGisToGeoref.png}
 & 
Collega il georeferenziatore a QGIS
 &  & \\
\hline\end{tabulary}


Strumenti del georeferenziatore


\subsection{Utilizzo del plugin}
\label{docs/user_manual/plugins/plugins_georeferencer:usual-procedure}
Per le coordinate X e Y (espresse in gradi, primi e secondi) oppure per le coordinate poriettate (espresse in metri), che corrispondono ai punti selezionati sull'immagine, possono essere usate due procedure alternative:
\begin{itemize}
\item {} 
Inserire manualmente le coordinate: solitamente nei raster sono presenti punti con le coordinate scritte sull’immagine.

\item {} 
Usare un layer già georiferito (vettoriale o raster) contenente le stesse entità/oggetti del raster da georiferire. In questo caso le coordinate vengono inserire cliccando sul layer di riferimento nella vista mappa.

\end{itemize}

Una procedura meno usuale consiste nel selezionare più punti del raster, specificarne le coordinate e scegliere un metodo di trasformazione. Sulla base dei parametri inseriti, il plugin calcola i parametri del world file. Più coordinate vengono fornite, migliore sarà il risultato.

Avviare QGIS, caricare il plugin (sezione {\hyperref[docs/user_manual/plugins/plugins:load-core-plugin]{\emph{Abilitare un Plugin Core}}}) e cliccare sull'icona \includegraphics[width=1.5em]{georeferencer.png} $^{\text{Georeferenziatore}}$ nella barra dei plugin. Si aprirà la finestra di dialogo Georeferenziatore mostrata in figura {\hyperref[docs/user_manual/plugins/plugins_georeferencer:figure-georeferencer-1]{figure\_georeferencer\_1}}.

Come esempio si può provare a georiferire la carta topografica del South Dakota scaricabile da: \href{http://grass.osgeo.org/sampledata/spearfish\_toposheet.tar.gz}{http://grass.osgeo.org/sampledata/spearfish\_toposheet.tar.gz}. Sarà possibile visualizzare la carta anche con i dati di GRASS della location \code{spearfish60}.
\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{Aggiungere punti 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 {} 
Per iniziare a georiferire un raster, caricarlo cliccando sul pulsante \includegraphics[width=1.5em]{mActionAddRasterLayer.png}. Il raster sarà visualizzato nel riquadro principale della finestra di dialogo. Caricato il raster, è ora possibile iniziare ad inserire i punti di riferimento.

\item {} 
Usare il pulsante \includegraphics[width=1.5em]{mActionCapturePoint.png} $^{\text{Aggiungi punto}}$ per aggiungere punti sul raster ed inserire le coordinate (see Figure {\hyperref[docs/user_manual/plugins/plugins_georeferencer:figure-georeferencer-2]{figure\_georeferencer\_2}}). Per inserire le coordinate si hanno tre opzioni:
\begin{itemize}
\item {} 
Cliccare su un punto del raster ed inserire le coordinate X/Y manualmente.

\item {} 
Cliccare su un punto del raster ed usare il pulsante \includegraphics[width=1.5em]{pencil.png} $^{\text{Dalla mappa}}$ per inserire le coordinate X/Y con l’aiuto di layer già georeferenziato caricato nella vista mappa di QGIS.

\item {} 
Se necessario usare il pulsante \includegraphics[width=1.5em]{mActionMoveFeature.png} per spostare i punti in entrambe le finestre.

\end{itemize}

\item {} 
Bisogna inserire almeno 4 GCP: più punti vengono inseriti, migliore sarà il risultato. Aiutarsi con gli altri strumenti del plugin per spostarsi nell’area di lavoro.

\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}

I punti inseriti vengono salvati in un file di testo (\code{{[}filename{]}.points}), solitamente all’interno della cartella contenente l’immagine raster: in tal modo sarà possibile riaprire il plugin con gli stessi dati per aggiungere/rimuovere punti al fine di ottimizzare il risultato. Il file dei punti contiene valori nella forma: \code{mapX, mapY, pixelX, pixelY}: tali file possono essere gestiti con i pulsanti \includegraphics[width=1.5em]{mActionFileOpen.png} $^{\text{Carica punti GCCP}}$ e \includegraphics[width=1.5em]{mActionFileSave.png} $^{\text{Salva punti GCP come}}$.

Nella tabella dei punti GCP è possibile ordinare i punti (per esempio in base al numero); la lista dei punti viene automaticamente aggiornata.


\subsubsection{Impostare una trasformazione}
\label{docs/user_manual/plugins/plugins_georeferencer:georeferencer-transformation}\label{docs/user_manual/plugins/plugins_georeferencer:defining-the-transformation-settings}
Una volta aggiunti i GCP, è necessario definire le impostazioni di trasformazione del processo di georeferenziazione.
\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{Algoritmi di trasformazione disponibili}
\label{docs/user_manual/plugins/plugins_georeferencer:available-transformation-algorithms}
Sono disponibili diversi algoritmi di trasformazione: la scelta dipende dal numero di GCP a disposizione, dal tipo e dalla qualità dei dati di input e dall’entità di distorsione geometrica che si accetta di introdurre nel risultato finale.

Sono disponibili i seguenti algoritmi:
\begin{itemize}
\item {} 
L’\textbf{Algoritmo Lineare} genera un word file, quindi non trasforma fisicamente il raster a differenza degli altri metodi: non è un algoritmo efficiente in caso di mappe provenienti da scansione di materiale cartaceo.

\item {} 
La \textbf{Trasformazione di Helmert} opera una rototraslazione.

\item {} 
Gli \textbf{Algoritmi Polinomiali} (1-3) sono molto usati: ognuno differisce in funzione del grado di distorsione introdotto nell’accoppiamento dei GCP. La trasformazione polinomiale più utilizzata è quella di secondo ordine: tiene conto della curvatura. La trasformazione polinomiale del primo ordine (affine) preserva la collinearità e permette la rototraslazione.

\item {} 
L’\textbf{Algoritmo Thin plate spline (TPS)} permette di introdurre deformazioni locali nei dati. L’algoritmo è particolarmente efficace nel caso i dati da georiferire siano di scarsa qualità.

\item {} 
La \textbf{Trasformazione Proiettiva} applica una rototraslazione delle coordinate.

\end{itemize}


\subsubsection{Metodo di ricampionamento}
\label{docs/user_manual/plugins/plugins_georeferencer:define-the-resampling-method}
La scelta del metodo di ricampionamento dipende dai dati in input e da alcuni requisiti utente. Se, ad esempio, non si accettano modifiche alle statistiche dell’immagine, allora il metodo del vicino più prossimo sarà più adatto. Se, invece, si richiede un risultato più `liscio' (smoothed) si utilizzerà il metodo cubico.

Sono disponibili 5 diversi metodi di ricampionamento.
\begin{enumerate}
\item {} 
Vicino più prossimo

\item {} 
Lineare

\item {} 
Cubico

\item {} 
Spline cubica

\item {} 
Lanczos

\end{enumerate}


\subsubsection{Altre impostazioni di trasformazione}
\label{docs/user_manual/plugins/plugins_georeferencer:define-the-transformation-settings}
Bisogna definire varie altre opzioni per l’output.
\begin{itemize}
\item {} 
La casella di controllo \includegraphics{checkbox.png} \emph{Crea il file di georeferenziazione} è attiva solo se si è scelta la trasformazione lineare, appunto quando il raster non viene fisicamente traformato: in tal caso, quindi, la casella Raster in output non è attiva perché viene creato solo un nuovo file world.

\item {} 
Per tutti gli altri tipi di trasformazione bisogna defnire un \emph{Raster in output}.Come modalità predefinita, viene creato un nuovo file ({[}nomefile{]}\_modificato) nella stessa cartella del raster di partenza.

\item {} 
Bisogna, poi, scegliere il \emph{SR} (Sistema di riferimento) (sezione {\hyperref[docs/user_manual/working_with_projections/working_with_projections:label-projections]{\emph{Lavorare con le proiezioni}}}).

\item {} 
Volendo si possono creare delle \textbf{mappe pdf} e anche dei \textbf{report pdf}. Il report fornisce informazioni sui parametri di informazione utilizzati, un immagine dei residui e una lista con tutti i punti GCP con il loro errore standard.

\item {} 
La casella di controllo \includegraphics{checkbox.png} \emph{imposta risoluzione finale} permette di definire la risoluzione del raster di output: il valore predefinito è 1.

\item {} 
Attivando la casella di controllo \includegraphics{checkbox.png} \emph{Utilizzare 0 per la trasparenza dove necessario}, i pixel con valore 0 saranno trasparenti.

\item {} 
La casella di controllo \includegraphics{checkbox.png} \emph{Carca in QGIS una volta eseguito}, carica l'output nella vista mappa di QGIS a trasformazione terminata.

\end{itemize}


\subsubsection{Proprietà del raster}
\label{docs/user_manual/plugins/plugins_georeferencer:show-and-adapt-raster-properties}
Cliccando su \emph{Proprietà raster} nel menu \emph{Preferenze}, si apre la finestra di dialogo Proprietà del layer - Raster.


\subsubsection{Configurare il georeferenziatore}
\label{docs/user_manual/plugins/plugins_georeferencer:configure-the-georeferencer}\begin{itemize}
\item {} 
Definire se visualizzare coordinate e/o ID dei GCP.

\item {} 
mpostare le unità dei residui.

\item {} 
Impostare i margini per i rapporti pdf e le dimensioni per le mappe pdf.

\item {} 
E' possibile attivare la casella di controllo \includegraphics{checkbox.png} \emph{Mostra la finestra del georeferenziatore agganciata}.

\end{itemize}


\subsubsection{Eseguire la trasformazione}
\label{docs/user_manual/plugins/plugins_georeferencer:running-the-transformation}\label{docs/user_manual/plugins/plugins_georeferencer:georeferencer-running}
Una volta acquisiti i GCP necessari ed impostati i vari parametri della trasformazione, cliccare su \includegraphics[width=1.5em]{mActionStartGeoref.png} $^{\text{Inizia georeferenziazione}}$ per creare il nuovo raster georeferenziato.


\section{Plugin Interpolazione}
\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}
Il plugin di interpolazione permette di generare un TIN (Triangulated Irregular Network) o un’interpolazione IDW (Inverse Distance Weighting) a partire da un layer vettoriale di punti: è molto semplice da usare grazie all’interfaccia grafica intuitiva mostrata in Figura {\hyperref[docs/user_manual/plugins/plugins_interpolation:figure-interpolation-1]{Figure\_interpolation\_1}}. Il plugin richiede l’impostazione dei seguenti parametri:
\begin{itemize}
\item {} 
\textbf{Layer vettoriale in input}: permette di selezionare un layer vettoriale di punti tra quelli caricati in QGIS. È anche possibile utilizzare dati provenienti da più layer. Nota: è possibile utilizzare linee e poligoni come vincoli per la triangolazione, specificando ``punti'', ``Linee struttura'' o ``Linee di interruzione'' nel menu a discesa \emph{Tipo} \includegraphics{selectstring.png}.

\item {} 
\textbf{Attributo interpolazione}: selezionare la colonna attributo contenente i valori da utilizzare per l’interpolazione o attivare la casella di controllo \includegraphics{checkbox.png} \emph{Usa la coordinata Z per l'interpolazione}.

\item {} 
\textbf{Metodo di interpolazione}: permette di selezionare il metodo di interpolazione, che può essere `Triangulated Irregular Network (TIN)' o `Inverse Distance Weighted (IDW)'.

\item {} 
\textbf{Numero di colonne/righe}: specifica il numero di colonne e di righe del raster di output.

\item {} 
\textbf{File di output}: nome del raster di output.

\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{Utilizzo del plugin}
\label{docs/user_manual/plugins/plugins_interpolation:using-the-plugin}\label{docs/user_manual/plugins/plugins_interpolation:interpolation-usage}\begin{enumerate}
\item {} 
Avviare QGIS e caricare un layer vettoriale di punti (es. \code{elevp.csv}).

\item {} 
Caricare il plugin di Interpolazione nel gestore dei plugin (sezione {\hyperref[docs/user_manual/plugins/plugins:load-core-plugin]{\emph{Abilitare un Plugin Core}}}) e cliccare su \includegraphics[width=1.5em]{raster-interpolate.png} $^{\text{Interpolazione}}$ nella barra dei plugin. La finestra di dialogo del plugin di Interpolazione appare come in figura {\hyperref[docs/user_manual/plugins/plugins_interpolation:figure-interpolation-1]{Figure\_interpolation\_1}}.

\item {} 
Selezionare un layer in imìnput (es. \emph{elevp} \includegraphics{selectstring.png}) e una colonna per l'interpolazione (e.g., \code{ELEV}).

\item {} 
Selezionare un metodo di interpolazione (es. `Triangulated Irregular Network (TIN)'), impostare 5000 come dimensione delle celle e \emph{elevation\_tin} come nome del raster di output.

\item {} 
Cliccare su \textbf{{[}OK{]}}.

\item {} 
Fare doppio click su \code{elevation\_tin} per aprire la finestra di dialogo \emph{Proprietà layer} e selezionare `Pseudocolor' come \emph{Mappa di colore} \includegraphics{selectstring.png} nella scheda \emph{Stile}.Oppure è possibile definire una nuova tavola di colori come descritto nella sezione {\hyperref[docs/user_manual/working_with_raster/index:working-with-raster]{\emph{Lavorare con i dati raster}}}.

\end{enumerate}

\index{Mapserver\_Export\_Plugin}

\section{Plugin MapServer Export}
\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}
Si può usare QGIS per comporre la propria mappa, aggiungendo e arrangiando i layer, simbolizzandoli, personalizzando i colori, e infine creare un map file per Mapserver per la pubblicazione sul web.

\begin{notice}{note}{Nota:}
Attualmente il plugin funziona solamente con la `Vecchia simbologia', la `Nuova simbologia' non è ancora supportata.
\end{notice}


\subsection{Creare il file Progetto}
\label{docs/user_manual/plugins/plugins_mapserver_export:creating-the-project-file}
Il Plugin MapServer Export opera su un progetto QGIS salvato e \textbf{non} sui contenuti correnti della vista mappa e della legenda: questo ha generato confusione in diversi utenti. Prima di cominciare ad utilizzare il plugin, è necessario predisporre i layer vettoriali e raster che si intende usare in MapServer e salvare queste impostazioni in un file di progetto 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}

L’esempio seguente mostra brevemente come creare un semplice progetto da usare per il mapfile di MapServer. Vengono usati file vettoriali e raster dal dataset campione di QGIS {\hyperref[docs/user_manual/introduction/getting_started:label-sampledata]{\emph{Dati campione}}}.
\begin{enumerate}
\item {} 
Aggiungere il layr raster \code{landcover.tif} cliccando su \includegraphics[width=1.5em]{mActionAddRasterLayer.png} $^{\text{Aggiungi raster}}$.

\item {} 
Aggiungere gli shapefile \code{lakes.shp}, \code{majrivers.shp} e \code{airports.shp} cliccando su \includegraphics[width=1.5em]{mActionAddNonDbLayer.png} $^{\text{Aggiungi vettore}}$.

\item {} 
Cambiare lo stile dei layer (come esempio, vedere {\hyperref[docs/user_manual/plugins/plugins_mapserver_export:figure-mapserver-export-1]{figure\_mapserver\_export\_1}})

\item {} 
Salvare un nuovo progetto con un nome \code{mapserverproject.qgs} usando \emph{File \(\rightarrow\)} \includegraphics[width=1.5em]{mActionFileSave.png} \emph{Salva progetto}.

\end{enumerate}

\index{msexport}

\subsection{Creazione del Map File}
\label{docs/user_manual/plugins/plugins_mapserver_export:creating-the-map-file}\label{docs/user_manual/plugins/plugins_mapserver_export:index-1}
Per usare il plugin Mapserver Export da QGIS è necessario attivarlo usando il Gestore QGIS Plugin (sezione ref:\emph{load\_core\_plugin}).
\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{Map file}
 & 
Scegliere un nome per il mapfile da creare. Si può anche usare il tasto sulla destra e cercare la cartella in cui si vuole salvare il mapfile.
\\

\textbf{Progetto QGIS}
 & 
Inserire il percorso del file di progetto di QGIS (.qgs) che si vuole esportare. Si può anche utilizzare il pulsante sulla destra e selezionare il file manualmente.
\\

\textbf{Nome mappa}
 & 
Un nome per la mappa. Questo nome è usato come prefisso per tutte le immagini generate dal mapserver.
\\

\textbf{Larghezza mappa}
 & 
Larghezza dell’immagine di output in pixel.
\\

\textbf{Altezza della mappa}
 & 
Altezza dell’immagine di output in pixel.
\\

\textbf{Unità della mappa}
 & 
Unità di misura per l’output.
\\

\textbf{Tipo di immagine}
 & 
Formato dell’immagine di output generata da MapServer
\\

\textbf{Modello}
 & 
Percorso completo al template Mapserver che sarà usato con il mapfile
\\

\textbf{Titolo}
 & 
Percorso completo al file intestazione di Mapserver che sarà usato con il mapfile
\\

\textbf{Piè di pagina}
 & 
Percorso completo al file piè di pagina di Mapserver che sarà usato con il mapfile
\\
\hline\end{tabulary}


Soltanto \emph{Map file} e \emph{progetto QGIS} ono richiesti per creare un mapfile, tuttavia omettendo gli altri parametri ci si potrebbe ritrovare con un mapfile non funzionante. Nonostante QGIS sia capace di creare un mapfile da un file di progetto, potrebbe essere necessario qualche successivo aggiustamento per raggiungere il risultato ottimale. Nell’esempio che segue, viene mostrato come creare un mapfile a partire dal progetto \code{mapserverproject.qgs} precedentemente salvato (figura {\hyperref[docs/user_manual/plugins/plugins_mapserver_export:figure-mapserver-export-2]{Figure\_mapserver\_export\_2}}):
\begin{enumerate}
\item {} 
Aprire la finestra di dialogo Esporta per MapServer cliccando sull'icona \includegraphics{mapserver_export.png} $^{\text{MapServer Export}}$ (vedi figura {\hyperref[docs/user_manual/plugins/plugins_mapserver_export:figure-mapserver-export-2]{Figure\_mapserver\_export\_2}}).

\item {} 
Assegnare il nome (e.g., \code{qgisproject.map}) al nuovo mapfile.

\item {} 
Selezionare il progetto QGIS (es. \code{mapserverproject.qgs}) precdentemente salvato.

\item {} 
Assegnare un nome alla mappa (es. \code{MyMap}).

\item {} 
Inserire la larghezza e l'altezza (es. \code{600} per la larghezza e \code{400} per l'altezza).

\item {} 
Impostare le unità di misura in metri.

\item {} 
Scegliere \emph{png} come tipo di immagine.

\item {} 
Cliccare su \textbf{{[}OK{]}} per generare il mapfile \code{qgisproject.map}.

\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}

Si può visualizzare il mapfile con qualsiasi editor o visualizzatore di testo. Se si apre il file, si noterà che lo strumento d’esportazione aggiunge i metadati necessari per rendere il nostro servizio web compatibile con le specifiche WMS.

\index{shp2img}\index{FWTools}

\subsection{Risoluzione dei problemi}
\label{docs/user_manual/plugins/plugins_mapserver_export:troubleshooting}\label{docs/user_manual/plugins/plugins_mapserver_export:index-2}
Se si riceve un errore da mapserver del tipo:

\begin{Verbatim}[commandchars=\\\{\}]
loadSymbolSet(): Unable to access file. (./symbols/symbols.txt)
\end{Verbatim}

oppure:

\begin{Verbatim}[commandchars=\\\{\}]
msLoadFontset(): Unable to access file. Error opening fontset ./fonts/fonts.txt.
\end{Verbatim}

Significa che sono stati usati font o simboli nel mapfile che Mapserver non è in grado di decodificare.

Si possono commentare le linee contenenti gli errori (possibile se non sono presenti etichette oppure usando stili provenienti da \code{symbols.txt}). Oppure si possono creare questi file (vedi sotto).

Il semplice file \code{fonts.txt} (arial è usato nei mapfile generati da QGIS) contenente la seguente linea

\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}

Il semplice file \code{symbols.txt} file contenente la definizione di un simbolo circolare (perché un simbolo circolare è usato per i layer di punti)

\begin{Verbatim}[commandchars=\\\{\}]
SYMBOLSET
    SYMBOL
    NAME "circle"
    TYPE ellipse
    FILLED true
    POINTS
    1 1
    END
    END
END
\end{Verbatim}


\subsection{Testare il File Mappa}
\label{docs/user_manual/plugins/plugins_mapserver_export:testing-the-map-file}
E' possibile testare il lavoro.

Se il mapfile è accessibile da un server cgi, si può usare uno degli url della finestra di dialogo.

Un'altra opzione è usarelo strumento \textbf{shp2img} per creare un’immagine dal mapfile. \textbf{shp2img} è parte di MapServer e FWTools. Per creare un’immagine dalla mappa:
\begin{itemize}
\item {} 
Aprire un terminale

\item {} 
Navigare nella cartella cui è stata salvato il mapfile.

\item {} 
Lanciare \code{shp2img -m qgisproject.map -o mapserver\textbackslash{}\_test.png} e visualizzare l'immagine

\end{itemize}

Il comando crea un file PNG con tutti i layer inclusi nel progetto QGIS: l’estensione spaziale dell’immagine sarà la stessa di quella del progetto. Come si vede in Figura {\hyperref[docs/user_manual/plugins/plugins_mapserver_export:figure-mapserver-export-4]{figure\_mapserver\_export\_4}}, tutte le informazioni eccetto i simboli degli aeroporti sono incluse.
\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{Usare il mapfile}
\label{docs/user_manual/plugins/plugins_mapserver_export:using-map-file}
Se si prevede di usare il mapfile per richieste WMS standard, probabilmente non sarà necessario alcun adattamento. Se invece si prevede di usarlo con un modello di mappa o un’interfaccia personalizzata, potrebbe essere necessario del lavoro manuale. Per vedere come è facile utilizzare QGIS per offrire servizi di webmapping, si veda il video di Christopher Schmidt \href{http://openlayers.org/presentations/mappingyourdata/}{flash video}. Egli usa una vecchia versione di QGIS (0.8), ma le operazioni sono facilmente adattabili ad una qualsiasi versione più nuova.


\section{Plugin Offline Editing}
\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}
In progetti di acquisizione dati è situazione comune trovarsi a lavorare sul campo con computer portatili e palmari: i dati in tal modo acquisiti vanno, poi, sincronizzati con la banca dati principale, es. un database PostGIS. Se più persone lavorano simultaneamente sullo stesso set di dati, risulta difficile aggiornare la banca dati principale manualmente.

Il plugin \includegraphics[width=1.5em]{offline_editing_copy.png} $^{\text{Offline Editing}}$ permette di automatizzare l’attività di sincronizzazione, copiando il contenuto della banca dati principale (solitamente un database PostGIS o un WFS-T) in un database Spatialite e memorizzando le modifiche non in linea in tabelle dedicate: le modifiche, poi, vengono sincronizzate una volta riconnessi alla rete.


\subsection{Utilizzo del plugin}
\label{docs/user_manual/plugins/plugins_offline_editing:using-the-plugin}\begin{itemize}
\item {} 
Aprire alcuni layer vettoriali, es. da PostGIS o da un WFS-T

\item {} 
Salvare il progetto

\item {} 
Cliccare su \includegraphics[width=1.5em]{offline_editing_copy.png} $^{\text{Converti ad un progetto offline}}$ e selezionare i layer da salvare. Il contenuto dei layer viene salvato in una tabella SpatiaLite.

\item {} 
Modificare il layer in modalità non in linea.

\item {} 
Riconnettersi alla rete e caricare le modifiche con \includegraphics[width=1.5em]{offline_editing_sync.png} $^{\text{Sincronizza}}$.

\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{Plugin Oracle Spatial GeoRaster}
\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}
Nei database Oracle i dati raster possono essere gestiti come oggetti SDO\_GEORASTER messi a disposizione dall’estensione Oracle Spatial. In QGIS il \includegraphics[width=1.5em]{oracle_raster.png} $^{\text{Plugin Oracle Geo Raster}}$ è supportato da GDAL e le sue funzionalità dipendono dal database Oracle installato sulla propria macchina. Il software Oracle è proprietario, sebbene il suo utilizzo sia libero per attività di sviluppo e test. Il comando seguente:

\begin{Verbatim}[commandchars=\\\{\}]
\$ gdal\_translate -of georaster input\_file.tif geor:scott/tiger@orcl
\end{Verbatim}

carica un raster nella tabella predefinita GDAL\_IMPORT in una colonna con nome \code{RASTER}.


\subsection{Gestire le connessioni}
\label{docs/user_manual/plugins/plugins_oracle_raster:managing-connections}
Assicurarsi che il plugin sia abilitato nel gestore dei plugin (Sezione {\hyperref[docs/user_manual/plugins/plugins:load-core-plugin]{\emph{Abilitare un Plugin Core}}}). Prima di caricare un GeoRaster bisogna creare una connessione al database Oracle contente i dati: L’icona \includegraphics[width=1.5em]{oracle_raster.png} $^{\text{Aggiungi layer Oracle GeoRaster}}$ nella barra dei plugin apre la finestra di dialogo \emph{Scegli Oracle Spatial GeoRaster}. In Connessioni server cliccare su \textbf{{[}Nuovo{]}} ed inserire i parametri di connessione al database (figura {\hyperref[docs/user_manual/plugins/plugins_oracle_raster:figure-oracle-raster-1]{Figure\_oracle\_raster\_1}}):
\begin{itemize}
\item {} 
\textbf{Nome}: inserire un nome per la connessione

\item {} 
\textbf{Istanza database}: inserire in nome del database cui si intende connettersi

\item {} 
\textbf{Nome utente}: inserire il nome utente

\item {} 
\textbf{Password}: inserire la password

\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}

Cliccando su \textbf{{[}OK{]}}  parametri della connessione vengono salvati e si ritorna nella finestra di dialogo per la scelta del georaster (figura {\hyperref[docs/user_manual/plugins/plugins_oracle_raster:figure-oracle-raster-2]{Figure\_oracle\_raster\_2}}), Selezionare la connessione appena impostata e cliccare su \textbf{{[}Connetti{]}} per modificare la connessione cliccare su \textbf{{[}Modifica{]}}, per rimuoverla cliccare su \textbf{{[}Elimina{]}}.


\subsection{Selezionare un GeoRaster}
\label{docs/user_manual/plugins/plugins_oracle_raster:selecting-a-georaster}
Stabilita la connessione, il riquadro ’Sottoinsieme di dati’ elencherà le tabelle del database contenenti colonne georaster compatibili con GDAL.

Selezionare una tabella con il mouse e cliccare su \textbf{{[}Seleziona{]}}: apparirà un nuovo elenco con i nomi delle colonne GeoRaster della tabella selezionata.

Selezionare una colonna con il mouse e cliccare su \textbf{{[}Seleziona{]}}: apparirà un nuovo elenco contenente gli oggetti GeoRaster.

In ogni momento è possibile modificare la selezione per raggiungere direttamente un GeoRaster noto o per selezionare un’altra tabella.
\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}

Il testo mostrato nella casella ’Selezione’ può essere usato in una clausola SQL WHERE, es: \code{geor:scott/tiger@orcl,gdal\_import,raster,geoid=}. Si veda \href{http://www.gdal.org/frmt\_georaster.html}{http://www.gdal.org/frmt\_georaster.html} per ulteriori informazioni.


\subsection{Visualizzare un GeoRaster}
\label{docs/user_manual/plugins/plugins_oracle_raster:displaying-georaster}
Selezionando un GeoRaster dalla lista appena descritta, esso sarà visualizzato in QGIS.

La finestra di dialogo \emph{Scegli Oracle Spatial GeoRaster} per la scelta dei georaster può ora essere chiusa: riaprendola, essa mostrerà la medesima connessione e lo stesso elenco di georaster, rendendo semplice la scelta di una nuova immagine dallo stesso contesto.

\begin{notice}{note}{Nota:}
I GeoRaster con piramidi vengono visualizzati molto più rapidamente. Le piramidi possono essere
generate con Oracle PL/SQL oppure con gdaladdo.
\end{notice}

Segue un esempio di utilizzo di \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}

Questo è, invece, un esempio con 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{Plugin Analisi geomorfologica}
\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}
\includegraphics[width=1.5em]{dem.png} Il plugin Analisi geomorfologica (Raster Terrain Modelling) consente di calcolare la pendenza, l’esposizione, l’indice di asperità e la curvatura totale da un DEM (Digital Elevation Model). È semplice da usare grazie ad un’interfaccia grafica intuitiva: i risultati dell’analisi sono salvati in un nuovo layer raster (Figura {\hyperref[docs/user_manual/plugins/plugins_raster_terrain:figure-raster-terrain-1]{Figure\_raster\_terrain\_1}}).

Descrizione delle analisi:
\begin{itemize}
\item {} 
\textbf{Pendenza}: calcola l’angolo di pendenza per ogni cella espresso in gradi.

\item {} 
\textbf{Esposizione}: 0 gradi per nord e continuando in senso orario.

\item {} 
\textbf{Ombreggiatura}: crea una mappa dell'ombreggiatura del terreno con un effetto tridimensionale fornito dal gioco luce - ombra.

\item {} 
\textbf{Indice di asperità}: una misura quantitativa dell’eterogeneità del terreno descritta da Riley et al (1999). Viene calcolata per ogni area sommando il cambiamento di elevazione all'interno della griglia di pixel 3x3.

\item {} 
\textbf{Rilievo}: cra una mappa di ombreggiatura partendo da un DEM. E' implementato un metodo che permette di scegliere i colori dell'elevazione analizzando la distribuzione delle frequenze.

\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{Usare il plugin}
\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 {} 
Avviare QGIS e caricare il file raster \code{gtopo30} dalla location di GRASS.

\item {} 
Caricare il plugin Analisi geomorfologica dal Gestore plugin (sezione {\hyperref[docs/user_manual/plugins/plugins:load-core-plugin]{\emph{Abilitare un Plugin Core}}})

\item {} 
Selezionare un metodo di analisi dal menu (es. \emph{Raster \(\rightarrow\) Analisi geomorfologica \(\rightarrow\) Pendenza}). Si aprirà cosi la finestra di dialogo \emph{Pendenza} come in figura {\hyperref[docs/user_manual/plugins/plugins_raster_terrain:figure-raster-terrain-1]{Figure\_raster\_terrain\_1}}.

\item {} 
Specificare nome, percorso e formato del file di output.

\item {} 
Cliccare su \textbf{{[}OK{]}}.

\end{enumerate}


\section{Plugin Mappa di concentrazione}
\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}
Il plugin \includegraphics[width=1.5em]{heatmap.png} $^{\text{Mappa di concentrazione}}$ permette di creare una mappa di concentrazione partendo da un layer di punti. Una mappa di concentrazione è una mappa raster di densità o di magnitudo dell'informazione selezionata. Il risultato permette di identificare facilmente degli ``hotspots''.


\subsection{Attivare il plugin Mappa di concentrazione}
\label{docs/user_manual/plugins/plugins_heatmap:activate-the-heatmap-plugin}
Prima di poter essere utilizzato, il plugin deve essere attivato dal Gestore plugin (sezione {\hyperref[docs/user_manual/plugins/plugins:load-core-plugin]{\emph{Abilitare un Plugin Core}}}). Dopo l'attivazione l'icona \includegraphics[width=1.5em]{heatmap.png} è accessibile dalla barra degli strumenti Raster.

Se non è già presente, attivare la barra degli strumenti Raster dal menu \emph{Vista \(\rightarrow\) Barra degli strumenti \(\rightarrow\) Raster}.


\subsection{Utilizzo del plugin}
\label{docs/user_manual/plugins/plugins_heatmap:using-the-heatmap-plugin}
Il pulsante \includegraphics[width=1.5em]{heatmap.png} $^{\text{Mappa di concentrazione}}$ fa partire il plugin (figura {\hyperref[docs/user_manual/plugins/plugins_heatmap:figure-heatmap-2]{figure\_heatmap\_2}}).

La finestra di dialogo ha le seguenti opzioni:
\begin{itemize}
\item {} 
\textbf{Vettore punti in input}: permette di selezionare il vettore di punti.

\item {} 
\textbf{Output Raster}: si può scegliere la cartella e il nome della mappa raster di concentrazione usando il pulsante \includegraphics{browsebutton.png}. Non è necessario specificare l'estensione del file

\item {} 
\textbf{Formato in output}: specifica il formato in output. Nonostante siano presenti tutti i formati supportati da GDAL, il formato GeoTIFF è in molti casi la scelta migliore.

\item {} 
\textbf{Raggio}: permette di scegliere il raggio di azione in metri o in unità di mappa. Se il raggio è troppo piccolo, il risultato non sarà ottimale. Nelle zone dove si sovrappongono i cerchi, è possibile invece cedere chiaramente gli hotspots.

\item {} 
\textbf{Decay Ratio}: serve per impostare il tasso con il quale la concentrazione decade rispetto al centro.
\begin{itemize}
\item {} 
Se si imposta 0 (valore minimo) la concentrazione è massima nel centro e scompare completemente sui bordi.

\item {} 
Se si imposta 10 (valore massimo) la concentrazione è massima ai bordi ed è completamente assente nel centro. E' possibile inserire valori più alti, ma non ci saranno altri effetti.

\item {} 
Se si imposta 1 la concentrazione è equamente distribuita in tutto il cerchio.

\item {} 
Se si imposta un valore negativo, verrà generata l'opposto di una mappa di concentrazione!

\end{itemize}

\end{itemize}

Se si attiva la casella di controllo \includegraphics{checkbox.png} \emph{Avanzato} si avrà accesso a diverse opzioni avanzate.
\begin{itemize}
\item {} 
\textbf{Riga} e \textbf{Colonna} possono essere utlizzate per cambiare la dimensione dei pixel della mappa in output. Impostando un numero maggiore di righe e colonne la dimensione dei pixel diminuisce e di coseguenza aumenta la dimensione della mappa. L'elaborazione richiede più tempo. Raddoppiando il numero delle righe verrà automaticamente raddoppiato il numero delle colonne e quindi la dimensione delle celle risulterà essere dimezzata. Infatti l'area di output del raster rimane la stessa!

\item {} 
\textbf{Cell Size X} e \textbf{Cell Size Y} influenzano la dimensione dei pixel in output e quindi cambierà anche il numero di righe e di colonne.

\end{itemize}

Il layer di punti può avere degli attributi che possono essere usati per creare una mappa di concentrazione:
\begin{itemize}
\item {} 
\textbf{Use Radius from Field}: il raggio viene determinato da un campo degli attributi.

\item {} 
\textbf{Use Weight from field}: serve per impostare il peso dalla tabella degli attributi.

\end{itemize}

Una volta dato il raster di outpur, premere \textbf{{[}OK{]}} per creare la mappa di concentrazione. Il primo risultato è una mappa grigia che necessita di modifiche affinché il risultato sia ottimale.

\begin{notice}{warning}{Avvertimento:}
\textbf{Cambiare le proprietà dimensionali del raster}

Cambiando le dimensioni dei pixel, cambia anche l'output finale. Gli hotspot saranno più grandi.
\end{notice}


\subsection{Creare una Mappa di concentrazione}
\label{docs/user_manual/plugins/plugins_heatmap:creating-a-heatmap}
Per questo esempio verrà usato il layer di punti \code{airports} presente nel dataset di esempio di QGIS (vedi {\hyperref[docs/user_manual/introduction/getting_started:label-sampledata]{\emph{Dati campione}}}). Si può trovare un altro ottimo tutorial sulla creazione di mappe di concentrazione all'indirizzo \href{http://qgis.spatialthoughts.com/2012/07/tutorial-making-heatmaps-using-qgis-and.html}{http://qgis.spatialthoughts.com}.

In figura {\hyperref[docs/user_manual/plugins/plugins_heatmap:figure-heatmap-1]{Figure\_Heatmap\_1}} sono visualizzati gli aeroporti dell'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 {} 
Premere il pulsante \includegraphics[width=1.5em]{heatmap.png} $^{\text{Mappa di concentrazione}}$ per aprire la finestra di dialogo (vedi {\hyperref[docs/user_manual/plugins/plugins_heatmap:figure-heatmap-2]{Figure\_Heatmap\_2}}).

\item {} 
Nel campo \emph{Vettore punti in input} \includegraphics{selectstring.png} selezionare \code{airpoirt} dalla lista dei layer presenti nel progetto.

\item {} 
Nel campo \emph{Output Raster} scegliere il nome e la posizione del raster in output usando il pulsante \includegraphics{browsebutton.png}. Inserire il nome \code{heatmap\_airports} senza aggiunger un'estensione al file.

\item {} 
Selezionare \code{GeoTIFF} nel campo \emph{Formato in output}.

\item {} 
Inserire \code{1000000} metri come \emph{Raggio}.

\item {} 
Il valore predefinto \code{0.1} per il \emph{Decay Ratio} è perfetto.

\item {} 
Cliccare su \textbf{{[}OK{]}}  per creare la nuova mappa raster (figura {\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}

Probabilmente il risultato caricato non è quello che ci si aspettava; infatti è solo una superficie grigia e non sembra esserci nessuna tendenza. E' necessario effetturare alcune configurazioni sul layer per rendere presentabile la mappa di concentrazione.
\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 {} 
Aprire la finestra delle priprietà del layer \code{heatmap\_airports} (selezionare il layer \code{heatmap\_airports}, fare click con il tasto desto e scegliere \emph{Proprietà}).

\item {} 
Selezionare la scheda \emph{Simbologia}.

\item {} 
Cambiare la \emph{Mappa colore} \includegraphics{selectstring.png} da `Grayscale' a `Pseudocolor'.

\item {} 
Premere il pulsante \textbf{{[}Applica{]}}.

\item {} 
Cliccare sulla scheda \emph{Trasparenza} e impostare la \emph{Trasparenza globale} \includegraphics{slider.png} al 40\%.

\item {} 
Premere \textbf{{[}OK{]}}

\end{enumerate}

Il risultato finale è mostrato nella figura {\hyperref[docs/user_manual/plugins/plugins_heatmap:figure-heatmap-4]{Figure\_Heatmap\_4}}.
\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{Plugin grafo strade}
\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}
Il plugin Road Graph è un plugin scritto in C++ che calcola il percorso minimo tra punti su una polilinea e traccia tale percorso sul grafo delle strade.
\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}

Caratteristiche principali:
\begin{itemize}
\item {} 
Calcola il percorso, la sua lunghezza ed il tempo di percorrenza

\item {} 
Ottimizza la lunghezza ed il tempo di percorrenza

\item {} 
Esporta il percorso in un layer vettoriale

\item {} 
Evidenzia la direzione delle strade (tale funzionalità è lenta e dovrebbe essere usata solo in fase di test)

\end{itemize}

Come layer di strade è possibile usare un layer vettoriale di polilinee in uno dei formati supportati da QGIS. Due linee con un punto in comune vengono considerate connesse. Si noti che è richiesto di impostare il SR del progetto sul SR del layer qualora si intenda modificare quest’ultimo: il ricalcolo delle coordinate in differenti SR introduce degli errori che inficiano la qualità dei dati, anche se si opera con lo snap attivato.

Nella tabella degli attributi del layer si possono usare i seguenti campi:
\begin{itemize}
\item {} 
Velocità su sezione di strada — numerico

\item {} 
Direzione — testo (avanti, inversa, a doppio senso)

\end{itemize}

Se alcuni campi non hanno valori, o non esistono, vengono utilizzati dei valori predefiniti. Si possono cambiare alcune impostazioni predefinite nel menu impostazioni del plugin.


\subsection{Utilizzo del plugin}
\label{docs/user_manual/plugins/plugins_road_graph:using-the-plugin}
Una volta caricato il plugin, impostarne le opzioni nella finestra di dialogo \emph{Impostazioni del pugin grafo strade dal menu :menuselection:{}`Vettore --\textgreater{} Grafo strade}.

Selezionare un punto di partenza ed un punto di arrivo sul grafo delle strade e cliccare su \textbf{{[}Calcola{]}}.


\section{Plugin Spatial Query}
\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}
Il plugin \includegraphics[width=1.5em]{spatialquery.png} $^{\text{Spatial Query}}$ permette di definire una query spaziale di selezione in un layer target con riferimento ad un altro layer. La funzionalità si basa sulla libreria GEOS e dipende dalle caratteristiche del layer selezionato.

Gli operatori spaziali sono:
\begin{itemize}
\item {} 
Contiene

\item {} 
E' uguale a

\item {} 
Sovrappone

\item {} 
Attraversa

\item {} 
Interseca

\item {} 
E' disgiunto

\item {} 
Tocca

\item {} 
E' contenuto

\end{itemize}


\subsection{Come usare il plugin}
\label{docs/user_manual/plugins/plugins_spatial_query:using-the-plugin}
L’esempio che segue mostra come individuare le regioni dell’Alaska che contengono degli aeroporti:
\begin{enumerate}
\item {} 
Avviare QGIS e caricare i layer vettoriali \code{regions.shp} e \code{airports.shp}.

\item {} 
Caricare il plugin Spatial Query dal Gestore plugin (sezione {\hyperref[docs/user_manual/plugins/plugins:load-core-plugin]{\emph{Abilitare un Plugin Core}}}) e cliccare sull'icona \includegraphics[width=1.5em]{spatialquery.png} $^{\text{Spatial Query}}$ nella barra degli strumenti plugin: si aprirà cosi la finestra di dialogo Interrogazione spaziale.

\item {} 
Selezionare regions come sorgente degli oggetti e airports come riferimento.

\item {} 
Selezionare ’Contiene’ come operatore e cliccare su \textbf{{[}Apply{]}}.

\end{enumerate}

A questo punto appare un riquadro che elenca gli ID degli elementi che soddisfano la query; si hanno diverse opzioni per utilizzare i risultati come si può vedere dalla figura {\hyperref[docs/user_manual/plugins/plugins_spatial_query:figure-spatial-query-1]{figure\_spatial\_query\_1}}.
\begin{itemize}
\item {} 
Cliccare su \includegraphics[width=1.5em]{selectesubsetlayer.png} $^{\text{Crea layer con lista di oggetti}}$

\item {} 
Selezionare un elemento dalla lista e cliccare \includegraphics[width=1.5em]{selectcreatelayer.png} $^{\text{Crea layer con selezionato}}$

\item {} 
Selezionare `Rimuovi dalla sessione corrente' nel campo \emph{E usa il risultato per} \includegraphics{selectstring.png}.

\item {} 
Opzionalmente è possibile selezionare le caselle di controllo \includegraphics{checkbox.png} \emph{Zoom all'oggetto} e \includegraphics{checkbox.png} \emph{Messaggi di log}.

\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{Plugin 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 include un plugin denominato SPIT (Shapefile to PostGIS Import Tool). SPIT può essere usato per caricare più shapefile contemporaneamente e include il supporto per gli schemi. Per usare SPIT, aprire il gestore dei plugin dal menu \emph{Plugin}, selezionare la casella di controllo \includegraphics{checkbox.png} \emph{SPIT} and click \textbf{{[}OK{]}}. L’icona di SPIT verrà aggiunta alla barra degli strumenti plugin.

Per importare uno shapefile, cliccare sull’icona \includegraphics{spiticon.png} $^{\text{SPIT}}$ nella barra degli strumenti per aprire la finestra di dialogo \emph{SPIT - Shapefile to PostGIS Import Tool} . Selezionare il database PostGIS al quale si desidera connettersi e cliccare su \textbf{{[}Connetti {]}}. Ora è possibile aggiungere uno o più file alla coda cliccando su \textbf{{[}Aggiungi{]}}. Per processare i file selezionati, cliccare su \textbf{{[}OK{]}}. L’avanzamento dell’importazione ed eventuali errori/avvertimenti saranno mostrati mentre ciascuno shapefile viene elaborato.
\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}{Suggerimento:}
\textbf{Importare shapefile contenenti parole riservate in PostgreSQL}

Se alla coda d’importazione viene aggiunto uno shapefile contenente campi con parole riservate per il database PostgreSQL, comparirà una finestra di dialogo che darà informazioni sullo stato di ogni campo. È necessario modificare i nomi dei campi contenenti tali parole (ed è possibile eventualmente editare anche il nome degli altri campi) prima dell’importazione, altrimenti il processo di importazione non andrà a buon fine.
\end{notice}


\section{Plugin 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 è un database relazionale proprietario (RDBMS) prodotto da Sybase. Fornisce supporto ai dati geospaziali, es. OGC e shapefile, e consente di esportare nei formati KML, GML e 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}

Il fornitore dati SQL Anywhere \includegraphics[width=1.5em]{sqlanywhere.png} $^{\text{SQL Anywhere}}$ presente in QGIS è rilasciato con licenza GPL v3. La finestra di dialogo \emph{Aggiungi un layer SQL Anywhere} è simile a quella di PostGIS e a quella SpatiLite.


\section{Plugin Statistica zonale}
\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}
Con il plugin \includegraphics[width=1.5em]{raster-stats.png} $^{\text{Stastica zonale}}$ è possibile di analizzare i risultati di una classificazione tematica. Il plugin permette di calcolare diversi valori dei pixel di un raster con l'aiuto di un layer vettoriale di poligoni(figura {\hyperref[docs/user_manual/plugins/plugins_zonal_statistics:figure-zonal-statistics]{figure\_zonal\_statistics}}). E' possibile calcolare la somma, la media e il numero totale dei pixel che ricadono dentro un poligono. Il plugin crea una colonna aggiuniva con un prefisso predefinito nella tabella degli attributi del layer vettoriale.
\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{Aiuto e supporto}
\label{docs/user_manual/preamble/help_and_support:help-and-support}\label{docs/user_manual/preamble/help_and_support::doc}

\section{Le Mailing list}
\label{docs/user_manual/preamble/help_and_support:mailing-lists}\label{docs/user_manual/preamble/help_and_support:label-helpsupport}
QGIS è in continuo sviluppo e, come tale, non funzionerà sempre come ci si aspetta. Il miglior modo di ottenere aiuto è unirsi a una mailing list di qgis. Le vostre domande raggiungeranno una audience più ampia e le risposte ottenute saranno anche a beneficio di altri.


\subsection{qgis-users}
\label{docs/user_manual/preamble/help_and_support:qgis-users}
Questa mailing list è usata per discussioni su QGIS in generale, così come per domande specifiche sulla sua installazione ed uso. Potere sottoscrivere la maling list qgis-users al seguente URL: \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}
Per l'utenza di lingua tedesca, FOSSGIS e.V. mette a disposizione la mailing list fossgis-talk-liste. Questa mailing list è usata per discussioni sul GIS open source in generale, incluso QGIS. Potete sottoscrivere la mailing list fossgis-talk-liste al seguente URL: \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}
Gli sviluppatori con problemi di natura più tecnica possono unirsi alla mailing list qgis-developer andando qui: \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}
Ogni volta che viene inserito un `commit' al codice di QGIS, viene inviata una email a questa mailing list. Se desiderate essere aggiornati su ogni cambiamento all'attuale codice, potete sottoscrivere questa mailing lista all'URL: \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}
Questa mailing list notifica email collegate alla gestione del progetto, inlcusi i bug report, i compiti assegnati e le richieste di nuove caratteristiche. Potete sottoscriverla all'URL: \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}
Questa mailin list si occupa di argomenti come la documentazione, l'aiuto contestuale, la guida utente, l'esperienza d'uso online inclusi i siti web, e i lavori di traduzione. Se volete lavorare anche sulla guida utente, questa mailing list è un buon punto di partenza per fare le vostre domande. Potete sottoscriverla all'URL:  \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}
Questa mailing list si occupa di argomenti quali il processo di rilascio, i pacchetti binari per i vari sistemi operativi e l'annuncio delle nuove release in generale. Potete sottoscriverla all'URL: \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}
Questa lista si occuopa delle traduzioni. Chi desidera lavorare alla traduzione dei manuali o dell'intefaccia grafica (GUI) trova in questa lista un buon punto di partenza per le proprie domande. La lista può essere sottoscritta all'URL \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}
Questa lista si occupa degli aspetti educativi di QGIS. Chi desidera lavorare su materiali educativi trova un questa lista un buon punto di partenza per le proprie domande. Può essere sottoscritta all'URL \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}
Questa mailing list viene usata per discutere argomenti relativi al Comitato di Coordinamento e alla gestione complessiva di Quantum GIS. Potete sottoscriverla all'URL: \href{http://lists.osgeo.org/mailman/listinfo/qgis-psc}{http://lists.osgeo.org/mailman/listinfo/qgis-psc}

Siete invitati a sottoscrivere qualunque mailing list desideriate fra queste. Ricordate che potete contribuire rispondendo alle domande e condividendo le vostre esperienze. Notate che le mailing list qgis-commit e qgis-trac sono riservate alle sole notifiche e non sono dedicate allo scambio di comunicazioni fra gli utenti.


\section{IRC}
\label{docs/user_manual/preamble/help_and_support:irc}
Siamo anche presenti su IRC - ci si può registrare al canale \#qgis su irc.freenode.net. Per favore, aspettate pazientemente le risposte alle vostre domande, dato che molte persone sul canale IRC sono al lavoro su altre cose, e potrebbero impiegare un po' di tempo prima di notare la vostra richiesta. E' inoltre disponibile un supporto commerciale a QSIG. Per maggiori informazioni, visitate il sito web \href{http://qgis.org/en/commercial-support.html}{http://qgis.org/en/commercial-support.html} .

Se avete perso una discussione su IRC, non c'è problema! Noi registriamo tutte le discussioni, cosicchè possiate mettervi in pari semlicemente leggendo i log salvati su \href{http://logs.qgis.org}{http://logs.qgis.org} .


\section{BugTracker}
\label{docs/user_manual/preamble/help_and_support:bugtracker}
Sebbene la mailing list qgis-users sia utile per domande del tipo `come si fa XYZ su QGIS', potreste volerci comunicare qualche bug. Potete inviare le vostre segnalazioni utilizzando il bug tracker di QGIS, all'URL \href{http://hub.qgis.org/projects/quantum-gis/issues}{http://hub.qgis.org/projects/quantum-gis/issues}. Nql creare un nuovo ticket, per favore fornite anche un indirizzo email al quale potervi contattare per ulteriori informazioni.

Ricordate che un bug da voi segnalato potrebbe ricevere una priorità diversa da quella che vi aspettereste (a seconda della serietà del problema). Alcuni errori richiedono un significativo sforzo allo sviluppatore e non sempre ci sono abbastanza risorse umane disponibili.

Le richieste per nuove caratteristiche possono essere sottoposte tramite lo stesso sistema di segnalazioni usato per i bug. Assicuratevi di aver prima selezionato il tipo \code{Feature}.

Se doveste aver trovato il modo di risolvere un errore da voi individuato, potete sottomettere anche la relativa patch. Anche qui, il sistema di segnalazione presente in \href{http://hub.qgis.org/projects/quantum-gis/issues}{http://hub.qgis.org/projects/quantum-gis/issues} ha una sezione dedicata. Selezionate \code{Patch supplied} e allegate la vostra patch prima di sottomettere l'errore. Uno sviluppatore la verificherà e la applicherà a QGIS. Non è il caso di allarmarsi se la patch non viene subito applicata --- gli sviluppatori potrebbero essere impegnati con altre priorità.


\section{Blog}
\label{docs/user_manual/preamble/help_and_support:blog}
LA comunità QGIS ha anche un blog all'URL \href{http://www.qgis.org/planet}{http://www.qgis.org/planet} che contiene articoli interessanti per utenti e sviluppatori. Siete tutti invitati a contribuire!


\section{Plugins}
\label{docs/user_manual/preamble/help_and_support:plugins}
Il sito web \href{http://plugins.qgis.org}{http://plugins.qgis.org} è il portale ufficiale per i plugin QGIS. Qui si può trovare una lista di tutti i plugin stabili e sperimentali disponibili tramite il `Repository Ufficiale dei Plugin di QGIS'.


\section{Wiki}
\label{docs/user_manual/preamble/help_and_support:wiki}
Infine, è disponibile una WIKI al sito \href{http://hub.qgis.org/projects/quantum-gis/wiki}{http://hub.qgis.org/projects/quantum-gis/wiki} dove'è possibile trovare un assortimento di informazioni utili sullo sviluppo di QGIS e sui piani di rilascio, collegamenti ai siti per il download, suggerimenti per le traduzioni e così via. Visitatelo, troverete molte cose utili!


\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{Literature and Web References}
\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}{Indice}
\printindex
\end{document}
