VirtuGhan QGIS Plugin

A QGIS plugin that integrates VirtuGhan capabilities directly into QGIS for remote sensing workflows.

Features

• Tiler: Real-time satellite tile visualization with custom band combinations
• Engine: Process and analyze satellite imagery with spectral indices
• Extractor: Bulk download and stack satellite data

Quick Start

Environment Management

This project uses uv for Python dependency and environment management. You must install uv before setting up the project.

Install uv first: Follow the installation guide at: https://docs.astral.sh/uv/getting-started/installation/

Prerequisites

• QGIS 3.22 or higher
• Python 3.10+
• uv (for dependency management)

Installation

1. Clone the repository:

git clone https://github.com/virtughan/qgis-plugin.git
cd qgis-plugin

2. Set up development environment with uv:

uv sync

3. Build the plugin:

./build.sh

4. Install in QGIS:
   • Go to Plugins > Manage and Install Plugins > Install from ZIP
   • Select dist/virtughan-qgis-plugin.zip

Development

Environment Setup

uv sync --group dev
source .venv/bin/activate

Version Management

This project uses Commitizen for version management:

cz bump
cz changelog

Building

./build.sh

The build script:

• Generates metadata.txt from pyproject.toml
• Creates a clean plugin package
• Outputs dist/virtughan-qgis-plugin.zip

Links

• Live Demo
• VirtuGhan Package
• Documentation

License

GPL-3.0