/ /

$stdDevSamp (función de ventana)

Definición

$stdDevSamp

Devuelve la desviación estándar muestral de los valores en una ventana.

Nota

Desambiguación

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

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

$stdDevSamp (accumulator), que calcula la desviación estándar de la muestra de valores en un grupo de documentos.
$stdDevSamp (expression), que calcula la desviación estándar de la muestra de valores numéricos en una matriz.

Sintaxis

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

Comportamiento

Tipo de resultado

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

Valores no numéricos y valores faltantes

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

Valor único

Si la ventana contiene solo un documento, $stdDevSamp devuelve null.

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 calcular un campo de desviación estándar de muestra móvil para cada película musical a partir de 2009 y 2010. Cada documento recibe el valor $stdDevSamp calculado desde el inicio de su partición anual hasta el documento actual.

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

[
  {
    imdb: { rating: 6.3 },
    year: 2009,
    title: 'Bran Nue Dae',
    stdDevSampRatingInYear: null,
    rankInYear: 1
  },
  {
    title: 'Face',
    year: 2009,
    imdb: { rating: 5.9 },
    stdDevSampRatingInYear: 0.28284271247461834,
    rankInYear: 2
  },
  {
    imdb: { rating: 5 },
    year: 2009,
    title: 'Fame',
    stdDevSampRatingInYear: 0.6658328118479391,
    rankInYear: 3
  },
  {
    title: 'Guy and Madeline on a Park Bench',
    year: 2009,
    imdb: { rating: 6.1 },
    stdDevSampRatingInYear: 0.5737304826019499,
    rankInYear: 4
  },
  {
    title: 'Lo',
    year: 2009,
    imdb: { rating: 6.6 },
    stdDevSampRatingInYear: 0.605805249234438,
    rankInYear: 5
  },
  {
    imdb: { rating: 5.9 },
    year: 2009,
    title: 'Nine',
    stdDevSampRatingInYear: 0.5428320796219271,
    rankInYear: 6
  },
  {
    title: 'Oxygen',
    year: 2009,
    imdb: { rating: 6.8 },
    stdDevSampRatingInYear: 0.5871642911161274,
    rankInYear: 7
  },
  {
    title: 'Ricky Rapper and the Bicycle Thief',
    year: 2009,
    imdb: { rating: 5.3 },
    stdDevSampRatingInYear: 0.6104740546727364,
    rankInYear: 8
  },
  {
    title: 'Stingray Sam',
    year: 2009,
    imdb: { rating: 7.2 },
    stdDevSampRatingInYear: 0.6996030620605118,
    rankInYear: 9
  },
  {
    title: 'Anjaana Anjaani',
    year: 2010,
    imdb: { rating: 5.8 },
    stdDevSampRatingInYear: null,
    rankInYear: 1
  },
  {
    title: 'Basilicata Coast to Coast',
    year: 2010,
    imdb: { rating: 6.7 },
    stdDevSampRatingInYear: 0.636396103067893,
    rankInYear: 2
  },
  {
    title: 'Camp Rock 2: The Final Jam',
    year: 2010,
    imdb: { rating: 5.1 },
    stdDevSampRatingInYear: 0.8020806277010645,
    rankInYear: 3
  },
  {
    title: 'Pure Country 2: The Gift',
    year: 2010,
    imdb: { rating: 4.9 },
    stdDevSampRatingInYear: 0.8139410298049852,
    rankInYear: 4
  },
  {
    title: 'Score: A Hockey Musical',
    year: 2010,
    imdb: { rating: 4.8 },
    stdDevSampRatingInYear: 0.7956129712366433,
    rankInYear: 5
  },
  {
    title: 'StarStruck',
    year: 2010,
    imdb: { rating: 6.2 },
    stdDevSampRatingInYear: 0.7730890418746516,
    rankInYear: 6
  },
  {
    title: 'The Ugly Duckling',
    year: 2010,
    imdb: { rating: 6.7 },
    stdDevSampRatingInYear: 0.8223080178318075,
    rankInYear: 7
  }
]

La tubería precedente:

Utiliza $match para filtrar películas 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 $stdDevSamp con una ventana de documentos de [ "unbounded", "current" ] para crear los siguientes campos para cada documento:
- stdDevSampRatingInYear: la desviación estándar de la muestra móvil de imdb.rating.
- rankInYear: un número de fila por partición asignado por $documentNumber.
El primer documento de cada partición tiene un solo valor en su ventana, por lo que stdDevSampRatingInYear es null. Cada documento subsiguiente añade un valor más a la ventana.
Utiliza $project para incluir title, year, imdb, stdDevSampRatingInYear y rankInYear en la salida.
Utiliza $sort para ordenar los resultados por año y título.

Obtén más información

Volver

$stdDevPop

$sum