/ /

$stdDevSamp (função de janela)

Definição

$stdDevSamp

Retorna o desvio padrão da amostra de valores em uma janela.

Observação

Desambiguação

Esta página descreve $stdDevSamp quando usado como uma função de janela.

Você também pode usar $stdDevSamp nestes outros contextos:

$stdDevSamp (accumulator), que calcula o desvio padrão da amostra de valores em um grupo de documentos.
$stdDevSamp (expression), que calcula o desvio padrão da amostra de valores numéricos em uma array.

Sintaxe

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

Comportamento

Tipo de resultado

$stdDevSamp retorna o desvio padrão da amostra dos valores de entrada como double.

Valores não numéricos e ausentes

A função de janela $stdDevSamp ignora valores não numéricos, incluindo valores ausentes. Se a janela não contiver valores numéricos, $stdDevSamp retornará null.

Valor único

Se a janela contiver apenas um documento, $stdDevSamp retornará null.

Exemplo

Os exemplos nesta página usam dados do conjunto de dados sample_mflix. Para obter detalhes sobre como carregar esse conjunto de dados em sua implantação autogerenciada do MongoDB , consulte Carregar o conjunto de dados de amostra. Se você fez modificações nos bancos de dados de amostra, talvez seja necessário descartar e recriar os bancos de dados para executar os exemplos nesta página.

Este exemplo usa $setWindowFields para calcular um campo de desvio padrão de amostra em execução para cada filme Global de 2009 e 2010. Cada documento recebe o valor $stdDevSamp calculado desde o início de sua partição anual até o documento atual.

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
  }
]

O pipeline anterior:

Usa $match para filtrar filmes músicas de 2009 e 2010 com uma classificação numérica do IMDb.
Utiliza $setWindowFields para dividir filmes por year e classificá-los por title. O estágio usa $stdDevSamp com uma janela de documentos de [ "unbounded", "current" ] para criar os seguintes campos para cada documento:
- stdDevSampRatingInYear: o desvio padrão da amostra em execução de imdb.rating.
- rankInYear: um número de linha por partição atribuído por $documentNumber.
O primeiro documento em cada partição tem apenas um valor em sua janela, portanto stdDevSampRatingInYear é null. Cada documento subsequente adiciona mais um valor à janela.
Utiliza $project para incluir title, year, imdb, stdDevSampRatingInYear e rankInYear na saída.
Utiliza $sort para classificar os resultados por ano e título.

Saiba mais

Voltar

$stdDevPop

$sum