Introduction

Maven allows hierarchical project structures, where one projects can contain one or more modules – which are essentially independent projects. MATSim uses such so-called "multi-module projects" for the Contributions and Playgrounds. Eclipse can generate for each module a project, so you can specify which modules (e.g. contributions, playgrounds) you really need and you will not have to care about the other projects.

Creating Eclipse Projects from Maven Modules (Eclipse 3.7)

To create an Eclipse project for a Maven module (e.g. a specific Contribution or specific Playground), follow these steps:

• Select the "contrib" or "playground" project in the Package Explorer
• Choose "File > Import" and there "Maven > Existing Maven Projects". Click on "Next".
• In the following dialog, the list of available contributions/playgrounds will be listed.
• Select the contributions/playgrounds that you want to have as projects in Eclipse. 
• If you are using working sets, you can add the to-be-created projects to a working set. If not, it doesn't matter.
• Click on "Finish" to generate Eclipse Projects for all the selected modules.

Creating Eclipse Projects from Maven Modules (Eclipse 3.6)

To create an Eclipse project for a Maven module (e.g. a specific Contribution or specific Playground), follow these steps:

• Choose "File > Import" and there "Maven > Materialize Maven Projects".
• Click twice on "Next", then on "Finish".
• In the next dialog, select the Playgrounds (or Contributions) location as the Root Directory (this is the actual directory on your file system). You should then see a list of all available modules in the project.
   
• Select the modules you want to use.
• If you are using working sets, you can add the to-be-created projects to a working set. If not, it doesn't matter.
• Click on "Finish" to generate Eclipse Projects for all the selected modules.

Getting rid of unused Eclipse Projects representing Maven Modules

If you have Eclipse Projects representing Maven Modules you no longer need, you can simply delete the Projects in Eclipse's Project Explorer like you delete any other project. Just make sure the option "Delete project contents on disk" is not activated.