v3.0: 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 15 models integrated into the new proposed model zoo structure:

• salsanext
• resnet50
• inceptionv3
• vehicle-make-classification
• efficientnet-edgetpu-S
• resnetv1
• yolox-nano
• mlperf_resnet34
• yolov4
• ENet
• SemanticFPN
• ERFnet
• DRUNet
• OFA-rcan
• SESR-S

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

The integrated model directories cover 39 out of 118 of all models’ configurations supported VCK5000 (33% coverage) that are presented in the model-list for the Xilinx v3.0 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: