THIS PLUGIN VERSION IS BASED ON PYSAL >= 2.0 (previous version here)
A QGIS Plugin to perform Hotspot analysis based on the Python Spatial Analysis Library - PySAL. The Hotspot analysis plugin associates the Z-scores and p-values (under Complete Spatial Randomness hypothesis) of the Gi* local statistic (Getis and Ord, 1992; Getis and Ord, 1996), Anselin Local Moran's I (Anselin, 1995) and Local Moran Bivariate (Wartenberg, 1985; Anselin et al., 2002) for each feature of a shapefile, with an assigned projected coordinate system and (at least) an associated numerical attribute. Output layer allows to indentify spatial hot spots/cold spots) as well as clusters/outliers for the input vector spatial dataset.
For what it concerns Gi* local statistic, positive and statistically significant Z-score indicates a cluster of high values (hotspot). Negative and statistically significant Z-score indicates a cluster of low values (coldspot). With respect to the Local Moran's I (and its bivariate counterpart, the Local Moran Bivariate), Z-scores are translated into quadrant values (q) which depict the presence of clusters or outliers within the dataset. Significance is computed, based on user's choice, against normality assumption or using random permutations. Please consider the aforementioned litterature references for detailed information.
Spatial relationship between point features is modeled using a Fixed Distance Band (expressed with the same unit of measure of the projected coordinate system of the input point shapefile) or optionally using the K-nearest neighbours approach. For polygon shapefile analysis, the spatial relation is modelled using a 1st order queen's case contiguity matrix. For more information, please refer to Geospatial Analysis - 5th Edition, 2015 - de Smith, Goodchild, Longley
1) Install dependencies:
If you are using QGIS 3.18 or lower:
Open OSGeo4W Shell installed with QGIS as Administrator and type:
$ py3_env
$ python -m pip install --upgrade pip
$ python -m pip install pysal==2.1.0If you are using QGIS >= 3.20:
Open OSGeo4W Shell installed with QGIS as Administrator and type:
$ o4w_env
$ python3 -m pip install --upgrade pip
$ python3 -m pip install pysal==2.1.0 -U --user- A video tutorial for installation on Windows is available here
2) Open QGIS:
Go to Plugins -> Manage and Install plugins -> Settings -> Show also experimental plugins
In All plugins tab, look for Hotspot Analysis and tick the checkbox.
A new icon for Hotspot Analysis will appear on the QGIS main panel and in the Vector Menu.
3) If you are interested in the latest unreleased version:
Download the zip folder of the repository at: https://github.com/danioxoli/HotSpotAnalysis_Plugin/archive/refs/heads/qgis3pysal2.zip
Open QGIS 3 and go to Plugins -> Install from ZIP
Select the downloaded zip folder and press Install plugin. The icon for the Hotspot Analysis plugin will appear in the list of the installed plugins. Tick the Checkbox to activate it. The plugin will appear in the Vector menu.
Note: In case of errors rising from the Scipy package, open OSGeo4W Shell installed with QGIS3 as Administrator and type:
$ py3_env
$ python -m pip install scipy -U1) Install dependencies:
Open a Terminal and type the command:
$ apt-get install python3-pipOpen the QGIS Python Console and type the commands:
$ import pip
$ pip.main(['install', 'pysal==2.1.0'])2) Open QGIS 3:
Go to Plugins -> Manage and Install plugins -> Settings -> Show also experimental plugins
In All plugins tab, look for Hotspot Analysis and tick the Checkbox.
A new icon for Hotspot Analysis will appear on the QGIS main panel and in the Vector Menu.
3) If you are interested in the latest unreleased version:
Open a Terminal and change directory to QGIS Plugins directory, default is:
$ cd /usr/share/qgis/python/plugins Clone the GitHub repository into the earlier mentioned path:
$ sudo git clone -b qgis3pysal2 https://github.com/danioxoli/HotSpotAnalysis_PluginAlternatively
Download the zip folder of the repository at: https://github.com/danioxoli/HotSpotAnalysis_Plugin/archive/refs/heads/qgis3pysal2.zip
Open QGIS 3 and go to Plugins -> Install from ZIP
Select the downloaded zip folder and press Install plugin. The icon for the Hotspot Analysis plugin will appear in the list of the installed plugins. Tick the Checkbox to activate it. The plugin will appear in the Vector menu.
1) PySAL 2 may be included in the core libraries of the current LTR QGIS version, otherwise install the package pysal==2.0.0 using pip3 following these instructions: https://www.lutraconsulting.co.uk/blog/2020/10/01/qgis-macos-package
Note: If dependencies errors show up, check this workaround: #61
2) Open QGIS 3:
Go to Plugins -> Manage and Install plugins -> Settings -> Show also experimental plugins
In All plugins tab, look for Hotspot Analysis and tick the Checkbox.
A new icon for Hotspot Analysis will appear on the QGIS main panel and in the Vector Menu.
3) If you are interested in the latest unreleased version:
Download the zip of the repository folder: https://github.com/danioxoli/HotSpotAnalysis_Plugin/archive/refs/heads/qgis3pysal2.zip
Go to Plugins -> Install from ZIP
Select the downloaded zip folder and press Install plugin. The icon for the Hotspot Analysis plugin will appear in the list of the installed plugins. Tick the Checkbox to activate it. The plugin will appear in the Vector menu.
An user guide with demo exercises is included here: https://github.com/danioxoli/HotSpotAnalysis_Plugin/blob/master/test_data/Hotspot_Analysis_UserGuide.pdf
Plese cite this as:
Oxoli, D., Prestifilippo, G., Bertocchi, D., Zurbaràn, M. (2017). Enabling spatial autocorrelation mapping in QGIS: The Hotspot Analysis Plugin. GEAM. GEOINGEGNERIA AMBIENTALE E MINERARIA, 151(2), 45-50.
Latest presentation available here: http://www.slideshare.net/danieleoxoli/hotspot-analysis-with-qgis-foss4git-2017
Note: part of this material might be based on the old version of the plugin!
- Bug import fix for LTR 3.16
- Fix of PySAL functions import paths
- Port to PySAL 2
- Enhancement to Gi* computation with negative values
- Icon fixed
- Plugin translation to QGIS 3
- Enabled the use of k-nearest neighbor spatial weights matrix for point shapefiles
- Minor bugs fixed
- Enabled Anselin Local Moran's I and Bivariate Local Moran computation
- Minor bugs fixed
- The plugin has been officially published on the QGIS plugin repository
- Minor bugs fixed
- Enabled the use of negative numerical attributes Getis and Ord, 1996
- Enabled polygon shapefiles as input using queen's case contiguity spatial weight matrix.
- Enabled the possibility of selecting between normality assumption (default) and standard normal approximation from permutations to compute Gi* Z-scores and associated p-values.
New check botton to eneable the usage of row standardized spatial weights
With this new version, the output layer is displayed with an automatic style which enables hotspot and coldspot visualization. Moreover, a default Fixed Distance Band is dispalyed. This latter represents the minimum distance to ensure at least 1 neighbor to any element of the dataset in order to compute spatial weights for Gi*
The current version does not require Pyshp as well as to specify the feature coordinates as two separate fields in the attribute table of the input shapefile. Only the numerical attribute must be included and selected using the graphical interface on QGIS. Nevertheless, be sure that your input shapefile is projected. The unit of measure in which you express the analysis distance must agree with the one of the projected coordinate system of your input layer.
- Test on the new functionalities addedd
- improve GUI appereance
- Update User guide and documentation for Anselin Local Moran's I and Bivariate Local Moran computation
Bug tracker and Wiki
The Hotspot Analysis plugin is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation
Copyright © 2021 Daniele Oxoli - Politecnico Di Milano | Gabriele Prestifilippo - GISdevio
E-mail: daniele.oxoli@polimi.it