/ /

$stdDevPop (expressão)

Definição

$stdDevPop

Retorna o desvio padrão da população de valores numéricos em uma array.

Observação

Desambiguação

Esta página descreve $stdDevPop quando usado como expressão.

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 (window function), que é usado no estágio $setWindowFields para calcular o desvio padrão da população de valores de documentos em uma janela específica.

Sintaxe

Quando usado como expressão, $stdDevPop tem uma das duas sintaxes a seguir:

{ $stdDevPop: <expression> }

Na sintaxe anterior, o operando é uma única expressão que avalia para uma matriz. $stdDevPop atravessa a array e retorna o desvio padrão da população dos valores numéricos da array.

{ $stdDevPop: [ <expression1>, <expression2>, ... ] }

Na sintaxe anterior, cada expressão deve avaliar para um único valor numérico. $stdDevPop retorna o desvio padrão da população desses valores. Valores não numéricos são ignorados.

Comportamento

Tipo de resultado

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

Valores não numéricos ou ausentes

$stdDevPop ignora valores não numéricos, incluindo valores ausentes. Se todos os valores de entrada forem não numéricos, $stdDevPop retornará null.

Valor único

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

Exemplo

Crie uma coleção testScores:

db.testScores.insertMany( [
   { studentId: "2345", scores: [ 62, 81, 80, 75, 68, 72, 74, 78, 69, 77 ] },
   { studentId: "2356", scores: [ 60, 83, 79, 72, 65, 71, 68, 74, 64, 76 ] },
   { studentId: "2358", scores: [ 67, 82, 78, 70, 84, 73, 79, 71, 88, 75 ] },
   { studentId: "2367", scores: [ 64, 72, 77, 58, 91, 66, 83, 55, 94, 61 ] },
   { studentId: "2369", scores: [ 60, 53, 72, 85, 63, 88, 57, 79, 66, 74 ] }
] )

O pipeline a seguir usa $stdDevPop para calcular o desvio padrão populacional das pontuações nos testes de cada aluno:

db.testScores.aggregate( [
   {
      $project: {
         _id: 0,
         studentId: 1,
         scoreStdDev: {
            $stdDevPop: "$scores"
         }
      }
   }
] )

[
  {
    studentId: '2345',
    scoreStdDev: 5.642694391866354
  },
  {
    studentId: '2356',
    scoreStdDev: 6.7646138101151045
  },
  {
    studentId: '2358',
    scoreStdDev: 6.356886030125126
  },
  {
    studentId: '2367',
    scoreStdDev: 13.026511428621248
  },
  {
    studentId: '2369',
    scoreStdDev: 11.278741064498291
  }
]

No pipeline anterior, $project com $stdDevPop calcula o desvio padrão da população da array scores de cada aluno e o retorna como scoreStdDev.

Voltar

$sqrt

$stdDevSamp