> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/arabic/alblwkat-alwzyfyh/blocks-reference/data-logic/mathmetical-operations/trigonometry.md).

# Trigonometry

هذا البلوك الوظيفي يقوم بعمليات مثلثية شائعة باستخدام الدرجات ونسب بسيطة. مفيد لتحويل الزوايا إلى قيم نسبة (مثل الجيب/الظل) أو تحويل النسب مرة أخرى إلى زوايا (الجيب العكسي/ظل العكسي) لمهام القياس والهندسة.

## 📥 المدخلات <a href="#inputs" id="inputs"></a>

`Number` أدخل قيمة رقمية. للدوال المباشرة (`Sin`, `Tan`) ضع زاوية بالدرجات. للدوال العكسية (`Asin`, `Atan`) ضع قيمة نسبة (نطاق القيم يعتمد على الدالة).

## 📤 المخرجات <a href="#outputs" id="outputs"></a>

`Number` النتيجة الرقمية للعملية المثلثية المحددة. نواتج الدوال العكسية تكون بالدرجات.

## 🕹️ عناصر التحكم <a href="#controls" id="controls"></a>

`Method` اختر العملية المثلثية المراد تطبيقها. الخيارات المتوافرة عادة تشمل `Sin`, `Asin`, `Tan`, و`Atan`.

## 🎨 الميزات <a href="#features" id="features"></a>

* اختيار سهل بين الدوال المثلثية المباشرة والعكسية عبر قائمة منسدلة بسيطة.
* يقبل مدخلاً رقمياً واحدًا ويعيد مخرجاً رقمياً واحدًا.
* يستخدم الدرجات للمدخلات والمخرجات لجعل الاستخدام بديهيًا لغير المختصين.

## ⚙️ آلية التشغيل <a href="#running-mechanism" id="running-mechanism"></a>

عند تشغيل البلوك يطبق العملية المحددة على القيمة التي تزودها:

* بالنسبة لـ `Sin` و`Tan`: يتعامل البلوك مع المدخل بوصفه زاوية بالدرجات، يحولها داخليًا إلى التمثيل المطلوب ويعيد قيمة النسبة.
* بالنسبة لـ `Asin` و`Atan`: يتعامل البلوك مع المدخل كقيمة نسبة ويعيد الزاوية المقابلة بالدرجات.

هذا يتيح لك التحويل بين زاوية ونسبة (مفيد لحساب أطوال أو مكونات) والعكس لتحويل نسب مقاسة إلى زوايا للتقارير أو المنطق التحكمي.

## 📝 تعليمات الاستخدام <a href="#usage" id="usage"></a>

1. قم بإدخال قيمة رقمية في مدخل `Number`.
2. اختر العملية المطلوبة عبر عنصر التحكم `Method`.
3. اطلع على النتيجة من مخرج `Number`.

* لتحويل زاوية إلى نسبة استخدم `Sin` أو `Tan`.
* لتحويل نسبة إلى زاوية استخدم `Asin` أو `Atan`.

## 💡 نصائح وحيل <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* استخدم `Measure Position Distance` للحصول على المسافات X وY بين نقطتين، ثم استخدم `Divide` لإنتاج نسبة و`Atan` لحساب الزاوية بينهما.
* لحساب الوتر من أطوال الأضلاع، اجمع `Square Root` و`Add` بعد تربيع المكونات بـ`Multiply`، ثم استخدم `Asin` أو `Atan` للحصول على الزوايا إذا لزم.
* اقترن مع `Round` لعرض زوايا بصيغة سهلة القراءة (مثلاً تقريب إلى منزلة أو منزلتين عشرية).
* استخدم `Absolute` قبل الدوال العكسية عندما يهمك مقدار النسبة فقط.
* اجمع مع `Line Geometry` عند العمل على خطوط مرسومة: استخدم هذا البلوك لتحويل بين النسب المقاسة والزوايا للتعليقات أو المنطق اللاحق.

## 🛠️ استكشاف الأخطاء وإصلاحها <a href="#troubleshooting" id="troubleshooting"></a>

* إذا بدت النتائج كبيرة جدًا أو صغيرة جدًا، تحقق مما إذا كان يجب إدخال زاوية (بالدرجات) أو نسبة في مدخل `Number` بحسب `Method` المحدد.
* للدوال العكسية تأكد أن نسب الإدخال ضمن النطاقات المسموح بها (مثلاً، القيم خارج المجال الصالح لـ `Asin` لن تعطي زوايا مفيدة).