Hands‐on Data Modeling with SAMM in Tractus‐X - eclipse-tractusx/eclipse-tractusx.github.io GitHub Wiki
Get a hands-on kickstart on modeling with SAMM and defining the data exchange standards in Tracus-X
Are you a modeler?
Or you want to learn or at least get a first impression how modelling for Digital Twins works in practice?
The role of model stewards is crucial for the success of data exchange in dataspaces like Catena-X or the new projects in the context of Manufacturing-X, to mention only Factory-X - The Digital Ecosystem as the biggest one. First thing to agree on is which data should be exchanged in which use case and what exactly is the meaning (= semantics) of the data being exchanged.
If you are interested then join this Tutorial at the 4th Tractus-X Community Days.
We are offering beginners, and experienced model stewards a session on semantic modeling with SAMM and how to contribute to the semantic modeling process in Tractus-X. You will learn how to work with the Semantic Aspect Modeler an open source tool within the Eclipse Foundation Top Level Project „Digital Twin“ driven by the IDTA - Industrial Digital Twin Association.
- Tomasz Jacewski Expert for Semantic Modelling, Bosch
- Rolf Bosse Member Technical Committee for Modelling in Catena-X e.V. and Lead CX-NEXT TAP3.2, Mercedes-Benz
- Lena Sauermann Member Digital Twin Expert Group, msg
- Markus Samarajiwa Subject Matter Expert Digital Twin, msg Industry Solution Consulting
- Johann Schuetz Senior Expert Standardization, Semantics Manager, Catena-X Automotive Network e.V.
- Birgit Boss Lead Technical Committee for Modelling in Catena-X e.V. and Lead Workgroup Open Technology in IDTA
Create Aspect Model and Submodel Template with ESMF
- Create your first aspect model using the Aspect Model Editor (AME). As an example we will be modeling the diagnostic trouble code list of a vehicle. A diagnostic trouble code (DTC) is a standardized error or warning code issued by different subsystems of a vehicle and can be used by a service technician to analyze any issues with a vehicle. The domain expert has given you the following description of the data.
- What you want to have is the list of "diagnostic trouble codes" from the OBD system
- Each code comes with a timestamp
- Each code has three digits
- The first indicates the affected subsystem P=Powertrain C=Chassis U=Network B=Body
- The next two are a fault code, where the first is between 0-3, the second between A-Z
- There is a time given when the DTC list of DTCs was cleared the last time
- …Yes, it also tells you (in hours) for how long the car was driven while at least one fault was present
- Generate Submodel Template (SMT) from aspect model using ESMF CLI
For the workshop you should download the editors and SDK beforehand
Aspect Model Editor
AASX Package Explorer (only Windows, optional):
AASX Package Explorer - download aasx-package-explorer.2025-03-25.alpha.zip
ESMF CLI for Generation and Validation
ESMF SDK - samm-cli-2.9.6-windows-x86_64
ESMF SDK - samm-cli-2.9.6-linux*
AAS Test Engines for validation of Submodel Templates (optional)
Follow installation guide for AAS Test Engine
Download example models
Create an aspect model Modeling with the Aspect Model Editor
Import aspect model to AASX Package Explorer
File→Import…→Import SAMM Aspect into Concept Descriptions… File→Import…→Import SAMM Aspect into Concept Descriptions…Known restrictions: this file will not validate because it is using extensions for supporting aspect models
Specifications Asset Administration Shell