MatplotLibAPI 3.2.20__py3-none-any.whl → 3.3.0__py3-none-any.whl

MatplotLibAPI/accessor.py

@@ -25,13 +25,16 @@ from .Histogram import aplot_histogram_kde, fplot_histogram_kde
 from .Network import (
     NETWORK_STYLE_TEMPLATE,
     aplot_network,
+    aplot_network_node,
     aplot_network_components,
+    fplot_network_node,
     fplot_network_components,
     fplot_network,
 )
 from .Pie import aplot_pie_donut, fplot_pie_donut
 from .Sankey import SANKEY_STYLE_TEMPLATE, fplot_sankey
 from .StyleTemplate import (
+    FIG_SIZE,
     AREA_STYLE_TEMPLATE,
     DISTRIBUTION_STYLE_TEMPLATE,
     PIE_STYLE_TEMPLATE,
@@ -109,10 +112,14 @@ class DataFrameAccessor:
         Plot a word cloud on a new figure.
     aplot_network
         Plot a network graph on a Matplotlib axes.
+    aplot_network_node
+        Plot the connected component for a specific node on a Matplotlib axes.
     aplot_network_components
         Plot connected components of a network graph on multiple axes.
     fplot_network
         Plot a network graph on a new figure.
+    fplot_network_node
+        Plot the connected component for a specific node on a new figure.
     fplot_network_components
         Plot connected components of a network graph on a new figure.
     fplot_treemap
@@ -210,7 +217,7 @@ class DataFrameAccessor:
         ascending: bool = False,
         hline: bool = False,
         vline: bool = False,
-        figsize: Tuple[float, float] = (19.2, 10.8),
+        figsize: Tuple[float, float] = FIG_SIZE,
         save_path: Optional[str] = None,
         savefig_kwargs: Optional[Dict[str, Any]] = None,
     ) -> Figure:
@@ -243,7 +250,7 @@ class DataFrameAccessor:
         vline : bool, optional
             If True, draw a vertical line at the mean of x-values. The default is `False`.
         figsize : tuple[float, float], optional
-            Figure size. The default is (19.2, 10.8).
+            Figure size. The default is FIG_SIZE.
 
         Returns
         -------
@@ -386,7 +393,7 @@ class DataFrameAccessor:
         stacked: bool = False,
         title: Optional[str] = None,
         style: StyleTemplate = DISTRIBUTION_STYLE_TEMPLATE,
-        figsize: Tuple[float, float] = (19.2, 10.8),
+        figsize: Tuple[float, float] = FIG_SIZE,
     ) -> Figure:
         """Plot bar or stacked bar charts on a new figure.
 
@@ -405,7 +412,7 @@ class DataFrameAccessor:
         style : StyleTemplate, optional
             Styling template. The default is ``DISTRIBUTION_STYLE_TEMPLATE``.
         figsize : tuple[float, float], optional
-            Figure size. The default is (19.2, 10.8).
+            Figure size. The default is FIG_SIZE.
 
         Returns
         -------
@@ -471,7 +478,7 @@ class DataFrameAccessor:
         kde: bool = True,
         title: Optional[str] = None,
         style: StyleTemplate = DISTRIBUTION_STYLE_TEMPLATE,
-        figsize: Tuple[float, float] = (19.2, 10.8),
+        figsize: Tuple[float, float] = FIG_SIZE,
     ) -> Figure:
         """Plot a histogram with an optional KDE on a new figure.
 
@@ -488,7 +495,7 @@ class DataFrameAccessor:
         style : StyleTemplate, optional
             Styling template. The default is ``DISTRIBUTION_STYLE_TEMPLATE``.
         figsize : tuple[float, float], optional
-            Figure size. The default is (19.2, 10.8).
+            Figure size. The default is FIG_SIZE.
 
         Returns
         -------
@@ -553,7 +560,7 @@ class DataFrameAccessor:
         violin: bool = False,
         title: Optional[str] = None,
         style: StyleTemplate = DISTRIBUTION_STYLE_TEMPLATE,
-        figsize: Tuple[float, float] = (19.2, 10.8),
+        figsize: Tuple[float, float] = FIG_SIZE,
     ) -> Figure:
         """Plot box or violin charts on a new figure.
 
@@ -570,7 +577,7 @@ class DataFrameAccessor:
         style : StyleTemplate, optional
             Styling template. The default is ``DISTRIBUTION_STYLE_TEMPLATE``.
         figsize : tuple[float, float], optional
-            Figure size. The default is (19.2, 10.8).
+            Figure size. The default is FIG_SIZE.
 
         Returns
         -------
@@ -635,7 +642,7 @@ class DataFrameAccessor:
         value: str,
         title: Optional[str] = None,
         style: StyleTemplate = HEATMAP_STYLE_TEMPLATE,
-        figsize: Tuple[float, float] = (19.2, 10.8),
+        figsize: Tuple[float, float] = FIG_SIZE,
     ) -> Figure:
         """Plot a heatmap on a new figure.
 
@@ -652,7 +659,7 @@ class DataFrameAccessor:
         style : StyleTemplate, optional
             Styling template. The default is ``HEATMAP_STYLE_TEMPLATE``.
         figsize : tuple[float, float], optional
-            Figure size. The default is (19.2, 10.8).
+            Figure size. The default is FIG_SIZE.
 
         Returns
         -------
@@ -712,7 +719,7 @@ class DataFrameAccessor:
         method: CorrelationMethod = "pearson",
         title: Optional[str] = None,
         style: StyleTemplate = HEATMAP_STYLE_TEMPLATE,
-        figsize: Tuple[float, float] = (19.2, 10.8),
+        figsize: Tuple[float, float] = FIG_SIZE,
     ) -> Figure:
         """Plot a correlation matrix heatmap on a new figure.
 
@@ -727,7 +734,7 @@ class DataFrameAccessor:
         style : StyleTemplate, optional
             Styling template. The default is ``HEATMAP_STYLE_TEMPLATE``.
         figsize : tuple[float, float], optional
-            Figure size. The default is (19.2, 10.8).
+            Figure size. The default is FIG_SIZE.
 
         Returns
         -------
@@ -796,7 +803,7 @@ class DataFrameAccessor:
         stacked: bool = True,
         title: Optional[str] = None,
         style: StyleTemplate = AREA_STYLE_TEMPLATE,
-        figsize: Tuple[float, float] = (19.2, 10.8),
+        figsize: Tuple[float, float] = FIG_SIZE,
     ) -> Figure:
         """Plot an area chart on a new figure.
 
@@ -815,7 +822,7 @@ class DataFrameAccessor:
         style : StyleTemplate, optional
             Styling template. The default is ``AREA_STYLE_TEMPLATE``.
         figsize : tuple[float, float], optional
-            Figure size. The default is (19.2, 10.8).
+            Figure size. The default is FIG_SIZE.
 
         Returns
         -------
@@ -881,7 +888,7 @@ class DataFrameAccessor:
         donut: bool = False,
         title: Optional[str] = None,
         style: StyleTemplate = PIE_STYLE_TEMPLATE,
-        figsize: Tuple[float, float] = (19.2, 10.8),
+        figsize: Tuple[float, float] = FIG_SIZE,
     ) -> Figure:
         """Plot pie or donut charts on a new figure.
 
@@ -898,7 +905,7 @@ class DataFrameAccessor:
         style : StyleTemplate, optional
             Styling template. The default is ``PIE_STYLE_TEMPLATE``.
         figsize : tuple[float, float], optional
-            Figure size. The default is (19.2, 10.8).
+            Figure size. The default is FIG_SIZE.
 
         Returns
         -------
@@ -963,7 +970,7 @@ class DataFrameAccessor:
         rows: int = 10,
         title: Optional[str] = None,
         style: StyleTemplate = PIE_STYLE_TEMPLATE,
-        figsize: Tuple[float, float] = (19.2, 10.8),
+        figsize: Tuple[float, float] = FIG_SIZE,
     ) -> Figure:
         """Plot waffle charts on a new figure.
 
@@ -980,7 +987,7 @@ class DataFrameAccessor:
         style : StyleTemplate, optional
             Styling template. The default is ``PIE_STYLE_TEMPLATE``.
         figsize : tuple[float, float], optional
-            Figure size. The default is (19.2, 10.8).
+            Figure size. The default is FIG_SIZE.
 
         Returns
         -------
@@ -1087,7 +1094,7 @@ class DataFrameAccessor:
         max_values: int = 20,
         sort_by: Optional[str] = None,
         ascending: bool = False,
-        figsize: Tuple[float, float] = (19.2, 10.8),
+        figsize: Tuple[float, float] = FIG_SIZE,
     ) -> Figure:
         """Plot a table of the DataFrame's data on a new figure.
 
@@ -1106,7 +1113,7 @@ class DataFrameAccessor:
         ascending : bool, optional
             Sort order. The default is `False`.
         figsize : tuple[float, float], optional
-            Figure size. The default is (19.2, 10.8).
+            Figure size. The default is FIG_SIZE.
 
         Returns
         -------
@@ -1192,7 +1199,7 @@ class DataFrameAccessor:
         sort_by: Optional[str] = None,
         ascending: bool = False,
         std: bool = False,
-        figsize: Tuple[float, float] = (19.2, 10.8),
+        figsize: Tuple[float, float] = FIG_SIZE,
     ) -> Figure:
         """Plot a time series on a new figure.
 
@@ -1217,7 +1224,7 @@ class DataFrameAccessor:
         std : bool, optional
             If True, plot the standard deviation. The default is `False`.
         figsize : tuple[float, float], optional
-            Figure size. The default is (19.2, 10.8).
+            Figure size. The default is FIG_SIZE.
 
         Returns
         -------
@@ -1296,7 +1303,7 @@ class DataFrameAccessor:
         max_words: int = 50,
         stopwords: Optional[List[str]] = None,
         random_state: Optional[int] = None,
-        figsize: Tuple[float, float] = (19.2, 10.8),
+        figsize: Tuple[float, float] = FIG_SIZE,
     ) -> Figure:
         """Plot a word cloud on a new figure.
 
@@ -1317,7 +1324,7 @@ class DataFrameAccessor:
         random_state : int, optional
             Seed for word placement. The default is ``None``.
         figsize : tuple[float, float], optional
-            Figure size. The default is (19.2, 10.8).
+            Figure size. The default is FIG_SIZE.
 
         Returns
         -------
@@ -1338,36 +1345,117 @@ class DataFrameAccessor:
 
     def aplot_network(
         self,
-        source: str = "source",
-        target: str = "target",
-        weight: str = "weight",
-        title: Optional[str] = None,
-        style: StyleTemplate = NETWORK_STYLE_TEMPLATE,
+        node_col: str = "node",
+        node_weight_col: str = "weight",
+        edge_source_col: str = "source",
+        edge_target_col: str = "target",
+        edge_weight_col: str = "weight",
         sort_by: Optional[str] = None,
         ascending: bool = False,
-        node_list: Optional[List] = None,
+        node_df: Optional[pd.DataFrame] = None,
+        title: Optional[str] = None,
+        style: StyleTemplate = NETWORK_STYLE_TEMPLATE,
+        layout_seed: Optional[int] = None,
         ax: Optional[Axes] = None,
     ) -> Axes:
         """Plot a network graph on a Matplotlib axes.
 
         Parameters
         ----------
-        source : str, optional
+        node_col : str, optional
+            Column for node identifiers. The default is "node".
+        node_weight_col : str, optional
+            Column for node weights. The default is "weight".
+        edge_source_col : str, optional
             Column for source nodes. The default is "source".
-        target : str, optional
+        edge_target_col : str, optional
             Column for target nodes. The default is "target".
-        weight : str, optional
+        edge_weight_col : str, optional
             Column for edge weights. The default is "weight".
+        sort_by : str, optional
+            Column to sort by.
+        ascending : bool, optional
+            Sort order. The default is `False`.
+        node_df : pd.DataFrame, optional
+            DataFrame containing ``node`` and ``weight`` columns for weighting.
         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"]``.
+        ax : Axes, optional
+            Matplotlib axes to plot on. If None, uses the current axes.
+
+        Returns
+        -------
+        Axes
+            The Matplotlib axes object with the plot.
+        """
+        kwargs: Dict[str, Any] = {}
+        if layout_seed is not None:
+            kwargs["layout_seed"] = layout_seed
+
+        return aplot_network(
+            pd_df=self._obj,
+            node_col=node_col,
+            node_weight_col=node_weight_col,
+            edge_source_col=edge_source_col,
+            edge_target_col=edge_target_col,
+            edge_weight_col=edge_weight_col,
+            sort_by=sort_by,
+            ascending=ascending,
+            node_df=node_df,
+            title=title,
+            style=style,
+            ax=ax,
+            **kwargs,
+        )
+
+    def aplot_network_node(
+        self,
+        node: Any,
+        node_col: str = "node",
+        node_weight_col: str = "weight",
+        edge_source_col: str = "source",
+        edge_target_col: str = "target",
+        edge_weight_col: str = "weight",
+        sort_by: Optional[str] = None,
+        ascending: bool = False,
+        node_df: Optional[pd.DataFrame] = None,
+        layout_seed: Optional[int] = None,
+        title: Optional[str] = None,
+        style: StyleTemplate = NETWORK_STYLE_TEMPLATE,
+        ax: Optional[Axes] = None,
+    ) -> Axes:
+        """Plot the connected component containing ``node``.
+
+        Parameters
+        ----------
+        node : Any
+            Node identifier whose component should be visualized.
+        node_col : str, optional
+            Column for node identifiers. The default is "node".
+        node_weight_col : str, optional
+            Column for node weights. The default is "weight".
+        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".
         sort_by : str, optional
             Column to sort by.
         ascending : bool, optional
             Sort order. The default is `False`.
-        node_list : list, optional
-            List of nodes to include. If None, all nodes are used.
+        node_df : pd.DataFrame, optional
+            DataFrame containing ``node`` and ``weight`` columns for weighting.
+        layout_seed : int, optional
+            Seed forwarded to the spring layout. The default is ``_DEFAULT["SPRING_LAYOUT_SEED"]``.
+        title : str, optional
+            Chart title. Defaults to the formatted node label when ``None``.
+        style : StyleTemplate, optional
+            Styling template. The default is `NETWORK_STYLE_TEMPLATE`.
         ax : Axes, optional
             Matplotlib axes to plot on. If None, uses the current axes.
 
@@ -1375,156 +1463,288 @@ class DataFrameAccessor:
         -------
         Axes
             The Matplotlib axes object with the plot.
+
+        Raises
+        ------
+        ValueError
+            If ``node`` is not present in the prepared graph.
         """
-        return aplot_network(
+        kwargs: Dict[str, Any] = {}
+        if layout_seed is not None:
+            kwargs["layout_seed"] = layout_seed
+
+        return aplot_network_node(
             pd_df=self._obj,
-            source=source,
-            target=target,
-            weight=weight,
-            title=title,
-            style=style,
+            node=node,
+            node_col=node_col,
+            node_weight_col=node_weight_col,
+            edge_source_col=edge_source_col,
+            edge_target_col=edge_target_col,
+            edge_weight_col=edge_weight_col,
             sort_by=sort_by,
             ascending=ascending,
-            node_list=node_list,
+            node_df=node_df,
+            title=title,
+            style=style,
             ax=ax,
+            **kwargs,
         )
 
     def aplot_network_components(
         self,
-        source: str = "source",
-        target: str = "target",
-        weight: str = "weight",
-        title: Optional[str] = None,
-        style: StyleTemplate = NETWORK_STYLE_TEMPLATE,
+        node_col: str = "node",
+        node_weight_col: str = "weight",
+        edge_source_col: str = "source",
+        edge_target_col: str = "target",
+        edge_weight_col: str = "weight",
         sort_by: Optional[str] = None,
         ascending: bool = False,
-        node_list: Optional[List] = None,
+        node_df: Optional[pd.DataFrame] = None,
+        title: Optional[str] = None,
+        style: StyleTemplate = NETWORK_STYLE_TEMPLATE,
+        layout_seed: Optional[int] = None,
         axes: Optional[np.ndarray] = None,
     ) -> None:
         """Plot connected components of a network graph on multiple axes.
 
         Parameters
         ----------
-        source : str, optional
+        node_col : str, optional
+            Column for node identifiers. The default is "node".
+        node_weight_col : str, optional
+            Column for node weights. The default is "weight".
+        edge_source_col : str, optional
             Column for source nodes. The default is "source".
-        target : str, optional
+        edge_target_col : str, optional
             Column for target nodes. The default is "target".
-        weight : str, optional
+        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`.
         sort_by : str, optional
             Column to sort by.
         ascending : bool, optional
             Sort order. The default is `False`.
-        node_list : list, optional
-            List of nodes to include. If None, all nodes are used.
+        node_df : pd.DataFrame, optional
+            DataFrame containing ``node`` and ``weight`` columns for weighting.
+        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"]``.
         axes : np.ndarray, optional
             Numpy array of Matplotlib axes to plot on. If None, new axes are created.
         """
+        kwargs: Dict[str, Any] = {}
+        if layout_seed is not None:
+            kwargs["layout_seed"] = layout_seed
+
         aplot_network_components(
             pd_df=self._obj,
-            source=source,
-            target=target,
-            weight=weight,
-            title=title,
-            style=style,
+            node_col=node_col,
+            node_weight_col=node_weight_col,
+            edge_source_col=edge_source_col,
+            edge_target_col=edge_target_col,
+            edge_weight_col=edge_weight_col,
             sort_by=sort_by,
             ascending=ascending,
-            node_list=node_list,
+            node_df=node_df,
+            title=title,
+            style=style,
             axes=axes,
+            **kwargs,
         )
 
     def fplot_network(
         self,
-        source: str = "source",
-        target: str = "target",
-        weight: str = "weight",
-        title: Optional[str] = None,
-        style: StyleTemplate = NETWORK_STYLE_TEMPLATE,
+        node_col: str = "node",
+        node_weight_col: str = "weight",
+        edge_source_col: str = "source",
+        edge_target_col: str = "target",
+        edge_weight_col: str = "weight",
         sort_by: Optional[str] = None,
         ascending: bool = False,
-        node_list: Optional[List] = None,
-        figsize: Tuple[float, float] = (19.2, 10.8),
+        node_df: Optional[pd.DataFrame] = None,
+        title: Optional[str] = None,
+        style: StyleTemplate = NETWORK_STYLE_TEMPLATE,
+        layout_seed: Optional[int] = None,
+        figsize: Tuple[float, float] = FIG_SIZE,
     ) -> Figure:
         """Plot a network graph on a new figure.
 
         Parameters
         ----------
-        source : str, optional
+        node_col : str, optional
+            Column for node identifiers. The default is "node".
+        node_weight_col : str, optional
+            Column for node weights. The default is "weight".
+        edge_source_col : str, optional
             Column for source nodes. The default is "source".
-        target : str, optional
+        edge_target_col : str, optional
             Column for target nodes. The default is "target".
-        weight : str, optional
+        edge_weight_col : str, optional
             Column for edge weights. The default is "weight".
+        sort_by : str, optional
+            Column to sort by.
+        ascending : bool, optional
+            Sort order. The default is `False`.
+        node_df : pd.DataFrame, optional
+            DataFrame containing ``node`` and ``weight`` columns for weighting.
         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
+
+        return fplot_network(
+            pd_df=self._obj,
+            node_col=node_col,
+            node_weight_col=node_weight_col,
+            edge_source_col=edge_source_col,
+            edge_target_col=edge_target_col,
+            edge_weight_col=edge_weight_col,
+            sort_by=sort_by,
+            ascending=ascending,
+            node_df=node_df,
+            title=title,
+            style=style,
+            figsize=figsize,
+            **kwargs,
+        )
+
+    def fplot_network_node(
+        self,
+        node: Any,
+        node_col: str = "node",
+        node_weight_col: str = "weight",
+        edge_source_col: str = "source",
+        edge_target_col: str = "target",
+        edge_weight_col: str = "weight",
+        sort_by: Optional[str] = None,
+        ascending: bool = False,
+        node_df: Optional[pd.DataFrame] = None,
+        layout_seed: Optional[int] = None,
+        title: Optional[str] = None,
+        style: StyleTemplate = NETWORK_STYLE_TEMPLATE,
+        figsize: Tuple[float, float] = FIG_SIZE,
+    ) -> Figure:
+        """Plot the connected component containing ``node`` on a new figure.
+
+        Parameters
+        ----------
+        node : Any
+            Node identifier whose component should be visualized.
+        node_col : str, optional
+            Column for node identifiers. The default is "node".
+        node_weight_col : str, optional
+            Column for node weights. The default is "weight".
+        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".
         sort_by : str, optional
             Column to sort by.
         ascending : bool, optional
             Sort order. The default is `False`.
-        node_list : list, optional
-            List of nodes to include. If None, all nodes are used.
+        node_df : pd.DataFrame, optional
+            DataFrame containing ``node`` and ``weight`` columns for weighting.
+        layout_seed : int, optional
+            Seed forwarded to the spring layout. The default is ``_DEFAULT["SPRING_LAYOUT_SEED"]``.
+        title : str, optional
+            Chart title. Defaults to the formatted node label when ``None``.
+        style : StyleTemplate, optional
+            Styling template. The default is `NETWORK_STYLE_TEMPLATE`.
         figsize : tuple[float, float], optional
-            Figure size. The default is (19.2, 10.8).
+            Figure size. The default is FIG_SIZE.
 
         Returns
         -------
         Figure
             The new Matplotlib figure with the plot.
+
+        Raises
+        ------
+        ValueError
+            If ``node`` is not present in the prepared graph.
         """
-        return fplot_network(
+        kwargs: Dict[str, Any] = {}
+        if layout_seed is not None:
+            kwargs["layout_seed"] = layout_seed
+
+        return fplot_network_node(
             pd_df=self._obj,
-            source=source,
-            target=target,
-            weight=weight,
-            title=title,
-            style=style,
+            node=node,
+            node_col=node_col,
+            node_weight_col=node_weight_col,
+            edge_source_col=edge_source_col,
+            edge_target_col=edge_target_col,
+            edge_weight_col=edge_weight_col,
             sort_by=sort_by,
             ascending=ascending,
-            node_list=node_list,
+            node_df=node_df,
+            title=title,
+            style=style,
             figsize=figsize,
+            **kwargs,
         )
 
     def fplot_network_components(
         self,
-        source: str = "source",
-        target: str = "target",
-        weight: str = "weight",
-        title: Optional[str] = None,
-        style: StyleTemplate = NETWORK_STYLE_TEMPLATE,
+        node_col: str = "node",
+        node_weight_col: str = "weight",
+        edge_source_col: str = "source",
+        edge_target_col: str = "target",
+        edge_weight_col: str = "weight",
         sort_by: Optional[str] = None,
         ascending: bool = False,
-        node_list: Optional[List] = None,
-        figsize: Tuple[float, float] = (19.2, 10.8),
+        node_df: Optional[pd.DataFrame] = None,
+        title: Optional[str] = None,
+        style: StyleTemplate = NETWORK_STYLE_TEMPLATE,
+        layout_seed: Optional[int] = None,
+        figsize: Tuple[float, float] = FIG_SIZE,
         n_cols: Optional[int] = None,
     ) -> Figure:
         """Plot network components on a new figure.
 
         Parameters
         ----------
-        source : str, optional
+        node_col : str, optional
+            Column for node identifiers. The default is "node".
+        node_weight_col : str, optional
+            Column for node weights. The default is "weight".
+        edge_source_col : str, optional
             Column for source nodes. The default is "source".
-        target : str, optional
+        edge_target_col : str, optional
             Column for target nodes. The default is "target".
-        weight : str, optional
+        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`.
         sort_by : str, optional
             Column to sort by.
         ascending : bool, optional
             Sort order. The default is `False`.
-        node_list : list, optional
-            List of nodes to include. If None, all nodes are used.
+        node_df : pd.DataFrame, optional
+            DataFrame containing ``node`` and ``weight`` columns for weighting.
+        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 (19.2, 10.8).
+            Figure size. The default is FIG_SIZE.
         n_cols : int, optional
             Number of columns for arranging component subplots.
 
@@ -1533,18 +1753,25 @@ class DataFrameAccessor:
         Figure
             The new Matplotlib figure with component plots.
         """
+        kwargs: Dict[str, Any] = {}
+        if layout_seed is not None:
+            kwargs["layout_seed"] = layout_seed
+
         return fplot_network_components(
             pd_df=self._obj,
-            source=source,
-            target=target,
-            weight=weight,
-            title=title,
-            style=style,
+            node_col=node_col,
+            node_weight_col=node_weight_col,
+            edge_source_col=edge_source_col,
+            edge_target_col=edge_target_col,
+            edge_weight_col=edge_weight_col,
             sort_by=sort_by,
             ascending=ascending,
-            node_list=node_list,
+            node_df=node_df,
+            title=title,
+            style=style,
             figsize=figsize,
             n_cols=n_cols,
+            **kwargs,
         )
 
     def fplot_treemap(