In this module, you will learn how SysML v2 expresses a system in both text and diagrams, then apply that understanding in a practical modeling workflow.
Understand
Build the mental model before touching syntax.
Read
Connect textual notation to system meaning.
Apply
Practice with a model, AI, and Mg software.
Modeling mindset
A good model turns complexity into something you can reason about.
Lesson 01 / Initial Theory
Model the system before the syntax
SysML v2 helps you describe a system from the outside in: what it is made of, where it interacts with the world, and how its internal elements relate to one another.
Parts
Parts describe the meaningful building blocks that make up the system.
Ports
Ports show where energy, material, or information enters and leaves.
Connections
Connections make interactions explicit instead of leaving them implied.
A useful rule of thumb: if someone can see the system boundary, its main parts, and their relationships, your model is already doing valuable work.
Lesson 01 / Initial Theory
Read the structure in code
The textual form is compact, precise, and version-friendly. Each line should communicate a modeling decision, not just satisfy syntax.
Example.sysml
part def CameraSystem {
part sensor : ImageSensor;
part processor : VisionProcessor;
port imageOut;
port powerIn;
connect sensor.image -> processor.input;
}
What to notice
01
The system is defined once, then composed from smaller parts.
02
Ports identify external interaction points without exposing every internal detail.
03
The connection tells us how one internal element exchanges information with another.
Lesson 01 / Initial Theory
See the same idea visually
The graphical notation is not a different model. It is another view of the same model, optimized for quick interpretation and discussion.
Internal Structure View
Three parts, two flows, one readable system.
part
Sensor
part
Controller
part
Actuator
measurement
command
Why this matters
Text gives precision. Diagrams give orientation. Strong modelers use both views to tell the same story.
Lesson 01 / Initial Theory
Your turn: build a simple system
Use the concept you just reviewed to sketch a small but complete system model of your own.
Modeling brief
Create a model for an automatic greenhouse watering system.
01
Define the system and at least three internal parts.
02
Add one information port and one material or energy port.
03
Show at least one explicit connection between internal parts.
Keep it small. A clear model of a small system is better than a vague model of a large one.
Lesson 01 / Initial Theory
Move from lesson to tool
Now take the same structure into Mg and experience the model in a real authoring environment.
Open
Launch Mg and start a new practice file for this module.
Build
Enter your system, parts, ports, and connection using textual notation.
Inspect
Switch to the graphical view and compare it with your intent.
⚠ Mg must be running locally on your machine. Make sure it is started before opening the link.
Lesson 01 / Initial Theory
Use AI as a reviewer, not a shortcut
A useful AI workflow is to ask for critique after you have made your own modeling decisions.
Insert this into Grok with your code pasted in the specified spot.
You are a SysML v2 instructor.
Analyze the SysML v2 code below.
Provide:
1. A simple explanation of what the model represents.
2. Any syntax errors.
3. Any modeling or logical errors.
4. Missing parts, attributes, dimensions, relationships, or behaviors.
5. Suggestions for improvement.
6. A score from 1-10.
7. An improved version of the SysML v2 code.
Use beginner-friendly language and explain issues clearly.
SYSML V2 CODE:
Review for
Does the model describe the right system?
Are the parts meaningful rather than arbitrary?
Would another engineer understand the interactions?
Lesson 01 / Initial Theory
Check your understanding
Try this sample certification-style question before you move on.
Question 01
Which statement best describes the role of a port in a SysML v2 structural model?
Correct. Ports represent interaction points, which is why they are so useful for expressing interfaces and exchanges.
Not quite. Revisit the theory page and focus on how ports help describe where the system interacts with other elements.
Congratulations on completing this module!
You've mastered this module of Learn SysML v2. Continue your learning journey and apply these skills to your own system models.
