QGISで自動化！Pythonコンソールの使い方

はじめに

この記事では、QGISの「Pythonコンソール」機能について解説し、対話型コンソールとコードエディタを使ったPythonコードの実行方法を紹介します。動画でもご紹介していますので、詳しい操作方法などはぜひ動画をご覧ください。

この記事は、株式会社MIERUNEのホームページで掲載されていた「QGISブログ」の内容を改訂して掲載したものです。

Pythonコンソールとは

QGISのプラグイン開発等で使われるPythonを、対話型コンソールとコードエディタから実行できる機能です。プラグインを開発する規模ではない自動化や、Python用の QGIS API**「PyQGIS」の挙動を確認する時などに有用**です。

対話型コンソールの使い方

ではまず初めに、Pythonコンソールを開いてみましょう。メニューバーより、「プラグイン」→「Pythonコンソール」の順でクリックします。

すると、QGISの画面の下部にPythonコンソールのパネルが表示されます。

入力領域（7のエリア）にPythonコマンドを入力すると、出力領域（8のエリア）に結果が出力されCUIのように対話的にコマンドが実行できます。出力が増え、可読性が低下した場合は出力領域のクリア（1のボタン）が可能です。また、コンソールは「オプション」からテーマを変更して見た目を変えることもできます。

各機能の説明は、以下の表のとおりです。

エディタの使い方

エディタではPythonスクリプトを実装して、実行や保存することができます。 QGISプラグイン開発においても実装予定の処理を試したい場合にも役に立ちます。特に、エディタとコンソールのスコープは同一のため、エディタで実装した関数の引数を変えて対話的に検証することも可能です。

各機能の説明は、以下の表のとおりです。

Pythonのサンプルコード

では、ここからPythonを使って簡単なレイヤの操作を行ってみます。使用するデータは、国土数値情報の湖沼データです。ダウンロードしてQGISに追加しましょう。

追加した湖沼レイヤに対して、レイヤのフィーチャー数と、式で選択したフィーチャーにフォーカスしてみます。下記のコードをエディタに入力して「実行」をクリックします。

#レイヤ名を指定して湖沼レイヤを取得
layer = QgsProject.instance().mapLayersByName('W09-05-g_Lake')[0]
#フィーチャーの数を出力
print(layer.featureCount())
#W09_001フィールドの値がさっぽろ湖を選択
layer.selectByExpression('"W09_001"=\'さっぽろ湖\'')
#選択したフィーチャーの１番目を変数に格納
selected_feature = layer.selectedFeatures()[0]
#キャンバスを変数に格納
canvas = iface.mapCanvas()
#選択したフィーチャーにフォーカス
canvas.setExtent(selected_feature.geometry().boundingBox())
#キャンバスの描画を更新
canvas.refresh()

すると、マップキャンバスでは「さっぽろ湖」にフォーカスされ、出力領域には湖沼レイヤの地物数として「556」が出力されていることがわかります。

おわりに

今回はPythonコンソールの操作方法について簡単に解説しました。簡単にコードの実行が可能でレイヤやキャンバスなどの操作できるため、非常に有用でお勧めしたい機能でした。ぜひ使ってみてください。