W MongoDB $cos
Operator potoku agregacji zwraca cosinus wartości mierzonej w radianach.
$cos
akceptuje każde prawidłowe wyrażenie, które prowadzi do liczby.
$cos
operator został wprowadzony w MongoDB 4.2.
Przykład
Załóżmy, że mamy kolekcję o nazwie test
z następującym dokumentem:
{ "_id" : 1, "data" : 3 }
Możemy użyć $cos
operator zwracający cosinus data
pole:
db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
cosine: { $cos: "$data" }
}
}
]
)
Wynik:
{ "cosine" : -0.9899924966004454 }
Domyślnie $cos
operator zwraca wartości jako double
, ale może również zwracać wartości jako 128-bitowe wartości dziesiętne, o ile wyrażenie daje wynik 128-bitowej wartości dziesiętnej.
Kiedy wyrażenie jest w stopniach
Jak wspomniano, $cos
przyjmuje swój wyraz w radianach. Możesz użyć $degreesToRadians
operatora do konwersji dowolnych wartości ze stopni na radiany.
Przykład:
db.test.aggregate(
[
{ $match: { _id: 1 } },
{ $project: {
_id: 0,
cosine: { $degreesToRadians: { $cos: "$data" } }
}
}
]
)
Wynik:
{ "cosine" : -0.017278628635716543 }
Wartości puste
Wartości null zwracają null
podczas korzystania z $cos
operatora.
Załóżmy, że do naszej kolekcji dodamy następujący dokument:
{ "_id" : 3, "data" : null }
Uruchommy $cos
operatora względem tego dokumentu:
db.test.aggregate(
[
{ $match: { _id: 3 } },
{ $project: {
_id: 0,
cosine: { $cos: "$data" }
}
}
]
)
Wynik:
{ "cosine" : null }
Widzimy, że wynikiem jest null
.
Wartości NaN
Jeśli argument kończy się na NaN
, $cos
zwraca NaN
.
Przykład:
db.test.aggregate(
[
{ $match: { _id: 3 } },
{ $project: {
_id: 0,
cosine: { $cos: 1 * "string" }
}
}
]
)
Wynik:
{ "cosine" : NaN }
W tym przypadku próbowałem pomnożyć liczbę przez ciąg, co spowodowało NaN
zostanie zwrócony.
Nieskończoność
Jeśli argument kończy się na Infinity
lub -Infinity
, $cos
operator zwraca błąd.
Załóżmy, że do naszej kolekcji dodamy następujący dokument:
{ "_id" : 4, "data" : Infinity }
Uruchommy $cos
względem pola danych:
db.test.aggregate(
[
{ $match: { _id: 4 } },
{ $project: {
_id: 0,
cosine: { $cos: "$data" }
}
}
]
)
Wynik:
uncaught exception: Error: command failed: { "ok" : 0, "errmsg" : "cannot apply $cos to inf, value must in (-inf,inf)", "code" : 50989, "codeName" : "Location50989" } : aggregate failed : [email protected]/mongo/shell/utils.js:25:13 [email protected]/mongo/shell/assert.js:18:14 [email protected]/mongo/shell/assert.js:618:17 [email protected]/mongo/shell/assert.js:708:16 [email protected]/mongo/shell/db.js:266:5 [email protected]/mongo/shell/collection.js:1046:12 @(shell):1:1
To jest błąd, który pojawia się w mongo
powłoka.
Nieistniejące pola
Jeśli $cos
operator jest stosowany do pola, które nie istnieje, null
jest zwracany.
Przykład:
db.test.aggregate(
[
{ $match: { _id: 4 } },
{ $project: {
_id: 0,
cosine: { $cos: "$carrots" }
}
}
]
)
Wynik:
{ "cosine" : null }
128-bitowa liczba dziesiętna
Jak wspomniano, jeśli wyrażenie dostarczone do $cos
jest 128-bitowy dziesiętny, to wynik jest zwracany w 128-bitowym dziesiętnym.
Załóżmy, że dodajemy do kolekcji następujący dokument:
{ "_id" : 5, "data" : NumberDecimal("1.1301023541559787031443874490659") }
Oto, co się dzieje, gdy uruchamiamy to przez $cos
operator:
db.test.aggregate(
[
{ $match: { _id: 5 } },
{ $project: {
_id: 0,
cosine: { $cos: "$data" }
}
}
]
)
Wynik:
{ "cosine" : NumberDecimal("0.4265672353490945266548815934449746") }
Dane wyjściowe są 128-bitowe po przecinku.