JavaScript ArcGIS summaryStatistics.summaryStatistics用法及代码示例

基本信息

以下是所在类或对象的基本信息。

AMD: require(["esri/smartMapping/statistics/summaryStatistics"], (summaryStatistics) => { /* code goes here */ });

ESM: import summaryStatistics from "@arcgis/core/smartMapping/statistics/summaryStatistics";

函数： esri/smartMapping/statistics/summaryStatistics

自从：用于 JavaScript 4.2 的 ArcGIS API

用法说明

summaryStatistics.summaryStatistics函数(或属性)的定义如下：

summaryStatistics (params) {Promise<SummaryStatisticsResult>}

返回一个对象，其中包含说明从 Layer 中的字段(或表达式)返回的一组值的统计信息。

参数：

规格：

类型说明

params Object

有关每个参数的详细信息，请参见下表。

规格：

layer

为给定 field 生成统计信息的层。

field

String

可选的

将为其生成汇总统计信息的数字或字符串字段的名称。如果使用 valueExpression，则忽略此属性。

valueExpression

String

可选的

遵循 Arcade Visualization Profile 定义的规范的 Arcade 表达式。表达式可以使用 $feature 全局变量引用字段值，并且必须返回一个数字。此属性覆盖 field 属性，因此用于代替输入 field 值。

sqlExpression

String

可选的

计算为数字的 SQL 表达式。

sqlWhere

String

可选的

用于过滤统计查询函数的 SQL where 子句。例如，这在您希望避免除以零的情况下很有用，就像创建优势可视化的情况一样。

normalizationType

String

可选的

确定提供的 field 值如何标准化。此参数仅标准化由 field 引用的数据，不适用于从 valueExpression 或 sqlExpression 返回的值。有关可能值的列表，请参见下表。

可能的值	说明
field	使用在`normalizationField` 参数中指定的字段值除数据值。如果使用此值，则必须提供 `normalizationField`。
percent-of-total	将数据值除以所有数据值的总和，然后乘以 100。使用 `normalizationTotal` 定义要标准化的总值。
log	计算数据值的以 10 为底的对数。这对于查看高度倾斜的数据分布可能是一种有用的方法，因为它减少了异常值的影响。仅计算正值。如果您的数据包含大量负值，则应避免使用这种规范化类型。
natural-log	计算数据值的自然对数。这对于查看高度倾斜的数据分布可能是一种有用的方法，因为它减少了异常值的影响。仅计算正值。如果您的数据包含大量负值，则应避免使用这种规范化类型。
square-root	计算数据值的平方根。这对于查看高度倾斜的数据分布可能是一种有用的方法，因为它减少了异常值的影响。仅计算正值。如果您的数据包含大量负值，则应避免使用这种规范化类型。

可能的值："field"|"log"|"percent-of-total"|"natural-log"|"square-root"

normalizationField

String

可选的

用于规范化从给定 field 返回的值的字段。

normalizationTotal

Number

可选的

仅在 normalizationType 为 percent-of-total 时适用。指示用于标准化字段值的总量。

minValue

Number

可选的

统计计算的最小边界值。将此与 maxValue 结合使用以生成上下限之间的统计信息。

maxValue

Number

可选的

统计计算的最大边界值。将此与 minValue 结合使用以生成上下限之间的统计信息。

view

View

可选的

当指定 valueExpression 时，需要 SceneView 或 MapView 实例。

features

Graphic []

已弃用从 4.23 版开始。请改用useFeaturesInView。

可选的

要为其计算统计数据的特征子集。

useFeaturesInView

Boolean

可选的

仅适用于输入layer是一个service-backed FeatureLayer。什么时候true，将根据视图中可见的函数在客户端上计算统计信息。如果false，将从服务中请求统计信息。从 4.23 版开始。

signal

AbortSignal

可选的

允许可取消的请求。如果取消，promise 将被拒绝，并出现名为 AbortError 的错误。另见AbortController。

类型	说明
Promise<SummaryStatisticsResult>	返回解析为 SummaryStatisticsResult 的承诺。

例子：

summaryStatistics({
  layer: featureLayer,
  valueExpression: "( ($feature.POP2020 - $feature.POP2010) / $feature.POP2010 ) * 100"
  view: mapView
}).then(function(stats){
  colorSlider.statistics = stats;
});

summaryStatistics({
  layer: featureLayer,
  field: "Population",
  normalizationType: "natural-log",
  sqlWhere: "Population > 0",
  numBins: 100
}).then(function(stats){
  histogramWidget.average = stats.avg;
});

相关用法

注：本文由纯净天空筛选整理自arcgis.com大神的英文原创作品 summaryStatistics.summaryStatistics。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。

基本信息

用法说明

参数：

返回：

例子：