Spring Graph Layout Example for Blazor

Nevron NOV Diagram for Blazor ships with hundreds of examples with full source code, as part of the Nevron Open Vision Suite. All Blazor Diagram examples are also available as a stand-alone Visual Studio solution in C#, which you can download from the links below.

Spring Graph Layout Example for Blazor Description

The spring layout method is a classical force directed layout, which uses spring and electrical forces.

Graph edges are treated as springs. Springs aim to ensure that the distance between adjacent vertices is approximately equal to the spring length. The parameters of the spring force are controlled by an instance of the NSpringForce class, accessible from the SpringForce property.

Graph vertices are treated as electrically charged particles, which repel each other. The electrical force aims to ensure that vertices should not be close together. The parameters of the electrical force are controlled by an instance of the NElectricalForce class, accessible from the ElectricalForce property.

The spring force accepts per edge defined spring lengths and spring stiffness. In this example the red connectors are with smaller spring length are with greater stiffness than the blue connectors. Because of that they tend to be displayed closer to each other.

The electrical force accepts per vertex provided electric charges. Thus some vertices may be more repulsive than others.

To experiment with the layout behavior just change the properties of the layout in the property grid and click the Layout button.


Spring Graph Layout Example

C# Spring Graph Layout Example Code for Nevron Diagram for Blazor
Language: C#

using Nevron.Nov;
using Nevron.Nov.DataStructures;
using Nevron.Nov.Diagram;
using Nevron.Nov.Diagram.Layout;
using Nevron.Nov.Diagram.Shapes;
using Nevron.Nov.Dom;
using Nevron.Nov.Editors;
using Nevron.Nov.Graphics;
using Nevron.Nov.Layout;
using Nevron.Nov.UI;
using Nevron.Nov.Windows.Forms;
using System.Windows.Forms;

namespace NovWinFormsProject
{
	public partial class Form1 : Form
	{
		#region Constructors

		public Form1()
		{
			InitializeComponent();

			// Set form title
			Text = "NOV WinForms - NSpringGraphLayoutExample";

			// Create the NOV example and its controls
			NWidget exampleContent = CreateExampleContent();
			NWidget exampleControls = CreateExampleControls();
			if (exampleControls != null)
			{
				exampleControls.PreferredWidth = 300;
			}

			// Place the example and its controls in a pair box
			NPairBox pairBox = new NPairBox(exampleContent, exampleControls);
			pairBox.FillMode = ENStackFillMode.First;
			pairBox.FitMode = ENStackFitMode.First;
			pairBox.Margins = new NMargins(NDesign.HorizontalSpacing, NDesign.VerticalSpacing);

			// Host the example in the form
			NNovWidgetHost host = new NNovWidgetHost(pairBox);
			host.Dock = DockStyle.Fill;
			Controls.Add(host);
		}

		#endregion

        #region Example

        public NWidget CreateExampleContent()
        {
            // Create a simple drawing
            NDrawingViewWithRibbon drawingViewWithRibbon = new NDrawingViewWithRibbon();
            m_DrawingView = drawingViewWithRibbon.View;

            m_DrawingView.Document.HistoryService.Pause();
            try
            {
                InitDiagram(m_DrawingView.Document);
            }
            finally
            {
                m_DrawingView.Document.HistoryService.Resume();
            }

            return drawingViewWithRibbon;
        }
        public NWidget CreateExampleControls()
        {
            m_Layout.Changed += OnLayoutChanged;

            NStackPanel stack = new NStackPanel();

            // property editor
            NEditor editor = NDesigner.GetDesigner(m_Layout).CreateStandaloneEditor(m_Layout);
            stack.Add(new NGroupBox("Properties", editor));

            NButton arrangeButton = new NButton("Arrange Diagram");
            arrangeButton.Click += OnArrangeButtonClick;
            stack.Add(arrangeButton);

            // items stack
            NStackPanel itemsStack = new NStackPanel();

            // NOTE: For Graph layouts we provide the user with the ability to generate random graph diagrams so that he/she can test the layouts
            NButton randomGraph1Button = new NButton("Random Graph (10 vertices, 15 edges)");
            randomGraph1Button.Click += OnRandomGraph1ButtonClick;
            itemsStack.Add(randomGraph1Button);

            NButton randomGraph2Button = new NButton("Random Graph (20 vertices, 30 edges)");
            randomGraph2Button.Click += OnRandomGraph2ButtonClick;
            itemsStack.Add(randomGraph2Button);

            stack.Add(new NGroupBox("Items", itemsStack));

            return stack;
        }
        public string GetExampleDescription()
        {
            return @"

The spring layout method is a classical force directed layout, which uses spring and electrical forces.

Graph edges are treated as springs. Springs aim to ensure that the distance between adjacent vertices is approximately equal to the spring length. The parameters of the spring force are controlled by an instance of the NSpringForce class, accessible from the SpringForce property.

Graph vertices are treated as electrically charged particles, which repel each other. The electrical force aims to ensure that vertices should not be close together. The parameters of the electrical force are controlled by an instance of the NElectricalForce class, accessible from the ElectricalForce property.

The spring force accepts per edge defined spring lengths and spring stiffness. In this example the red connectors are with smaller spring length are with greater stiffness than the blue connectors. Because of that they tend to be displayed closer to each other.

The electrical force accepts per vertex provided electric charges. Thus some vertices may be more repulsive than others.

To experiment with the layout behavior just change the properties of the layout in the property grid and click the Layout button.

"; } /// /// Gets the relevant documentation links for the example /// /// public (string Name, string Url)[] GetDocumentationUrls() { return new[] { ("Spring Layout", "https://www.nevron.com/docs/openvision/diagram-spring-layout.html"), ("Layouts Overview", "https://www.nevron.com/docs/openvision/diagram-drawing-layouts-overview.html"), ("Graph Regions and Regions Layouts", "https://www.nevron.com/docs/openvision/diagram-graph-regions-and-region-layouts.html"), ("Shape Navigation", "https://www.nevron.com/docs/openvision/diagram-shape-navigation.html"), }; } private void InitDiagram(NDrawingDocument drawingDocument) { // Hide ports drawingDocument.Content.ScreenVisibility.ShowPorts = false; NPage activePage = drawingDocument.Content.ActivePage; // We will be using basic shapes for this example NBasicShapeFactory basicShapes = new NBasicShapeFactory(); basicShapes.DefaultSize = new NSize(80, 80); NList persons = new NList(); // Create persons NPerson personEmil = new NPerson("Emil Moore", basicShapes.CreateShape(ENBasicShape.Circle)); NPerson personAndre = new NPerson("Andre Smith", basicShapes.CreateShape(ENBasicShape.Circle)); NPerson personRobert = new NPerson("Robert Johnson", basicShapes.CreateShape(ENBasicShape.Circle)); NPerson personBob = new NPerson("Bob Williams", basicShapes.CreateShape(ENBasicShape.Circle)); NPerson personPeter = new NPerson("Peter Brown", basicShapes.CreateShape(ENBasicShape.Circle)); NPerson personSilvia = new NPerson("Silvia Moore", basicShapes.CreateShape(ENBasicShape.Circle)); NPerson personEmily = new NPerson("Emily Smith", basicShapes.CreateShape(ENBasicShape.Circle)); NPerson personMonica = new NPerson("Monica Johnson", basicShapes.CreateShape(ENBasicShape.Circle)); NPerson personSamantha = new NPerson("Samantha Miller", basicShapes.CreateShape(ENBasicShape.Circle)); NPerson personIsabella = new NPerson("Isabella Davis", basicShapes.CreateShape(ENBasicShape.Circle)); persons.Add(personEmil); persons.Add(personAndre); persons.Add(personRobert); persons.Add(personBob); persons.Add(personPeter); persons.Add(personSilvia); persons.Add(personEmily); persons.Add(personMonica); persons.Add(personSamantha); persons.Add(personIsabella); // Create family relashionships personEmil.m_Family = personSilvia; personAndre.m_Family = personEmily; personRobert.m_Family = personMonica; // Create friend relationships personEmily.m_Friends.Add(personBob); personEmily.m_Friends.Add(personMonica); personAndre.m_Friends.Add(personPeter); personAndre.m_Friends.Add(personIsabella); personSilvia.m_Friends.Add(personBob); personSilvia.m_Friends.Add(personSamantha); personSilvia.m_Friends.Add(personIsabella); personEmily.m_Friends.Add(personIsabella); personEmily.m_Friends.Add(personPeter); personPeter.m_Friends.Add(personRobert); // create the person vertices for (int i = 0; i < persons.Count; i++) { activePage.Items.Add(persons[i].m_Shape); } // Create the family relations for (int i = 0; i < persons.Count; i++) { NPerson currentPerson = persons[i]; if (currentPerson.m_Family != null) { NRoutableConnector connector = new NRoutableConnector(); connector.MakeLine(); activePage.Items.Add(connector); connector.GlueBeginToShape(currentPerson.m_Shape); connector.GlueEndToShape(currentPerson.m_Family.m_Shape); connector.Geometry.Stroke = new NStroke(2, NColor.Coral); connector.LayoutData.SpringStiffness = 2; connector.LayoutData.SpringLength = 100; } } for (int i = 0; i < persons.Count; i++) { NPerson currentPerson = persons[i]; for (int j = 0; j < currentPerson.m_Friends.Count; j++) { NRoutableConnector connector = new NRoutableConnector(); connector.MakeLine(); activePage.Items.Add(connector); connector.GlueBeginToShape(currentPerson.m_Shape); connector.GlueEndToShape(currentPerson.m_Friends[j].m_Shape); connector.Geometry.Stroke = new NStroke(2, NColor.Green); connector.LayoutData.SpringStiffness = 1; connector.LayoutData.SpringLength = 200; } } // Arrange diagram ArrangeDiagram(drawingDocument); // Fit active page drawingDocument.Content.ActivePage.ZoomMode = ENZoomMode.Fit; } #endregion #region Implementation /// /// Arranges the shapes in the active page. /// /// private void ArrangeDiagram(NDrawingDocument drawingDocument) { // get all top-level shapes that reside in the active page NPage activePage = drawingDocument.Content.ActivePage; NList shapes = activePage.GetShapes(false); // create a layout context and use it to arrange the shapes using the current layout NDrawingLayoutContext layoutContext = new NDrawingLayoutContext(drawingDocument, activePage); m_Layout.Arrange(shapes.CastAll(), layoutContext); // size the page to the content size activePage.SizeToContent(); } #endregion #region Event Handlers private void OnRandomGraph1ButtonClick(NEventArgs arg) { NDrawingDocument drawingDocument = m_DrawingView.Document; drawingDocument.StartHistoryTransaction("Create Random Graph 1"); try { m_DrawingView.ActivePage.Items.Clear(); // create a test tree NRandomGraphTemplate graph = new NRandomGraphTemplate(); graph.EdgeUserClass = NDR.StyleSheetNameConnectors; graph.VertexCount = 10; graph.EdgeCount = 15; graph.VertexShape = VertexShape; graph.VertexSize = VertexSize; graph.Create(drawingDocument); // layout the tree ArrangeDiagram(drawingDocument); } finally { drawingDocument.CommitHistoryTransaction(); } } private void OnRandomGraph2ButtonClick(NEventArgs arg) { NDrawingDocument drawingDocument = m_DrawingView.Document; drawingDocument.StartHistoryTransaction("Create Random Graph 2"); try { m_DrawingView.ActivePage.Items.Clear(); // create a test tree NRandomGraphTemplate graph = new NRandomGraphTemplate(); graph.EdgeUserClass = NDR.StyleSheetNameConnectors; graph.VertexCount = 20; graph.EdgeCount = 30; graph.VertexShape = VertexShape; graph.VertexSize = VertexSize; graph.Create(drawingDocument); // layout the tree ArrangeDiagram(drawingDocument); } finally { drawingDocument.CommitHistoryTransaction(); } } private void OnLayoutChanged(NEventArgs arg) { ArrangeDiagram(m_DrawingView.Document); } protected virtual void OnArrangeButtonClick(NEventArgs arg) { ArrangeDiagram(m_DrawingView.Document); } #endregion #region Fields private NDrawingView m_DrawingView; private NSpringGraphLayout m_Layout = new NSpringGraphLayout(); #endregion #region Static Methods #endregion #region Constants private const ENBasicShape VertexShape = ENBasicShape.Circle; private static readonly NSize VertexSize = new NSize(50, 50); #endregion #region Nested Types public class NPerson { public NPerson(string name, NShape shape) { m_Shape = shape; m_Shape.Text = name; m_Shape.DefaultShapeGlue = ENDefaultShapeGlue.GlueToGeometryIntersection; m_Name = name; m_Friends = new NList(); m_Family = null; } public NShape m_Shape; public string m_Name; public NList m_Friends; public NPerson m_Family; } #endregion } }

Download a fully functional C# (.cs) Spring Graph Layout Example for Blazor Solution