Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Docs] 优化基础使用文档 #50

Merged
merged 3 commits into from
Oct 31, 2022
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,7 @@
- [目标检测功能使用说明](./object_detection.md)
- [图像复原功能使用说明](./image_restoration.md)
- [地物分类功能使用说明](./semantic_segmentation.md)
- [在线地图功能使用说明](./online_BMap.md)
- [导出解译结果说明](./export_results.md)
+ **高级功能使用说明**
- [图像预处理、后处理功能使用说明](./functions.md)
- [在线地图功能使用说明](./online_BMap.md)
22 changes: 10 additions & 12 deletions docs/change_detection.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## 功能描述

对同一地点不同时期的图像进行分析,判断该地点的建筑物变化情况,并将变化部分结果图返回给用户
对同一地点不同时期的两幅影像进行分析,定位区域内发生的变化情况。PP-GeoView目前仅支持二类变化检测任务,即,结果中以不同颜色标识“变化”与“不变”

## 效果展示

Expand All @@ -11,7 +11,7 @@
<img src="https://user-images.githubusercontent.com/78073130/198859495-2421f879-80ee-4766-9791-3f978c0c15e3.png" alt = "pic" width = "600" />
</p>

+ 方式二:前后时期图片并排对比浏览
+ 方式二:前后时期影像并排对比浏览
<p align="center">
<img src="https://user-images.githubusercontent.com/78073130/198859728-e702883e-d0e7-4ad8-9b1e-a3084b78371c.jpg" alt = "pic" width = "600" />
</p>
Expand All @@ -20,24 +20,22 @@

### 基本使用

变化检测需要上传第一时期和第二时期的图,分别在两个上传框内上传,可以一次上传多张图,为了将属于同一组的两张图片匹配在一起,需要它们有相同的命名。如出现两上传框的上传图片数不同,属于一组的图片没有相同的命名,上传的文件格式错误等情况都会有相应信息提示
变化检测需要分别在两个上传框内上传第一时期和第二时期的图像,支持一次上传一组图像。为了正确匹配影像对,请确保第一时期和第二时期对应的影像具有相同的文件名。若出现两个上传框上传图像数量不同、存在无法被正确匹配的图像、或是上传的文件格式错误的情况,将给出相应的错误信息提示

### 高级功能

+ 在变化检测前,可对输入图像进行图像增强。在功能界面可以点击选项框添加需要进行的图像增强操作。备选项如下:
- **直方图匹配**:适用于两幅图像风格差异比较大时,效果为使两幅图片风格保持一致
- **图像锐化**:适用于图像分辨率较低,建筑物边缘模糊时,效果为增强建筑物的边缘、轮廓
+ 在进行变化检测前,可对输入图像进行图像增强。在功能界面可以点击选项框添加需要进行的图像增强操作。备选项如下:
- **直方图匹配**:适用于两幅图像风格差异比较大的情况,效果为使两幅图像的灰度值分布尽可能保持一致。
- **图像锐化**:适用于图像分辨率较低或建筑物边缘模糊的情况,效果为增强建筑物的边缘、轮廓

+ 在进行变化检测前,可对输入图像进行图像降噪。在功能界面可以点击选项框添加需要进行的图像降噪操作。备选项如下:
- **平滑**:对影像进行中值滤波,适合用于去除类椒盐噪声。
- **滤波**:对影像进行高斯滤波,适合用于去除类高斯噪声。

+ 在进行变化检测后,可对结果图像进行后处理,备选项如下:
- **结果图渲染**:效果如下图所示
<p align="center">
<img src="https://user-images.githubusercontent.com/78073130/198608703-71212c00-27f7-4fa6-8916-30dd837874fa.gif" alt = "gif" width = "600" />
</p>
- **连通域滤波+填充孔洞**:去除伪变化噪声点以及填充建筑物内的孔洞,使结果更加接近真实情况,效果如下图所示
+ 在进行变化检测后,可在“结果图渲染”结果图像的配色方案。

+ 在进行变化检测后,可对结果图像进行后处理。勾选“开启连通域滤波并填充孔洞处理”以启用此功能。备选项如下:
- **连通域滤波+孔洞填充**:去除伪变化噪声点以及填充变化区域内的孔洞,使结果更加接近真实情况。效果如下图所示:
<p align="center">
<img src="https://user-images.githubusercontent.com/78073130/198609084-a9b27edb-b6ba-40da-9e14-782a134ddc33.png" alt = "gif" width = "600" />
</p>
4 changes: 2 additions & 2 deletions docs/classification.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## 功能描述

对图像进行场景判断,并将场景的类别名称返回给用户
对图像进行场景分类,输出类别名称和置信度。

## 效果展示

Expand All @@ -14,4 +14,4 @@

### 基本使用

点击上传按钮,选择单张图片或包含多张图片的文件夹并确认。
点击“上传”按钮,选择单张图片或包含多张图片的文件夹并确认。
13 changes: 11 additions & 2 deletions docs/dev.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

请遵循如下步骤导入模型:

Expand Down Expand Up @@ -77,6 +77,15 @@ host:
frontend: {前端监听ip}
```

### 百度地图 Access Key 设置

在项目根目录下的`config.yaml`文件中将`<ACCESS_KEY>`替换为百度地图的Access Key。百度地图的Access Key可在[百度地图开放平台](http://lbsyun.baidu.com/apiconsole/key?application=key)申请。

``` yaml
baidu_map:
access_key: <ACCESS_KEY>
```

## Web 前后端启动

### 启动 Web 后端
Expand Down
11 changes: 11 additions & 0 deletions docs/export_results.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
# 导出解译结果说明

PP-GeoView提供两种导出解译结果的方式:下载图像或压缩包。

## 下载结果图

可通过点击结果图下方的“下载”图标,将解译结果下载到本地。

## 下载压缩包

可点击“结果图打包”将本次解译输出的所有结果图压缩并打包。当一次上传图片超过10张时,将自动提示是否使用此功能。
52 changes: 32 additions & 20 deletions docs/functions.md
Original file line number Diff line number Diff line change
@@ -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):又称为直方图规定化,是指将一幅图像的直方图变成规定形状的直方图的图像增强方法。即,将某幅影像或某一区域的直方图匹配到另一幅影像上。使两幅影像的色调保持一致。此功能可以减少因季节变化等外部原因造成图像风格差异较大从而对预测结果带来的负面影响。直方图匹配效果如下图所示:
<p align="center">
<img src="https://user-images.githubusercontent.com/78073130/198608558-7f5a1b9c-c9c6-4686-871d-e22a69b6e235.png" alt ='pic' width = "600" />
</p>
- 2.**CLAHE**: 即限制对比度自适应直方图均衡化,其功能是在增强图像对比度的同时限制噪声的放大,适用于图像背景与目标物比较难区分的场景,可以有效提高图像的对比度。[详情参考请点这里](https://blog.csdn.net/qq_43743037/article/details/107195117)其效果图如下所示:

- **CLAHE**: 全称为“限制对比度自适应直方图均衡化”,该功能在增强图像对比度的同时限制噪声的放大,适用于图像背景与目标物比较难区分的场景。CLAHE效果如下图所示:
<p align="center">
<img src="https://user-images.githubusercontent.com/78073130/198608351-671ef6c5-77c9-408a-a4d8-6cb4417b4293.png" alt ='pic' width = "600" />
</p>
- 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)
## 变化检测图像后处理说明:
针对变化检测这一任务的特殊性,我们提供了连通域滤波+建筑物孔洞填充这一操作,用户如果对系统预测结果不满意即可在结果图展示处上方勾选“开启连通域滤波并填充孔洞处理”选项,之后会自动将结果图中的零散伪变化点去除,并填充建筑物内部的孔洞,使结果更加接近真实情况。具体效果如下图所示:
<p align="center">
<img src="https://user-images.githubusercontent.com/78073130/198609084-a9b27edb-b6ba-40da-9e14-782a134ddc33.png" align="middle" width = "600" />
</p>

# 导出编译结果功能说明
## 图片下载功能说明:
可通过点击结果图下方的下载图标,获取下载图。
## 图片压缩打包功能说明:
可点击“结果图打包”获取所有结果图的压缩文件,当一次上传图片超过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提供连通域滤波+孔洞填充的后处理操作,在结果图展示处上方勾选“开启连通域滤波并填充孔洞处理”选项可启用此功能。一般来说,启用此项功能后,结果图中的零散伪变化点将得到去除,同时变化区域内部的孔洞得到填充。具体效果如下图所示:
<p align="center">
<img src="https://user-images.githubusercontent.com/78073130/198609084-a9b27edb-b6ba-40da-9e14-782a134ddc33.png" align="middle" width = "600" />
</p>
4 changes: 2 additions & 2 deletions docs/image_restoration.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## 功能描述

恢复已被退化的遥感图像的本来面目,并将修复好的图像返回给用户
对存在噪声、模糊等不同类型失真的遥感影像进行复原,或是对低分辨率影像进行超分辨率重建,输出修复或重建后的影像

## 效果展示

Expand All @@ -12,4 +12,4 @@

## 使用方法

点击上传按钮,选择单张图片或包含多张图片的文件夹并确认。
点击“上传”按钮,选择单张图片或包含多张图片的文件夹并确认。
4 changes: 2 additions & 2 deletions docs/object_detection.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## 功能描述

对图像进行目标检测识别,并将图像中的目标物体用颜色框标记出来,最终将结果图呈现给用户
对图像进行目标检测,并将图像中不同类别的的目标用不同颜色的方框标记

## 效果展示

Expand All @@ -14,7 +14,7 @@

### 基本使用

点击上传按钮,选择单张图片或包含多张图片的文件夹并确认。
点击“上传”按钮,选择单张图片或包含多张图片的文件夹并确认。

### 高级功能

Expand Down
14 changes: 3 additions & 11 deletions docs/online_BMap.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,25 +2,17 @@

## 功能描述

提供在线百度地图服务,允许用户搜索位置定位,截取图片,自定义训练模型,上传至目标检测、地物分类、场景分类和图像复原功能区
提供在线百度地图服务,允许用户通过地图定位、截取图片。支持目标检测、地物分类、场景分类和图像复原任务

## 使用方法

### 填充百度地图Access Key

在根目录下的`config.yaml`文件中百度地图配置处,将`<ACCESS_KEY>`替换为百度地图的Access Key。百度地图的Access Key可在[百度地图开放平台](http://lbsyun.baidu.com/apiconsole/key?application=key)申请。
``` yaml
baidu_map:
access_key: <ACCESS_KEY>
```

### 基本使用

在输入框输入位置信息,选择搜索结果,定位到该地,可在地图右上角设置地图模式(混合地图模式和卫星地图模式)如图:
在搜索框输入位置信息,选择“搜索结果”,定位到感兴趣地点。可在地图右上角设置地图模式(混合地图模式和卫星地图模式)如图:
<p align="center">
<img src="https://user-images.githubusercontent.com/90198481/198829346-67e8945d-d587-4feb-a9cb-dc787e267114.png" alt = "pic" width = "600" />
</p>
截取图片后,可选择上传功能区和训练模型,上传成功后即可查看效果,如图:
截取图片后,可选择上传功能区和需要使用的模型,上传成功后即可查看效果,如图:
<p align="center">
<img src="https://user-images.githubusercontent.com/90198481/198829708-61aed428-4a9d-4cc9-8619-b26164900011.png" alt = "pic" width="600" />
</p>
Expand Down
2 changes: 1 addition & 1 deletion docs/semantic_segmentation.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@

### 基本使用

点击上传按钮,选择单张图片或包含多张图片的文件夹并确认。
点击“上传”按钮,选择单张图片或包含多张图片的文件夹并确认。

### 高级功能

Expand Down
4 changes: 3 additions & 1 deletion docs/user.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,13 +2,15 @@

> 阅读如下教程前,请确保您已参照[文档](../README.md)正确安装PP-GeoView。

PP-GeoView提供变化检测、场景分类、目标检测、图像复原、地物分类等5大遥感任务的解译功能,同时提供遥感影像预处理、解译结果后处理、解译结果导出以及在线地图解译功能。请参考具体功能使用说明:
PP-GeoView提供变化检测、场景分类、目标检测、图像复原、地物分类等5大遥感任务的解译功能,同时提供遥感影像预处理、解译结果后处理以及在线地图解译功能。请参考具体功能使用说明:

+ **基本功能使用说明**
- [变化检测功能使用说明](./change_detection.md)
- [场景分类功能使用说明](./classification.md)
- [目标检测功能使用说明](./object_detection.md)
- [图像复原功能使用说明](./image_restoration.md)
- [地物分类功能使用说明](./semantic_segmentation.md)
- [导出解译结果说明](./export_results.md)
+ **高级功能使用说明**
- [图像预处理、后处理功能使用说明](./functions.md)
- [在线地图功能使用说明](./online_BMap.md)