Definição
Calcula o desvio padrão da população dos valores em um grupo de documentos. Use $stdDevPop se os valores englobarem toda a população de dados que você deseja representar e não quiser generalizar.
Se os valores representam apenas uma amostra da população, use $stdDevSamp.
O acumulador $stdDevPop está disponível nestes estágios:
Observação
Desambiguação
Esta página descreve $stdDevPop quando usado como um acumulador. Acumuladores retornam um valor agregado em um grupo de documentos de entrada.
Você também pode usar $stdDevPop nestes outros contextos:
$stdDevPop (expression), que retorna o desvio padrão da população de valores numéricos em um array.$stdDevPop (window function), que é usado no$setWindowFieldsestágio para calcular o desvio padrão da população de valores de documentos em uma janela específica.
Sintaxe
{ $stdDevPop: <expression> }Para mais informações sobre expressões, consulte Expressões.
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 não forem numéricos, $stdDevPop retorna 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 este conjunto de dados em sua implantação do MongoDB autogerenciado, consulte Carregar o conjunto de dados de amostra. Se você fez alguma modificação nos bancos de dados de amostra, talvez seja necessário descartar e recriar os bancos de dados para executar os exemplos nesta página.
O exemplo a seguir agrupa filmes por diretor e retorna os cinco diretores com as classificações IMDb mais variadas, entre os diretores com pelo menos 10 filmes.
db.movies.aggregate( [ { $match: { directors: { $exists: true }, "imdb.rating": { $type: "double" } } }, { $unwind: "$directors" }, { $group: { _id: "$directors", movieCount: { $sum: 1 }, stdDevRating: { $stdDevPop: "$imdb.rating" } } }, { $match: { movieCount: { $gte: 10 } } }, { $sort: { stdDevRating: -1 } }, { $limit: 5 }] )O pipeline anterior:
Usa
$matchpara filtrar filmes que têm um campodirectorse uma classificação numérica do IMDb.Usa
$unwindpara criar um documento por diretor por filme, assim cada par diretor-filme é agrupado separadamente.Usa
$grouppara agrupar por diretor, contar filmes e calcularstdDevRatingusando$stdDevPopemimdb.rating.Usa
$matchpara manter apenas os diretores com pelo menos 10 filmes.Utiliza
$sortpara retornar resultados em ordem decrescente porstdDevRating.Usa
$limitpara retornar os 5 principais resultados.