一个高级地理空间数据分析平台
项目描述
whitebox-python
重要说明
此存储库仅与WhiteboxTools Python前端相关。如果您在安装此Python包时遇到问题，可以向此存储库报告问题。如果您遇到任何工具功能特定的错误，请在此处在John Lindsay博士的WhiteboxTools存储库上打开问题。
链接
作者：Dr. John Lindsay (https://jblindsay.github.io/ghrg/index.html)
贡献者：Dr. Qiusheng Wu (https://wetlands.io)
GitHub存储库： https://github.com/opengeos/whitebox-python
WhiteboxTools: https://github.com/jblindsay/whitebox-tools
用户手册： https://www.whiteboxgeo.com/manual/wbt_book/intro.html
conda-forge: https://anaconda.org/conda-forge/whitebox
免费软件： MIT许可证
内容
描述
whitebox Python包基于由Guelph大学John Lindsay教授（网页；jblindsay）开发的先进的地理空间数据分析平台WhiteboxTools。 WhiteboxTools可用于执行常见的地理信息系统（GIS）分析操作，例如成本距离分析、距离缓冲区和栅格重分类。遥感图像处理任务包括图像增强（例如，全色增强、对比度调整）、图像镶嵌、众多过滤操作、简单分类（k-均值）和常见的图像转换。WhiteboxTools还包含用于空间水文分析（例如，流量累积、流域划分、河流网络分析、汇点移除）的高级工具，地形分析（例如，常见的地形指数如坡度、曲率、湿度指数、阴影；高程分析；多尺度地形位置分析）和LiDAR数据处理。LiDAR点云可以进行查询（LidarInfo，LidarHistogram）、分割、拼接和合并，分析异常值，插值到栅格（DEM，强度图像），并可以对地面点进行分类或过滤。WhiteboxTools不是一个制图或空间数据可视化包；相反，它旨在作为其他数据可视化软件（主要是GIS）的分析后端。
安装
whitebox支持多种平台，包括Microsoft Windows、macOS和Linux操作系统。请注意，您需要安装Python 3.x。Python 2.x不受支持。可以使用以下命令安装whitebox Python包：
pip install whitebox如果您之前已安装whitebox Python包并希望升级到最新版本，可以使用以下命令：
pip install whitebox -U建议您使用Python虚拟环境（例如，conda）来测试whitebox包。如需安装conda，请遵循conda用户指南。安装conda后，您可以使用终端或Anaconda提示符创建Python虚拟环境。更多信息请参阅管理Python环境。
conda create -n wbt python
source activate wbt
conda install whitebox -c conda-forge如果在安装whitebox包时遇到GLIBC错误，您可以尝试以下命令：
import whitebox
whitebox.download_wbt(linux_musl=True, reset=True)或者，您可以在安装whitebox包之前设置环境变量WBT_LINUX为MUSL。它将自动下载WhiteboxTools的MUSL版本。
import os
os.environ["WBT_LINUX"] = "MUSL"whitebox 教程
现在直接使用mybinder.org启动whitebox教程笔记本。
快速示例
whitebox Python包中的工具名称可以使用snake_case或CamelCase约定来调用（例如，lidar_info或LidarInfo）。以下是一个示例Python脚本（example.py）。如果您对使用WhiteboxTools命令行程序感兴趣，请参阅WhiteboxTools 使用方法。
import os
import pkg_resources
import whitebox
wbt = whitebox.WhiteboxTools()
print(wbt.version())
print(wbt.help())
# identify the sample data directory of the package
data_dir = os.path.dirname(pkg_resources.resource_filename("whitebox", 'testdata/'))
wbt.set_working_dir(data_dir)
wbt.verbose = False
wbt.feature_preserving_smoothing("DEM.tif", "smoothed.tif", filter=9)
wbt.breach_depressions("smoothed.tif", "breached.tif")
wbt.d_inf_flow_accumulation("breached.tif", "flow_accum.tif")whitebox教程笔记本
此教程可以通过以下三种方式访问：
在云上以交互式Jupyter笔记本启动此教程 - https://gishub.org/whitebox-cloud。
whitebox GUI
WhiteboxTools还提供了一个图形用户界面（GUI） - WhiteboxTools Runner，可以使用以下Python脚本来调用：
import whitebox
whitebox.Runner()
故障排除
Linux
当使用 import whitebox 时，如果您遇到显示“No module named '_tkinter', please install the python3-tk package”的错误，您可以尝试以下解决方案
对于 Ubuntu、Linux Mint 等： sudo apt-get install python3-tk
对于 Manjaro、Arch Linux： sudo pacman -S tk
可用工具
该库目前包含 518 个工具，这些工具根据其主要功能分为以下类别：数据工具、GIS 分析、水文分析、图像分析、激光雷达分析、数学和统计分析、河流网络分析和地形分析。有关可用的工具列表，包括文档和使用细节，请参阅 WhiteboxTools 用户手册。
支持的数据格式
WhiteboxTools 库目前支持在 Whitebox GAT、GeoTIFF、ESRI (ArcGIS) ASCII 和二进制 (.flt & .hdr)、GRASS GIS、Idrisi、SAGA GIS（二进制和 ASCII）和 Surfer 7 数据格式中读写栅格数据。目前，WhiteboxTools 读取矢量地理数据的能力有限。库内很快将增强对 Shapefile（以及其他常见矢量格式）的支持。
贡献
如果您想作为开发者参与项目，请按照以下说明开始
克隆 whitebox 项目（https://github.com/opengeos/whitebox-python）
创建您的特性分支（git checkout -b my-new-feature）
提交您的更改（git commit -am ‘Add some feature’）
将更改推送到分支（git push origin my-new-feature）
创建新的 Pull Request
许可证
whitebox 包是在 MIT 许可证 下分发的，这是一个宽松的开源（免费软件）许可证。
报告错误
在 https://github.com/opengeos/whitebox-python/issues 报告错误。
如果您正在报告错误，请包括
您的操作系统名称和版本。
任何可能有助于故障排除的本地设置详细信息。
重现错误的详细步骤。
致谢
此包是用 Cookiecutter 和 audreyr/cookiecutter-pypackage 项目模板创建的。
历史
0.2.0 (2018-06-08)
0.1.0 (2018-06-06)
首次发布在 PyPI。
下载文件
下载适合您平台的项目文件。如果您不确定该选择哪一个，请了解有关 安装包 的更多信息。
源分布
构建分发
whitebox-2.3.5.tar.gz 的哈希值
| 算法 | 哈希摘要 | |
|---|---|---|
| SHA256 | 4a9fb6da799dc0f99daf139d6dbe573ca12af3785c48708e56728b8372c6a2a7 |
|
| MD5 | b3ee1583d7cbc757e0b117f439e140b8 |
|
| BLAKE2b-256 | dfed84ff85589a53bb61fa6f0f96a659ef20fbada1fcd6d1bb3c48dcbc24bb40 |
whitebox-2.3.5-py2.py3-none-any.whl 的哈希值
| 算法 | 哈希摘要 | |
|---|---|---|
| SHA256 | dd9db85bbb687356741afe935dd25286a2b31e7bf87b74c60b655cdf84a9d922 |
|
| MD5 | 51bf3493405b35b0f66005d978f441be |
|
| BLAKE2b-256 | a85fb3734743c856c5f616e92e74e612b727eb0465d7f8726b7d44e8734179aa |
