CMN Mesh Visualizer

This is a Python project that provides a GUI-based visualizer for Arm CMN (Coherent Mesh Network) systems. It parses and displays information generated by WindowsPerf and Topdown Tool, presenting their output files in an interactive interface. The visualizer enables analysis of topology, traffic, and performance metrics using PMU data from XPs, DTCs, and related components—helping engineers identify bottlenecks and understand system behavior across complex SoCs.

Installation

Install via pip using:

> pip install wperf-cmn-visualizer

This base install is enough for SVG export without the GUI. For the GUI, install the optional dependencies:

> pip install wperf-cmn-visualizer[gui]

Note: For more information, checkout INSTALL.md

Usage

Find out more about how to use this at USAGE.md

Contributing

To contribute to the project follow our Contributing Guidelines.

License

All code in this repository is licensed under the BSD 3-Clause License

Third-Party Dependencies

This project uses the following third-party library licensed under the GNU Lesser General Public License (LGPL):

• PySide6 – Licensed under LGPL-3.0-only.

The LGPL-licensed package is used without modification and is dynamically linked (imported as a separate dependency via PyPI). In accordance with LGPL terms, users are free to replace or modify this library independently of this project.

Compliance Statement

The use of the LGPL-licensed package does not affect the licensing of this project, which remains under the BSD 3-Clause License. This is permitted under LGPL rules provided the library is dynamically linked and not embedded or modified.

For more details on the BSD 3-Clause License, see https://opensource.org/licenses/BSD-3-Clause.

For more details on the LGPL, see https://spdx.org/licenses/LGPL-3.0-only.html.