com.supermap.analyst.spatialstatistics

类 WeightsUtilities



  • public class WeightsUtilities
    extends Object
    空间权重矩阵工具类。该类可用来构建空间权重矩阵。

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

    • 方法详细资料

      • 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 - 一个用于接收进度条事件的监听器。

Copyright © 2021–2024 SuperMap. All rights reserved.