Importante

Translation is a community effort you can join. This page is currently translated at 74.40%.

27.3. La caja de Herramientas

La Caja de Herramientas de Procesamiento es el elemento principal de la GUI de procesamiento y el que es más probable que utilice en su trabajo diario. Muestra la lista de todos los algoritmos disponibles agrupados en diferentes bloques llamados Proveedores, y modelos y scripts personalizados que puede agregar para ampliar el conjunto de herramientas. Por lo tanto, la caja de herramientas es el punto de acceso para ejecutarlos, ya sea como un proceso único o como un proceso por lotes que implica varias ejecuciones del mismo algoritmo en diferentes conjuntos de entradas.

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

Figura 27.6 Caja de Herramientas de Procesamiento

Los proveedores se pueden (des)activar en Diálogo de configuración de procesamiento. De forma predeterminada, solo los proveedores que no dependen de aplicaciones de terceros (es decir, aquellos que solo requieren que se ejecuten elementos QGIS) están activos. Los algoritmos que requieren aplicaciones externas pueden necesitar una configuración adicional. La configuración de proveedores se explica en un capítulo posterior de este manual.

En la parte superior del cuadro de diálogo de la caja de herramientas, encontrará un conjunto de herramientas para:

  • Trabajar con processingModel Modelos: Crear Nuevo Modelo…, Abrir Modelo existente… y Agregar Modelo a la caja de Herramientas…;

  • trabajar con pythonFile Scripts: Craer Nuevo Script…, Crear Nuevo Script desde Plantilla…, Abrir Script existente… y Agregar Script a Caja de Herramientas…;

  • Abra el panel processingHistory Historial;

  • abra el panel processingResult Visor de Resultados;

  • Conmutar la caja de herramientas a modo de modificación in situ usando el botón processSelected Editar objetos de la capa activa : solo se muestran los algoritmos que son adecuados para ejecutarse en la capa activa sin generar una nueva capa;

  • abra el diálogo options Opciones.

Debajo de esta barra de herramientas hay un cuadro search Buscar… para ayudarle a encontrar fácilmente las herramientas que necesita. Puede ingresar cualquier palabra o frase en el cuadro de texto. Observe que, a medida que escribe, la cantidad de algoritmos, modelos o scripts en la caja de herramientas se reduce a solo aquellos que contienen el texto que ha ingresado en sus nombres o palabras clave.

Nota

En la parte superior de la lista de algoritmos se muestran las herramientas utilizadas más recientemente; útil si desea volver a ejecutar alguna.

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

Figura 27.7 Caja de herramientas de procesamiento que muestra los resultados de la búsqueda

Para ejecutar una herramienta, simplemente haga doble clic en su nombre en la caja de herramientas.

27.3.1. El cuadro de diálogo de algoritmo

Una vez que hace doble click en el nombre del algoritmo que desea ejecutar, se muestra un diálogo similar al de Figura 27.8 a continuación (en este caso, el diálogo corresponde al algoritmo Centroides) .

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

Figura 27.8 Dialogo Algoritmo - Parámetros

El diálogo muestra dos pestañas (Parameters y Log) en la parte izquierda, la descripción del algoritmo a la derecha y un conjunto de botones en la parte inferior.

27.3.1.1. Tipos de parámetros

La pestaña Parámetros se usa para establecer los valores de entrada que el algoritmo necesita para ser ejecutado. Muestra una lista de valores de entrada y parámetros de configuración a configurar. Por supuesto, tiene un contenido diferente, dependiendo de los requisitos del algoritmo a ejecutar, y se crea automáticamente en función de esos requisitos.

Truco

Setting your own default values for algorithm parameters

Algorithm dialogs open with some parameters prefilled with values from QGIS installation. It is however possible to set your own default values for specific algorithm parameters so that they are used at algorithm startup.

Aunque el número y el tipo de parámetro dependen de las características del algoritmo, la estructura es similar para todos ellos. Los parámetros encontrados en la tabla pueden ser de uno de los siguientes tipos.

  • Una capa vectorial, para seleccionar de una lista de todas las capas vectoriales disponibles (actualmente abiertas) en QGIS. También puede utilizar capas no cargadas: pulse el botón en la parte derecha del widget, y seleccione:

    • Seleccionar archivo…: selecciona un archivo del disco utilizando el explorador de archivos del sistema operativo

    • Buscar capa…: abre el panel Navegador, que permite tomar las capas directamente de fuentes de bases de datos (PostgreSQL, SQL Server, Oracle, …), servicios web (WFS, AFS, …) o archivos en disco.

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

    Figura 27.9 Widget de entrada de vectores

    Nota

    De forma predeterminada, el widget de capa muestra el SRC de la capa junto con su nombre. Si no desea ver esta información adicional, puede desactivar esta funcionalidad en el cuadro de diálogo Configuración de procesamiento, desmarcando la opción General ► Mostrar definición de SRC de capa en cuadros de selección.

    El widget de entrada de vectores también tiene las siguientes características:

    • un botón iterador iterate: Si está activado, el algoritmo se ejecutará iterativamente en cada una de sus objetos espaciales, en lugar de una sola vez para toda la capa, produciendo tantas salidas como veces se ejecute el algoritmo. Esto permite automatizar el proceso cuando todas las características de una capa deben procesarse por separado. Si el algoritmo contiene varios vectores de entrada sobre los que se puede iterar, la iteración se procesará sólo sobre el primer parámetro conmutado, en el orden en que se declaran los parámetros en el algoritmo.

    • options Opciones avanzadas para ajustar la configuración a utilizar para ese parámetro específico. Estos ajustes se refieren a:

      • Filtrado de objetos espaciales no válidos: permite el método predeterminado para el tratamiento de objetos espaciales con geometrías no válidas que deben anularse

      • Límite de objetos espaciales procesados: límite opcional del número de objetos espaciales procesados desde el origen.

      • Feature filter: allows to enter an expression to subset the layer dynamically when running the tool, avoiding the need for separate steps to set layer filters or create layer subsets.

      ../../../_images/vector_input_parameters.png

      Figura 27.10 Advanced options for vector input widget

    • También es posible limitar la ejecución del algoritmo en la capa vectorial a su Sólo objetos espaciales seleccionados.

  • Una tabla, para seleccionar de una lista de todas las disponibles en QGIS. Las tablas no espaciales se cargan en QGIS como capas vectoriales, y utilizan el mismo widget.

  • Una capa ráster, para seleccionar de una lista de todas las capas ráster disponibles en QGIS. El selector contiene también un botón en su parte derecha, para permitirle seleccionar nombres de archivos que representan capas actualmente no cargadas en QGIS.

    ../../../_images/raster_input1.png

    Figura 27.11 Widget de entrada Raster

  • Una opción, para elegir de una lista de selección de posibles opciones.

  • Un valor numérico, que se introducirá en una casilla de número. En algunos contextos (cuando el parámetro se aplica a nivel de entidad y no a nivel de capa), encontrará un botón dataDefine Anulación definida por datos a un lado, que le permite abrir el :ref:ʻconstructor de expresiones<vector_expressions>` e ingresar una expresión matemática para generar valores variables para el parámetro. Algunas variables útiles relacionadas con los datos cargados en QGIS se pueden agregar a su expresión, por lo que puede seleccionar un valor derivado de cualquiera de estas variables, como el tamaño de celda de una capa o la coordenada más al norte de otra.

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

Figura 27.12 Entrada basada en expresión

  • Un rango, con valores mínimos y máximos que se introducirán en dos cuadros de texto.

  • Una cadena de texto, que se introducirá en un cuadro de texto.

  • Un campo, para elegir de la tabla de atributos de una capa vectorial o de una sola tabla seleccionada en otro parámetro.

  • Un sistema de referencia de coordenadas. Puede seleccionarlo entre los usados recientemente en la lista desplegable o en el diálogo Selección de SRC que aparece al hacer clic en el botón del lado derecho.

  • Una extensión, un cuadro de texto que define un rectángulo a través de sus esquinas coordinadas en el formato xmin, xmax, ymin, ymax. Pulse el botón mapIdentification Establecer la extensión actual del lienzo del mapa para utilizar la extensión del lienzo del mapa. Al hacer clic en la flecha situada a la derecha del selector de valores, aparecerá un menú emergente con opciones para:

    • Calcular a partir de capa ►: rellena la caja de texto con las coordenadas del cuadro delimitador de una capa a seleccionar entre las cargadas.

    • Calcular a partir de mapa de disposición ►: rellena la caja de texto con las coordenadas de un elemento de mapa seleccionado de una disposición del proyecto actual.

    • Calcular a partir de marcador ►: rellena la caja de texto con las coordenadas de un marcador guardado

    • mapIdentification Utilizar la extensión actual del lienzo del mapa

    • Dibujar sobre lienzo: la ventana de parámetros se ocultará, por lo que puede hacer click y arrastrar sobre el lienzo. Una vez que haya definido el rectángulo de extensión, volverá a aparecer el cuadro de diálogo que contiene los valores en el cuadro de texto de la extensión.

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

    Figura 27.13 Selector de extensión

  • Una lista de elementos (ya sean capas raster o vectoriales, tablas, campos) para seleccionar. Haga clic en el botón a la izquierda de la opción para ver un diálogo como el siguiente. Se permite la selección múltiple y cuando se cierra el cuadro de diálogo, el número de elementos seleccionados se muestra en el widget del cuadro de texto del parámetro.

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

    Figura 27.14 Selección Múltiple

  • Una tabla pequeña para ser editada por el usuario. Estos se utilizan para definir parámetros como tablas de búsqueda o núcleos de convolución, entre otros.

    Click en el botón del lado derecho para ver la tabla y editar sus valores.

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

    Figura 27.15 Tabla Fija

    Dependiendo del algoritmo, el número de filas que pueden ser modificadas o no al utilizar los botones del lado derecho de la ventana.

Nota

Some algorithms require many parameters to run, e.g. in the Calculadora ráster 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.

27.3.1.2. Registro de la ejecución

Junto con la pestaña Parámetros, hay otra pestaña llamada Registro (véase Figura 27.16 más abajo). La información proporcionada por el algoritmo durante su ejecución se escribe en esta pestaña, permitiéndole hacer un seguimiento de la ejecución así como conocer y tener más detalles sobre el algoritmo a medida que se ejecuta. La información sobre la ejecución del algoritmo también se muestra en Ver ► Paneles ► Panel de Mensajes de Registro.

Tenga en cuenta que no todos los algoritmos escriben información en la pestaña Registro, y muchos de ellos pueden ejecutarse silenciosamente sin producir ningún resultado más que los archivos finales. Compruebe el Panel de registro de mensajes en ese caso.

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

Figura 27.16 Diálogo Algoritmo - Registro

En la parte inferior de la pestaña Registro encontrará botones para fileSave Guardar registro en archivo, editCopy Copiar registro al portapapeles y clearConsole Borrar registro. Estos son particularmente útiles cuando ha marcado Mantener el diálogo abierto después de ejecutar el algoritmo en la parte General de las opciones de Procesamiento.

27.3.1.3. Otras herramientas

En el lado derecho del cuadro de diálogo encontrará una breve descripción del algoritmo, que lo ayudará a comprender su propósito y sus ideas básicas. Si dicha descripción no está disponible, no se mostrará el panel de descripción.

Para obtener un archivo de ayuda más detallado, que puede incluir una descripción de cada parámetro que utiliza, o ejemplos, encontrará un botón Ayuda en la parte inferior del diálogo que lo lleva a la :ref:`Documentación de algoritmos de procesamiento<processing_algs>`o a la documentación del proveedor (para algunos proveedores externos).

El menú Avanzado ► proporciona funciones para reutilizar la configuración definida en el diálogo sin ejecutar el algoritmo:

  • settings Algorithm Settings…: allows to override processing settings for the current algorithm execution. More details at Override algorithm settings.

  • pythonFile Copy as Python Command: allows for easy copying of the equivalent PyQGIS command to run the tool using the parameters defined in the dialog

  • terminal Copy as qgis_process Command: allows for easy generation of qgis_process command, including its environment settings like the distance units, area units, ellipsoid, and any tricky parameter values like GeoPackage outputs with specific layers

  • editCopy Copy as JSON: all the settings of the command are copied in a JSON format, ready to be consumed by qgis_process. This is a convenient way to see the expected format of the commands, even for complex parameters (like TIN interpolation parameters). You can store these easily and then restore them later by pasting the values.

  • editPaste Paste Settings in a JSON format

El botón Correr como Proceso de Lotes… dispara el modo de procesamiento por lotes permitiendo ejecutar y correr múltiples instancias del algoritmo con una variedad de parámetros. Correr como Proceso Único… le ayuda a volver atrás desde el modo por lotes.

Cuando finaliza la ejecución de un algoritmo (con o sin éxito), se muestra un nuevo botón Cambiar parámetros siempre que la pestaña Registro esté activa.

27.3.1.4. Override algorithm settings

Triggered from within the Advanced drop-down menu at the bottom of an algorithm dialog, the settings Algorithm Settings… shows a panel allowing users to control general processing settings which apply to that algorithm execution only. It is intended to be a place where a user can override their global processing settings on an ad-hoc basis without having to change their usual default settings.

Settings that can be overridden are:

  • Invalid feature filtering: unlike the existing per-parameter setting override for this, setting the handling method here will apply to ALL inputs for the algorithm

  • Calculation settings, such as Distance units and Area units to use for distance/area measurements

  • Environment settings, such as Temporary folder and Number of threads to use

27.3.1.5. Un comentario sobre proyecciones

La ejecución del algoritmo de procesamiento siempre se realiza en el sistema de referencia de coordenadas de la capa de entrada (SRC). Debido a las capacidades de reproyección sobre la marcha de QGIS, aunque parezca que dos capas se superponen y coinciden, eso podría no ser cierto si se utilizan sus coordenadas originales sin reproyectarlas en un sistema de coordenadas común. Siempre que utilice más de una capa como entrada para un algoritmo nativo de QGIS, ya sea vectorial o ráster, todas las capas se volverán a proyectar para que coincidan con el sistema de referencia de coordenadas de la primera capa de entrada.

Sin embargo, esto es menos cierto para la mayoría de las aplicaciones externas cuyos algoritmos se exponen a través del marco de procesamiento, ya que asumen que todas las capas ya están en un sistema de coordenadas común y listas para ser analizadas.

De forma predeterminada, el cuadro de diálogo de parámetros mostrará una descripción del SRC de cada capa junto con su nombre, lo que facilita la selección de capas que comparten el mismo SRC para utilizarlas como capas de entrada. Si no desea ver esta información adicional, puede deshabilitar esta funcionalidad en el cuadro de diálogo Configuración de procesamiento, desmarcando la opción: guilabel: Mostrar definición de capa SRC en cuadros de selección.

Si intenta ejecutar un algoritmo utilizando como entrada dos o más capas con CRS no coincidentes, se mostrará un cuadro de diálogo de advertencia. Esto ocurre gracias a la opción Advertir antes de ejecutar si la capa SRC no coincide.

Aún se puede ejecutar el algoritmo, pero en la mayoría de los casos se producirán resultados incorrectos, como capas vacias debido a que las capas de entrada no se solapan.

Truco

Usar algoritmos de procesamiento para realizar una reproyección intermedia

Cuando un algoritmo no puede funcionar con éxito en múltiples capas de entrada debido a SRC no coincidentes, use el algoritmo interno de QGIS como Capa reproyectada para realizar la reproyección de capas al mismo SRC antes de ejecutar el algoritmo usando estas salidas.

27.3.2. Resultados generados por algoritmos

Los tipos de resultados que se pueden generar cor un algoritmo son los siguientes:

  • Una capa ráster.

  • Una capa vectorial.

  • Una tabla

  • Un archivo HTML (usado para salidas de texto y salidas gráficas).

Todos estos se guardan en el disco, y la tabla de parámetros contendrá un cuadro de texto correspondiente a cada una de estas salidas, donde puede escribir el canal de salida a usar para guardarlo. Un canal de salida contiene la información necesaria para guardar el objeto resultante en algún lugar. En el caso más habitual, lo guardarás en un archivo, pero en el caso de capas vectoriales, y cuando sean generadas por algoritmos nativos (algoritmos que no utilizan aplicaciones externas) también puedes guardar en una base de datos PostGIS, GeoPackage o SpatiaLite, o una capa de memoria.

Para seleccionar un canal de salida, simplemente haga clic en el botón en el lado derecho del cuadro de texto y verá un pequeño menú contextual con las opciones disponibles.

En el caso más habitual, seleccionará guardar en un archivo. Si selecciona esa opción, se le solicitará un cuadro de diálogo para guardar archivo, donde puede seleccionar la ruta de archivo deseada. Las extensiones de archivo admitidas se muestran en el selector de formato de archivo del cuadro de diálogo, según el tipo de salida y el algoritmo.

El formato de la salida está definido por la extensión del nombre de archivo. Los formatos admitidos dependen de lo que admita el propio algoritmo. Para seleccionar un formato, simplemente seleccione la extensión de archivo correspondiente (o agréguela, si en su lugar está escribiendo directamente la ruta del archivo). Si la extensión de la ruta del archivo que ingresó no coincide con ninguno de los formatos admitidos, se agregará una extensión predeterminada a la ruta del archivo y se usará el formato de archivo correspondiente a esa extensión para guardar la capa o tabla. Las extensiones predeterminadas son .dbf para tablas, .tif para capas ráster y .gpkg para capas vectoriales. Estos se pueden modificar en el cuadro de diálogo de configuración, seleccionando cualquier otro de los formatos compatibles con QGIS.

Si no ingresa ningún nombre de archivo en el cuadro de texto de salida (o selecciona la opción correspondiente en el menú contextual), el resultado se guardará como archivo temporal en el formato de archivo predeterminado correspondiente, y se eliminará una vez que salga de QGIS (tenga cuidado con eso, en caso de que guarde su proyecto y contenga capas temporales).

Puede establecer una carpeta predeterminada para los objetos de datos de salida. Vaya al diálogo de configuración (puede abrirlo desde el menú Configuración -> Opciones -> Procesamiento), y en el grupo General, encontrará un parámetro llamado: guilabel: ` Carpeta de salida`. Esta carpeta de salida se utiliza como ruta predeterminada en caso de que escriba solo un nombre de archivo sin ruta (es decir, myfile.shp) al ejecutar un algoritmo.

Al ejecutar un algoritmo que utiliza una capa vectorial en modo iterativo, la ruta del archivo introducido se utiliza como la ruta de la base para todos los archivos generados, los cuales se denominan utilizando el nombre base y añadiendo un número que representa el índice de la iteración. La extensión del archivo (y el formato) se utiliza para todos los archivos generados.

Además de las capas y tablas ráster, los algoritmos también generan gráficos y texto como archivos HTML. Estos resultados se muestran al final de la ejecución del algoritmo en un nuevo diálogo. Este diálogo mantendrá los resultados producidos por cualquier algoritmo durante la sesión actual, y se puede mostrar en cualquier momento seleccionando Procesamiento -> Visor de Resultados en el menú principal de QGIS.

Algunas aplicaciones externas pueden tener archivos (sin restricciones de extensión particulares) como de salida, pero no pertenece a ninguna de las categorías anteriores. Esos archivos de salida no serán procesadas por QGIS (abierto o incluido en el proyecto actual de QGIS), ya que la mayor parte del tiempo que corresponden a formatos de archivo o elementos no compatibles con QGIS. Esto es, por ejemplo, en el caso de archivos LAS utilizados para datos LiDAR. Los archivos se crean, pero no se ve nada nuevo en su sesión de trabajo en QGIS.

Para todos los otros tipos de salida, encontrará una casilla de verificación que se puede utilizar para decirle al algoritmo si se debe cargar el archivo una vez que se genera por el algoritmo o no. Por defecto, se abren todos los archivos.

No se admiten salidas opcionales. Es decir, se crean todas las salidas. Sin embargo, puede desmarcar la casilla de verificación correspondiente si no está interesado en una salida determinada, lo que esencialmente hace que se comporte como una salida opcional (en otras palabras, la capa se crea de todos modos, pero si deja el cuadro de texto vacío, será guardado en un archivo temporal y eliminado una vez que salga de QGIS).