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。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。

基本信息

用法說明

參數：

返回：

例子：