وثائق ONNX

الوصف

تُعد وثائق ONNX 1.23.0 موردًا شاملاً لفهم واستخدام تنسيق Open Neural Network Exchange. تبدأ بمقدمة عن ONNX ومفاهيمه الأساسية، وتوجه المستخدمين خلال تكامله مع Python. يتم توفير مرجع شامل لواجهة برمجة التطبيقات (API)، يشمل استراتيجيات إدارة الإصدارات، وهياكل البيانات، والدوال، وقائمة مفصلة بمشغلات ONNX.

يتم تفصيل الجوانب التقنية، بما في ذلك تفاصيل تخزين الأعداد العشرية (float) بـ 8 بت، وتنفيذ أنواع الأعداد الصحيحة بـ 4 بت و 2 بت. تتناول الوثائق أيضًا مستودع ONNX (ONNX Repository)، وتقدم إرشادات حول إضافة تعريفات الدوال للمشغلات وعملية تقديم مشغلات أو دوال جديدة إلى نظام ONNX البيئي. تُعد حالات ضمان الأمان (Security Assurance Cases) جزءًا من الوثائق أيضًا، مما يسلط الضوء على التزام ONNX بالتطوير القوي.

تتعمق أقسام تقنية إضافية في آليات البث (broadcasting) داخل ONNX، ودليل لعلامات قابلية الاشتقاق (differentiability tags)، وتسميات الأبعاد (dimension denotation)، والتعامل مع البيانات الخارجية. يتم تقديم مواصفات تمثيل ONNX الوسيط (ONNX IR Specification)، جنبًا إلى جنب مع تعليمات لتنفيذ واجهة خلفية لـ ONNX (ONNX Backend). تتم تغطية إدارة المشغلات التجريبية والبيانات الوصفية (metadata) أيضًا، بالإضافة إلى أنواع ONNX (ONNX Types) ومجموعة اختبارات الواجهة الخلفية لـ ONNX (ONNX Backend Test suite).

توفر المعلومات حول الإصدارات الرسمية لـ ONNX واتفاقيات المشغلات سياقًا لتطور الإطار. يتم تضمين نظرة عامة على واجهة برمجة تطبيقات Python (Python API) وطرق التحقق من إصدارات PyPI باستخدام إثباتات Sigstore للمطورين. أخيرًا، تتطرق الوثائق إلى أمان البيانات الخارجية، واستدلال الأشكال في ONNX (ONNX shape inference)، والصيغة النصية لـ ONNX (ONNX textual syntax)، وتسميات الأنواع (type denotation)، ومحول إصدارات ONNX (ONNX version converter)، وإدارة إصدارات ONNX (ONNX versioning)، مما يجعلها مرجعًا كاملاً لمستخدمي ONNX والمساهمين فيه.

الميزات الأساسية لـ وثائق ONNX

• مقدمة لمفاهيم ONNX

• دليل التكامل مع Python لـ ONNX

• مرجع شامل لواجهة برمجة التطبيقات (API)

• شرح مفصل لإدارة إصدارات ONNX

• وثائق حول هياكل بيانات ONNX

• تغطية لدوال ONNX

• وثائق متعمقة لمشغلات ONNX

• تفاصيل تقنية حول أنواع البيانات والتخزين (مثل: 8 بت للأعداد العشرية، 4 بت للأعداد الصحيحة)

• إرشادات مستودع ONNX

• إجراءات إضافة المشغلات/الدوال

• حالة ضمان الأمان لـ ONNX

• البث (Broadcasting) في ONNX

• دليل علامات قابلية الاشتقاق

• تسميات الأبعاد وتسميات الأنواع

• التعامل مع البيانات الخارجية

• مواصفات ONNX IR

• إرشادات تنفيذ الواجهة الخلفية لـ ONNX

• إدارة المشغلات التجريبية

• البيانات الوصفية لـ ONNX

• أنواع ONNX

• مجموعة اختبارات الواجهة الخلفية لـ ONNX

• الإصدارات الرسمية لـ ONNX

• نظرة عامة على اتفاقيات المشغلات

• نظرة عامة على واجهة برمجة تطبيقات Python

• إثباتات Sigstore لإصدارات PyPI

• استدلال الأشكال في ONNX

• الصيغة النصية لـ ONNX

• محول إصدارات ONNX

البدء مع وثائق ONNX

1. 1

   فهم مفاهيم ONNX: اقرأ الأقسام التمهيدية لفهم المبادئ الأساسية لـ ONNX.

2. 2

   التكامل مع Python: اتبع دليل التكامل مع Python لـ ONNX للتنفيذ العملي.

3. 3

   استكشاف مرجع واجهة برمجة التطبيقات (API): استخدم مرجع واجهة برمجة التطبيقات للحصول على معلومات مفصلة حول الدوال والمشغلات وهياكل البيانات.

4. 4

   تنفيذ واجهة خلفية لـ ONNX: استشر الأدلة حول تنفيذ واجهة خلفية لـ ONNX للحلول المخصصة.

5. 5

   إضافة مشغلات/دوال جديدة: ارجع إلى الوثائق لمعرفة الإجراءات الخاصة بإضافة مشغلات أو دوال جديدة.

6. 6

   إدارة الميزات التجريبية: تعلم كيفية إدارة واستخدام المشغلات التجريبية.

7. 7

   التحقق من الإصدارات: فهم عملية التحقق من إصدارات ONNX PyPI باستخدام إثباتات Sigstore.

حالات استخدام وثائق ONNX

• قابلية تشغيل نماذج التعلم الآلي
• تسريع الأجهزة
• تحسين النماذج
• البحث والتطوير
• النشر في بيئات الإنتاج

الأسئلة الشائعة من وثائق ONNX

• ما هو ONNX وماذا تغطي وثائقه؟

  ONNX (Open Neural Network Exchange) هو تنسيق لتمثيل نماذج التعلم الآلي. تغطي وثائقه المفاهيم الأساسية، والتكامل مع Python، ومراجع واجهة برمجة التطبيقات (API)، وإدارة الإصدارات، وهياكل البيانات، والمشغلات، والتفاصيل التقنية، والأمان، وأدلة التنفيذ.

• أين يمكنني العثور على معلومات حول مشغلات ONNX؟

  تتضمن وثائق ONNX 1.23.0 قسمًا مخصصًا لمشغلات ONNX، يفصل مواصفاتها واستخدامها.

• كيف يتعامل ONNX مع أنواع البيانات والتخزين المختلفة؟

  يشرح قسم التفاصيل التقنية في وثائق ONNX تخزين الأعداد العشرية بـ 8 بت وأنواع الأعداد الصحيحة المختلفة مثل أنواع الأعداد الصحيحة بـ 4 بت و 2 بت.

• ما هو الغرض من مواصفات ONNX IR؟

  تحدد مواصفات تمثيل ONNX الوسيط (ONNX IR) بنية ودلالات نماذج ONNX، مما يتيح قابلية التشغيل البيني بين الأطر المختلفة.

• هل يمكنني تنفيذ واجهة خلفية خاصة بي لـ ONNX؟

  نعم، توفر الوثائق إرشادات حول تنفيذ واجهة خلفية لـ ONNX، مما يسمح بتكاملات مخصصة للأجهزة أو البرامج.

• كيف تتم إدارة الإصدارات في ONNX؟

  لدى ONNX قسم مخصص لإدارة الإصدارات (Versioning)، يشرح كيفية إدارة الإصدارات المختلفة للتنسيق وكيفية استخدام محول إصدارات ONNX (ONNX Version Converter).

• ما هي اعتبارات الأمان لـ ONNX؟

  تتضمن الوثائق معلومات حول حالات ضمان الأمان لـ ONNX وأمان البيانات الخارجية، مع تسليط الضوء على الإجراءات لضمان سلامة النموذج وتكامله.

• كيف يمكنني إضافة مشغلات أو دوال جديدة إلى ONNX؟

  توفر وثائق مستودع ONNX (ONNX Repository) تعليمات خطوة بخطوة لإضافة تعريف جسم دالة لمشغل ولإضافة مشغلات أو دوال جديدة إلى ONNX.

• ما هو استدلال الأشكال في ONNX؟

  استدلال الأشكال في ONNX (ONNX Shape Inference) هو عملية موصوفة في الوثائق تحدد أشكال المخرجات للمشغلات بناءً على أشكال مدخلاتها.

• هل تغطي الوثائق كيفية استخدام ONNX مع Python؟

  نعم، يوجد قسم محدد بعنوان 'التكامل مع Python لـ ONNX' (ONNX with Python) يوجه المستخدمين حول دمج نماذج ONNX في سير عمل Python الخاصة بهم.