4. Salidas no espaciales

Introducción

Cuando pensamos en las herramientas de processing, no podemos olvidar que muchos de los resultados no necesariamente tienen referencia espacial. Processing R Provider cuenta también con parámetros de entrada y salida de datos no espaciales. En esta entrada nos concentraremos en los parámetros de salida que no son objetos espaciales. Nos referimos a salidas que no presentan ningún aspecto espacial (vector o raster), como por ejemplo, salidas en formato *.csv, gráficos estáticos o interactivos, como también salidas de valores numéricos y de carácteres.

Tipos de parámetros con salida no espacial.

Recordando el listado que vimos en la primera lectura, podemos decir que los parámetros de salida no espacial son muchos: table, string, number, folder y file. Pero a estos también debemos agregar los gráficos (RPLOTS) y la consola (R_CONSOLE_OUTPUT). Empecemos viendo algunas particularidades de este grupo de parámetros.

Tablas

Un script R permite devolver una tabla a la proyecto de QGIS mediante el argumento table. Esta salida requiere que después de ejecutar todo el script, el objeto Tabla sea un objeto de clase "data.frame". La línea del parámetro de salida sería:

1##Tabla=output table

String y Number

En el caso de estos dos parámetros, no hay salida que se devuelva al panel de capas en QGIS. El resultado es una lista de python de clase QgsList. Los valores que devuelven mediante estas salidas, pueden ser reutilizados en otras salidas o herramientas.

1##String=output string
2##Number=output number

Después de ejecutar todo el script, el objeto String debe ser de clase "character" mientras que el objeto Number debería ser de clase "numeric". Un ejemplo de este tipo de salidas se puede ver en el script que se llama "Min_Max", incluido en la instalación del plugin. En la imagen a continuación verás un ejemplo de uso de este script en el modelador.

Gráficos y Consola

Estos dos son casos especiales de salida. Permiten la exportación de gráficos y consola a un fichero html. Aunque de cierta manera también están disponibles los ficheros de imagen (gráficos) o de texto (consola). La especificación difiere de un típico parámetro de salida, porque estos son más bien parámetros de comportamiento que generan salidas.

1##output_plots_to_html
2> mean(x)

Los gráficos dependen del parámetro output_plots_to_html, mientras que el registro en la consola depende de que una línea del cuerpo del script empiece con el caracter >. De esta manera se generarán las interfaces para guardar las salidas correspondientes. En el caso de la salida a la consola, es necesario que la línea de código de R ejecute el método print.*() en alguna de sus formas.

Ficheros y Directorios

Estos dos últimos parámetros de salida se comportan de forma similar a los parámetros de entrada. Es decir que retornan a la sesión de R las rutas de los ficheros o directorios definidos mediante la interfaz gráfica. Estos pueden ser reutilizados dentro del script como cualquier objeto de texto que contenga una ruta.

La especificación de estos parámetros es la siguiente:

1##Work_dir=Output folder
2##Stat_file=Output file csv
3
4setwd(Work_dir)
5...
6write.csv2(Summary_statistics, Stat_file, row.names = FALSE, na ="")

Ejemplos

En los siguientes ejemplos veremos todas las configuraciones que deberías de considerar para poder obtener estas salidas mencionadas anteriormente.

Salida en formato tabular (csv,txt)

Este script indentifica todo las vías de acceso con su respectivo nivel de peligro. El resultado es un csv y se mostrará por defecto en el panel de capas.

 1##Taller UseR!2022=group
 2##Cálculo de afectación=Name
 3##Raster_de_peligro=raster
 4##Capa_de_lineas=vector
 5##Resultados_tabulares=output table
 6
 7library(tidyverse)
 8library(stars)
 9
10peligro <- st_as_stars(Raster_de_peligro) %>% 
11  st_as_sf() 
12lineas <- Capa_de_lineas %>%
13  rename_if(stringr::str_detect(names(.), "geom$"), ~paste0(.,"etry"))
14lineas_intersect <- st_intersection(
15  lineas,
16  peligro
17) %>%
18  dplyr::mutate(afectacion_km = as.vector(st_length(geometry))/1000) %>%
19  st_drop_geometry() %>%
20  rename(peligro = peligro.tif)  %>%
21  dplyr::mutate(
22    peligro = case_when(
23      peligro == 1 ~ "bajo", peligro == 2 ~ "medio", peligro == 3 ~ "alto",
24      peligro == 4 ~ "muy alto", peligro == 5 ~ "extremo"
25    )
26  )
27
28Resultados_tabulares <-  lineas_intersect %>% 
29  group_by(Recep_clas,peligro) %>% 
30  summarise(afectacion_km = sum(afectacion_km))

Salida de valores númericos y de carácteres

Este script indentifica los valores máximos y mínimos de un raster. El resultado se presentará mediante un diccionario dentro de QGIS. Esta herramienta es similar a la función raster_statistic de la calculadora de campos.

 1##Taller UseR!2022=group
 2##MinMaxRaster=name
 3##Layer=raster
 4##Min=output number
 5##Max=output number
 6##Summary=output string
 7
 8Min <- minValue(Layer)
 9Max <- maxValue(Layer)
10Summary <- paste("El valor mínimo es: ",Min, " y el máximo: ", Max, sep = "")

Ejercicio: Agregando salidas no espaciales a scripts

La práctica de esta lectura consiste en agregar líneas de encabezados o modificar scripts para desplegar parámetros de salida de las herramientas hechas con R. ¡Empecemos!

1. Edita el script "Cálculo de afectación" y agrega la línea de encabezado que falta para desplegar el gráfico que está en el código del script.
2. Edita el script "Mínimo y Máximo" para que imprima en el registro de consola los resultados de las tres líneas de código.
3. Revisa y comenta al resto de los participantes sobre encabezado del script "Making a ggplot2 interactively".

Traducciones:

• "English" |