iMOD User Manual version 5.2 (html)

7.10Quick Scan Tool

WHY?
The effects of changes in hydrogeological conditions in an area can be visualized once a groundwater model has been created. This can be done by changing the model input (as described in section 7.9) or by using scenarios (currently not available!). However much run time may be needed in case of complicated large groundwater models while many variations of the model input are required to select the desired changes in the model input. The Quick Scan Tool is designed to reduce significantly this run time. The Quick Scan Tool will provide an approximated result indicating the effect of the model variation and enabling to choose the desired model input. After selecting the model input a single final model run is needed to obtain the detailed model output.

WHAT?
The Quick Scan Tool works with a database (the Quick Scan database or QS-database, in previous iMOD versions called the Impulse-Response database or IR-database) which contains the model output of many model runs made by varying combinations of model input. The result of a change in model input can be presented very quickly just by querying this QS-database.

7.10.1Quick Scan Tool - Initial Settings

The Quick Scan Tool needs an input file (*.INI) with initial settings. The input file is defined in the *.PRF file using the keyword QSTOOL (not yet implemented) or IRDBASE.

The Quick Scan Tool input file (*.INI) needs to contain the following parameters:

NIDF	Number of IDF-files used as reference file.
IDFNAME#	Name used in the QS Tool for IDF number #
IDFFILE#	Name of the IDF file used as IDF number #
RESDIR	Name of the folder with the results of the QS Tool
NIR	Number of QS databases used in the QS Tool
DIRIR#	Name of the folder with QS database number #
NAMEIR#	Name used in the QS Tool for QS database number #
IMPIR#	Name of the Impulse used in the QS database
MINIR#	Minimal impulse value
MAXIR#	Maximal impulse value
IDFIR#	IDF with the link to the REFIR#
REFIR#	Name of the file linking the IDFIR# value with the Response data

7.10.2Starting the Quick Scan Tool

HOW?
Select the Toolbox option from the main menu and then choose Quick Scan Tool to start the Quick Scan Tool window.

Define Name of Current Target window:

Enter a name for the target and click the Continue button. The Quick Scan Tool window will appear with the name of the target in the Project Overview list.

The Project Overview list contains all defined Targets (T), Measures (M) and Results (R).

The Active Polygons list contains all defined polygons. The targets and measures are defined in the tabs in the bottom half of the window by defining the area and the target or measure values.

Quick Scan Tool window:

A target (Target tab) and a measure (Measure tab) is defined by:

Click on the Add Areas button:

	Draw Draw a polygon to define the area where the target/measure is valid.
	Select Select a surface water level area from the map with surface water level areas. This map is shown in the background.

Click on the Add Target orAdd Measure button: a target/measure is linked to the area defined. Information on the targets/measures linked to a polygon is shown in the bottom half of the Quick Scan Tool window when selecting the polygon on the map.

Quick Scan Tool window, bottom half for selected polygon:

for Targets tab:

Assign Definition	Click on the Assign Definition button to add the target definition. The Assign Target Definition window appears.
Copy Definition	Click on the Copy Definition button to copy target definitions from one polygon to other polygons.
Create New Measure	Click on the Create New Measure button to make a new measure definition linked to the target.

Assign Target Definition window:

Topic	List of variables for which a target may be defined: • Purged water table: level of the purged groundwater above the confining layer; • Groundwater table: level of the groundwater under the confining layer; • Seepage fluxes: seepage-/infiltration flux from modellayer 1 to modellayer 2; • River fluxes: recharge/discharge of surface water; • Drainage fluxes: discharge by drainage tubes and ditches.
Period	Period or condition for which the target is valid: GHG (average highest groundwater level) or GLG (average lowest groundwater level)
Lower	Lower limit of the target
Upper	Upper limit of the target
Add Definition	Add target definition to the list of targets
Remove Selected Definition(s)	Remove the selected target definitions from the list of targets

Quick Scan Tool window, bottom half for selected polygon:

for Measures tab, Add Measures button:

Assign Definition	Click on the Assign Definition button to add the measure definition. The Assign Measure Definition window appears.
Copy Definition	Click on the Copy Definition button to copy measure definitions from one polygon to other polygons.
Plot selected cells, using following IR	Check the box to show the QS(=IR) units (model cell clusters) for which the effects of measures are calculated. The measure should be selected in the listbox because each measure may be linked to different units.
Create New Result	Click on the Create New Result button to save the set of measures to a result.

Assign Measure Definition window:

Topic	Name of the measure
Strength	Strength of the measure
Add Measure	Add measure definition to the list of measures
Remove Selected Measure(s)	Remove the selected measure definitions from the list of measure

Quick Scan Tool window, bottom half for selected polygon:

for Measures tab, Optimize button:

The Optimize function gives the opportunity to search in the QS-database for the optimal set of measures. These are the measures which give the desired result with the minimum number of measures.

Assign Constraints window:

Fixed	Click on the button to set a fixed constraint. The value of the measure is fixed and can not be changed.
Topic	Name of the measure
Lower	Lower limit of the constraint
Upper	Upper limit of the constraint
Fixed	Fixed value of the constraint (usable when button on first column is clicked)
Add Constraint	Click on the Add Constraint button to add a constraint to the list of measures.
Remove Selected Constraint(s)	Remove the selected constraints from the list of constraints
OK	The constraint values are checked to be within the limits of the QS-database and the window closes.

Quick Scan Tool window, bottom half for selected polygon:

for Measures tab, Preview button:

Select one of the results below:	Select the result from the list box. The effect of the measure is shown for the area selected under Add Areas.
	Show the result Click on the button to show the result on the map. The legend is shown below the list box.
Plot selected cells, using following IR	Check the box to show the QS(=IR) units (model cell clusters) for which the effects of measures are calculated. The measure should be selected in the listbox because each measure may be linked to different units.
Create New Result	Click on theCreate New Result buttonto save the set of measures to a result.

Example of report generated by Calculate on the Measures tab, Optimize button:

Measures	The proposed measures are listed by polygon. The constraints are shown between brackets.
Targets	The desired targets are listed by polygon. The upper and lower limits of the target are shown between brackets.
Exit	The report can be closed with the Window Close button or by [File / Exit].

Assign Constraints	Click on the Assign Constraints button to open the Assign Constraints window.
Calculate	Click on the Calculate button to search for the optimal set of measures using the assigned constraints. A report (see below) is generated in case the QS-database finds a solution. A warning is shown in case the QS-database is not able to find a solution.
Report	Show the report generated by the Calculate function
Plot selected cells, using following IR	Check the box to show the QS(=IR) units (model cell clusters) for which the effects of measures are calculated. The measure should be selected in the listbox because each measure may be linked to different units.
Create New Result	Click on theCreate New Result buttonto save the set of measures to a result.