@memoarchitect/ontology 0.13.2 → 0.15.1

package/examples/gpca-pump/analysis/Samples/04-change-impact-explorer.ipynb

@@ -1,200 +1,59 @@
 {
- "cells": [
-  {
-   "cell_type": "markdown",
-   "id": "memo-1",
-   "metadata": {},
-   "source": [
-    "# Change-impact explorer\n",
-    "\n",
-    "Search any element and inspect its owner, children, and directly related elements.\n",
-    "\n",
-    "This sample uses only standard SysML v2 concepts and automatically discovers the project's `model/` or `src/` directory."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 1,
-   "id": "memo-2",
-   "metadata": {
-    "execution": {
-     "iopub.execute_input": "2026-07-29T22:31:52.751165Z",
-     "iopub.status.busy": "2026-07-29T22:31:52.750921Z",
-     "iopub.status.idle": "2026-07-29T22:31:53.037061Z",
-     "shell.execute_reply": "2026-07-29T22:31:53.036612Z"
-    }
-   },
-   "outputs": [
+  "cells": [
     {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "Loaded 42 SysML files from /Users/poojakashyap/sandbox/memo-meta/memo/examples/gpca-pump/model\n"
-     ]
-    }
-   ],
-   "source": [
-    "from pathlib import Path\n",
-    "from collections import Counter, defaultdict\n",
-    "import syside\n",
-    "\n",
-    "def find_sysml_root(start=Path.cwd()):\n",
-    "    \"\"\"Find the nearest model/ or src/ folder containing textual SysML.\"\"\"\n",
-    "    for directory in (start, *start.parents):\n",
-    "        for folder_name in ('model', 'src'):\n",
-    "            candidate = directory / folder_name\n",
-    "            if candidate.is_dir() and next(candidate.rglob('*.sysml'), None):\n",
-    "                return candidate\n",
-    "    raise FileNotFoundError('No model/ or src/ directory containing .sysml files was found')\n",
-    "\n",
-    "SYSML_ROOT = find_sysml_root()\n",
-    "SYSML_FILES = sorted(SYSML_ROOT.rglob('*.sysml'))\n",
-    "model, diagnostics = syside.try_load_model([str(path) for path in SYSML_FILES])\n",
-    "print(f'Loaded {len(SYSML_FILES)} SysML files from {SYSML_ROOT}')"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 2,
-   "id": "memo-3",
-   "metadata": {
-    "execution": {
-     "iopub.execute_input": "2026-07-29T22:31:53.038369Z",
-     "iopub.status.busy": "2026-07-29T22:31:53.038278Z",
-     "iopub.status.idle": "2026-07-29T22:31:53.044194Z",
-     "shell.execute_reply": "2026-07-29T22:31:53.043828Z"
-    }
-   },
-   "outputs": [
+      "cell_type": "markdown",
+      "metadata": {},
+      "source": [
+        "# Change-impact explorer\n\nSearch any element and inspect its owner, children, and directly related elements.\n\nThis sample uses only standard SysML v2 concepts and reads the model through `memo_model.py`, compiled by the project's selected compiler."
+      ],
+      "id": "memo-1"
+    },
     {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "Set QUERY to a name fragment. Suggestions:\n",
-      " - memo_examples_gpca_pump_model_catalog_gpca_analysis::fmeaDelivery\n",
-      " - memo_examples_gpca_pump_model_catalog_gpca_analysis::fmMotorRunaway\n",
-      " - memo_examples_gpca_pump_model_catalog_gpca_analysis::fmAirSensorSilent\n",
-      " - memo_examples_gpca_pump_model_catalog_gpca_analysis::fmOcclusionDrift\n",
-      " - memo_examples_gpca_pump_model_catalog_gpca_analysis::fmStuckBolusButton\n",
-      " - memo_examples_gpca_pump_model_catalog_gpca_analysis::fmBatteryEarlyDepletion\n",
-      " - memo_examples_gpca_pump_model_catalog_gpca_analysis::feOverdose\n",
-      " - memo_examples_gpca_pump_model_catalog_gpca_analysis::feAirDelivered\n",
-      " - memo_examples_gpca_pump_model_catalog_gpca_analysis::feTherapyInterrupted\n",
-      " - memo_examples_gpca_pump_model_catalog_gpca_analysis::fcMotorDriverFault\n",
-      " - memo_examples_gpca_pump_model_catalog_gpca_analysis::fcTransducerAging\n",
-      " - memo_examples_gpca_pump_model_catalog_gpca_analysis::fcPendantAbuse\n",
-      " - memo_examples_gpca_pump_model_catalog_gpca_analysis::dmFlowCrossCheck\n",
-      " - memo_examples_gpca_pump_model_catalog_gpca_analysis::dmPostSensorCheck\n",
-      " - memo_examples_gpca_pump_model_catalog_gpca_analysis::dmStuckInputMonitor\n",
-      " - memo_examples_gpca_pump_model_catalog_gpca_analysis::fmeaActionAirSensor\n",
-      " - memo_examples_gpca_pump_model_catalog_gpca_analysis::ftaOverdose\n",
-      " - memo_examples_gpca_pump_model_catalog_gpca_analysis::fteOverdoseTop\n",
-      " - memo_examples_gpca_pump_model_catalog_gpca_analysis::fteMotorRunaway\n",
-      " - memo_examples_gpca_pump_model_catalog_gpca_analysis::fteCrossCheckFails\n"
-     ]
+      "cell_type": "code",
+      "metadata": {},
+      "source": [
+        "import sys\nfrom pathlib import Path\nfrom collections import Counter, defaultdict\n\n# memo_model.py sits in the project's analysis/ folder, above this notebook.\nsys.path.insert(0, str(next(d for d in (Path.cwd(), *Path.cwd().parents) if (d / 'memo_model.py').is_file())))\nimport memo_model\n\n# Compiled by the project's selected compiler (toolchain.compiler), as every\n# MEMO command is: change the setting and this notebook follows.\nmodel = memo_model.load()\ndiagnostics = model.diagnostics\nSYSML_FILES = model.documents\nprint(f'Loaded {len(SYSML_FILES)} SysML files, compiled by {model.compiler} {model.compiler_version or \"\"}')"
+      ],
+      "execution_count": null,
+      "outputs": [],
+      "id": "memo-2"
     },
     {
-     "data": {
-      "text/plain": [
-       "[]"
-      ]
-     },
-     "execution_count": 2,
-     "metadata": {},
-     "output_type": "execute_result"
-    }
-   ],
-   "source": [
-    "QUERY = ''  # Example: 'pump', 'controller', 'safety', or a requirement name\n",
-    "\n",
-    "semantic_elements = (\n",
-    "    list(model.elements(syside.Usage, include_subtypes=True))\n",
-    "    + list(model.elements(syside.Definition, include_subtypes=True))\n",
-    ")\n",
-    "\n",
-    "def label(element):\n",
-    "    value = element.qualified_name or element.name or element.declared_name\n",
-    "    return str(value) if value else '<unnamed>'\n",
-    "\n",
-    "if not QUERY:\n",
-    "    print('Set QUERY to a name fragment. Suggestions:')\n",
-    "    for suggestion in [label(item) for item in semantic_elements if item.name][:20]:\n",
-    "        print(' -', suggestion)\n",
-    "    matches = []\n",
-    "else:\n",
-    "    matches = [item for item in semantic_elements if QUERY.casefold() in label(item).casefold()]\n",
-    "    print(f'{len(matches)} match(es) for {QUERY!r}')\n",
-    "\n",
-    "[(type(item).__name__, label(item)) for item in matches[:100]]"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 3,
-   "id": "memo-4",
-   "metadata": {
-    "execution": {
-     "iopub.execute_input": "2026-07-29T22:31:53.045051Z",
-     "iopub.status.busy": "2026-07-29T22:31:53.045000Z",
-     "iopub.status.idle": "2026-07-29T22:31:53.047642Z",
-     "shell.execute_reply": "2026-07-29T22:31:53.047288Z"
-    }
-   },
-   "outputs": [
+      "cell_type": "code",
+      "metadata": {},
+      "source": [
+        "QUERY = ''  # Example: 'pump', 'controller', 'safety', or a requirement name\n\nsemantic_elements = (\n    model.elements('Usage', include_subtypes=True)\n    + model.elements('Definition', include_subtypes=True)\n)\n\ndef label(element):\n    value = element.qualified_name or element.name or element.declared_name\n    return str(value) if value else '<unnamed>'\n\nif not QUERY:\n    print('Set QUERY to a name fragment. Suggestions:')\n    for suggestion in [label(item) for item in semantic_elements if item.name][:20]:\n        print(' -', suggestion)\n    matches = []\nelse:\n    matches = [item for item in semantic_elements if QUERY.casefold() in label(item).casefold()]\n    print(f'{len(matches)} match(es) for {QUERY!r}')\n\n[(item.type, label(item)) for item in matches[:100]]"
+      ],
+      "execution_count": null,
+      "outputs": [],
+      "id": "memo-3"
+    },
     {
-     "data": {
-      "text/plain": [
-       "[]"
-      ]
-     },
-     "execution_count": 3,
-     "metadata": {},
-     "output_type": "execute_result"
+      "cell_type": "code",
+      "metadata": {},
+      "source": [
+        "def neighborhood(element):\n    owner = getattr(element, 'owner', None)\n    children = [child for child in element.owned_elements if child.is_a('Usage', 'Definition')]\n    related = []\n    for relationship in element.owned_relationships:\n        for candidate in relationship.related_elements:\n            if candidate is not element:\n                related.append(candidate)\n    return {\n        'selected': (element.type, label(element)),\n        'owner': None if owner is None else (owner.type, label(owner)),\n        'children': [(child.type, label(child)) for child in children[:50]],\n        'directly related': [(item.type, label(item)) for item in related[:50]],\n    }\n\n[neighborhood(item) for item in matches[:10]]"
+      ],
+      "execution_count": null,
+      "outputs": [],
+      "id": "memo-4"
+    }
+  ],
+  "metadata": {
+    "kernelspec": {
+      "display_name": "Python 3 (ipykernel)",
+      "language": "python",
+      "name": "python3"
+    },
+    "language_info": {
+      "name": "python",
+      "version": "3"
+    },
+    "memo": {
+      "starter": true,
+      "description": "Search any element and inspect its owner, children, and directly related elements."
     }
-   ],
-   "source": [
-    "def neighborhood(element):\n",
-    "    owner = getattr(element, 'owner', None)\n",
-    "    children = [child for child in element.owned_elements if isinstance(child, (syside.Usage, syside.Definition))]\n",
-    "    related = []\n",
-    "    for relationship in element.owned_relationships:\n",
-    "        for candidate in relationship.related_elements:\n",
-    "            if candidate is not element:\n",
-    "                related.append(candidate)\n",
-    "    return {\n",
-    "        'selected': (type(element).__name__, label(element)),\n",
-    "        'owner': None if owner is None else (type(owner).__name__, label(owner)),\n",
-    "        'children': [(type(child).__name__, label(child)) for child in children[:50]],\n",
-    "        'directly related': [(type(item).__name__, label(item)) for item in related[:50]],\n",
-    "    }\n",
-    "\n",
-    "[neighborhood(item) for item in matches[:10]]"
-   ]
-  }
- ],
- "metadata": {
-  "kernelspec": {
-   "display_name": "Python 3 (ipykernel)",
-   "language": "python",
-   "name": "python3"
-  },
-  "language_info": {
-   "codemirror_mode": {
-    "name": "ipython",
-    "version": 3
-   },
-   "file_extension": ".py",
-   "mimetype": "text/x-python",
-   "name": "python",
-   "nbconvert_exporter": "python",
-   "pygments_lexer": "ipython3",
-   "version": "3.12.13"
   },
-  "memo": {
-   "description": "Search any element and inspect its owner, children, and directly related elements.",
-   "starter": true
-  }
- },
- "nbformat": 4,
- "nbformat_minor": 5
+  "nbformat": 4,
+  "nbformat_minor": 5
 }

package/examples/gpca-pump/analysis/Samples/05-model-charts.ipynb

@@ -1,188 +1,49 @@
 {
- "cells": [
-  {
-   "cell_type": "markdown",
-   "id": "memo-1",
-   "metadata": {},
-   "source": [
-    "# Model charts\n",
-    "\n",
-    "Render semantic composition and diagnostic charts without external plotting packages.\n",
-    "\n",
-    "This sample uses only standard SysML v2 concepts and automatically discovers the project's `model/` or `src/` directory."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 1,
-   "id": "memo-2",
-   "metadata": {
-    "execution": {
-     "iopub.execute_input": "2026-07-29T22:35:00.883178Z",
-     "iopub.status.busy": "2026-07-29T22:35:00.882949Z",
-     "iopub.status.idle": "2026-07-29T22:35:01.265420Z",
-     "shell.execute_reply": "2026-07-29T22:35:01.265083Z"
-    }
-   },
-   "outputs": [
+  "cells": [
     {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "Loaded 42 SysML files from /Users/poojakashyap/sandbox/memo-meta/memo/examples/gpca-pump/model\n"
-     ]
-    }
-   ],
-   "source": [
-    "from pathlib import Path\n",
-    "from collections import Counter, defaultdict\n",
-    "import syside\n",
-    "\n",
-    "def find_sysml_root(start=Path.cwd()):\n",
-    "    \"\"\"Find the nearest model/ or src/ folder containing textual SysML.\"\"\"\n",
-    "    for directory in (start, *start.parents):\n",
-    "        for folder_name in ('model', 'src'):\n",
-    "            candidate = directory / folder_name\n",
-    "            if candidate.is_dir() and next(candidate.rglob('*.sysml'), None):\n",
-    "                return candidate\n",
-    "    raise FileNotFoundError('No model/ or src/ directory containing .sysml files was found')\n",
-    "\n",
-    "SYSML_ROOT = find_sysml_root()\n",
-    "SYSML_FILES = sorted(SYSML_ROOT.rglob('*.sysml'))\n",
-    "model, diagnostics = syside.try_load_model([str(path) for path in SYSML_FILES])\n",
-    "print(f'Loaded {len(SYSML_FILES)} SysML files from {SYSML_ROOT}')"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 2,
-   "id": "memo-3",
-   "metadata": {
-    "execution": {
-     "iopub.execute_input": "2026-07-29T22:35:01.266692Z",
-     "iopub.status.busy": "2026-07-29T22:35:01.266622Z",
-     "iopub.status.idle": "2026-07-29T22:35:01.282674Z",
-     "shell.execute_reply": "2026-07-29T22:35:01.282322Z"
-    }
-   },
-   "outputs": [
+      "cell_type": "markdown",
+      "metadata": {},
+      "source": [
+        "# Model charts\n\nRender semantic composition and diagnostic charts without external plotting packages.\n\nThis sample uses only standard SysML v2 concepts and reads the model through `memo_model.py`, compiled by the project's selected compiler."
+      ],
+      "id": "memo-1"
+    },
+    {
+      "cell_type": "code",
+      "metadata": {},
+      "source": [
+        "import sys\nfrom pathlib import Path\nfrom collections import Counter, defaultdict\n\n# memo_model.py sits in the project's analysis/ folder, above this notebook.\nsys.path.insert(0, str(next(d for d in (Path.cwd(), *Path.cwd().parents) if (d / 'memo_model.py').is_file())))\nimport memo_model\n\n# Compiled by the project's selected compiler (toolchain.compiler), as every\n# MEMO command is: change the setting and this notebook follows.\nmodel = memo_model.load()\ndiagnostics = model.diagnostics\nSYSML_FILES = model.documents\nprint(f'Loaded {len(SYSML_FILES)} SysML files, compiled by {model.compiler} {model.compiler_version or \"\"}')"
+      ],
+      "execution_count": null,
+      "outputs": [],
+      "id": "memo-2"
+    },
     {
-     "data": {
-      "text/html": [
-       "<div style=\"font-family:system-ui;max-width:900px\">\n",
-       "  <h2>Semantic composition</h2><div style=\"display:grid;grid-template-columns:180px 1fr 70px;gap:12px;align-items:center;margin:7px 0\">\n",
-       "      <div>AttributeUsage</div><div style=\"background:#edf2f4;border-radius:6px;overflow:hidden\"><div style=\"width:100.0%;height:20px;background:#2d8d70\"></div></div><strong>5,056</strong>\n",
-       "    </div><div style=\"display:grid;grid-template-columns:180px 1fr 70px;gap:12px;align-items:center;margin:7px 0\">\n",
-       "      <div>ConnectionUsage</div><div style=\"background:#edf2f4;border-radius:6px;overflow:hidden\"><div style=\"width:13.7%;height:20px;background:#3887c7\"></div></div><strong>691</strong>\n",
-       "    </div><div style=\"display:grid;grid-template-columns:180px 1fr 70px;gap:12px;align-items:center;margin:7px 0\">\n",
-       "      <div>PartUsage</div><div style=\"background:#edf2f4;border-radius:6px;overflow:hidden\"><div style=\"width:8.4%;height:20px;background:#e58a2b\"></div></div><strong>425</strong>\n",
-       "    </div><div style=\"display:grid;grid-template-columns:180px 1fr 70px;gap:12px;align-items:center;margin:7px 0\">\n",
-       "      <div>RequirementUsage</div><div style=\"background:#edf2f4;border-radius:6px;overflow:hidden\"><div style=\"width:2.1%;height:20px;background:#8357b6\"></div></div><strong>105</strong>\n",
-       "    </div><div style=\"display:grid;grid-template-columns:180px 1fr 70px;gap:12px;align-items:center;margin:7px 0\">\n",
-       "      <div>ItemUsage</div><div style=\"background:#edf2f4;border-radius:6px;overflow:hidden\"><div style=\"width:1.0%;height:20px;background:#cf5c62\"></div></div><strong>49</strong>\n",
-       "    </div><div style=\"display:grid;grid-template-columns:180px 1fr 70px;gap:12px;align-items:center;margin:7px 0\">\n",
-       "      <div>ActionUsage</div><div style=\"background:#edf2f4;border-radius:6px;overflow:hidden\"><div style=\"width:1.0%;height:20px;background:#4f9d9d\"></div></div><strong>44</strong>\n",
-       "    </div><div style=\"display:grid;grid-template-columns:180px 1fr 70px;gap:12px;align-items:center;margin:7px 0\">\n",
-       "      <div>StateUsage</div><div style=\"background:#edf2f4;border-radius:6px;overflow:hidden\"><div style=\"width:1.0%;height:20px;background:#2d8d70\"></div></div><strong>10</strong>\n",
-       "    </div><div style=\"display:grid;grid-template-columns:180px 1fr 70px;gap:12px;align-items:center;margin:7px 0\">\n",
-       "      <div>ActionDefinition</div><div style=\"background:#edf2f4;border-radius:6px;overflow:hidden\"><div style=\"width:1.0%;height:20px;background:#3887c7\"></div></div><strong>6</strong>\n",
-       "    </div><div style=\"display:grid;grid-template-columns:180px 1fr 70px;gap:12px;align-items:center;margin:7px 0\">\n",
-       "      <div>PortDefinition</div><div style=\"background:#edf2f4;border-radius:6px;overflow:hidden\"><div style=\"width:1.0%;height:20px;background:#e58a2b\"></div></div><strong>1</strong>\n",
-       "    </div><div style=\"display:grid;grid-template-columns:180px 1fr 70px;gap:12px;align-items:center;margin:7px 0\">\n",
-       "      <div>PortUsage</div><div style=\"background:#edf2f4;border-radius:6px;overflow:hidden\"><div style=\"width:1.0%;height:20px;background:#8357b6\"></div></div><strong>0</strong>\n",
-       "    </div><div style=\"display:grid;grid-template-columns:180px 1fr 70px;gap:12px;align-items:center;margin:7px 0\">\n",
-       "      <div>PartDefinition</div><div style=\"background:#edf2f4;border-radius:6px;overflow:hidden\"><div style=\"width:1.0%;height:20px;background:#cf5c62\"></div></div><strong>0</strong>\n",
-       "    </div><div style=\"display:grid;grid-template-columns:180px 1fr 70px;gap:12px;align-items:center;margin:7px 0\">\n",
-       "      <div>RequirementDefinition</div><div style=\"background:#edf2f4;border-radius:6px;overflow:hidden\"><div style=\"width:1.0%;height:20px;background:#4f9d9d\"></div></div><strong>0</strong>\n",
-       "    </div>\n",
-       "  <h2 style=\"margin-top:28px\">Diagnostics</h2>\n",
-       "  <div style=\"display:flex;align-items:center;gap:24px\">\n",
-       "    <div style=\"width:150px;height:150px;border-radius:50%;background:conic-gradient(#cf5c62 0 100.0%, #e5a52b 100.0% 100.0%, #3887c7 100.0% 100%);position:relative\">\n",
-       "      <div style=\"position:absolute;inset:28px;background:white;border-radius:50%;display:grid;place-items:center;font-size:24px;font-weight:700\">8009</div>\n",
-       "    </div>\n",
-       "    <table><tr><th>Severity</th><th>Count</th></tr><tr><td>Errors</td><td>8009</td></tr><tr><td>Warnings</td><td>0</td></tr><tr><td>Information</td><td>0</td></tr></table>\n",
-       "  </div>\n",
-       "</div>"
+      "cell_type": "code",
+      "metadata": {},
+      "source": [
+        "from html import escape\nfrom IPython.display import HTML, display\n\ntype_names = [\n    'PartUsage', 'RequirementUsage', 'ActionUsage', 'PortUsage',\n    'ConnectionUsage', 'StateUsage', 'AttributeUsage', 'ItemUsage',\n    'PartDefinition', 'RequirementDefinition', 'ActionDefinition', 'PortDefinition'\n]\ncounts = {}\nfor type_name in type_names:\n    counts[type_name] = len(model.elements(type_name))\n\npalette = ['#2d8d70', '#3887c7', '#e58a2b', '#8357b6', '#cf5c62', '#4f9d9d']\nlargest = max(counts.values(), default=1)\nbars = []\nfor index, (name, count) in enumerate(sorted(counts.items(), key=lambda item: item[1], reverse=True)):\n    width = max(1, count * 100 / largest)\n    color = palette[index % len(palette)]\n    bars.append(f'''<div style=\"display:grid;grid-template-columns:180px 1fr 70px;gap:12px;align-items:center;margin:7px 0\">\n      <div>{escape(name)}</div><div style=\"background:#edf2f4;border-radius:6px;overflow:hidden\"><div style=\"width:{width:.1f}%;height:20px;background:{color}\"></div></div><strong>{count:,}</strong>\n    </div>''')\n\nerror_count = len(diagnostics.errors)\nwarning_count = len(diagnostics.warnings)\ninfo_count = len(diagnostics.infos)\ntotal_diagnostics = max(1, error_count + warning_count + info_count)\ndiagnostic_gradient = (\n    f'#cf5c62 0 {error_count / total_diagnostics * 100:.1f}%, '\n    f'#e5a52b {error_count / total_diagnostics * 100:.1f}% {(error_count + warning_count) / total_diagnostics * 100:.1f}%, '\n    f'#3887c7 {(error_count + warning_count) / total_diagnostics * 100:.1f}% 100%'\n)\n\ndisplay(HTML(f'''<div style=\"font-family:system-ui;max-width:900px\">\n  <h2>Semantic composition</h2>{''.join(bars)}\n  <h2 style=\"margin-top:28px\">Diagnostics</h2>\n  <div style=\"display:flex;align-items:center;gap:24px\">\n    <div style=\"width:150px;height:150px;border-radius:50%;background:conic-gradient({diagnostic_gradient});position:relative\">\n      <div style=\"position:absolute;inset:28px;background:white;border-radius:50%;display:grid;place-items:center;font-size:24px;font-weight:700\">{error_count + warning_count + info_count}</div>\n    </div>\n    <table><tr><th>Severity</th><th>Count</th></tr><tr><td>Errors</td><td>{error_count}</td></tr><tr><td>Warnings</td><td>{warning_count}</td></tr><tr><td>Information</td><td>{info_count}</td></tr></table>\n  </div>\n</div>'''))"
       ],
-      "text/plain": [
-       "<IPython.core.display.HTML object>"
-      ]
-     },
-     "metadata": {},
-     "output_type": "display_data"
+      "execution_count": null,
+      "outputs": [],
+      "id": "memo-3"
+    }
+  ],
+  "metadata": {
+    "kernelspec": {
+      "display_name": "Python 3 (ipykernel)",
+      "language": "python",
+      "name": "python3"
+    },
+    "language_info": {
+      "name": "python",
+      "version": "3"
+    },
+    "memo": {
+      "starter": true,
+      "description": "Render semantic composition and diagnostic charts without external plotting packages."
     }
-   ],
-   "source": [
-    "from html import escape\n",
-    "from IPython.display import HTML, display\n",
-    "\n",
-    "type_names = [\n",
-    "    'PartUsage', 'RequirementUsage', 'ActionUsage', 'PortUsage',\n",
-    "    'ConnectionUsage', 'StateUsage', 'AttributeUsage', 'ItemUsage',\n",
-    "    'PartDefinition', 'RequirementDefinition', 'ActionDefinition', 'PortDefinition'\n",
-    "]\n",
-    "counts = {}\n",
-    "for type_name in type_names:\n",
-    "    node_type = getattr(syside, type_name, None)\n",
-    "    if node_type is not None:\n",
-    "        counts[type_name] = len(list(model.elements(node_type)))\n",
-    "\n",
-    "palette = ['#2d8d70', '#3887c7', '#e58a2b', '#8357b6', '#cf5c62', '#4f9d9d']\n",
-    "largest = max(counts.values(), default=1)\n",
-    "bars = []\n",
-    "for index, (name, count) in enumerate(sorted(counts.items(), key=lambda item: item[1], reverse=True)):\n",
-    "    width = max(1, count * 100 / largest)\n",
-    "    color = palette[index % len(palette)]\n",
-    "    bars.append(f'''<div style=\"display:grid;grid-template-columns:180px 1fr 70px;gap:12px;align-items:center;margin:7px 0\">\n",
-    "      <div>{escape(name)}</div><div style=\"background:#edf2f4;border-radius:6px;overflow:hidden\"><div style=\"width:{width:.1f}%;height:20px;background:{color}\"></div></div><strong>{count:,}</strong>\n",
-    "    </div>''')\n",
-    "\n",
-    "error_count = len(list(diagnostics.errors))\n",
-    "warning_count = len(list(diagnostics.warnings))\n",
-    "info_count = len(list(diagnostics.infos))\n",
-    "total_diagnostics = max(1, error_count + warning_count + info_count)\n",
-    "diagnostic_gradient = (\n",
-    "    f'#cf5c62 0 {error_count / total_diagnostics * 100:.1f}%, '\n",
-    "    f'#e5a52b {error_count / total_diagnostics * 100:.1f}% {(error_count + warning_count) / total_diagnostics * 100:.1f}%, '\n",
-    "    f'#3887c7 {(error_count + warning_count) / total_diagnostics * 100:.1f}% 100%'\n",
-    ")\n",
-    "\n",
-    "display(HTML(f'''<div style=\"font-family:system-ui;max-width:900px\">\n",
-    "  <h2>Semantic composition</h2>{''.join(bars)}\n",
-    "  <h2 style=\"margin-top:28px\">Diagnostics</h2>\n",
-    "  <div style=\"display:flex;align-items:center;gap:24px\">\n",
-    "    <div style=\"width:150px;height:150px;border-radius:50%;background:conic-gradient({diagnostic_gradient});position:relative\">\n",
-    "      <div style=\"position:absolute;inset:28px;background:white;border-radius:50%;display:grid;place-items:center;font-size:24px;font-weight:700\">{error_count + warning_count + info_count}</div>\n",
-    "    </div>\n",
-    "    <table><tr><th>Severity</th><th>Count</th></tr><tr><td>Errors</td><td>{error_count}</td></tr><tr><td>Warnings</td><td>{warning_count}</td></tr><tr><td>Information</td><td>{info_count}</td></tr></table>\n",
-    "  </div>\n",
-    "</div>'''))"
-   ]
-  }
- ],
- "metadata": {
-  "kernelspec": {
-   "display_name": "Python 3 (ipykernel)",
-   "language": "python",
-   "name": "python3"
-  },
-  "language_info": {
-   "codemirror_mode": {
-    "name": "ipython",
-    "version": 3
-   },
-   "file_extension": ".py",
-   "mimetype": "text/x-python",
-   "name": "python",
-   "nbconvert_exporter": "python",
-   "pygments_lexer": "ipython3",
-   "version": "3.12.13"
   },
-  "memo": {
-   "description": "Render semantic composition and diagnostic charts without external plotting packages.",
-   "starter": true
-  }
- },
- "nbformat": 4,
- "nbformat_minor": 5
+  "nbformat": 4,
+  "nbformat_minor": 5
 }