定義
ドキュメントのグループ全体の 値の母集団標準偏差を計算します。値が表現したいデータの母集団全体に含まれ、一般化したくない場合は、$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 評価を持つ 5 つの監督を返します。
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 } ] )
先行するパイプライン:
$matchdirectorsを使用して、 フィールドと数値 IMDb 評価を持つ映画をフィルタリングします。$unwindを使用して、1 つの映画につき、役員ごとに 1 つのドキュメントを作成するため、各監督と映画のペアは個別にグループ化されます。$groupを使用して、役員ごとにグループ化し、映画をカウントし、stdDevRating$stdDevPopで を使用してimdb.ratingを計算します。$matchを使用して、少なくとも10 の映画を持っている監督のみを保持します。$sortstdDevRatingを使用して、 の降順で結果を返します。$limit上位の5 結果を返すには、 を使用します。