Supplementary material: Model coupling through reproducible adapter workflows based on shared transformation functionsdoi:10.26165/JUELICH-DATA/VLBZIAJülich DATA2025-12-061Kuckertz, Patrick; Benjamin Fuchs; Julian Schönau; Hedda Gardian; Kevin Knosala; Eugenio Arellano Ruiz; Jan Göpfert; Hans Christian Gils; Jann M. Weinand; Patrick Jochem; Jochen Linßen; Detlef Stolten, 2025, "Supplementary material: Model coupling through reproducible adapter workflows based on shared transformation functions", https://doi.org/10.26165/JUELICH-DATA/VLBZIA, Jülich DATA, V1Supplementary material: Model coupling through reproducible adapter workflows based on shared transformation functionsdoi:10.26165/JUELICH-DATA/VLBZIAKuckertz, PatrickBenjamin FuchsJulian SchönauHedda GardianKevin KnosalaEugenio Arellano RuizJan GöpfertHans Christian GilsJann M. WeinandPatrick JochemJochen LinßenDetlef Stolten03EI1005A-G442146713Energy System DesignJülich DATAKuckertz, PatrickKuckertz, Patrick2025-12-04Computer and Information ScienceSoftware CouplingData IntegrationScientific WorkflowsData ModelsTransformation FunctionsMetadataReusabilityInteroperabilityDataDesc SchemaioProc Workflow ManagerThis supplementary material provides resources supporting the implementation of the refined DataDesc metadata schema and the ioProc workflow manager, described in the article, “Model coupling through reproducible adapter workflows based on shared transformation functions.” It aims to facilitate data and software integration, as well as data processing, by formalizing interface and data model descriptions and automating the identification of data transformation requirements. Using the ioProc and Snakemake workflow tools, these resources support reproducible, transparent adapter workflows with reusable transformation functions. The DataDesc schema is applied to create machine-interpretable descriptions of transformations, ensuring transparency in data handling across complex, coupled workflows. <h3>Organization</h3> <p>The project is organized into sections for <code>DataDesc Annotations</code>, <code>Data Models</code>, <code>Workflows</code>, and <code>Shared Data</code>.</p> <ul> <li><strong><code>DataDesc Annotations</code></strong> <ul> <li><strong><code>Data</code>:</strong> Contains JSON files with metadata annotations for energy technologies and renewable resources: <ul> <li>PEM electrolysis (<code>86 PEMEC 100 MW.json</code>)</li> <li>Solar PV (<code>ninja_pv_country_DE_merra-2_corrected.json</code>)</li> <li>Wind onshore (<code>ninja_wind_country_DE_current-merra-2_corrected.json</code>)</li> <li>Technology data for electricity and district heating (<code>technology_data_for_el_and_dh.json</code>)</li> <li>Technology data for energy storage (<code>technology_datasheet_for_energy_storage.json</code>)</li> <li>Specific technologies, including gas turbines, heat pumps, and lithium-ion batteries.</li> </ul> </li> <li><strong><code>Data Models</code>:</strong> JSON files representing data models for different workflows: <ul> <li>FINE framework models (<code>fine_dd.json</code>, <code>fine_merra_comparison.json</code>)</li> <li>REMix framework models (<code>REMix_dd.json</code>, <code>remix_readRemixCsv.json</code>)</li> </ul> </li> </ul> </li> <li><strong><code>Workflows</code></strong> <ul> <li><strong><code>FINE Workflow</code></strong> and <strong><code>REMix Workflow</code></strong>: Workflow configuration files for each framework, implementing the transformations and data processing steps.</li> </ul> </li> <li><strong><code>Shared Data</code></strong> <ul> <li>Contains <code>.xlsx</code> and <code>.csv</code> datasets shared across workflows: <ul> <li>Renewable fuels data (<code>data_sheets_for_renewable_fuels.xlsx</code>)</li> <li>Technology data for electricity, heat, and storage (<code>technology_data_for_el_and_dh.xlsx</code>, <code>technology_datasheet_for_energy_storage.xlsx</code>)</li> <li>High-resolution generation data for Germany from renewables.ninja, including solar PV and wind (<code>ninja_pv_country_DE_merra-2_corrected.csv</code>, <code>ninja_wind_country_DE_current-merra-2_corrected.csv</code>).</li> </ul> </li> </ul> </li> <li><strong><code>README.md</code></strong>: General project instructions and usage guidelines.</li> </ul> <h3>License</h3> All source code is licensed under the BSD 3-Clause License, including the jupyter notebooks. All input data from the Danish Energy Agency and Renewables Ninja have their respective licenses specified in accompanying license files. All other data is licensed under CC-BY 4.0 Attribution 4.0 International. Copyright (C) 2023-2024 FZJ-ICE-2 and Deutsches Zentrum für Luft- und Raumfahrt <h3>Acknowledgement</h3> The authors would like to thank the Federal Ministry for Economic Affairs and Climate Action of Germany (BMWK) for supporting this work with a grant for the project LOD-GEOSS (03EI1005A-G). Furthermore, the authors are grateful to the German federal government, the German state governments, and the Joint Science Conference (GWK) for their funding and support as part of the NFDI4Ing consortium, managed by the German Research Foundation (DFG) – 442146713. This work was also supported by the Helmholtz Association as part of the program "Energy System Design".All source code is licensed under the BSD 3-Clause License, including the jupyter notebooks. All input data from the Danish Energy Agency and Renewables Ninja have their respective licenses specified in accompanying license files. All other data is licensed under CC-BY 4.0 Attribution 4.0 International. Copyright (C) 2023-2024 FZJ-ICE-2 and Deutsches Zentrum für Luft- und Raumfahrt01_data_processing.ipynbapplication/x-ipynb+json02_model_calculation.ipynbapplication/x-ipynb+json05 Gas turb. CC, steam extract..jsonapplication/json180 Lithium Ion Battery.jsonapplication/json40 Absorption heat pump, DH.jsonapplication/json86 PEMEC 100 MW.jsonapplication/jsonaccounting_converteractivity-1.csvtext/csvaccounting_converteractivity.csvtext/csvaccounting_converterstartup.csvtext/csvaccounting_converterunits-1.csvtext/csvaccounting_converterunits.csvtext/csvaccounting_indicatorbounds.csvtext/csvaccounting_perindicator.csvtext/csvaccounting_sourcesinkflow.csvtext/csvaccounting_storageunits-1.csvtext/csvaccounting_storageunits.csvtext/csvaccounting_transportdistance.csvtext/csvconfig.yamlapplication/octet-streamconverter_activityprofile-1.csvtext/csvconverter_activityprofile.csvtext/csvconverter_capacityparam.csvtext/csvconverter_coefficient-1.csvtext/csvconverter_coefficient.csvtext/csvconverter_coefficientprofile.csvtext/csvconverter_techparam-1.csvtext/csvconverter_techparam.csvtext/csvconvert_scalars.pytext/x-pythonconvert_timeseries.pytext/x-pythoncreate_folder_structure.pytext/x-pythondata_sheets_for_renewable_fuels.xlsxapplication/vnd.openxmlformats-officedocument.spreadsheetml.sheetfine_dd.jsonapplication/jsonfine_merra_comparison.jsonapplication/jsongeneral.pytext/x-pythongetData.pytext/x-pythonInput_profiles_fine_changed.xlsxapplication/vnd.openxmlformats-officedocument.spreadsheetml.sheetInput_profiles_fine.xlsxapplication/vnd.openxmlformats-officedocument.spreadsheetml.sheetmap_accnodes.csvtext/csvmap_aggregatenodesmodel.csvtext/csvmodel_coupling.pytext/x-pythonninja_pv_country_DE_merra-2_corrected.csvtext/csvninja_pv_country_DE_merra-2_corrected.csv.licenseapplication/octet-streamninja_pv_country_DE_merra-2_corrected.jsonapplication/jsonninja_wind_country_DE_current-merra-2_corrected.csvtext/csvninja_wind_country_DE_current-merra-2_corrected.csv.licenseapplication/octet-streamninja_wind_country_DE_current-merra-2_corrected.jsonapplication/jsonOutput_profiles_fine_changed.xlsxapplication/vnd.openxmlformats-officedocument.spreadsheetml.sheetOutput_profiles_fine.xlsxapplication/vnd.openxmlformats-officedocument.spreadsheetml.sheetparameters.jsonapplication/jsonPotentials_changed.xlsxapplication/vnd.openxmlformats-officedocument.spreadsheetml.sheetPotentials.xlsxapplication/vnd.openxmlformats-officedocument.spreadsheetml.sheetREADME.mdtext/markdownREMix_dd.jsonapplication/jsonremix_readRemixCsv.jsonapplication/jsonREMix-workflow.drawioapplication/octet-streamREMix-workflow.pdfapplication/pdfrun.pytext/x-pythonset_accnodes.csvtext/csvset_accnodesdata.csvtext/csvset_activities.csvtext/csvset_commodities.csvtext/csvset_converter_techs.csvtext/csvset_distancetypes.csvtext/csvset_indicators.csvtext/csvset_linksdata.csvtext/csvset_nodesdata.csvtext/csvset_nodesmodel.csvtext/csvset_nodesmodelsel.csvtext/csvset_profiletypes.csvtext/csvset_sourcesink_techs.csvtext/csvset_storage_techs.csvtext/csvset_timemodel.csvtext/csvset_transport_techs.csvtext/csvset_years.csvtext/csvset_yearssel.csvtext/csvsourcesink_annualsum.csvtext/csvsourcesink_config.csvtext/csvsourcesink_profile.csvtext/csvstorage_levelprofile.csvtext/csvstorage_reservoirparam.csvtext/csvstorage_sizeparam-1.csvtext/csvstorage_sizeparam.csvtext/csvstorage_techparam-1.csvtext/csvstorage_techparam.csvtext/csvstrukturExample.pngimage/pngstrukturExample.vsdxapplication/vnd.ms-visio.viewertechnology_data_for_el_and_dh.xlsxapplication/vnd.openxmlformats-officedocument.spreadsheetml.sheettechnology_data_for_el_and_dh.xlsx.licenseapplication/octet-streamtechnology_datasheet_for_energy_storage.xlsxapplication/vnd.openxmlformats-officedocument.spreadsheetml.sheettechnology_datasheet_for_energy_storage.xlsx.licenseapplication/octet-streamtransport_coefficient.csvtext/csvtransport_coefperdistance.csvtext/csvtransport_coefperflow.csvtext/csvtransport_distanceparam.csvtext/csvtransport_linesparam.csvtext/csvtransport_linkstartend.csvtext/csvtransport_techparam.csvtext/csvuser.yamlapplication/octet-streamworkflow.drawioapplication/octet-streamworkflow.pdfapplication/pdf