MatplotLibAPI 4.0.3__py3-none-any.whl → 4.0.4__py3-none-any.whl

MatplotLibAPI/accessor.py

@@ -1278,6 +1278,57 @@ class DataFrameAccessor:
             **kwargs,
         )
 
+    def fplot_network(
+        self,
+        edge_source_col: str = "source",
+        edge_target_col: str = "target",
+        edge_weight_col: str = "weight",
+        title: Optional[str] = None,
+        style: Optional[StyleTemplate] = None,
+        layout_seed: Optional[int] = None,
+        figsize: Tuple[float, float] = FIG_SIZE,
+    ) -> Figure:
+        """Plot a network graph on a new figure.
+
+        Parameters
+        ----------
+        edge_source_col : str, optional
+            Column for source nodes. The default is "source".
+        edge_target_col : str, optional
+            Column for target nodes. The default is "target".
+        edge_weight_col : str, optional
+            Column for edge weights. The default is "weight".
+        title : str, optional
+            Chart title.
+        style : StyleTemplate, optional
+            Styling template. The default is `NETWORK_STYLE_TEMPLATE`.
+        layout_seed : int, optional
+            Seed forwarded to the spring layout. The default is ``_DEFAULT["SPRING_LAYOUT_SEED"]``.
+        figsize : tuple[float, float], optional
+            Figure size. The default is FIG_SIZE.
+
+        Returns
+        -------
+        Figure
+            The new Matplotlib figure with the plot.
+        """
+        kwargs: Dict[str, Any] = {}
+        if layout_seed is not None:
+            kwargs["layout_seed"] = layout_seed
+
+        from .network import NETWORK_STYLE_TEMPLATE, fplot_network
+
+        return fplot_network(
+            pd_df=self._obj,
+            edge_source_col=edge_source_col,
+            edge_target_col=edge_target_col,
+            edge_weight_col=edge_weight_col,
+            title=title,
+            style=style or NETWORK_STYLE_TEMPLATE,
+            figsize=figsize,
+            **kwargs,
+        )
+
     def aplot_network_components(
         self,
         edge_source_col: str = "source",

MatplotLibAPI/network/core.py

@@ -453,6 +453,33 @@ class NetworkGraph(BasePlot):
         """Return the degree assortativity coefficient of the graph."""
         return nx.degree_assortativity_coefficient(self._nx_graph)
 
+    @property
+    def degree_distribution(self) -> Dict[int, int]:
+        """Return the count of nodes for each degree.
+
+        Returns
+        -------
+        dict[int, int]
+            Mapping from node degree to number of nodes with that degree.
+        """
+        distribution: Dict[int, int] = defaultdict(int)
+        for _, degree in self._nx_graph.degree():
+            distribution[int(degree)] += 1
+        return dict(sorted(distribution.items()))
+
+    @property
+    def degree_sequence(self) -> List[int]:
+        """Return node degrees sorted in descending order.
+
+        Returns
+        -------
+        list[int]
+            Degree for each node sorted from highest to lowest.
+        """
+        return sorted(
+            (int(degree) for _, degree in self._nx_graph.degree()), reverse=True
+        )
+
     def add_node(self, node: Any, **attributes: Any):
         """Add a node with optional attributes.
 

MatplotLibAPI/network/plot.py

@@ -501,6 +501,8 @@ def fplot_network(
     ).fplot(
         title=title,
         style=style,
+        edge_weight_col=edge_weight_col,
+        layout_seed=layout_seed,
         figsize=figsize,
     )
 

{matplotlibapi-4.0.3.dist-info → matplotlibapi-4.0.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: MatplotLibAPI
-Version: 4.0.3
+Version: 4.0.4
 License-File: LICENSE
 Requires-Python: >=3.9
 Requires-Dist: kaleido

{matplotlibapi-4.0.3.dist-info → matplotlibapi-4.0.4.dist-info}/RECORD

@@ -1,5 +1,5 @@
 MatplotLibAPI/__init__.py,sha256=3eYMzW-R3VbXAWrA6ab6opQNj1LaCsI8qc_ZNfCepzw,188
-MatplotLibAPI/accessor.py,sha256=AYxATXslp3XV63jGjObs3zyiPSS1DMZjNHaPKy5g8Wk,51941
+MatplotLibAPI/accessor.py,sha256=vjV9mfUz-gJAor-VZ-lZV9auobdX_7fzieA-22YySfM,53722
 MatplotLibAPI/area.py,sha256=nh9Lur1q8FoSGZu_PVaGF1NIzJOcENjp26rG3rRjOWY,5465
 MatplotLibAPI/bar.py,sha256=beDTQ2bMqB0tkDSn_6FfSPHrWS-vLtlhXQfy53vHfIw,4293
 MatplotLibAPI/base_plot.py,sha256=OJXljQRHJFFRtUsETaoBXwJzT1FaRu-u5zmnjx0iU7g,5314
@@ -25,11 +25,11 @@ MatplotLibAPI/mcp/metadata.py,sha256=G0SJSG4XX5fZQy5F2Ii3FVOM1uprFcBvbGpK7BxMDrg
 MatplotLibAPI/mcp/renderers.py,sha256=mB7B9ytr1ahxkK8MSIFQKtQ3nz5jYmX2JgKhQUe0W4k,1293
 MatplotLibAPI/network/__init__.py,sha256=qkAwW7aQTEORaFB7qcja4rSEpBXy5STveAwhDmV2o2E,784
 MatplotLibAPI/network/constants.py,sha256=857G_-7Gaa1L-8dsdRvWv681TpWfde9ixgrkTdzpY5A,467
-MatplotLibAPI/network/core.py,sha256=-pulwAOW4OF7E5xsjpSLU6l3AfQBsPRPC4sAznI-8Gk,45478
-MatplotLibAPI/network/plot.py,sha256=9ct2Xm8MyUsoZuVt77iFMI8_5b3u6DRD0DbQJt1dPc4,23253
+MatplotLibAPI/network/core.py,sha256=4bwUAMuNHD1TTOlQ8XjEmNp7L_jrBZ0KYWfDRbiIfAU,46300
+MatplotLibAPI/network/plot.py,sha256=cPtVC0jiXqj6JJkzpt6Pr7WgRasRnnIbFVFn9itCe6E,23327
 MatplotLibAPI/network/scaling.py,sha256=gdbusWHN-yKYWJjSZ0viqM5S31tZfLH8hojoc2fML2c,1632
-matplotlibapi-4.0.3.dist-info/METADATA,sha256=Yt2k9dcf1vrzGL0EvfD8mKV_yPBrEIhZEEeu8Fjs6d0,8457
-matplotlibapi-4.0.3.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-matplotlibapi-4.0.3.dist-info/entry_points.txt,sha256=x_X45-YKZXmwaEiyYqQiPVHFJ5Rj66qwNesDDq3-rWg,68
-matplotlibapi-4.0.3.dist-info/licenses/LICENSE,sha256=hMErKLb6YZR3lRR5zr-vxeFkvY69QAaafgSpZ5-P1dQ,1067
-matplotlibapi-4.0.3.dist-info/RECORD,,
+matplotlibapi-4.0.4.dist-info/METADATA,sha256=OE5rn8vXTR20_tFtXcAdjIpImth1yxntQoCvExM55t8,8457
+matplotlibapi-4.0.4.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+matplotlibapi-4.0.4.dist-info/entry_points.txt,sha256=x_X45-YKZXmwaEiyYqQiPVHFJ5Rj66qwNesDDq3-rWg,68
+matplotlibapi-4.0.4.dist-info/licenses/LICENSE,sha256=hMErKLb6YZR3lRR5zr-vxeFkvY69QAaafgSpZ5-P1dQ,1067
+matplotlibapi-4.0.4.dist-info/RECORD,,