Class: InterpolationIDWAnalystParameters

InterpolationIDWAnalystParameters

反距离加权插值分析参数类。此类除了能够设置插值分析的一系列通用参数,还可以设置反距离加权插值分析中的查找参与运算点的方式、距离权重计算的幂次等参数。
当插值分析类型为 dataset 时,插值分析的数据集名称和插值字段名称为必设参数。当插值分析类型为 geometry 时,插值分析的离散点集合为必设参数。

new InterpolationIDWAnalystParameters(options)

Usage
// 浏览器
<script type="text/javascript" src="https://iclient.supermap.io/dist/openlayers/iclient-ol.js"></script>
<script>
  new ol.supermap.InterpolationIDWAnalystParameters(options);
  
  // 弃用的写法
  new SuperMap.InterpolationIDWAnalystParameters(options);

</script>

// ES6 Import
import { InterpolationIDWAnalystParameters } from '@supermapgis/iclient-ol';

new InterpolationIDWAnalystParameters(options);

common/iServer/InterpolationIDWAnalystParameters.js, line 7
Name Type Description
options Object

参数。

Name Type Default Description
bounds SuperMap.Bounds | L.Bounds | L.LatLngBounds | ol.extent | mapboxgl.LngLatBounds | GeoJSONObject

插值分析的范围,用于确定结果栅格数据集的范围。

searchMode SearchMode

插值运算时,查找参与运算点的方式,支持固定点数查找、定长查找。

outputDatasetName string

插值分析结果数据集的名称。

outputDatasourceName string

插值分析结果数据源的名称。

zValueFieldName string 可选

进行插值分析的字段名称,插值分析不支持文本类型的字段。当插值分析类型(SuperMap.InterpolationAnalystType)为 dataset 时,此为必设参数。

expectedCount number 12 可选

【固定点数查找】方式下,设置待查找的点数,即参与插值运算的点数。

searchRadius number 0 可选

【定长查找】方式下,设置查找半径,即参与运算点的查找范围,与点数据集单位相同。

power number 2 可选

距离权重计算的幂次。

zValueScale number 1 可选

用于进行插值分析值的缩放比率。

resolution number 可选

插值结果栅格数据集的分辨率,即一个像元所代表的实地距离,与点数据集单位相同。

filterQueryParameter FilterParameter 可选

属性过滤条件。

pixelFormat PixelFormat 可选

指定结果栅格数据集存储的像素格式。

dataset string 可选

用于做插值分析的数据源中数据集的名称。该名称用形如”数据集名称@数据源别名”形式来表示。当插值分析类型(SuperMap.InterpolationAnalystType)为 dataset 时,此为必设参数。

inputPoints Array.<(GeometryPoint|L.LatLng|L.Point|ol.geom.Point|mapboxgl.LngLat|Array.<number>)> 可选

用于做插值分析的离散点集合。当插值分析类型(SuperMap.InterpolationAnalystType)为 geometry 时,此为必设参数。

Example
例如:
var myInterpolationIDWAnalystParameters = new InterpolationIDWAnalystParameters({
     dataset:"SamplesP@Interpolation",
     power: 2,
     searchMode: "KDTREE_FIXED_COUNT",
     expectedCount: 12,
     pixelFormat: "BIT16",
     zValueFieldName: "AVG_TMP",
     resolution: 3000,
     filterQueryParameter: {
         attributeFilter: ""
     },
     outputDatasetName: "myIDW"
});

Extends

Members

插值分析的范围,用于确定结果栅格数据集的范围。 如果缺省,则默认为原数据集的范围。鉴于此插值方法为内插方法,原数据集的范围内的插值结果才相对有参考价值, 因此建议此参数不大于原数据集范围。

clipParamClipParameter

对插值分析结果进行裁剪的参数。

datasetstring

用来做插值分析的数据源中数据集的名称,该名称用形如 "数据集名称@数据源别名" 形式来表示。 当插值分析类型(InterpolationAnalystType)为 dataset 时,此为必设参数。

expectedCountnumber

【固定点数查找】方式下,设置待查找的点数,即参与插值运算的点数。

Default Value:
12

filterQueryParameterFilterParameter

过滤条件,对分析数据集中的点进行过滤,设置为 null 表示对数据集中的所有点进行分析。

inputPointsArray.<(GeometryPoint|L.LatLng|L.Point|ol.geom.Point|mapboxgl.LngLat|Array.<number>)>

用于做插值分析的离散点(离散点包括 Z 值)集合。 当插值分析类型(InterpolationAnalystType)为 geometry 时,此为必设参数。 通过离散点直接进行插值分析不需要指定输入数据集 inputDatasourceName,inputDatasetName 以及 zValueFieldName。

InterpolationAnalystTypestring

插值分析类型。插值分析包括数据集插值分析和几何插值分析两类, "dataset" 表示对数据集进行插值分析,"geometry" 表示对离散点数组进行插值分析。

Default Value:
"dataset"

outputDatasetNamestring

插值分析结果数据集的名称。

outputDatasourceNamestring

插值分析结果数据源的名称。

pixelFormatPixelFormat

指定结果栅格数据集存储的像素格式。支持存储的像素格式有 BIT16、BIT32、DOUBLE、SINGLE、UBIT1、UBIT4、UBIT8、UBIT24、UBIT32。

powernumber

距离权重计算的幂次。 该值决定了权值下降的速度,幂次越大,随距离的增大权值下降越快,距离预测点越远的点的权值也越小。 理论上,参数值必须大于 0,但是 0.5 到 3 之间时运算结果更合理,因此推荐值为 0.5 ~ 3。

Default Value:
2

resolutionnumber

插值结果栅格数据集的分辨率,即一个像元所代表的实地距离,与点数据集单位相同。 该值不能超过待分析数据集的范围边长。 且该值设置时,应该考虑点数据集范围大小来取值,一般为结果栅格行列值(即结果栅格数据集范围除以分辨率),在 500 以内可以较好地体现密度走势。

searchModeSearchMode

插值运算时,查找参与运算点的方式,支持固定点数查找、定长查找。 具体如下: {KDTREE_FIXED_COUNT} 使用 KDTREE 的固定点数方式查找参与内插分析的点。 {KDTREE_FIXED_RADIUS} 使用 KDTREE 的定长方式查找参与内插分析的点。

searchRadiusnumber

查找半径,即参与运算点的查找范围,与点数据集单位相同。 计算某个位置的 Z 值时,会以该位置为圆心,以查找范围的值为半径,落在这个范围内的采样点都将参与运算。 该值需要根据待插值点数据的分布状况和点数据集范围进行设置。

zValueFieldNamestring

数据集插值分析中,用于指定进行插值分析的目标字段名,插值分析不支持文本类型的字段。 含义为每个插值点在插值过程中的权重,可以将所有点此字段值设置为 1,即所有点在整体插值中权重相同。 当插值分析类型(InterpolationAnalystType)为 dataset 时,此为必设参数。

zValueScalenumber

用于进行插值分析值的缩放比率。 参加插值分析的值将乘以该参数值后再进行插值,也就是对进行插值分析的值进行统一的扩大或缩小。

Default Value:
1

Methods

destroy()

common/iServer/InterpolationIDWAnalystParameters.js, line 79

释放资源,将引用资源的属性置空。