经纬度K均值聚类 (GeoKMeans)

Java 类名：com.alibaba.alink.pipeline.clustering.GeoKMeans

Python 类名：GeoKMeans

功能介绍

KMeans 是一个经典的聚类算法。

基本思想是：以空间中k个点为中心进行聚类，对最靠近他们的对象归类。通过迭代的方法，逐次更新各聚类中心的值，直至得到最好的聚类结果。

本组件主要针对经纬度距离做Kmeans聚类，包括经纬度KMeans，经纬度KMeans预测, 经纬度KMeans流式预测。

经纬度距离（https://en.wikipedia.org/wiki/Haversine_formula)

输入数据中的经度和纬度使用度数表示，得到的距离单位为千米(km)。

参数说明

名称	中文名称	描述	类型	是否必须？	取值范围	默认值
latitudeCol	经度列名	经度列名	String	✓
longitudeCol	纬度列名	纬度列名	String	✓
predictionCol	预测结果列名	预测结果列名	String	✓
epsilon	收敛阈值	当两轮迭代的中心点距离小于epsilon时，算法收敛。	Double			1.0E-4
initMode	中心点初始化方法	初始化中心点的方法，支持“K_MEANS_PARALLEL”和“RANDOM”	String		“RANDOM”, “K_MEANS_PARALLEL”	“RANDOM”
initSteps	k-means++初始化迭代步数	k-means初始化中心点时迭代的步数	Integer			2
k	聚类中心点数量	聚类中心点数量	Integer			2
maxIter	最大迭代步数	最大迭代步数，默认为 50。	Integer			50
modelFilePath	模型的文件路径	模型的文件路径	String			null
overwriteSink	是否覆写已有数据	是否覆写已有数据	Boolean			false
predictionDetailCol	预测详细信息列名	预测详细信息列名	String
predictionDistanceCol	预测距离列名	预测距离列名	String
randomSeed	随机数种子	随机数种子	Integer			0
reservedCols	算法保留列名	算法保留列	String[]			null
numThreads	组件多线程线程个数	组件多线程线程个数	Integer			1
modelStreamFilePath	模型流的文件路径	模型流的文件路径	String			null
modelStreamScanInterval	扫描模型路径的时间间隔	描模型路径的时间间隔，单位秒	Integer			10
modelStreamStartTime	模型流的起始时间	模型流的起始时间。默认从当前时刻开始读。使用yyyy-mm-dd hh:mm:ss.fffffffff格式，详见Timestamp.valueOf(String s)	String			null

代码示例

Python 代码

from pyalink.alink import *

import pandas as pd

useLocalEnv(1)

df = pd.DataFrame([
    [0, 0],
    [8, 8],
    [1, 2],
    [9, 10],
    [3, 1],
    [10, 7]
])

inOp1 = BatchOperator.fromDataframe(df, schemaStr='f0 long, f1 long')

kmeans = GeoKMeans()\
    .setLongitudeCol("f0")\
    .setLatitudeCol("f1")\
    .setK(2)\
    .setPredictionCol("pred")

kmeans.fit(inOp1).transform(inOp1).print()

Java 代码

import org.apache.flink.types.Row;

import com.alibaba.alink.operator.batch.BatchOperator;
import com.alibaba.alink.operator.batch.source.MemSourceBatchOp;
import com.alibaba.alink.pipeline.clustering.GeoKMeans;
import org.junit.Test;

import java.util.Arrays;
import java.util.List;

public class GeoKMeansTest {
	@Test
	public void testGeoKMeans() throws Exception {
		List <Row> df = Arrays.asList(
			Row.of(0, 0),
			Row.of(8, 8),
			Row.of(1, 2),
			Row.of(9, 10),
			Row.of(3, 1),
			Row.of(10, 7)
		);
		BatchOperator <?> inOp1 = new MemSourceBatchOp(df, "f0 int, f1 int");
		GeoKMeans kmeans = new GeoKMeans()
			.setLongitudeCol("f0")
			.setLatitudeCol("f1")
			.setK(2)
			.setPredictionCol("pred");
		kmeans.fit(inOp1).transform(inOp1).print();
	}
}

运行结果

f0	f1	pred
0	0	1
8	8	0
1	2	1
9	10	0
3	1	1
10	7	0

ALinkLab