/ /

$stdDevPop (função de janela)

Definição

$stdDevPop

Retorna o desvio padrão da população de valores de documentos em uma janela específica.

Observação

Desambiguação

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

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

$stdDevPop (accumulator), que retorna o desvio padrão da população de valores em um grupo de documentos.
$stdDevPop (expression), que retorna o desvio padrão da população de valores numéricos em uma array.

Sintaxe

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

Comportamento

Tipo de resultado

$stdDevPop retorna o desvio padrão da população dos valores de entrada como double.

Non-Numeric Values

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

Valor único

Se a entrada consistir em um único valor numérico, $stdDevPop retornará 0.

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 adicionar a cada documento um campo que contém o desvio padrão da população em execução das classificações do IMDb para Murais de 2009 e 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
  }
]

O pipeline anterior:

Usa $match para filtrar Murais 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 $stdDevPop com uma janela de documentos de [ "unbounded", "current" ] para criar stdDevPopRatingInYear. O campo stdDevPopRatingInYear contém o desvio padrão da população em execução de imdb.rating desde o início da partição até o documento atual. $documentNumber atribui um número de linha por partição (rankInYear) a cada documento.
Utiliza $project para incluir title, year, imdb, stdDevPopRatingInYear e rankInYear na saída.
Utiliza $sort para classificar os resultados por ano e título.

Voltar

$push

$stdDevSamp