feat: adding network viz

feat: adding network core and parsers with test

feat: network visualization working

fix: fixing speed of forcelayout calculation

cleaning comment

cleaning example, creating utility, setting dyanmicbb default to true

Author: ganimtron-10

docs/examples/_valid_examples.toml

@@ -37,7 +37,7 @@ files = [
     "viz_line_projections.py",
     "viz_streamlines_roi.py",
     "viz_contour.py",
-
+    "viz_network.py",
 ]
 
 [ui]

docs/examples/viz_network.py

@@ -0,0 +1,48 @@
+"""
+====================================
+Force-Directed Network Visualization
+====================================
+
+This example demonstrates how to use the `Network` actor to visualize
+graphs using a GPU-accelerated Fruchterman-Reingold force-directed layout.
+
+It supports two modes:
+1. Dummy: Generates a random synthetic graph.
+2. File: Loads a graph from .gexf, .gml, or .xnet files.
+"""
+
+import numpy as np
+from fury import window, ui, actor
+
+N_NODES = 500
+N_EDGES = 1000
+K_DISTANCE = 20.0
+SIM_SPEED = 0.01
+
+# To load from file, uncomment the lines below:
+# from fury.io import load_network
+# network_data = load_network("path/to/graph.gexf")
+# network_actor = actor.network(network_data, k=K_DISTANCE, speed=SIM_SPEED)
+
+nodes = (np.random.rand(N_NODES, 3) - 0.5) * 100
+edges = np.random.randint(0, N_NODES, size=(N_EDGES, 2))
+edges = edges[edges[:, 0] != edges[:, 1]]
+colors = np.random.rand(N_NODES, 4).astype(np.float32)
+
+network_actor = actor.create_network(
+    nodes=nodes, edges=edges, colors=colors, k=K_DISTANCE, speed=SIM_SPEED
+)
+
+scene = window.Scene()
+scene.background = (0.1, 0.1, 0.1)
+scene.add(network_actor)
+
+info_text = f"Nodes: {N_NODES}\nEdges: {N_EDGES}\nMode: GPU Simulation"
+ui_label = ui.TextBlock2D(
+    text=info_text, position=(10, 10), font_size=16, dynamic_bbox=True
+)
+scene.add(ui_label)
+
+if __name__ == "__main__":
+    show_manager = window.ShowManager(scene=scene, title="FURY Network")
+    show_manager.start()

fury/actor/__init__.pyi

@@ -47,6 +47,7 @@ __all__ = [
     "create_point",
     "create_text",
     "create_image",
+    "create_network",
     "Mesh",
     "Line",
     "Points",
@@ -67,6 +68,7 @@ __all__ = [
     "contour_from_label",
     "read_buffer",
     "create_axes_helper",
+    "extract_graph_data_from_network",
 ]
 
 from ._billboard import Billboard, billboard, billboard_sphere
@@ -92,6 +94,7 @@ from .core import (
     line,
 )
 from .curved import cone, cylinder, ellipsoid, sphere, streamlines, streamtube
+from .network import create_network
 from .planar import (
     disk,
     image,
@@ -127,6 +130,7 @@ from .topology import contour_from_volume, surface
 from .utils import (
     apply_affine_to_actor,
     apply_affine_to_group,
+    extract_graph_data_from_network,
     get_slices,
     read_buffer,
     set_group_opacity,