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.
[data_manager] contains scripts to run the Data Manager.
[scheduled] contains scripts to run the Scheduler.
[webapp] contains scripts to run the Web Application.
"README.md" contains documentation and instructions.
metadata.json: description of data assets stored in the MongoDB database by default in this repository in compliance with Open Access and ISO-compliant metadata requirements.
All data files are licensed under CC BY 4.0, all software is licensed under MIT License.
Supplementary repository
The following repository complements this one by providing a precompiled Docker image of the project and references to external Docker images pinned with SHA-256 digests. This ensures long-term use and accurate replicability (use the prebuilt version in case of compilation problems or compatibility issues with future versions of external modules and dependencies).
Iglesias Vazquez, F. (2025). Proof of Concept: JUNON Digital Twin (v1.4) -- Prebuilt Image (1.4). TU Wien. https://doi.org/10.48436/rpkgp-d3b15
