# atlas200dk_remote

**Repository Path**: labgps/atlas200dk_remote

## Basic Information

- **Project Name**: atlas200dk_remote
- **Description**: No description available
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 11
- **Created**: 2022-02-18
- **Last Updated**: 2022-02-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# inferemote 远程推理实践平台

### 介绍
适用于Atlas200DK的分布式推理应用开发的Python3框架。

### 软件架构
本框架实现了应用开发与模型推理的分布式运行，简化了推理应用开发环境，提高了模型推理效率，提升了应用的用户体验。
1. 提供一个远程推理模型的封装包；
2. 提供若干推理应用示例；
3. 通过命令行参数支持支持多源测试方式，包括支持图片文件、目录、视频文件或摄像头采集测；
4. 通过命令行参数支持多种结果展现方式，包括图片对比显示、在线web视频流显示，以及多线程快速测试。

examples 中提供了远程推理模型和推理应用的示例，使用简洁。框架易于扩展，可基于此示例快速开发其他远程模型和推理应用。

### 运行环境说明

当前支持 Windows（64位）, GNU/Linux（64位）和 MacOS 10.15 (Intel)系统的 Python 3.7.x 或 Python 3.9.x 环境，可在通用PC和树莓派等嵌入式系统上使用Atlas200DK的远程推理服务。

### Windows 安装配置说明

#### 安装 Python 
以下两种方式二选一即可，推荐第一种。

##### 通过 MiniConda 安装

参考网址（https://docs.conda.io/en/latest/miniconda.html）。

Python version	Name	Size	SHA256 hash

Python 3.9	[点此下载](https://repo.anaconda.com/miniconda/Miniconda3-py39_4.10.3-Windows-x86_64.exe) Windows 64-bit	58.1 MiB	b33797064593ab2229a0135dc69001bea05cb56a20c2f243b1231213642e260a

Python 3.7	[点此下载](https://repo.anaconda.com/miniconda/Miniconda3-py37_4.10.3-Windows-x86_64.exe) Windows 64-bit	55.8 MiB	9c031506bfcb0428a0ac46c9152f9bdd48d5bdaa83046691bf8e0a4480663c05


##### 直接通过安装包安装
Windows 安装包下载地址：https://www.python.org/ftp/python/3.7.5/python-3.7.5-amd64.exe
执行安装文件，注意第一步中选择 注册环境变量。

#### 安装项目软件包
将本项目下载到本地目录，如：
    D:\inferemote

启动 cmd.exe，执行以下命令：

python -V

根据版本，执行以下相应命令：

pip install D:\atlas200dk_remote\site-packages\inferemote-0.2.2-py39-none-win_amd64.whl

或

pip install D:\atlas200dk_remote\site-packages\inferemote-0.2.2-cp37-cp37m-win_amd64.whl

### GNU/Linux 安装配置说明
适用于 Ubuntu/CentOS/openEuler 等常见操作系统，以及树莓派平台。

#### 安装 Python

以下两种方式二选一即可，推荐第一种。

##### 通过 MiniConda 安装 
Python version	Name	Size	SHA256 hash

Python 3.9	[点此下载](https://repo.anaconda.com/miniconda/Miniconda3-py39_4.10.3-Linux-x86_64.sh) Linux 64-bit	63.6 MiB	1ea2f885b4dbc3098662845560bc64271eb17085387a70c2ba3f29fff6f8d52f

Python 3.7	[点此下载](https://repo.anaconda.com/miniconda/Miniconda3-py37_4.10.3-Linux-x86_64.sh) Linux 64-bit	84.9 MiB	a1a7285dea0edc430b2bc7951d89bb30a2a1b32026d2a7b02aacaaa95cf69c7c

Python 3.7 	[点此下载](https://repo.anaconda.com/miniconda/Miniconda3-py37_4.10.3-Linux-aarch64.sh) Linux-aarch64 64-bit	89.2 MiB	65f400a906e3132ddbba35a38d619478be77d32210a2acab05133d92ba08f111

##### 直接通过安装包安装
Linux 安装包下载地址：https://www.python.org/ftp/python/3.7.5/Python-3.7.5.tar.xz
按文档说明进行编译安装，添加路径环境变量。

### MacOS 安装配置说明
请参照上述 GNU/Linux 的安装方式。

#### 安装项目软件包

将本项目下载到本地目录，如：
    ~/atlas200dk_remote

进入shell，执行以下命令：

python -V

根据版本，执行以下相应命令：
pip install ~/atlas200dk_remote/site-packages/inferemote-0.2.2-py39-none-manylinux1_x86_64.whl

或

pip install ~/atlas200dk_remote/site-packages/inferemote-0.2.2-py37-none-manylinux1_x86_64.whl

### 使用说明
1. 务必确认 Python 的版本与安装包是对应的；
2. 目前仅限课堂实践使用，所涉及 REMOTE_IP 根据教学需要提供。

#### 进入本项目主目录
cd D:\atlas200dk_remote\examples

#### 运行采用毕加索模型的图像分割迁移变换，使用默认测试图片：
python styletransfer\test.py -r {REMOTE_IP} -m show -w 3

#### 转换指定目录下的全部图片。将待转换的文件存入指定位置，如：D:\test_pictures，并执行以下命令：

python styletransfer\test.py -r {REMOTE_IP} -m show -w 3 -i D:\test_pictures
 
#### 执行如下命令，可显示参数帮助信息，请自行探索更多功能！
python styletransfer\test.py -h

###
如需制作支持以上远程推理的开发板系统，请参考：
https://gitee.com/haojiash/atlas200dk_remote/tree/master/sdcard-image

### 反馈建议
欢迎提交issue，并参与更多实践案例移植和分享。