ترجمت واجهة Cloud Translation API‏ هذه الصفحة.
Switch to English

ملحقات TensorFlow




TensorFlow Addons هو مستودع للمساهمات التي تتوافق مع أنماط API الراسخة ، ولكنها تنفذ وظائف جديدة غير متوفرة في TensorFlow الأساسية. يدعم TensorFlow أصلاً عددًا كبيرًا من عوامل التشغيل والطبقات والمقاييس والخسائر والمحسنات. ومع ذلك ، في مجال سريع الحركة مثل ML ، هناك العديد من التطورات الجديدة المثيرة للاهتمام التي لا يمكن دمجها في TensorFlow الأساسية (لأن تطبيقها الواسع لم يتضح بعد ، أو أنه يستخدم في الغالب من قبل مجموعة فرعية أصغر من المجتمع).

التركيب

يبني مستقر

لتثبيت أحدث إصدار ، قم بتشغيل ما يلي:

 pip install tensorflow-addons
 

لاستخدام الإضافات:

 import tensorflow as tf
import tensorflow_addons as tfa
 

يبني ليلا

هناك أيضًا تراكيب ليلية من TensorFlow Addons تحت حزمة النقاط tfa-nightly ، والتي تم إنشاؤها مقابل أحدث إصدار ثابت من TensorFlow. تتضمن الإصدارات الليلية ميزات أحدث ، ولكنها قد تكون أقل استقرارًا من الإصدارات التي تم إصدارها.

 pip install tfa-nightly
 

التثبيت من المصدر

يمكنك أيضًا التثبيت من المصدر. هذا يتطلب نظام بناء Bazel .

 git clone https://github.com/tensorflow/addons.git
cd addons

# If building GPU Ops (Requires CUDA 10.0 and CuDNN 7)
export TF_NEED_CUDA=1
export CUDA_HOME="/path/to/cuda10" (default: /usr/local/cuda)
export CUDNN_INSTALL_PATH="/path/to/cudnn" (default: /usr/lib/x86_64-linux-gnu)

# This script links project with TensorFlow dependency
python3 ./configure.py

bazel build build_pip_pkg
bazel-bin/build_pip_pkg artifacts

pip install artifacts/tensorflow_addons-*.whl
 

المفاهيم الأساسية

واجهة برمجة تطبيقات موحدة داخل الحزم الفرعية

تعتبر خبرة المستخدم وقابلية الصيانة للمشروع مفاهيم أساسية في TF-Addons. من أجل تحقيق ذلك ، نطلب أن تتوافق إضافاتنا مع أنماط API المعمول بها في TensorFlow الأساسية.

GPU / CPU Custom-Ops

فائدة رئيسية من TensorFlow Addons هي وجود عمليات opompiled. إذا لم يتم العثور على تثبيت CUDA 10 ، فسيعود المرجع تلقائيًا إلى تنفيذ وحدة المعالجة المركزية.

صيانة الوكيل

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

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

لمزيد من المعلومات راجع RFC حول هذا الموضوع.

التقييم الدوري للعبوات الفرعية

نظرًا لطبيعة هذا المستودع ، قد تصبح الحزم الفرعية والقطع الفرعية أقل فائدة للمجتمع مع مرور الوقت. من أجل الحفاظ على المستودع مستدامًا ، سنقوم بإجراء مراجعات نصف سنوية لشفرتنا لضمان أن كل شيء لا يزال ينتمي إلى الريبو. العوامل المساهمة في هذه المراجعة ستكون:

  1. عدد الرعاة النشطين
  2. مقدار استخدام OSS
  3. عدد المشاكل أو الأخطاء المنسوبة إلى الشفرة
  4. إذا كان الحل الأفضل متاحًا الآن

يمكن تصنيف الوظائف ضمن إضافات TensorFlow إلى ثلاث مجموعات:

  • مقترح : واجهة برمجة تطبيقات جيدة الصيانة ؛ يشجع الاستخدام.
  • مُحبط : يتوفر بديل أفضل ؛ يتم الاحتفاظ بواجهة برمجة التطبيقات لأسباب تاريخية ؛ أو يتطلب API صيانة وهي فترة الانتظار ليتم إيقافها.
  • موقوف : الاستخدام على مسؤوليتك الخاصة ؛ تخضع للحذف.

تغيير الحالة بين هذه المجموعات الثلاث هو: <-> غير مشجع -> موقوف.

الفترة بين واجهة برمجة التطبيقات التي تم وضع علامة عليها بأنها متوقفة وحذفها ستكون 90 يومًا. الأساس المنطقي:

  1. في حالة إصدار TensorFlow Addons شهريًا ، سيكون هناك 2-3 إصدارات قبل حذف واجهة برمجة التطبيقات. يمكن أن تعطي ملاحظات الإصدار تحذيرًا كافيًا للمستخدم.

  2. 90 يومًا تمنح المشرفين متسعًا من الوقت لإصلاح الرمز الخاص بهم.

المساهمة

TF-Addons هو مشروع مفتوح المصدر بقيادة المجتمع. على هذا النحو ، يعتمد المشروع على المساهمات العامة وإصلاح الأخطاء والوثائق. يرجى الاطلاع على إرشادات المساهمة للحصول على دليل حول كيفية المساهمة. يلتزم هذا المشروع بمدونة سلوك TensorFlow . من خلال المشاركة ، من المتوقع أن تلتزم بهذا الرمز.

تواصل اجتماعي

رخصة

ترخيص Apache 2.0