/ /

$covariancePop (operador de expresión)

Definición

Nuevo en la versión 5.0.

$covariancePop

Devuelve la covarianza poblacional de dos números. expresiones que se evalúan utilizando documentos en la ventana $setWindowFieldsde la etapa.

$covariancePop solo está disponible en la $setWindowFields etapa.

$covariancePop sintaxis:

{
   $covariancePop:
   [
      <numeric expression 1>,
      <numeric expression 2>
   ]
}

Comportamiento

$covariancePop comportamiento:

Ignora valores no numéricos, valores null y campos faltantes en una ventana.
Si la ventana contiene un documento, se devuelve null. (Compárese con $covarianceSamp, que devuelve null si la ventana contiene un documento).
Si la ventana está vacía, devuelve null.
Si la ventana contiene un valor NaN, devuelve NaN.
Si la ventana contiene uno o más valores Infinity que son todos positivos o todos negativos, devuelve Infinity. El valor Infinity devuelto tiene el mismo signo que los valores Infinity de la ventana.
Si la ventana contiene Infinity valores con signos diferentes, devuelve NaN.
Si la ventana contiene un valor decimal, devuelve un valor decimal.
Si ninguno de los puntos anteriores aplica, devuelve un valor de double.

Los valores devueltos en orden de precedencia son los siguientes:

NaN
Infinity
decimal
double

Ejemplo

Crea una colección de cakeSales que incluya ventas de pasteles en el estado de California (CA) y Washington (WA):

db.cakeSales.insertMany( [
   { _id: 0, type: "chocolate", orderDate: new Date("2020-05-18T14:10:30Z"),
     state: "CA", price: 13, quantity: 120 },
   { _id: 1, type: "chocolate", orderDate: new Date("2021-03-20T11:30:05Z"),
     state: "WA", price: 14, quantity: 140 },
   { _id: 2, type: "vanilla", orderDate: new Date("2021-01-11T06:31:15Z"),
     state: "CA", price: 12, quantity: 145 },
   { _id: 3, type: "vanilla", orderDate: new Date("2020-02-08T13:13:23Z"),
     state: "WA", price: 13, quantity: 104 },
   { _id: 4, type: "strawberry", orderDate: new Date("2019-05-18T16:09:01Z"),
     state: "CA", price: 41, quantity: 162 },
   { _id: 5, type: "strawberry", orderDate: new Date("2019-01-08T06:12:03Z"),
     state: "WA", price: 43, quantity: 134 }
] )

Este ejemplo utiliza $covariancePop en la etapa para generar los valores de covarianza de la población para las ventas de pasteles $setWindowFields del orderDate año y los quantity valores:

db.cakeSales.aggregate( [
   {
      $setWindowFields: {
         partitionBy: "$state",
         sortBy: { orderDate: 1 },
         output: {
            covariancePopForState: {
               $covariancePop: [ { $year: "$orderDate" }, "$quantity" ],
               window: {
                  documents: [ "unbounded", "current" ]
               }
            }
         }
      }
   }
] )

En el ejemplo:

partitionBy: "$state" particiona los documentos de la colección en state. Existen particiones para CA y WA.
sortBy: { orderDate: 1 } ordena los documentos de cada partición por orderDate en orden ascendente (1), de modo que el orderDate más antiguo sea el primero.

output Establece los valores de covarianza de la población para el orderDate año y los quantity valores utilizando la ejecución $covariancePop en una ventana de documentos.
La ventana contiene documentos entre un unbounded límite inferior y el current documento en el resultado. Esto significa que $covariancePop establece el campo covariancePopForState con los valores de covarianza poblacional para los documentos entre el principio de la partición y el documento actual.

En esta salida, la covarianza poblacional se muestra en el campo covariancePopForState:

{ "_id" : 4, "type" : "strawberry", "orderDate" : ISODate("2019-05-18T16:09:01Z"),
  "state" : "CA", "price" : 41, "quantity" : 162, "covariancePopForState" : 0 }
{ "_id" : 0, "type" : "chocolate", "orderDate" : ISODate("2020-05-18T14:10:30Z"),
  "state" : "CA", "price" : 13, "quantity" : 120, "covariancePopForState" : -10.5 }
{ "_id" : 2, "type" : "vanilla", "orderDate" : ISODate("2021-01-11T06:31:15Z"),
  "state" : "CA", "price" : 12, "quantity" : 145, "covariancePopForState" : -5.666666666666671 }
{ "_id" : 5, "type" : "strawberry", "orderDate" : ISODate("2019-01-08T06:12:03Z"),
  "state" : "WA", "price" : 43, "quantity" : 134, "covariancePopForState" : 0 }
{ "_id" : 3, "type" : "vanilla", "orderDate" : ISODate("2020-02-08T13:13:23Z"),
  "state" : "WA", "price" : 13, "quantity" : 104, "covariancePopForState" : -7.5 }
{ "_id" : 1, "type" : "chocolate", "orderDate" : ISODate("2021-03-20T11:30:05Z"),
  "state" : "WA", "price" : 14, "quantity" : 140, "covariancePopForState" : 2 }

Volver

$cosh

$covarianceSamp