Skip to content

NickySpatial

An open-source object-based image analysis library for remote sensing.

Category Badge
Build uv hatchling pre-commit.ci status
Code Quality Ruff pre-commit Tests Coverage
Documentation MkDocs Read DeepWiki
Package Info Python PyPI version Dependencies License
Community GitHub Stars Issues Downloads Last Commit

[!WARNING] This project is under active development and lot of its functionality is still in my head yet to code.

Find Demo Frontend Here : https://nickyspatial-gpoqz.ondigitalocean.app/

Description

NickySpatial is a Python package that provides object-based image analysis (OBIA) functionality similar to commercial software like eCognition. It allows users to segment geospatial imagery into meaningful objects, calculate statistics, and apply rule-based classification.

Project Structure

nickyspatial/
├── __init__.py
├── io/
   ├── __init__.py
   ├── raster.py       # Raster I/O
   └── vector.py       # Vector I/O
├── core/
   ├── __init__.py
   ├── layer.py        # Layer class and management
   ├── segmentation.py # Segmentation algorithms
   └── rules.py        # Rule engine
|   └── classifier.py   # Classification algorithms
├── stats/
   ├── __init__.py
   ├── basic.py        # Basic statistics (min, max, mean, etc.)
   ├── spatial.py      # Spatial statistics (area, perimeter, etc.)
   └── spectral.py     # Spectral indices (NDVI, etc.)
├── filters/
   ├── __init__.py
   ├── spatial.py      # Spatial filters (smoothing, merging)
   └── spectral.py     # Spectral filters (band math)
├── viz/
   ├── __init__.py
   ├── maps.py         # Map visualization
   └── charts.py       # Statistical charts
└── utils/
    ├── __init__.py
    └── helpers.py      # Helper functions

Installation

pip install nickyspatial

Quick Start

import nickyspatial as ns
 TODO : add sample computation here

Documentation

For detailed documentation and examples, see the documentation website. Deepwiki also provides documentation quite detailed , Do check it out if you like

Examples

Check out the 'examples' directory for more examples:

TODO : Add example scripts here

Contributing

Contributions are welcome! Follow dev setup guide & Please feel free to submit a Pull Request.

Acknowledgments

  • Inspired by the functionality of eCognition and other OBIA methodologies
  • Built on top of powerful open-source libraries like numpy, rasterio, scikit-image, and GeoPandas
  • Nicky : Nicky is my belated dog and I named this package in his memory!

    Nicky the dog

Contributors

Contributors