Skip to content

About

Geoalert's public QGIS plugin for using Mapflow from inside QGIS.

Topics

Resources

Contributing

Stars

35 stars

Watchers

4 watching

Forks

Repository files navigation

Get maps from pixels with Mapflow by Geoalert

At Geoalert, we employ Artificial Intelligence (AI) and Machine Learning (ML) to detect and extract real-world objects a.k.a. 'features' from satellite or aerial imagery.

You choose what type of features you want to extract, where and from which imagery, and Mapflow will do the work for you.

Currently we can detect:

  • building footprints (optionally, with height)
  • forest (optionally, with height)
  • construction sites
  • roads

More info about our AI models can be found here.

Mapflow supports various imagery sources types. You can upload your local GeoTIFF image, or use one of the tile services on the Web. By default, we use Mapbox Satellite, but you can specify a link to another imagery in XYZ, WMS, etc. You can also search the Mapflow imagery catalog and process a specific image.

Geoalert Mapflow plugin for QGIS

Installation

The plugin can be found in the official QGIS plugin repository and can be installed by going to Plugins -> Manage and Install Plugins in QGIS, and then searching for 'Mapflow'. Make sure the 'all' tab is activated.

Use

To learn how to use the plugin, please, follow our guide.

Contributing

Running tests

Automated tests run inside the official qgis/qgis:release-3_28 Docker image — no host QGIS install needed, only Docker.

make test-functional   # pure-logic tests
make test-qgis         # tests that touch real QGIS objects
make test-ui           # UI tests under xvfb (harness only — no tests yet)
make test              # all three tiers

Test layout, fixtures, and the policy for adding a test live in tests/README.md.

Linting

Static analysis runs on the host (not in Docker) via the project venv:

pip install ruff pyright   # once, into the venv
make lint                  # ruff check + pyright

ruff (config in pyproject.toml) catches unused code and real-bug patterns; pyright (config in pyrightconfig.json) adds flow analysis ruff can't do, such as use-before-assignment and undefined names. Pyright's type-completeness checks are muted until the codebase is annotated. The rule set starts intentionally narrow — broaden it once the baseline is clean.

Coverage scope. CI is pinned to Linux + QGIS 3.28 LTR. The qgis/qgis Docker image is Linux-only and we do not run a CI matrix across operating systems or QGIS versions. Verify macOS, Windows, and non-LTR QGIS versions by manual smoke testing before release.

License

This software is released under the GNU Public License (GPL) Version 2 or any later version. This license means that you can inspect and modify the source code and guarantees that you always have access to this software under the same termas as QGIS, that is free of cost and can be freely modified.

About

Geoalert's public QGIS plugin for using Mapflow from inside QGIS.

Topics

Resources

Contributing

Stars

35 stars

Watchers

4 watching

Forks

Releases

Packages

Used by

Contributors

Languages