2018-08-08

QGIS3に付属のPython等を使えるようにするためのパス設定

環境変数Pathを設定する
Pythonプログラミング
Plugin開発がしたい

このページでは、QGISに付属しているPythonやコマンドを使えるようにするための設定方法を紹介しています。コマンドが使えるようになると、ファイル形式の変換(例:shp→mif)や等高線作成等のちょっとした作業をバッチ処理できたり何かと便利なのでおすすめです。このページでは、QGIS3.6を使用しています。

環境変数Pathを設定する

PythonやGDALやOGR等のコマンドを使うために環境変数を設定します。環境変数の設定については、こちらのページがとても参考になりました。

【PowerShell】環境変数を設定する | ほそぼそプログラミング日記

PowerShellを起動する

f:id:Chiakikun:20180901140429p:plain

PowerShellを起動します。検索窓？（下の赤丸部分）に『powershell』と入力すると、いくつか候補が出てくるので上の赤丸部分のPowerShellを選択します。

設定のためのコード

下記のコードをコピーします。

    $oldSystemPath = [System.Environment]::GetEnvironmentVariable("Path", "User")
    $oldSystemPath += ";C:\Program Files\QGIS 3.6\apps\qgis\bin"
    $oldSystemPath += ";C:\Program Files\QGIS 3.6\apps\Python37"
    $oldSystemPath += ";C:\Program Files\QGIS 3.6\apps\Python37\Scripts"
    $oldSystemPath += ";C:\Program Files\QGIS 3.6\apps\Qt5\bin"
    $oldSystemPath += ";C:\Program Files\QGIS 3.6\bin"
    [System.Environment]::SetEnvironmentVariable("Path", $oldSystemPath, "User")
    [System.Environment]::SetEnvironmentVariable("QT_QPA_PLATFORM_PLUGIN_PATH", "C:\Program Files\QGIS 3.6\apps\qt5\plugins", "User")

PowerShellにコードを貼り付ける

f:id:Chiakikun:20190428234517p:plain

コピーしたコードを張り付けて、PowerShellを一度閉じて下さい。

Windows10の場合

f:id:Chiakikun:20200427013532p:plain

Windows 10の場合、赤丸部分のパスが一番上にあるとPowerShellやコマンドプロンプトでPythonと入力したときに、ストアが立ち上がってしまって実行できないので、一番下に移動しておいてください。

Pythonプログラミング

ソースコードを書てみる

ここまでの設定で、Pythonが使えるようになっているはずですので、簡単なプログラムを実行してみます。PowerShellを起動して、次のコマンドを入力してメモ帳を起動してください。

notepad test.py

メモ帳が起動したら、次のコードを張り付けて保存して下さい。

import numpy
x = 10
y = 10
z = 10
w = 1

mat_heikoido = numpy.matrix([[1, 0, 0, 10], [0, 1, 0, 0], [0, 0, 1, 0], [0, 0, 0, 1]])
vec = numpy.matrix([[x], [y], [z], [w]])

print(mat_heikoido*vec)

プログラムを実行してみる

f:id:Chiakikun:20180901141752p:plain

PowerShellに次のように入力して実行してみてください。上の画像のように出力されましたか？

python test.py

PyGTも使ってみる

PyQTのライブラリを使って、ウィンドウを表示できるかも試してみます。次のコマンドを入力してメモ帳を起動してください。

notepad qttest.py

次のコードをコピーして下さい。このコードは

PyQt5とpython3によるGUIプログラミング［１］のページで紹介されていたコードを使用させていただきました。コピーしたらメモ帳に貼り付けて保存して下さい。

import sys
from PyQt5.QtWidgets import *

def main():
app = QApplication(sys.argv)
w = QWidget()
w.resize(250, 150)
w.setWindowTitle('Window01')
w.show()
sys.exit(app.exec_())

if __name__ == '__main__':
main()

PyQTを使ったプログラムも実行してみる

f:id:Chiakikun:20180901142452p:plain

④PowerShellで次のコマンドを入力して実行すると、ウィンドウが表示されるはずですが、表示されましたか？

python qttest.py

Plugin開発がしたい

QGISをインストールした環境でPythonプログラミングができるようになり、QGISのプラグイン開発に手を出したくなる方もいらっしゃるかと思いますが、そのためにはもう少し設定が必要です。下のページではプラグイン開発が容易になるプラグイン「Plugin Builder」の紹介をしています。

chiakikun.hatenadiary.com

下のページでは、Visual Studioという開発環境を使って、プラグインのデバッグができるようにする方法を紹介していますので、興味がある方はご覧ください。

chiakikun.hatenadiary.com

最後までご覧頂き、ありがとうございました

2018-06-24

QGIS3のプラグインをVisualStudioでデバッグするための設定

QGISのプラグイン

Python開発環境をインストールする
プラグインをVisualStudioに読み込ませる
- プラグインのソリューションファイルを作成する
- プラグインを選択する
QGISのPython環境を取り込む
- Python環境を追加する
- QGISに付属のPythonのパスを設定する
QGISのモジュール設定
- モジュールが見つからない
- 検索パスを追加
デバッグ
Visual Studio Codeでデバッグする場合

このページでは、QGISのプラグインをVisualStudioを使ってデバッグができるように設定していきます。デバッグに使ったプラグインは「QGIS3 Plugin Builderでプラグイン作成」で作成したものを使用しています。

QGISをインストールした環境でPythonプログラミングするための環境設定が未だ済んでいない場合は「QGIS3 Pythonプログラミングのための設定」のページで紹介している設定を行ってください。

Python開発環境をインストールする

インストーラーを起動する

f:id:Chiakikun:20190429142435p:plain

Visual Studio Installerが起動したら、『Python 開発』を選択します。今回はQGISのインストール時に付属しているPythonを使いたいので、オプションの赤丸部分の選択は全て解除します。解除したら、『変更』ボタンを押下します。

ダイアログが出てきたら

f:id:Chiakikun:20180825123315p:plain

途中、上のようなダイアログが出てくる場合があります。この場合、VisualStudioを閉じてから、ダイアログの『続行』ボタンを押下してください。

Pythonを選択する

f:id:Chiakikun:20190429142706p:plain

VisualStudioを起動してみて、『言語』→『Python』を選択すると、項目が増えています。これでVisualStudioにPython開発環境がインストールされました。

プラグインをVisualStudioに読み込ませる

プラグインのソリューションファイルを作成する

f:id:Chiakikun:20190429143013p:plain

「QGIS3 Plugin Builderでプラグイン作成」で作成したプラグインのソリューションファイルを作成します。VisualStudioを起動して、メニューの『新しいプロジェクトの作成』を選択し、『言語』→『Python』を選択します。表示された項目の中から、『既存のPythonコードから』を選択します。

プラグインを選択する

f:id:Chiakikun:20190429143320p:plain

場所には「QGIS3 Plugin Builderでプラグイン作成」で作成したプラグインの保存先を指定します。

f:id:Chiakikun:20190429143502p:plain

『完了』ボタンを押下します。

QGISのPython環境を取り込む

Python環境を追加する

f:id:Chiakikun:20190429143545p:plain

f:id:Chiakikun:20190429143801p:plain

読み込みに成功すると、ソリューションエクスプローラーにプラグインのファイルが全部表示されます。次にQGISに付属のPython環境をVisualStudioで使うための設定をします。Python環境を右クリックして『環境を追加』を選択します。

QGISに付属のPythonのパスを設定する

f:id:Chiakikun:20190429144213p:plain

『既存の環境』を選択します。

f:id:Chiakikun:20190429144259p:plain

プレフィックスにPython.exeが置かれているパスを指定します。QGIS3.6.1では「C:\Program Files\QGIS 3.6\apps\Python37」に置かれています。プレフィックスの設定に成功すると、他の項目が自動で設定されます。

QGISのモジュール設定

モジュールが見つからない

f:id:Chiakikun:20190429151505p:plain

test_plugin.pyのコードを開くと、qgiscoreライブラリが見つけられていないので、設定します。

検索パスを追加

f:id:Chiakikun:20190429155007p:plain

ソリューションエクスプローラーの『検索パス』を右クリックして、『フォルダーを検索パスに追加』を選択します。選択ダイアログが表示されたら、QGIS3.6の場合は「C:\Program Files\QGIS 3.6\apps\qgis\python」を選択します。成功すると、ソースコードのqgis.coreの下のニョロニョロが消えます。