• About Ascend Samples Repository
• Release Notes
• Directory Structure
• Version and Product Support per Sample
• Sample Deployment
• Documentation
• Community
• Contribution
• License

English|中文

About Ascend Samples Repository

Ascend Computing Language (AscendCL) provides a collection of C language APIs for users to develop deep neural network apps for object recognition and image classification, ranging from device management, context management, stream management, memory management, to model loading and execution, operator loading and execution, and media data processing. You can call AscendCL APIs through a third-party framework to utilize the compute capability of the Ascend AI Processor, or encapsulate AscendCL into third-party libraries, to provide the runtime and resource management capabilities of the Ascend AI Processor.

This repository provides a wide range of samples developed based on AscendCL APIs. When developing your own samples, feel free to refer to the existing samples in this repository.

Release Notes

For the CANN version and Ascend product supported by each sample in the master branch, see Version and Product Support per Sample.
For historical version, please refer to CANN Version Description.

Table 1 CANN Version Description

CANN Version	Driver Version	Samples Repository Support	Download Link
5.0.4.alpha002/5.0.4.alpha003/ 5.0.4.alpha005/5.0.5.alpha001/ 5.1.RC1.alpha001/5.1.RC1.alpha002/ 5.1.RC1.alpha003	1.0.12.alpha	Yes	Release 0.6.0: click here
5.0.2.alpha005/5.0.3.alpha001/ 5.0.3.alpha002/5.0.3.alpha003/ 5.0.3.alpha005	1.0.11.alpha	Yes	Release 0.5.0: click here
5.0.2.alpha003	1.0.10.alpha	Yes	Release 0.4.0: click here
3.3.0.alpha001/3.3.0.alpha005/ 3.3.0.alpha006/5.0.2.alpha001/ 5.0.2.alpha002	1.0.9.alpha	Yes	Release 0.3.0: click here
3.2.0.alpha001	1.0.8.alpha	Yes	Release 0.2.0: click here
3.1.0.alpha001	1.0.7.alpha	Yes	Release 0.1.0: click here

Directory Structure

directory	description
common	Sample warehouse public file directory
cplusplus	C++ sample directory of samples warehouse
python	samples warehouse python sample directory
st	Samples warehouse sample test case directory

Version and Product Support per Sample

Sample Name	Language	Product	Description
DVPP interface sample	c++	>=5.0.4	Call the relevant interface of dvpp to realize image processing. Includes crop/vdec/venc/jpegd/jpege/resize/batchcrop/cropandpaste and other functions
Custom operator sample	c++	>=5.0.4	Custom operator operation verification, including Add operator/batchnorm operator/conv2d operator/lstm operator/matmul operator/reshape operator, etc.
200DK peripheral sample	c++	>=5.0.4	200DK peripheral interface related cases, including functions such as configuring GPIO pins/using i2c to read and write data/using uart1 serial port to send and receive data/using camera to take photos or videos.
C++ classification sample	c++	>=5.0.4	Use the googlenet/ResNet-50 model to classify and infer the input data. Contains multiple feature samples such as pictures/videos/dynamic batch/multi-batch/video stream/universal camera.
C++ detection sample	c++	>=5.0.4	Use the object detection/yolov3/yolov4/vgg_ssd/faster_rcnn model to detect the input data. Contains various feature samples such as general picture/universal video//video stream/universal camera.
C++ natural language processing sample	c++	>=5.0.4	Use the nlp model to reason about the input data.
C++ other sample	c++	>=5.0.4	Other model reasoning examples, including black and white image coloring, super-segmentation, image enhancement, etc.
C++ multithreading sample	c++	>=5.0.4	Use yolov3, object detection and other models to perform multi-threaded inference examples on input data.
C++ user contribution sample	c++	>=5.0.4	Inference sample contributed by users.
Python classification sample	python	>=5.0.4	Use the googlenet/inceptionv3/vgg16 model to classify and infer the input data.
python detection sample	python	>=5.0.4	Use the googlenet/inceptionv3/vgg16 model to classify and infer the input data.
Python segmentation sample	python	>=5.0.4	Use the segmentation model to segment the input image.
python natural language processing sample	python	>=5.0.4	Use the nlp model to reason about the input data.
python other sample	python	>=5.0.4	Other model reasoning sample, including black and white image coloring, image restoration, etc.
End-to-end sample from training to inference	python	>=5.0.4	End-to-end sample guidance from training to deployment, including guidance on mask recognition, garbage classification, cat and dog battles, etc.
Python industry sample	python	>=5.0.4	For more complex samples, combine hardware or use multi-model and multi-threaded samples. Such as removing the designated foreground target sample of the image, the robot arm sample, etc.
Python user contribution sample	python	>=5.0.4	Inference sample contributed by users.

Sample Deployment

Deploy and run a sample by referring to the corresponding README file.

Documentation

Obtain related documentation at Ascend Documentation.

Community

Get support from our developer community. Find answers and talk to other developers in our forum.

Ascend website: https://www.huaweicloud.com/intl/en-us/ascend/home.html

Ascend forum: https://forum.huawei.com/enterprise/en/forum-100504.html

Contribution

Welcome to contribute to Ascend Samples. For more details, please refer to our Contribution Wiki.

License

Apache License 2.0