$ln (اللوغاريتم الطبيعي)
آخر تحديث: 2026-10-09
$ln (اللوغاريتم الطبيعي)
يُرجع $ln اللوغاريتم الطبيعي (الأساس e) لعدد. يُستخدم في حسابات معدلات النمو وتمهيد البيانات وتحويلات المقياس اللوغاريتمي، مثل أخذ اللوغاريتم الطبيعي للأسعار قبل تحليل الانحدار. الوسيطة الفارغة أو المفقودة تُنتج null؛ ويجب أن يكون الإدخال موجبًا — فالقيم الصفرية أو السالبة تُرجع null. قيمة e تساوي تقريبًا 2.71828. للأساسات الأخرى استخدم $log مع أساس صريح، أو $log10 و $log2 المخصصين. $ln هو معكوس $exp.
| الفئة | الرياضيات |
|---|---|
| إصدار MongoDB | 1.0+ |
| لغة المثال | mongosh (الطرفية) |
📝 الصيغة
{ $ln: <numeric-expression> }
⚙️ المعلمات
| قيمة رقمية | قيمة رقمية أو تعبير يُحلّ إلى قيمة رقمية؛ يجب أن يكون أكبر من 0. |
|---|
القيمة المرجعة:اللوغاريتم الطبيعي للإدخال؛ null إذا كان الإدخال غير موجب أو null أو مفقودًا
▶ مثال
نفّذ الأوامر التالية في mongosh المحلي لديك (يتطلب تشغيل mongod):
// $ln: أخذ اللوغاريتم الطبيعي للمبالغ
db.sales.aggregate([
{ $project: {
logAmount: { $ln: '$amount' }
} }
])
المخرجات:
{ '_id': 1, 'logAmount': 4.605170185988092 }
{ '_id': 2, 'logAmount': 2.995732273553991 }
📌 ملاحظات
- يجب أن يكون الإدخال أكبر من 0؛ القيم الصفرية أو السالبة تُرجع null
- الأساس ثابت عند e؛ استخدم $log للأساسات الأخرى
- معكوس $exp: $exp($ln(x)) يساوي x
🏷️ وسوم ذات صلة
💡 حالات ذات صلة
مزيد من الحالات العملية قريبًا.
📚 دروس ذات صلة
❓ الأسئلة الشائعة
Qما الفرق بين $ln و $log؟
A$ln يستخدم أساسًا ثابتًا هو e؛ $log يأخذ الأساس كوسيطته الثانية.
Qماذا يُرجع $ln للإدخال الصفري أو السالب؟
Aيُرجع null؛ اللوغاريتمات معرّفة للأعداد الموجبة فقط.
Qكيف أستعيد القيمة الأصلية من اللوغاريتم الطبيعي؟
Aطبّق $exp على النتيجة لعكس اللوغاريتم.