MagicDraw Visualizer

A plugin for MagicDraw/Cameo 2024x that adds interactive, non-symbol diagrams for visual analysis of UML model relationships. Built with JxBrowser and D3.js.

Note: this project requires a working JxBrowser v8.x key to build!

Chord Diagram

The initial diagram type is a Chord Diagram that visualizes relationships between model elements as an interactive circular layout. Elements are displayed as arcs, and relationships between them are rendered as ribbons connecting the arcs.

Features:

• Filter by element type (Class, Block, Component, Interface, Package, etc.) with optional subtype inclusion
• Filter by relationship type (Dependency, Association, Generalization, Realization, Usage)
• Recursive traversal into nested packages
• Click arcs or ribbons to navigate to the corresponding element in the containment tree
• Toggle labels, legend, and orphan (unconnected) element visibility
• Settings auto-save per diagram instance

Prerequisites

• MagicDraw/Cameo 2024x (2024.3.0 or compatible)
• Java 11
• Maven 3.x
• JxBrowser 8.0 license key (see example)

Setup

1. Clone this repository

2. Verify the MagicDraw installation path in pom.xml matches your system:

   <md.path>/Applications/MagicDraw 2024xR3</md.path>

3. Configure the JxBrowser license:

   cp src/main/resources/jxbrowser.properties.example src/main/resources/jxbrowser.properties

   Edit the file and add your license key.

Build

Build the JAR for testing:

mvn clean package

Build a distribution bundle for Resource Manager installation:

./build_dist.sh

This produces dist/visualizer-plugin-2024x-v1.0.0.zip.

Install

Manual (development)

Copy the built JAR and plugin descriptor into MagicDraw's plugins directory:

<MagicDraw>/plugins/com.jonbackhaus.visualizer/
    magicdraw-visualizer-1.0.0.jar
    plugin.xml

Restart MagicDraw.

Resource Manager (distribution)

1. In MagicDraw, go to Help > Resource/Plugin Manager
2. Click Import and select dist/visualizer-plugin-2024x-v1.0.0.zip
3. Restart MagicDraw

Usage

1. Open a MagicDraw project
2. Right-click a Package in the containment tree
3. Select Create Diagram > Chord Diagram
4. Use the configuration panel on the left to set element type, relationship filters, and display options
5. Click Refresh to render the diagram

License

MIT