# This file contains metadata for your plugin.

# This file should be included when you package your plugin.# Mandatory items:

[general]
name=TopoDrain
qgisMinimumVersion=3.0
description=A QGIS plugin for planning surface drainage water management like Keyline-Design.
version=0.1.10
author=Timo Wicki
email=wickitimo@gmail.com
about=It automates the extraction of main valleys and ridges, creates off-contour line and supports creating Keyline Designs and other water-retention planning measures. The tool can also be used for other tasks, such as planning the location and alignment of paths and roads.
    DISCLAIMER: Influencing surface runoff on land is complex and requires significant expertise. This tool is intended as an aid for users with experience in land surface water management.
    
    DOCUMENTATION: Installation manual and tutorial guides are available on the project homepage: https://github.com/wickit7/topo-drain-plugin
    
    Core algorithms leverage WhiteboxTools (Lindsay, 2017–2020; see https://github.com/jblindsay/whitebox-tools).
    So make shure you have installed and configured the plugin "WhiteboxTools for QGIS"!
    - Installation video: https://www.youtube.com/watch?v=xJXDBsNbcTg
    
    This plugin requires several Python packages (numpy, shapely, pandas, geopandas, scipy).
    These packages are typically included in common newer QGIS distributions, but may be missing in some installations (especially custom builds). If a package is missing, follow the installation instructions below:
    - Windows, QGIS installed with OSGeo4W: https://landscapearchaeology.org/2018/installing-python-packages-in-qgis-3-for-windows/
    - macOS (terminal): https://gis.stackexchange.com/questions/351280/installing-python-modules-for-qgis-3-on-mac
    Take care to install compatible package versions.


tracker=https://github.com/wickit7/topo-drain-plugin/issues
repository=https://github.com/wickit7/topo-drain-plugin
# End of mandatory metadata

# Recommended items:

hasProcessingProvider=yes
# Uncomment the following line and add your changelog:

changelog=0.1.10 - Imporved crs handling
    * Improved CRS handling documentation for Windows compatibility
    * Bug fix crs windows: Implemented alternative for saving and loading geodataframe to file with crs because of PyProj access violation issue on windwos 
    0.1.9 - Windows compatibility release
    * Fixed Windows compatibility issues: console window flashing when WhiteboxTools executes
    * Enhanced GDAL virtual file system path detection (GPKG, HDF5, NETCDF)
    * Improved sys.stdout/sys.stderr handling for Windows QGIS environment
    0.1.8 - Documentation release
    * Added comprehensive Keyline Design, Constant Slope lines and Watershed delineation manual with step-by-step tutorial
    * Added installation guide in README with detailed setup instructions
    * Improved plugin documentation and user guidance
    * Fixed Constant Slope Lines and Adjust Constant Slope Lines algorithms (CRS attribute issue)
    0.1.7 - Stable release (mac os) candidate - Ready for user testing
    * Improved get keypoints algorithm performance and accuracy
    * Enhanced keyline creation with valley-to-valley and ridge-to-ridge tracing support
    * Code cleanup and refactoring for better maintainability
    * Removed experimental warning message - plugin is now stable and ready for testing


# Tags are comma separated with spaces allowed
tags=keyline-design, permaculture, sponge-scape, schwammland, surface analysis, watershed-analysis, topo-drain, water-management, whiteboxtools

homepage=https://github.com/wickit7/topo-drain-plugin
category=Analysis
icon=icons/topo_drain.svg
# experimental flag (keep True for initial public release)
experimental=True

# deprecated flag (applies to the whole plugin, not just a single version)
deprecated=False

# Since QGIS 3.8, a comma separated list of plugins to be installed
# (or upgraded) can be specified.
# Check the documentation for more information.
# The plugin name should match the exact folder name in QGIS plugins directory
#plugin_dependencies=plugin:wbt_for_qgis;python:numpy;python:pandas;python:geopandas;python:shapely;python:scipy

# If the plugin can run on QGIS Server.
server=False

