Primeros pasos

English version

Primeros pasos

Solo hace falta instalar la herramienta que vayas a usar: sin más, MonitorEO calcula en Google Earth Engine con su cuenta compartida, sin cuenta propia ni inicio de sesión. Con tu cuenta de Earth Engine y tu proyecto de Google Cloud, los cálculos cuentan en tu cuota y además puedes exportar a Google Drive. La app de Earth Engine ni siquiera se instala: se abre en el navegador (manual).

1. Cuenta y proyecto de Earth Engine

MonitorEO calcula todo en Google Earth Engine, con una de estas dos cuentas:

• La cuenta compartida de MonitorEO, la de siempre que no des un proyecto: no hace falta cuenta de Earth Engine ni iniciar sesión. Calcula con el proyecto de Google Cloud de MonitorEO mapas, series, tendencias, comparaciones, incendios y GeoTIFF que se descargan a tu ordenador. No exporta a Google Drive, y cada usuario tiene 25 EECU-h de cálculo al mes, sus research EECUs, solo para investigación (Conceptos): cuando los gastes, o si la cuenta no responde un rato, usa la tuya. Es un proyecto de uso no comercial, así que vale para los mismos usos que se describen abajo: para la gestión operativa de una administración, el trabajo por encargo o el de una empresa, usa tu propio proyecto comercial.
• Tu cuenta y tu proyecto: los cálculos cuentan en la cuota de tu proyecto y puedes exportar a Google Drive (mapas de regiones grandes a resolución completa, series largas). Basta con dar tu proyecto en la herramienta.

Para usar tu cuenta necesitas:

1. Una cuenta de Google. En una administración pública, Google exige la cuenta institucional de Google del organismo.
2. Un proyecto de Google Cloud registrado en Earth Engine. Para uso no comercial (investigación, docencia, ONG, uso personal sin ánimo de lucro) es gratuito, con una cuota mensual de cómputo. Se crea en https://code.earthengine.google.com/register (elige Unpaid usage y el tipo de uso) o desde la consola de Google Cloud; los detalles están en https://developers.google.com/earth-engine/guides/access. Según las condiciones de Google, las empresas necesitan en general un proyecto comercial (Paid usage), y una administración solo puede usarlo gratis para investigación académica (artículos, tesis, informes), salvo las de países menos desarrollados y los gobiernos indígenas: la gestión operativa (seguimiento continuado, herramientas o productos para la gestión) y las pruebas internas necesitan un proyecto comercial. El uso no comercial tampoco cubre el trabajo por encargo o remunerado para administraciones o empresas. Google revisa cada caso.
3. El identificador del proyecto (p. ej. mi-proyecto-ee, no su nombre visible): se indica en cada herramienta o, una vez para todas, en la variable de entorno EE_PROJECT.

Si ya usas el editor de código de Earth Engine, ya tienes un proyecto: es el que aparece arriba a la derecha.

2. Autenticación

Solo para usar tu cuenta, una vez por ordenador. Las credenciales se guardan en ~/.config/earthengine/credentials y valen para todas las herramientas:

• QGIS: botón Authenticate… del panel de MonitorEO, que abre el navegador para iniciar sesión con tu cuenta de Google. Es la forma recomendada en QGIS: no hace falta terminal.

• Python, línea de comandos, MCP y R: en una terminal con el entorno de MonitorEO activado,

  earthengine authenticate

  (o rgee::ee_Initialize() si ya usas rgee). Se abre el navegador para iniciar sesión con tu cuenta de Google.

3. Instalación

Herramienta	Qué instalar
App de Earth Engine	Nada, y sin cuenta de Earth Engine.
QGIS	El zip del plugin. Lleva todo dentro: no hace falta Python ni conda.
Python y Línea de comandos	El paquete monitoreo (mejor con el entorno de conda)
MCP	El paquete monitoreo y una entrada en la configuración de Claude Desktop, Claude Code u otro cliente. Sin saber Python: instalación paso a paso
Asistente para gestores	Su instalador: doble clic en Windows, una orden en la Terminal de macOS o de Ubuntu (o el entorno de conda). La primera vez, el asistente descarga su modelo de lenguaje y su motor (unos 5 GB)
R	El paquete monitoreo de Python y el paquete de R monitoreo

Plugin de QGIS

1. Descarga monitoreo_qgis-<versión>.zip de la última release.
2. En QGIS: Complementos > Administrar e instalar complementos > Instalar a partir de ZIP, elige el zip e Instalar complemento.
3. Abre el panel con el botón MonitorEO. Con el campo Project vacío ya calcula con la cuenta compartida. Para usar tu cuenta, pulsa Authenticate…, inicia sesión con tu cuenta de Google en el navegador que se abre, escribe tu proyecto y pulsa Connect.

Funciona en QGIS 4.0.3 o posterior, en Windows, macOS y Linux. Detalles en QGIS.

Paquete de Python (también para el MCP y R)

Esta sección da por hecho que sabes usar una terminal y conda. Si no, sigue la instalación paso a paso, que explica cada orden.

Con Miniforge (conda solo con conda-forge; el canal defaults de Anaconda exige licencia a organizaciones grandes):

curl -O https://raw.githubusercontent.com/monitoreo-obsnev/monitoreo/main/environment.yml
conda env create -f environment.yml
conda activate monitoreo
earthengine authenticate        # solo para usar tu cuenta de Earth Engine

El entorno monitoreo trae Python 3.12, Earth Engine, GDAL (para leer capas vectoriales y escribir GeoTIFF), matplotlib (gráficas), el servidor MCP y el paquete monitoreo de GitHub.

O con pip, en cualquier Python 3.9 o posterior (sin GDAL, las regiones desde ficheros no funcionan):

pip install "monitoreo[mcp,plot] @ https://github.com/monitoreo-obsnev/monitoreo/archive/refs/heads/main.zip"

Comprueba que todo va bien:

monitoreo parks "Sierra Nevada"

Debe listar las áreas protegidas con ese nombre y su ID de WDPA, calculadas con la cuenta compartida; con tu cuenta, monitoreo --project mi-proyecto-ee parks "Sierra Nevada".

Actualizar

• Python y R: repite la instalación con pip añadiendo --force-reinstall (o mo_install() en R).
• MCP y asistente: se actualizan solos a la última versión de GitHub cada vez que arrancan.
• QGIS: descarga el zip de la nueva release e instálalo encima.

monitoreo --version (o monitoreo.__version__) da la versión instalada.

Siguiente paso

Lee Conceptos (variables, regiones, periodos y filtros) y sigue el manual de tu herramienta.