# Setting up the Eclipse Modelling Tools

## Download Eclipse Modelling tools

Currently Photon is the latest stable release of Eclipse. You can download the Eclipse installer from the [general download page](https://www.eclipse.org/downloads/) and select the Eclipse Modelling Tools from the list of options after running the executable.

## Setting up Eclipse Modelling Tools

After downloading and installing Eclipse and Eclipse Modelling Tools, you start Eclipse by double clicking on the created icon on the Desktop (if you are using Windows...). It will ask you where you want to place your workspace files. Select a logical location and you end up with a welcome screen.

If you did not clone the repository yet, now is a good moment with your preferred GIT tool or use Eclipse to import the repository directly.

![](https://2468807995-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LEUR-fboF2eOWi4I9zf%2F-LF1leVCl03ke0VRWD6M%2F-LF1mlFH3DsfR490J0py%2Fimport.png?alt=media\&token=45c92ddb-b492-4357-b2e3-01e71be772d7)

Next step is importing the ESDL git repository by using File -> Import... If you already cloned the repository locally, use _Existing Project into Workspace_ and the project will be imported. If you want to directly import the project from Git, use Git->Projects from Git.

After importing, the _Package explorer_ will show the following files and directories:

![](https://2468807995-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LEUR-fboF2eOWi4I9zf%2F-LF1alYGO74fdayDMriz%2F-LF1lOut78H1arzsajky%2Fpackage-explorer.PNG?alt=media\&token=f9a60242-53d5-41d3-bee9-c4dc67ba6a40)

In the model folder you see several files:

* `esdl.aird` - In this file the graphical representation of the ESDL concepts are documented, such as the (x,y) location of the classes, the colour of the classes, the font, etc. It allows us to visually modify the contents of the ESDL model. If you double click you can open the ESDL model diagram editor and manipulate the model.
* `esdl.ecore` - This is ESDL. The UML-based model describing all ESDL concepts: the vocabulary and grammar of an Energy System. If you double click you can edit the ESDL model using a tree-based structure (less convenient than the diagram editor)
* `esdl.genmodel` - This file describes how to generate Java-files and XSD Schemas from an `ecore`-file. It contains a dozen configuration options.
* `esdlXML.xsd` - this is the XML Schema file for ESDL
* `esdlXML.xsd2ecore` - maps the XSD to the `Ecore` model.

Double clicking on the aird-file opens the following dialog:

![](https://2468807995-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LEUR-fboF2eOWi4I9zf%2F-LF1pLAoTkbgDcKZFG2_%2F-LF1pNlEv-z7ud9fDqGm%2Faird.png?alt=media\&token=c219ac87-7cde-4446-8162-9d125f1f828f)

The AIRD file shows the model dependencies and representation. The Design->Entities in a Class Diagram is the most interesting. Double click on `esdl` to open this representation.

There is also a Review representation that shows all the documentation in the model. (although this is work in progress).

![](https://2468807995-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LEUR-fboF2eOWi4I9zf%2F-LF1snPD6K7WysLM7XFd%2F-LF1srRzdkAmICQ0F6Dr%2Fesdl-diagram-editor.png?alt=media\&token=edf515a6-57d3-4e26-aee9-407b9a99f041)

Now you're setup to edit the Energy System Description Language!
