Hands‐on Data Modeling with SAMM in Tractus‐X - eclipse-tractusx/eclipse-tractusx.github.io GitHub Wiki

Why should you join?

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.

Responsible, Contact Person

  • 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

Challenges -> Description

Create Aspect Model and Submodel Template with ESMF

  1. 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
  1. Generate Submodel Template (SMT) from aspect model using ESMF CLI

Prerequisites/Requirements

For the workshop you should download the editors and SDK beforehand

Aspect Model Editor

ESMF 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


Tipps and Tricks - Useful Links

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


More useful links

ESMF

SAMM AAS Mapping

Specifications Asset Administration Shell

Slides from the Workshop

Tractus-X CommunityDays Workshop.pdf

Tractus-X Days 2025-05 AASX Package Explorer.pdf

⚠️ **GitHub.com Fallback** ⚠️