Commit eaaa4914 authored by lishen's avatar lishen
Browse files

修改readme

parent 10253177
# dlib C++ library [![GitHub Actions C++ Status](https://github.com/davisking/dlib/actions/workflows/build_cpp.yml/badge.svg)](https://github.com/davisking/dlib/actions/workflows/build_cpp.yml) [![GitHub Actions Python Status](https://github.com/davisking/dlib/actions/workflows/build_python.yml/badge.svg)](https://github.com/davisking/dlib/actions/workflows/build_python.yml) # DLIB
Dlib is a modern C++ toolkit containing machine learning algorithms and tools for creating complex software in C++ to solve real world problems. ## 环境配置
See [http://dlib.net](http://dlib.net) for the main project documentation and API reference.
## Compiling dlib C++ example programs 使用DCU编译之前,需要准备编译环境。参考
[environment prepare](environment_prepare.md)
Go into the examples folder and type: ## 使用源码安装
DCU编译之前,需要准备编译环境 ### 编译环境准备(以dtk-23.04版本为例)
[environment_prepare](environment_prepare.md)
```shell - 拉取代码
mkdir build; cd build;
cmake .. -DCMAKE_CXX_COMPILER=/opt/dtk/bin/hipcc
cmake --build . -j16 --verbose
```
That will build all the examples. ```
If you have a CPU that supports AVX instructions then turn them on like this: git clone -b develop http://developer.hpccube.com/codes/aicomponent/dlib.git
```
-[开发者社区](https://developer.hpccube.com/tool/#sdk) DCU Toolkit 中下载 DTK-23.04 解压至 /opt/ 路径下,并建立软链接
```shell ```
mkdir build; cd build; cmake .. -DUSE_AVX_INSTRUCTIONS=1; cmake --build . cd /opt && ln -s dtk-23.04 dtk
``` ```
Doing so will make some things run faster. - 导入环境变量以及安装必要依赖库
Finally, Visual Studio users should usually do everything in 64bit mode. By default Visual Studio is 32bit, both in its outputs and its own execution, so you have to explicitly ```shell
tell it to use 64bits. Since it's not the 1990s anymore you probably want to use 64bits. Do that with a cmake invocation like this: source /opt/dtk/env.sh
```
```shell ### 编译安装
cmake .. -G "Visual Studio 14 2015 Win64" -T host=x64
```
## Compiling your own C++ programs that use dlib
The examples folder has a [CMake tutorial](https://github.com/davisking/dlib/blob/master/examples/CMakeLists.txt) that tells you what to do. There are also additional instructions #### 使用cmake编译
on the [dlib web site](http://dlib.net/compile.html).
```shell ```shell
vcpkg install dlib mkdir build; cd build;
``` cmake .. -DCMAKE_CXX_COMPILER=/opt/dtk/bin/hipcc
## Compiling dlib Python API
Before you can run the Python example programs you must compile dlib. Type:
```shell cmake --build . -j16 #--verbose
python setup.py install --set CMAKE_CXX_COMPILER=/opt/dtk/bin/hipcc
``` ```
## Running the unit test suite #### 单元测试
Running the unit test suite.
Type the following to compile and run the dlib unit test suite: Type the following to compile and run the dlib unit test suite:
- 编译单元测试
```shell ```shell
cd dlib/test cd dlib/test
mkdir build mkdir build
cd build cd build
cmake .. -DCMAKE_CXX_COMPILER=/opt/dtk/bin/hipcc cmake .. -DCMAKE_CXX_COMPILER=/opt/dtk/bin/hipcc
cmake --build . -j16 --config Release --verbose cmake --build . -j16 --config Release #--verbose
```
- 进行单元测试
./dtest --runall ```shell
./dtest -d --test_dnn ./dtest --runall # 全部测试
./dtest -d --test_rocblas # 测试单个测试单元
``` ```
Note that on windows your compiler might put the test executable in a subfolder called `Release`. If that's the case then you have to go to that folder before running the test. #### 编译 dlib Python API
This library is licensed under the Boost Software License, which can be found in [dlib/LICENSE.txt](https://github.com/davisking/dlib/blob/master/dlib/LICENSE.txt). The long and - 使用python安装
short of the license is that you can use dlib however you like, even in closed source commercial software.
## dlib sponsors ```shell
python setup.py install --set CMAKE_CXX_COMPILER=/opt/dtk/bin/hipcc
```
This research is based in part upon work supported by the Office of the Director of National Intelligence (ODNI), Intelligence Advanced Research Projects Activity (IARPA) under - 使用python编译whl包
contract number 2014-14071600010. The views and conclusions contained herein are those of the authors and should not be interpreted as necessarily representing the official
policies or endorsements, either expressed or implied, of ODNI, IARPA, or the U.S. Government.
```shell
python setup.py bdist_wheel --set CMAKE_CXX_COMPILER=/opt/dtk/bin/hipcc
```
\ No newline at end of file
# DLIB
## 环境配置
使用DCU编译之前,需要准备编译环境。参考
[environment prepare](environment_prepare.md)
## 使用源码安装
### 编译环境准备(以dtk-23.04版本为例)
- 拉取代码
```
git clone -b develop http://developer.hpccube.com/codes/aicomponent/dlib.git
```
-[开发者社区](https://developer.hpccube.com/tool/#sdk) DCU Toolkit 中下载 DTK-23.04 解压至 /opt/ 路径下,并建立软链接
```
cd /opt && ln -s dtk-23.04 dtk
```
- 导入环境变量以及安装必要依赖库
```shell
source /opt/dtk/env.sh
```
### 编译安装
#### 使用cmake编译
```shell
mkdir build; cd build;
cmake .. -DCMAKE_CXX_COMPILER=/opt/dtk/bin/hipcc
cmake --build . -j16 #--verbose
```
#### 单元测试
Running the unit test suite.
Type the following to compile and run the dlib unit test suite:
- 编译单元测试
```shell
cd dlib/test
mkdir build
cd build
cmake .. -DCMAKE_CXX_COMPILER=/opt/dtk/bin/hipcc
cmake --build . -j16 --config Release #--verbose
```
- 进行单元测试
```shell
./dtest --runall # 全部测试
./dtest -d --test_rocblas # 测试单个测试单元
```
#### 编译 dlib Python API
- 使用python安装
```shell
python setup.py install --set CMAKE_CXX_COMPILER=/opt/dtk/bin/hipcc
```
- 使用python编译whl包
```shell
python setup.py bdist_wheel --set CMAKE_CXX_COMPILER=/opt/dtk/bin/hipcc
```
\ No newline at end of file
# dlib C++ library [![GitHub Actions C++ Status](https://github.com/davisking/dlib/actions/workflows/build_cpp.yml/badge.svg)](https://github.com/davisking/dlib/actions/workflows/build_cpp.yml) [![GitHub Actions Python Status](https://github.com/davisking/dlib/actions/workflows/build_python.yml/badge.svg)](https://github.com/davisking/dlib/actions/workflows/build_python.yml)
Dlib is a modern C++ toolkit containing machine learning algorithms and tools for creating complex software in C++ to solve real world problems.
See [http://dlib.net](http://dlib.net) for the main project documentation and API reference.
## Compiling dlib C++ example programs
Go into the examples folder and type:
DCU编译之前,需要准备编译环境
[environment_prepare](environment_prepare.md)
```shell
mkdir build; cd build;
cmake .. -DCMAKE_CXX_COMPILER=/opt/dtk/bin/hipcc
cmake --build . -j16 --verbose
```
That will build all the examples.
If you have a CPU that supports AVX instructions then turn them on like this:
```shell
mkdir build; cd build; cmake .. -DUSE_AVX_INSTRUCTIONS=1; cmake --build .
```
Doing so will make some things run faster.
Finally, Visual Studio users should usually do everything in 64bit mode. By default Visual Studio is 32bit, both in its outputs and its own execution, so you have to explicitly
tell it to use 64bits. Since it's not the 1990s anymore you probably want to use 64bits. Do that with a cmake invocation like this:
```shell
cmake .. -G "Visual Studio 14 2015 Win64" -T host=x64
```
## Compiling your own C++ programs that use dlib
The examples folder has a [CMake tutorial](https://github.com/davisking/dlib/blob/master/examples/CMakeLists.txt) that tells you what to do. There are also additional instructions
on the [dlib web site](http://dlib.net/compile.html).
```shell
vcpkg install dlib
```
## Compiling dlib Python API
Before you can run the Python example programs you must compile dlib. Type:
```shell
python setup.py install --set CMAKE_CXX_COMPILER=/opt/dtk/bin/hipcc
```
## Running the unit test suite
Type the following to compile and run the dlib unit test suite:
```shell
cd dlib/test
mkdir build
cd build
cmake .. -DCMAKE_CXX_COMPILER=/opt/dtk/bin/hipcc
cmake --build . -j16 --config Release --verbose
./dtest --runall
./dtest -d --test_dnn
```
Note that on windows your compiler might put the test executable in a subfolder called `Release`. If that's the case then you have to go to that folder before running the test.
This library is licensed under the Boost Software License, which can be found in [dlib/LICENSE.txt](https://github.com/davisking/dlib/blob/master/dlib/LICENSE.txt). The long and
short of the license is that you can use dlib however you like, even in closed source commercial software.
## dlib sponsors
This research is based in part upon work supported by the Office of the Director of National Intelligence (ODNI), Intelligence Advanced Research Projects Activity (IARPA) under
contract number 2014-14071600010. The views and conclusions contained herein are those of the authors and should not be interpreted as necessarily representing the official
policies or endorsements, either expressed or implied, of ODNI, IARPA, or the U.S. Government.
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment