דף זה תורגם על ידי Cloud Translation API.
Switch to English

TensorFlow Addons




תוספות TensorFlow הוא מאגר תרומות התואמות לדפוסי API מבוססים, אך מיישמים פונקציונליות חדשה שאינה זמינה ב TensorFlow הליבה. TensorFlow תומך באופן טבעי במספר גדול של מפעילים, שכבות, מדדים, הפסדים ומיטבי אופטימיזציה. עם זאת, בשדה מהיר כמו ML, ישנם פיתוחים חדשים ומעניינים רבים שלא ניתן לשלב אותם בליבה TensorFlow (מכיוון שהיישום הרחב שלהם עדיין לא ברור, או שהוא משמש בעיקר על ידי תת-קבוצה קטנה יותר של הקהילה).

הַתקָנָה

בונה יציבה

כדי להתקין את הגרסה האחרונה, הפעל את הפעולות הבאות:

 pip install tensorflow-addons
 

כדי להשתמש בתוספות:

 import tensorflow as tf
import tensorflow_addons as tfa
 

בניות ליליות

ישנם גם לילי בונה של Addons TensorFlow תחת חבילת PIP 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
 

מושגי ליבה

API סטנדרטי בתוך חבילות המשנה

חווית משתמש ושמירה על פרויקטים הם מושגי ליבה ב- TF-Addons. על מנת להשיג זאת אנו דורשים שהתוספות שלנו יתאימו לדפוסי API קבועים שנראו ב TensorFlow הליבה.

אפשרויות התאמה אישית של GPU / CPU

היתרון העיקרי של TensorFlow Addons הוא שישנם אופציות מורכבות מראש. אם לא נמצא התקנה של CUDA 10, ה- OP יחזור אוטומטית ליישום מעבד.

תחזוקת פרוקסי

Addons תוכנן כדי למדרג את חבילות המשנה ותתי המשנה כך שתוכלו לתחזק אותם על ידי משתמשים שיש להם מומחיות ואינטרס מוקדם באותו רכיב.

תחזוקת חבילות משנה תוענק רק לאחר שתרמה תרומה משמעותית על מנת להגביל את מספר המשתמשים בעלי הרשאת כתיבה. תרומות יכולות להגיע בצורה של סגירות גיליון, תיקוני באגים, תיעוד, קוד חדש או אופטימיזציה של הקוד הקיים. ניתן להעניק תחזוקת תת-מודול עם מחסום נמוך יותר לכניסה מכיוון שהדבר לא יכלול הרשאות כתיבה לרפאו.

למידע נוסף ראה RFC בנושא זה.

הערכה תקופתית של חבילות המשנה

בהתחשב באופי מאגר זה, חבילות המשנה ותתי המשנה עשויים להיות פחות ופחות מועילים לקהילה ככל שעובר הזמן. כדי לשמור על מאגר בר-קיימא, אנו נבצע בדיקות דו-שנתיות של הקוד שלנו כדי להבטיח שהכל עדיין שייך לרשומה. הגורמים התורמים לסקירה זו יהיו:

  1. מספר התחזקים הפעילים
  2. כמות השימוש ב- OSS
  3. כמות הבעיות או הבאגים המיוחסים לקוד
  4. אם כעת ניתן להשיג פיתרון טוב יותר

ניתן לסווג פונקציונליות בתוך תוספות TensorFlow לשלוש קבוצות:

  • מוצע : API מתוחזק היטב; שימוש מעודד.
  • מיואש : קיימת אלטרנטיבה טובה יותר; ה- API נשמר מסיבות היסטוריות; או שממשק ה- API דורש תחזוקה והיא תקופת ההמתנה שיש לבטלה.
  • מיושן : השתמש על אחריותך בלבד; נושא שיימחק.

שינוי הסטטוס בין שלוש הקבוצות הללו הוא: מוצע <-> מיואש -> בוטל.

התקופה שבין ממשק API שמסומן כמיושם ונמחקת תהיה 90 יום. ההוויה הרציונאלית:

  1. במקרה ש- TensorFlow Addons ישחרר מדי חודש, יהיו 2-3 מהדורות לפני מחיקת API. הערות השחרור עלולות לתת למשתמש מספיק אזהרה.

  2. 90 יום נותנים למתחזקים זמן רב לתקן את הקוד שלהם.

תורם

TF-Addons הוא פרויקט קוד פתוח המוביל בקהילה. ככזה, הפרויקט תלוי בתרומות ציבוריות, תיקוני באגים ותיעוד. אנא עיינו בהנחיות התרומה לקבלת מדריך כיצד לתרום. פרויקט זה מציית לקוד ההתנהגות של TensorFlow . על ידי השתתפות, אתה צפוי לשמור על קוד זה.

קהילה

רישיון

Apache License 2.0