This tool transforms values in an input raster (`input`) into quantiles. In statistics, quantiles are cut points dividing the range of a probability distribution into continuous intervals with equal probabilities, or dividing the observations in a sample in a same way. There is one fewer quantile than the number of groups created. Thus quartiles are the three cut points that will divide a dataset into four equal-sized groups. Common quantiles have special names: for instance quartile (4-quantile), quintiles (5-quantiles), decile (10-quantile), percentile (100-quantile).

The user must specify the desired number of quantiles, q (`num_quantiles`), in the output raster (`output`). The output raster will contain q equal-sized groups with values 1 to q, indicating which quantile group each grid cell belongs to.

## See Also

histogram_equalization

## Function Signature

`def quantiles(self, raster: Raster, num_quantiles: int = 5) -> Raster: ...`

## Project Links

WbW Homepage User Manual Support WbW