$sigimoid (agregação)

Definição

$sigmoid

Executa a função sigmóide, que calcula o percentil de um número na distribuição normal com desvio padrão 1.

A expressão $sigmoid tem a seguinte sintaxe:

{ $sigmoid: { input: <numeric expression>, onNull: <expression>} }

Os argumentos podem ser qualquer expressão válida, desde que sejam produzidos todos os números.

A função sigmóide é equivalente à seguinte operação Algebricamente:

clique para ampliar

Exemplo

Este exemplo utiliza uma coleção myScores que contém os seguintes documentos:

db.myScores.insertMany( [
   { score: 1 },
   { score: 5 },
   {},
   { score: 13 },
   { score: null },
   { score: 21 },
] )

O seguinte pipeline de agregação adiciona um campo scaled a cada documento e utiliza $sigmoid para calcular o valor do campo scaled:

db.myScores.aggregate( [
   { $set: {
      scaled: { $sigmoid: "$score" }
   } }
] )

A operação retorna os seguintes documentos:

{ score: 1, scaled: 0.7310585786 }
{ score: 5, scaled: 0.9933071491 }
{ scaled: null }
{ score: 13, scaled: 0.9999977397 }
{ score: null, scaled: null }
{ score: 19, scaled: 0.9999999992 }