View source for EMF DiffMerge

[[Image:Logo EDM Small.png]]

== Introduction  ==

EMF Diff/Merge is a tool for merging models. More precisely, it is a technical component that can compare and merge sets of model elements. It consists in a diff/merge engine that is designed to prevent data loss and enforce model consistency during merge thanks to consistency rules.&nbsp;The project also provides GUI components and a set of applications. 

It is intended to help develop merge-based features that are useful in model-based engineering. For example: model refactoring, iterative model transformations, bridges between modeling tools, collaborative modeling environments, versioning systems. 

The EMF Diff/Merge project is part of [http://www.eclipse.org/projects/project.php?id=modeling.emf EMF] 

== Context and issues  ==

Merging models is a common need in model-based activities, not only for version control of models but for model manipulation in general. However, it is a much more complex operation than merging source code. This is because models, in the EMF sense, are rich data structures constrained by a metamodel and sometimes subject to implicit engineering rules.&nbsp;Have you ever merged models in the past and obtained incorrect, unexpected or inconsistent results?&nbsp;This is what EMF Diff/Merge seeks to prevent. 

== Tool overview  ==

[[Image:ReducedOverview.png|center]] 

The scope of EMF Diff/Merge covers: 

*A lightweight, configurable engine for comparing and merging EMF-based models in 2-way and 3-way (with common ancestor) configurations.

*Matching of model elements by ID, where an ID can be any "signature" that uniquely identifies the element within its scope: Ecore ID, XML ID, qualified name, location in model tree, etc.

*A GUI with reusable components.

Among others, the tool exhibits the following characteristics: 

*Comparison can be performed on any arbitrary model scope for versatility and scalability reasons.

*Interdependent differences are merged together in order to preserve model consistency.

*The order in which differences are merged has no impact.

*The global impact of a merge can be determined beforehand (picture above).

*Undo/redo of merges is supported.

== Principle of the solution  ==

The usage process is illustrated by the figure below. First, a comparison is created based on the models to compare. The differences between those models are computed according to given policies. Then, as long as differences remain, any subset of these differences can be selected for merging. Every time, predefined consistency rules and user-defined policies are used to compute the minimal superset of differences that must be merged to preserve consistency. The user may decide whether to confirm or cancel the merge of the whole set of differences. 

<br> [[Image:Process.png|center]] 

For a description on how the objectives and the level of abstraction differ from EMF Compare, see the [http://www.eclipse.org/proposals/modeling.emf.edm/ project proposal]. 

== Usage  ==

*[http://wiki.eclipse.org/EMF_DiffMerge/Programmatic_Usage Programmatic usage and concepts] 
*[http://wiki.eclipse.org/EMF_DiffMerge/Default_GUI Default GUI] 
*[https://ci.eclipse.org/diffmerge/job/emf-diffmerge-core-master/javadoc/overview-summary.html Javadoc]

== Applications  ==

*[http://wiki.eclipse.org/EMF_DiffMerge/Patterns Patterns]: a technology for the declarative creation, application, evolution and management of modeling patterns
*[http://wiki.eclipse.org/EMF_DiffMerge/Co-Evolution Co-Evolution]: a technology for model synchronization based on the merge mechanism
*[http://wiki.eclipse.org/EMF_DiffMerge/Model_Patch Model Patch]: a technology for recording, applying and persisting model modifications in a portable, model instance independent way
*Incremental transitions between engineering phases in [http://www.polarsys.org/capella/ Capella]
*Reuse mechanism ("Replicable Elements") in [http://www.polarsys.org/capella/ Capella]

== Presentations  ==

*[http://wiki.eclipse.org/images/4/4c/EDM_ECE12.pdf Overview] at EclipseCon Europe 2012 - Modeling Symposium 
*[http://jaxenter.com/introducing-emf-diff-merge-chat-with-olivier-constant-project-lead-47666.html "New in Kepler" interview] in June 2013 on JAXenter
*[http://wiki.eclipse.org/images/f/fc/EDM_KeplerDemoCamp_Frankfurt_2013.pdf Presentation] at Kepler Demo Camp Frankfurt am Main (2013)
*[https://www.eclipsecon.org/france2015/session/transformations-patterns-version-control-where-there-modeling-there-merging-sponsored-thales Presentation of applications: transformations, patterns, version control] at EclipseCon France 2015 (video [https://www.youtube.com/watch?v=TMkRAEOe20E here])
*Ignite talk "What's new for Neon" at EclipseCon France 2016 (video [https://www.youtube.com/watch?v=U_Pm8k8eyr0#t=352 here])
*[https://www.eclipsecon.org/france2017/session/patching-gap-collaborating-models Presentation of Model Patches] at EclipseCon France 2017 (video [https://www.youtube.com/watch?v=ZHBg5jVBRFw here])
*[https://wiki.eclipse.org/images/7/75/EDM-Unconf-ECE2017.pdf Presentation of EMF Diff/Merge] as part of [https://www.eclipsecon.org/europe2017/schedule_item/guided-tour-eclipse-modeling A Guided Tour of Eclipse Modeling] at the EclipseCon Europe 2017 Unconference

== Download  ==

Click here for the [http://wiki.eclipse.org/EMF_DiffMerge/Download Download page].

== Links  ==

*[https://www.eclipse.org/projects/project.php?id=modeling.emf.diffmerge Project summary]: a summary of the current state of the project

*[https://www.eclipse.org/proposals/modeling.emf.edm/ Project proposal]: the original proposal for the project

*[https://www.eclipse.org/forums/index.php?t=thread&frm_id=246 Forum]: the dedicated newsgroup

*[https://github.com/eclipse/org.eclipse.emf.diffmerge.core GitHub project]: the source code on GitHub

*[https://ci.eclipse.org/diffmerge/ Build jobs]: the location where the project is built

*[[EMF_DiffMerge/Developer|Developer's guide]]: setting up a development environment for contributing