Tool Name	Iterative Truncation
Tool ID	29
Library ID	grid_analysis
Version	1.0
Author(s)	V. Wichmann (c) 2020

Description

The tool allows one to perform an iterative truncation to a target average. This operation iteratively removes the highest values from the input grid until the average of all grid values matches the user-specified target average. Instead of simply removing the highest cell values, these values can also be replaced by a substitute value.
An example application is surface soil cleanup, where the highest soil contaminant concentrations are removed until targeted post-remediation concentrations are reached. In this case, the substitute value would be set to the concentration of clean fill.

Parameters

Name	Type	Identifier	Description	Constraints
Input
Input	grid, input	INPUT	Grid to analyse.
Output
Removed Cells	grid, output	REMOVED	Output grid showing the removed cells (1/NoData).
Output	grid, output, optional	OUTPUT	The modified input grid.
Options
Target Average	floating point number	TARGET	The target average.	Default: 100.000000
Method	choice	METHOD	Choose a mode of operation.	Available Choices: [0] remove cell values [1] replace cell values Default: 0
Substitute Value	floating point number	SUBSTITUTE	The value with which the removed cell values are replaced.	Default: 0.000000