Definición
Devuelve la desviación estándar de muestra de los valores numéricos en un arreglo.
Nota
Desambiguación
Esta página describe $stdDevSamp cuando se utiliza como una expresión, que devuelve la desviación estándar de muestra de valores numéricos en un arreglo.
También puede usar $stdDevSamp en estos otros contextos:
$stdDevSamp (accumulator), que calcula la desviación estándar de la muestra de los valores en un grupo de documentos.$stdDevSamp (window function), que se utiliza en el$setWindowFieldspara calcular la desviación estándar de muestra de los valores en una ventana.
Sintaxis
Cuando se utiliza como una expresión, $stdDevSamp tiene una de estas sintaxis:
{ $stdDevSamp: <expression> }En la sintaxis anterior, el operando es una única expresión que se evalúa como un arreglo. $stdDevSamp recorre el arreglo y devuelve la desviación estándar muestra de los valores numéricos del arreglo.
{ $stdDevSamp: [ <expression1>, <expression2>, ... ] }En la sintaxis anterior, cada expresión debe evaluarse como un único valor numérico. $stdDevSamp devuelve la desviación estándar de la muestra de esos valores. Los valores no numéricos se ignoran.
Comportamiento
Tipo de resultado
$stdDevSamp devuelve la desviación estándar muestral de los valores de entrada como un double.
Non-Numeric Values
$stdDevSamp ignora valores no numéricos, valores nulos, y campos faltantes. Si todos los valores de entrada no son numéricos o faltan, $stdDevSamp devuelve null.
Valor único
Si solo hay un valor de entrada numérico, $stdDevSamp devuelve null.
Ejemplo
Cree una colección 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 ] }] )El siguiente pipeline utiliza $stdDevSamp para calcular la desviación estándar de muestra de las puntuaciones de las pruebas de cada estudiante:
db.testScores.aggregate( [ { $project: { _id: 0, studentId: 1, scoreStdDev: { $stdDevSamp: "$scores" } } }] )En el pipeline anterior, $project con $stdDevSamp calcula la desviación estándar de la muestra del arreglo scores de cada estudiante y lo devuelve como scoreStdDev.