You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Current »

New for 10.1.5 (draft preview). This page previews a feature shipping in FrameworX 10.1.5 (planned April 2026). The feature is not available in 10.1.4 or earlier. Content under review.

Produce a human-readable diagram of your Unified Namespace (UserTypes, AssetTree, Tags) in Mermaid / SVG / PNG / HTML.

Standards Compliance How-toIndustrial Ontology → Visual Report


Primary path: the Relationship Graph button

The fastest way is a single click in Designer. No AI required, works offline.

  1. Open Unified Namespace → Asset Tree.
  2. On the AssetTree toolbar, click Relationship Graph (tooltip: Generate Visual Graph of UNS).
  3. Designer generates a Markdown file with embedded Mermaid diagrams and opens it in the default viewer. The file lands in the solution's Exchange folder under Visualizations/.

The output shows:

  • UDT class diagram. Composition members as hasPart edges, Reference members as dotted edges, BaseUserType as inheritance arrows.
  • AssetTree containment. One node per folder, one per Tag, with the /Attr convention made visible.
  • Cross-links. Reference-typed members pointing at other tags.
  • Summary. Counts of UDTs, Enumerations, Tags, folders. Any warnings.

The button is also available on the UNS UserTypes page as Open Visual Graph. Same backend, same output file format.

Alternative path: AI-driven for scripted or fuzzy-intent flows

If the AI assistant needs to generate visuals as part of a larger workflow (post-import verification, narrowing a large solution to a subtree, filtering by scope), it uses the generate_uns_visual MCP tool. See skill Skill Generate UNS Visual.

generate_uns_visual(scope="full")
generate_uns_visual(scope="subtree", root_path="/Plant1/Line3")
generate_uns_visual(scope="userTypes", include_inheritance=true)

Output ladder

Tier

Format

Best for

1 (default)

mermaid-md (.md)

Docs, handoff, diff. Renders natively in VSCode, GitHub, Obsidian, Confluence. No local tools required.

2

svg / png

Embedding in external docs, tickets, email. Requires mmdc on the host. Falls back to mermaid-md with a warning if unavailable.

3

html

Interactive exploration (pan, zoom, filter) via cytoscape.js. Ships in 10.1.6.

Example Mermaid output

classDiagram
    Motor <|-- Pump : BaseUserType
    class Motor {
      Running : Digital
      Speed : Double
      Temperature : Double
    }
    class Pump {
      FlowRate : Double
      Pressure : Double
    }

Performance notes

  • Mermaid starts to struggle around 500 nodes. Narrow the scope (subtree, userTypes) or escalate to svg.
  • Same solution plus same parameters always produces byte-identical output. Safe to check into source control.

Related: Import an OWL/RDF ontology into your UNS · Export your UNS to RDF/OWL/GraphDB


  • No labels