QGIS plugin manual test plan

This document describes how to perform a full manual test on the Ribasim QGIS plugin. Known shortcomings and issues can be documented here. Bugs can be reported on GitHub.

1 Clean slate tests

Before starting with data, perform the following tests to see if the plugin doesn’t result in any errors.

1.1 Enable and disable

  • Open QGIS and navigate to “Plugins > Manage and Install Plugins…”: The plugin management window opens.
  • Navigate to “Installed”: Ribasim plugin is in the list (enabled).
  • Disable the Ribasim plugin: Ribasim plugin panel hides if it was open, Ribasim button hides from navigation toolbar.
  • Enable the Ribasim plugin: Ribasim button shows on the navigation toolbar.

1.2 Open and close

  • Open QGIS and ensure that the Ribasim plugin is installed and enabled.
  • Open the application via the Ribasim button on the QGIS toolbar: Ribasim panel opens.
  • Press the Ribasim button on the QGIS toolbar: Ribasim panel hides.

1.3 Button states on startup

  • Open QGIS and ensure that the Ribasim plugin is installed and enabled.
  • Open the application via the Ribasim button on the QGIS toolbar: Ribasim panel opens.
  • In the Nodes tab, all buttons are disabled.

Failing

2 Model tab button interaction tests

2.1 Open model twice

  • Open QGIS and ensure that the Ribasim plugin is installed and enabled.
  • Open the application via the Ribasim button on the QGIS toolbar: Ribasim panel opens.
  • Press the “New” button in the Model tab: file navigation window pops up.
  • Fill in a name (“test1”).
  • Press OK: A TOML and database file are created on the given location.
  • Press the “Open” button in the Model tab: file navigation window pops up.
  • Open test1.toml: A new layer group is added to the layers panel.
  • In the Nodes tab press “Basin / profile”: A Basin / profile table layer is added to the last layer group only.

Intended behavior: The same model is loaded twice, but there is only a connection on the last loaded model when interacting with the plugin.

3 Nodes tab button interaction tests

3.1 Add all tables to new model

  • Open QGIS and ensure that the Ribasim plugin is installed and enabled.
  • Open the application via the Ribasim button on the QGIS toolbar: Ribasim panel opens.
  • Press the “New” button in the Model tab: file navigation window pops up.
  • Fill in a name (“test1”).
  • Press OK: A TOML and database file are created on the given location.
  • Go to the Nodes tab: All buttons are enabled.
  • From left to right, top to bottom, press every button to add tables to the layers: The layer group contains extra layers for every button clicked. Basin / area is a MultiPolygon layer.
  • Navigate to Model tab: All layers are added to the panel.
  • Press the “Open” button to open the same model once again: The layers panel adds the model containing all of its layers, the Model tab was refreshed.

3.2 Add table twice to new model

  • Open QGIS and ensure that the Ribasim plugin is installed and enabled.
  • Open the application via the Ribasim button on the QGIS toolbar: Ribasim panel opens.
  • Press the “New” button in the Model tab: file navigation window pops up.
  • Fill in a name (“test1”).
  • Press OK: A TOML and database file are created on the given location.
  • Go to the Nodes tab: All buttons are enabled.
  • Press the Basin / time button: A layer is added to the layers panel with that name, the button becomes disabled.

Failing

4 Map interaction tests

4.1 Add points to Node layer

  • Open QGIS and ensure that the Ribasim plugin is installed and enabled.
  • Open the application via the Ribasim button on the QGIS toolbar: Ribasim panel opens.
  • Press the “New” button in the Model tab: file navigation window pops up.
  • Fill in a name (“test1”).
  • Press OK: A TOML and database file are created on the given location.
  • Select the Node layer in the Layers tab: edit buttons in the toolbar become enabled.
  • Edit the layer by pressing the pencil button: Add Point Feature button becomes enabled.
  • Click in the canvas: Popup appears with Feature Attributes to fill in.
  • Press OK: The first Node appears on the map.
  • Click in the canvas again: Popup appears with Feature Attributes to fill in.
  • Press OK: The second Node appears on the map.

Unexpected behavior: The default type of the nodes is NULL, and therefore undefined. Should be enforced and validated. See issue.

4.3 Node selection on map triggers table selection

  • Open QGIS and ensure that the Ribasim plugin is installed and enabled.
  • Open the application via the Ribasim button on the QGIS toolbar: Ribasim panel opens.
  • Press the “Open” button in the Model tab: file navigation window pops up.
  • Choose an existing model from the generated_testmodels folder.
  • Press OK: The model layers appear in the layer panel and on the map.
  • Select the node layer, and make a subselection of nodes on the map: Nodes are highlighted in yellow, including their links.
  • Open the Link attribute table: The highlighted rows are those with a from/to node_id that was selected.
  • Open any non-spatial attribute table: The highlighted rows are those with an node_id that was selected.

5 Result inspection tests

5.1 Run a model and check the time series

TODO

6 Tutorial tests

6.1 Perform tutorial in documentation

Go through the tutorial as described in the How-to guide.