24.8. Usando o processamento da linha de comando

QGIS vem com uma ferramenta chamada “QGIS executor de processamento” permitindo que você execute algoritmos de processamento e modelos (construídos dentro do software ou providos por plugins), direto da linha de comando, sem precisar iniciar o aplicativo no desktop.

Por uma ferramenta de linha de comando, execute “qgis_process” e você deverá receber como saída:

QGIS Processing Executor - 3.21.0-Master 'Master' (3.21.0-Master)
Usage: C:\OSGeo4W\apps\qgis-dev\bin\qgis_process.exe [--json] [--verbose] [command] [algorithm id or path to model file] [parameters]

Options:

  --json          Output results as JSON objects
  --verbose       Output verbose logs

Available commands:

  plugins          list available and active plugins
  plugins enable   enables an installed plugin. The plugin name must be specified, e.g. "plugins enable cartography_tools"
  plugins disable  disables an installed plugin. The plugin name must be specified, e.g. "plugins disable cartography_tools"
  list             list all available processing algorithms
  help             show help for an algorithm. The algorithm id or a path to a model file must be specified.
  run              runs an algorithm. The algorithm id or a path to a model file and parameter values must be specified.
                   Parameter values are specified after -- with PARAMETER=VALUE syntax.
                   Ordered list values for a parameter can be created by specifying the parameter multiple times,
                   e.g. --LAYERS=layer1.shp --LAYERS=layer2.shp
                   If required, the ellipsoid to use for distance and area calculations can be specified via the "--ELLIPSOID=name" argument.
                   If required, an existing QGIS project to use during the algorithm execution can be specified via the "--PROJECT_PATH=path" argument.

Nota

Apenas plugins instalados que avisam hasProcessingProvider=yes no seu metadata.txt no arquivo são reconhecidos e podem ser ativados ou carregados pelo qgis_process tool.

O comando lista pode ser usado para obter uma lista de todos os provedores e algoritmos disponíveis.

qgis_process list

O comando ajuda pode ser usado para obter mais informações sobre comandos ou algoritmos.

qgis_process help qgis:regularpoints

O comando executar pode ser usado para executar um algoritmo ou modelo. Especifique o nome do algoritmo ou um caminho para um modelo como primeiro parâmetro.

qgis_process run qgis:buffer -- INPUT=source.shp DISTANCE=2 OUTPUT=buffered.shp

Onde um parâmetro aceita uma lista de valores, defina a mesma variável várias vezes.

qgis_process run native:mergevectorlayers -- LAYERS=input1.shp LAYERS=input2.shp OUTPUT=merged.shp

Durante a execução de um algoritmo, uma barra de feedback em texto é mostrada, e a operação pode ser cancelada via :kbd:`CTRL+C. O comando “run” também dá suporte para parâmetros adicionais.

  • --json irá formatar a saída stdout dentro de uma estrutura chamada JSON.

  • –ellipsoid`` preparará o ellipsoid para o do tipo específico.

  • --distance_units usará as unidades especificas de distância.

  • --area_units usará as unidades especificas de área.

  • --project_path irá carregar o projeto específico que executa o algoritmo