Ran Wei / MBSE Series / Module 7
中文
MBSE Series — Ran Wei

Module 7: MagicGrid

A structured matrix approach to organising MBSE models by abstraction level and concern — with a running EV charging station example.

Prerequisite: MBSE Module 6 — OOSEM

1

MagicGrid Origins

MagicGrid was developed by No Magic (now part of Dassault Systèmes) as a practical, prescriptive MBSE methodology. Unlike academic frameworks that describe principles in the abstract, MagicGrid was designed from the outset to be directly usable — providing a clear, step-by-step recipe for populating an MBSE model.

The methodology emerged from years of consulting experience with Cameo Systems Modeler and was first documented publicly in the MBSE Grid-Based Approach technical paper by No Magic. Its goal was to answer a deceptively simple question: "I have a modelling tool open — what do I model first, and where does each diagram go?"

Design philosophy

MagicGrid rests on two organising principles:

The intersection of a row (abstraction level) and a column (concern) tells you exactly which SysML diagrams and model elements to create. This makes MagicGrid highly approachable for teams new to MBSE.

NOTE

Although MagicGrid was developed alongside Cameo Systems Modeler, the underlying concepts are tool-agnostic. The grid structure, abstraction levels, and concern columns can be applied with any SysML-capable tool — including open-source options like Eclipse Papyrus or the emerging SysML v2 tooling ecosystem.

2

The Grid Structure

The core of MagicGrid is a 3 × 4 matrix. Rows represent abstraction levels; columns represent engineering concerns. Every model element you create has a well-defined "address" inside this grid.

ANALOGY

Think of MagicGrid as a spreadsheet where the rows are "zoom levels" (how much detail you see) and the columns are "aspects" (what kind of detail you are looking at). Just as you would not mix revenue numbers with headcount data in the same spreadsheet column, you do not mix structural diagrams with behavioural diagrams in the same grid cell.

Rows — abstraction levels

Columns — engineering concerns

The 3 × 4 grid at a glance

RequirementsStructureBehaviourParametrics
Problem Domain
(Black Box)
Stakeholder needs, system-level requirementsSystem context diagram, external actorsUse cases, high-level activity diagramsMeasures of effectiveness (MoE), key performance parameters
Solution Domain
(White Box)
Subsystem requirements, derived requirementsLogical architecture, internal block diagramsState machines, detailed activity diagrams, sequence diagramsConstraint blocks, trade-off equations
ImplementationInterface requirements, component specsPhysical architecture, allocated componentsImplementation-level interactions, deployment sequencesVerification constraints, test parameters

Table 1 — The MagicGrid 3 × 4 matrix with example artifacts

The grid is typically worked through top-to-bottom (from problem domain down to implementation) and roughly left-to-right within each row, though iteration across cells is expected and encouraged.

3

Problem Domain (Black Box)

In the problem domain row, the system is treated as an opaque box. We define what it must do without deciding how. This forces the engineering team to fully understand the problem before jumping to solutions.

Running example: EV Charging Station

Throughout this module, we will use an EV charging station as a running example. This is a system that charges electric vehicles, processes payments, communicates with the electricity grid, and provides status information to station owners.

Stakeholders

The first step in the problem domain is identifying who interacts with the system and who has an interest in it:

Use cases

Use cases capture the externally visible functions of the system:

System context

A system context diagram at this level shows the EV charging station as a single block, surrounded by its actors (EV Driver, Grid Operator, Station Owner) and external systems (payment gateway, electricity grid, cloud monitoring platform). All interfaces are external — we do not yet show what is inside the station.

Measures of effectiveness

Parametrics in the problem domain capture high-level performance targets:

TIP

Resist the temptation to jump into internal design at this stage. The black-box discipline ensures that every requirement traces back to a genuine stakeholder need — not to an assumed technical solution. If you find yourself discussing specific hardware or software choices, you have moved to the solution domain too early.

4

Solution Domain (White Box)

Having defined what the system must do, we now open the box and describe how it achieves those goals. The solution domain introduces the logical architecture — subsystems, internal interfaces, state machines, and detailed behaviour.

Logical decomposition

For our EV charging station, the logical subsystems include:

Internal structure

An internal block diagram at this level shows how the four subsystems connect. The Charging Controller exchanges power commands with Energy Management; the Payment Processor sends authorisation status to the Charging Controller (charging only begins after payment is confirmed); and the User Interface communicates with all other subsystems to display status.

Behaviour modelling

State machines describe the lifecycle of a charging session: Idle → Authenticating → Charging → Complete → Idle, with fault transitions from any state to a Faulted state. Activity diagrams detail the sequence of internal operations within each state transition.

Constraint blocks

Parametric constraints at the solution level express engineering trade-offs. For example, a constraint block might relate charging power, cable temperature, and session duration to ensure that thermal limits are never exceeded.

NOTE

Every element in the solution domain should trace back to a problem-domain requirement. The Charging Controller exists because there is a "Charge Vehicle" use case. The Payment Processor exists because there is a "Process Payment" use case. If a solution-domain element has no traceability to the problem domain, question whether it is needed.

5

Implementation Domain

The implementation row bridges the gap between the logical architecture and the real world. Here, logical subsystems are allocated to physical components, and interface specifications become concrete.

From logical to physical

The allocation from solution-domain subsystems to implementation-domain components for our EV charging station:

Interface specifications

At the implementation level, interfaces become concrete protocols and physical connectors:

Verification constraints

Parametric constraints at this level map directly to test procedures. For example: "The NFC reader shall complete a contactless transaction in under 500 ms" is a testable constraint allocated to the Payment Processor hardware.

TIP

The implementation domain is where MagicGrid connects to procurement and manufacturing. Each physical component in this row should be traceable upward to a logical subsystem (solution domain) and ultimately to a stakeholder need (problem domain). This end-to-end traceability is one of MBSE's greatest strengths — and MagicGrid's grid structure makes it visible at a glance.

6

MagicGrid vs. OOSEM

Module 6 introduced OOSEM (Object-Oriented Systems Engineering Method). Both OOSEM and MagicGrid are widely used MBSE frameworks, but they differ in philosophy, organisation, and emphasis. The table below compares them across six dimensions.

DimensionMagicGridOOSEM
OriginNo Magic / Dassault Systèmes — born from tool-vendor consultingINCOSE / Lockheed Martin — born from systems engineering practice
Process StyleGrid-based, prescriptive: "fill in each cell"Process-oriented, iterative: "follow the lifecycle steps"
Model OrganisationHighly structured — the 3×4 matrix defines exactly where every artifact livesFlexible — organised around process phases (stakeholder needs analysis, requirements analysis, logical architecture, etc.)
Language DependencyDesigned for SysML but tool-agnostic in principleLanguage-agnostic; commonly used with SysML v1 and v2
Best ForTeams wanting a clear, repeatable recipe; organisations new to MBSEExperienced SE teams who need flexibility; projects with complex stakeholder landscapes
ComplexityLower learning curve — the grid provides immediate structureHigher learning curve — more process discipline required, but greater adaptability

Table 2 — MagicGrid vs. OOSEM comparison

In practice, the two frameworks are not mutually exclusive. Many organisations adopt MagicGrid's model organisation (the 3×4 grid) while following OOSEM's process steps within each cell. The key is to choose the approach — or combination — that best fits your team's maturity and project context.

Up Next

Module 8 — IBM Harmony — A use-case-driven, architecture-centric approach with strong behaviour emphasis.