From 56797ab64a51ec23d79205a99f735e59361ec83b Mon Sep 17 00:00:00 2001 From: Bobholamovic Date: Mon, 24 Oct 2022 16:35:43 +0800 Subject: [PATCH] Update README --- README.md | 321 +++++++++++++++++++++++++----------------- docs/images/intro.png | Bin 0 -> 7135 bytes 2 files changed, 189 insertions(+), 132 deletions(-) create mode 100644 docs/images/intro.png diff --git a/README.md b/README.md index 37b6376..2ba6a95 100644 --- a/README.md +++ b/README.md @@ -6,26 +6,26 @@ **飞桨高性能遥感影像开发套件，端到端完成从数据到部署的全流程遥感应用。** - + [![version](https://img.shields.io/github/release/PaddlePaddle/PaddleRS.svg)](https://github.com/PaddlePaddle/PaddleRS/releases) [![license](https://img.shields.io/badge/license-Apache%202-blue.svg)](LICENSE) [![build status](https://github.com/PaddlePaddle/PaddleRS/actions/workflows/build.yaml/badge.svg?branch=develop)](https://github.com/PaddlePaddle/PaddleRS/actions) ![python version](https://img.shields.io/badge/python-3.7+-orange.svg) ![support os](https://img.shields.io/badge/os-linux%2C%20win%2C%20mac-yellow.svg) -## 最新动态 +## 最新动态 * [2022-05-19] 🔥 PaddleRS发布1.0-beta版本，全面支持遥感领域深度学习任务。详细发版信息请参考[Release Note](https://github.com/PaddlePaddle/PaddleRS/releases)。 -## 简介 +## 简介 PaddleRS是百度飞桨、遥感科研院所及相关高校共同开发的基于飞桨的遥感影像智能化处理套件，支持图像分割、目标检测、场景分类、变化检测以及图像复原等常见遥感任务。PaddleRS致力于帮助遥感领域科研从业者快速完成算法的研发、验证和调优，以及帮助投身于产业实践的开发者便捷地实现从数据预处理到模型部署的全流程遥感深度学习应用。
- +
-## 特性 +## 特性 PaddleRS具有以下五大特色： @@ -39,19 +39,31 @@ PaddleRS具有以下五大特色： * **工业级训练与部署性能**：支持多进程异步I/O、多卡并行训练等加速策略，结合飞桨核心框架的显存优化功能，可大幅度减少模型的训练开销，帮助开发者以更低成本、更高效地完成遥感的开发和训练。 -## 产品矩阵 +
+ +
+ +## 技术交流 + +* 如果您发现任何PaddleRS存在的问题或是对PaddleRS有建议, 欢迎通过[GitHub Issues](https://github.com/PaddlePaddle/PaddleRS/issues)向我们提出。 +* 欢迎加入PaddleRS微信群： +
+ +
+ +## 产品矩阵 - +
- 模型总览 + 模型库 - 数据增强 + 数据变换算子 - 遥感工具 + 遥感特色工具 实践案例 @@ -59,158 +71,199 @@ PaddleRS具有以下五大特色：
- 场景分类
+
变化检测 - 语义分割
+
+
场景分类 - 目标检测
+
+
图像复原 - 图像复原
+
+
目标检测 - 变化检测
+
+
图像分割 +
- 数据增强
+
数据预处理
    -
  • Resize
    • -
  • RandomResize
    • -
  • ResizeByShort
    • -
  • RandomResizeByShort
    • -
  • ResizeByLong
    • -
  • RandomFlipOrRotate
    • -
  • RandomHorizontalFlip
    • -
  • RandomVerticalFlip
    • -
  • Normalize
    • +
  • AppendIndex（遥感指数计算）
  • CenterCrop
    • -
  • RandomCrop
    • -
  • RandomScaleAspect
    • -
  • RandomExpand
    • +
  • Dehaze（影像去雾）
    • +
  • MatchRadiance（辐射校正）
    • +
  • Normalize
  • Pad
    • -
  • MixupImage
    • -
  • RandomDistort
    • -
  • RandomBlur
    • -
  • Dehaze
    • -
  • ReduceDim
    • -
  • SelectBand
    • -
  • RandomSwap
    • -
  • AppendIndex
    • -
  • ...
    • -
-
- 数据格式转换
-
    -
  • coco to mask
    • -
  • geojson to mask
    • -
  • mask to shpfile
    • -
  • ...
    • -
- 数据预处理
-
    -
  • 影像切片
    • -
  • 影像配准
    • -
  • 波段选择
    • -
  • 辐射校正
    • -
  • ...
    • +
  • ReduceDim（高光谱降维）
    • +
  • Resize
    • +
  • ResizeByLong
    • +
  • ResizeByShort
    • +
  • SelectBand（波段选择）
    • +
  • ...
- 数据后处理
+ +
数据增强
    -
  • 建筑边界规则化
    • -
  • 道路断线连接
    • -
  • ...
    • +
  • MixupImage
    • +
  • RandomBlur
    • +
  • RandomCrop
    • +
  • RandomDistort
    • +
  • RandomExpand
    • +
  • RandomHorizontalFlip
    • +
  • RandomResize
    • +
  • RandomResizeByShort
    • +
  • RandomScaleAspect
    • +
  • RandomSwap（随机时序交换）
    • +
  • RandomVerticalFlip
    • +
  • ...
- 数据可视化
+
+
遥感指数
    -
  • 地图-栅格可视化
    • -
  • ...
    • +
  • ARI
    • +
  • ARI2
    • +
  • ARVI
    • +
  • AWEInsh
    • +
  • AWEIsh
    • +
  • BAI
    • +
  • BI
    • +
  • BLFEI
    • +
  • BNDVI
    • +
  • BWDRVI
    • +
  • BaI
    • +
  • CIG
    • +
  • CSI
    • +
  • CSIT
    • +
  • DBI
    • +
  • DBSI
    • +
  • DVI
    • +
  • EBBI
    • +
  • EVI
    • +
  • EVI2
    • +
  • FCVI
    • +
  • GARI
    • +
  • GBNDVI
    • +
  • GLI
    • +
  • GRVI
    • +
  • IPVI
    • +
  • LSWI
    • +
  • MBI
    • +
  • MGRVI
    • +
  • MNDVI
    • +
  • MNDWI
    • +
  • MSI
    • +
  • NBLI
    • +
  • NDVI
    • +
  • NDWI
    • +
  • NDYI
    • +
  • NIRv
    • +
  • PSRI
    • +
  • RI
    • +
  • SAVI
    • +
  • SWI
    • +
  • TDVI
    • +
  • UI
    • +
  • VIG
    • +
  • WI1
    • +
  • WI2
    • +
  • WRI
    • +
  • ...
+
- 遥感场景分类
+
数据格式转换 - 遥感图像分割
+
+
数据集制作 - 遥感目标检测
+
+ +
数据后处理 - 遥感变化检测
+
+
数据可视化 - 遥感图像复原
+
+
开源数据集预处理 +
+
-### 代码结构 - -PaddleRS目录树中关键部分如下： - -``` -├── deploy # 部署相关文档与脚本 -├── docs # 项目文档 -├── paddlers -│ ├── rs_models # 遥感专用模型实现 -│ ├── datasets # 数据集接口实现 -│ ├── models # 视觉模型实现 -│ ├── tasks # 训练器实现 -│ ├── transforms # 数据预处理/数据增强实现 -│ └── utils # 数据下载/可视化/后处理等 -├── tools # 遥感影像处理工具集 -├── examples # 相关实践案例 -└── tutorials - └── train # 模型训练教程 -``` - -## 技术交流 - -* 如果您发现任何PaddleRS存在的问题或是对PaddleRS有建议, 欢迎通过[GitHub Issues](https://github.com/PaddlePaddle/PaddleRS/issues)向我们提出。 -* 欢迎加入PaddleRS微信群 -
- -
- -## 使用教程 +## 教程与文档 -* [快速上手PaddleRS](./tutorials/train/README.md) -* 准备数据集 +* 快速上手 + * [快速上手PaddleRS](./tutorials/train/README.md) +* 数据准备 * [快速了解遥感与遥感数据](./docs/data/rs_data.md) - * [遥感数据集整理](./docs/data/dataset.md) + * [开源遥感数据集汇总表](./docs/data/dataset.md) * [智能标注工具EISeg](https://github.com/PaddlePaddle/PaddleSeg/tree/release/2.6/EISeg) * [遥感影像处理工具集](./docs/data/tools.md) * 组件介绍 @@ -218,30 +271,34 @@ PaddleRS目录树中关键部分如下： * [模型库](./docs/intro/model_zoo.md) * [遥感指数](./docs/intro/indices.md) * [数据变换算子](./docs/intro/transforms.md) -* 模型训练 - * [模型训练API说明](./docs/apis/train.md) +* [模型训练](./tutorials/train/README.md) * 模型部署 * [模型导出](./deploy/export/README.md) * [Python部署](./deploy/README.md) - * [模型推理API说明](./docs/apis/infer.md) -* 实践案例 - * [PaddleRS实践案例库](./examples/README.md) * 代码贡献 * [贡献指南](./docs/CONTRIBUTING.md) * [开发指南](./docs/dev/dev_guide.md) * [代码注释规范](./docs/dev/docstring.md) + * [模型训练API说明](./docs/apis/train.md) + * [模型推理API说明](./docs/apis/infer.md) -## 开源贡献 +## 实践案例 -* 非常感谢国家对地观测科学数据中心、中国科学院空天信息创新研究院、北京航空航天大学、武汉大学、中国石油大学（华东）、中国地质大学、中国四维、航天宏图、中科星图、超图等单位对PaddleRS项目的贡献。注：排名不分先后。 -* 非常感谢[geoyee](https://github.com/geoyee)(陈奕州), [kongdebug](https://github.com/kongdebug)(孔远杭), [huilin16](https://github.com/huilin16)(赵慧琳)等开发者对PaddleRS项目的贡献。 -* PaddleRS欢迎来自开源社区的贡献。如果您想要为PaddleRS贡献源码/案例，请参考[贡献指南](./docs/CONTRIBUTING.md)。 +* [遥感影像智能解译工具PP-GeoView](https://github.com/PaddleCV-SIG/PP-GeoView) +* [PaddleRS科研实战：设计深度学习变化检测模型](./examples/rs_research/README.md) + +更多案例请参考[PaddleRS实践案例库](./examples/README.md)。 ## 许可证书 本项目的发布受[Apache 2.0 license](./LICENSE)许可认证。 -## 学术引用 +## 开源贡献 + +* 非常感谢国家对地观测科学数据中心、中国科学院空天信息创新研究院、北京航空航天大学、武汉大学、中国石油大学（华东）、中国地质大学、中国四维、航天宏图、中科星图、超图等单位对PaddleRS项目的贡献。注：排名不分先后。 +* 非常感谢[geoyee](https://github.com/geoyee)(陈奕州), [kongdebug](https://github.com/kongdebug)(孔远杭), [huilin16](https://github.com/huilin16)(赵慧琳)等开发者对PaddleRS项目的贡献。 + +## 学术引用 如果我们的项目在学术上帮助到您，请考虑以下引用： diff --git a/docs/images/intro.png b/docs/images/intro.png new file mode 100644 index 0000000000000000000000000000000000000000..db07debbeefe323eb560118b93104378a72befae GIT binary patch literal 7135 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