17. プロセッシングプラグインを書く

開発しようとしているプラ​​グインの種類によっては、プロセッシングアルゴリズム(またはそれらのセット)として機能を追加する方が良い場合もあるでしょう。そうすれば、QGIS内でのより良い統合がなされ(これは、モデラーやバッチ処理インターフェイスといった、「プロセッシング」のコンポーネントの中で実行できるためです)、また開発時間の短縮も期待できます(「プロセッシング」が作業の大部分を肩代わりしてくれるからです)。

開発したアルゴリズムを配布するためには、アルゴリズムをプロセッシングツールボックスに追加するためのプラグインを新しく作る必要があります。このプラグインにはアルゴリズムプロバイダを含ませるとともに、プラグインの初期化の際にアルゴリズムがツールボックスに登録されるようにする必要があります。

17.1. イチから作る

アルゴリズムプロバイダを含むプラグインをイチから作るには、Plugin Builder を使って以下のステップに従います。

  1. Plugin Builder プラグインをインストールする

  2. Plugin Builder を使用して新しくプラグインを作成します。Plugin Builder が使用するテンプレートをきいてきたら、「プロセッシングプロバイダ」を選択します。

  3. 生成されたプラグインには、アルゴリズムをひとつ持つプロバイダが含まれています。プロバイダファイルおよびアルゴリズムファイルには両方ともに十分なコメントがついていて、プロバイダを修正したりさらにアルゴリズムを追加する方法についての情報が含まれています。詳細については、それらを参照してください。

17.2. プラグインをアップデートする

すでに作成済みのプラグインをプロセッシングに追加したい場合は、さらにコードを追加する必要があります。

  1. metadata.txt ファイルに以下の変数を追加する必要があります。

    hasProcessingProvider=yes
    
  2. initGui メソッドによってプラグインのセットアップを担うPythonファイルでは、幾つかのコードを直す必要があります。

     1from qgis.core import QgsApplication
     2from processing_provider.provider import Provider
     3
     4class YourPluginName():
     5
     6    def __init__(self):
     7        self.provider = None
     8
     9    def initProcessing(self):
    10        self.provider = Provider()
    11        QgsApplication.processingRegistry().addProvider(self.provider)
    12
    13    def initGui(self):
    14        self.initProcessing()
    15
    16    def unload(self):
    17        QgsApplication.processingRegistry().removeProvider(self.provider)
    
  3. processing_provider フォルダを作ってそこに次の3つのファイルを納めることもできます。

    • 白紙の __init__.py ファイル。このファイルは妥当なPythonパッケージを作るために必要です。

    • provider.py ファイルはプロセッシングプロバイダを生成しあなたのアルゴリズムを外部から使えるようにします。

       1from qgis.core import QgsProcessingProvider
       2
       3from processing_provider.example_processing_algorithm import ExampleProcessingAlgorithm
       4
       5
       6class Provider(QgsProcessingProvider):
       7
       8    def loadAlgorithms(self, *args, **kwargs):
       9        self.addAlgorithm(ExampleProcessingAlgorithm())
      10        # add additional algorithms here
      11        # self.addAlgorithm(MyOtherAlgorithm())
      12
      13    def id(self, *args, **kwargs):
      14        """The ID of your plugin, used for identifying the provider.
      15
      16        This string should be a unique, short, character only string,
      17        eg "qgis" or "gdal". This string should not be localised.
      18        """
      19        return 'yourplugin'
      20
      21    def name(self, *args, **kwargs):
      22        """The human friendly name of your plugin in Processing.
      23
      24        This string should be as short as possible (e.g. "Lastools", not
      25        "Lastools version 1.0.1 64-bit") and localised.
      26        """
      27        return self.tr('Your plugin')
      28
      29    def icon(self):
      30        """Should return a QIcon which is used for your provider inside
      31        the Processing toolbox.
      32        """
      33        return QgsProcessingProvider.icon(self)
      
    • example_processing_algorithm.py ファイルはサンプルアルゴリズムを含みます。 script template file の内容をコピー&ペーストして、自分の必要に合わせて修正してください。

  4. ここまできたらQGISでプラグインをリロードすれば、プロセッシングツールボックスとモデラーの中にあなたのスクリプトを見つけることができるはずです。