Outdated version of the documentation. Find the latest one here.

.

Modellatore grafico

Il modellatore grafico ti permette di creare modelli complessi grazie a un’interfaccia molto facile ed intuitiva. Quando lavori con un GIS, molte operazioni di analisi non sono isolate, ma sono inserite in un processo di operazioni. Grazie al modellatore grafico puoi unire i singoli processi in un unico grande modello; in questo modo velocizzerai molto il flusso di lavoro in quanto non dovrai più specificare ogni volta ogni singola operazione. Indipendentemente dal numero di passaggi e dai differenti algoritmi coinvolti, il modello funziona come se fosse un singolo algoritmo, facendoti risparmiare tempo e fatica, specialmente nel caso di modelli di grandi dimensioni.

Puoi aprire il modellatore grafico dal menu di Processing.

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.

Figure Processing 16:

../../../_images/modeler_canvas.png

Modellatore grafico win

La creazione di un modello comporta due passaggi:

  1. Definizione degli input necessari. Tutti gli input verranno aggiunti alla finestra dei parametri, in questo modo puoi impostare i valori durante l’esecuzione del modello. Il modello stesso è un algoritmo, quindi la finestra dei parametri viene automaticamente generata come accade con tutti gli algoritmi disponibili.

  2. Definizione del flusso di lavoro. Usando i dati in input del modello, il flusso di lavoro è definito aggiungendo algoritmi e scegliendo come questi devono usare gli input o gli output generati da altri algoritmi già presenti nel modello.

Definizione dei dati di ingresso

Il primo passo per creare un modello è quello di definire tutti gli input. Nella parte sinistra del modellatore trovi la scheda Inputs dove potrai scegliere i vari elementi.

  • Raster

  • Vettori

  • Stringhe di testo

  • Campi di tabelle

  • Tabelle

  • Estensione

  • Numero

  • Booleano

  • File

Facendo doppio click su uno di questi elementi, apparirà una finestra di dialogo che servirà a definire le sue caratteristiche. A seconda del parametro, la finestra conterrà un solo elemento (la descrizione, ovvero quello che vedrai durante l’esecuzione del modello) oppure più elementi. Per esempio, aggiungendo un valore numerico, come puoi vedere nella figura seguente, oltre alla descrizione del parametro, dovrai definire un valore di partenza ed un intervallo di valori validi.

Figure Processing 17:

../../../_images/models_parameters.png

Parametri del modellatore win

Per ogni dato di ingresso aggiunto, appare un nuovo elemento nel pannello grafico del modellatore.

Figure Processing 18:

../../../_images/models_parameters2.png

Parametri del modellatore win

Puoi inoltre aggiungere input trascinandolo dall’elenco e rilasciandolo nella mappa del modellatore, nella posizione in cui vuoi posizionarlo.

Definizione del flusso operativo

Una volta definiti gli input, devi scegliere gli algoritmi che intendi usare. Gli algoritmi si trovano nella casella Algoritmi, raggruppati allo stesso modo come in Strumenti.

Figure Processing 19:

../../../_images/models_parameters3.png

Parametri del modellatore win

Anche l’aspetto degli Strumenti ha due voci: semplificato e avanzato. Tuttavia, non puoi cambiare l’aspetto nel modello, lo devi fare direttamente dagli Strumenti. La voce selezionata sarà quella che verrà usata nell’elenco degli algoritmi del modellatore.

Per aggiungere un algoritmo a un modello, fai doppio click sul suo nome o trascinalo, proprio come hai fatto durante l’aggiunta di input. Apparirà una finestra di dialogo, simile a quella che viene visualizzata quando si esegue l’algoritmo dagli strumenti. Quella mostrata di seguito corrisponde all’algoritmo SAGA ‘indice di convergenza’, lo stesso esempio che abbiamo visto nella sezione dedicata agli Strumenti.

Figure Processing 20:

../../../_images/models_parameters4.png

Parametri del modellatore win

Come puoi vedere, ci sono diverse differenze. Al posto della casella di output dove potevi specificare il percorso dei layer e tabelle, qui c’è una semplice casella di testo. Se il layer generato da questo algoritmo è solamente un layer temporaneo che deve essere usato come input da un altro algoritmo, allora non inserire niente in questa casella. Se riempi questa casella significa che il risultato è finale e che il testo che hai inserito corrisponderà all’output finale.

Anche il valore di ogni parametro è leggermente diverso, dal momento che che ci sono importanti differenze fra il contesto del modello e quello degli Strumenti. Vediamo come inserire i valori per ogni tipologia di parametro.

  • Layer (raster e vettori) e tabelle. Li devi selezionare da un elenco, ma in questo caso, quello che puoi scegliere non sono i layer o le tabelle caricati in QGIS, ma semplicemente l’elenco dei tipi di file o altri layer e tabelle generati da algoritmi già presenti al modello.

  • Valori numerici. Puoi inserire questi valori direttamente nella casella di testo. Questa casella però funziona anche come elenco in modo che tu possa selezionare ogni valore numerico del modello. In questo caso, il parametro considererà il valore che hai inserito durante l’esecuzione del modello.

  • Stringa. Come nel caso dei valori numerici, puoi inserire una stringa o scegliere un stringa fra quelle disponibili.

  • Table filed. Il parametro parent layer dipende da altri layer caricati nel modello e quindi lo potrai definire solamente in un secondo momento. Inserisci prima il nome del parametro e poi scegli il parent layer dal menu a tendina. Nel menu avrai a disposizione tutti i layer caricati nel modello.

In tutti i casi troverai un parametro aggiunti chiamato Parent algorithms, non disponibile quando avvii un algoritmo dagli Strumenti. Questo parametro ti permette di definire l’ordine in cui gli algoritmi vengono eseguiti, in quanto scegli tu la nidificazione degli algoritmi. In altre parole, puoi forzare l’esecuzione di un algoritmo prima di un altro.

Quando usi l’output di un algoritmo come input per un altro algoritmo, allora il primo algoritmo è implicitamente trattato come Parent algorithm del secondo (e lo puoi anche vede dalla direzione della freccia nella finestra del modello). Tuttavia, in alcuni casi un algoritmo può dipendere da un altro algoritmo anche se non richiede output (per esempio, un algoritmo che esegue un’interrogazione SQL su un database PostGIS e un altro che importa un layer nel database stesso). In questo caso, basta che selezioni l’algoritmo precedente nel parametro Parent algorithms e i due passaggi verranno eseguiti nell’ordine corretto.

Una volta assegnati valori corretti a tutti i parametri, premi [OK] e l’algoritmo verrà aggiunto alla finestra. L’algoritmo sarà collegato a tutti gli altri elementi del pannello, sia algoritmi sia dati in input, che creano risultati usati come input dall’algoritmo.

Gli elementi possono essere trascinati in un’altra posizione all’interno della mappa, per cambiare il modo in cui viene visualizzata la struttura del modulo e renderlo più chiaro e intuitivo. I collegamenti tra gli elementi vengono aggiornati automaticamente. Puoi ingrandire e ridurre utilizzando la rotellina del mouse.

Puoi eseguire l’algoritmo in ogni momento premendo il pulsante [Run]. Tuttavia, per poterlo usare dagli Strumenti, devi prima salvarlo e poi chiudere la finestra di dialogo del modellatore in modo da consentire al sistema di aggiornare la configurazione.

Salvataggio e caricamento di modelli

Usa il pulsante [Salva] per salvare il modello ed il pulsante [Apri] per aprire un modello esistente. I modelli sono salvati con l’estensione .model. Se hai già salvato il modello non ti verrà più chiesto il nome del file da salvare, infatti il modello verrà automaticamente sovrascritto sul file già esistente.

Prima di salvare un modello, devi inserire un nome ed un gruppo di appartenenza usando le caselle di testo nella parte alta della finestra.

I modelli salvati nella cartella modelli (cartella predefinita dove vengono salvati i modelli) appariranno in Strumenti, nel gruppo corrispondente. Quando apri gli Strumenti, vengono cercati tutti i file con estensione .model e poi caricati nella finestra. Visto che un modello è inteso come un algoritmo, lo puoi aggiungere agli Strumenti come un algoritmo qualsiasi.

Puoi specificare la cartella del modellatore nella finestra di configurazione di Processing, presente nel gruppo Modellatore.

I modelli caricati dalla cartella models appariranno non solo negli Strumenti, ma anche nell’albero degli algoritmi della scheda Algorithms presente nella finestra del modellatore. Questo significa che puoi includere un modello all’interno di un altro modello, proprio come se fosse un semplice algoritmo.

In alcuni casi, Processing potrebbe non essere in grado di caricare un modello perché non tutti gli algoritmi inclusi nel modello sono disponibili. Se hai usato un determinato algoritmo nel tuo modello, questo deve anche essere disponibile (cioè deve apparire negli Strumenti), altrimenti il modello non verrà caricato. Se disattivi un gestore di algoritmi nella finestra di configurazione di Processing, renderai inutilizzabili tutti i suoi algoritmi, creando problemi durante il caricamento dei modelli. Ricordati di questa procedura se hai problemi nel caricare o eseguire un modello.

Aggiornare il modello

Puoi modificare il modello mentre lo stai creando, ridefinendo il flusso e le relazioni fra gli algoritmi e i dati che definiscono il modello stesso.

Se premi il tasto destro del mouse su un algoritmo nel grafico che rappresenta il modello, apparirà un menu come quello sotto riportato:

Figure Processing 22:

../../../_images/modeler_right_click.png

Click con il tasto destro win

Selezionando l’opzione Remove rimuoverai l’algoritmo selezionato. Non potrai rimuovere un algoritmo se altri algoritmi dipendono da lui, ovvero quando un algoritmo vuole come input il risultato di un altro algoritmo. Se provi a rimuovere comunque uno di questi algoritmi, apparirà una finestra di avviso.

Figure Processing 23:

../../../_images/cannot_delete_alg.png

Impossibile rimuovere l’algoritmo win

Selezionando l’opzione 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 [OK] come al solito. La connessione fra gli elementi del modello cambieranno di conseguenza anche nel pannello grafico.

Informazioni ed aiuto per l’aggiornamento del modello

Puoi anche aggiungere una documentazione ai tuoi modelli. Premi il pulsante [Edit model help] per aprire la finestra di dialogo corrispondente.

Figure Processing 25:

../../../_images/help_edition.png

Documentazione dell’algoritmo win

Sulla parte destra vedrai una semplice pagina HTML, creata usando la descrizione dei parametri di input e di output dell’algoritmo insieme ad alcuni parametri aggiuntivi come la sua descrizione e l’autore. La prima volta che apri l’editor di aiuto, vedrai tutti i campi vuoti. Li puoi riempire usando le voci corrispondenti presenti nella parte sinistra della finestra di dialogo. Seleziona un elemento nella parte superiore e poi inserisci la descrizione nella casella di testo.

L’informazione di aiuto del modello è salvata nella stessa cartella insieme al modello stesso. Non devi preoccuparti del suo salvataggio perché viene eseguito automaticamente.

A proposito degli algoritmi disponibili

Potrai notare che alcuni algoritmi eseguibili dagli Strumenti non appaiono nell’elenco di quelli disponibili quando stai creando un modello. Per essere incluso in un modello, un algoritmo deve avere una semantica corretta in modo da poter essere correttamente collegato a tutti 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 in anticipo) allora non lo potrai usare all’interno del modello e quindi non apparirà nell’elenco di quelli disponibili.

Inoltre, ci sono altri algoritmi presenti nel modellatore grafico ma non negli Strumenti. Questi sono gli algoritmi pensati per essere usati solamente come parte di un modello e non hanno senso in altri contesti. Un esempio è l’algoritmo ‘Calcolatore’. È infatti una semplice calcolatrice che puoi usare per cambiare valori numerici (inseriti da te o creati da qualche algoritmo). Questo strumento è molto utile in un modello ma non ha molto senso al di fuori di questo contesto.