# K-Means聚类算法(clustersKmeans)
> npm install @turf/clusters-kmeans
Takes a set of points and partition them into clusters using the k-mean. It uses the k-means algorithm 接收一个点要素集合，并使用K-Means聚类算法 (opens new window) (opens new window)将它们聚类划分，返回计算后的点要素集合。
参数
| 参数 | 类型 | 描述 |
|---|---|---|
| points | FeatureCollection <Point> | 点要素集合 |
| options | Object | 可配置项 |
options选项
| 属性 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| numberOfClusters | number | Math.sqrt(numberOfPoints/2) | 集群数量 |
| mutate | boolean | false | 是否返回入参的 GeoJSON，为 true 性能能显著提高 |
返回
FeatureCollection <Point> - Clustered Points with an additional two properties associated to each Feature:
示例
// create random points with random z-values in their properties
var points = turf.randomPoint(100, {bbox: [0, 30, 20, 50]});
var options = {numberOfClusters: 7};
var clustered = turf.clustersKmeans(points, options);
