# GeoRoughness Tool
This is a spatial analysis tool for calculating surface roughness from Digital Elevation Models (DEMs). The tool
provides a comprehensive solution for geospatial analysis, allowing users to compute roughness values based on the
standard deviation of height within a specified window size. The tool allows for easy classification of roughness values
and generation of roughness maps for visualizing the terrain's variability.
## Features
- **Surface Roughness Calculation**: Compute roughness values based on the standard deviation of height.
- **Surface Roughness Mapping**: Generate roughness maps for visualizing the terrain's variability.
- **Surface Roughness Classification**: Categorize roughness values into different classes.
- **Classification Quality Metrics**: Evaluate the quality of the classification using accuracy metrics.
- **Classification Optimization**: Optimize the classification thresholds for better results.
---
## Documentation
For more detailed information about the tool's capabilities and additional configurations,
please refer to the [Project's Wiki](../../wiki).
## Installation Guide for GeoRoughness Tool
Follow these steps to install the GeoRoughness Tool on your system. The program is available
as a Python package and can therefore be installed on any major operating system.
> [!TIP]
> If you are not that experienced using command line tools or experience any problems during installation, please refer
> to the [Getting Started Wiki Page](../../wiki/Getting-Started) for a more detailed and OS specific installation guide.
### Prerequisites
Before you begin, ensure that your system meets the following requirements:
- **Python 3.12 or later**: The software is built to run with Python 3.12 and above.
- **pip**: Python's package installer, used to install the GeoRoughness Tool.
### Step-by-Step Installation
#### 1. Install Python
Ensure you have Python 3.12 or later installed on your computer:
- **Windows**: Download from the [official Python website](https://www.python.org/downloads/). Make sure to add Python to PATH during installation.
- **macOS**: Install using Homebrew with `brew install python@3.12`.
- **Linux**: Use your package manager, e.g., for Ubuntu: `sudo apt install python3.12 python3-pip`.
#### 2. Verify Installation
Check Python and pip installation:
```bash
python3 --version
pip3 --version
```
#### 3. Install GeoRoughness Tool
Install the package via pip:
```bash
pip3 install geo-roughness-tool
```
---
## Usage
To launch the Application, simply run the following command in your terminal after installation:
```bash
georough
```
---
### CLI Application
This package also provides a basic command line interface (CLI) for batch processing of DEM files. For more information
on how to use the CLI, please refer to the [CLI Documentation](../../wiki/Getting-Started#CLI-Application).
---
## AI-Assisted Development
> [!NOTE]
> This project leverages artificial intelligence, including OpenAI's GPT-4, GPT-4o and GitHub Copilot, to assist in generating parts of the code and documentation. These tools provide suggestions that enhance the development process and help in crafting more robust and comprehensive materials. While AI tools have been instrumental in accelerating development and improving productivity, the final decisions on the inclusion and modification of the generated content rest solely with the human developers. This ensures that each aspect of the project aligns with our quality standards and functional requirements.
>
> Please note that while AI has contributed to the project, it may not capture the full complexity or context of the development practices. As such, any anomalies or errors introduced by AI-generated content have been reviewed and rectified to the best of our capabilities. However, users should exercise their judgment and discretion when using or modifying this software.
>
> For any concerns or questions about the AI-generated content within this project, please feel free to contact us through the repository's issues section.
---
## Contributing
We welcome contributions! If you have suggestions or want to report bugs, please use the [Issues](../../issues) section of this repository.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
Raw data
{
"_id": null,
"home_page": "https://github.com/lbatschelet/GeoRoughness-Tool",
"name": "geo-roughness-tool",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": null,
"keywords": "GIS, GeoTIFF, DEM, surface roughness, geographic information systems",
"author": "Lukas Batschelet",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/af/bb/a8c86210bd55e1768b6be54e21f4456ab792208ee9b3715928ab437ddbff/geo_roughness_tool-0.4.31.post1.tar.gz",
"platform": null,
"description": "\n\n\n# GeoRoughness Tool\n\nThis is a spatial analysis tool for calculating surface roughness from Digital Elevation Models (DEMs). The tool \nprovides a comprehensive solution for geospatial analysis, allowing users to compute roughness values based on the\nstandard deviation of height within a specified window size. The tool allows for easy classification of roughness values\nand generation of roughness maps for visualizing the terrain's variability.\n\n## Features\n\n- **Surface Roughness Calculation**: Compute roughness values based on the standard deviation of height.\n- **Surface Roughness Mapping**: Generate roughness maps for visualizing the terrain's variability.\n- **Surface Roughness Classification**: Categorize roughness values into different classes.\n- **Classification Quality Metrics**: Evaluate the quality of the classification using accuracy metrics.\n- **Classification Optimization**: Optimize the classification thresholds for better results.\n\n---\n\n## Documentation\n\nFor more detailed information about the tool's capabilities and additional configurations, \nplease refer to the [Project's Wiki](../../wiki).\n\n## Installation Guide for GeoRoughness Tool\n\nFollow these steps to install the GeoRoughness Tool on your system. The program is available\nas a Python package and can therefore be installed on any major operating system.\n\n> [!TIP]\n> If you are not that experienced using command line tools or experience any problems during installation, please refer \n> to the [Getting Started Wiki Page](../../wiki/Getting-Started) for a more detailed and OS specific installation guide.\n\n### Prerequisites\n\nBefore you begin, ensure that your system meets the following requirements:\n- **Python 3.12 or later**: The software is built to run with Python 3.12 and above.\n- **pip**: Python's package installer, used to install the GeoRoughness Tool.\n\n### Step-by-Step Installation\n\n#### 1. Install Python\nEnsure you have Python 3.12 or later installed on your computer:\n- **Windows**: Download from the [official Python website](https://www.python.org/downloads/). Make sure to add Python to PATH during installation.\n- **macOS**: Install using Homebrew with `brew install python@3.12`.\n- **Linux**: Use your package manager, e.g., for Ubuntu: `sudo apt install python3.12 python3-pip`.\n\n#### 2. Verify Installation\nCheck Python and pip installation:\n```bash\npython3 --version\npip3 --version\n```\n\n#### 3. Install GeoRoughness Tool\nInstall the package via pip:\n```bash\npip3 install geo-roughness-tool\n```\n\n---\n\n## Usage\n\nTo launch the Application, simply run the following command in your terminal after installation:\n\n```bash\ngeorough\n```\n\n---\n\n### CLI Application\n\nThis package also provides a basic command line interface (CLI) for batch processing of DEM files. For more information \non how to use the CLI, please refer to the [CLI Documentation](../../wiki/Getting-Started#CLI-Application).\n\n---\n\n## AI-Assisted Development\n\n> [!NOTE]\n> This project leverages artificial intelligence, including OpenAI's GPT-4, GPT-4o and GitHub Copilot, to assist in generating parts of the code and documentation. These tools provide suggestions that enhance the development process and help in crafting more robust and comprehensive materials. While AI tools have been instrumental in accelerating development and improving productivity, the final decisions on the inclusion and modification of the generated content rest solely with the human developers. This ensures that each aspect of the project aligns with our quality standards and functional requirements. \n> \n> Please note that while AI has contributed to the project, it may not capture the full complexity or context of the development practices. As such, any anomalies or errors introduced by AI-generated content have been reviewed and rectified to the best of our capabilities. However, users should exercise their judgment and discretion when using or modifying this software. \n> \n> For any concerns or questions about the AI-generated content within this project, please feel free to contact us through the repository's issues section.\n\n---\n\n## Contributing\n\nWe welcome contributions! If you have suggestions or want to report bugs, please use the [Issues](../../issues) section of this repository.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A package for calculating surface roughness using GeoTIFF DEM files with a GUI and CLI",
"version": "0.4.31.post1",
"project_urls": {
"Documentation": "https://github.com/lbatschelet/GeoRoughness-Tool/wiki",
"Homepage": "https://github.com/lbatschelet/GeoRoughness-Tool",
"Source": "https://github.com/lbatschelet/GeoRoughness-Tool",
"Tracker": "https://github.com/lbatschelet/GeoRoughness-Tool/issues"
},
"split_keywords": [
"gis",
" geotiff",
" dem",
" surface roughness",
" geographic information systems"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8cd60ae9e0f2eb521c7bde14cfcb276f17ecb3f6877f25fdf81d93f7039ac8c6",
"md5": "05ce354c616e51d754531948f947d33c",
"sha256": "f95c07acbe8184b3b61928854deaed04987824e9f5aefb36217eeb694c0e1d57"
},
"downloads": -1,
"filename": "geo_roughness_tool-0.4.31.post1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "05ce354c616e51d754531948f947d33c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 651835,
"upload_time": "2024-05-24T12:22:16",
"upload_time_iso_8601": "2024-05-24T12:22:16.392775Z",
"url": "https://files.pythonhosted.org/packages/8c/d6/0ae9e0f2eb521c7bde14cfcb276f17ecb3f6877f25fdf81d93f7039ac8c6/geo_roughness_tool-0.4.31.post1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "afbba8c86210bd55e1768b6be54e21f4456ab792208ee9b3715928ab437ddbff",
"md5": "03698be68ab0155db54c36c11c3e1fcf",
"sha256": "9c2d1450773a04e6071ea433a1da5c9494c8660c730b941e3bf8731619d8a4d6"
},
"downloads": -1,
"filename": "geo_roughness_tool-0.4.31.post1.tar.gz",
"has_sig": false,
"md5_digest": "03698be68ab0155db54c36c11c3e1fcf",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 937098,
"upload_time": "2024-05-24T12:22:18",
"upload_time_iso_8601": "2024-05-24T12:22:18.190599Z",
"url": "https://files.pythonhosted.org/packages/af/bb/a8c86210bd55e1768b6be54e21f4456ab792208ee9b3715928ab437ddbff/geo_roughness_tool-0.4.31.post1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-24 12:22:18",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "lbatschelet",
"github_project": "GeoRoughness-Tool",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "customtkinter",
"specs": [
[
"==",
"5.2.2"
]
]
},
{
"name": "matplotlib",
"specs": [
[
"==",
"3.8.4"
]
]
},
{
"name": "numpy",
"specs": [
[
"==",
"1.26.4"
]
]
},
{
"name": "Pillow",
"specs": [
[
"==",
"10.3.0"
]
]
},
{
"name": "rasterio",
"specs": [
[
"==",
"1.3.10"
]
]
},
{
"name": "screeninfo",
"specs": [
[
"==",
"0.8.1"
]
]
},
{
"name": "setuptools",
"specs": [
[
"==",
"69.5.1"
]
]
},
{
"name": "requests",
"specs": [
[
"==",
"2.32.2"
]
]
},
{
"name": "packaging",
"specs": [
[
"==",
"24.0"
]
]
},
{
"name": "wheel",
"specs": [
[
"==",
"0.43.0"
]
]
},
{
"name": "twine",
"specs": [
[
"==",
"5.1.0"
]
]
},
{
"name": "setuptools-scm",
"specs": [
[
"==",
"8.1.0"
]
]
}
],
"lcname": "geo-roughness-tool"
}
JSON
