Proof of Concept: JUNON Digital Twin (v1.4c)

Proof of Concept: JUNON Digital Twin (v1.4)

Context and methodology

JUNON is an ambitious research programme to develop a digital research cluster on the continental environment (agricultural, urban, forestry and river) in the Centre-Val de Loire region, France. This cluster aims to design digital services to improve the monitoring and understanding of the environment, for better management of natural resources.

This repository contains a proof of concept (PoC) of the JUNON Digital Twin. It tests some planned parts of DT, data exchange protocols, communication processes and services. The PoC is built on dockerized modules that can be executed on a single machine. It is formed by a FIWARE network that includes the following components: Data Manager, Scheduler, Web Application, MongoDB, Orion Context Manager, Cygnus, and STH-Comet. External repositories (MétéoFrance-Safran, Hubeau-ADEs and Folium) are connected through official APIs. The developed PoC serves a use case in which the DT collects and manipulates data related to 53 piezometric sensors from strategic locations in the Centre-Val de Loire selected by expert hydrologists. They collect data of aquifer water levels (Hubeau-ADEs). Additionally, this information is combined with weather/climate measurements and estimations (MétéoFrance-Safran). Folium repositories are accessed to obtain interactive geographic maps.

The database contains data from January 2020 to July 2025 by default, although users can easily extend or reduce the temporal coverage. The DT prototype provides services for: (a) historical data visualization, (b) time series forecasting with or without exogenous inputs, (c) clustering of multivariate time series, and (d) spatial interpolation of two-dimensional water-level maps. Users access the PoC services through a Flask/Dash application.

Technical details

• [docker] contains the Dockerfile and docker-compose.yml to build the FIWARE network with the MongoDB, Orion Context Manager, Cygnus, and STH-Comet components as well as a debian-based system component with Python to run the Data Manager, Scheduler and Web Application components.
• [db] contains the default MongoDB with data from 2020 to 2025 (shared local volume).
• [data_manager] contains scripts to run the Data Manager (shared local volume).
• [scheduled] contains scripts to run the Scheduler (shared local volume).
• [webapp] contains scripts to run the Web Application (shared local volume).
• "README.md" contains documentation and instructions.

All data files are licensed under CC BY 4.0, all software is licensed under MIT License.