Skip to main content

A package for calculating surface roughness using GeoTIFF DEM files with a GUI and CLI

Project description

GeoRoughness_Banner_dark.png GeoRoughness_Banner_light.png

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.

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 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. 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:

python3 --version
pip3 --version

3. Install GeoRoughness Tool

Install the package via pip:

pip3 install geo-roughness-tool

Usage

To launch the Application, simply run the following command in your terminal after installation:

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.


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 section of this repository.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

geo_roughness_tool-0.4.31.post1.tar.gz (937.1 kB view details)

Uploaded Source

Built Distribution

geo_roughness_tool-0.4.31.post1-py3-none-any.whl (651.8 kB view details)

Uploaded Python 3

File details

Details for the file geo_roughness_tool-0.4.31.post1.tar.gz.

File metadata

File hashes

Hashes for geo_roughness_tool-0.4.31.post1.tar.gz
Algorithm Hash digest
SHA256 9c2d1450773a04e6071ea433a1da5c9494c8660c730b941e3bf8731619d8a4d6
MD5 03698be68ab0155db54c36c11c3e1fcf
BLAKE2b-256 afbba8c86210bd55e1768b6be54e21f4456ab792208ee9b3715928ab437ddbff

See more details on using hashes here.

File details

Details for the file geo_roughness_tool-0.4.31.post1-py3-none-any.whl.

File metadata

File hashes

Hashes for geo_roughness_tool-0.4.31.post1-py3-none-any.whl
Algorithm Hash digest
SHA256 f95c07acbe8184b3b61928854deaed04987824e9f5aefb36217eeb694c0e1d57
MD5 05ce354c616e51d754531948f947d33c
BLAKE2b-256 8cd60ae9e0f2eb521c7bde14cfcb276f17ecb3f6877f25fdf81d93f7039ac8c6

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page