Skip to content

EWoPe: A light Embeddable WOrkflow PErsistence tool for geoscientific pipeline reproducibility

License

Notifications You must be signed in to change notification settings

DanielaCabiddu/EWOPE

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

80 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

EWoPe: a light Embeddable WOrkflow PErsistence tool for geoscientific pipeline reproducibility

EWoPe: Embeddable WOrkflow PErsistence is a flexible, multi-platform software framework implemented in C++ and designed to document and preserve a wide range of geoscientific computational workflows. It enables users and developers for managing, serializing, and inspecting workflow metadata and data descriptors. The architecture supports two modes of use, such as:

  • an embeddable library that can be integrated directly into user-developed C++ software;
  • a standalone executable to work with third-party software.

The code is tested on different Operating Systems (MacOS, Linux and Windows).

Clone

We provide the commands to install EWoPe. The repository includes a submodule necessary to make the code work. Please, clone it recursively:

  • Clone recursively the repository into your local machine:
git clone --recursive https://github.com/DanielaCabiddu/EWOPE.git

Content of the repository

  • src: source code for the two main applications
    • main_core: to create and customize metadata following EWoPe base structure
    • main_history: to build computational histories
  • include: functionalities library to support source codes
  • external: external libraries
  • examples: application data (input data and output metadata)
  • CMakeLists.txt: build configuration file

Dependences

EWoPe code has some mandatory dependences:

  • to manage command line arguments and options: tclap (to clone and include in ${ROOT}/external);
  • to metadata the computational process: cereal (included as a submodule in ${ROOT}/external).

Building

To build EWoPe source code, use the following pipeline:

cd ${ROOT}
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
cmake --build . --config Release

Executables will be made available in ${ROOT}/bin folder.

Application

Our application is described in the paper (see Section 5). To replicate paper results testing history functionality (see Section 6.3), please run the executable _EWOPE_history_, as described in the README located in the examples folder. Such a folder contains all input data and output metadata used in our case study.

Contributors

Citing us

{
@article{MIOLA2026106099,
title = {EWoPe: A light Embeddable WOrkflow PErsistence tool for geoscientific pipeline reproducibility},
journal = {Computers & Geosciences},
volume = {209},
pages = {106099},
year = {2026},
issn = {0098-3004},
doi = {https://doi.org/10.1016/j.cageo.2025.106099},
url = {https://www.sciencedirect.com/science/article/pii/S0098300425002493},
author = {Marianna Miola and Daniela Cabiddu and Simone Pittaluga and Micaela Raviola and Marino {Vetuschi Zuccolini}},
keywords = {Scientific workflows, Workflow persistence, Provenance tracking, Metadata, Geoscientific modeling, Computational reproducibility}
}

Acknowledgment

The work is developed under the Ph.D. Research Project in Science and Technologies for Earth and Environment, supported by the Italian Ministry of University and Research under the National Operational Programme NOP “Research and Innovation” 2014-2020, “Education and research for recovery – REACT-EU”, Axis IV - Action IV.5 “PhD programmes on green topics” Ministerial Decree no. 1061, 10 August 2021.

Marianna Miola acknowledges the support of the National Recovery and Resilience Plan (NRRP), Mission 4 Component 2 Investment 1.4 - Call for tender no. 3138 of 16 December 2021, rectified by Decree no. 3175 of 18 December 2021 of Italian Ministry of University and Research funded by the European Union-NextGenerationEU; Award Number: Project code CN 00000033, Concession Decree no. 1034 of 17 June 2022 adopted by the Italian Ministry of University and Research, CUP B83C22002930006, Project title “National Biodiversity Future Center - NBFC”.

Daniela Cabiddu, Simone Pittaluga and Marino Vetuschi Zuccolini are members of the RAISE Innovation Ecosystem, funded by the European Union - NextGenerationEU and by the Ministry of University and Research (MUR), National Recovery and Resilience Plan (NRRP), Mission 4, Component 2, Investment 1.5, project “RAISE - Robotics and AI for Socio-economic Empowerment” (ECS00000035).

About

EWoPe: A light Embeddable WOrkflow PErsistence tool for geoscientific pipeline reproducibility

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •