Manual de Usuario y Administración
Parte 1Manual del usuario externo
Esta parte está dirigida a investigadores, instituciones y cualquier persona externa al LANOT que desee solicitar datos históricos del acervo de observación de la Tierra a través de este sistema.
1. ¿Qué es este sistema?
Este sitio permite solicitar datos históricos del sensor ABI del satélite geoestacionario GOES-East (GOES-16 de 2017 a abril de 2025; GOES-19 a partir del 7 de abril de 2025) sin necesidad de contactar directamente al equipo del LANOT. El sensor ABI captura una imagen del disco completo cada 10 minutos y una del sector continental de EE. UU. (CONUS) cada 5 minutos; el sector CONUS incluye prácticamente todo México, salvo una zona del sur de Chiapas.
Puede solicitar dos niveles de producto:
| Nivel | Contenido | Unidades |
|---|---|---|
| L1b | Las 16 bandas crudas del sensor, georreferenciadas. | Radiancia |
| L2 | Productos generados a partir de L1b (nubes, temperatura de superficie, vientos, etc.), calibrados y filtrados de errores. | Reflectancia / temperatura de brillo / unidades físicas según producto |
Puede consultar el catálogo completo de productos L2 (variables, unidades y descripción) en la página Productos CSPP Geo L2, enlazada también desde el constructor de consultas.
2. Ingreso y registro
El acceso al sistema se hace únicamente con su correo electrónico institucional, sin contraseña:
- Abra la página de ingreso y escriba su correo institucional.
- Si su correo ya está registrado, se le llevará directamente al constructor de consultas.
- Si es la primera vez que usa el sistema, se le pedirá completar un breve registro (nombre completo e institución; el correo queda fijo porque es el que usted ya escribió).
- Al registrarse queda creado como cliente con prioridad "Ninguno": sus primeras consultas serán revisadas manualmente por el equipo del LANOT (ver sección 5). El equipo puede otorgarle una prioridad mayor más adelante (ver Parte 2, sección 2) para que sus consultas se procesen automáticamente.
3. Construcción de una consulta
Una vez dentro, el constructor de consultas le pide elegir, en este orden, dominio, nivel, bandas o productos, y fechas/horarios.
Dominio y nivel.
Bandas (nivel L1b o L2). El sensor ABI tiene 16 bandas: las dos primeras en el visible, las cuatro siguientes en el infrarrojo cercano y las diez restantes en el infrarrojo térmico. La banda 02 tiene resolución de 500 m por píxel; las bandas 01, 03 y 05, de 1 km; el resto, de 2 km. Marque las casillas de las bandas que necesita, o use "Invertir selección" para marcar/desmarcar todas a la vez.
| Bandas L1b | 01 | 02 | 03 | 04 | 05 | 06 | 07 | 08 | 09 | 10 | 11 | 12 | 13 | 14 | 15 | 16 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Invertir selección |
Productos (solo nivel L2). Al elegir nivel L2 se habilita además una lista de productos derivados, por ejemplo: Aerosol Detection, Aerosol Optical Depth, Clear Sky Masks, Cloud Optical Depth, Cloud Particle Size Distribution, Cloud Top Height/Phase/Pressure/Temperature, Derived Motion Winds, Land Surface Temperature y Low Cloud and Fog, entre otros. Algunos productos (Derived Stability Indices, Downward/Reflected Shortwave Radiation, Fire Hotspot Characterization, Rainfall Rate/QPE, Sea Surface Temperature, Total Precipitable Water, Volcanic Ash) no se generan localmente pero se listan como referencia; consulte al equipo del LANOT sobre su disponibilidad. El detalle de variables y unidades de cada producto está en el catálogo Productos CSPP Geo L2.
Fechas y horarios. Indique al menos una fecha. Opcionalmente puede agregar una segunda
fecha para pedir un intervalo de días, y uno o varios intervalos de horas por cada fecha usando los botones
(+)/(-). Al dar clic en el campo de fecha final estando vacío, el formulario propone
el día siguiente al de la fecha inicial, de modo que el calendario se abra ya en el mes correcto; puede ajustar
esa fecha o borrarla si sólo le interesa un día. Reglas que valida el formulario antes de permitirle enviar la
consulta:
- Debe seleccionar al menos una banda o un producto, y al menos una fecha con un intervalo de horas.
- Ninguna fecha puede ser anterior al 1 de enero de 2018 (no hay datos previos a esa fecha en el acervo).
- Ninguna fecha puede ser posterior al día de hoy.
- Si indica dos fechas, la fecha inicial no puede ser posterior a la final.
- Si llena la fecha final debe llenar también la inicial, y lo mismo para las horas: una hora final sin hora inicial no describe ninguna ventana.
- Las horas se escriben en formato de 24 horas,
HH:MM. Puede teclear los cuatro dígitos de corrido (1430) y los dos puntos se agregan solos.
Dos comportamientos de los horarios que conviene conocer, porque no son errores aunque lo parezcan:
- Una hora final anterior a la inicial cruza la medianoche. Por ejemplo
22:00–02:00cubre de las 22:00 a las 23:59 y de las 00:00 a las 02:00. - Una hora inicial sin hora final es un instante, no una hora completa.
10:00a secas corresponde a la imagen tomada exactamente en ese minuto. Si lo que quiere es toda esa hora, indique10:00–10:59. - En CONUS conviene indicar siempre un intervalo. Full Disk llega en los minutos
exactos (:00, :10, :20…), de modo que un instante como
10:00sí encuentra su imagen. CONUS en cambio suele llegar en los minutos 1 y 6, y a veces en el 2 y el 7, así que un instante puede no coincidir con ninguna imagen y devolver cero archivos sin que nada haya fallado. - Dentro de un intervalo la alineación no importa.
10:00–12:00entrega toda imagen cuyo minuto caiga dentro, coincida o no con los extremos que usted escribió.
Si algo falta, aparecerá un mensaje en rojo indicando qué corregir antes de poder continuar. No está limitado a una sola fecha: puede agregar tantas filas de fecha como necesite, y dentro de cada una, tantos intervalos de hora como requiera. Si repite la misma fecha en varias filas, sus intervalos de horas se reúnen en una sola petición. El siguiente es un ejemplo real de una consulta para dar seguimiento a una emisión de ceniza volcánica, con 4 fechas distintas y entre 2 y 4 intervalos de horas en cada una:
fechas) agrupa cada fecha con su lista de
intervalos "HH:MM-HH:MM".Al terminar, pulse "Generar consulta". Si todo es válido, su solicitud queda registrada de inmediato.
4. Confirmación de la consulta
Tras enviar el formulario verá una pantalla de confirmación con su número de consulta (consérvelo para dar seguimiento), la fecha de registro y el estado inicial. El aviso que acompaña a la confirmación depende de la prioridad que el LANOT le haya asignado:
- Sin prioridad asignada — su consulta será revisada y procesada manualmente por el equipo del LANOT. Recibirá un correo cuando los datos estén listos.
- Cliente — su consulta se valida y envía a procesar automáticamente (si está dentro de los límites de tamaño configurados). Al terminar, se le crea automáticamente un acceso FTP temporal y se le notifica por correo con las credenciales.
- Staff — igual que Cliente en la validación/envío automático; al terminar, en lugar de un acceso FTP recibe un correo indicando que los datos ya están disponibles en el servidor (uso interno del LANOT).
5. Qué esperar después
Su consulta avanza por una serie de estados a medida que se procesa. Esta es la versión simplificada para seguimiento desde fuera del sistema:
| Estado | Qué significa |
|---|---|
| Pendiente | Su consulta fue recibida y aún no se ha revisado. |
| Validada | Ya se calcularon el tamaño y la cantidad estimada de archivos; está lista para procesarse. |
| En proceso | El sistema está buscando y preparando los archivos solicitados. |
| Completada | Los archivos ya están listos en el servidor del LANOT. |
| Sin datos | El proceso terminó pero no se encontró ningún archivo con los criterios indicados. |
| Rechazada | La consulta no pudo procesarse; el motivo se incluye en el correo de aviso. |
| Acceso FTP listo | Ya se generó su acceso temporal de descarga. |
| Correo de acceso enviado | Ya se le envió el correo con las credenciales de descarga. |
| Archivada | El acceso FTP fue revocado (venció el plazo o se alcanzó el máximo de descargas). |
Las transiciones automáticas a "Archivada" (por vencimiento o exceso de descargas) se explican en la sección 7.
6. Correos que puede recibir
Todas las notificaciones llegan al correo con el que se registró. A continuación, un ejemplo de cada una (con datos ficticios) tal como las redacta el sistema:
Estimado Juan Pérez, ¡Buenas noticias! Los datos para su consulta histórica (ID: aB3dE9fG) están listos y se ha creado una cuenta de acceso temporal para que puedas descargarlos. A continuación, los detalles para el acceso FTP: Servidor: ftp.lanot.unam.mx Usuario: hq_ab3de9fg Contraseña: ******** Vigencia: 10 días Por favor, descargue los datos tus datos antes de que el acceso expire. Saludos cordiales, El equipo del LANOT
Estimado/a Juan Pérez, Le informamos que su acceso FTP para la consulta #aB3dE9fG vencerá el 2026-06-28 10:00 UTC. Le recomendamos descargar sus datos antes de esa fecha. Una vez vencido el plazo, el acceso será revocado automáticamente y no podrá recuperarse sin una nueva solicitud. Si tiene alguna duda o necesita más tiempo, por favor contacte al administrador del sistema. Atentamente, El equipo de Datos Históricos LANOT
Estimado Juan Pérez, Lamentamos informarle que con los criterios de su consulta de datos históricos (ID: aB3dE9fG), no fue posible recuperar ningún archivo. Sugerimos que revise sus criterios de fechas y productos y lo intente de nuevo. Atentamente, El equipo de LANOT.
Estimado Juan Pérez, Lamentamos informarle que su consulta de datos históricos (ID: aB3dE9fG) ha sido rechazada. Motivo del rechazo: El rango de fechas solicitado excede la cobertura disponible para el dominio CONUS. Si tiene alguna pregunta, por favor, no dude en contactarnos. Atentamente, El equipo de LANOT.
Únicamente para usuarios con prioridad "Staff": en lugar del correo de acceso FTP, recibirá este aviso indicando la ruta donde ya están disponibles los datos en el servidor.
Hola María López, Te informamos que los datos de tu consulta con ID aB3dE9fG han sido descargados y están disponibles en la carpeta: /acervo/salidas/aB3dE9fG/ . Gracias por usar nuestro servicio. Saludos cordiales, El equipo del LANOT
7. Descarga de los datos por FTP
El correo de acceso FTP incluye servidor, usuario, contraseña y la vigencia en días del acceso. Puede usar cualquier cliente FTP (por ejemplo FileZilla), el explorador de archivos de su sistema operativo, o la línea de comandos, apuntando al servidor indicado con esas credenciales.
- Vigencia: el acceso se revoca automáticamente al cumplirse el plazo indicado en el correo. Unos días antes del vencimiento recibirá un aviso recordatorio (ver ejemplo en la sección anterior).
- Límite de descargas: el sistema permite un número máximo de descargas por acceso. Si lo supera, el acceso se bloquea automáticamente como medida de protección, incluso si todavía no ha vencido.
- Una vez que el acceso se archiva (por vencimiento, exceso de descargas o de forma manual), no puede reactivarse: si necesita los datos nuevamente, debe generar una nueva consulta.
Por eso se recomienda descargar los archivos tan pronto como reciba el correo de acceso.
8. Preguntas frecuentes
- No recibí ningún correo después de varios días.
- Revise su carpeta de correo no deseado/spam. Si no aparece, contacte al equipo del LANOT indicando su número de consulta.
- Mi consulta quedó en estado "Sin datos".
- No se encontró ningún archivo que cumpla los criterios solicitados. Revise el dominio, nivel, bandas/productos y, sobre todo, el rango de fechas, y vuelva a intentarlo.
- Mi consulta fue "Rechazada", ¿qué hago?
- El correo de rechazo incluye el motivo. Ajuste su consulta según esa indicación y vuelva a generarla, o contacte al equipo del LANOT si no le queda claro.
- Mi acceso FTP venció antes de que pudiera descargar todo.
- Los accesos vencidos no se extienden ni se reactivan. Genere una nueva consulta con los mismos criterios para obtener un nuevo acceso.
- ¿Cuántas veces puedo descargar con el mismo acceso?
- Hay un límite configurado por el LANOT (por defecto 8 descargas). Al superarlo, el acceso se bloquea automáticamente.
Parte 2Manual del administrador (equipo LANOT)
Esta parte está dirigida al personal del LANOT que opera el panel de administración Django para validar, procesar, notificar y dar seguimiento a las consultas de los usuarios externos.
1. Acceso al panel de administración
El panel se encuentra en /admin/ y requiere una cuenta de staff de Django. Para crear una
nueva cuenta de administrador con los permisos correctos sobre clientes y consultas, el equipo técnico ejecuta:
python manage.py create_historic_admin --username <nombre> --email <correo> --password "<clave>"
Este comando asigna la cuenta al grupo Historic App Admin, con permisos sobre clientes y
consultas (y su historial de auditoría). Si nota más de un grupo con nombre similar en el panel de grupos,
consulte con el equipo técnico antes de modificar permisos.
2. Gestión de clientes y prioridades
Cada cliente registrado tiene un nivel de prioridad, editable directamente desde la lista de clientes en el admin, que determina cuánta automatización recibe:
| Prioridad | Comportamiento |
|---|---|
| Ninguno | Sin automatización: el administrador valida y envía las consultas manualmente. |
| Cliente | Al registrar la consulta: se valida y envía automáticamente si está dentro de los umbrales configurados. Al completarse: se solicita un acceso FTP temporal y se notifica al cliente con las credenciales. |
| Staff | Igual que Cliente para validación/envío automático. Al completarse: se envía un correo con la ruta de destino de los archivos, sin crear acceso FTP. |
Los umbrales de auto-envío (cantidad de archivos y tamaño estimado en MB) son variables de entorno del
servidor (AUTOMATION_MAX_FILES, AUTOMATION_MAX_SIZE_MB); si una consulta de un cliente con
prioridad los excede, queda en estado Validado esperando el envío manual desde el admin.
3. Ciclo de vida de una consulta desde el admin
En la vista de detalle de cada consulta, los botones disponibles cambian según el estado actual:
| Situación | Botón(es) visibles |
|---|---|
| Pendiente, sin ID de seguimiento | Validar |
| Validado, sin ID de seguimiento | Enviar consulta |
| Cualquier estado activo, con ID | Actualizar estado |
| Error, con ID | Reiniciar consulta + Actualizar estado |
| Completado, sin FTP | Ver Resumen · Descargar Lista · Crear Acceso FTP |
| Completado, con FTP pendiente | Actualizar Acceso FTP |
Además, la columna Rechazar aparece para cualquier estado activo (limpia los recursos reservados en QueryProcessor y TempoFTP antes de rechazar localmente), y la columna Archivar aparece cuando hay un acceso FTP activo o bloqueado.
4. Acciones en lote
Desde la lista de consultas se pueden seleccionar varias filas y aplicar una acción masiva:
| Acción | Qué hace |
|---|---|
| Validar y enviar consultas seleccionadas | Valida y envía al QueryProcessor las consultas en estado Pendiente o Rechazada; el resto se omite. |
| Enviar consultas validadas seleccionadas | Envía a procesar las consultas que ya están en estado Validado. |
| Reintentar solicitud FTP | Limpia errores transitorios de solicitudes FTP atascadas para reintentar la creación del acceso. |
| Rechazar consultas seleccionadas | Limpia los recursos externos (QueryProcessor + TempoFTP) de cada consulta y la rechaza localmente. |
| Archivar consultas (revocar acceso FTP) | Revoca el acceso en TempoFTP y transiciona la consulta a Archivada. |
5. Notificaciones al cliente
Para clientes sin automatización (prioridad "Ninguno"), el administrador debe disparar manualmente el correo correspondiente desde el botón de notificación que aparece según el estado: Rechazada, Acceso FTP listo o Sin datos. Una vez enviado, el botón se reemplaza por un indicador de "ya notificado". Para clientes con prioridad Cliente/Staff, estas notificaciones se generan automáticamente cuando corresponde.
Todos los correos —manuales o automáticos— se encolan en una tabla de notificaciones pendientes y se envían de forma asíncrona (proceso programado cada minuto, hasta 3 reintentos por correo), para que un fallo de conexión SMTP nunca bloquee una acción del admin.
6. Auditoría de cambios
Cada cambio sobre una consulta (creación, modificación, borrado) queda registrado con usuario y fecha/hora
en el historial de auditoría, visible desde el botón de historial en la vista de detalle de la consulta
(/admin/historic/query/<id>/history/). Es la referencia para reconstruir qué administrador
hizo qué y cuándo ante cualquier duda o reclamo.
7. Diagrama de estados completo
A diferencia de la versión simplificada de la Parte 1, el equipo del LANOT debe conocer también los estados de error y los estados legacy que aún pueden aparecer en registros antiguos:
El rechazo manual puede ocurrir desde casi cualquier estado activo, no solo desde Pendiente. El
archivado puede ser manual o automático (vencimiento del acceso FTP o exceso de descargas). Los estados legacy
Recibido/Procesando solo provienen de registros antiguos de la API y se normalizan a
"En proceso"; el comando consolidate_legacy_states existe para migrarlos en una ventana de
mantenimiento.
8. Resolución de problemas comunes
- Una consulta quedó en estado "Error".
- Revise el mensaje de error en el detalle de la consulta. Si la causa ya se resolvió (por ejemplo, un problema temporal del servicio de procesamiento), use Reiniciar consulta. Si no es recuperable, rechácela e infórmele al cliente el motivo.
- Un acceso FTP se bloqueó por exceso de descargas.
- El sistema lo bloquea automáticamente al superar el límite configurado. Use Archivar para cerrar el ciclo; si el cliente necesita más descargas, deberá generar una nueva consulta.
- Un acceso FTP está por vencer.
- El sistema envía automáticamente un aviso al cliente unos días antes del vencimiento (configurable). No hay extensión automática del plazo; si es necesario, se debe crear un nuevo acceso manualmente desde Actualizar Acceso FTP o coordinarlo con el cliente.
- Un correo no se envió.
- Revise la cola de notificaciones pendientes en el admin: cada intento fallido queda registrado con su error; tras 3 intentos sin éxito, la notificación deja de reintentarse y debe atenderse manualmente.