Finn-examples

Updates to FINN-examples since the last release include
- Migration to PYNQ v3.0.1 and FINN v0.9
- Newly built bitfiles with FINN v0.9
- Migrated to new FINN (v0.9) driver: updated notebooks & QONNX dependency
- A [new notebook](https://github.com/Xilinx/finn-examples/blob/main/finn_examples/notebooks/6_cybersecurity_with_mlp.ipynb) example and [build script](https://github.com/Xilinx/finn-examples/tree/main/build/cybersecurity-mlp):
- **Cybersecurity MLP**: classifying network packets as malicious or not with an MLP on the UNSW-NB15 dataset.
- Minor fixes in reporting and documentation

Known issues
- The build flow for ResNet-50 for the Alveo U250 has known issues and we're currently working on resolving them. However, you can still execute the associated notebook, as we provide a pre-built FPGA bitfile generated with an older Vivado (/FINN) version targeting the [xilinx_u250_xdma_201830_2](https://www.xilinx.com/products/boards-and-kits/alveo/package-files-archive/u250-2018-3-1.html) platform.
- The build flow for MobileNet-v1 for the ZCU104 works, but there are currently (known) issues with runtime-writeable weights. Therefore, we have excluded this example, but you can still integrate this IP into your design and try to deploy it with your driver.

* No changes to prebuilt examples
* Update FINN to v0.8.1 for rebuilds
* Update driver and scripts to account for QONNX migration (finn-base is no longer a dependency)
* Minor fixes in reporting and documentation

Three new examples:

* **[Face mask wear and positioning:](https://github.com/Xilinx/finn-examples/blob/main/finn_examples/notebooks/3_binarycop_mask_detection.ipynb)** Low-power BNN classifier for Pynq-Z1 for correct face mask wear and positioning. Contributed by TU Munich and BMW.
* **[Radio signal modulation:](https://github.com/Xilinx/finn-examples/blob/main/finn_examples/notebooks/5_radioml_with_cnns.ipynb)** Classify RadioML 2018.1 at 250k inferences/second on a ZCU104. See also our [ITU challenge](https://bit.ly/brevitas-radioml-challenge-21) on the topic. Contributed by Felix Jentzsch.
* **[Keyword spotting:](https://github.com/Xilinx/finn-examples/blob/main/finn_examples/notebooks/4_keyword_spotting.ipynb)** Classify spoken commands from the Google Speech Commands dataset at 250k inferences/second on a Pynq-Z1. Utilizes the new QONNX build flow. Contributed by Hendrik Borras.


radioml
RadioML 2018.1 example

kws
Data files and models for the upcoming keyword spotting (KWS) example

binary-cop
New contribution from TU Munich / BMW: Binary Neural Network-based COVID-19 Face-Mask Wear and Positioning Predictor on Edge Devices
See https://github.com/NaelF/BinaryCoP/tree/master/notebook for more details
Note: currently PYNQ-Z1 only, bitfile only

* ResNet-50: first release on U250

rn50-u250
Binary weights, 2-bit activations ResNet-50, gets ~3000 FPS on an Alveo U250 running at 178 MHz and delivers a top-1 accuracy of 67.9% on ImageNet-1K.

* MobileNet-v1: first release on ZCU104
* MobileNet-v1: improved frequency on U250
* driver updates
* documentation updates and other minor fixes

mnv1-zcu104


mnv1-u250-partitioned
MobileNet-v1 for U250 with SLR partitioning