| This directory should be the only one in IREE that pulls a dependency on `tf` |
| dialect and related dialects (with the exception of a small selection of "safe" |
| XLA IR). |
| |
| # Tools |
| |
| ## Development Tools |
| |
| * `iree-tf-opt` : MLIR Opt tool with TensorFlow and IREE passes/dialects |
| linked in |
| * `iree-tf-translate` : Equivalent to `mlir-tf-translate` tool in TensorFlow, |
| with IREE passes/dialects linked in |
| |
| ## Production Tools |
| |
| ### iree-import-tf |
| |
| `iree-import-tf` provides a single entry-point for compiling TensorFlow saved |
| models to "IREE Input Dialects" that can be fed to `iree-translate` or |
| `iree-opt` and operated on further. |
| |
| #### Usage |
| |
| ```shell |
| iree-import-tf /path/to/saved_model_v2 |
| # Optional args: --tf-savedmodel-exported-names=subset,of,exported,names |
| |
| iree-import-tf /path/to/saved_model_v1 --tf-import-type=savedmodel_v1 |
| # Optional args: |
| # --tf-savedmodel-exported-names=subset,of,exported,names |
| # --tf-savedmodel-tags=serving |
| ``` |
| |
| # Testing |
| |
| ```shell |
| $ bazel test :saved_model_adopt_exports |
| ``` |
| |
| This will capture the output and pass it through FileCheck and report pass/fail, |
| along with a hopefully informative description of what failed. |
| |
| ## Debugging failures |
| |
| During development, it can be useful to just see the raw output directly. |
| |
| To see the raw output of the MLIR import and conversion process: |
| |
| ```shell |
| $ bazel run :saved_model_adopt_exports -- --disable_filecheck |
| ``` |
| |
| Look for the `RUN_TEST: <test_name>` and `FINISH_TEST: <test_name>` lines to |
| narrow in on the test that interests you. |
