DOI: 10.5281/zenodo.16869738
title: "What Really Happened to my Models?" Extending Co-Evolution with Cross-Layer Traceability in Metamodel-Model Histories

description: “What Really Happened to my Models?” Extending Co-Evolution with Cross-Layer Traceability in Metamodel-Model Histories

 

This repository provides the dataset and results for the evaluation of the paper “What Really Happened to my Models?”



RQ1-Type-Refactors.zip contains the operations and refactoring performed on each of the given metamodels used by our approach in RQ1.

RQ1-Type-Results.zip: contains the group results of RQ1 as shown in our paper with additional metrics of other operations not highlighted in our paper due to space limitations.

RQ2-4-PlantUML.zip: contains the 250 PlantUML models and the metamodel. This folder contains the co-evolved PlantUML models, the operations performed during the co-evolution, their metrics and the state of the models bore and after the co-evolution. 

RQ2-4-FHIR.zip: contains the 1180 FHIR models and the metamodel. This folder contains the co-evolved FHIR models, the operations performed during the co-evolution, their metrics and the state of the models bore and after the co-evolution.

RQ2-4-Results.zip: contains the grouped results of RQ2 and RQ3 as presented in our paper.

Additionalnformation.pdf: contains additional information on how to read the files extracted by our approach, i.e., how to read the models and operations and how our executable refactoring catlaog works since we only focused on Property Refactorings in the paper.

Results.pdf: Contains an overview of the results (the results from our paper + additional results)

Tools.zip: Contains the tools used for the evalution. For an explaination how to use it read the Additionalnformation.pdf, see below or contact the authors


Running the Tools

This section describes how to use the tools. There are two tools:

·         importer.jar

This file is used to import a FHIR or PlantUML file into the server and co-evolve it.

·         Server_FHIR.jar / Server_PlantUML.jar / Server_FHIR-Synth.jar

The server stores the models and co-evolves them. The files provided already have the metamodels preloaded, that are used in RQ2 and RQ3, i.e., FHIR_STU3 contains the FHIR metamodel version DSTU2 and STU3 and our hybrid PlantUML, while FHIR-Synth contains the FHIR metamodel DSTU2 and our synthetically created one.

 

How to use the Tools

First, start the server by starting the jar. The server also has an experimental GUI mode that allows engineers to check the types and instances that were created.

java -jar Server_FHIR.jar

After the server has booted up, it exports InstanceTypes and operations created for the FHIR and PlantUML metamodels. Next, you start the importer. We have two importers:  the PlantUML importer , where it imports a PlantUML state machine and co-evolves it and the FHIR importer, where it imports an FHIR file and co-evolves it into either STU3 or our synthetic version (depending on which of the preloaded servers is running). 

FHIR-Importer  

java -jar FHIR-importer.jar <path_to_file_folder> <fileName> <saveFolder>                                 

java -jar FHIR-importer.jar C:\Users\Admin\Desktop\ Aaron697_Brekke496_2fa15bc7-8866-461a-9000-f739e425860a.json results

PlantUML-Importer 

java -jar PlantUML-Importer.jar <path_to_file_folder> <fileName>

java -jar PlantUML-importer.jar C:\Users\Admin\Desktop\  branch.puml

Note: Please run both the tool and the server in a command line to receive additional information about the importing and co-evolution since the tool is otherwise without a user interface.