이 페이지는 Cloud Translation API를 통해 번역되었습니다.
Switch to English

텐서 플로우 애드온




TensorFlow 애드온 은 잘 확립 된 API 패턴을 준수하지만 핵심 TensorFlow에서 사용할 수없는 새로운 기능을 구현하는 컨트 리뷰 션 저장소입니다. TensorFlow는 기본적으로 수많은 연산자, 계층, 메트릭, 손실 및 최적화 프로그램을 지원합니다. 그러나 ML과 같이 빠르게 변화하는 분야에는 핵심 TensorFlow에 통합 할 수없는 흥미로운 새로운 개발이 많이 있습니다 (넓은 적용 가능성이 아직 명확하지 않거나 커뮤니티의 작은 하위 집합에서 주로 사용되기 때문에).

설치

안정적인 빌드

최신 버전을 설치하려면 다음을 실행하십시오.

 pip install tensorflow-addons
 

애드온을 사용하려면

 import tensorflow as tf
import tensorflow_addons as tfa
 

야간 빌드

tfa-nightly pip 패키지 아래에 TensorFlow Addons의 야간 빌드도 있으며, 최신 안정 버전의 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의 핵심 개념입니다. 이를 달성하기 위해서는 추가 된 사항이 핵심 TensorFlow에서 보이는 기존 API 패턴을 준수해야합니다.

GPU / CPU 맞춤형 조작

TensorFlow Addons의 주요 이점은 사전 컴파일 된 op가 있다는 것입니다. CUDA 10 설치를 찾지 못하면 op가 자동으로 CPU 구현으로 폴백합니다.

프록시 유지 보수

애드온은 하위 패키지 및 하위 모듈을 구획화하여 해당 구성 요소에 대한 전문 지식과 관심을 갖고있는 사용자가 유지 관리 할 수 ​​있도록 설계되었습니다.

하위 패키지 유지 관리는 쓰기 권한이있는 사용자 수를 제한하기 위해 상당한 기여를 한 후에 만 ​​부여됩니다. 기고문은 이슈 종결, 버그 수정, 설명서, 새 코드 또는 기존 코드 최적화의 형태로 제공 될 수 있습니다. 하위 모듈 유지 관리 권한에는 진입 장벽이 낮아서 저장소에 대한 쓰기 권한이 포함되지 않기 때문입니다.

자세한 정보는이 주제에 대한 RFC 를 참조하십시오.

서브 패키지의 주기적 평가

이 저장소의 특성상 시간이 지남에 따라 서브 패키지 및 서브 모듈이 커뮤니티에 점점 더 유용하지 않을 수 있습니다. 저장소를 지속 가능하게 유지하기 위해 모든 코드가 저장소에 여전히 포함되도록 코드를 2 년에 한 번씩 검토합니다. 이 검토에 기여하는 요소는 다음과 같습니다.

  1. 활성 관리자 수
  2. OSS 사용량
  3. 코드로 인한 문제 또는 버그의 양
  4. 더 나은 솔루션을 사용할 수 있다면

TensorFlow 애드온의 기능은 세 그룹으로 분류 할 수 있습니다.

  • 제안 : 잘 관리 된 API; 사용을 권장합니다.
  • 낙심 : 더 나은 대안을 사용할 수 있습니다. 역사적인 이유로 API가 유지됩니다. 또는 API에 유지 보수가 필요하며 더 이상 사용되지 않는 대기 기간입니다.
  • 더 이상 사용되지 않음 : 모든 위험 부담으로 사용하십시오. 삭제 될 수 있습니다.

이 세 그룹 간의 상태 변경은 다음과 같습니다. 제안 <-> 권장 안 함-> 더 이상 사용되지 않습니다.

API가 더 이상 사용되지 않는 것으로 표시되고 삭제되는 기간은 90 일입니다. 근거 :

  1. TensorFlow Addons가 월별로 릴리스되는 경우 API가 삭제되기 전에 2-3 개의 릴리스가 있습니다. 릴리스 정보는 사용자에게 충분한 경고를 줄 수 있습니다.

  2. 90 일 동안 관리자는 코드를 수정할 수있는 충분한 시간을 갖게됩니다.

기여

TF-Addons는 커뮤니티 주도형 오픈 소스 프로젝트입니다. 따라서이 프로젝트는 공공 기여, 버그 수정 및 문서에 의존합니다. 기여 방법에 대한 지침기여 지침 을 참조하십시오. 이 프로젝트는 TensorFlow의 행동 강령을 준수합니다. 참여하면이 코드를 준수해야합니다.

커뮤니티

특허

아파치 라이선스 2.0