This is an old revision of the document!

SysML v1 to v2 Transition Guidance Project

Project Overview

The INCOSE SysML v2 Transition Activity Team is being sponsored by the US Department of War (DoW) Digital Engineering, Modeling and Simulation office (DEM&S). The project name is “SysML v1 to SysML v2 Transition Guidance Project.” The project is intended to provide early guidance in the form of recommendations to assist organizations, projects, and practitioners in their transition from a model-based systems engineering (MBSE) approach using SysML v1 to an MBSE approach using SysML v2. This is not official government guidance. This is a collaborative effort that is drawing from input from across the MBSE community and is intended as an open and public effort.

The OMG Systems Modeling Language™ Version 2 beta specifications were adopted in June 2023. Finalized specifications were published by OMG in September 2025. The SysML v2 submission concluded seven years of development, resulting in three specifications and an open-source pilot implementation to validate them (using the beta specs). These specifications enable next-generation systems modeling with improved precision, expressiveness, consistency, usability, interoperability, and extensibility over SysML version 1. The three specifications are:

1.Kernel Modeling Language (KerML) specification version 1.0 - defines a new metamodel to provide the foundation for SysML v2. Its formal semantics specified as first order of logic with 4D temporal and spatial extent, provide a new level of precision.

2.Systems Modeling Language (SysML) specification version 2.0 - provides the expressive capability to model complex systems and complementary textual and graphical representations that facilitate improved system understanding.

3.SysML Application Programming Interface (API) and Services specification version 1.0 - provides standard services to navigate, query, and update the model that enables interoperability with other tools and software applications throughout the lifecycle of system development.

Content derived from OUSW (R&E) publicly available material

Terminology

Term	Definition
Model Conversion	The process for converting a baseline SysML v1 model to a baseline SysML v2 model that includes pre-processing the SysML v1 model, transforming the SysML v1 model to a SysML v2 model, post-processing the SysML v2 model, validating the SysML v2 model, and assessing the impact on other artifacts generated or derived from the model.
Transform	A step in the model conversion process which translates a conformant SysML v1 model to a conformant SysML v2 model.
Transition	The process that an organization or project implements to update their SysML v1 modeling environment, practices, training, and related assets to support SysML v2 modeling.

Content derived from OUSW (R&E) publicly available material

Guidance Products

Product	Description
Frequently Asked Questions	58 Frequently Asked Questions stakeholders might have, along with the latest answers to those questions. These questions came from community input at the 2023 INCOSE International Workshop.
Transition Plan Outline	This product page provides an outline and recommended approach around what to plan for and consider when transitioning from SysML v1 to v2.
Tool Consideration Checklist	A list of points to consider based on experience converting models from SysML v1 to v2. For tool users and developers, use this list as possible features to consider in a tool that supports v2.
Modeling Environment Setup	Instruction to help with setting up your own SysML v2 textual notation model development environment.
Model Conversion Process	Example approach to converting a model from SysML v1 to v2. This page also includes links to documented conversion efforts.
Model Conversion Examples	A collection of links to example v1 models and v2 conversion results that can be downloaded and tinkered with should you choose to try your hand at converting models or testing v2 features.
Flashlight Starter Model	This page includes a short description of the SysML v2 Starter Model along with links to a tutorial and completed v2 flashlight model. This product is a learning aid for getting comfortable with v2.
Tool Capability Summary	This matrix provides a summary of capabilities from 20+ tool vendors. The file is designed to aid in narrowing down v2 tool options depending on the customer's needs. Complete the available input form to add a tool.
Quick Reference Guide	This “cheat sheet” serves as a visual aid to help remind modelers who are accustomed to v1 what the equivalent syntax is for many of the most common modeling actions in v2 language.
Learning Resource List	Working list of available learning resources. The list will grow as learning opportunities are submitted to our team via the available input form.