Using the Python ScriptRunner plugin

The QGIS Python ScriptRunner plugin provides a middle ground for QGIS automation, between the interactive console and the overhead of plugins. It provides a script management dialog that allows you to easily load, create, edit, and run scripts for large-scale QGIS automation.

Getting ready

Install the ScriptRunner plugin using the QGIS plugin manager. Then, run the plugin from the Plugin menu to open the ScriptRunner dialog. Configure a default editor to edit scripts using the following steps:

Find the gear icon that represents the ScriptRunner Preferences settings dialog box and click on it.
In the General Options section, check the Edit Scripts Using: checkbox.
Click on the … button to browse to the location of a text editor on your system.
Click on the Open button.
Click on the OK button in the Preferences dialog.

How to do it…

In the ScriptRunner dialog, click on the New Script icon, as shown in the following screenshot:
Browse to the directory where you can save your script, name the script, and save it.
Verify that the new script is loaded in ScriptRunner.
Right-click (or control-click on a Mac) on the script name in ScriptRunner and select Edit Script in External Editor.

In the editor, replace the template code with the following code:

from PyQt4.QtCore import *
from PyQt4.QtGui import *
from qgis.core import *
from qgis.gui import *

def run_script(iface):
    layer =  QgsVectorLayer('Polygon?crs=epsg:4326', 'Mississippi' , "memory")
pr = layer.dataProvider()
    poly = QgsFeature()
    geom = QgsGeometry.fromWkt("POLYGON ((-88.82 34.99,-88.09 34.89,-88.39 30.34,-89.57 30.18,-89.73 31,-91.63 30.99,-90.87 32.37,-91.23 33.44,-90.93 34.23,-90.30 34.99,-88.82 34.99))")
    poly.setGeometry(geom)
    pr.addFeatures([poly])
    layer.updateExtents()
QgsMapLayerRegistry.instance().addMapLayers([layer])

Click on the Run Script icon, which is represented by a green-colored arrow.
Close the ScriptRunner plugin.
Verify that the memory layer polygon was added to the QGIS map, as shown in the following screenshot:

How it works…

ScriptRunner is a simple but powerful idea. It allows you to build a library of automation scripts and use them from within QGIS, but without the overhead of building a plugin or a standalone application. All the Python and system path variables are set correctly and inherited from QGIS; however, you must still import the QGIS and Qt libraries.

Tech Concepts

Programming languages

Tech Tools

Unlimited access to the largest independent learning library in tech of over 8,000 expert-authored tech books and videos.

Innovative learning tools, including AI book assistants, code context explainers, and text-to-speech.

50+ new titles added per month and exclusive early access to books as they are being written.

QGIS Python Programming Cookbook

By : Joel Lawhead

QGIS Python Programming Cookbook

By: Joel Lawhead

Overview of this book

Using the Python ScriptRunner plugin

Getting ready

How to do it…

How it works…

QGIS Python Programming Cookbook

By : Joel Lawhead

QGIS Python Programming Cookbook

By: Joel Lawhead

Overview of this book

Using the Python ScriptRunner plugin

Getting ready

How to do it…

How it works…

Confirmation

Buy this book with your credits?

Submit Your Feedback

Create a Free Account To Continue Reading

Sign in to activate your 7-day free access