diff --git a/README.cn.md b/README.cn.md index e9ab70f6c5f627c76bc1fb5b2cd884b7947ac310..caa72086aa3561e8f28553f36c27dba39b218a15 100644 --- a/README.cn.md +++ b/README.cn.md @@ -25,28 +25,28 @@ VisualDL 目前支持4种组件: - image - histogram -### graph +### Graph 兼容 ONNX(Open Neural Network Exchange)[https://github.com/onnx/onnx], 通过与 python SDK的结合,VisualDL可以兼容包括 PaddlePaddle, pytorch, mxnet在内的大部分主流DNN平台。

-### scalar +### Scalar 可以用于展示训练测试的误差趋势

-### image +### Image 可以用于可视化任何tensor,或模型生成的图片

-### histogram +### Histogram 用于可视化任何tensor中元素分布的变化趋势 @@ -58,7 +58,7 @@ VisualDL 目前支持4种组件: 请使用下面的命令,来快速测试 VisualDL。 ``` -# 安装,建議是在虛擬環境下。 +# 安装,建議是在虚拟环境或anaconda下。 pip install --upgrade visualdl # 运行一个例子,vdl_create_scratch_log 将创建测试日志 @@ -68,6 +68,95 @@ visualDL --logdir=scratch_log --port=8080 # 访问 http://127.0.0.1:8080 ``` +如果以上步骤出现问题,很可能是因为python或pip不同版本或不同位置所致,以下安装方法能解决。 + +## 使用 virtualenv 安装 + +[Virtualenv](https://virtualenv.pypa.io/en/stable/) 能创建独立Python环境,也能确保Python和pip的相对位置正确。 + +在macOS上,安装pip和virtualenv如下: +``` +sudo easy_install pip +pip install --upgrade virtualenv +``` + +在Linux上,安装pip和virtualenv如下: +``` +sudo apt-get install python3-pip python3-dev python-virtualenv +``` + +然后创建一个虚拟环境: +``` +virtualenv ~/vdl # for Python2.7 +virtualenv -p python3 ~/vdl for Python 3.x +``` + +```~/vdl``` 是你的Virtualenv目录, 你也可以选择任一目录。 + +激活虚拟环境如下: +``` +source ~/vdl/bin/activate +``` + +现在再安装 VisualDL 和运行范例: + +``` +pip install --upgrade visualdl + +# 运行一个例子,vdl_create_scratch_log 将创建测试日志 +vdl_create_scratch_log +visualDL --logdir=scratch_log --port=8080 + +# 访问 http://127.0.0.1:8080 +``` + +如果在虚拟环境下仍然遇到安装问题,请尝试以下方法。 + + +## 使用 Anaconda 安装 + +Anaconda是一个用于科学计算的Python发行版,提供了包管理与环境管理的功能,可以很方便地解决多版本python并存、切换以及各种第三方包安装问题。 + +请根据[Anaconda下载网站](https://www.anaconda.com/download) 的指示去下载和安装Anaconda. +下载Python 3.6版本的command-Line installer. + +创建conda环境名字为```vdl```或任何名字: +``` +conda create -n vdl pip python=2.7 # or python=3.3, etc. +``` + +激活conda环境如下: +``` +source activate vdl +``` + +现在再安装 VisualDL 和运行范例: + +``` +pip install --upgrade visualdl + +# 运行一个例子,vdl_create_scratch_log 将创建测试日志 +vdl_create_scratch_log +visualDL --logdir=scratch_log --port=8080 + +# 访问 http://127.0.0.1:8080 +``` + +如果仍然遇到安装问题,请尝试以下用源代码安装方法。 + +### 使用代码安装 +``` +#建議是在虚拟环境或anaconda下。 +git clone https://github.com/PaddlePaddle/VisualDL.git +cd VisualDL + +python setup.py bdist_wheel +pip install --upgrade dist/visualdl-*.whl +``` + +如果打包和安装遇到其他问题,不安装只想运行Visual DL可以看[这里](https://github.com/PaddlePaddle/VisualDL/blob/develop/docs/how_to_dev_frontend_en.md) + + ## SDK VisualDL 同时提供了python SDK 和 C++ SDK 来实现不同方式的使用。 @@ -133,9 +222,6 @@ board 还支持一下参数来实现远程的访问: - `--port` 设定端口 - `--model_pb` 指定 ONNX 格式的模型文件 -VisualDL的图形系统采用` GraphViz `来可视化ONNX格式模型。 -请安装 [GraphViz](https://www.graphviz.org/download/)确保VisualDL图形系统可以启动 - ### 贡献 VisualDL 是由 [PaddlePaddle](http://www.paddlepaddle.org/) 和 diff --git a/README.md b/README.md index 27531ae6886d8bdb7aa8c37e18cd10ad409902be..d126cf8d41fb72b28a52dbfa1722a1dfa0c1e2fa 100644 --- a/README.md +++ b/README.md @@ -88,7 +88,7 @@ sudo easy_install pip pip install --upgrade virtualenv ``` -On Linux, install virtualenv by: +On Linux, install pip and virtualenv by: ``` sudo apt-get install python3-pip python3-dev python-virtualenv ```