Google Git
Sign in
android / platform / external / XNNPACK / 2957a79725fb70ca12818a9149c1a4304080f916
commit2957a79725fb70ca12818a9149c1a4304080f916[log] [tgz]
authorHaibo Huang <hhb@google.com>Wed Mar 24 00:12:50 2021 +0000
committerAutomerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>Wed Mar 24 00:12:50 2021 +0000
tree604f8e07934583a6da3a03939484467017c19440
parent00a40a9086a61df28266f055515c340bc7bea4ca [diff]
parent0b758efe6f4ec62ba55a07b3d2f9178ee192f035 [diff]
Upgrade XNNPACK to b0da47a9fab5216f120c5abc3aa44a61b2dab932 am: 08f3c78a97 am: 0b758efe6f

Original change: https://android-review.googlesource.com/c/platform/external/XNNPACK/+/1646892

Change-Id: Ie72335b934abc99472ad359359ccb6addf3126f8
tree: 604f8e07934583a6da3a03939484467017c19440
  1. bench/
  2. cmake/
  3. eval/
  4. include/
  5. models/
  6. scripts/
  7. src/
  8. test/
  9. third_party/
  10. tools/
  11. .bazelrc
  12. .gitignore
  13. Android.bp
  14. BUILD.bazel
  15. build_defs.bzl
  16. CMakeLists.txt
  17. CONTRIBUTING.md
  18. emscripten.bzl
  19. LICENSE
  20. METADATA
  21. MODULE_LICENSE_BSD
  22. OWNERS
  23. preamble.js.lds
  24. README.md
  25. TEST_MAPPING
  26. WORKSPACE
README.md

XNNPACK

XNNPACK is a highly optimized library of floating-point neural network inference operators for ARM, WebAssembly, and x86 platforms. XNNPACK is not intended for direct use by deep learning practitioners and researchers; instead it provides low-level performance primitives for accelerating high-level machine learning frameworks, such as TensorFlow Lite, TensorFlow.js, PyTorch, and MediaPipe.

Supported Architectures

  • ARM64 on Android, Linux, macOS, and iOS (including WatchOS and tvOS)
  • ARMv7 (with NEON) on Android, Linux, and iOS (including WatchOS)
  • x86 and x86-64 (up to AVX512) on Windows, Linux, macOS, Android, and iOS simulator
  • WebAssembly MVP
  • WebAssembly SIMD (experimental)

Operator Coverage

XNNPACK implements the following neural network operators:

  • 2D Convolution (including grouped and depthwise)
  • 2D Deconvolution (AKA Transposed Convolution)
  • 2D Average Pooling
  • 2D Max Pooling
  • 2D ArgMax Pooling (Max Pooling + indices)
  • 2D Unpooling
  • 2D Bilinear Resize
  • 2D Depth-to-Space (AKA Pixel Shuffle)
  • Add (including broadcasting, two inputs only)
  • Subtract (including broadcasting)
  • Divide (including broadcasting)
  • Maximum (including broadcasting)
  • Minimum (including broadcasting)
  • Multiply (including broadcasting)
  • Squared Difference (including broadcasting)
  • Global Average Pooling
  • Channel Shuffle
  • Fully Connected
  • Abs (absolute value)
  • Bankers' Rounding (rounding to nearest, ties to even)
  • Ceiling (rounding to integer above)
  • Clamp (includes ReLU and ReLU6)
  • Copy
  • ELU
  • Floor (rounding to integer below)
  • HardSwish
  • Leaky ReLU
  • Negate
  • Sigmoid
  • Softmax
  • Square
  • Truncation (rounding to integer towards zero)
  • PReLU

All operators in XNNPACK support NHWC layout, but additionally allow custom stride along the Channel dimension. Thus, operators can consume a subset of channels in the input tensor, and produce a subset of channels in the output tensor, providing a zero-cost Channel Split and Channel Concatenation operations.

Performance

Mobile phones

The table below presents single-threaded performance of XNNPACK library on three generations of MobileNet models and three generations of Pixel phones.

ModelPixel, msPixel 2, msPixel 3a, ms
MobileNet v1 1.0X828688
MobileNet v2 1.0X495355
MobileNet v3 Large394244
MobileNet v3 Small121414

The following table presents multi-threaded (using as many threads as there are big cores) performance of XNNPACK library on three generations of MobileNet models and three generations of Pixel phones.

ModelPixel, msPixel 2, msPixel 3a, ms
MobileNet v1 1.0X432746
MobileNet v2 1.0X261828
MobileNet v3 Large221624
MobileNet v3 Small768

Benchmarked on March 27, 2020 with end2end_bench --benchmark_min_time=5 on an Android/ARM64 build with Android NDK r21 (bazel build -c opt --config android_arm64 :end2end_bench) and neural network models with randomized weights and inputs.

Raspberry Pi

The table below presents multi-threaded performance of XNNPACK library on three generations of MobileNet models and three generations of Raspberry Pi boards.

ModelRPi Zero W (BCM2835), msRPi 2 (BCM2836), msRPi 3+ (BCM2837B0), msRPi 4 (BCM2711), ms
MobileNet v1 1.0X400433711672
MobileNet v2 1.0X20111958341
MobileNet v3 Large16941637038
MobileNet v3 Small482522313

Benchmarked on May 22, 2020 with end2end-bench --benchmark_min_time=5 on a Raspbian Buster build with CMake (./scripts/build-local.sh) and neural network models with randomized weights and inputs.

Publications

Ecosystem

Machine Learning Frameworks

Acknowledgements

XNNPACK is a based on QNNPACK library. Over time its codebase diverged a lot, and XNNPACK API is no longer compatible with QNNPACK.