Configuración QGIS

QGIS es altamente configurable. Mediante el menú Ajustes, proporciona diferentes herramientas para:

  • styleManager Administrador de estilo…: crear y administrar símbolos, estilos y rampas de color.

  • customProjection Proyecciones personalizadas…: crear tus propios :ref:`coordinate reference systems `.

  • keyboardShortcuts Atajos de teclado…: define tu propio conjunto de keyboard shortcuts. Además, pueden ser anulados durante cada sesión de QGIS por el project properties (acessible en el menú Proyecto).

  • interfaceCustomization Personalización de la Interfaz…: configure la application interface, ocultando cuadros de diálogo o herramientas que quizás no necesite.

  • options Opciones…: establece las options globales a aplicar en diferentes áreas del software. Estas preferencias se guardan en los ajustes activos User profile y se aplica por defecto cada vez que abre un nuevo proyecto con este perfil.

Opciones

options Algunas opciones básicas para QGIS se pueden seleccionar usando el diálogo Opciones. Selecciona la opción de menú Ajustes‣ options Opciones. Puede modificar las opciones según sus necesidades. Algunos de los cambios pueden requerir un reinicio de QGIS antes de que sean efectivos.

Las pestañas donde puede personalizar sus opciones se describen a continuación.

Nota

Los complementos pueden incrustar su configuración dentro del cuadro de diálogo Opciones

Si bien solo se presentan las configuraciones principales a continuación, tenga en cuenta que esta lista puede ampliarse installed plugins implementando sus propias opciones en el cuadro de diálogo Opciones estándar. Esto evita que cada complemento tenga su propio diálogo de configuración con elementos de menú adicionales solo para ellos …

Configuración general

Anular configuración regional del sistema

Por defecto, QGIS se basa en la configuración de su sistema operativo para establecer el idioma y manipular los valores numéricos. Habilitar este grupo le permite personalizar el comportamiento.

  • Seleccione en Traducción de interfaz de usuario el idioma para aplicar a la GUI

  • Seleccione en Local (número, formatos de fecha y moneda) el sistema en el que deben ingresarse y representarse los valores de fecha y numéricos

  • checkbox Mostrar separador de grupo(mil)

En la parte inferior del cuadro se muestra un resumen de la configuración seleccionada y cómo se interpretarían.

Aplicación

  • Seleccione la Estilo (requiere reinicio de QGIS) p.ej., Los widgets se ven y se colocan en diálogos. Los valores posibles dependen de su sistema operativo.

  • Define el tema UI (requiere reinicio de QGIS) selectString. Puede ser “default”, “Night Mapping”, o “Blend of Gray”

  • Define el Tamaño de icono selectString

  • Define la Fuente y su Tamaño. La fuente puede ser radioButtonOn Qt default o una definida por el usuario

  • Cambie el Tiempo de espera para mensajes o diálogos cronometrados

  • unchecked Ocultar pantalla de inicio al iniciar

  • checkbox Mostrar noticias feed de QGIS en la página de bienvenida: muestra una fuente de noticias feed de QGIS curada en la página de bienvenida, que le brinda una forma directa de estar al tanto de las noticias del proyecto (fecha y resumen de las reuniones de usuarios/desarrolladores, encuestas de la comunidad, anuncios de lanzamientos, varios consejos …)

  • checkbox Verifique la versión de QGIS al inicio para mantenerse informado si se lanza una versión más nueva

  • unchecked Usar cuadros de diálogo de selección de color nativos (ver Selector de color)

  • unchecked Diálogo de administrador de fuente de datos de modelos para mantener el diálogo data source manager abierto y permitir la interacción con la interfaz de QGIS mientras añade capas al proyecto

Los archivos de proyecto

  • Abrir proyecto al iniciar

    • La “Página de Bienvenida” (default): puede mostrar las «Noticias» feed, la plantilla(s) del proyecto y los proyectos mas recientes (con miniaturas) del user profile. Ningún proyecto se abre por defecto.

    • “Nueno”: abre un nuevo proyecto, absado en una plantilla por defecto

    • “Mas recientes”: reabre el último proyecto guardado

    • y “Specifico”: abre un proyecto en concreto . Use el botón para definir el proyecto a usar por defecto.

  • checkbox Crear nuevo proyecto desde el proyecto predeterminado. Tiene la posibilidad de presionar Establecer el actual proyecto como predeterminado o sobre Restablecer el predeterminado. Puede navegar a través de sus archivos y definir un directorio donde se encuentra las plantillas definidas por el usuario. Esto se añadirá a Proyecto ‣ Nueva plantilla de formulario. Si activa primero checkbox Crear nuevo proyecto desde proyecto predeterminado y entonces guarde un proyecto en l la carpeta de las plantillas de proyecto.

  • checkbox Solicitar guardar los cambios del proyecto y la fuente de datos cuando sea necesario para evitar la pérdidas de cambios realizados.

  • checkbox Pedir confirmación cuando se va a eliminar una capa

  • checkbox Avisar al abrir un archivo de proyecto guardado con una versión anterior de QGIS. Siempre puede abrir proyectos creados con una versión anterior de QGIS, pero una vez que se guarda el proyecto, intentar abrir con una versión anterior puede fallar debido a las características no disponibles en esa versión.

  • Habilitar macros selectString. Esta opción fue creada para manejar macros que están escritas para realizar una acción en eventos del proyecto. Puede elegir entre “Nunca”, “Preguntar”, “Solo para esta sesión” y “Siempre (no recomendado)”.

Ajustes del sistema

rutas SVG

Añada o borre Ruta(s) para buscar símbolos Scalable Vector Graphic (SVG). Estos archivos SVG están además disponibles para simbolizar o etiquetas las entidades o decorar tu composición de mapa.

Al usar un archivo SVG en un símbolo o etiqueta, QGIS le permite:

  • cargar el archivo desde el archivo de sistema: el archivo es identificado a través de la ruta de archivo y QGIS necesita resolver la ruta para mostrar la imagen correspondiente

  • cargar el archivo desde una URL remota: como se indicó anteriormente, la imagen solo se cargará al recuperar con éxito el recurso remoto

  • incrustar el archivo SVG en el elemento: el archivo está incrustado dentro del proyecto actual, la base de datos de estilo o la plantilla de diseño de impresión. El archivo SVG siempre se representa como parte del elemento. Esta es una manera conveniente de crear proyectos autónomos con símbolos SVG personalizados que se pueden compartir fácilmente entre diferentes usuarios e instalaciones de QGIS.

    También es posible extraer el archivo SVG incrustado de un símbolo o etiqueta y guardarlo en el disco.

Nota

Las opciones mencionadas anteriormente para cargar y almacenar un archivo SVG en un proyecto también son aplicables a las imágenes ráster que desee utilizar para personalizar símbolos, etiquetas o decoraciones.

Rutas de complemento

Añadir o borrar Ruta(s) para buscar librerías de complementos adicionales de C++.

Rutas de Documentación

Añadir o borrar Ruta(s) de Documentación a usar para la ayuda de QGIS. Por defecto, se agrega un enlace al Manual de usuario en línea oficial correspondiente a la versión que se está utilizando. Sin embargo, puede agregar otros enlaces y priorizarlos de arriba a abajo: cada vez que hace click en un botón Ayuda en un cuadro de diálogo, se comprueba el enlace superior y, si no se encuentra la página correspondiente, se prueba el siguiente, y así.

Nota

La documentación está versionada y traducida solo para QGIS Long Term Releases (LTR), lo que significa que si está ejecutando una versión regular (por ejemplo, QGIS 3.0), el botón de ayuda abrirá de manera predeterminada la siguiente página del manual de LTR (es decir, 3.4 LTR), que puede contener una descripción de las características de las versiones más recientes (3.2 y 3.4). Si no hay documentación LTR disponible, se utiliza el documento testing, con características de versiones más recientes y de desarrollo.

QSettings

Le ayuda a :guilabel: Restablecer la interfaz de usuario a la configuración predeterminada(se requiere reinicio) si realizó alguna customization.

Entorno

../../../_images/sys-env-options.png

Variables del entorno del sistema en QGIS

Las variables de entorno del sistema se pueden ver, y muchas configurar, en el grupo Environment. Esto es útil para plataformas, como Mac, donde una aplicación GUI no necesariamente hereda el entorno de shell del usuario. También es útil para configurar y ver variables de entorno para los conjuntos de herramientas externas controladas por la caja de herramientas Procesamiento (por ejemplo, SAGA, GRASS), y para activar la salida de depuración para secciones específicas del código fuente.

checkbox :guilabel: Usar variables personalizadas (reinicio requerido - incluir separadores). Puede Agregar y :guilabel:` Eliminar` variables. Las variables de entorno ya definidas se muestran en Variables de entorno actuales, y es posible filtrarlas activando checkbox Mostrar solo variables específicas de QGIS.

Configuraciones SRC

Nota

Para obtener más información sobre cómo QGIS maneja la proyección de capas, lea la sección dedicada en Trabajar con Proyecciones.

../../../_images/options_crs.png

Ajustes del CRS en QGIS

CRS para proyectos

Hay una opción para ajustar automáticamente el CRS de nuevos proyectos:

  • radioButtonOnUsar CRS de la primera capa agregada: el CRS del proyecto se establecerá en el CRS de la primera capa cargada en él

  • radioButtonOffUtilice un CRS predeterminado: un CRS preseleccionado se aplica por defecto a cualquier proyecto nuevo y no se modifica al agregar capas al proyecto.

La opción se guardará para su uso en sesiones posteriores de QGIS. El Sistema de referencia de coordenadas del proyecto todavía puede anularse desde la pestaña Proyecto ‣ Propiedades… ‣ CRS.

CRS para capas

:guilabel:`CRS predeterminado para capas”: seleccione un CRS Preestablecido a usar cuando cree una capa

También puede definir la acción a tomar cuando se crea una nueva capa, o cuando se carga una capa sin un CRS.

  • radioButtonOn Dejar como CRS desconocido (no hacer nada)

  • radioButtonOff Solicitud de CRS

  • radioButtonOff Usar CRS del proyecto

  • radioButtonOff Usar un CRS preestablecido

Transformación de datum predeterminado

En este grupo, puede controlar si la reproyección de capas a otro CRS debe ser:

  • procesado automáticamente usando la configuración de transformaciones predeterminadas de QGIS;

  • y/o mayor control por usted con preferencias personalizadas como:

    • checkbox Pedir transformación de datos si hay varios disponibles

    • Una lista predefinida de transformaciones de referencia para aplicar por defecto. Ver Datum Transformations for more details.

  • unchecked Mediciones planimétricas: establece el valor predeterminado para la propiedad «medidas planimétricas» para proyectos recién creados.

Ajustes de las Fuentes de Datos

../../../_images/options_data_sources.png

Ajustes de Fuentes de Datos en QGIS

Atributos de entidades espaciales y tabla

  • checkbox Abrir nuevas tablas de atributos como ventanas acopladas

  • Copiar entidades como “Texto plano, sin geometría”, “Texto plano, geometría WKT”, o “GeoJSON” al pegar entidades en otras aplicaciones.

  • Comportamiento de la tabla de atributos selectString: establecer filtro en la tabla de atributos en la apertura. Hay tres posibilidades: “Mostrar todas las entidades”, “Mostrar entidades seleccionadas” y “Mostrar entidades visibles en el mapa”.

  • Vista predeterminada: define el modo de vista de la tabla de atributos en cada apertura. Puede ser “Recordar última vista”, “Vista de tabla” o “Vista de formulario”.

  • Tabla de atributos fila caché selectNumber. Este caché de filas permite guardar las N últimas filas de atributos cargados para que trabajar con la tabla de atributos sea más rápido. El caché se eliminará al cerrar la tabla de atributos.

  • Representación de valores NULOS. Aquí, puede definir un valor para los datos de campos que tienen un valor NULO.

Truco

Mejorar la apertura de la tabla de atributos de big data

Al trabajar con capas con gran cantidad de registros, la apertura de la tabla de atributos puede ser lenta ya que el diálogo solicita todas las filas de la capa. Al configurar Atributo del comportamiento de la tabla en Mostrar características visibles en el mapa hará que QGIS solicite solo las características en el lienzo del mapa actual al abrir la tabla, permitiendo una carga rápida de datos.

Tenga en cuenta que los datos en esta instancia de tabla de atributos siempre estarán vinculados a la extensión del lienzo con la que se abrió, lo que significa que al seleccionar Mostrar todas las entidades dentro de dicha tabla no se mostrarán nuevas entidades. Sin embargo, puede actualizar el conjunto de entidades mostradas cambiando la extensión del lienzo y seleccionando la opción Mostrar entidades visibles en el mapa en la tabla de atributos.

Manejo de fuente de datos

  • Escanear en busca de elementos válidos en el dock del navegador selectString. Puede elegir entre “Verificar extensión” y “Verificar contenido del archivo”.

  • :guilabel:`Escanear el contenido de los archivos comprimidos(.zip) en el dock del navegador” selectString define cuan detallada es la información del widget en la parte inferior del panel del navegador cuando se consultan dichos archivos. “No”, “Escaneo básico” y “Escaneo completo” son las posibles opciones.

  • Solicitar subcapas raster al abrir. Algunas subcapas raster soportadas — se les llama subdataset en GDAL. Un ejemplo son los archivos netCDF — si hay muchos variables netCDF, GDAL ve cada variable como un subconjunto de datos. La opción le permite controlar cómo lidiar con subcapas cuando se abre un archivo con subcapas. Dispone de las siguientes opciones:

    • ‘Siempre’: Siempre preguntar (Si hay subcapas existentes)

    • ‘Si es necesario’: Preguntar si la capa no tiene bandas, pero tiene subcapas

    • ‘Nunca’: Nunca preguntar, no se cargará nada

    • ‘Cargar todo’: Nunca preguntar, pero cargar todas las subcapas

  • checkbox Ignorar la declaración de codificación del archivo de forma. Si un archivo de forma tiene información de codificación, QGIS lo ignorará.

  • checkbox Ejecute expresiones en el lado del servidor si es posible: al solicitar entidades de una fuente de datos, QGIS intentará optimizar las solicitudes enviando criterios de filtro directamente al servidor y solo descargará las entidades que coincidan con los criterios. Por ejemplo, si para una lista en la interfaz de usuario solo deben incluirse los agricultores que viven en Berna, QGIS enviará un WHERE "hometown" = 'Bern' a la base de datos. En algunos casos, los criterios de filtro son demasiado complejos para traducirlos de expresiones QGIS a SQL compatible con la base de datos. En esos casos, QGIS descargará todos los datos y los filtrará localmente para estar seguro, lo que es mucho menos eficaz.

    Al deshabilitar esta opción, QGIS puede verse obligado a descargar siempre todos los datos y filtrarlos localmente, a coste de una bajada de rendimiento. Esta opción es una interrupción de seguridad y solo debe desactivarse si identifica un mal comportamiento del motor de traducción de expresiones QGIS.

  • checkbox Evaluar valores predeterminados define si los valores predeterminados del proveedor de la base de datos deben calcularse al digitalizar la nueva función (estado verificado) o al guardar los cambios.

Ruta del navegador oculta

Este widget enumera todas las carpetas que eligió ocultar del Browser panel. Al eliminar una carpeta de la lista, estará disponible en el panel Browser.

Ajustes de Renderización

../../../_images/rendering_menu.png

La pestaña Renderización del diálogo de Propiedades del Proyecto

Comportamiento de presentación

  • checkbox Por defecto, deben mostrarse las nuevas capas agregadas al mapa: desmarcar esta opción puede ser útil al cargar varias capas para evitar que cada capa nueva se represente en el lienzo y ralentizar el proceso

  • checkbox Utilizar el cacheo de presentación en lo posible a la velocidad de regeneración

  • checkbox Representación de capas en paralelo utilizando muchos núcleos CPU

  • checkbox Máximo de núcleos a utilizar

  • Intervalo de actualización del mapa (por defecto 250 ms)

  • checkbox Habilitar simplificación de objetos espaciales por defecto a las nuevas capas añadidas

  • Simplificación del umbral

  • Algoritmo de simplificación: Esta opción realiza una simplificación local «sobre la marcha» en las funciones y acelera la representación de la geometría. No cambia la geometría obtenida de los proveedores de datos. Esto es importante cuando tiene expresiones que usan la geometría de la entidad (por ejemplo, cálculo del área): garantiza que estos cálculos se realicen en la geometría original, no en la simplificada. Para este propósito, QGIS proporciona tres algoritmos: “Distancia” (predeterminado), “SnapToGrid” y “Visvalingam”.

  • unchecked Simplifique del lado del proveedor si es posible: el proveedor simplifica las geometrías (PostGIS, Oracle …) y, a diferencia de la simplificación del lado local, los cálculos basados en la geometría pueden verse afectados

  • Escala máxima a la que la capa se debe simplificar

  • doubleSpinBox Nivel de Magnififcaión (Ver magnifier)

Nota

Además de la configuración global, se puede configurar la simplificación de características para cualquier capa específica desde su menú Propiedades de Capa ‣ Renderizado

Calidad de representación

  • checkbox Hacer que las líneas se muestren menos quebradas a expensas del rendimiento de la representación

Segmentación de curva

  • Tolerancia de segmentación: esta configuración controla la forma en que se representan los arcos circulares. EL menor ángulo máximo (entre los dos vértices consecutivos y el centro de la curva, en grados) o la diferencia máxima (distancia entre el segmento de los dos vértices y la línea de la curva, en unidades de mapa), los segmentos más rectos se usarán durante el renderizado.

  • Tipo de Tolerancia: puede ser Máximo ángulo o Maxima diferencia entre aproximación y curva.

Rásters

  • Con Selección de la banda RGB, puede definir el numero para la banda Roja, Verde y Azul.

  • Los métodos Muestreo ampliado” y los métodos :guilabel: Muestreo ampliado” se pueden definir. Para Zoom de remuestreo’puede elegir entre tres métodos de remuestreo:” Vecino más cercano “ , “Bilineal “ y “Cúbico”. Para :guilabel:`Muestreo alejado” puede elegir entre “Vecino más cercano” y “Promedio”. También puede establecer el valor :guilabel:`Sobremuestreo (entre 0.0 y 99.99; un valor grande significa más trabajo para QGIS; el valor predeterminado es 2.0).

Mejora de contraste

Las opciones de mejora de contraste se pueden aplicar a banda simple gris, color Multibanda (byte/banda) o color Multibanda(>byte/banda). Para cada uno, puede configurar:

  • el Algoritmo a usar, cuyos valores pueden ser “Sin estiramiento”, “Estirar a MinMax”, “Estirar y recortar a MinMax” o “Recortar a MinMax”

  • Los Limites(minimo/maximo) a plicar, con valores como “Corte de recuento de píxeles acumulativo”, “Mínimo/Máximo”, “Media +/- desviación estándar”.

Para representación ráster, puede además definir las siguientes opciones:

  • Límite para corte del conteo acumulativo de píxeles

  • Multiplicador de la desviación estándar

Depuración

  • checkbox Actualizado del lienzo de mapa para depurar la duración de representación en el panel Mensajes Log.

Ajustes de Lienzo y Leyenda

../../../_images/options_canvas_legend.png

Ajustes de Lienzo y Leyenda

Estas propiedades le permiten establecer:

  • Aspecto Preestablecido del mapa (anulado por las propiedades del proyecto): el Color de selección y :guilabel:` Color de fondo`.

  • Leyenda de Capa interacción:

    • : guilabel:Acción de doble click en la leyenda selectString. Puede hacer click en «Abrir propiedades de capa», «Abrir tabla de atributos» o «Abrir base de estilo de capa».

    • checkbox Mostrar nombres de atributos de clasificación en el panel Capas, p.ej. cuando aplique un renderizador categorizado o basado en reglas (consulte Propiedades de simbología para obtener más información).

    • the WMS getLegendGraphic Resolution

  • the Delay in milliseconds of layers map tips display

Ajustes de herramientas de mapa

../../../_images/options_map_tools.png

Ajustes de herramientas de mapa en QGIS

Esta pestaña ofrece algunas opciones con respecto al comportamiento de la :ref:`Identify tool `.

  • Search radius for identifying features and displaying map tips is a tolerance distance within which the identify tool will depict results as long as you click within this tolerance.

  • Highlight color allows you to choose with which color features being identified should be highlighted.

  • Buffer determines a buffer distance to be rendered from the outline of the identify highlight.

  • Minimum width determines how thick should the outline of a highlighted object be.

Herramienta de medición

  • Definir Color de la banda de medida para herramienta de medida

  • Definir Lugares decimales

  • checkbox Keep base unit to not automatically convert large numbers (e.g., meters to kilometers)

  • Preferred distance units: options are “Meters”, “Kilometers”, “Feet”, “Yards”, “Miles”, “Nautical Miles”, “Centimeters”, “Millimeters”, “Degrees” or “Map Units”

  • Preferred area units: options are “Square meters”, “Square kilometers”, “Square feet”, “Square yards”, “Square miles”, “Hectares”, “Acres”, “Square nautical miles”, “Square centimeters”, “Square millimeters”, “Square degrees” or “Map Units”

  • Preferred angle units: options are “Degrees”, “Radians”, “Gon/gradians”, “Minutes of arc”, “Seconds of arc”, “Turns/revolutions”, milliradians (SI definition) or mil (NATO/military definition)

Mover y zum

  • Define a Zoom factor for zoom tools or wheel mouse

Escalas predefinidas

Here, you find a list of predefined scales. With the signPlus and signMinus buttons you can add or remove your personal scales. You can also import or export scales from/to a .XML file. Note that you still have the possibility to remove your changes and reset to the predefined list.

Colors Settings

../../../_images/options_colors.png

Colors Settings

This menu allows you to create or update palettes of colors used throughout the application in the color selector widget. You can choose from:

  • Recent colors showing recently used colors

  • Standard colors, the default palette of colors

  • Project colors, a set of colors specific to the current project (see Default Styles Properties for more details)

  • New layer colors, a set of colors to use by default when new layers are added to QGIS

  • or custom palette(s) you can create or import using the button next to the palette combobox.

By default, Recent colors, Standard colors and Project colors palettes can not be removed and are set to appear in the color button drop-down. Custom palettes can also be added to this widget thanks to the Show in Color Buttons option.

For any of the palettes, you can manage the list of colors using the set of tools next to the frame, ie:

  • signPlus Add or signMinus Remove color

  • editCopy Copy or editPaste Paste color

  • fileOpen Import or fileSave Export the set of colors from/to .gpl file.

Double-click a color in the list to tweak or replace it in the Color Selector dialog. You can also rename it by double-clicking in the Label column.

Configuración de digitalización

../../../_images/options_digitizing.png

Digitizing Settings in QGIS

This tab helps you configure general settings when editing vector layer (attributes and geometry).

Creación de entidades espaciales

  • checkbox Suppress attribute form pop-up after feature creation: this choice can be overridden in each layer properties dialog.

  • checkbox Reuse last entered attribute values.

  • Validar geometrías. Editar lineas y polígonos complejos con muchos nodos puede resultar a una representación muy lenta. Esto se debe a los procesos de validación por defecto en QGIS puede tomar mucho tiempo. Para acelerar la representación, es posible seleccionar la validación de geometría GEOS (a partir de GEOS 3.3) o a pagarlo. La validación de geometría GEOS es mucho más rápido, pero la desventaja es que sólo el primer problema de geometría será reportado.

    Note that depending on the selection, reports of geometry errors may differ (see Tipos de mensajes de error y sus significados)

  • Default Z value to use when creating new 3D features.

Banda de medición

  • Define Rubberband Line width, Line color and Fill color.

  • Don’t update rubberband during vertex editing.

Autoensamblado

  • checkbox Enable snapping by default activates snapping when a project is opened

  • Define Default snap mode selectString (“Vertex”, “Vertex and segment”, “Segment”)

  • Definir Tolerancia de autoensamblado predeterminado en unidades de mapa o píxeles

  • Definir el Radio de búsqueda para edición de vértices en unidades de mapa o píxeles

  • Display main dialog as (restart required): set whether the Advanced Snapping dialog should be shown as “Dialog” or “Dock”.

  • Snapping marker color

  • checkbox Show snapping tooltips such as name of the layer whose feature you are about to snap. Helpful when multiple features overlap.

  • checkbox Enable snapping on invisible features (not shown on the map canvas)

Marcar vértices

  • checkbox Mostrar marcadores sólo para los objetos espaciales seleccionados

  • Definir vértice Estilo de marcador selectString (“Cruz” (predeterminado), “Círculo semitransparente” o “Nada”)

  • Define vertex Marker size (in millimeter)

Herramienta de desplazamiento de curva

The next 3 options refer to the offsetCurve Offset Curve tool in Digitalización avanzada. Through the various settings, it is possible to influence the shape of the line offset. These options are possible starting from GEOS 3.3.

  • Join style: “Round”, “Mitre” or “Bevel”

  • Segmentos del cuadrante

  • Límite Miter

Layouts Settings

../../../_images/options_layouts.png

Layouts Settings in QGIS

Predeterminados de la composición

You can define the Default font used within the print layout.

Apariencia de la cuadrícula

  • Definir el Estilo de cuadrícula selectString (“Sólido, “Puntos”, “Cruces”)

  • Definir el Color de la cuadrícula

Valores predeterminados de la cuadrícula y guía

  • Define the Grid spacing selectNumber

  • Define the Grid offset selectNumber for X and Y

  • Define the Snap tolerance selectNumber

Layout Paths

  • Define Path(s) to search for extra print templates: a list of folders with custom layout templates to use while creating new one.

Configuración de GDAL

GDAL is a data exchange library for vector and raster files. It provides drivers to read and or write data in different formats. The GDAL tab currently exposes the drivers for raster formats with their capabilities.

GDAL driver options

This frame provides ways to customize the behavior of drivers that support read and write access:

  • Edit create options: allows you to edit or add different profiles of file transformation, i.e. a set of predefined combinations of parameters (type and level of compression, blocks size, overview, colorimetry, alpha…) to use when outputting raster files. The parameters depend on the driver.

    ../../../_images/gdalCreateOptions.png

    Sample of create options profile (for GeoTiff)

    The upper part of the dialog lists the current profile(s) and allows you to add new ones or remove any of them. You can also reset the profile to its default parameters if you have changed them. Some drivers (eg, GeoTiff) have some sample of profiles you can work with.

    At the bottom of the dialog:

    • The signPlus button lets you add rows to fill with the parameter name and value

    • The signMinus button deletes the selected parameter

    • Click the Validate button to check that the creation options entered for the given format are valid

    • Use the Help button to find the parameters to use, or refer to the GDAL raster drivers documentation.

  • Edit Pyramids Options

    ../../../_images/gdalPyramidsOptions.png

    Sample of Pyramids profile

GDAL drivers

In this frame, you can define which GDAL driver is to use to read and/or write files, as in some cases more than one GDAL driver is available.

../../../_images/options_gdal.png

GDAL Settings in QGIS

Truco

Double-click a driver that allows read and write access (rw+(v)) opens the Edit Create options dialog for customization.

Variables Settings

The Variables tab lists all the variables available at the global-level.

It also allows the user to manage global-level variables. Click the signPlus button to add a new custom global-level variable. Likewise, select a custom global-level variable from the list and click the signMinus button to remove it.

More information about variables in the Storing values in Variables section.

../../../_images/options_variables_global.png

Variables Settings in QGIS

Authentication Settings

In the Authentication tab you can set authentication configurations and manage PKI certificates. See Sistema de autenticación for more details.

../../../_images/auth-editor-configs21.png

Authentication Settings in QGIS

Network Settings

General

  • Definir Dirección de búsqueda de WMS, por omisión es http://geopole.org/wms/search?search=\%1\&type=rss

  • Definir Expiró el tiempo para solicitudes de red - por omisión 60000

  • Define Default expiration period for WMS Capabilities (hours) - default is 24

  • Definir Periodo de expiración predeterminada para teselas WMS-C/WMTS (en horas) - por omisión 24

  • Define Max retry in case of tile or feature request errors

  • Definir Agente- Usuario

../../../_images/proxy-settings.png

Configurar proxy en QGIS

Configuración de caché

Defines the Directory and a Size for the cache. Also offers tools to automatically clear the connection authentication cache on SSL errors (recommended).

Proxy for web access

  • checkbox Use proxy for web access

  • Set the Proxy type selectString according to your needs and define “Host” and “Port”. Available proxy types are:

    • Default Proxy: Proxy is determined based on system’s proxy

    • Socks5Proxy: Proxy genérico para cualquier tipo de conexión. Soporta TCP, UDP, unión a un puerto (conexiones entrantes) y autenticación.

    • HttpProxy: Implementado con el comando «CONNECT», sólo admite conexiones TCP salientes; admite la autenticación.

    • HttpCachingProxy: Implementando el uso de comandos HTTP normales, es útil sólo en el contexto de peticiones HTTP.

    • FtpCachingProxy: Implementar el uso de un proxy FTP, es útil sólo en el contexto de las peticiones FTP.

Credentials of proxy are set using the authentication widget.

Excluding some URLs can be added to the text box below the proxy settings (see Figure_Network_Tab). No proxy will be used if the target url starts with one of the string listed in this text box.

If you need more detailed information about the different proxy settings, please refer to the manual of the underlying QT library documentation at https://doc.qt.io/qt-5.9/qnetworkproxy.html#ProxyType-enum

Truco

Utilizar proxies

Using proxies can sometimes be tricky. It is useful to proceed by “trial and error” with the above proxy types, to check if they succeed in your case.

Locator Settings

search The Locator tab allows to configure the Locator bar, a quick search widget available on the status bar that helps you perform searches anywhere in the application. It provides some default filters (with prefix) to use:

  • Project layers (l): finds and selects a layer in the Layers panel.

  • Project layouts (pl): finds and opens a print layout.

  • Actions (.): finds and executes a QGIS action; actions can be any tool or menu in QGIS, opening a panel…

  • Active layer features (f): searches for matching attributes in any field from the current active layer and zooms to the selected feature.

  • Features in all layers (af): searches for matching attributes in the display name of each searchable layers and zooms to the selected feature.

  • Calculator (=): allows evaluation of any QGIS expression and, if valid, gives an option to copy the result to the clipboard.

  • Spatial bookmarks (b): finds and zooms to the bookmark extent.

  • Settings (set): browses and opens project and application-wide properties dialogs.

  • Processing (a): searches and opens a Processing algorithm dialog.

  • Edit selected features (ef): gives quick access and runs a compatible modify-in-place Processing algorithm on the active layer.

For each filter, you can customize the filter, set whether it is enabled by default or not. The set of default locator filters can be extended by plugins, eg for OSM nominatim searches, direct database searching, layer catalog searches.

The locator search bar can be activated pressing Ctrl+K. Type your text to perform a search. By default, results are returned for all enabled locator filters but you can limit the search to a certain filter by prefixing your text with the locator filter prefix, ie. typing l cad will return only the layers whose name contains cad. Click on the result to execute the corresponding action, depending on the type of item.

Searching is handled using threads, so that results always become available as quickly as possible, regardless of whether any slow search filters may be installed. They also appear as soon as each result is encountered by each filter, which means that e.g. a file search filter will show results one by one as the file tree is scanned. This ensures that the UI is always responsive even if a very slow search filter is present (e.g. one which uses an online service).

Truco

Quick access to the locator’s configurations

Click on the search icon inside the locator widget on the status bar to display the list of filters you can use and a Configure entry that opens the Locator tab of the Settings ‣ Options… menu.

../../../_images/options_locator.png

Locator Settings in QGIS

Configuración avanzada

../../../_images/options_advanced.png

Advanced Settings tab in QGIS

All the settings related to QGIS (UI, tools, data providers, Processing configurations, default values and paths, plugins options, expressions, geometry checks…) are saved in a QGIS/QGIS3.ini file under the active user profile directory. Configurations can be shared by copying this file to other installations.

From within QGIS, the Advanced tab offers a way to manage these settings through the Advanced Settings Editor. After you promise to be careful, the widget is populated with a tree of all the existing settings, and you can edit their value. Right-click over a setting or a group and you can delete it (to add a setting or group, you have to edit the QGIS3.ini file). Changes are automatically saved in the QGIS3.ini file.

Advertencia

Avoid using the Advanced tab settings blindly

Be careful while modifying items in this dialog given that changes are automatically applied. Doing changes without knowledge can break your QGIS installation in various ways.

Acceleration Settings

OpenCL acceleration settings.

../../../_images/acceleration_menu.png

Acceleration tab

Processing Settings

The processing Processing tab provides you with general settings of tools and data providers that are used in the QGIS Processing framework. More information at Entorno de trabajo de procesamiento de QGIS.

../../../_images/options_processing.png

Pestaña configuración de procesamiento en QGIS

Working with User Profiles

The Settings ‣ User Profiles menu provides functions to set and access user profiles. A user profile is a unified application configuration that allows to store in a single folder:

  • all the global settings, including locale, projections, authentication settings, color palettes, shortcuts…

  • GUI configurations and customization

  • installed plugins and their configurations

  • project templates and history of saved project with their image preview

  • processing settings, logs, scripts, models.

By default, a QGIS installation contains a single user profile named default. But you can create as many user profiles as you want:

  1. Click the New profile… entry.

  2. You’ll be prompted to provide a profile name, creating a folder of the same name under ~/<UserProfiles>/ where:

    • ~ represents the HOME directory, which on win Windows is usually something like C:\Users\(user).

    • and <UserProfiles> represents the main profiles folder, i.e.:

      • nix .local/share/QGIS/QGIS3/profiles/

      • win AppData\Roaming\QGIS\QGIS3\profiles\

      • osx Library/Application Support/QGIS/QGIS3/profiles/

    The user profile folder can be opened from within QGIS using the Open Active Profile Folder.

  3. A new instance of QGIS is started, using a clean configuration. You can then set your custom configurations.

As each user profile contains isolated settings, plugins and history they can be great for different workflows, demos, users of the same machine, or testing settings, etc. And you can switch from one to the other by selecting them in the Settings ‣ User Profiles menu. You can also run QGIS with a specific user profile from the command line.

Unless changed, the profile of the last closed QGIS session will be used in the following QGIS sessions.

Truco

Run QGIS under a new user profile to check for bug persistence

When you encounter weird behavior with some functions in QGIS, create a new user profile and run the commands again. Sometimes, bugs are related to some leftovers in the current user profile and creating a new one may fix them as it restarts QGIS with the new (clean) profile.

Propiedades del proyecto

In the properties window for the project under Project ‣ Project Properties, you can set project-specific options. The project-specific options overwrite their equivalent in the Options dialog described above.

General Properties

In the General tab, the General settings let you:

  • see the location of the project file

  • set the folder for the project home (available in the Project Home item in the browser). The path can be relative to the folder of the project file (type it in) or absolute. The project home can be used for storing data and other content that is useful for the project.

  • dé un texto al título del proyecto aparte de la ruta del archivo del proyecto

  • escoge el color a usar para objetos espaciales cuando son seleccionados

  • escoger el color de fondo: el color a usar para la tela de fondo del mapa

  • set whether the path to layers in the project should be saved as absolute (full) or as relative to the project file location. You may prefer relative path when both layers and project files can be moved or shared or if the project is accessed from computers on different platforms.

  • choose to avoid artifacts when project is rendered as map tiles. Note that checking this option can lead to performance degradation.

Calculating areas and distances is a common need in GIS. However, these values are really tied to the underlying projection settings. The Measurements frame lets you control these parameters. You can indeed choose:

  • the Ellipsoid, on which distance and area calculations are entirely based; it can be:

    • None/Planimetric: returned values are in this case cartesian measurements.

    • a Custom one: you’ll need to set values of the semi-major and semi-minor axes.

    • or an existing one from a predefined list (Clarke 1866, Clarke 1880 IGN, New International 1967, WGS 84…).

  • the units for distance measurements for length and perimeter and the units for area measurements. These settings, which default to the units set in QGIS options but then overrides it for the current project, are used in:

    • Attribute table field update bar

    • Cálculos de calculadora de campo

    • Identify tool derived length, perimeter and area values

    • Default unit shown in measure dialog

The Coordinate display allows you to choose and customize the format of units to use to display the mouse coordinate in the status bar and the derived coordinates shown via the identify tool.

Finally, you can set a Project predefined scales list, which overrides the global predefined scales.

../../../_images/project_general.png

General tab of the Project Properties dialog

Propiedades de metadatos

The Metadata tab allows detailed metadata to be defined, including (among the others): author, creation date, language, abstracts, categories, keywords, contact details, links, history. There is also a validation functionality that checks if specific fields were filled, anyway this is not enforced. See vector layer metadata properties for some details.

CRS Properties

Nota

For more information on how QGIS handles project projection, please read the dedicated section at Trabajar con Proyecciones.

The crs CRS tab helps you set the coordinate reference system to use in this project. It can be:

  • checkbox No projection (or unknown/non-Earth projection): layers are drawn based on their raw coordinates

  • or an existing coordinate reference system that can be geographic, projected or user-defined. Layers added to the project are translated on-the-fly to this CRS in order to overlay them regardless their original CRS.

The crs CRS tab also helps you control the layers reprojection settings by configuring the datum transformation preferences to apply in the current project. As usual, these override any corresponding global settings. See Datum Transformations for more details.

Default Styles Properties

The Default Styles tab lets you control how new layers will be drawn in the project when they do not have an existing .qml style defined. You can:

  • Set default symbols (Marker, Line, Fill) to apply depending on the layer geometry type as well as a default Color Ramp

  • Apply a default Opacity to new layers

  • checkbox Assign random colors to symbols, modifying the symbols fill colors, hence avoiding same rendering for all layers.

../../../_images/project_default_styles.png

Default Styles tab

Using the styleManager Style Manager button, you can also quickly access the Style Manager dialog and configure symbols and color ramps.

There is also an additional section where you can define specific colors for the running project. Like the global colors, you can:

  • signPlus Add or signMinus Remove color

  • editCopy Copy or editPaste Paste color

  • fileOpen Import or fileSave Export the set of colors from/to .gpl file.

Double-click a color in the list to tweak or replace it in the Color Selector dialog. You can also rename it by double-clicking in the Label column.

These colors are identified as Project colors and listed as part of color widgets.

Truco

Use project colors to quickly assign and update color widgets

Project colors can be refered to using their label and the color widgets they are used in are bound to them. This means that instead of repeatedly setting the same color for many properties and, to avoid a cumbersome update you can:

  1. Define the color as a project color

  2. Click the data defined override widget next to the color property you want to set

  3. Hover over the Color menu and select the project color. The property is then assigned the expression project_color('color_label') and the color widget reflects that color.

  4. Repeat steps 2 and 3 as much as needed

  5. Update the project color once and the change is reflected EVERYWHERE it’s in use.

Data Sources Properties

In the Data Sources tab, you can:

  • unchecked Automatically create transaction groups where possible: When this mode is turned on, all (postgres) layers from the same database are synchronised in their edit state, i.e. when one layer is put into edit state, all are, when one layer is committed or one layer is rolled back, so are the others. Also, instead of buffering edit changes locally, they are directly sent to a transaction in the database which gets committed when the user clicks save layer. Note that you can (de)activate this option only if no layer is being edited in the project.

  • unchecked Evaluate default values on provider side: When adding new features in a PostgreSQL table, fields with default value constraint are evaluated and populated at the form opening, and not at the commit moment. This means that instead of an expression like nextval('serial'), the field in the Add Feature form will display expected value (e.g., 25).

  • unchecked Trust project when data source has no metadata: To speed up project loading by skipping data checks. Useful in QGIS Server context or in projects with huge database views/materialized views. The extent of layers will be read from the QGIS project file (instead of data sources) and when using the PostgreSQL provider the primary key unicity will not be checked for views and materialized views.

  • Configure the Layers Capabilities, i.e.:

    • Set (or disable) which layers are identifiable, i.e. will respond to the identify tool. By default, layers are set queryable.

    • Set whether a layer should appear as read-only, meaning that it can not be edited by the user, regardless of the data provider’s capabilities. Although this is a weak protection, it remains a quick and handy configuration to avoid end-users modifying data when working with file-based layers.

    • Define which layers are searchable, i.e. could be queried using the locator widget. By default, layers are set searchable.

    • Define which layers are defined as required. Checked layers in this list are protected from inadvertent removal from the project.

    The Layers Capabilities table provides some convenient tools to:

    • Select multiple cells and press Toggle Selection to have them change their checkbox state;

    • unchecked Show spatial layers only, filtering out non-spatial layers from the layers list;

    • search Filter layers… and quickly find a particular layer to configure.

../../../_images/project_datasources.png

Data Sources tab

Relations Properties

El panel:guilabel:Relaciones es utilizado para definir relaciones 1:n. Las relaciones están definidas en el diálogo de propiedades del proyecto. Una vez que existen las relaciones de una capa, un nuevo elemento de la interfaz de usuario en la vista del formulario (por ejemplo al identificar un elemento espacial y abrir el formulario) mostrará una lista de las entidades relacionadas. Este proporciona un poderosa forma para expresar, por ejemplo la inspección de la longitud de una tubería o el segmento de carretera. Se puede encontrar más información acerca de relaciones 1:n y soporte en la sección Creating one or many to many relations.

../../../_images/project_relations.png

Relations tab

Propiedades de variables

The Variables tab lists all the variables available at the project’s level (which includes all global variables). Besides, it also allows the user to manage project-level variables. Click the signPlus button to add a new custom project-level variable. Likewise, select a custom project-level variable from the list and click the signMinus button to remove it. More information on variables usage in the General Tools Storing values in Variables section.

Macros Properties

The Macros tab is used to edit Python macros for projects. Currently, only three macros are available: openProject(), saveProject() and closeProject().

../../../_images/macro.png

Definición macro en QGIS

Propiedades de servidor QGIS

The tab QGIS Server allows you to configure your project in order to publish it online. Here you can define information about the QGIS Server WMS and WFS capabilities, extent and CRS restrictions. More information available in section Configure your project and subsequent.

../../../_images/project_qgisserver.png

Pestaña de ajustes de servidor QGIS

Personalización

The customization dialog lets you (de)activate almost every element in the QGIS user interface. This can be very useful if you want to provide your end-users with a “light” version of QGIS, containing only the icons, menus or panels they need.

Nota

Antes de aplicar los cambios, debe reiniciar QGIS.

../../../_images/customization.png

El diálogo de Personalización

Ticking the checkbox Enable customization checkbox is the first step on the way to QGIS customization. This enables the toolbar and the widget panel from which you can uncheck and thus disable some GUI items.

The configurable item can be:

With select Switch to catching widgets in main application, you can click on an item in QGIS interface that you want to be hidden and QGIS automatically unchecks the corresponding entry in the Customization dialog. You can also use the Search box to find items by their name or label.

Once you setup your configuration, click Apply or OK to validate your changes. This configuration becomes the one used by default by QGIS at the next startup.

The modifications can also be saved in a .ini file using fileSave Save To File button. This is a handy way to share a common QGIS interface among multiple users. Just click on fileOpen Load from File from the destination computer in order to import the .ini file. You can also run command line tools and save various setups for different use cases as well.

Truco

Easily restore predefined QGIS

The initial QGIS GUI configuration can be restored by one of the methods below:

  • unchecking checkbox Enable customization option in the Customization dialog or click the selectAllTree Check All button

  • pressing the Reset button in the QSettings frame under Settings ‣ Options menu, System tab

  • launching QGIS at a command prompt with the following command line qgis --nocustomization

  • setting to false the value of UI ‣ Customization ‣ Enabled variable under Settings ‣ Options menu, Advanced tab (see the warning).

In most cases, you need to restart QGIS in order to have the change applied.

Atajos de teclado

QGIS provides default keyboard shortcuts for many features. You can find them in section Barra de Menú. Additionally, the menu option Settings ‣ keyboardShortcuts Keyboard Shortcuts… allows you to change the default keyboard shortcuts and add new ones to QGIS features.

../../../_images/shortcuts.png

Define shortcut options

Configuration is very simple. Use the search box at the top of the dialog to find a particular action, select it from the list and click on :

  • Change and press the new combination you want to assign as new shortcut

  • Set None to clear any assigned shortcut

  • or Set Default to backup the shortcut to its original and default value.

Proceed as above for any other tools you wish to customize. Once you have finished your configuration, simply Close the dialog to have your changes applied. You can also Save the changes as an .XML file and Load them into another QGIS installation.

Running QGIS with advanced settings

Command line and environment variables

We’ve seen that launching QGIS is done as for any application on your OS. QGIS provides command line options for more advanced use cases (in some cases you can use an environment variable instead of the command line option). To get a list of the options, enter qgis --help on the command line, which returns:

QGIS is a user friendly Open Source Geographic Information System.
Usage: /usr/bin/qgis.bin [OPTION] [FILE]
  OPTION:
        [--version]     display version information and exit
        [--snapshot filename]   emit snapshot of loaded datasets to given file
        [--width width] width of snapshot to emit
        [--height height]       height of snapshot to emit
        [--lang language]       use language for interface text (changes existing override)
        [--project projectfile] load the given QGIS project
        [--extent xmin,ymin,xmax,ymax]  set initial map extent
        [--nologo]      hide splash screen
        [--noversioncheck]      don't check for new version of QGIS at startup
        [--noplugins]   don't restore plugins on startup
        [--nocustomization]     don't apply GUI customization
        [--customizationfile path]      use the given ini file as GUI customization
        [--globalsettingsfile path]     use the given ini file as Global Settings (defaults)
        [--authdbdirectory path] use the given directory for authentication database
        [--code path]   run the given python file on load
        [--defaultui]   start by resetting user ui settings to default
        [--hide-browser]        hide the browser widget
        [--dxf-export filename.dxf]     emit dxf output of loaded datasets to given file
        [--dxf-extent xmin,ymin,xmax,ymax]      set extent to export to dxf
        [--dxf-symbology-mode none|symbollayer|feature] symbology mode for dxf output
        [--dxf-scale-denom scale]       scale for dxf output
        [--dxf-encoding encoding]       encoding to use for dxf output
        [--dxf-map-theme maptheme]      map theme to use for dxf output
        [--take-screenshots output_path]        take screen shots for the user documentation
        [--screenshots-categories categories]   specify the categories of screenshot to be used (see QgsAppScreenShots::Categories).
        [--profile name]        load a named profile from the user's profiles folder.
        [--profiles-path path]  path to store user profile folders. Will create profiles inside a {path}\profiles folder
        [--version-migration]   force the settings migration from older version if found
        [--openclprogramfolder]         path to the folder containing the sources for OpenCL programs.
        [--help]                this text
        [--]            treat all following arguments as FILEs

  FILE:
    Files specified on the command line can include rasters,
    vectors, and QGIS project files (.qgs and .qgz):
     1. Rasters - supported formats include GeoTiff, DEM
        and others supported by GDAL
     2. Vectors - supported formats include ESRI Shapefiles
        and others supported by OGR and PostgreSQL layers using
        the PostGIS extension

Truco

Example Using command line arguments

You can start QGIS by specifying one or more data files on the command line. For example, assuming you are in the qgis_sample_data directory, you could start QGIS with a vector layer and a raster file set to load on startup using the following command: qgis ./raster/landcover.img ./gml/lakes.gml

--version

This option returns QGIS version information.

--snapshot

This option allows you to create a snapshot in PNG format from the current view. This comes in handy when you have many projects and want to generate snapshots from your data, or when you need to create snapshots of the same project with updated data.

Currently, it generates a PNG file with 800x600 pixels. The size can be adjusted using the --width and --height arguments. The filename can be added after --snapshot. For example:

qgis --snapshot my_image.png --width 1000 --height 600 --project my_project.qgs

--width

This option returns the width of the snapshot to be emitted (used with --snapshot).

--height

This option returns the height of the snapshot to be emitted (used with --snapshot).

--lang

Based on your locale, QGIS selects the correct localization. If you would like to change your language, you can specify a language code. For example, qgis --lang it starts QGIS in Italian localization.

--project

Starting QGIS with an existing project file is also possible. Just add the command line option --project followed by your project name and QGIS will open with all layers in the given file loaded.

--extent

To start with a specific map extent use this option. You need to add the bounding box of your extent in the following order separated by a comma:

--extent xmin,ymin,xmax,ymax

This option probably makes more sense when paired with the --project option to open a specific project at the desired extent.

--noversioncheck

Skip searching for a new version of QGIS at startup.

--noplugins

If you have trouble at start-up with plugins, you can avoid loading them at start-up with this option. They will still be available from the Plugins Manager afterwards.

--nocustomization

Using this option, any existing GUI customization will not be applied at startup. This means that any hidden buttons, menu items, toolbars, and so on, will show up on QGIS start up. This is not a permanent change. The customization will be applied again if QGIS is launched without this option.

This option is useful for temporarily allowing access to tools that have been removed by customization.

--customizationfile

Using this option, you can define a UI customization file, that will be used at startup.

--globalsettingsfile

Using this option, you can specify the path for a Global Settings file (.ini), also known as the Default Settings. The settings in the specified file replace the original inline default ones, but the user profiles” settings will be set on top of those. The default global settings is located in your_QGIS_PKG_path/resources/qgis_global_settings.ini.

Presently, there’s no way to specify a file to write settings to; therefore, you can create a copy of an original settings file, rename, and adapt it.

Setting the qgis_global_setting.ini file path to a network shared folder, allows a system administrator to change global settings and defaults in several machines by only editing one file.

The equivalent environment variable is QGIS_GLOBAL_SETTINGS_FILE.

--authdbdirectory

This option is similar to --globalsettingsfile, but defines the path to the directory where the authentication database will be stored and loaded.

--code

This option can be used to run a given python file directly after QGIS has started.

For example, when you have a python file named load_alaska.py with following content:

from qgis.utils import iface
raster_file = "/home/gisadmin/Documents/qgis_sample_data/raster/landcover.img"
layer_name = "Alaska"
iface.addRasterLayer(raster_file, layer_name)

Assuming you are in the directory where the file load_alaska.py is located, you can start QGIS, load the raster file landcover.img and give the layer the name “Alaska” using the following command:

qgis --code load_alaska.py

--defaultui

On load, permanently resets the user interface (UI) to the default settings. This option will restore the panels and toolbars visibility, position, and size. Unless it’s changed again, the default UI settings will be used in the following sessions.

Notice that this option doesn’t have any effect on GUI customization. Items hidden by GUI customization (e.g. the status bar) will remain hidden even using the --defaultui option. See also the --nocustomization option.

--hide-browser

On load, hides the Browser panel from the user interface. The panel can be enabled by right-clicking a space in the toolbars or using the View ‣ Panels (Settings ‣ Panels in kde Linux KDE).

Unless it’s enabled again, the Browser panel will remain hidden in the following sessions.

--dxf-*

These options can be used to export a QGIS project into a DXF file. Several options are available:

  • –dxf-export: the DXF filename into which to export the layers;

  • –dxf-extent: the extent of the final DXF file;

  • –dxf-symbology-mode: several values can be used here: none (no symbology), symbollayer (Symbol layer symbology), feature (feature symbology);

  • –dxf-scale-denom: the scale denominator of the symbology;

  • –dxf-encoding: the file encoding;

  • –dxf-map-theme: choose a map theme from the layer tree configuration.

--take-screenshots

Takes screenshots for the user documentation. Can be used together with --screenshots-categories to filter which categories/sections of the documentation screenshots should be created (see QgsAppScreenShots::Categories).

--profile

Loads QGIS using a specific profile from the user’s profile folder. Unless changed, the selected profile will be used in the following QGIS sessions.

--profiles-path

With this option, you can choose a path to load and save the profiles (user settings). It creates profiles inside a {path}\profiles folder, which includes settings, installed plugins, processing models and scripts, and so on.

This option allows you to, for instance, carry all your plugins and settings in a flash drive, or, for example, share the settings between different computers using a file sharing service.

The equivalent environment variable is QGIS_CUSTOM_CONFIG_PATH.

--version-migration

If settings from an older version are found (e.g., the .qgis2 folder from QGIS 2.18), this option will import them into the default QGIS profile.

--openclprogramfolder

Using this option, you can specify an alternative path for your OpenCL programs. This is useful for developers while testing new versions of the programs without needing to replace the existing ones.

The equivalent environment variable is QGIS_OPENCL_PROGRAM_FOLDER.

Deploying QGIS within an organization

If you need to deploy QGIS within an organization with a custom configuration file, first you need to copy/paste the content of the default settings file located in your_QGIS_PKG_path/resources/qgis_global_settings.ini. This file already contains some default sections identified by a block starting with []. We recommend that you keep these defaults values and add your own sections at the bottom of the file. If a section is duplicated in the file, QGIS will take the last one from top to bottom.

You can change allowVersionCheck=false to disable the QGIS version check.

If you do not want to display the migration window after a fresh install, you need the following section:

[migration]
fileVersion=2
settings=true

If you want to add a custom variable in the global scope:

[variables]
organisation="Your organization"

To discover the possibilities of the settings INI file, we suggest that you set the config you would like in QGIS Desktop and then search for it in your INI file located in your profile using a text editor. A lot of settings can be set using the INI file such as WMS/WMTS, PostGIS connections, proxy settings, maptips…

Finally, you need to set the environment variable QGIS_GLOBAL_SETTINGS_FILE to the path of your customized file.

In addition, you can also deploy files such as Python macros, color palettes, layout templates, project templates… either in the QGIS system directory or in the QGIS user profile.

  • Layout templates must be deployed in the composer_templates directory.

  • Project templates must be deployed in the project_templates directory.

  • Custom Python macros must be deployed in the python directory.