Integración del software de gestión del riego: vincular sensores, unidades e identificadores de parcela

La integración de un software de gestión del riego funciona cuando cada valor recibido conserva su significado: qué se midió, con qué sensor, dónde, en qué unidad y en qué momento. Una conexión que transfiere números correctamente puede asignar una lectura profunda a un canal superficial o vincular mediciones de la temporada anterior con una parcela recién dividida. Resuelva esas correspondencias antes de utilizar la visualización conjunta para orientar el riego.

Termómetros infrarrojos inalámbricos miden la temperatura de las plantas para programar el riego. La fotografía muestra instrumentos de campo, no sondas de humedad del suelo ni una integración de software demostrada. Foto: Plant Stress and Germplasm Development Unit, USDA Agricultural Research Service.

Esta guía desarrolla un diccionario de datos práctico, un ejercicio original de correspondencia de registros y un historial de sustitución de sensores. Los nombres de campos y los registros son ejemplos propuestos, no una especificación del software de IrriNex ni una afirmación de que alguna plataforma los implemente automáticamente.

1. Defina la medición antes de elegir el campo correspondiente

Comience con un registro real de cada fuente. Pida al instalador o al proveedor del software que explique cada campo utilizado por la aplicación receptora. Una etiqueta como «humedad» no basta: el contenido volumétrico de agua, la tensión del agua y un índice relativo del proveedor describen magnitudes distintas. Cambiar el encabezado de una columna no permite combinarlas.

El estándar OGC SensorThings API Part 1: Sensing, versión 1.1 distingue la propiedad observada, el sensor, las observaciones y la entidad observada. La descripción de un flujo de datos incluye una unidad explícita. Es una referencia útil para separar significados; no demuestra que los productos existentes de la explotación admitan este estándar.

Registre el sistema de origen, el ámbito de la cuenta, el identificador del dispositivo, el canal, la magnitud, la unidad, la posición de medición y los indicadores de calidad disponibles. Conserve los identificadores como cadenas de caracteres cuando su formato importe. Un dispositivo llamado «007» no debe convertirse silenciosamente en otro llamado «7». Ninguno de esos identificadores es necesariamente único entre cuentas de clientes distintas.

Identifique si cada valor es una muestra instantánea, un promedio de intervalo, una cantidad correspondiente a un intervalo o un contador acumulativo. Conserve el intervalo de medición y el tipo de estadística cuando corresponda. La guía de interpretación de pulsos de caudalímetros aborda el cálculo previo; esta integración conserva su significado establecido.

2. Separe la identidad de la parcela, el punto de medición y el dispositivo físico

Asigne a cada parcela gestionada un identificador estable, independiente del nombre mostrado. Mantenga otro identificador para el punto de medición que representa la posición y profundidad observadas, y asocie el sensor físico instalado y su canal con ese punto durante un período definido. Una dirección de pasarela o un número de serie no debe convertirse en la única descripción conservada del suelo muestreado.

Una parcela y una zona de riego también tienen identidades diferentes. Una válvula puede abastecer parte de una parcela o varias superficies, y esas relaciones pueden cambiar. Mantenga por separado la relación zona-parcela, con su período de vigencia, sin suponer que nombres iguales significan límites iguales.

Si se divide una parcela, conserve la versión anterior de sus límites y cree las nuevas identidades o relaciones documentadas de sucesión. No reasigne las lecturas antiguas al mapa actual sin conservar la asignación original. Las coordenadas necesitan un sistema de referencia y un orden declarados; un punto que aparece en una posición plausible puede seguir estando mal ubicado.

Confirme la profundidad y la posición con el equipo de campo. La guía de ubicación de sensores de humedad del suelo explica por qué influyen en la interpretación. Una correspondencia correcta en el software no hace que una sola sonda represente toda una parcela heterogénea.

3. Normalice las unidades sin perder el valor original

Elija una unidad receptora documentada para cada magnitud y conserve el valor original junto a ella. Indique la fórmula de conversión y la versión de correspondencia. Una opción de formato del panel no demuestra que los valores almacenados o los cálculos posteriores hayan cambiado de manera coherente.

En un ejemplo inventado, suponga que la fuente A comunica explícitamente el contenido volumétrico de agua como fracción en m³/m³, mientras que B comunica explícitamente la misma magnitud como porcentaje en volumen. Entonces 0.275 m³/m³ × 100 = 27.5 % en volumen, y 27.5 ÷ 100 = 0.275 m³/m³. Son representaciones equivalentes en distintas unidades, no una meta para el cultivo ni una prueba de concordancia entre instrumentos.

Aplicar el factor dos veces convertiría 27.5 en 0.00275 m³/m³, un resultado 100 veces menor que el valor normalizado correcto. Ese número sigue dentro de un intervalo amplio de fracciones no negativas, por lo que una comprobación simple de rango no detectaría el error. Pruebe pares conocidos de entrada y salida, además de verificar límites plausibles.

No aplique esta conversión al contenido gravimétrico de agua, al potencial matricial ni a un índice porcentual sin documentar. Convertir entre magnitudes físicas distintas puede requerir información adicional o un modelo. Registre una unidad desconocida como pendiente de resolución, en vez de tomar prestado el ajuste de un canal cercano.

Asimismo, conserve el significado del cero. Una cantidad válida de lluvia igual a cero difiere de una lectura ausente; un contenido de agua del suelo igual a cero puede merecer investigación, pero no debe fabricarse a partir de una celda vacía. Aplique validaciones específicas de la magnitud y conserve la información de calidad del proveedor.

4. Almacene la hora de medición por separado de la hora de llegada

Especifique qué reloj generó cada marca temporal. La hora de medición describe cuándo se aplica la observación. La hora de generación del resultado describe cuándo se produjo, algo que puede diferir tras el procesamiento. La hora de recepción describe la llegada al servicio de integración. El campo resultTime de OGC no es un sinónimo genérico de la hora de recepción del servidor.

Utilice una representación temporal acordada con una referencia UTC o un desplazamiento numérico explícito. La RFC 3339 del IETF, publicada en julio de 2002, define un formato de marcas temporales para Internet y explica los desplazamientos numéricos. Conserve la marca original y su desplazamiento al normalizar a UTC, y documente la zona horaria de la explotación utilizada para la visualización local y los informes diarios.

En los registros ficticios siguientes, 2026-08-20T08:00:00-07:00 y 2026-08-20T10:00:00-05:00 representan el mismo instante: 2026-08-20T15:00:00Z. Dos horas de reloj diferentes no son necesariamente dos instantes diferentes. Por el contrario, una hora local repetida durante un cambio horario estacional necesita un desplazamiento inequívoco u otra interpretación verificada.

No añada Z a una marca temporal local cuyo desplazamiento se desconoce: eso declara una hora UTC sin haberla establecido. Conserve el registro ambiguo y déjelo pendiente de resolución. Algunas interfaces asignan la hora del servidor cuando se omite la hora de medición, incluido el comportamiento documentado de SensorThings. Una importación correcta no demuestra, por tanto, que se haya suministrado una hora auténtica de medición en campo.

Defina los períodos de informe mediante instantes explícitos de inicio incluido y final excluido. Para un día local de riego, derive esos límites con las reglas de la zona horaria aplicable; no suponga que todos los días del calendario local contienen el mismo número de horas transcurridas. Esto afecta a la interpretación de registros, no a un cambio del programa de riego del controlador.

5. Pruebe duplicados, valores ausentes y registros contradictorios

Acuerde la clave de observación con el proveedor de origen. Puede combinar sistema de origen, cuenta e identificador de registro; si los identificadores solo son únicos dentro de un flujo, incluya ese flujo. La marca temporal y el valor numérico por sí solos son insuficientes: sondas distintas pueden producir valores idénticos en el mismo instante.

Las seis filas recibidas siguientes son pruebas inventadas de un adaptador. Suponga que los identificadores son únicos dentro de cada cuenta de origen nombrada, que A:901 pertenece al punto P-A y B:901 a otro punto, P-B. Suponga que la última fila repite A:901 con un valor modificado, sin una revisión correctora documentada. Ningún registro de esta tabla representa mediciones reales de campo.

Antes de que llegue el conflicto, el ejercicio contiene dos observaciones distintas aceptadas, una recepción duplicada, un registro no válido y otro con tiempo pendiente de resolución. La sexta fila exige marcar la observación A:901 existente como cuestionada y excluirla de los usos que requieren un valor no cuestionado hasta resolverla. No debe convertirse en una tercera medición independiente.

La importación repetida del mismo lote sin cambios debe dejar intacto el conjunto de mediciones aceptadas, conservando las pruebas de recepción necesarias. Pruebe los registros corregidos con una política explícita de revisiones. Los registros tardíos pueden actualizar una visualización histórica, pero debe documentarse por separado si se recalcula una recomendación anterior.

Este ejercicio comprueba significado e identidad, no el rendimiento de entrega de la red. La comparación de conectividad para riego trata las rutas de comunicación y las mediciones de llegada. Una conexión correcta no resuelve una observación ambigua.

6. Sustituya sensores sin reescribir el pasado

Mantenga un punto de medición persistente solo cuando su significado siga siendo apropiado. Sustituir una sonda averiada en la misma posición y profundidad verificadas puede continuar el historial de ese punto, pero el nuevo instrumento físico necesita su propia identidad, período de instalación y registro de calibración. Mover la sonda a otro suelo o profundidad requiere un punto nuevo o una definición de medición explícitamente modificada.

Para otra sustitución ficticia en P-A el 2026-08-21, suponga que el sensor OLD está asignado hasta las 14:00Z, excluidas, y que NEW comienza a las 15:00Z, incluidas. Son límites de instalación documentados para este ejemplo, no horarios de mantenimiento recomendados.

Verifique tanto la identidad del sensor físico como la asignación vigente en el momento de medir. Un mensaje retrasado de OLD no puede convertirse en una observación de NEW solo porque cambió el registro actual de dispositivos. Investigue las asignaciones solapadas o las lecturas fuera del período de instalación declarado.

Muestre el límite de sustitución y calibración al revisar tendencias. Un salto en la serie puede reflejar diferencias de instrumento o instalación, en vez de un cambio brusco del agua del suelo. Conserve las observaciones originales; si se justifica una corrección autorizada, mantenga su método y revisión en lugar de sobrescribir la única copia histórica.

7. Apruebe la correspondencia con un pequeño conjunto controlado de registros

Pida al responsable de la explotación, al agrónomo y al especialista de integración que revisen juntos un conjunto de prueba. Incluya cada magnitud y unidad requerida, más de una parcela, un cambio de límites, una sustitución y los registros excepcionales anteriores. Siga registros de origen seleccionados a través de la normalización hasta la visualización final, comprobando punto, profundidad, hora, valor y calidad.

Utilice un entorno de prueba sin operación de equipos o una copia histórica autorizada. Registre la entrada, el resultado esperado, el resultado real, la versión de correspondencia, el problema pendiente y el revisor. Un cambio de etiqueta de parcela no debe trasladar mediciones anteriores; un canal desconocido debe quedar pendiente en vez de asignarse a una parcela predeterminada.

Apruebe la correspondencia de observaciones antes de permitir sus usos dependientes. Si los datos informarán una alerta, verifique cómo ese diseño separado trata los registros no válidos, cuestionados y pendientes de resolución. La hoja de diseño de alarmas de riego aborda los umbrales y la respuesta; este ejercicio de correspondencia aporta entradas correctamente identificadas.

Repita los casos afectados después de un cambio de API, firmware, calibración o asignación de parcelas. Conserve la versión anterior de correspondencia junto a su período de vigencia. El resultado útil es una ruta trazable desde el registro de origen hasta la observación correcta de la parcela, manteniendo visible la incertidumbre.

8. Preguntas frecuentes

¿Puedo unir registros mediante el nombre de la parcela?

Utilice un identificador estable y una asignación vigente. Los nombres pueden cambiar o reutilizarse, y el límite actual de una parcela puede diferir del que corresponde a observaciones antiguas.

¿Deben usar la misma unidad todos los valores de humedad del suelo?

Las magnitudes compatibles pueden compartir una unidad normalizada documentada. Confirme primero qué mide cada sensor. Un índice porcentual o una lectura de tensión no se convierte en contenido volumétrico de agua cambiando la etiqueta.

¿Sustituir un sensor requiere eliminar el canal anterior?

Conserve el instrumento anterior y sus observaciones. Asocie el reemplazo con el punto de medición apropiado durante su propio período de vigencia, retenga la información de calibración y marque expresamente cualquier intervalo sin instalación o cambio en el significado del muestreo.