QGIS Python Programming Cookbook, Second Edition

QGIS Python Programming Cookbook, Second Edition - Second Edition

By : Joel Lawhead

Buy this Book

QGIS Python Programming Cookbook, Second Edition - Second Edition

By: Joel Lawhead

Buy this Book

Overview of this book

QGIS is a desktop geographic information system that facilitates data viewing, editing, and analysis. Paired with the most efficient scripting language—Python, we can write effective scripts that extend the core functionality of QGIS. Based on version QGIS 2.18, this book will teach you how to write Python code that works with spatial data to automate geoprocessing tasks in QGIS. It will cover topics such as querying and editing vector data and using raster data. You will also learn to create, edit, and optimize a vector layer for faster queries, reproject a vector layer, reduce the number of vertices in a vector layer without losing critical data, and convert a raster to a vector. Following this, you will work through recipes that will help you compose static maps, create heavily customized maps, and add specialized labels and annotations. As well as this, we’ll also share a few tips and tricks based on different aspects of QGIS.

QGIS Python Programming Cookbook - Second Edition

Credits

About the Author

About the Reviewer

www.PacktPub.com

Customer Feedback

Preface

Free Chapter

Automating QGIS

Introduction

Installing QGIS 2.18 for development

Using the QGIS Python console for interactive control

Automatically starting the Python console

Using the Python's Script Runner plugin

Setting up your QGIS IDE

Debugging QGIS Python scripts

Navigating the PyQGIS API

Creating a traditional QGIS plugin

Creating a Processing Toolbox plugin

Distributing a plugin

Building a standalone application

Storing and reading global preferences

Storing and reading project preferences

Accessing the script path from within your script

Querying Vector Data

Introduction

Loading a vector layer from a file sample

Loading a vector layer from a geodatabase

Examining vector layer features

Examining vector layer attributes

Filtering a layer by geometry

Filtering a layer by attributes

Buffering a feature

Measuring the distance between two points

Measuring distance along a line

Calculating the area of a polygon

Creating a spatial index

Calculating the bearing of a line

Loading data from a spreadsheet

Accessing layer metadata

Editing Vector Data

Introduction

Creating a vector layer in memory

Adding a point feature to a vector layer

Adding a line feature to a vector layer

Adding a polygon feature to a vector layer

Adding a set of attributes to a vector layer

Adding a field to a vector layer

Joining a shapefile attribute table to a CSV file

Changing vector layer geometry

Changing a vector layer feature's attribute

Removing data from a vector layer

Deleting a vector layer feature's attribute

Reprojecting a vector layer

Converting a shapefile to KML or GeoJSON

Merging shapefiles

Splitting a shapefile

Generalizing a vector layer

Dissolving vector features

Performing a union on vector shapes

Rasterizing a vector layer

Exporting a layer to the GeoPackage format

Using Raster Data

Introduction

Loading a raster layer

Loading a NetCDF file

Getting the cell size of a raster layer

Obtaining the width and height of a raster

Counting raster bands

Swapping raster bands

Querying the value of a raster at a specified point

Reprojecting a raster

Creating an elevation hillshade

Creating vector contours from elevation data

Sampling a raster dataset using a regular grid

Adding elevation data to a line vertices using a digital elevation model

Creating a common extent for rasters

Resampling raster resolution

Counting the unique values in a raster

Mosaicing rasters

Converting a TIFF image to a JPEG image

Creating pyramids for a raster

Converting a pixel location to a map coordinate

Converting a map coordinate to a pixel location

Creating a KML image overlay for a raster

Classifying a raster

Converting a raster to a vector

Georeferencing a raster from control points

Clipping a raster using a shapefile

Creating Dynamic Maps

Introduction

Accessing the map canvas

Changing the map units

Iterating over layers

Symbolizing a vector layer

Setting a transparent layer fill

Using a filled marker symbol

Rendering a single band raster using a color ramp algorithm

Setting a feature's color using a column in a CSV file

Creating a complex vector layer symbol

Using icons as vector layer symbols

Using an outline for font markers

Using arrow symbols

Creating a graduated vector layer symbol renderer

Creating a categorized vector layer symbol

Using live layer effects

Creating inverted polygon shapeburst fills

Creating a map bookmark

Navigating to a map bookmark

Setting scale-based visibility for a layer

Using SVG for layer symbols

Using pie charts for symbols

Using the 2.5D renderer

Using XYZ tiled map services

Using Esri ArcGIS map services

Labeling a feature

Using null symbols

Change map layer transparency

Adding standard map tools to the canvas

Using a map tool to draw points on the canvas

Using a map tool to draw polygons or lines on the canvas

Building a custom selection tool

Creating a mouse coordinate tracking tool

Composing Static Maps

Introduction

Creating the simplest map renderer

Using the Map Composer

Adding labels to a map for printing

Adding a scale bar to a map

Adding a North arrow to the map

Adding a logo to the map

Adding a vertical legend to the map

Adding a horizontal legend

Adding a custom shape to the map

Adding a grid to the map

Adding a table to the map

Adding a world file to a map image

Saving a map to a project

Loading a map from a project

Interacting with the User

Introduction

Using log files

Creating a simple message dialog

Creating a warning dialog

Creating an error dialog

Displaying a progress bar

Creating a simple text input dialog

Creating a file input dialog

Creating a combobox

Creating radio buttons

Creating checkboxes

Creating a dock widget

Displaying a message in the status bar

Pushing messages to the message bar

Pushing widgets to the message bar

Creating tabs

Stepping the user through a wizard

Keeping dialogs on top

QGIS Workflows

Introduction

Creating an NDVI

Geocoding addresses

Creating raster footprints

Performing network analysis

Routing along streets

Tracking a GPS

Creating a mapbook

Finding the least cost path

Performing nearest neighbor analysis

Creating a DEM from LIDAR

Creating a heat map

Creating a dot density map

Collecting field data

Computing road slope using elevation data

Geolocating photos on the map

Image change detection

Adjusting imprecise building footprints

Visualizing multitemporal data

Other Tips and Tricks

Introduction

Creating tiles from a QGIS map

Adding a layer to geojson.io

Rendering map layers based on rules

Creating a layer-definition file

Using NULL values in PyQGIS

Using generators for layer queries

Using alpha values to show data density

Using the __geo_interface__ protocol

Getting the output file names from processing algorithms

Generating points along a line

Using expression-based labels

Creating dynamic forms in QGIS

Calculating length for all selected lines

Using a different status bar CRS than the map

Creating HTML labels in QGIS

Using OpenStreetMap points of interest in QGIS

Changing the QGIS web proxy

Running QGIS scripts as scheduled tasks

Visualizing data in 3D with WebGL

Visualizing data on a globe

Make a globe-like azimuthal orthographic projection

Animating a layer

Customer Reviews

5 star

4 star

3 star

2 star

1 star

Distributing a plugin

Distributing a QGIS plugin means placing a collection of files on a server as a ZIP file, with a special configuration file, in order to allow the QGIS plugin manager to locate and install the plugin. The QGIS project has an official repository, but third-party repositories are also permitted. The official repository is very strict regarding how the plugin is uploaded, so, for this recipe, we'll set up a simple third-party repository for a sample plugin and test it with the QGIS plugin manager to avoid polluting the main QGIS repository with a test project. You should note that QGIS is released under the GNU General Public License (GPL), so presumably all other plugins fall under the GPL as well, based on the terms of the license.

Getting ready

In order to complete this recipe, you'll need a sample plugin and a web-accessible directory. You'll also need a ZIP tool, such as the free 7-zip program (http://www.7-zip.org/download.html). Both OSX and Windows can compress and decompress zip files natively. On Linux, you may need to download a ZIP tool from your package manager. You can use the MyPlugin example from the Creating a QGIS plugin recipe as the plugin to distribute. For a web directory, you can use a Google Code repository, GitHub repository, or other online directories you can access. Code repositories work well because they are a good place to store a plugin that you are developing.

How to do it...

In the following steps, we will package our plugin, create a server configuration file for it, and place it on a server to create a QGIS plugin repository:

First, zip up the plugin directory to create a .zip file.
Rename the .zip file to contain the plugin's version number:
```
Myplugin.0.1.0.zip
```
Upload this file to a publicly accessible web directory.
Upload the icon.png file from your plugin directory to the web directory.

Next, customize a plugins.xml metadata file for your plugin. Most of the data you need can be found in the metatdata.txt file in your plugin directory. The following example provides some guidance:

        <?xml version = '1.0' encoding = 'UTF-8'?> 
        <?xml-stylesheet type="text/xsl"href="" ?> 
        <plugins> 
          <pyqgis_plugin name="My Plugin" version="0.1.0" plugin_id="227"> 
            <description> 
              <![CDATA[Demonstration of a QGIS Plugin]]> 
            </description> 
            <about></about> 
            <version>0.1.0</version> 
            <qgis_minimum_version>1.8.0</qgis_minimum_version> 
            <qgis_maximum_version>2.9.9</qgis_maximum_version> 
            <homepage> 
              <![CDATA[https://github.com/GeospatialPython/Learn]]> 
            </homepage> 
            <file_name>MyPlugin.0.1.0.zip</file_name> 
            <icon>https://github.com/GeospatialPython/
            Learn/raw/master/icon_227.png</icon> 
            <author_name><![CDATA[Joel Lawhead]]></author_name> 
            <download_url>https://github.com/GeospatialPython/
            Learn/raw/master/MyPlugin.0.1.0.zip</download_url> 
            <uploaded_by><![CDATA[jll]]></uploaded_by> 
            <create_date>2016-11-19T15:31:19.824333</create_date> 
            <update_date>2016-11-19T15:31:19.824333</update_date> 
            <experimental>True</experimental> 
            <deprecated>False</deprecated> 
            <tracker> 
              <![CDATA[https://github.com/GeospatialPython/Learn/issues]]> 
            </tracker> 
            <repository> 
              <![CDATA[https://github.com/GeospatialPython/Learn/]]> 
            </repository> 
            <tags><![CDATA[development,debugging,tools]]></tags> 
            <downloads>0</downloads> 
            <average_vote>0</average_vote> 
            <rating_votes>0</rating_votes> 
          </pyqgis_plugin> 
        </plugins>

Upload the plugins.xml file to your web directory.
Now start QGIS and launch the plugins manager by going to the Plugins menu and selecting Manage and Install Plugins....
In the Settings tab of the Plugins | Settings dialog, scroll down and click on the Add... button.
Give the plugin a name and then add the complete URL to plugins.xml in the URL field.
Click on the OK button.
To make things easier, disable the other repositories by selecting the repository name, clicking on the Edit button, and unchecking the Enabled checkbox.
Click on the OK button
Click on the Not installed tab.
Your test plugin should be the only plugin listed, so select it from the list.
Click on the Install plugin button in the bottom-right corner of the window.
Click on the Close button.
Go to the Plugins menu and select your plugin to ensure that it works.

How it works...

The QGIS repository concept is simple and effective. The plugins.xml file contains a <download_url> tag that points to a ZIP file plugin on the same server or on a different server. The name attribute of the <pyqgis_plugin> tag is what appears in the QGIS plugin manager.

QGIS Python Programming Cookbook, Second Edition - Second Edition

By : Joel Lawhead

QGIS Python Programming Cookbook, Second Edition - Second Edition

By: Joel Lawhead

Overview of this book

Related Content you might be interested in

Current Title:

QGIS Python Programming Cookbook, Second Edition - Second Edition

Mastering Geospatial Development with QGIS 3.x

Learn QGIS

Learning Geospatial Analysis with Python

Distributing a plugin

Getting ready

How to do it...

How it works...