22.3. ツールボックス

The Processing Toolbox is the main element of the processing GUI, and the one that you are more likely to use in your daily work. It shows the list of all available algorithms grouped in different blocks called Providers, and custom models and scripts you can add to extend the set of tools. Hence the toolbox is the access point to run them, whether as a single process or as a batch process involving several executions of the same algorithm on different sets of inputs.

../../../_images/toolbox3.png

図 22.6 プロセッシングツールボックス

プロバイダは Processing settings dialog で有効化(無効化)することができます. デフォルトサードパーティアプリケーションに依存しないプロバイダで (QGIS エレメントのみに依存する) が有効です. 外部アプリケーションが必要なアルゴリズムについては追加の構成が必要な場合があります. プロバイダの設定についてはこのマニュアルの later chapter を参照して下さい.

ツールボックスの上部には次のようなツールがあります:

  • work with processingModel Models: Create New Model..., Open Existing Model... and Add Model to Toolbox...;

  • work with pythonFile Scripts: Create New Script..., Create New Script from Template..., Open Existing Script... and Add Script to Toolbox...;

  • open the processingHistory History panel;

  • processingResult 結果ビューア パネルを開きます;

  • toggle the toolbox to the in-place modification mode using the processSelected Edit Features In-Place button: only the algorithms that are suitable to be executed on the active layer without outputting a new layer are displayed;

  • options オプション ダイアログを開きます.

このツールバーの下の search 検索... ボックスはあなたが必要なツールを探す助けになるでしょう. このテキストボックスに任意の単語やフレーズを入力できます. あなたがここでタイプするとツールボックス内のアルゴリズム,モデル,スクリプトのリスト表示があなたが入力したテキストが名前やキーワードに含まれるものだけになるので注意して下さい.

注釈

アルゴリズムリストの上部には最近最も使われたツールの名前が表示されます; 再度実行したい場合に便利です.

../../../_images/toolbox_search.png

図 22.7 検索結果を表示している[プロセッシングツールボックス]

ツールを実行する場合ツールボックス内の名前をダブルクリックして下さい.

22.3.1. アルゴリズムダイアログ

あなたが実行したいアルゴリズムの名前をダブルクリックすると下の図のようなダイアログが表示されます (この場合は Centroids アルゴリズムの画面です).

../../../_images/parameters_dialog.png

図 22.8 アルゴリズムダイアログ - パラメータ

このダイアログは、アルゴリズムを実行するために必要な入力値を設定するために使用されます。ここには入力値と設定パラメータのリストが表示されます。当然のことですがその内容は実行するアルゴリズムの要件に応じて違い、それら要件に基づいて自動的に作成されます。

パラメータの数とタイプはアルゴリズムの特性に依存しますが、その構造はすべてのアルゴリズムで似通っています。ここで示されるパラメータは次のいずれかのタイプのみが可能です。

  • ラスターレイヤー ,QGISで利用可能なすべてのこのようなレイヤーのリスト(現在開いている)から選択します。セレクタを使用すると、その右側にボタンも含まれ、現在QGISにロードされていないレイヤーを表すファイル名を選択できるようになります。

  • ベクターレイヤー は、QGISで利用可能なすべてのベクターレイヤーのリストから選択します。QGISにロードされていないレイヤーは、ラスターレイヤーの場合のように、同様に選択できますが、このアルゴリズムは、レイヤーの属性テーブルから選択したテーブルのフィールドを必要としない場合にのみ。その場合には、彼らは利用できるフィールド名のリストを取得するように開く必要があるため、開かれたレイヤーだけが選択できます。

    以下の図のように、各ベクターレイヤーにイテレータボタンが表示されるでしょう.

    ../../../_images/vector_iterator.png

    図 22.9 ベクターイテレータボタン

    アルゴリズムがそれらのいくつかを含む場合は、それらのひとつだけを切り替えできるようになります。ベクター入力に対応するボタンがトグルされた場合、アルゴリズムは、アルゴリズムが実行された回数と同じ数の出力を生成する、全レイヤーに一度だけの代わりに、その地物のそれぞれに繰り返し実行されます。これにより、レイヤー内のすべての地物を別々に処理する必要があるとき、プロセスを自動化できます。

注釈

デフォルトでパラメータダイアログでは各レイヤのCRS説明と名前が表示されます.この追加情報を表示したくない場合は If you do not want to see this additional information, you can disable this functionality in the プロセッシング設定ダイアログで非表示設定ができます. 一般情報 ‣ 選択ボックス内にレイヤCRS定義情報を表示する オプションのチェックをはずして下さい.

  • テーブル ,QGISで使用可能なすべてのリストから選択します。非空間テーブルは、ベクターレイヤーのようなものとしてQGISにロードされ、実際にプログラムによってそのようなものとして処理されます。現在、一つのテーブルを必要とするアルゴリズムを実行するときに表示される使用可能なテーブルのリストは、dBaseの内のファイル( .dbf )またはカンマ区切り値( .CSV )フォーマットからのテーブルに制限されます。

  • オプション ,利用可能なオプションのリストから選択する

  • A numerical value, to be introduced in a spin box. In some contexts (when the parameter applies at the feature level and not at the layer's), you will find a dataDefined Data-defined override button by its side, allowing you to open the expression builder and enter a mathematical expression to generate variable values for the parameter. Some useful variables related to data loaded into QGIS can be added to your expression, so you can select a value derived from any of these variables, such as the cell size of a layer or the northernmost coordinate of another one.

../../../_images/number_selector.png

図 22.10 式に基づく入力

  • 範囲 、2個のテキストボックスで最小値と最大値で指定されます.

  • テキストストリング 、1個のテキストボックスで指定されます.

  • フィールド 、ベクターレイヤーまたは別のパラメーターで選択された単一のテーブルの属性テーブルから選択します。

  • A coordinate reference system. You can select it among the recently used ones from the drop-down list or from the CRS selection dialog that appears when you click on the button on the right-hand side.

  • An extent, to be entered by four numbers representing its xmin, xmax, ymin, ymax limits. Clicking on the button on the right-hand side of the value selector, a pop-up menu will appear, giving you options:

    • to select the value from a layer or the current canvas extent;

    • or to define it by dragging directly onto the map canvas.

    ../../../_images/extent.png

    図 22.11 範囲セレクタ

    最初のオプションを選択すると次のようなウィンドウが表示されます。

    ../../../_images/extent_list.png

    図 22.12 範囲リスト

    2番目を選択した場合は、パラメーターウィンドウはそれ自身を非表示にしますので、キャンバスにクリックしてドラッグできます。選択した矩形を定義すると、ダイアログが再表示され、範囲テキストボックス内の値を格納します。

    ../../../_images/extent_drag1.png

    図 22.13 範囲ドラッグ

  • A list of elements (whether raster or vector layers, tables, fields) to select from. Click on the ... button at the left of the option to see a dialog like the following one. Multiple selection is allowed and when the dialog is closed, number of selected items is displayed in the parameter text box widget.

    ../../../_images/multiple_selection.png

    図 22.14 複数選択

  • 小さなテーブル 、ユーザーによって編集されます。これらは、とりわけ、ルックアップテーブルまたはコンボリューションカーネルのようなパラメーターを定義するために使用されます。

    右側にあるボタンをクリックするとテーブルを表示してその値を編集できます.

    ../../../_images/fixed_table.png

    図 22.15 固定テーブル

    アルゴリズムによっては、行数は、ウィンドウの右側にあるボタンを使用せずに変更できます。

注釈

Some algorithms require many parameter to run, e.g. in the ラスタ計算機 you have to specify manually the cell size, the extent and the CRS. You can avoid to choose all the parameters manually when the algorithm has the Reference layers parameter. With this parameter you can choose the reference layer and all its properties (cell size, extent, CRS) will be used.

Along with the Parameters tab, there is another tab named Log (see figure below). Information provided by the algorithm during its execution is written in this tab, and allow you to track the execution and be aware and have more details about the algorithm as it runs. Notice that not all algorithms write information to this tab, and many of them might run silently without producing any output other than the final files.

../../../_images/algdialoglog.png

図 22.16 Algorithm Dialog - Log

At the bottom of the Log tab you will find buttons to Save Log to File, Copy Log to Clipboard and Clear Log. These are particularly handy when you have checked the Keep dialog open after running algorithm in the General part of the Processing options.

On the right hand side of the dialog you will find a short description of the algorithm, which will help you understand its purpose and its basic ideas. If such a description is not available, the description panel will not be shown.

For a more detailed help file, which might include description of every parameter it uses, or examples, you will find a Help button at the bottom of the dialog bringing you to the Processing algorithms documentation or to the provider documentation (for some third-party providers).

22.3.1.1. 投影法についての注記

Processing algorithm execution are always performed in the input layer coordinate reference system (CRS). Due to QGIS's on-the-fly reprojecting capabilities, although two layers might seem to overlap and match, that might not be true if their original coordinates are used without reprojecting them onto a common coordinate system. Whenever you use more than one layer as input to a QGIS native algorithm, whether vector or raster, the layers will all be reprojected to match the coordinate reference system of the first input layer.

This is however less true for most of the external applications whose algorithms are exposed through the processing framework as they assume that all of the layers are already in a common coordinate system and ready to be analyzed.

By default, the parameters dialog will show a description of the CRS of each layer along with its name, making it easy to select layers that share the same CRS to be used as input layers. If you do not want to see this additional information, you can disable this functionality in the Processing settings dialog, unchecking the Show layer CRS definition in selection boxes option.

If you try to execute an algorithm using as input two or more layers with unmatching CRSs, a warning dialog will be shown. This occurs thanks to the Warn before executing if layer CRS's do not match option.

アルゴリズムは実行できますが、ほとんどの場合、入力レイヤーに重なる部分がないために空白レイヤーになるなど、間違った結果が生じることに注意してください。

ちなみに

Use Processing algorithms to do intermediate reprojection

When an algorithm can not successfully perform on multiple input layers due to unmatching CRSs, use QGIS internal algorithm such as Reproject layer to perform layers' reprojection to the same CRS before executing the algorithm using these outputs.

22.3.2. アルゴリズムによって生成されるデータオブジェクト

アルゴリズムによって生成されるデータオブジェクトは以下のタイプが利用できます:

  • ラスターレイヤー

  • ベクターレイヤー

  • テーブル

  • HTML ファイル (テキストとグラフィック出力の場合利用できます)

These are all saved to disk, and the parameters table will contain a text box corresponding to each one of these outputs, where you can type the output channel to use for saving it. An output channel contains the information needed to save the resulting object somewhere. In the most usual case, you will save it to a file, but in the case of vector layers, and when they are generated by native algorithms (algorithms not using external applications) you can also save to a PostGIS, GeoPackage or SpatiaLite database, or a memory layer.

出力チャンネルを選択するには、単にテキストボックスの右側にあるボタンをクリックすると、使用可能なオプションを備えた小型のコンテキストメニューが表示されます。

最も一般的なケースでは、ファイルに保存を選択します。そのオプションを選択した場合、目的のファイル・パスを選択でき、保存ファイルダイアログでプロンプトが表示されます。サポートされているファイルの拡張子は出力とアルゴリズムの種類に応じて、ダイアログのファイル形式セレクタに示されています。

The format of the output is defined by the filename extension. The supported formats depend on what is supported by the algorithm itself. To select a format, just select the corresponding file extension (or add it, if you are directly typing the file path instead). If the extension of the file path you entered does not match any of the supported formats, a default extension will be appended to the file path, and the file format corresponding to that extension will be used to save the layer or table. Default extensions are .dbf for tables, .tif for raster layers and .gpkg for vector layers. These can be modified in the setting dialog, selecting any other of the formats supported by QGIS.

If you do not enter any filename in the output text box (or select the corresponding option in the context menu), the result will be saved as a temporary file in the corresponding default file format, and it will be deleted once you exit QGIS (take care with that, in case you save your project and it contains temporary layers).

You can set a default folder for output data objects. Go to the settings dialog (you can open it from the Settings ‣ Options ‣ Processing menu), and in the General group, you will find a parameter named Output folder. This output folder is used as the default path in case you type just a filename with no path (i.e., myfile.shp) when executing an algorithm.

反復モードのベクターレイヤーを使用するアルゴリズムを実行する場合、入力されたファイルパスには、ベース名を使用し、反復のインデックスを表す数値を付加命名されているすべての生成されたファイルのためのベースパスとして使用されます。ファイルの拡張子(と形式)このようなすべての生成されたファイルに使用されます。

Apart from raster layers and tables, algorithms also generate graphics and text as HTML files. These results are shown at the end of the algorithm execution in a new dialog. This dialog will keep the results produced by any algorithm during the current session, and can be shown at any time by selecting Processing ‣ Results Viewer from the QGIS main menu.

外部アプリケーションには(特に拡張子に制限がない)複数のファイルを出力とするものもありますが、それらは上記のカテゴリのいずれにも属しません。これらの出力ファイルはQGISによって処理される(開かれたり、現在のQGISプロジェクトに含まれる)ことはありません、なぜならほとんどの場合それらはQGISでサポートされていないファイル形式や要素に対応しているからです。これは、例えば、レーザー測量データに使用されるLASファイルの場合です。ファイルは作成されますが、QGIS作業セッションには何も新しいものは表示されません。

他の出力タイプのすべてに対し、アルゴリズムによってか生成されると、ファイルをロードするかどうかをアルゴリズムに指示するために使用できるチェックボックスがあります。デフォルトでは、すべてのファイルが開かれます。

オプションの出力はサポートされていません。つまり、すべての出力が作成されます。しかし、与えられた出力に興味がない場合は、対応するチェックボックスのチェックを外すことで、本質的にそれをオプションの出力のように動作させることができます(つまり、レイヤーがとにかく作成されるが、テキストボックスが空のままにした場合、それは一時ファイルに保存され、QGISを終了した後に削除されます)。