K-Means
Minimizes within-cluster squared distance to K centroids.
Automatically groups pixels with similar multiband values without labelled training data. The result is a cluster map that must be interpreted before it becomes a semantic land-cover map.
Remote Sensing CoreEnd-User DocumentationTheory + Formula + ParametersAutomatically groups pixels with similar multiband values without labelled training data. The result is a cluster map that must be interpreted before it becomes a semantic land-cover map.
Minimizes within-cluster squared distance to K centroids.
Adaptive centroid clustering that can remove small clusters, merge nearby centers, and split high-variance clusters.
Learns a 2-D topology of representative feature vectors, then groups map units into output classes.
Models data as a mixture of Gaussian components with configurable covariance.
Assigns soft membership to all clusters during fitting, then produces a class map from the strongest membership.
Builds compact Clustering Feature summaries in a hierarchy, then performs global grouping.
| Input | Type | Requirement | Description |
|---|---|---|---|
| Input Raster | raster | Required |
| Parameter | Default | Choices / Range | How to Use It |
|---|---|---|---|
| Classification Algorithm | — | K-Means, ISODATA, Self-Organizing Map (SOM), Gaussian Mixture Model (GMM), Fuzzy C-Means, BIRCH | Choose the clustering method. |
| Predictor Bands | All bands | — | Select raster bands used to form each pixel's feature vector. |
| Number of Classes | 5 | 2 to 255 | Requested classes; for ISODATA this is the initial class count. |
| Training Pixel Sample | 100000 | 100 to — | Maximum valid pixels sampled to learn the cluster structure. |
| Standardize Predictor Bands | On | — | Recommended when bands or stacked variables have different numeric ranges. |
| Prediction Batch Size | 250000 | 1000 to 2000000 | Controls memory used while assigning the final raster classes. |
| Random State | 42 | — | Keep fixed to make comparative runs more reproducible. |
| Output Nodata | 0 | 0 to 32767 | Value reserved for invalid / nodata output pixels. |
| K-Means Mini-Batch Size | 4096 | 64 to 262144 | Shown for: kmeans |
| K-Means Maximum Iterations | 100 | 1 to 2000 | Shown for: kmeans |
| K-Means Initializations | 3 | 1 to 50 | Shown for: kmeans |
| ISODATA Minimum Classes | 2 | 2 to 255 | Shown for: isodata |
| ISODATA Maximum Classes | 12 | 2 to 255 | Shown for: isodata |
| ISODATA Maximum Iterations | 30 | 1 to 500 | Shown for: isodata |
| ISODATA Minimum Pixels per Cluster | 50 | 1 to 1000000 | Shown for: isodata |
| ISODATA Merge Distance Threshold | 0.5 | 0 to — | Small distances encourage merging of similar clusters. Shown for: isodata |
| ISODATA Split Standard Deviation Threshold | 1.0 | 0 to — | High within-cluster variation can trigger splitting. Shown for: isodata |
| ISODATA Convergence Tolerance | 0.01 | 1e-07 to — | Shown for: isodata |
| SOM Grid Rows | 5 | 1 to 64 | Shown for: som |
| SOM Grid Columns | 5 | 1 to 64 | Shown for: som |
| SOM Epochs | 30 | 1 to 1000 | Shown for: som |
| SOM Initial Learning Rate | 0.5 | 1e-06 to 2.0 | Shown for: som |
| SOM Initial Neighborhood Sigma | 2.0 | 0.1 to 100 | Shown for: som |
| SOM Mini-Batch Size | 1024 | 16 to 65536 | Shown for: som |
| GMM Covariance Type | Full | Full, Tied, Diagonal, Spherical | Shown for: gmm |
| GMM Maximum Iterations | 200 | 1 to 5000 | Shown for: gmm |
| GMM Convergence Tolerance | 0.001 | 1e-08 to — | Shown for: gmm |
| GMM Covariance Regularization | 1e-06 | 0 to — | Shown for: gmm |
| GMM Initializations | 1 | 1 to 50 | Shown for: gmm |
| Fuzzy C-Means Fuzziness (m) | 2.0 | 1.0001 to 10 | Shown for: fuzzy_cmeans |
| Fuzzy C-Means Maximum Iterations | 150 | 1 to 5000 | Shown for: fuzzy_cmeans |
| Fuzzy C-Means Convergence Tolerance | 0.0001 | 1e-08 to — | Shown for: fuzzy_cmeans |
| Fuzzy C-Means Initializations | 1 | 1 to 20 | Shown for: fuzzy_cmeans |
| BIRCH Threshold | 0.5 | 1e-06 to — | Shown for: birch |
| BIRCH Branching Factor | 50 | 2 to 10000 | Shown for: birch |
The result should be interpreted according to the selected method and the physical meaning of the input data. Preserve source units, coordinate reference information, NoData meaning, acquisition date, and preprocessing level when comparing results.