Grafische modellen bouwen¶

Definitie van invoer¶

De eerste stap om een model te maken is het definiëren van de invoer die het nodig heeft. De volgende elementen worden gevonden in de tab Invoer aan de linkerkant van het venster Grafische modellen bouwen:

• Rasterlaag

• Vectorlaag

• Tekenreeks

• Tabelveld

• Tabel

• Bereik

• Getal

• Booleaanse waarde

• Bestand

Na dubbelklikken op een van deze elementen wordt een dialoogvenster weergegeven om de karakteristieken te definiëren. Afhankelijk van de parameter zelf, kan het dialoogvenster slechts één basiselement bevatten (de beschrijving, wat datgene is dat de gebruiker zal zien bij het uitvoeren van het model) of meerdere. Bijvoorbeeld bij het toevoegen van een numerieke waarde, zoals kan worden gezien in de volgende afbeelding, los van de beschrijving van de parameter, moet u een standaard waarde en een bereik van geldige waarden instellen.

Figure Processing 18:

Parameters Grafische modellen bouwen

Voor elke toegevoegde invoer wordt een nieuw element toegevoegd aan de werkruimte van Grafische modellen bouwen.

Figure Processing 19:

Parameters Grafische modellen bouwen

U kunt ook invoer toevoegen door het type invoer te slepen vanuit de lijst en neer te zetten in het venster van Grafische modellen bouwen, op de positie waar u het wilt plaatsen.

Definitie van de werkstroom¶

Als de invoer eenmaal is gedefinieerd, is het tijd om de algoritmen te definiëren die daarop moeten worden toegepast. Algoritmen kunnen worden gevonden op de tab Algoritmen, gegroepeerd op nagenoeg dezelfde wijze als in de Toolbox.

Figure Processing 20:

Parameters Grafische modellen bouwen

Dubbelklik op de naam van een algoritme en sleep en zet het neer, net zoals bij het toevoegen van invoer, om een algoritme aan een model toe te voegen. Een dialoogvenster voor de uitvoering zal verschijnen met een soortgelijke inhoud als die in het paneel voor uitvoering dat wordt weergegeven bij het uitvoeren van het algoritme vanuit de Toolbox. De volgende weergave correspondeert met het algoritme SAGA ‘Convergence index’.

Figure Processing 21:

Parameters Grafische modellen bouwen

Zoals u ziet zijn er enkele verschillen. In plaats van het vak voor het uitvoerbestand dat werd gebruikt om het pad voor de uitvoer van lagen en tabellen in te stellen, wordt hier een eenvoudig tekstvak gebruikt. Als de laag, gegenereerd door het algoritme, slechts een tijdelijk resultaat is dat zal worden gebruikt als de invoer voor een ander algoritme en niet zou moeten worden bewaard als uiteindelijk resultaat, bewerk dan dat tekstvak niet. Door er iets in te typen betekent het dat het resultaat het eindpunt is en de tekst die u invoert zal de beschrijving voor de uitvoer zijn, wat de uitvoer zal zijn die de gebruiker zal zien bij het uitvoeren van het model.

Selecteren van de waarde van elke parameter gaat ook een beetje anders, omdat er belangrijke verschillen zijn tussen de context van Grafische modellen bouwen en die van de Toolbox. Laten we eens kijken hoe we de waarden voor elk type parameter invullen.

• Lagen (raster en vector) en tabellen. Deze worden geselecteerd uit een lijst, maar in dit geval zijn de mogelijke waarden niet de huidige in QGIS geladen lagen of tabellen, maar de lijst van ingevoerde modellen van het overeenkomende type, of andere lagen of tabellen die zijn gegenereerd door algoritmen die al zijn toegevoegd aan het model.

• Numerieke waarden. Letterlijke waarden kunnen direct in het tekstvak worden ingevuld. Maar dit tekstvak is ook een lijst die kan worden gebruikt om elke van de numerieke invoerwaarden voor het model in te voeren. In dat geval zal de parameter, bij het uitvoeren van het model, de waarde aannemen die door de gebruiker is ingevuld.

• Tekenreeks. Net als in het geval van numerieke waarden kunnen letterlijke waarden worden ingevuld, of er kan een tekenreeks voor invoer worden geselecteerd.

• Tabelveld. De velden van de ouder-tabel of laag hoeven niet bekend te zijn op het moment van ontwerpen, omdat zij afhankelijk zijn van de selectie van de gebruiker, elke keer als het model wordt uitgevoerd. Type de naam van een veld direct in het tekstvak, of gebruik de lijst om een tabelveld voor invoer te selecteren dat al is toegevoegd aan het model om de waarde voor deze parameter in te stellen. De geldigheid van het geselecteerde veld zal bij de uitvoering worden gecontroleerd.

In alle gevallen zult u een aanvullende parameter aantreffen, genaamd Ouder-algoritmen dat niet beschikbaar is bij het aanroepen van het algoritme in de Toolbox. Deze parameter stelt u in staat de volgorde te definiëren waarin de algoritmen worden uitgevoerd door expliciet één algoritme als een ouder van het huidige te definiëren, wat forceert dat het ouder-algoritme wordt uitgevoerd vóór het huidige.

Wanneer u de uitvoer van een eerder algoritme gebruikt als de invoer voor uw algoritme, stelt dat impliciet het eerdere algoritme in als ouder van het huidige (en plaatst de overeenkomende pijl in de werkruimte van Grafische modellen bouwen). In sommige gevallen kan een algoritme echter afhankelijk zijn van een ander, zelfs als het er geen uitgevoerd object van gebruikt (bijvoorbeeld een algoritme dat een zin in SQL uitvoert op een database van PostGIS en een ander dat een laag importeert in dezelfde database). Selecteer in dat geval slechts het eerdere algoritme in de parameter Ouder-algoritmen en de twee stappen zullen in de juiste volgorde worden uitgevoerd.

Klik, als eenmaal aan alle parameters geldige waarden zijn toegewezen, op [OK] en het algoritme zal worden toegevoegd aan de werkruimte. Het zal worden gekoppeld aan alle andere elementen in de werkruimte, algoritme of invoer, dat objecten verschaft die worden gebruikt als invoer voor dat algoritme.

Elementen kunnen naar een andere positie binnen de werkruimte worden gesleept, om de manier waarop de modelstructuur wordt weergegeven te wijzigen en het duidelijker en meer intuïtief te maken. Koppelingen tussen elementen worden automatisch bijgewerkt. U kunt in- en uitzoomen met behulp van het muiswiel.

U kunt uw algoritme op elk moment uitvoeren door te drukken op de knop [Start model]. Echter, om het algoritme te kunnen gebruiken vanuit de Toolbox, moet het worden opgeslagen en het dialoogvenster Grafische modellen bouwen worden gesloten, om de Toolbox in staat te stellen zijn inhoud te verversen.

Opslaan en laden van modellen¶

Gebruik de knop [Opslaan] om het huidige model op te slaan en de knop [Open model] om een eerder opgeslagen model te openen. Modellen worden opgeslagen met de extensie .model. Als het model eerder werd opgeslagen vanuit het venster Grafische modellen bouwen, zult u niet naar ene bestandsnaam worden gevraagd. Omdat er al een bestand is geassocieerd met dat model, zal hetzelfde bestand worden gebruikt voor volgende opslag.

Vóór het opslaan van een model moet u een naam en een groep er voor invoeren, met behulp van de tekstvakken in het bovenste gedeelte van het venster.

Modellen die zijn opgeslagen in de map models (de standaard map als u wordt gevraagd naar een bestandsnaam om het model op te slaan) zullen in de corresponderende tak in de Toolbox verschijnen. Wanneer de Toolbox wordt gestart, zoekt het in de map models naar bestanden met de extensie .model en laadt de modellen die zij bevatten. Omdat een model in zichzelf een algoritme is, kan het aan de Toolbox worden toegevoegd, net als elk ander algoritme.

De map Models kan worden ingesteld in het dialoogvenster Opties van Processing onder de groep Models.

Modellen die zijn geladen uit de map models verschijnen niet alleen in de Toolbox, maar ook in de boom met algoritmen op de tab Algoritmen van het venster Grafische modellen bouwen. Dat betekent dat u een model kunt invoegen als deel van een groter model, net zoals u alle andere algoritmen kunt toevoegen.

Bewerken van een model¶

U kunt het model, dat u momenteel maakt, bewerken, de werkstroom opnieuw definiëren en de relaties tussen de algoritmen en invoer die het model zelf definiëren.

Als u met rechts klikt op een algoritme in de werkruimte dat het model vertegenwoordigt, zult u een contextmenu zien zoals dat wat hieronder wordt weergegeven:

Figure Processing 22:

Grafische modellen bouwen, klik met rechts

Selecteren van de optie Remove zal het geselecteerde algoritme verwijderen. Een algoritme kan alleen worden verwijderd als er geen andere algoritmen van afhankelijk zijn. Dat is, als er geen uitvoer van het algoritme wordt gebruikt in een ander als invoer. Als u probeert een algoritme te verwijderen waarvan andere afhankelijk zijn, zal een waarschuwingsbericht, zoals die welke hieronder wordt weergegeven, worden getoond:

Figure Processing 23:

Kan algoritme niet verwijderen

Selecteren van de optie Edit zal het dialoogvenster Parameters van het algoritme weergeven, zodat u de invoer- en parameterwaarden kunt wijzigen. Niet alle beschikbare elementen voor invoer in het model zullen in dat geval verschijnen als beschikbare invoer. Lagen of waarden die worden gegenereerd in een meer gevorderde stap in de werkstroom die is gedefinieerd door het model zal niet beschikbaar zijn als zij cirkelverwijzingen veroorzaken.

Selecteer de nieuwe waarden en klik dan op de knop [OK] zoals gewoonlijk. De verbindingen tussen de elementen van het model zullen overeenkomstig wijzigen in de werkruimte van Grafische modellen bouwen.

Een model kan gedeeltelijk worden uitgevoerd door enkele van zijn algoritmen uit te schakelen. Selecteer de optie Deactivate in het contextmenu dat verschijnt door met rechts te klikken op een element van een algoritme om dit te doen. Het geselecteerde algoritme, en alle in het model die daarvan afhankelijk zijn, zullen grijs worden weergegeven en zullen niet worden uitgevoerd als deel van het model.

Figure Processing 24:

Model met uitgeschakelde algoritmen

Door met rechts te klikken op een algoritme dat niet actief is, zult u in plaats daarvan een menuoptie Activate zien die kan worden gebruikt om het opnieuw te activeren.

Bewerken van Help-bestanden Grafische modellen bouwen en meta-informatie¶

U kunt vanuit Grafische modellen bouwen uw modellen documenteren. Klik gewoon op de knop [Help model bewerken] en een dialoogvenster, zoals dat wat hieronder wordt weergegeven, zal verschijnen.

Figure Processing 25:

Bewerken van Help

Aan de rechterkant ziet u een eenvoudige HTML-pagina, die is gemaakt met behulp van de beschrijving van de parameters voor de invoer en de uitvoer van het algoritme, tezamen met enkele aanvullende items zoals een algemene beschrijving van het model of de auteur ervan. De eerste keer dat u de bewerker voor de Help opent, zijn al deze beschrijvingen leeg, maar u kunt ze bewerken met behulp van de elementen aan de linkerkant van het dialoogvenster. Selecteer een element in het bovenste gedeelte en schrijf dan de beschrijving ervan in het tekstvak onderin.

Help voor een model wordt opgeslagen als deel van het model zelf.

Een model als script voor Python exporteren¶

Zoals we in een later hoofdstuk zullen zien kunnen algoritmen van Processing worden aangeroepen vanuit de Python console van QGIS, en nieuwe algoritmen van Processing kunnen ook worden gemaakt met behulp van Python. Een snelle manier voor het maken van zo’n script voor Python is om een model te maken en dat te exporteren als bestand voor Python.

Klik op de knop Als Python script exporteren om dat te doen. Selecteer het uitvoerbestand in het dialoogvenster voor het kiezen van bestanden, en Processing zal het herschrijven naar opdrachten voor Python die dezelfde bewerkingen uitvoeren als die welke zijn gedefinieerd in het huidige model.

Over beschikbare algoritmen¶

Het zal u zijn opgevallen dat sommige algoritmen die uitgevoerd kunnen worden vanuit de Toolbox niet verschijnen in de lijst van beschikbare algoritmen wanneer u een model ontwerpt. Een algoritme moet een juiste semantiek hebben, zoals juist zijn gekoppeld aan andere in de werkstroom, om te kunnen worden opgenomen in een model. Als een algoritme niet een dergelijke goed-gedefiniëerde semantiek heeft (als bijvoorbeeld het aantal uit te voeren lagen niet vooruit bekend is), dan is het niet mogelijk om het in een model te gebruiken, en dus,verschijnt het niet in de lijst met algoritmen die u zult zien in het dialoogvenster Grafische modellen bouwen.

Aanvullend zult u in Grafische modellen bouwen enkele algoritmen zien die niet worden aangetroffen in de Toolbox. Deze algoritmen zijn bedoeld om exclusief als deel van een model te worden gebruikt, en zij zijn niet van belang in enige andere. Het algoritme ‘Calculator’ is een voorbeeld daarvan. Het is slechts een eenvoudige rekenkundige calculator die u kunt gebruiken om numerieke waarden aan te passen (ingevoerd door de gebruiker of gegenereerd door een ander algoritme). Dit gereedschap is echt handig binnen een model, maar buiten die context, heeft het niet veel betekenis.