whiteboxgui


Namewhiteboxgui JSON
Version 2.3.0 PyPI version JSON
download
home_pagehttps://github.com/giswqs/whiteboxgui
SummaryAn interactive GUI for whitebox-tools in a Jupyter-based environment
upload_time2023-03-29 02:08:17
maintainer
docs_urlNone
authorQiusheng Wu
requires_python>=3.5
licenseMIT license
keywords whiteboxgui
VCS
bugtrack_url
requirements ipyfilechooser ipywidgets ipytree whitebox
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # whiteboxgui

[![image](https://img.shields.io/pypi/v/whiteboxgui.svg)](https://pypi.python.org/pypi/whiteboxgui)
[![image](https://img.shields.io/conda/vn/conda-forge/whiteboxgui.svg)](https://anaconda.org/conda-forge/whiteboxgui)
[![image](https://pepy.tech/badge/whiteboxgui)](https://pepy.tech/project/whiteboxgui)
[![image](https://colab.research.google.com/assets/colab-badge.svg)](https://githubtocolab.com/giswqs/whiteboxgui/blob/master/examples/examples.ipynb)
[![image](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/giswqs/whiteboxgui/master)
[![image](https://img.shields.io/twitter/follow/giswqs?style=social)](https://twitter.com/giswqs)

**An interactive GUI for WhiteboxTools in a Jupyter-based environment**

-   GitHub repo: <https://github.com/giswqs/whiteboxgui>
-   Documentation: <https://giswqs.github.io/whiteboxgui>
-   PyPI: <https://pypi.org/project/whiteboxgui>
-   conda-forge: <https://anaconda.org/conda-forge/whiteboxgui>
-   WhiteboxTools: <https://github.com/jblindsay/whitebox-tools>
-   User Manual: <https://www.whiteboxgeo.com/manual/wbt_book>
-   whitebox-python: <https://github.com/giswqs/whitebox-python>
-   whiteboxR: <https://github.com/giswqs/whiteboxR>
-   whitebox-ArcGIS: <https://github.com/giswqs/WhiteboxTools-ArcGIS>
-   Free software: MIT license

## Description

The whiteboxgui Python package is a Jupyter frontend for WhiteboxTools, an advanced geospatial data analysis platform developed by Prof. John Lindsay ([webpage](https://jblindsay.github.io/ghrg/index.html); [jblindsay](https://github.com/jblindsay)) at the University of Guelph's [Geomorphometry and Hydrogeomatics Research Group](https://jblindsay.github.io/ghrg/index.html). WhiteboxTools can be used to perform common geographical information systems (GIS) analysis operations, such as cost-distance analysis, distance buffering, and raster reclassification. Remote sensing and image processing tasks include image enhancement (e.g. panchromatic sharpening, contrast adjustments), image mosaicing, numerous filtering operations, simple classification (k-means), and common image transformations. WhiteboxTools also contains advanced tooling for spatial hydrological analysis (e.g. flow-accumulation, watershed delineation, stream network analysis, sink removal), terrain analysis (e.g. common terrain indices such as slope, curvatures, wetness index, hillshading; hypsometric analysis; multi-scale topographic position analysis), and LiDAR data processing. LiDAR point clouds can be interrogated (LidarInfo, LidarHistogram), segmented, tiled and joined, analyized for outliers, interpolated to rasters (DEMs, intensity images), and ground-points can be classified or filtered. WhiteboxTools is not a cartographic or spatial data visualization package; instead it is meant to serve as an analytical backend for other data visualization software, mainly GIS.

The WhiteboxTools currently contains **518** tools, which are each grouped based on their main function into one of the following categories: Data Tools, GIS Analysis, Hydrological Analysis, Image Analysis, LiDAR Analysis, Mathematical and Statistical Analysis, Stream Network Analysis, and Terrain Analysis. For a listing of available tools, complete with documentation and usage details, please see the [WhiteboxTools User Manual](https://www.whiteboxgeo.com/manual/wbt_book/available_tools/index.html).

## Installation

**whiteboxgui** is available on [PyPI](https://pypi.org/project/whiteboxgui). To install **whiteboxgui**, run this command in your terminal:

```
pip install whiteboxgui
```

**whiteboxgui** is also available on [conda-forge](https://anaconda.org/conda-forge/whiteboxgui). If you have
[Anaconda](https://www.anaconda.com/distribution/#download-section) or [Miniconda](https://docs.conda.io/en/latest/miniconda.html) installed on your computer, you can create a conda Python environment to install whiteboxgui:

    conda create -n wbt python
    conda activate wbt
    conda install mamba -c conda-forge
    mamba install whiteboxgui -c conda-forge

## Usage

The whiteboxgui provides a Graphical User Interface (GUI) for WhiteboxTools in a Jupyter-based environment, which can be invoked using the following Python script. You can also try [![image](https://colab.research.google.com/assets/colab-badge.svg)](https://githubtocolab.com/giswqs/whiteboxgui/blob/master/examples/examples.ipynb)

```
import whiteboxgui
whiteboxgui.show(tree=True)
```

![Imgur](https://i.imgur.com/z4Pm2Mt.png)

## Demo

![tutorial](https://i.imgur.com/girs2dr.gif)

## Credits

This package was created with [Cookiecutter](https://github.com/cookiecutter/cookiecutter) and the [giswqs/pypackage](https://github.com/giswqs/pypackage) project template.

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/giswqs/whiteboxgui",
    "name": "whiteboxgui",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.5",
    "maintainer_email": "",
    "keywords": "whiteboxgui",
    "author": "Qiusheng Wu",
    "author_email": "giswqs@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/25/90/c2ad2b8982618e6f86c363b3c3d8b13c2aa27929126c24e1d15bc213275d/whiteboxgui-2.3.0.tar.gz",
    "platform": null,
    "description": "# whiteboxgui\n\n[![image](https://img.shields.io/pypi/v/whiteboxgui.svg)](https://pypi.python.org/pypi/whiteboxgui)\n[![image](https://img.shields.io/conda/vn/conda-forge/whiteboxgui.svg)](https://anaconda.org/conda-forge/whiteboxgui)\n[![image](https://pepy.tech/badge/whiteboxgui)](https://pepy.tech/project/whiteboxgui)\n[![image](https://colab.research.google.com/assets/colab-badge.svg)](https://githubtocolab.com/giswqs/whiteboxgui/blob/master/examples/examples.ipynb)\n[![image](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/giswqs/whiteboxgui/master)\n[![image](https://img.shields.io/twitter/follow/giswqs?style=social)](https://twitter.com/giswqs)\n\n**An interactive GUI for WhiteboxTools in a Jupyter-based environment**\n\n-   GitHub repo: <https://github.com/giswqs/whiteboxgui>\n-   Documentation: <https://giswqs.github.io/whiteboxgui>\n-   PyPI: <https://pypi.org/project/whiteboxgui>\n-   conda-forge: <https://anaconda.org/conda-forge/whiteboxgui>\n-   WhiteboxTools: <https://github.com/jblindsay/whitebox-tools>\n-   User Manual: <https://www.whiteboxgeo.com/manual/wbt_book>\n-   whitebox-python: <https://github.com/giswqs/whitebox-python>\n-   whiteboxR: <https://github.com/giswqs/whiteboxR>\n-   whitebox-ArcGIS: <https://github.com/giswqs/WhiteboxTools-ArcGIS>\n-   Free software: MIT license\n\n## Description\n\nThe whiteboxgui Python package is a Jupyter frontend for WhiteboxTools, an advanced geospatial data analysis platform developed by Prof. John Lindsay ([webpage](https://jblindsay.github.io/ghrg/index.html); [jblindsay](https://github.com/jblindsay)) at the University of Guelph's [Geomorphometry and Hydrogeomatics Research Group](https://jblindsay.github.io/ghrg/index.html). WhiteboxTools can be used to perform common geographical information systems (GIS) analysis operations, such as cost-distance analysis, distance buffering, and raster reclassification. Remote sensing and image processing tasks include image enhancement (e.g. panchromatic sharpening, contrast adjustments), image mosaicing, numerous filtering operations, simple classification (k-means), and common image transformations. WhiteboxTools also contains advanced tooling for spatial hydrological analysis (e.g. flow-accumulation, watershed delineation, stream network analysis, sink removal), terrain analysis (e.g. common terrain indices such as slope, curvatures, wetness index, hillshading; hypsometric analysis; multi-scale topographic position analysis), and LiDAR data processing. LiDAR point clouds can be interrogated (LidarInfo, LidarHistogram), segmented, tiled and joined, analyized for outliers, interpolated to rasters (DEMs, intensity images), and ground-points can be classified or filtered. WhiteboxTools is not a cartographic or spatial data visualization package; instead it is meant to serve as an analytical backend for other data visualization software, mainly GIS.\n\nThe WhiteboxTools currently contains **518** tools, which are each grouped based on their main function into one of the following categories: Data Tools, GIS Analysis, Hydrological Analysis, Image Analysis, LiDAR Analysis, Mathematical and Statistical Analysis, Stream Network Analysis, and Terrain Analysis. For a listing of available tools, complete with documentation and usage details, please see the [WhiteboxTools User Manual](https://www.whiteboxgeo.com/manual/wbt_book/available_tools/index.html).\n\n## Installation\n\n**whiteboxgui** is available on [PyPI](https://pypi.org/project/whiteboxgui). To install **whiteboxgui**, run this command in your terminal:\n\n```\npip install whiteboxgui\n```\n\n**whiteboxgui** is also available on [conda-forge](https://anaconda.org/conda-forge/whiteboxgui). If you have\n[Anaconda](https://www.anaconda.com/distribution/#download-section) or [Miniconda](https://docs.conda.io/en/latest/miniconda.html) installed on your computer, you can create a conda Python environment to install whiteboxgui:\n\n    conda create -n wbt python\n    conda activate wbt\n    conda install mamba -c conda-forge\n    mamba install whiteboxgui -c conda-forge\n\n## Usage\n\nThe whiteboxgui provides a Graphical User Interface (GUI) for WhiteboxTools in a Jupyter-based environment, which can be invoked using the following Python script. You can also try [![image](https://colab.research.google.com/assets/colab-badge.svg)](https://githubtocolab.com/giswqs/whiteboxgui/blob/master/examples/examples.ipynb)\n\n```\nimport whiteboxgui\nwhiteboxgui.show(tree=True)\n```\n\n![Imgur](https://i.imgur.com/z4Pm2Mt.png)\n\n## Demo\n\n![tutorial](https://i.imgur.com/girs2dr.gif)\n\n## Credits\n\nThis package was created with [Cookiecutter](https://github.com/cookiecutter/cookiecutter) and the [giswqs/pypackage](https://github.com/giswqs/pypackage) project template.\n",
    "bugtrack_url": null,
    "license": "MIT license",
    "summary": "An interactive GUI for whitebox-tools in a Jupyter-based environment",
    "version": "2.3.0",
    "split_keywords": [
        "whiteboxgui"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "bff3320f1f5b67fceb23a5f3556d5d728d2fbcaaca0ce60cdb50a8715e0f8c19",
                "md5": "8ca80381f5a4d282943e4e3b806aca93",
                "sha256": "f226783efaba1af1cd55f98bba743da590bccf4dd6cbba519f6c879993b57631"
            },
            "downloads": -1,
            "filename": "whiteboxgui-2.3.0-py2.py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "8ca80381f5a4d282943e4e3b806aca93",
            "packagetype": "bdist_wheel",
            "python_version": "py2.py3",
            "requires_python": ">=3.5",
            "size": 108636,
            "upload_time": "2023-03-29T02:08:15",
            "upload_time_iso_8601": "2023-03-29T02:08:15.379673Z",
            "url": "https://files.pythonhosted.org/packages/bf/f3/320f1f5b67fceb23a5f3556d5d728d2fbcaaca0ce60cdb50a8715e0f8c19/whiteboxgui-2.3.0-py2.py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "2590c2ad2b8982618e6f86c363b3c3d8b13c2aa27929126c24e1d15bc213275d",
                "md5": "feb0080c7992c18ce7b0c89c52589523",
                "sha256": "c59dfccb244bc2d7b9ff77c63a81b77d0e1b4a6fc19476449e450e0da009a754"
            },
            "downloads": -1,
            "filename": "whiteboxgui-2.3.0.tar.gz",
            "has_sig": false,
            "md5_digest": "feb0080c7992c18ce7b0c89c52589523",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.5",
            "size": 108918,
            "upload_time": "2023-03-29T02:08:17",
            "upload_time_iso_8601": "2023-03-29T02:08:17.127974Z",
            "url": "https://files.pythonhosted.org/packages/25/90/c2ad2b8982618e6f86c363b3c3d8b13c2aa27929126c24e1d15bc213275d/whiteboxgui-2.3.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-03-29 02:08:17",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "github_user": "giswqs",
    "github_project": "whiteboxgui",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [
        {
            "name": "ipyfilechooser",
            "specs": []
        },
        {
            "name": "ipywidgets",
            "specs": []
        },
        {
            "name": "ipytree",
            "specs": []
        },
        {
            "name": "whitebox",
            "specs": []
        }
    ],
    "lcname": "whiteboxgui"
}
        
Elapsed time: 0.04765s