EMT (ERE-ML-Tool)

ERE-ML is a framework for model driven development of Multi-Agent Systems (MAS) in Emergency Response Environments (ERE). This framework includes four main components (1) a domain-specific modeling language named ERE-ML for modeling emergency response environments (2) a modeling tool named EMT (3) transformation code for automatic transformation of the model into the code, and (4) the platform for executing the generated code. The framework is an Eclipse plug-in which adds the following capabilities to it:

1. The capability of modeling an emergency response environment including disasters, organizations, tasks, and agents.
2. The capability of model checking against predefined constraints. This will determine that:
3. The capability of automatic code generating from the model.
   • Are the teams organized properly in the relevant organizations?
   • Are the tasks properly assigned to each team?
   • Are the required resources provided to the teams to perform tasks?
4. The capability of code executing. By executing the Java project, the geographical map of the environment with disasters, organizations, and agents are shown and the crisis manager can see the team formation, tasks assignment and perform tasks by choosing Organize Team, Assign Tasks and Perform Tasks options respectively.

Instructions:

For using the framework, follow these instructions:

Prerequisites:

• Eclipse epsilon: You can download it from https://www.eclipse.org/epsilon/download/

A) Modeling

1. download EMT plugin and extract it into the dropins folder of Eclipse and re-run the eclipse.exe.
2. Create new general project (File > new project > general project), and choose a name for it (for example “ERE_diagrams”).
3. Right click on ERE_diagrams project and select new > example > Ereml diagram. Choose a name for your diagram (for example “Victoria_bushfire”). So two new files with “.masml” and “.masml_diagram” extentions will be create.
4. Open .masml_diagram file and draw a model for an ERE scenario by using MAS and ERE nodes and relationships.
5. After modelling the ERE scenario, it should be validated. In order to do this, from Edit menu select Validate. (you can see probably errors of your model in “problems view” of eclipse). For correct code generation, these errors should be fixed.

B) Automatic Code Generation

1. Import org.eclipse.acceleo.module.EREML project into the eclipse.
2. Import ERE_diagrams project created in section “A”, into the same workspace.
3. Run EREMLToJava.mtl file in org.eclipse.acceleo.module.EREML project as acceleo application. In “Run Configurations” window you should set Model, Target, and Runner:
   • Browse your model from ERE_diagrams by typing it’s name.masml
   • Select an empty java project as Target
   • Choose “Acceleo plug-in Application” as Runner
   • Click on the Run button to generate java files into the target folder.

C) Running Generated Codes

1. Copy jamder folder from JAMDER.rar file in to the “src” folder of your target java project.
2. Add JADE library in to your project. Follow these instructions:
   • Download jade.jar file.
   • Right click on your java project, and select properties.
   • In opened window, select “Java Build Path” from left hand side.
   • In “Libraries” tab, select “Add External JARs” and add jade.jar file in to the project.
3. Run the project as java application.

Samples:

• Victoria Bushfire Disaster Model => Automatic Generated Codes

• Fokoshima Nuclear Disaster Model => Automatic Generated Codes

• Bam Earthquack Disaster Model => Automatic Generated Codes

• Plasco Tower Collapse Model => Automatic Generated Codes