update all docs involving color label (#109)

docs/data_prepare.md

@@ -3,8 +3,11 @@
 ## 数据标注
 
 ### 标注协议
-PaddleSeg采用单通道的标注图片，每一种像素值代表一种类别，类别从0开始，例如0，1，2，3表示有4种类别。
+PaddleSeg采用单通道的标注图片，每一种像素值代表一种类别，像素标注类别需要从0开始递增，例如0，1，2，3表示有4种类别。
 
+**NOTE:** 标注图像请使用PNG无损压缩格式的图片。标注类别最多为256类。
+
+### 灰度标注vs伪彩色标注
 一般的分割库使用单通道灰度图作为标注图片，往往显示出来是全黑的效果。灰度标注图的弊端：
 1. 对图像标注后，无法直接观察标注是否正确。
 2. 模型测试过程无法直接判断分割的实际效果。
@@ -51,9 +54,7 @@ PddleSeg已支持2种标注工具：LabelMe、精灵数据标注工具。标注
 
 ### 文件列表规范
 
-PaddleSeg采用通用的文件列表方式组织训练集、验证集和测试集。像素标注类别需要从0开始递增。
-
-**NOTE:** 标注图像请使用PNG无损压缩格式的图片
+PaddleSeg采用通用的文件列表方式组织训练集、验证集和测试集。
 
 以Cityscapes数据集为例, 我们需要整理出训练集、验证集、测试集对应的原图和标注文件列表用于PaddleSeg训练即可。
 

docs/usage.md

@@ -33,7 +33,6 @@ python pdseg/train.py BATCH_SIZE 1 --cfg configs/cityscapes.yaml
 |--tb_log_dir|train|TensorBoard的日志路径|None||
 |--do_eval|train|是否在保存模型时进行效果评估|False||
 |--vis_dir|vis|保存可视化图片的路径|"visual"||
-|--also_save_raw_results|vis|是否保存原始的预测图片|False||
 
 ## OPTIONS
 
@@ -129,12 +128,10 @@ python pdseg/vis.py --use_gpu \
                      --cfg configs/unet_pet.yaml \
                      TEST.TEST_MODEL saved_model/unet_pet/final
 ```
-执行上述脚本后，会在主目录下产生一个visual/visual_results文件夹，里面存放着测试集图片的预测结果，我们选择其中几张图片进行查看，可以看到，在测试集中的图片上的预测效果已经很不错：
+执行上述脚本后，会在主目录下产生一个visual文件夹，里面存放着测试集图片的预测结果，我们选择其中几张图片进行查看，可以看到，在测试集中的图片上的预测效果已经很不错：
 
 ![](./imgs/usage_vis_demo.jpg)
-![](./imgs/usage_vis_demo2.jpg)
-![](./imgs/usage_vis_demo3.jpg)
 
 `NOTE`
-1. 可视化的图片会默认保存在visual/visual_results目录下，可以通过`--vis_dir`来指定输出目录
+1. 可视化的图片会默认保存在visual目录下，可以通过`--vis_dir`来指定输出目录
 2. 训练过程中会使用DATASET.VIS_FILE_LIST中的图片进行可视化显示，而vis.py则会使用DATASET.TEST_FILE_LIST

pdseg/vis.py

@@ -87,7 +87,7 @@ def to_png_fn(fn):
 def visualize(cfg,
               vis_file_list=None,
               use_gpu=False,
-              vis_dir="visual_predict",
+              vis_dir="visual",
               ckpt_dir=None,
               log_writer=None,
               local_test=False,
@@ -117,7 +117,7 @@ def visualize(cfg,
 
     fluid.io.load_params(exe, ckpt_dir, main_program=test_prog)
 
-    save_dir = os.path.join('visual', vis_dir)
+    save_dir = vis_dir
     makedirs(save_dir)
 
     fetch_list = [pred.name]