com.supermap.analyst.spatialstatistics

类 WeightsUtilities

java.lang.Object

com.supermap.analyst.spatialstatistics.WeightsUtilities

public class WeightsUtilities
extends Object

空间权重矩阵工具类。该类可用来构建空间权重矩阵。

该类可用来衡量数据集中各要素彼此之间的空间相关性。空间权重矩阵可以观察数据集中各要素之间的空间关系。

方法概要

限定符和类型	方法和说明
static void	addSteppedListener(SteppedListener l) 添加一个进度条事件（SteppedEvent）的监听器。
static boolean	buildWeightMatrix(DatasetVector sourceDatasetVector, String uniqueIDFieldName, String filePath, PatternsParameter patternsParameter) 已过时。 此方法已废弃，请使用支持进度监听的新方法 WeightsUtilities.buildWeightMatrix(DatasetVector, String, String, PatternsParameter, SteppedListener...) 替换。
static boolean	buildWeightMatrix(DatasetVector sourceDatasetVector, String uniqueIDFieldName, String filePath, PatternsParameter patternsParameter, SteppedListener... listeners) 构建空间权重矩阵。
static DatasetVector	converToTableDataset(String filePath, Datasource targetDatasource, String targetDatasetName) 已过时。 此方法已废弃，请使用支持进度监听的新方法 WeightsUtilities.converToTableDataset(String, Datasource, String, SteppedListener...) 。
static DatasetVector	converToTableDataset(String filePath, Datasource targetDatasource, String targetDatasetName, SteppedListener... listeners) 空间权重矩阵文件转换成属性表。
static void	removeSteppedListener(SteppedListener l) 移除一个进度条事件（SteppedEvent）的监听器。

从类继承的方法 java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

方法详细资料

buildWeightMatrix

@Deprecated
public static boolean buildWeightMatrix(DatasetVector sourceDatasetVector,
                                                     String uniqueIDFieldName,
                                                     String filePath,
                                                     PatternsParameter patternsParameter)

已过时。 此方法已废弃，请使用支持进度监听的新方法 WeightsUtilities.buildWeightMatrix(DatasetVector, String, String, PatternsParameter, SteppedListener...) 替换。

构建空间权重矩阵。

1. 该方法会生成一个空间权重矩阵文件,文件格式为: ***.swmb。生成的空间权重矩阵文件可用来进行分析,只要将空间关系概念化模型（ConceptualizationModel）设置 为ConceptualizationModel.SPATIALWEIGHTMATRIXFILE 并且在分析模式参数（PatternsParameter中通过 PatternsParameter.setFilePath 方法指定使用此方法创建的空间权重矩阵文件的完整路径。

2. 空间权重矩阵文件旨在生成、存储、重用和共享一组要素之间关系的空间关系概念化模型。文件采用的是二进制文件格式创建,要素关系存储为稀疏矩阵。

3. 调用该方法时，需要通过 patternsParameter 参数指定一个分析模式参数（PatternsParameter）对象，该对象用于构建空间权重矩阵所需的参数，仅空间关系概念化模型、距离容限、反距离幂指数、相邻数目、标准化有效。

参数:

sourceDatasetVector - 指定源数据集。

uniqueIDFieldName - 指定的唯一ID字段名。

filePath - 指定的空间权重矩阵文件保存路径。

patternsParameter - 指定的分析模式参数设置。

返回:

一个布尔值，表示构建空间权重矩阵是否成功，如果构建空间权重矩阵，返回 true，否则返回 false。

buildWeightMatrix

public static boolean buildWeightMatrix(DatasetVector sourceDatasetVector,
                                        String uniqueIDFieldName,
                                        String filePath,
                                        PatternsParameter patternsParameter,
                                        SteppedListener... listeners)

构建空间权重矩阵。

1. 该方法会生成一个空间权重矩阵文件,文件格式为: ***.swmb。生成的空间权重矩阵文件可用来进行分析,只要将空间关系概念化模型（ConceptualizationModel）设置 为ConceptualizationModel.SPATIALWEIGHTMATRIXFILE 并且在分析模式参数（PatternsParameter中通过 PatternsParameter.setFilePath 方法指定使用此方法创建的空间权重矩阵文件的完整路径。

2. 空间权重矩阵文件旨在生成、存储、重用和共享一组要素之间关系的空间关系概念化模型。文件采用的是二进制文件格式创建,要素关系存储为稀疏矩阵。

3. 调用该方法时，需要通过 patternsParameter 参数指定一个分析模式参数（PatternsParameter）对象，该对象用于构建空间权重矩阵所需的参数，仅空间关系概念化模型、距离容限、反距离幂指数、相邻数目、标准化有效。

参数:

sourceDatasetVector - 指定源数据集。

uniqueIDFieldName - 指定的唯一ID字段名。

filePath - 指定的空间权重矩阵文件保存路径。

patternsParameter - 指定的分析模式参数设置。

listeners - 用于接收进度条事件的监听器。

返回:

一个布尔值，表示构建空间权重矩阵是否成功，如果构建空间权重矩阵，返回 true，否则返回 false。

converToTableDataset

@Deprecated
public static DatasetVector converToTableDataset(String filePath,
                                                              Datasource targetDatasource,
                                                              String targetDatasetName)

已过时。 此方法已废弃，请使用支持进度监听的新方法 WeightsUtilities.converToTableDataset(String, Datasource, String, SteppedListener...) 。

空间权重矩阵文件转换成属性表。

结果属性表包含源唯一ID字段（UniqueID）、相邻要素唯一ID字段（NeighborsID）、权重字段（Weight）。

参数:

filePath - 指定的空间权重矩阵文件路径。

targetDatasource - 指定的用于存储结果属性表的数据源。

targetDatasetName - 指定的结果属性表名称。

返回:

结果属性表。

converToTableDataset

public static DatasetVector converToTableDataset(String filePath,
                                                 Datasource targetDatasource,
                                                 String targetDatasetName,
                                                 SteppedListener... listeners)

空间权重矩阵文件转换成属性表。

结果属性表包含源唯一ID字段（UniqueID）、相邻要素唯一ID字段（NeighborsID）、权重字段（Weight）。

参数:

filePath - 指定的空间权重矩阵文件路径。

targetDatasource - 指定的用于存储结果属性表的数据源。

targetDatasetName - 指定的结果属性表名称。

listeners - 用于接收进度条事件的监听器。

返回:

结果属性表。

addSteppedListener

public static void addSteppedListener(SteppedListener l)

添加一个进度条事件（SteppedEvent）的监听器。

参数:

l - 一个用于接收进度条事件的监听器。

removeSteppedListener

public static void removeSteppedListener(SteppedListener l)

移除一个进度条事件（SteppedEvent）的监听器。

参数:

l - 一个用于接收进度条事件的监听器。