Skip to Content
Getting startedBuild your first model

Build your first model

Create a model, organize its content, and present a small system structure in a Diagram. Choose a system you want to describe and use names appropriate to that system.

Before you begin

You need a running SES Modeler installation. Follow Installation if necessary, or obtain your installation’s web address.

The Model Repository can be empty. You will create the content used in this walkthrough. Screenshots illustrate the controls using a separate model; matching its names or structure is unnecessary.

1. Create the model

  1. Open SES Modeler. If the landing page appears, choose Enter SES Modeler.
  2. If the Welcome screen appears, enter your Display name and choose Enter workspace.
  3. In the Model Repository, choose Create New Model.
  4. Enter a Model name for your project. Optionally add a description and icon.
  5. Choose Create Model.
Create SysML Model dialog with name, description, and icon controls
The dialog is illustrated with the Inspection Drone name. Enter the name of your own model. Open full-size image

The workspace opens with a package bearing your model’s name and a starter view named General.

Choose Model Browser in the left activity rail if the tree is hidden. Expand the top model entry to find its package. Use the package row, rather than the top model entry, when creating content in the next step.

Check: your model is open, and its root package is visible.

2. Create a package and a system definition

  1. Open the root package’s actions menu.
  2. Choose Create Element → package.
  3. Enter a name describing the content it will organize and press Enter.
  4. Open that new package’s actions menu and choose Create Element → part def.
  5. Enter the name of the system you want to describe and press Enter.

A package organizes elements. A part definition describes a reusable kind of system or component.

Model Browser showing a package, a system definition, and owned parts beside a Diagram
Inspection Drone illustration: a package contains a system definition and its parts. Your model will use the names and composition you create. Open full-size image

Check: the package owns your new part definition.

3. Add the system’s parts

  1. Open your system definition’s actions menu and choose Create Element → part.
  2. Enter the name of a component or subsystem and press Enter.
  3. Repeat from the system definition’s menu for the other parts you want to include.

Check: expand the definition to see the parts you created beneath it. Sibling parts appear at the same indentation level.

To describe a component’s own composition, open that part’s actions menu and create its child parts there. The owner you choose determines where each new element belongs.

4. Set a component count

When one named part represents several instances:

  1. Select that part in the Model Browser.
  2. In its inspector, choose Edit multiplicity.
  3. Set Range to Exact count.
  4. Enter the required Count and choose Save.
Nested part selected in the Model Browser with its multiplicity shown in the inspector
Inspection Drone illustration: selecting a nested part opens its properties in the inspector. Open full-size image
Edit feature multiplicity dialog with Exact count selected
This illustration uses a count of four. Enter the count required for the part you selected. Open full-size image

Check: the selected part’s inspector shows your count. Multiplicity records several instances of one role without requiring separately named model elements for each instance.

5. Present the parts in a Diagram

  1. Open your system definition’s actions menu and choose Create View → InterconnectionView.
  2. Enter a name for the view and press Enter.
  3. If its editor is closed, double-click the view in the Model Browser.
  4. Expand the system definition so its parts are visible.
  5. Drag each part you want to present into the system frame in the Diagram.
  6. Arrange the presentations so their names are readable. Use Fit View if needed.

Creating a view does not automatically populate it. Dragging an existing part creates a presentation of that element.

An interconnection Diagram presenting a system's parts and relationships
Inspection Drone illustration: parts are arranged inside the system frame. The pictured connections are additional model content; see Connections and interfaces to create your own. Open full-size image

Check: the frame presents the parts you added. Select a presentation to inspect the same model element shown in the tree.

6. Explain the system

  1. Select your system definition in the Model Browser.
  2. Expand Description and choose Add documentation.
  3. Explain the system’s purpose and the responsibilities of its main parts.
  4. Finish using the editor’s checkmark.

Check: selecting the definition again shows the explanation you saved.

Check your result

Your model should contain the package, definition, and parts you created. Its Diagram should present the intended parts, and the inspector should retain your documentation and any multiplicity changes.

The screenshot’s model hierarchy, extra views, connections, and values are not completion criteria for this walkthrough.

If you get stuck

Cannot find an element? Choose Model Browser, reopen the sidebar if collapsed, clear search and type filters, then expand the owner you used.

Creation kind missing? Use a package’s menu for part def, a system definition’s menu for its part elements, and that definition’s menu for InterconnectionView. If the view kind remains unavailable, check view availability and the installation’s libraries.

Empty Diagram? Drag your existing parts from the Model Browser into the frame.

Version conflict? Keep any text you need, cancel the draft, reload, and retry against the refreshed model.

Continue with Understand the workspace.