$atan2 (قوس الظل بوسيطين)

آخر تحديث: 2026-10-09

$atan2 (قوس الظل بوسيطين)

يُرجع $atan2 زاوية الاتجاه بالراديان من إحداثي y وإحداثي x، مع أخذ الوسيطات بالترتيب [y, x]. يتعامل مع الأرباع الأربعة بشكل صحيح وهو العملية الرئيسية لتحويل الإحداثيات الديكارتية إلى الصيغة القطبية. يُستخدم في حسابات الاتجاه والملاحة والتدوير في الرسوميات، مثل اشتقاق زاوية المسار من فرق الإحداثيات. الوسيطة الفارغة أو المفقودة تُنتج null، وتكون النتيجة غير معرّفة عندما يكون كل من y و x صفرًا. وعلى خلاف $atan يحافظ على معلومات الربع، مُرجعًا قيمًا من -π إلى π.

📝 الصيغة

{ $atan2: [ <y>, <x> ] }

⚙️ المعلمات

القيمة المرجعة：زاوية الاتجاه بالراديان؛ null عندما يكون null أو مفقودًا، وغير معرَّفة عندما يكون كلٌّ من y وx صفرًا

▶ مثال

نفّذ الأوامر التالية في mongosh المحلي لديك (يتطلب تشغيل mongod):

// $atan2: زاوية الاتجاه من إحداثيي x و y
db.points.aggregate([
  { $project: {
      bearing: { $atan2: ['$y', '$x'] }
  } }
])

المخرجات：

{ '_id': 1, 'bearing': 0.7853981633974483 }
{ '_id': 2, 'bearing': -1.1071487177940904 }

📌 ملاحظات

• الوسيطات y أولًا ثم x — لا تبدّلهما
• تمتد النتائج من -π إلى π، مميزةً الأرباع الأربعة
• النتيجة غير معرّفة عندما يكون كل من y و x صفرًا؛ صفِّ هذه الحالة أولًا

🏷️ وسوم ذات صلة

💡 حالات ذات صلة

📚 دروس ذات صلة

❓ الأسئلة الشائعة

فريق Web-Tutorial التقني

منصة دروس برمجية يديرها عدة مطورين. كل درس يتم كتابته ومراجعته بواسطة مطورين متخصصين في المجال. نعمل على ضمان دقة وموثوقية المحتوى — إذا لاحظت أي مشكلة، فيرجى إخبارنا.

من نحن