From 223c0e37c256b22a762c4e30042c9a99a7f86339 Mon Sep 17 00:00:00 2001 From: Bobholamovic Date: Mon, 31 Oct 2022 20:36:54 +0800 Subject: [PATCH 1/2] Update docs --- docs/README.md | 3 +- docs/change_detection.md | 22 +++++++-------- docs/classification.md | 4 +-- docs/dev.md | 13 +++++++-- docs/export_results.md | 11 ++++++++ docs/functions.md | 52 +++++++++++++++++++++-------------- docs/image_restoration.md | 4 +-- docs/object_detection.md | 4 +-- docs/online_BMap.md | 14 ++-------- docs/semantic_segmentation.md | 2 +- docs/user.md | 4 ++- 11 files changed, 79 insertions(+), 54 deletions(-) create mode 100644 docs/export_results.md diff --git a/docs/README.md b/docs/README.md index 461848b..6f98ced 100644 --- a/docs/README.md +++ b/docs/README.md @@ -15,6 +15,7 @@ - [目标检测功能使用说明](./object_detection.md) - [图像复原功能使用说明](./image_restoration.md) - [地物分类功能使用说明](./semantic_segmentation.md) - - [在线地图功能使用说明](./online_BMap.md) + - [导出解译结果说明](./export_results.md) + **高级功能使用说明** - [图像预处理、后处理功能使用说明](./functions.md) + - [在线地图功能使用说明](./online_BMap.md) diff --git a/docs/change_detection.md b/docs/change_detection.md index 9ffd310..01fd138 100644 --- a/docs/change_detection.md +++ b/docs/change_detection.md @@ -2,7 +2,7 @@ ## 功能描述 -对同一地点不同时期的图像进行分析，判断该地点的建筑物变化情况，并将变化部分结果图返回给用户。 +对同一地点不同时期的两幅影像进行分析，定位区域内发生的变化情况。PP-GeoView目前仅支持二类变化检测任务，即，结果中以不同颜色标识“变化”与“不变”。 ## 效果展示 @@ -11,7 +11,7 @@ pic

-+ 方式二：前后时期图片并排对比浏览 ++ 方式二：前后时期影像并排对比浏览

pic

@@ -20,24 +20,22 @@ ### 基本使用 -变化检测需要上传第一时期和第二时期的图，分别在两个上传框内上传，可以一次上传多张图，为了将属于同一组的两张图片匹配在一起，需要它们有相同的命名。如出现两上传框的上传图片数不同，属于一组的图片没有相同的命名，上传的文件格式错误等情况都会有相应信息提示。 +变化检测需要分别在两个上传框内上传第一时期和第二时期的图像，支持一次上传一组图像。为了正确匹配影像对，请确保第一时期和第二时期对应的影像具有相同的文件名。若出现两个上传框上传图像数量不同、存在无法被正确匹配的图像、或是上传的文件格式错误的情况，将给出相应的错误信息提示。 ### 高级功能 -+ 在变化检测前，可对输入图像进行图像增强。在功能界面可以点击选项框添加需要进行的图像增强操作。备选项如下： - - **直方图匹配**：适用于两幅图像风格差异比较大时，效果为使两幅图片风格保持一致 - - **图像锐化**：适用于图像分辨率较低，建筑物边缘模糊时，效果为增强建筑物的边缘、轮廓 ++ 在进行变化检测前，可对输入图像进行图像增强。在功能界面可以点击选项框添加需要进行的图像增强操作。备选项如下： + - **直方图匹配**：适用于两幅图像风格差异比较大的情况，效果为使两幅图像的灰度值分布尽可能保持一致。 + - **图像锐化**：适用于图像分辨率较低或建筑物边缘模糊的情况，效果为增强建筑物的边缘、轮廓。 + 在进行变化检测前，可对输入图像进行图像降噪。在功能界面可以点击选项框添加需要进行的图像降噪操作。备选项如下： - **平滑**：对影像进行中值滤波，适合用于去除类椒盐噪声。 - **滤波**：对影像进行高斯滤波，适合用于去除类高斯噪声。 -+ 在进行变化检测后，可对结果图像进行后处理，备选项如下： - - **结果图渲染**：效果如下图所示 -

- gif -

- - **连通域滤波+填充孔洞**：去除伪变化噪声点以及填充建筑物内的孔洞，使结果更加接近真实情况，效果如下图所示 ++ 在进行变化检测后，可在“结果图渲染”结果图像的配色方案。 + ++ 在进行变化检测后，可对结果图像进行后处理。勾选“开启连通域滤波并填充孔洞处理”以启用此功能。备选项如下： + - **连通域滤波+孔洞填充**：去除伪变化噪声点以及填充变化区域内的孔洞，使结果更加接近真实情况。效果如下图所示：

gif

diff --git a/docs/classification.md b/docs/classification.md index d33c5d1..0a4fb46 100644 --- a/docs/classification.md +++ b/docs/classification.md @@ -2,7 +2,7 @@ ## 功能描述 -对图像进行场景判断，并将场景的类别名称返回给用户 +对图像进行场景分类，输出类别名称和置信度。 ## 效果展示 @@ -14,4 +14,4 @@ ### 基本使用 -点击上传按钮，选择单张图片或包含多张图片的文件夹并确认。 +点击“上传”按钮，选择单张图片或包含多张图片的文件夹并确认。 diff --git a/docs/dev.md b/docs/dev.md index 1ed9bb5..0dd687d 100644 --- a/docs/dev.md +++ b/docs/dev.md @@ -21,13 +21,13 @@ PP-GeoView基于PaddleRS导出的推理格式（静态图）模型进行图像 若您需要使用自定义模型，请参考[使用PaddleRS训练和导出模型](https://github.com/PaddlePaddle/PaddleRS/blob/develop/deploy/export/README.md#11) 。 -### （可选）使用PaddleRS训练和导出模型 +### （可选）使用 PaddleRS 训练和导出模型 请参考PaddleRS[模型训练文档](https://github.com/PaddlePaddle/PaddleRS/blob/develop/tutorials/train/README.md) 与[模型导出文档](https://github.com/PaddlePaddle/PaddleRS/blob/develop/deploy/export/README.md) 。 -### 将模型导入到PP-GeoView +### 将模型导入到 PP-GeoView 请遵循如下步骤导入模型： @@ -77,6 +77,15 @@ host: frontend: {前端监听ip} ``` +### 百度地图 Access Key 设置 + +在项目根目录下的`config.yaml`文件中将``替换为百度地图的Access Key。百度地图的Access Key可在[百度地图开放平台](http://lbsyun.baidu.com/apiconsole/key?application=key)申请。 + +``` yaml +baidu_map: + access_key: +``` + ## Web 前后端启动 ### 启动 Web 后端 diff --git a/docs/export_results.md b/docs/export_results.md new file mode 100644 index 0000000..c12aee3 --- /dev/null +++ b/docs/export_results.md @@ -0,0 +1,11 @@ +# 导出解译结果说明 + +PP-GeoView提供两种导出解译结果的方式：下载图像或压缩包。 + +## 下载结果图 + +可通过点击结果图下方的“下载”图标，将解译结果下载到本地。 + +## 下载压缩包 + +可点击“结果图打包”将本次解译输出的所有结果图压缩并打包。当一次上传图片超过10张时，将自动提示是否使用此功能。 \ No newline at end of file diff --git a/docs/functions.md b/docs/functions.md index 827e3da..7a7e1e7 100644 --- a/docs/functions.md +++ b/docs/functions.md @@ -1,26 +1,38 @@ -# 各预处理、后处理功能说明 -## 图像预处理功能说明： -- 1.**直方图匹配**：直方图匹配又称为直方图规定化，是指将一幅图像的直方图变成规定形状的直方图而进行的图像增强方法。即将某幅影像或某一区域的直方图匹配到另一幅影像上。使两幅影像的色调保持一致。 -此功能可以减少因季节变化等外部原因造成图像风格差异较大对预测结果带来的影响，[详情参考请点这里](https://blog.csdn.net/mmmmmk_/article/details/82927411)。其效果如下图所示： +# 图像预处理、后处理功能使用说明 + +## 图像预处理 + +### 图像增强 + +PP-GeoView对部分任务提供图像增强功能，具体有如下3种类型： + +- [**直方图匹配**](https://baike.baidu.com/item/%E7%9B%B4%E6%96%B9%E5%9B%BE%E5%8C%B9%E9%85%8D/4861714)：又称为直方图规定化，是指将一幅图像的直方图变成规定形状的直方图的图像增强方法。即，将某幅影像或某一区域的直方图匹配到另一幅影像上。使两幅影像的色调保持一致。此功能可以减少因季节变化等外部原因造成图像风格差异较大从而对预测结果带来的负面影响。直方图匹配效果如下图所示：

pic

-- 2.**CLAHE**： 即限制对比度自适应直方图均衡化，其功能是在增强图像对比度的同时限制噪声的放大，适用于图像背景与目标物比较难区分的场景，可以有效提高图像的对比度。[详情参考请点这里](https://blog.csdn.net/qq_43743037/article/details/107195117)其效果图如下所示: + +- **CLAHE**： 全称为“限制对比度自适应直方图均衡化”，该功能在增强图像对比度的同时限制噪声的放大，适用于图像背景与目标物比较难区分的场景。CLAHE效果如下图所示:

pic

-- 3.**锐化**：锐化就是通过增强高频分量来减少图象中的模糊，因此又称为高通滤波。锐化处理在增强图象边缘的同时增加了图象的噪声。[详情参考请点这里](https://blog.csdn.net/qq_50559644/article/details/123925265) -## 图像降噪功能说明： -- 1.**平滑**：PP-GeoView为了使用户理解更加方便，用“平滑”这一称呼代替了中值滤波，即二者是等价的。有关中值滤波的[详情请参考这里](https://blog.csdn.net/qq_50559644/article/details/123925265) -- 2.**滤波**：PP-GeoView为了使用户理解更加方便，用“滤波”这一称呼代替了高斯滤波，即二者是等价的。有关高斯滤波的[详情请参考这里](https://blog.csdn.net/qq_50559644/article/details/123925265) -## 变化检测图像后处理说明： - 针对变化检测这一任务的特殊性，我们提供了连通域滤波+建筑物孔洞填充这一操作，用户如果对系统预测结果不满意即可在结果图展示处上方勾选“开启连通域滤波并填充孔洞处理”选项，之后会自动将结果图中的零散伪变化点去除，并填充建筑物内部的孔洞，使结果更加接近真实情况。具体效果如下图所示： -

- -

- -# 导出编译结果功能说明 -## 图片下载功能说明： - 可通过点击结果图下方的下载图标，获取下载图。 -## 图片压缩打包功能说明： - 可点击“结果图打包”获取所有结果图的压缩文件，当一次上传图片超过10张时，将提示用户是否压缩图片，选择“是”，则将本次上传的所有结果图打包。 + +- [**锐化**](https://baike.baidu.com/item/%E5%9B%BE%E5%83%8F%E9%94%90%E5%8C%96/9949080)：通过增强高频分量来减少图像中的模糊，可视为高通滤波。需注意的是，锐化处理在增强图像边缘细节的同时也可能增强图像中存在的噪声。 + +在上传图片后勾选对应选项，可执行相应图像增强操作。 + +### 图像降噪 + +PP-GeoView对部分任务提供图像降噪功能，具体有以下2种类型： + +- **平滑**：即[中值滤波](https://baike.baidu.com/item/%E4%B8%AD%E5%80%BC%E6%BB%A4%E6%B3%A2/5031069)。为使用户理解更加方便，使用“平滑”这一称呼。 + +- **滤波**：即[高斯滤波](https://baike.baidu.com/item/%E9%AB%98%E6%96%AF%E6%BB%A4%E6%B3%A2/9032353)。为使用户理解更加方便，使用“滤波”这一称呼。 + +在上传图片后勾选对应选项，可执行相应图像降噪操作。 + +## 变化检测结果后处理 + +针对变化检测任务的特殊性，PP-GeoView提供连通域滤波+孔洞填充的后处理操作，在结果图展示处上方勾选“开启连通域滤波并填充孔洞处理”选项可启用此功能。一般来说，启用此项功能后，结果图中的零散伪变化点将得到去除，同时变化区域内部的孔洞得到填充。具体效果如下图所示： +

+ +

\ No newline at end of file diff --git a/docs/image_restoration.md b/docs/image_restoration.md index 837baa2..9a9c9e3 100644 --- a/docs/image_restoration.md +++ b/docs/image_restoration.md @@ -2,7 +2,7 @@ ## 功能描述 -恢复已被退化的遥感图像的本来面目，并将修复好的图像返回给用户。 +对存在噪声、模糊等不同类型失真的遥感影像进行复原，或是对低分辨率影像进行超分辨率重建，输出修复或重建后的影像。 ## 效果展示 @@ -12,4 +12,4 @@ ## 使用方法 -点击上传按钮，选择单张图片或包含多张图片的文件夹并确认。 +点击“上传”按钮，选择单张图片或包含多张图片的文件夹并确认。 diff --git a/docs/object_detection.md b/docs/object_detection.md index c7402dd..c89ca99 100644 --- a/docs/object_detection.md +++ b/docs/object_detection.md @@ -2,7 +2,7 @@ ## 功能描述 -对图像进行目标检测识别，并将图像中的目标物体用颜色框标记出来，最终将结果图呈现给用户。 +对图像进行目标检测，并将图像中不同类别的的目标用不同颜色的方框标记。 ## 效果展示 @@ -14,7 +14,7 @@ ### 基本使用 -点击上传按钮，选择单张图片或包含多张图片的文件夹并确认。 +点击“上传”按钮，选择单张图片或包含多张图片的文件夹并确认。 ### 高级功能 diff --git a/docs/online_BMap.md b/docs/online_BMap.md index 452a1da..8319c8a 100644 --- a/docs/online_BMap.md +++ b/docs/online_BMap.md @@ -2,25 +2,17 @@ ## 功能描述 -提供在线百度地图服务，允许用户搜索位置定位，截取图片，自定义训练模型，上传至目标检测、地物分类、场景分类和图像复原功能区。 +提供在线百度地图服务，允许用户通过地图定位、截取图片。支持目标检测、地物分类、场景分类和图像复原任务。 ## 使用方法 -### 填充百度地图Access Key - -在根目录下的`config.yaml`文件中百度地图配置处，将``替换为百度地图的Access Key。百度地图的Access Key可在[百度地图开放平台](http://lbsyun.baidu.com/apiconsole/key?application=key)申请。 -``` yaml -baidu_map: - access_key: -``` - ### 基本使用 -在输入框输入位置信息，选择搜索结果，定位到该地，可在地图右上角设置地图模式（混合地图模式和卫星地图模式），如图： +在搜索框输入位置信息，选择“搜索结果”，定位到感兴趣地点。可在地图右上角设置地图模式（混合地图模式和卫星地图模式）。如图：

pic

-截取图片后，可选择上传功能区和训练模型，上传成功后即可查看效果，如图： +截取图片后，可选择上传功能区和需要使用的模型，上传成功后即可查看效果，如图：

pic

diff --git a/docs/semantic_segmentation.md b/docs/semantic_segmentation.md index 5bebb5e..fd8f539 100644 --- a/docs/semantic_segmentation.md +++ b/docs/semantic_segmentation.md @@ -14,7 +14,7 @@ ### 基本使用 -点击上传按钮，选择单张图片或包含多张图片的文件夹并确认。 +点击“上传”按钮，选择单张图片或包含多张图片的文件夹并确认。 ### 高级功能 diff --git a/docs/user.md b/docs/user.md index 9cf22ff..830f3ec 100644 --- a/docs/user.md +++ b/docs/user.md @@ -2,7 +2,7 @@ > 阅读如下教程前，请确保您已参照[文档](../README.md)正确安装PP-GeoView。 -PP-GeoView提供变化检测、场景分类、目标检测、图像复原、地物分类等5大遥感任务的解译功能，同时提供遥感影像预处理、解译结果后处理、解译结果导出以及在线地图解译功能。请参考具体功能使用说明： +PP-GeoView提供变化检测、场景分类、目标检测、图像复原、地物分类等5大遥感任务的解译功能，同时提供遥感影像预处理、解译结果后处理以及在线地图解译功能。请参考具体功能使用说明： + **基本功能使用说明** - [变化检测功能使用说明](./change_detection.md) @@ -10,5 +10,7 @@ PP-GeoView提供变化检测、场景分类、目标检测、图像复原、地 - [目标检测功能使用说明](./object_detection.md) - [图像复原功能使用说明](./image_restoration.md) - [地物分类功能使用说明](./semantic_segmentation.md) + - [导出解译结果说明](./export_results.md) + **高级功能使用说明** - [图像预处理、后处理功能使用说明](./functions.md) + - [在线地图功能使用说明](./online_BMap.md) From ed1c697c1fe250e2868268cfe18b1ab1b0dd9a93 Mon Sep 17 00:00:00 2001 From: Bobholamovic Date: Mon, 31 Oct 2022 20:46:49 +0800 Subject: [PATCH 2/2] Fix code style --- docs/export_results.md | 2 +- docs/functions.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/export_results.md b/docs/export_results.md index c12aee3..5fbb898 100644 --- a/docs/export_results.md +++ b/docs/export_results.md @@ -8,4 +8,4 @@ PP-GeoView提供两种导出解译结果的方式：下载图像或压缩包。 ## 下载压缩包 -可点击“结果图打包”将本次解译输出的所有结果图压缩并打包。当一次上传图片超过10张时，将自动提示是否使用此功能。 \ No newline at end of file +可点击“结果图打包”将本次解译输出的所有结果图压缩并打包。当一次上传图片超过10张时，将自动提示是否使用此功能。 diff --git a/docs/functions.md b/docs/functions.md index 7a7e1e7..c6f3a01 100644 --- a/docs/functions.md +++ b/docs/functions.md @@ -35,4 +35,4 @@ PP-GeoView对部分任务提供图像降噪功能，具体有以下2种类型： 针对变化检测任务的特殊性，PP-GeoView提供连通域滤波+孔洞填充的后处理操作，在结果图展示处上方勾选“开启连通域滤波并填充孔洞处理”选项可启用此功能。一般来说，启用此项功能后，结果图中的零散伪变化点将得到去除，同时变化区域内部的孔洞得到填充。具体效果如下图所示：

-

\ No newline at end of file +