หน้านี้ได้รับการแปลโดย Cloud Translation API
Switch to English

TensorFlow Addons




TensorFlow Addons เป็นที่เก็บของการสนับสนุนที่สอดคล้องกับรูปแบบ API ที่ได้รับการยอมรับอย่างดี แต่ใช้การทำงานใหม่ที่ไม่มีใน TensorFlow หลัก TensorFlow ช่วยสนับสนุนผู้ปฏิบัติงานเลเยอร์เมตริกการสูญเสียและเครื่องมือเพิ่มประสิทธิภาพจำนวนมาก อย่างไรก็ตามในสนามที่มีการเคลื่อนไหวอย่างรวดเร็วเช่น ML มีการพัฒนาใหม่ที่น่าสนใจมากมายที่ไม่สามารถรวมเข้ากับแกนหลัก TensorFlow (เนื่องจากการบังคับใช้ในวงกว้างยังไม่ชัดเจน

การติดตั้ง

Builds ที่เสถียร

หากต้องการติดตั้งเวอร์ชันล่าสุดให้รันสิ่งต่อไปนี้:

 pip install tensorflow-addons
 

วิธีใช้งาน addons:

 import tensorflow as tf
import tensorflow_addons as tfa
 

สร้างทุกคืน

นอกจากนี้ยังมีการสร้าง TensorFlow Addons ทุกคืนภายใต้แพ็คเกจ pip tfa-nightly ซึ่งสร้างขึ้นจาก TensorFlow เวอร์ชันเสถียรล่าสุด งานสร้างทุกคืนมีคุณสมบัติใหม่กว่า แต่อาจมีเสถียรภาพน้อยกว่ารุ่นที่วางจำหน่าย

 pip install tfa-nightly
 

การติดตั้งจากแหล่งที่มา

คุณยังสามารถติดตั้งจากแหล่งที่มา สิ่งนี้ต้องการระบบ Bazel build

 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

Custom-Ops

ประโยชน์หลักของ TensorFlow Addons คือมี ops ที่คอมไพล์แล้ว หากไม่พบการติดตั้ง CUDA 10 ดังนั้น op จะกลับไปใช้งาน CPU โดยอัตโนมัติ

การดูแลรักษาพร็อกซี่

Addons ได้รับการออกแบบมาเพื่อแยกแพคเกจย่อยและ submodules เพื่อให้สามารถรักษาโดยผู้ใช้ที่มีความเชี่ยวชาญและมีความสนใจในส่วนนั้น

Subpackage maintainership จะได้รับหลังจากมีส่วนสนับสนุนอย่างมากเพื่อ จำกัด จำนวนผู้ใช้ที่ได้รับอนุญาตให้เขียน ผลงานสามารถมาในรูปแบบของการปิดปัญหาแก้ไขข้อผิดพลาดเอกสารรหัสใหม่หรือเพิ่มประสิทธิภาพรหัสที่มีอยู่ Submodule maintainership สามารถให้สิทธิ์กับอุปสรรคที่ต่ำกว่าสำหรับรายการเนื่องจากจะไม่รวมสิทธิ์การเขียนไปยัง repo

สำหรับข้อมูลเพิ่มเติมโปรดดู RFC ในหัวข้อนี้

การประเมินผลเป็นระยะ ๆ ของแพ็คเกจย่อย

เมื่อพิจารณาถึงลักษณะของพื้นที่เก็บข้อมูลนี้แพ็กเกจย่อยและ submodules อาจมีประโยชน์ต่อชุมชนน้อยลงเรื่อย ๆ เมื่อเวลาผ่านไป เพื่อให้พื้นที่เก็บข้อมูลยั่งยืนเราจะทำการตรวจสอบโค้ดของเราทุก ๆ สองปีเพื่อให้แน่ใจว่าทุกอย่างยังคงอยู่ใน repo ปัจจัยที่มีผลต่อการตรวจสอบนี้จะเป็น:

  1. จำนวนผู้ดูแลที่ใช้งานอยู่
  2. ปริมาณการใช้งาน OSS
  3. จำนวนของปัญหาหรือข้อบกพร่องที่เกิดจากรหัส
  4. หากทางออกที่ดีกว่ามีวางจำหน่ายแล้ว

การทำงานภายใน TensorFlow Addons สามารถแบ่งได้เป็นสามกลุ่ม:

  • แนะนำ : API ที่ได้รับการดูแลเป็นอย่างดี การใช้งานได้รับการสนับสนุน
  • ท้อแท้ : มีทางเลือกที่ดีกว่า; API ถูกเก็บไว้ด้วยเหตุผลทางประวัติศาสตร์ หรือ API ต้องการการบำรุงรักษาและเป็นช่วงเวลาที่ต้องรอให้เลิกใช้งาน
  • เลิกใช้ : ใช้ความเสี่ยงของคุณเอง; เรื่องที่จะถูกลบ

การเปลี่ยนแปลงสถานะระหว่างสามกลุ่มนี้คือ: แนะนำ <-> หมดกำลังใจ -> เลิกใช้แล้ว

ช่วงเวลาระหว่าง API ที่ถูกทำเครื่องหมายว่าเลิกใช้แล้วและถูกลบจะเป็น 90 วัน เหตุผลความเป็นอยู่:

  1. ในกรณีที่ Addens TensorFlow Addons รายเดือนจะมี 2-3 รุ่นก่อนที่จะลบ API บันทึกประจำรุ่นสามารถให้คำเตือนผู้ใช้ได้อย่างเพียงพอ

  2. 90 วันให้เวลากับผู้ดูแลในการแก้ไขรหัส

การบริจาค

TF-Addons เป็นชุมชนโอเพนซอร์สโครงการ ดังนั้นโครงการดังกล่าวขึ้นอยู่กับการมีส่วนร่วมของสาธารณะการแก้ไขข้อผิดพลาดและเอกสารประกอบ โปรดดู แนวทางการบริจาค เพื่อเป็นแนวทางในการมีส่วนร่วม โครงการนี้ปฏิบัติตาม จรรยาบรรณของ TensorFlow โดยการเข้าร่วมคุณคาดว่าจะรักษารหัสนี้

ชุมชน

การอนุญาต

Apache License 2.0