v3.5: Model zoo enhancements - detailed catalog structure and model cards

[LeoSvalov]

Model zoo improvements

The current models’ representation has an enumerative format in the model-list directory. The proposed model zoo structure adds a detailed catalog and has the following format:

For every integrated model in the new structure, the following components were added:

1. Model card - The information about the model and basic theory behind its architecture, original paper, dataset description, and instructions on how to get inference, evaluate and profile the model.
2. Standardized scripts - bash scripts that helps to use the model zoo models in unified format:

• inference.sh: Get inference of the model by given input
• performance.sh: Get performance metrics (FPS, E2E, DPU_MEAN)
• quality.sh: Evaluate the quality of the model (metric is task-dependent)
• vaitrace.sh: Profile the model by the vaitrace tool. (located in the model zoo root, in the /scripts directory)
  All scripts are made to provide ease of the model use and utilize the Vitis .cpp sources for the artifacts build.

Model directory example:

In total, there were 16 models integrated into the new proposed model zoo structure:

• resnet50
• inceptionv3
• vehicle-make-classification
• efficientnet-edgetpu-S
• resnetv1
• yolox-nano
• mlperf_resnet34
• yolov4
• HRNet
• 2D-UNet
• RCAN
• OFA-rcan
• SESR-S
• inception-V4
• squeezenet
• OFA-YOLO

All integrated models have the configurations from the model-list that are supported by the Alveo V70 and each script for every model was tested on the Alveo V70 card device.

The integrated model directories cover 37 out of 103 of all models’ configurations supported V70 (36% coverage) that are presented in the model-list for the Xilinx v3.5 latest version.

Model cards integration into the GitHubIO documentation

To represent model cards in the GitHubIO documentation, but avoid the duplication of information, there several enhancements in the documentation build were introduced:

• All markdown documentation files in the model zoo directory were exported transparently by the script build_model_cards.sh including Getting Started guide and model cards.
• The integration script build_model_cards.sh was added to the Makefile commands so that no extra steps are required in the GitHubIO documentation build.

Example of the added content to the documentation: