megflow | 安装megflow

1、安装依赖

安装 Rust

sudo apt install curl

curl --proto '=https' --tlsv1.2 https://sh.rustup.rs -sSf | sh

成功后，cargo 应该可以正常执行

cargo --version

cargo 1.53.0 (4369396ce 2021-04-27)

如果不成功，提示Command 'cargo' not found，可以按照提示加载一下环境变量(重新连接或打开终端也可以)：

source $HOME/.cargo/env

cargo 是 Rust 的包管理器兼编译辅助工具。类似 Java maven/go pkg/C++ CMake 的角色，更易使用。

2、编译

MegFlow 需要编译 ffmpeg。考虑到 ffmpeg 依赖较多、本身又是常用工具，最简单的办法就是直接装 ffmpeg 把编译依赖装上

$ sudo apt install yasm git build-essential ffmpeg
$ ffmpeg 
ffmpeg version 3.4.8...
$ sudo apt install clang
$ clang --version
clang version 6.0.0-1ubuntu2...

编译底层 Rust 组件，安装 Python module

$ git clone --recursive https://github.com/MegEngine/MegFlow --depth=1
$ cd MegFlow
$ cargo build
waiting ...
$ cd flow-python
$ python3 setup.py install --user

常见问题：error while loading shared libraries: libpython3.8.xxx，意为 libpython.so 找不到。如果使用 conda 就在 miniconda 安装目录下面，只需要设置环境变量

$ export LD_LIBRARY_PATH=`conda info --base`/pkgs/python-3.8.11-xxx/lib:${LD_LIBRARY_PATH}

P.S. 默认 ffmpeg 依赖自动从 github 上拉取源码构建，这会使得首次构建的时间较长。若希望缩短首次构建时间，或者希望依赖一个指定版本的 ffmpeg，可以启用环境变量CARGO_FEATURE_PREBUILD并参考rust-ffmpeg自行构建

3、Python“开机自检”

$ cd examples
$ cargo build --example run_with_plugins --release # 编译出 megflow bin
$ ln -s ../../target/example/run_with_plugins
$ ./run_with_plugins -p logical_test

logical_test 是 examples 下最基础的计算图测试用例，运行能正常结束表示 MegFlow 编译成功、基本语义无问题。

run_with_plugins 是计算图的实现。编译完成之后不再需要 cargo 和 Rust，使用者只需要

• import megflow成功
• run_with_plugins -h 正常

4、Python Built-in Applications

接下来开始运行好玩的 Python 应用

• 猫猫围栏运行手册

• • 图片注册猫猫
  • 部署视频围栏，注册的猫离开围栏时会发通知
  • 未注册的不会提示

• 电梯电瓶车告警

• • 电梯里看到电瓶车立即报警

• Comming Soon

• • OCR： 通用字符识别

5、其他选项

$ cargo run --example graph -- ${args} # 测试 MegFlow 的延迟/吞吐/调度开销, 更多使用说明通过--help 查看
$ cargo run --example run_with_plugins -- ${args} # 基于插件 + 参数文件形式运行 MegFlow, 更多说明通过--help 查看
$ export RUST_LOG=LOG_LEVEL // 设置日志级别, 例如 INFO, TRACE..
$ cargo build [--release] // 编译
$ cargo check // 快速编译，不执行 link
$ cargo test [target] // 执行单元测试