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.

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 “Open” button in the Ribasim panel: 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.
  • Press the “Open” button: file navigation window pops up.
  • Open the same model again: A new layer group is added to the layers panel.

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 Map interaction tests

3.1 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 Ribasim panel: 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 a node_id that was selected.

4 Result inspection tests

4.1 Run a model and check the time series

TODO

5 Tutorial tests

5.1 Perform tutorial in documentation

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