PCACellularAutomata (iObjects Java Help)

java.lang.Object
- com.supermap.data.InternalHandle
- - com.supermap.data.InternalHandleDisposable
  - - com.supermap.analyst.spatialanalyst.PCACellularAutomata

所有已实现的接口:

IDisposable
```
public class PCACellularAutomata
extends com.supermap.data.InternalHandleDisposable
```
基于主成分分析的元胞自动机。
元胞自动机（cellular automata,CA）是一种时间、空间、状态都离散，空间相互作用和时间因果关系为局部的网络动力学模型，具有模拟复杂系统时空演化过程的能力。

当地理模拟需要使用许多空间变量，这些空间变量往往是相关的，有必要采用主成分分析，可以有效地将多个空间变量压缩到少数的主成分中，减少设置权重的难度，可以将基于主成分分析的元胞自动机应用在城市发展的空间模拟中。

构造器概要

构造器
构造器和说明

PCACellularAutomata()
默认构造函数，构造一个新的 PCACellularAutomata对象。

构造器
构造器和说明
`PCACellularAutomata()` 默认构造函数，构造一个新的 PCACellularAutomata对象。

方法概要

所有方法静态方法实例方法具体方法已过时的方法
限定符和类型	方法和说明
`static void`	`addCAFlushedListener(CAFlushedListener l)` 添加一个元胞自动机刷新信息（`CAFlushedEvent`）的监听器。
`static void`	`addSteppedListener(SteppedListener l)` 添加一个进度条事件（`SteppedEvent`）的监听器。
`void`	`dispose()` 释放该对象所占有的资源。
`PCAEigenResult`	`loadModel(String modelFile)` 加载主成分分析模型。
`PCAEigenResult`	`pca(DatasetGrid[] spatialVariableGrids, int nSampleCount, double dComponentRatio)` 已过时。此方法已废弃，请使用支持进度监听的新方法 `PCACellularAutomata.pca(DatasetGrid[], int, double, SteppedListener...)` 替换。
`PCAEigenResult`	`pca(DatasetGrid[] spatialVariableGrids, int nSampleCount, double dComponentRatio, SteppedListener... listeners)` 对元胞数据集进行抽样和主成分分析。
`DatasetGrid`	`pcaCellularAutomata(Datasource outputDatasource, String outputDatasetName, PCACellularAutomataParameter parameter)` 已过时。此方法已废弃，请使用支持进度监听的新方法 `PCACellularAutomata.pcaCellularAutomata(Datasource, String, PCACellularAutomataParameter, SteppedListener...)` 替换。
`DatasetGrid`	`pcaCellularAutomata(Datasource outputDatasource, String outputDatasetName, PCACellularAutomataParameter parameter, SteppedListener... listeners)` 基于主成分分析的元胞自动机。
`static void`	`removeCAFlushedListener(CAFlushedListener l)` 移除一个元胞自动机刷新信息（`CAFlushedEvent`）的监听器。
`static void`	`removeSteppedListener(SteppedListener l)` 移除一个进度条事件（`SteppedEvent`）的监听器。
`boolean`	`saveModel(String modelFile)` 是否保存主成分分析模型文件。
`static void`	`setIsDisposable(com.supermap.data.InternalHandleDisposable obj, boolean disposable)`

从类继承的方法 com.supermap.data.InternalHandleDisposable
makeSureNativeObjectLive

从类继承的方法 java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - PCACellularAutomata
```
public PCACellularAutomata()
```
    默认构造函数，构造一个新的 PCACellularAutomata对象。
- 方法详细资料
  - dispose
```
public void dispose()
```
    释放该对象所占有的资源。当调用该方法之后，此对象不再可用。
  - pca
```
@Deprecated
public PCAEigenResult pca(DatasetGrid[] spatialVariableGrids,
                                       int nSampleCount,
                                       double dComponentRatio)
```
    已过时。此方法已废弃，请使用支持进度监听的新方法 PCACellularAutomata.pca(DatasetGrid[], int, double, SteppedListener...) 替换。
    
    对元胞数据集进行抽样和主成分分析。
    该方法用于在进行基于主成分分析的元胞自动机分析之前，利用得到的主成分个数设置对应的权重值。
    
    参数:
    
    spatialVariableGrids - 空间变量栅格数据集。
    
    nSampleCount - 抽样个数。在整个栅格数据中随机抽取样本指定的样本个数。
    
    dComponentRatio - 主成分比例，取值范围 [0,1]，例如取值为0.8时，表示选取前n个累计贡献率达到80%的主成分。
  - pca
```
public PCAEigenResult pca(DatasetGrid[] spatialVariableGrids,
                          int nSampleCount,
                          double dComponentRatio,
                          SteppedListener... listeners)
```
    对元胞数据集进行抽样和主成分分析。
    该方法用于在进行基于主成分分析的元胞自动机分析之前，利用得到的主成分个数设置对应的权重值。
    
    参数:
    
    spatialVariableGrids - 空间变量栅格数据集。
    
    nSampleCount - 抽样个数。在整个栅格数据中随机抽取样本指定的样本个数。
    
    dComponentRatio - 主成分比例，取值范围 [0,1]，例如取值为0.8时，表示选取前n个累计贡献率达到80%的主成分。
    
    listeners - 用于接收进度条事件的监听器。
  - pcaCellularAutomata
```
@Deprecated
public DatasetGrid pcaCellularAutomata(Datasource outputDatasource,
                                                    String outputDatasetName,
                                                    PCACellularAutomataParameter parameter)
```
    已过时。此方法已废弃，请使用支持进度监听的新方法 PCACellularAutomata.pcaCellularAutomata(Datasource, String, PCACellularAutomataParameter, SteppedListener...) 替换。
    
    基于主成分分析的元胞自动机。
    
    参数:
    
    outputDatasource - 输出结果数据集所在数据源。
    
    outputDatasetName - 输出结果数据集的名称。
    
    parameter - 基于主成分分析的元胞自动机的参数。
  - pcaCellularAutomata
```
public DatasetGrid pcaCellularAutomata(Datasource outputDatasource,
                                       String outputDatasetName,
                                       PCACellularAutomataParameter parameter,
                                       SteppedListener... listeners)
```
    基于主成分分析的元胞自动机。
    
    参数:
    
    outputDatasource - 输出结果数据集所在数据源。
    
    outputDatasetName - 输出结果数据集的名称。
    
    parameter - 基于主成分分析的元胞自动机的参数。
    
    listeners - 用于接收进度条事件的监听器。
  - saveModel
```
public boolean saveModel(String modelFile)
```
    是否保存主成分分析模型文件。
    主成分分析训练完成时，会将结果信息保存为训练模型。
    
    参数:
    
    modelFile - 主成分分析模型保存路径。
    
    返回:
    
    保存成功返回TRUE，失败返回FALSE。
  - loadModel
```
public PCAEigenResult loadModel(String modelFile)
```
    加载主成分分析模型。
    
    参数:
    
    modelFile - 主成分分析模型保存路径。
    
    返回:
    
    主成分分析结果，将结果信息如：权重信息、错误率等保存至模型中。
  - addSteppedListener
```
public static void addSteppedListener(SteppedListener l)
```
    添加一个进度条事件（SteppedEvent）的监听器。
    
    参数:
    
    l - 一个用于接收进度条事件的监听器。
  - removeSteppedListener
```
public static void removeSteppedListener(SteppedListener l)
```
    移除一个进度条事件（SteppedEvent）的监听器。
    
    参数:
    
    l - 一个用于接收进度条事件的监听器。
  - addCAFlushedListener
```
public static void addCAFlushedListener(CAFlushedListener l)
```
    添加一个元胞自动机刷新信息（CAFlushedEvent）的监听器。
    
    参数:
    
    l - 一个用于接收元胞自动机刷新事务的监听器。
  - removeCAFlushedListener
```
public static void removeCAFlushedListener(CAFlushedListener l)
```
    移除一个元胞自动机刷新信息（CAFlushedEvent）的监听器。
    
    参数:
    
    l - 一个用于接收元胞自动机刷新事务的监听器。
  - setIsDisposable
```
public static void setIsDisposable(com.supermap.data.InternalHandleDisposable obj,
                                   boolean disposable)
```

类 PCACellularAutomata

构造器概要

方法概要

从类继承的方法 com.supermap.data.InternalHandleDisposable

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

构造器详细资料

PCACellularAutomata

方法详细资料

dispose

pca

pca

pcaCellularAutomata

pcaCellularAutomata

saveModel

loadModel

addSteppedListener

removeSteppedListener

addCAFlushedListener

removeCAFlushedListener

setIsDisposable