Quick Start Guide

After the installation of the CARMA Eclipse Plug-In you can start specifying your first system in CARMA.

First of all a CARMA Project has to be created. Select File -> New -> Other… 

Screen Shot 2015-10-11 at 13.58.27

After that select CARMA Project under the CARMA category and click on button Next:

Screen Shot 2015-10-11 at 14.01.46

Give a name to the project and click on Finish.

Screen Shot 2015-10-11 at 14.08.31

The New CARMA Project Wizard creates a new project in the current Workspace. In the project you can find a simple CARMA specification that is used to illustrate the basic structure of a .carma file:

Screen Shot 2015-10-11 at 14.15.18

Warning: The New CARMA Project wizard installs in the created project all the required Eclipse bundles. If you open or create a .carma file in a different project you can access to the syntax highlight features but you cannot use the simulation tool provided with CARMA.

Double-click on Example.carma to open the editor.

Screen Shot 2015-10-11 at 14.21.20

Given a CARMA specification, the CARMA Eclipse Plug-in automatically generates the Java classes providing the machinery to simulate the model.

Screen Shot 2015-10-11 at 14.22.19

To access the simulation features, a user can use the Carma Simulation View: 

Screen Shot 2016-10-06 at 15.30.39

In the view the following commands are available:

  • add_obj Add a new experiment to the selected project 
  • delete_obj Delete the selected experiment
  • write_obj Edit selected experiment
  • saveall_edit Save all experiments
  • save_edit Save the experiments of selected projects
  • lrun_obj Run selected experiment
  • copy Copy selected experiment
  • chart_line Plot experiment results
  • datasheet Save experiment results into CSV a file.

Carma Simulation View can be used to create new experiments


after that a dialogue box pops up to choose the model and the system to simulate and the appropriate values to execute the simulation:

The experiment is then created and added in the view:

A simulation experiment can be selected and then executed:

Screen Shot 2016-10-06 at 15.57.14

Screen Shot 2015-10-11 at 14.50.14

When the simulation completes, collected results are reported in the view and can be plotted chart_line in the Experiment Results View or saved in a CSV file datasheet.

Screen Shot 2016-10-06 at 16.02.53

Screen Shot 2016-10-06 at 16.04.14

Experiments can be saved in inside the project via buttons saveall_edit save_edit to let them available for further analysis.