# Matrix Stats（矩陣統計） **matrix_stats**?聚合是一個數字聚合，它會對一組文檔字段計算以下統計數據： | count | 計算中每個字段樣本的數量 | | mean | 每個字段的平均值。 | | variance | 每個字段測量如何從mean 值展開樣本。 | | skewness | 每個字段測量量化mean周圍的不對稱分布。 | | kurtosis | 每個字段測量量化分布的形狀。 | | covariance | 一個矩陣描述一個字段與另一個相關聯字段的變化。 | | correlation | 協方差矩陣縮放到-1到1的范圍。描述字段分布之間的關系。 | 以下示例演示了使用矩陣統計來描述收入與貧困之間的關系。 | `{` `"aggs"``: {` `"matrixstats"``: {` `"matrix_stats"``: {` `"fields"``: [``"poverty"``,?``"income"``]` `}` `}` `}` `}` | 聚合類型是matrix_stats，字段設置定義用于計算統計信息的字段集（作為數組）。上述請求返回以下響應： | `{` `...` `"aggregations"``: {` `"matrixstats"``: {` `"fields"``: [{` `"name"``:?``"income"``,` `"count"``:?``50``,` `"mean"``:?``51985.1``,` `"variance"``:?``7``.383377037755103E7,` `"skewness"``:?``0.5595114003506483``,` `"kurtosis"``:?``2.5692365287787124``,` `"covariance"``: {` `"income"``:?``7``.383377037755103E7,` `"poverty"``: -``21093.65836734694` `},` `"correlation"``: {` `"income"``:?``1.0``,` `"poverty"``: -``0.8352655256272504` `}` `}, {` `"name"``:?``"poverty"``,` `"count"``:?``50``,` `"mean"``:?``12.732000000000001``,` `"variance"``:?``8.637730612244896``,` `"skewness"``:?``0.4516049811903419``,` `"kurtosis"``:?``2.8615929677997767``,` `"covariance"``: {` `"income"``: -``21093.65836734694``,` `"poverty"``:?``8.637730612244896` `},` `"correlation"``: {` `"income"``: -``0.8352655256272504``,` `"poverty"``:?``1.0` `}` `}]` `}` `}` `}` | ## Multi Value Fields matrix_stats聚合將每個文檔字段視為獨立樣本。 mode參數控制聚合將用于數組或多值字段的數組值。此參數可以采取以下之一： | avg | （默認值）使用所有值的平均值。 | | min | 選擇最低值。 | | max | 選擇最大值. | | sum | 使用所有值的總和。 | | median | 使用所有值的中值。 | ## Missing Values 缺少的參數定義了如何處理缺少值的文檔。默認情況下，它們將被忽略，但也可以將它們視為具有值。這是通過添加一組fieldname：值映射來指定每個字段的默認值來完成的。 | `{` `"aggs"``: {` `"matrixstats"``: {` `"matrix_stats"``: {` `"fields"``: [``"poverty"``,?``"income"``],` `"missing"``: {``"income"`?`:?``50000``}??``1` `}` `}` `}` `}` | | 1 | 收入字段中沒有值的文檔的默認值為50000。 | ## Script 此聚合系列尚不支持腳本。