/ /

$stdDevPop (función de ventana)

Definición

$stdDevPop

Devuelve la desviación estándar poblacional de los valores de los documentos en una ventana determinada.

Nota

Desambiguación

Esta página describe $stdDevPop cuando se utiliza como función de ventana.

También puedes usar $stdDevPop en estos otros contextos:

$stdDevPop (accumulator), que devuelve la desviación estándar poblacional de los valores en un grupo de documentos.
$stdDevPop (expression), que devuelve la desviación estándar poblacional de los valores numéricos en una matriz.

Sintaxis

{
   $setWindowFields: {
      ...
      output: {
         <field>: {
            $stdDevPop: <expression>
         }
      }
   }
}

Comportamiento

Tipo de resultado

$stdDevPop devuelve la desviación estándar de la población de los valores de entrada como un double.

Non-Numeric Values

La función de ventana $stdDevPop ignora los valores no numéricos. Si la ventana no contiene valores numéricos, $stdDevPop devuelve null.

Valor único

Si la entrada consiste en un único valor numérico, $stdDevPop devuelve 0.

Ejemplo

Los ejemplos de esta página utilizan datos del conjunto de datos sample_mflix. Para obtener más información sobre cómo cargar este conjunto de datos en su implementación autogestionada de MongoDB, consulte Cargar el conjunto de datos de ejemplo. Si realizó alguna modificación en las bases de datos de ejemplo, es posible que deba eliminarlas y volver a crearlas para ejecutar los ejemplos de esta página.

Este ejemplo utiliza $setWindowFields para agregar a cada documento un campo que contiene la desviación estándar poblacional acumulada de las calificaciones de IMDb para musicales de 2009 y 2010.

db.movies.aggregate( [
   {
      $match: {
         genres: "Musical",
         year: { $in: [ 2009, 2010 ] },
         "imdb.rating": { $type: "double" }
      }
   },
   {
      $setWindowFields: {
         partitionBy: "$year",
         sortBy: { title: 1 },
         output: {
            stdDevPopRatingInYear: {
               $stdDevPop: "$imdb.rating",
               window: {
                  documents: [ "unbounded", "current" ]
               }
            },
            rankInYear: {
               $documentNumber: {}
            }
         }
      }
   },
   {
      $project: {
         _id: 0,
         title: 1,
         year: 1,
         "imdb.rating": 1,
         stdDevPopRatingInYear: 1,
         rankInYear: 1
      }
   },
   { $sort: { year: 1, title: 1 } }
] )

[
  {
    imdb: {
      rating: 6.3
    },
    year: 2009,
    title: 'Bran Nue Dae',
    stdDevPopRatingInYear: 0,
    rankInYear: 1
  },
  {
    title: 'Face',
    year: 2009,
    imdb: {
      rating: 5.9
    },
    stdDevPopRatingInYear: 0.1999999999999995,
    rankInYear: 2
  },
  {
    imdb: {
      rating: 5
    },
    year: 2009,
    title: 'Fame',
    stdDevPopRatingInYear: 0.5436502143433362,
    rankInYear: 3
  },
  {
    title: 'Guy and Madeline on a Park Bench',
    year: 2009,
    imdb: {
      rating: 6.1
    },
    stdDevPopRatingInYear: 0.4968651728587945,
    rankInYear: 4
  },
  {
    title: 'Lo',
    year: 2009,
    imdb: {
      rating: 6.6
    },
    stdDevPopRatingInYear: 0.5418486873657623,
    rankInYear: 5
  },
  {
    imdb: {
      rating: 5.9
    },
    year: 2009,
    title: 'Nine',
    stdDevPopRatingInYear: 0.4955356249106166,
    rankInYear: 6
  },
  {
    title: 'Oxygen',
    year: 2009,
    imdb: {
      rating: 6.8
    },
    stdDevPopRatingInYear: 0.5436085025840125,
    rankInYear: 7
  },
  {
    title: 'Ricky Rapper and the Bicycle Thief',
    year: 2009,
    imdb: {
      rating: 5.3
    },
    stdDevPopRatingInYear: 0.5710461890250208,
    rankInYear: 8
  },
  {
    title: 'Stingray Sam',
    year: 2009,
    imdb: {
      rating: 7.2
    },
    stdDevPopRatingInYear: 0.659592092429148,
    rankInYear: 9
  },
  {
    title: 'Anjaana Anjaani',
    year: 2010,
    imdb: {
      rating: 5.8
    },
    stdDevPopRatingInYear: 0,
    rankInYear: 1
  },
  {
    title: 'Basilicata Coast to Coast',
    year: 2010,
    imdb: {
      rating: 6.7
    },
    stdDevPopRatingInYear: 0.4500000000000002,
    rankInYear: 2
  },
  {
    title: 'Camp Rock 2: The Final Jam',
    year: 2010,
    imdb: {
      rating: 5.1
    },
    stdDevPopRatingInYear: 0.6548960901462835,
    rankInYear: 3
  },
  {
    title: 'Pure Country 2: The Gift',
    year: 2010,
    imdb: {
      rating: 4.9
    },
    stdDevPopRatingInYear: 0.7048936089935841,
    rankInYear: 4
  },
  {
    title: 'Score: A Hockey Musical',
    year: 2010,
    imdb: {
      rating: 4.8
    },
    stdDevPopRatingInYear: 0.7116178749862878,
    rankInYear: 5
  },
  {
    title: 'StarStruck',
    year: 2010,
    imdb: {
      rating: 6.2
    },
    stdDevPopRatingInYear: 0.7057305119913376,
    rankInYear: 6
  },
  {
    title: 'The Ugly Duckling',
    year: 2010,
    imdb: {
      rating: 6.7
    },
    stdDevPopRatingInYear: 0.7613092911128131,
    rankInYear: 7
  }
]

La tubería precedente:

Utiliza $match para filtrar los musicales de 2009 y 2010 con una calificación numérica de IMDb.
Utiliza $setWindowFields para particionar las películas por year y ordenarlas por title. La etapa utiliza $stdDevPop con una ventana de documentos de [ "unbounded", "current" ] para crear stdDevPopRatingInYear. El campo stdDevPopRatingInYear contiene la desviación estándar acumulada de la población de imdb.rating desde el inicio de la partición hasta el documento actual. $documentNumber asigna un número de fila por partición (rankInYear) a cada documento.
Utiliza $project para incluir title, year, imdb, stdDevPopRatingInYear y rankInYear en la salida.
Utiliza $sort para ordenar los resultados por año y título.

Volver

$setUnion

$stdDevSamp