QGIS User Guide 1.7 - en to it translation catalogue (61 entries)

en: The SEXTANTE graphical modeler
it: Il modellatore grafico di SEXTANTE

en: Introduction
it: Introduzione

en: The *graphical modeler* allows to create complex models using a simple and easy-to-use interface. When working with a GIS, most analysis operations are not isolated, but part of a chain of operations instead. Using the graphical modeler, that chain of processes can be wrapped into a single process, so it is easier and more convenient to execute than a single process later on a different set on inputs. No matter how many steps and different algorithms it involves, a model is executed as a single algorithm, thus saving time and effort, specially for larger models.
it: Il *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.

en: The modeler can be opened from the :menuselection:`SEXTANTE` menu, but also from the toolbox. In the :guilabel:`Modeler` branch of the algorithms tree you will find a group named :guilabel:`Tools`, which contains an entry called :guilabel:`Create new model`.
it: Il modellatore può essere aperto dal menu :menuselection:`SEXTANTE`, ma anche dalla cassetta degli attrezzi. Nel ramo :guilabel:`Modellatore` dell'albero degli algoritmi troverete un gruppo denominato :guilabel:`Attrezzi` che contiene una opzione chiamata :guilabel:`Crea un nuovo modello`.

en: The modeler has a working canvas where the structure of the model and the workflow it represents are shown. On the left part of the window, a panel with two tabs can be used to add new elements to the model.
it: 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.

en: Creating a model involves two steps:
it: La creazione di un modello comporta due passaggi:

en: Definition of necessary inputs*. These inputs will be added to the parameters window, so the user can set their values when executing the model. The model itself is a SEXTANTE algorithm, so the parameters window is generated automatically as it happens with all the algorithms included in SEXTANTE.
it: 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.

en: Definition of the workflow. Using the input data of the model, the workflow is defined adding algorithms and selecting how they use those inputs or the outputs generated by other algorithms already in the model.
it: 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.

en: Definition of inputs
it: Definizione dei dati di ingresso

en: The first step to create a model is to define the inputs it needs. The following elements are found in the *Inputs* tabs on the left side of the modeler window:
it: Il primo passo per creare un modello è definire i dati in ingresso di cui necessita. Nella casella *inputs* alla sinistra della finestre del modellatore si trovano questi elementi:

en: Raster layer
it: Layer raster

en: Vector layer
it: Layer vettoriali

en: String
it: Stringhe di testo

en: Table field
it: Campi di tabelle

en: Table
it: Tabelle

en: Numerical value
it: Valori numerici

en: Boolean value
it: Valori logici (booleani)

en: Double-clicking on any of them, a dialog is shown to define its characteristics. Depending on the parameter itself, the dialog will contain just one basic element (the description, which is what the user will see when executing the model) or more of them. For instance, when adding a numerical value, as it can be seen in the next figure, apart from the description of the parameter you have to set a default value and a range of valid values.
it: 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.

en: For each added input, a new element is added to the modeler canvas.
it: Per ogni dato di ingresso aggiunto, appare un nuovo elemento nel pannello grafico del modellatore.

en: Definition of the workflow
it: Definizione del flusso operativo

en: Once the inputs have been defined, it is time to define the algorithms to apply on them. Algorithms can be found in the :guilabel:`Algorithms` tab, grouped much in the same way as they are in the toolbox.
it: Una volta definiti i dati ingresso, occorre decidere gli algoritmi da applicare ad essi. Gli algoritmi si trovano nella casella :guilabel:`Algoritmi`, raggruppati allo stesso modo come nella cassetta degli attrezzi.

en: To add an algorithm, double-click on its name. An execution dialog will appear, with a content similar to the one found in the execution panel that SEXTANTE shows when executing the algorithm from the toolbox. the one shown next correspond to the SAGA 'Convergence index' algorithm, the same one we saw in the section dedicated to the SEXTANTE toolbox.
it: 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.

en: As you can see, some differences exist. Instead of the file output box that was used to set the filepath for output layers and tables, a simple text box is. If the layer generated by the algorithm is just a temporary result that will be used as the input of another algorithm and should not be kept as a final result, just do not edit that textbox. Typing anything on it means that the result is a final one, and the text that you supply will be the description for the output, which will be the one the user will see when executing the model.
it: 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.

en: Selecting the value of each parameter is also a bit different, since there are importante differences between the context of the modeler and the toolbox one. Let's see how to introduce the values for each type of parameter.
it: 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.

en: Layers (raster and vector) and tables. They are selected from a list, but in this case the possible values are not the layers or tables currently loaded in QGIS, but the list of model inputs of the corresponding type, or other layers or tables generated by algorithms already added to the model.
it: 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.

en: Numerical values. Literal values can be introduced directly on the textbox. But this textbox is also a list that can be used to select any of the numerical value inputs of the model. In this case, the parameter will take the value introduced by the user when executing the model.
it: 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.

en: String. Like in the case of numerical values, literal strings can be typed, or an input string can be selected.
it: Stringhe. Come nel caso dei valori numerici, si possono inserire stringhe o selezionarle (da un elenco).

en: Table field. The fields of the parent table or layer cannot be known at design-time, since they depend of the selection of the user each time the model is executed. To set the value for this parameter, type the name of a field directly in the textbox, or use the list to select a table field input already added to the model. The validity of the selected field will be checked by SEXTANTE at run-time.
it: 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.

en: Once all the parameter have been assigned valid values, click on **[OK]** and the algorithm will be added to the canvas. It will be linked to all the other elements in the canvas, whether algorithms or inputs, which provide objects that are used as inputs for that algorithm.
it: Una volta assegnati valori corretti a tutti i parametri, premete **[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.

en: Elements can be dragged to a different position within the canvas, to change the way the module structure is displayed and make it more clear and intuitive. Links between elements are update automatically.
it: 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.

en: You can run your algorithm anytime clicking on the **[Run]** button. However, in order to use it from the toolbox, it has to be saved and the modeler dialog closed, to allow the toolbox to refresh its contents.
it: Potete eseguire il vostro algoritmo in ogni momento premendo il pulsante **[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.

en: Saving and loading models
it: Salvataggio e caricamento di modelli

en: Use the **[Save]** button to save the current model and the **[Open]** one to open any model previously saved. Model are saved with the :file:`.model` extension. If the model has been previously saved from the modeler window, you will not be prompted for a filename, since there is already a file associated with that model, and it will be used.
it: Usate il pulsante **[Salvataggio]** per salvare il modello corrente ed il pulsante **[Apri]** per aprire un modello esistente. I modelli sono salvati con l'estensione :file:`.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.

en: Before saving a model, you have to enter a name and a group for it, using the text boxes in the upper part of the window.
it: Prima di salvare un modello, dovete inserire un nome ed un gruppo per esso usando le caselle di testo nella parte alta della finestra.

en: Models saved on the :file:`models` folder (the default folder when you are prompted for a filename to save the model) will appear in the toolbox in the corresponding branch. When the toolbox is invoked, SEXTANTE searches the :file:`models` folder for files with :file:`.model` extension and loads the models they contain. Since a model is itself a SEXTANTE algorithm, it can be added to the toolbox just like any other algorithm.
it: I modelli salvati nella cartella :file:`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 :file:`modelli` i file con l'estensione :file:`.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.

en: The models folder can be set from the SEXTANTE configuration dialog, under the :guilabel:`Modeler` group.
it: La cartella del modellatore può essere definita nella finestra di configurazione di SEXTANTE, sotto il gruppo :guilabel:`Modellatore`.

en: Models loaded from the models folder appear not only in the toolbox, but also in the algorithms tree in the :guilabel:`Algorithms` tab of the modeler window. That means that you can incorporate a model as a part of a bigger model, just as you add any other algorithm.
it: I modelli presenti nella cartella dei modelli appariranno non solo nella cassetta degli attrezzi, ma anche nell'albero degli algoritmi nel pannello :guilabel:`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.

en: In some cases, SEXTANTE might not be able to load a model because it cannot find all the algorithms included in its workflow. If you have used a given algorithm as part of your model, it should be available (that is, it should appear on the toolbox) in order to load that model. Deactivating an algorithm provider in the SEXTANTE configuration window renders all the algorithms in that provider unusable by the modeler, which might cause problems when loading models. Keep that in mind when you have trouble loading or executing models.
it: 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.

en: Editing a model
it: Aggiornare il modello

en: You can edit the model you are currently creating, redefining the workflow and the relationships between the algorithms and inputs that define the model itself.
it: 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.

en: If you right-click on an algorithm in the canvas representing the model, you will see a context menu like the one shown next:
it: Se premete il tasto destro del mouse su un algoritmo nel grafico che rappresenta il modello, apparirà un menu come quello sotto riportato:

en: Selecting the :guilabel:`Remove` option will cause the selected algorithm to be removed. An algorithm can be removed only if there are no other algorithms dependind on it. That is, if no output from the algorithm is used in a different one as input. If you try to remove an algorithm that has others depending on it, SEXTANTE will show you a warning message like the one you can see below:
it: Selezionando l'opzione :guilabel:`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:

en: Selecting the :guilabel:`Edit` option or simply double-clicking on the algorithm icon will show the parameters dialog of the algorithm, so you can change the inputs and parameter values. Not all input elements available in the model will appear in this case as available inputs. Layers or values generated at a more advanced step in the workflow defined by the model will not be available if they cause circular dependencies.
it: Selezionando l'opzione :guilabel:`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.

en: Select the new values and then click on the **[OK]** button as usual. The connections between the model elements will change accordingly in the modeler canvas.
it: Selezionate i nuovi valori e premete il pulsante **[OK]** come al solito. La connessione fra gli elementi del modello cambieranno di conseguenza anche nel pannello grafico.

en: Activating and deactivating algorithms
it: Abilitare e disabilitare gli algortimi

en: Algorithms can be deactivated in the modeler, so they will not be executed once the model is run. This can be used to test just a given part of the model, or when you do not need all the outputs it generates.
it: 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.

en: To deactivate an algorithm, right-click on its icon in the model canvas and select the :guilabel:`Deactivate` option. You will see that the algorithm is represented now with a red label under its name indicating that is not active.
it: Per disattivare un algoritmo, premete il tasto destro del mouse sulla sua icona nel pannello grafico e spuntate l'opzione :guilabel:`Disattivazione`. Vedrete che ora l'algoritmo sarà presentato con un'etichetta rossa sotto il nome che indica che questo non è attivo.

en: All algorithms depending (directly or undirectly) on that algorithm will also appear as inactive, since they cannot be executed now.
it: Anche gli algoritmi dipendenti (direttamente o indirettamente) da quell'algoritmo appariranno come disattivati in quanto non possono ora essere eseguiti.

en: To activate an algorithm, just right--click on its icon and select the :guilabel:`Activate` option.
it: Per abilitare un algoritmo basta premere sulla sua icona col pulsante destro del mouse e selezionare l'opzione :guilabel:`Abilitare`.

en: Editing model help files and meta-information
it: Informazioni ed aiuto per l'aggiornamento del modello

en: You can document your models from SEXTANTE. Just click on the **[Edit model help]** button and a dialog like the one shown next will appear.
it: Potete documentare i vostri modelli in SEXTANTE. Premete il pulsante **[Edit model help]** ed apparirà una finestra di dialogo come la seguente.

en: On the right-hand side you will see a simple HTML page, created using the description of the input parameters and outputs of the algorithm, along with some additional items like a general description of the model or its author. The first time you open the help editor all those descriptions are empty, but you can edit them using the elements on the left-hand side of the dialog. Select an element on the upper part and the write its description in the texbox below.
it: 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.

en: Model help is saved in a file in the same folder as the model itself. You do not have to worry about saving it, since it is done automatically.
it: L'informazione di aiuto del modello è salvata nella stessa cartella insieme al modello stesso. Non dovete preoccuparvi del suo salvataggio perchè è eseguito automaticamente.

en: About available algorithms
it: A proposito degli algoritmi disponibili

en: You might notice that some algorithms that can be be executed from the toolbox do not appear in the list of available ones when you are designing a model. To be included in a model, and algorithm must have a correct semantic, so as to be properly linked to other in the workflow. If an algorithm does not have such well-defined semantic (for instance, if the number of output layers cannot be know in advance), then it is not possible to use it within a model, and thus does not appear in the list of them that you can find in the modeler dialog.
it: 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.

en: Additionaly, you will see some algorithms in the modeler that are not found in the toolbox. This algorithms are meant to be used exclusively as part of a model, and they are of no interest in a different context. The 'Calculator' algorithm is an example of that. It is just a simple arithmetic calculator that you can use to modify numerical values (entered by the user or generated by some other algorithm). This tools is really useful within a model, but outside of that context, it doesn't make too much sense.
it: 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.

en: SEXTANTE models as Python code
it: I modelli di SEXTANTE come codice Python

en: *This feature is temporarily unavailable*
it: *Questa funzionalità non è al momento disponibile*

en: Along with the tab that contains the graphical design of the model, you will find another one containing a Python script which performs the same task as the model itself. Using that code, you can create a console script (we will explain them later in this same manual) and modify it to incorporate actions and methods not available in the graphical modeler, such as loops or conditional sentences.
it: 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.

en: This feature is also a very practical way of learning how to use SEXTANTE from the console and how to create SEXTANTE algorithms using Python code, so you can use it as a learning tool when you start creating your own SEXTANTE scripts.
it: 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.

en: You will find a button below the text field containing the Python code. Click on it to directly create a new script from that code, without having to copy and paste it in the SEXTANTE script editor.
it: 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.
