Get Started

Syside Derisker is a SysML v2 library and associated tool for reliability analysis and beyond. It supports design/process FMEA and other FuSa methods compliant with ISO26262, AIAG/VDA, ECSS industry standards. The tool requires Syside Automator to provide bidirectional SysML v2 - Python interface.

Note

Sensmetry offers ISO26262, AIAG/VDA, ECSS libraries, that are already available today to take advantage of SysML v2 and Syside for reliability analysis. The associated Syside Derisker tool is in development to further support analysis, sign up for free early adopter version at syside@sensmetry.com

This guide will help you install Syside Derisker. It covers system requirements, extension and dependency installation steps, and updating.

Install Derisker

Minimum Requirements

  • System requirements:

    • Windows 10+ x64 or arm64 (for older versions, install Windows UCRT)

  • System requirements:

    • macOS Big Sur (11.0+, arm64)

    • macOS High Sierra (10.13+, x64)

  • System requirements:

    • Linux x64 distribution with GNU C Library glibc >= 2.31

    Note

    Some Linux distributions like Alpine and Chimera do not include glibc and may not support running applications that require it.


Install Dependencies

Install Graphviz

Graphviz is open source graph visualization software. Syside Derisker uses it for visualizing failure chains.

Download and install from Graphviz download page

  • Homebrew:

    brew install graphviz
    
  • MacPorts:

    sudo port install graphviz
    
  • Debian/Ubuntu:

    sudo apt-get install graphviz
    
  • Fedora:

    sudo dnf install graphviz
    

Note

Derisker extension needs to find the dot executable provided by Graphviz. Make sure the directory containing the dot executable exists in the PATH or Path environment variable.

Install Syside Modeler

Syside Modeler is a prerequisite for Derisker.

Tip

For VS Code users: You can skip this section as Derisker extension automatically installs Modeler as a dependency.

  1. Open Visual Studio Code

  2. Open Extensions view (click in left sidebar or press Ctrl/Cmd-Shift-X)

  3. In the search bar, type Syside Modeler

  4. Click Install on Syside Modeler by Sensmetry (identifier sensmetry.syside-modeler)

Extension can also be installed from Marketplace directly.

  1. Download Syside Modeler extension (may take a few seconds to start)

    Other platforms: Windows | macOS (Intel) | macOS (ARM) | Linux
  2. Open Visual Studio Code or your preferred VSCodium-based editor

  3. Open VSIX installation window:

    1. via Extensions view:

      1. Click in left sidebar or press Ctrl/Cmd-Shift-X

      2. Drag and drop the downloaded syside-modeler-*.vsix file to the Extensions panel (alternatively, click and Install from VSIX…)

    2. via Command Palette:

      1. Open the Command Palette Ctrl/Cmd-Shift-P

      2. Type Extensions: Install from VSIX…

      3. Select downloaded syside-modeler-*.vsix file and click Install


Install Extension

  1. Download Syside Derisker extension

  2. Open Visual Studio Code or your preferred VSCodium-based editor

  3. Open VSIX installation window:

    1. via Extensions view:

      1. Click in left sidebar or press Ctrl/Cmd-Shift-X

      2. Drag and drop the downloaded syside-derisker-*.vsix file to the Extensions panel (alternatively, click and Install from VSIX…)

    2. via Command Palette:

      1. Open the Command Palette Ctrl/Cmd-Shift-P

      2. Type Extensions: Install from VSIX…

      3. Select downloaded syside-derisker-*.vsix file and click Install

Warning

Extensions installed from VSIX files do not receive automatic updates. To update Syside Derisker, see Update Derisker section.


Set Up Project Environment

Derisker uses Syside Automator to parse SysML v2 models and synchronize changes between the table view and your model files. The Python environment is installed per-project in a virtual environment (.venv folder) within your workspace, keeping dependencies isolated.

Note

This setup is required once per project. Once complete, you only need to provide the SysML package name and system architecture when performing analysis.

  1. Open a workspace folder containing your SysML v2 model files

  2. Open Derisker panel (click the in left sidebar)

  3. Click the Install Python and Dependencies button

This will:

  • Verify that Graphviz is installed

  • Create a Python virtual environment (.venv) in your workspace root

  • Install all required Python packages

Note

If you have never used Syside Modeler before, you will be prompted to input your license key.

  1. Open a terminal and create a Python virtual environment

    python -m venv .venv
    
  2. Activate the created virtual environment (see How to manually activate virtual environment)

  3. Install Python dependencies:

    pip install syside anytree pydot graphviz
    
  4. Activate Automator by creating a .env file in your workspace root with your Syside license key (for alternative methods see Activate Automator page):

    SYSIDE_LICENSE_KEY=your-license-key-here
    

Licensing

Syside Derisker uses your Syside Modeler license. No separate license activation is required.

If you haven’t activated Modeler before, you’ll be prompted to enter your license key when open a .sysml file.


Update Derisker

Extensions installed from VSIX files do not receive automatic updates.

To update to the latest version, repeat the Install Extension above to download and install the latest VSIX file.

Tip

Your license activation and settings will be preserved during the update. If the new version requires updated Python dependencies, you may need to click Install Python and Dependencies again.