/ /

$stdDevPop（累加器操作符）

定义

$stdDevPop

计算一群组文档值的总体标准差。如果这些值涵盖了要表示的整个数据总体并且不想进行概括，请使用 $stdDevPop。

如果这些值仅表示总体中的一个示例，请改用 $stdDevSamp。

$stdDevPop累加器可在以下阶段使用：

注意

消歧

本页描述了用作累加器时的 $stdDevPop。累加器返回一群组输入文档的聚合值。

您还可以在其他上下文中使用 $stdDevPop：

$stdDevPop (expression)，返回大量中数值的总体标准差。
$stdDevPop (window function)，在 $setWindowFields 阶段用于计算特定窗口中文档值的总体标准偏差。

语法

{ $stdDevPop: <expression> }

有关表达式的更多信息，请参阅表达式。

行为

结果类型

$stdDevPop 以double形式返回输入值的总体标准差。

非数值或缺失值

$stdDevPop 忽略非数字值，包括缺失值。如果所有输入值都是非数字值，则 $stdDevPop 返回 null。

单值

如果输入由单个数值组成，则 $stdDevPop 返回 0。

例子

本页上的示例使用 sample_mflix 数据集中的数据。有关如何将此数据集加载到自管理MongoDB 部署中的详细信息，请参阅加载样本数据集。如果对示例数据库进行了任何修改，则可能需要删除并重新创建数据库才能运行本页上的示例。

以下示例按导演对电影进行分组，并返回电影数至少为 10 的导演中 IMDb 评分差异最大的五位导演。

db.movies.aggregate( [
   {
      $match: {
         directors: { $exists: true },
         "imdb.rating": { $type: "double" }
      }
   },
   {
      $unwind: "$directors"
   },
   {
      $group: {
         _id: "$directors",
         movieCount: { $sum: 1 },
         stdDevRating: { $stdDevPop: "$imdb.rating" }
      }
   },
   {
      $match: { movieCount: { $gte: 10 } }
   },
   {
      $sort: { stdDevRating: -1 }
   },
   {
      $limit: 5
   }
] )

[
  { _id: 'Bob Clark', movieCount: 12, stdDevRating: 1.6436747447918845 },
  { _id: 'John McTiernan', movieCount: 10, stdDevRating: 1.439305388025766 },
  { _id: 'James Cameron', movieCount: 10, stdDevRating: 1.3683566786477859 },
  { _id: 'Sean McNamara', movieCount: 13, stdDevRating: 1.3499945211372495 },
  {
    _id: 'Robert Rodriguez',
    movieCount: 20,
    stdDevRating: 1.2701476292148088
  }
]

上述管道：

使用 $match过滤具有 directors字段和 IMDb 数字评级的电影。
使用 $unwind 为每个电影的每个导演创建一个文档，因此每个导演-电影对都单独分组。
使用 $group 按导演群组，对电影进行计数，并在 imdb.rating 上使用 $stdDevPop 计算 stdDevRating。
使用 $match 仅保留电影至少为 10 的导演。
使用 $sort 按 stdDevRating 降序返回结果。
使用 $limit 返回前 5 结果。

了解详情