Eclipse MOSAIC is a multi-scale simulation framework in the field of smart and connected mobility. It allows coupling simulators from various domains towards a comprehensive simulation tool. Data exchange and time management is implemented by the Runtime Infrastructure (RTI), which is the heart of MOSAIC. Simulation models are coupled to the RTI using HLA inspired interfaces; Each simulator is wrapped into a "Federate" object which is linked to an "Ambassador" which is directly coupled with the RTI. Currently, the following simulators are coupled with the MOSAIC RTI:
- MOSAIC Application (application simulation)
- Eclipse SUMO (traffic simulation)
- OMNeT++ (communication simulation)
- ns-3 (communication simulation)
- MOSAIC Cell Simulator (cellular communication simulation)
- MOSAIC Simple Network Simulator (communication simulation)
- MOSAIC Environment (environment and event simulation)
- MOSAIC Output Generator (evaluation and visualization)
The project is a Maven based multi-module project and has its child modules organized in three main categories:
rti- MOSAIC RTI: modules providing the runtime infrastructure API and implementationlib- MOSAIC Libraries: mathematics, spatial, routing, utilities, communication models, and data exchangefed- MOSAIC Ambassadors/Federates: simulators and couplings which integrate simulation models to Eclipse MOSAIC
View our website at eclipse.org/mosaic for detailed documentation and many tutorials to get started with Eclipse MOSAIC. For a quick start on building and running the code in this repository, just jump to the bottom section of this README file.
This repository contains the Essential edition of Eclipse MOSAIC, that is, the runtime infrastructure, the core libraries, and various implementations of simulators or couplings to existing ones. All features included in this version of Eclipse MOSAIC are sufficient for most use-cases in the field of smart and connected mobility. Additional simulators and assessment features are provided by Fraunhofer FOKUS on a commercial basis.
- Eclipse SUMO is coupled directly using the TraCI interface. We recommend using the SUMO release
1.16.0. - The coupling to ns-3 is realized by a federate implementation which can be found in our MOSAIC Addons repository.
We currently support ns-3 version
3.36.1. - The coupling to OMNeT++ is implemented in a very similar manner. The corresponding federate implementation can be found in our MOSAIC Addons repository.
We currently support OMNeT++ version
5.5in combination with the INET framework in version4.1. - We created the Berlin SUMO Traffic (BeST) scenario which provides 2.2 million vehicle trips in 24h for Berlin, Germany. The scenario is fully compatible with the latest release of MOSAIC.
Any questions regarding Eclipse MOSAIC can be asked, discussed, and found in the Discussion section here at GitHub.
For further questions we are available via mosaic@fokus.fraunhofer.de
For a successful build you need the following software to be installed:
- Maven 3.1.x or higher.
- Java 8, 11, or 17 - We recommend using the Adoptium OpenJDK (aka Eclipse Temurin).
- SUMO 1.16.0 - Additionally, the environment variable
SUMO_HOMEshould be configured properly.
Eclipse MOSAIC is a Java base project using Apache Maven for build and dependency management.
Once installed, you can build Eclipse MOSAIC using the following command:
mvn clean install
This command executes all tests as well. In order to skip test execution, the following command succeeds:
mvn install -DskipTests
After building, a MOSAIC bundle including a start script and all necessary configurations is located in the bundle\target directory.
After extracting this bundle to an arbitrary path, Eclipse MOSAIC can be executed using:
mosaic.sh -s HelloWorld
mosaic.bat -s HelloWorld
Besides, the simulation can also be started in your IDE using the main method in org.eclipse.mosaic.starter.MosaicStarter.
Eclipse MOSAIC is licensed under the Eclipse Public License Version 2.
Before starting with contributions, please see CONTRIBUTING information.