This function thresholds an array or vector, setting elements below the
threshold value to zero. The threshold can be given literally or calculated
using k-means clustering.
The method to use to calculate the threshold. If
"literal" (the default) then the value of level will be
used. If "kmeans" then the threshold value will be determined
implicitly using k-means clustering.
binarise
Whether to set suprathreshold elements to unity (if
TRUE), or leave them at their original values (if FALSE).