Exportaciones¶

Esta página le indica cómo sacar datos e informes de LUC Analytics (LUCA), y cuándo no está disponible cada exportación.

En esta página, un control o una etiqueta de la aplicación está en negrita. Un mensaje de la aplicación está entre "comillas dobles".

Resumen de las exportaciones¶

Exportación	Dónde está el control	Formato	Nombre del archivo
Resultados de la lista, posterior a 2020	El menú ⋯ de la lista en la página de listas, elemento Exportar	CSV	`<list name> - post2020.csv`
Resultados de la lista, posterior a 2020	La pestaña EVALUACIÓN DE RIESGO POSTERIOR A 2020 de una lista, botón ⬇ Descargar CSV	CSV	`<list name> - post2020.csv`
Resultados de la lista, alertas	La pestaña ALERTAS RECIENTES DE PERTURBACIÓN de una lista, botón ⬇ Descargar CSV	CSV	`<list name> - alerts.csv`
Una ubicación	El panel Detalles de la ubicación, botón ⬇ Descargar CSV	CSV	`<list name> - location <id> detail.csv`
Informe de una ubicación	El panel Detalles de la ubicación, botón Descargar PDF	PDF	`location-<id>-report.pdf`
Datos usados	Viene con cada exportación CSV, como un segundo archivo	CSV	`<CSV name>.data-used.csv`
Plantilla de la leyenda del mapa	La leyenda del mapa, Plantillas de mapa guardadas, botón Guardar	`.mpky` (JSON)	`mapkey_0001.mpky` o el nombre que usted escribe

Si el nombre de la lista no da un nombre de archivo que se pueda usar, la aplicación usa el ID de la lista, por ejemplo list-<list id>-post2020.csv o location-<id>-detail.csv. La aplicación reemplaza los caracteres que Windows, macOS o Linux no permiten en un nombre de archivo.

Cuándo está disponible una exportación¶

El navegador y el servidor hacen cada uno una comprobación antes de una exportación. Las dos comprobaciones usan la misma regla:

Una exportación de una lista completa está disponible solo cuando el análisis de la lista está completo.
Una exportación de una ubicación está disponible solo cuando el análisis de esa ubicación está terminado.

Exportación	Condición necesaria
CSV de la lista y su archivo de datos usados (Exportar y los dos botones ⬇ Descargar CSV)	El estado de la lista es completo. Antes, la información sobre herramientas (tooltip) muestra "La exportación CSV estará disponible cuando finalice el análisis de esta lista."
CSV de la ubicación y su archivo de datos usados	Cada análisis de la lista está terminado para esa ubicación.
PDF de la ubicación	El análisis posterior a 2020 de esa ubicación está terminado. El mapa también debe estar listo para la captura.

Estos son los resultados de las comprobaciones:

No puede exportar el CSV de una lista que no está completa. Una lista con la etiqueta Incompleta (por ejemplo, después de Detener y confirmar) se queda en esta condición. Para una lista así, exporte cada ubicación terminada.
Puede descargar el CSV o el PDF de una ubicación terminada. Las otras ubicaciones de la lista no tienen que estar terminadas.
El PDF de una ubicación de una lista que no está completa tiene una nota, por ejemplo "Informe generado a partir de una lista parcialmente analizada: 40/50 ubicaciones analizadas (80%)". Si la aplicación no puede contar las ubicaciones, la nota es "Informe generado a partir de una lista parcialmente analizada: no se pudo confirmar el número de ubicaciones analizadas".
La aplicación no escribe un cero en lugar de un valor que no calculó. No hay ninguna forma de anular estas comprobaciones.

Si el servidor rechaza una exportación, la aplicación muestra uno de estos mensajes:

"Exportación no disponible — aún no se ha analizado ninguna ubicación de esta lista, por lo que no hay nada para exportar."
"La exportación CSV estará disponible cuando finalice el análisis de esta lista."
"Exportación no disponible — el análisis de esta ubicación aún no ha finalizado. La exportación estará disponible cuando todos sus análisis estén completos."
"Exportación PDF no disponible: aún no se ha analizado ninguna ubicación de esta lista."

Para más información sobre los estados del análisis, consulte 03-analysis-and-results.md.

Exportar los resultados de una lista como CSV¶

Puede iniciar la exportación posterior a 2020 desde la página de listas o desde la lista. Los dos controles dan el mismo archivo.

Desde la página de listas:

Vaya a la página de listas (Listas).
En la fila de la lista, pulse ⋯.
Seleccione Exportar.

Desde la lista:

Abra la lista.
Seleccione la pestaña EVALUACIÓN DE RIESGO POSTERIOR A 2020 o la pestaña ALERTAS RECIENTES DE PERTURBACIÓN.
Si usa la pestaña de alertas, defina las fechas de las alertas en el chip de fechas Alertas. El CSV usa las mismas fechas.
Pulse ⬇ Descargar CSV.

El navegador descarga dos archivos: el CSV y su archivo de datos usados. Para el archivo de datos usados, consulte "El archivo de datos usados" más abajo.

Contenido del CSV posterior a 2020¶

El CSV tiene una fila para cada ubicación. Las columnas son:

La identidad de la ubicación: location_id, location_name, load_order, status, centroid_lat, centroid_lon.
La fecha del análisis y la versión del conjunto de datos: post2020_analysis_date, post2020_dataset_version.
Las superficies en hectáreas: total_area_ha, sbtn_area_ha, jrc_area_ha, y los indicadores sbtn_flag y jrc_flag.
La pérdida después de 2020 para cada mapa base de bosque: sbtn_loss_ha_post2020, jrc_loss_ha_post2020. También hay una columna para cada año de pérdida, por ejemplo sbtn_loss_ha_2021.
Los factores de pérdida de cobertura arbórea: una columna driver_<name>_ha para cada factor. Después, dominant_driver, dominant_share, dominant_is_mixed y dominant_is_none.
Los errores: error_code y explanation.
El estado: finished_state, list_status, list_locations_computed, list_locations_total.

Contenido del CSV de alertas¶

El CSV de alertas tiene una fila para cada ubicación. Tiene las mismas columnas de identidad, superficie, error y estado que el CSV posterior a 2020. También tiene estas columnas: alerts_analysis_date, alerts_dataset_version, alert_area_ha, alert_sbtn_area_ha, alert_jrc_area_ha, window_start y window_end. Las dos columnas de ventana muestran las fechas de las alertas que cuenta el archivo.

Exportar una ubicación como CSV¶

Abra la lista.
En la fila de la ubicación, pulse DETALLES. Se abre el panel Detalles de la ubicación.
Pulse ⬇ Descargar CSV.

El CSV tiene una fila. Contiene las columnas de identidad, superficie, pérdida y factores del CSV posterior a 2020, y las columnas de alertas del CSV de alertas. También contiene la columna annotation, que es su nota sobre la ubicación. El navegador también descarga el archivo de datos usados de esa ubicación.

Descargar un informe PDF de una ubicación¶

Abra la lista.
En la fila de la ubicación, pulse DETALLES.
Espere hasta que el mapa del panel Detalles de la ubicación está dibujado por completo.
Pulse Descargar PDF.

Antes de crear el PDF, la aplicación espera las teselas del mapa base y las capas de análisis. Si no están listas, la aplicación no crea el archivo. Muestra un mensaje que le indica la causa. Por ejemplo: "Exportación PDF no disponible: aún se espera: la carga de las teselas del mapa base (6 de 9 cargadas). Espere e inténtelo de nuevo."

El PDF está en horizontal. Contiene estos elementos:

Un título: el nombre y el ID de la ubicación.
Una nota, solo si la lista no está completa. La nota da el número de ubicaciones terminadas. Consulte "Cuándo está disponible una exportación" más arriba.
Dos imágenes de mapa: "Límite sobre mapa base" y "Límite + capas de análisis activas sobre mapa base".
"Configuración de capas usada para estas imágenes". Esta parte da el color y la opacidad de cada capa, los años de pérdida, las fechas de las alertas y la resolución del mapa.
Los detalles de la ubicación: el nombre, la superficie y sus notas.
La tabla de pérdida de bosque de cada año, para el mapa base SBTN y el mapa base JRC.
Las alertas, si la lista tiene el análisis de alertas.
Los factores de pérdida de cobertura arbórea, como un gráfico circular con una leyenda. Si no hay datos de factores, el PDF lo indica.
"Datos usados": los conjuntos de datos y sus versiones.
"Cómo citar los datos": el texto de atribución.

NOTA: Las imágenes de mapa pueden ser mayores que en la pantalla. Entonces, el PDF le indica la escala, por ejemplo "Paneles de mapa escalados ×2.00 de la resolución en pantalla para este informe."

Para los controles del mapa que cambian las imágenes, consulte 04-maps.md.

El archivo de datos usados¶

Cada exportación CSV viene con un segundo archivo. Su nombre es el nombre del CSV con .data-used.csv en lugar de .csv. Contiene una fila para cada conjunto de datos de origen, con estas columnas: dataset, version_id, date, date_kind, local_or_s3, profile, currency_at_run, hash, location.

Si el análisis se ejecutó antes de que la aplicación registrara las fechas de los conjuntos de datos, el archivo tiene una fila con el texto vigencia no registrada.

El CSV puede descargarse cuando el archivo de datos usados no se descarga. Entonces, la aplicación muestra "El CSV se descargó, pero su archivo complementario «Datos usados» (las fechas de los conjuntos de datos de origen) no se pudo descargar." Pulse el botón otra vez para obtener los dos archivos.

Formato de los archivos CSV¶

El texto es UTF-8 con una marca de orden de bytes (BOM). Las líneas terminan con CR LF.
Las primeras líneas son el texto de atribución. Cada una de estas líneas empieza con #. La fila de encabezados de la tabla viene después.
Los números no tienen separador de miles. Las superficies tienen un máximo de 4 decimales.
Una celda está vacía cuando la aplicación no tiene ningún valor para ella, por ejemplo una ubicación con un error. La aplicación no escribe un cero en lugar de un valor que no calculó.

NOTA: Si una celda de texto empieza con =, +, -, @ o una tabulación, la aplicación pone ' antes del texto. Así, un programa de hoja de cálculo no lee el texto como una fórmula.

Para leer la tabla en un programa, indique al programa que omita las líneas que empiezan con #. Por ejemplo, en pandas, use read_csv(..., comment="#").

Atribución y licencias¶

Las "Condiciones especiales de uso del WRI para GNW Self-Hosted Monitoring" se aplican a los datos. Usted debe atribuir los datos cuando comparte un resultado. No debe sugerir que WRI le respalda, le patrocina, le certifica o le aprueba a usted o aprueba su uso de los datos.

La aplicación añade el texto de atribución a cada exportación CSV y a cada informe PDF. El texto tiene estas partes:

La cita de GNW, con la fecha de acceso: "Global Nature Watch. [year]. World Resources Institute. Consultado el [date]." La fecha de acceso es la fecha en que terminó la última ejecución de la lista.
La cita de cada conjunto de datos que usa la exportación, con su licencia.
"Calculado con LUC Analytics, un proyecto independiente, con métodos adaptados de los scripts publicados por el WRI (post2020.py, GNW Self-Hosted Monitoring). El WRI no respalda este proyecto ni sus resultados."
"El uso de estos datos está sujeto a las Condiciones especiales de uso del WRI para GNW Self-Hosted Monitoring: https://www.wri.org/about/legal/gnw-shm-tos"

Los conjuntos de datos de cada exportación son:

Exportación	Conjuntos de datos
CSV posterior a 2020	Pérdida de cobertura arbórea, Bosques naturales SBTN, Cobertura forestal mundial JRC 2020, Causas dominantes de la pérdida de bosque
CSV de alertas	Alertas integradas de perturbación mundiales, Bosques naturales SBTN, Cobertura forestal mundial JRC 2020
CSV de la ubicación y PDF de la ubicación	Los cinco conjuntos de datos anteriores

Las licencias son:

Licencia	Conjuntos de datos
CC BY 4.0	Pérdida de cobertura arbórea, Bosques naturales SBTN, Causas dominantes de la pérdida de bosque, Alertas integradas de perturbación mundiales
Gratuito, sin restricciones de uso (Reglamento Copernicus de la Comisión Europea)	Cobertura forestal mundial JRC 2020

Para una lista con datos de demostración sintéticos, el texto de atribución es diferente. Dice "Datos sintéticos de demostración generados por LUC Analytics. No se leyó ningún conjunto de datos del WRI para estas cifras."

Para leer el texto de atribución en la aplicación, pulse Fuentes de datos y licencias en la parte inferior de la página. El texto completo está en el archivo DATA-ATTRIBUTION.md del repositorio del proyecto.

PRECAUCIÓN: Conserve las líneas de atribución cuando copia datos de un CSV a un archivo diferente. Si las quita, el archivo nuevo no indica a los lectores la fuente y la licencia de los datos.

Guardar una plantilla de la leyenda del mapa¶

Una plantilla de la leyenda del mapa guarda los ajustes de las capas del mapa en un archivo, para que usted pueda usarlos otra vez. No es una exportación de resultados.

En la leyenda del mapa, busque Plantillas de mapa guardadas.
Escriba un nombre en Nombre del archivo, o conserve el nombre predeterminado.
Pulse Guardar.

El archivo es un documento JSON con la extensión .mpky. Para usar el archivo otra vez, pulse Cargar…. Para más información, consulte 04-maps.md.

Exportación por línea de comandos¶

El programa también tiene el comando luc-analytics export para los administradores. Escribe el CSV de una lista (--analysis post2020 o --analysis alerts) o de una ubicación (--analysis detail --location-id <id>). Los argumentos --start y --end definen las fechas de las alertas. El argumento --output define el archivo. Sin --output, el comando escribe en la salida estándar.

El comando usa las mismas comprobaciones que la aplicación. Para una lista entera, la lista debe estar completa. Para una sola ubicación, esa ubicación debe estar terminada. Si la comprobación falla, el comando no escribe ningún archivo. Muestra un mensaje que empieza con export_refused: y se detiene con el código de salida 1. El comando no escribe el archivo de datos usados.