インストール

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

Pip を使用したインストール

以下を実行して、TensorFlow デシジョン フォレストをインストールします。

# Install TensorFlow Decision Forests.
pip3 install tensorflow_decision_forests --upgrade

次に、次を実行してインストールを確認します。

# Check the version of TensorFlow Decision Forests.
python3 -c "import tensorflow_decision_forests as tfdf; print('Found TF-DF v' + tfdf.__version__)"

ソースからビルド

Linux

設定

要件

  • バゼル >= 3.7.2
  • パイソン >= 3
  • ギット
  • Python パッケージ: numpy tensorflow pandas

依存関係を手動でインストールする代わりに、 TensorFlow Build dockerを使用できます。このオプションを選択した場合は、Docker をインストールします。

コンパイル

TensorFlow デシジョン フォレストを次のようにダウンロードします。

# Download the source code of TF-DF.
git clone https://github.com/tensorflow/decision-forests.git
cd decision-forests

オプション: TensorFlow デシジョン フォレストはYggdrasil デシジョンフォレストに依存します。 Yggdrasil コードを編集する場合は、Yggdrasil github のクローンを作成し、それに応じてthird_party/yggdrasil_decision_forests/workspace.bzlのパスを変更できます。

オプション: docker オプションを使用する場合は、 start_compile_docker.shスクリプトを実行して、次のステップに進みます。 docker オプションを使用しない場合は、直接次の手順に進みます。

# Optional: Install and start the build docker.
./tools/start_compile_docker.sh

次のコマンドを使用して、TF-DF の単体テストをコンパイルして実行します。 test_bazel.shは、マシンのpython3.8およびデフォルトのコンパイラ用に構成されていることに注意してください。この構成を変更するには、ファイルを直接編集します。

# Build and test TF-DF.
./tools/test_bazel.sh

次のコマンドで pip パッケージを作成してテストします。 python3.8 を、使用する python のバージョンに置き換えます。 test_bazel.shスクリプトと同じバージョンの Python を使用する必要はないことに注意してください。

構成がmanylinux2014と互換性がある場合、 manylinux2014互換の pip パッケージが生成されます。

構成が manylinux2014 と互換性がない場合、 manylinux2014と互換性のない pip パッケージが生成され、最終チェックは失敗します。自分のマシンで TF-DF を使用するかどうかは問題ではありません。ビルド manylinux2014 に互換性を持たせる簡単な方法は、上記の docker を使用することです。

# Build and test a Pip package.
./tools/build_pip_package.sh python3.8

このコマンドは、TF-DF pip パッケージをインストールし、 examples/minimal.pyのサンプルを実行します。 Pip パッケージはdist/ディレクトリにあります。

互換性のある他のバージョンの Python 用の Pip パッケージを作成する場合は、次を実行します。

# Install the other versions of python (assume only python3.8 is installed; this is the case in the build docker).
sudo apt-get update && sudo apt-get install python3.7 python3.9 python3-pip

# Create the Pip package for the other version of python
./tools/build_pip_package.sh python3.7
./tools/build_pip_package.sh python3.9

または、 pyenvを使用して次のコマンドを実行することにより、互換性のあるすべてのバージョンの python の pip パッケージを作成できます。詳細については、 tools/build_pip_package.shのヘッダーを参照してください。

# Build and test all the Pip package using Pyenv.
./tools/build_pip_package.sh ALL_VERSIONS

マックOS

設定

要件

  • Coreutils ( brew install coreutilsでテスト済み)
  • バゼル >= 3.7.2
  • Python >= 3 ( brew install pythonでテスト済み)
  • ギット
  • JDK11
  • Python パッケージ: numpy tensorflow pandas

コンパイル

Docker を使用しない Linux のコンパイルと同じ手順に従います。

最後の注意事項

TF-DF のコンパイルは、(2021 年 12 月 17 日以降) TensorFlow Pip パッケージと TensorFlow Bazel 依存関係に依存しています。 TensorFlow のごく一部がコンパイルされます。単一の強力なワークステーションで TF-DF をコンパイルするには、約 10 分かかります。

トラブルシューティング