The Semantic Aspect Meta Model (SAMM) allows the creation of models to describe the semantics of digital twins by defining their domain specific aspects. In this context, digital twins are the digital representation of a physical or virtual object that bundles and combines several aspects. SAMM provides a set of predefined objects (as depicted below) that allow a domain expert to define Aspect Models and complement a digital twin with a semantic foundation.
SAMM was previously known as BAMM (BAMM Aspect Meta Model).
The source files (AsciiDoc) are built using Maven and Antora, which generates the documentation as HTML files.
SAMM standardizes the creation of domain specific Aspect Models and also makes them reusable. Therefore, the created aspects can be used in several different digital twins.
Imagine an automated guided vehicle (AGV) and its digital representation. The AGV digital twin could encompass aspects, such as its movement position or battery state. However, both aspects could also be part of other digital twins. This modularization and reusability simplifies the creation of highly complex use cases.
SAMM and its SDKs evolve over time. While measures are taken to do this in a non-breaking manner, some changes cannot be carried out without the need to define a new, breaking version.
SAMM uses semantic versioning (
major.minor.micro) with the following rules:
majorpart designates major changes in the meta model and can imply breaking changes
- A non-breaking change in the meta model or a change to the model elements that are
part of SAMM (
samm-e) increases the
- Changes to existing features or bugfixes increase the
Are you having trouble with Semantic Aspect Meta Model? We want to help!
- Check the reference documentation.
- Ask a question the community forum.
- Having issues with SAMM? Open a GitHub issue.
To build the Antora documentation locally, clone the repository and run
./mvnw generate-resources -pl documentation -Pantora
inside the repository folder.
Navigate to build > site and open the
index.html page in your web browser to see the result.
Repeat the steps everytime you make any changes in the documentation and want to inspect the final outcome.
./mvnw generate-sources -pl documentation -Prender-diagrams
In order to render the diagrams and the Antora documentation in one step, run
./mvnw generate-resources -pl documentation -Prender-diagrams,antora
Note that for GraphViz .dot files, you can include a line like the following to choose the layout
engine to use:
// PRAGMA LAYOUT-ENGINE: neato. Allowed values
are circo, dot, neato, osage, twopi, and fdp. If left out, the default is dot.
To build the Semantic Aspect Meta Model Java artifact, run
./mvnw clean install -pl esmf-samm-build-plugin ./mvnw clean package -pl esmf-semantic-aspect-meta-model
This will compile the code and run all tests. The resulting JAR file can be found under esmf-semantic-aspect-meta-model > target. Please be aware, that you need JDK 11 to run build and tests.
Before making a contribution, please take a look at the contribution guidelines. Please keep in mind to create an issue first before opening a pull request.