MatplotLibAPI 3.2.21__py3-none-any.whl → 4.0.0__py3-none-any.whl

MatplotLibAPI/accessor.py

@@ -1,37 +1,17 @@
 """Pandas accessor exposing MatplotLibAPI plotting helpers."""
 
-from typing import Any, Dict, List, Optional, Tuple
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, Dict, List, Optional, Tuple
 
 import numpy as np
 import pandas as pd
-import plotly.graph_objects as go
 from matplotlib.axes import Axes
 from matplotlib.figure import Figure
 from pandas.api.extensions import register_dataframe_accessor
 
-from .Area import aplot_area, fplot_area
-from .Bar import aplot_bar, fplot_bar
-from .BoxViolin import aplot_box_violin, fplot_box_violin
-from .Bubble import BUBBLE_STYLE_TEMPLATE, aplot_bubble, fplot_bubble
-from .Composite import plot_composite_bubble, plot_composite_treemap
-from .Heatmap import (
-    HEATMAP_STYLE_TEMPLATE,
-    aplot_correlation_matrix,
-    aplot_heatmap,
-    fplot_correlation_matrix,
-    fplot_heatmap,
-)
-from .Histogram import aplot_histogram_kde, fplot_histogram_kde
-from .Network import (
-    NETWORK_STYLE_TEMPLATE,
-    aplot_network,
-    aplot_network_components,
-    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 (
+from .base_plot import BasePlot
+from .style_template import (
     FIG_SIZE,
     AREA_STYLE_TEMPLATE,
     DISTRIBUTION_STYLE_TEMPLATE,
@@ -41,19 +21,198 @@ from .StyleTemplate import (
     TREEMAP_STYLE_TEMPLATE,
     StyleTemplate,
 )
-from ._typing import CorrelationMethod
-from .Table import aplot_table, fplot_table
-from .Timeserie import aplot_timeserie, fplot_timeserie
-from .Sunburst import fplot_sunburst
-from .Treemap import fplot_treemap
-from .Waffle import aplot_waffle, fplot_waffle
-from .Wordcloud import WORDCLOUD_STYLE_TEMPLATE, aplot_wordcloud, fplot_wordcloud
+from .typing import CorrelationMethod
+
+if TYPE_CHECKING:
+    import plotly.graph_objects as go
+
+
+def _bubble_imports() -> tuple[StyleTemplate, type]:
+    from .bubble import BUBBLE_STYLE_TEMPLATE, Bubble
+
+    return BUBBLE_STYLE_TEMPLATE, Bubble
+
+
+def _heatmap_imports() -> tuple[StyleTemplate, Any, Any, Any, Any]:
+    from .heatmap import (
+        HEATMAP_STYLE_TEMPLATE,
+        aplot_correlation_matrix,
+        aplot_heatmap,
+        fplot_correlation_matrix,
+        fplot_heatmap,
+    )
+
+    return (
+        HEATMAP_STYLE_TEMPLATE,
+        aplot_correlation_matrix,
+        aplot_heatmap,
+        fplot_correlation_matrix,
+        fplot_heatmap,
+    )
+
+
+def _network_imports() -> tuple[StyleTemplate, Any, Any, Any, Any, Any, Any]:
+    from .network import (
+        NETWORK_STYLE_TEMPLATE,
+        aplot_network,
+        aplot_network_node,
+        aplot_network_components,
+        fplot_network,
+        fplot_network_node,
+        fplot_network_components,
+    )
+
+    return (
+        NETWORK_STYLE_TEMPLATE,
+        aplot_network,
+        aplot_network_node,
+        aplot_network_components,
+        fplot_network,
+        fplot_network_node,
+        fplot_network_components,
+    )
+
+
+def _wordcloud_imports() -> tuple[StyleTemplate, Any, Any]:
+    from .word_cloud import WORDCLOUD_STYLE_TEMPLATE, aplot_wordcloud, fplot_wordcloud
+
+    return WORDCLOUD_STYLE_TEMPLATE, aplot_wordcloud, fplot_wordcloud
+
+
+def _sankey_imports() -> tuple[StyleTemplate, Any]:
+    from .sankey import SANKEY_STYLE_TEMPLATE, fplot_sankey
+
+    return SANKEY_STYLE_TEMPLATE, fplot_sankey
+
+
+def aplot_area(*args: Any, **kwargs: Any) -> Axes:
+    from .area import aplot_area as _aplot_area
+
+    return _aplot_area(*args, **kwargs)
+
+
+def fplot_area(*args: Any, **kwargs: Any) -> Figure:
+    from .area import fplot_area as _fplot_area
+
+    return _fplot_area(*args, **kwargs)
+
+
+def aplot_bar(*args: Any, **kwargs: Any) -> Axes:
+    from .bar import aplot_bar as _aplot_bar
+
+    return _aplot_bar(*args, **kwargs)
+
+
+def fplot_bar(*args: Any, **kwargs: Any) -> Figure:
+    from .bar import fplot_bar as _fplot_bar
+
+    return _fplot_bar(*args, **kwargs)
+
+
+def aplot_box_violin(*args: Any, **kwargs: Any) -> Axes:
+    from .box_violin import aplot_box_violin as _aplot_box_violin
+
+    return _aplot_box_violin(*args, **kwargs)
+
+
+def fplot_box_violin(*args: Any, **kwargs: Any) -> Figure:
+    from .box_violin import fplot_box_violin as _fplot_box_violin
+
+    return _fplot_box_violin(*args, **kwargs)
+
+
+def aplot_histogram(*args: Any, **kwargs: Any) -> Axes:
+    from .histogram import aplot_histogram as _aplot_histogram
+
+    return _aplot_histogram(*args, **kwargs)
+
+
+def fplot_histogram(*args: Any, **kwargs: Any) -> Figure:
+    from .histogram import fplot_histogram as _fplot_histogram
+
+    return _fplot_histogram(*args, **kwargs)
+
+
+def aplot_pie_donut(*args: Any, **kwargs: Any) -> Axes:
+    from .pie import aplot_pie as _aplot_pie_donut
+
+    return _aplot_pie_donut(*args, **kwargs)
+
+
+def fplot_pie_donut(*args: Any, **kwargs: Any) -> Figure:
+    from .pie import fplot_pie as _fplot_pie_donut
+
+    return _fplot_pie_donut(*args, **kwargs)
+
+
+def aplot_table(*args: Any, **kwargs: Any) -> Axes:
+    from .table import aplot_table as _aplot_table
+
+    return _aplot_table(*args, **kwargs)
+
+
+def fplot_table(*args: Any, **kwargs: Any) -> Figure:
+    from .table import fplot_table as _fplot_table
+
+    return _fplot_table(*args, **kwargs)
+
+
+def aplot_timeserie(*args: Any, **kwargs: Any) -> Axes:
+    from .timeserie import aplot_timeserie as _aplot_timeserie
+
+    return _aplot_timeserie(*args, **kwargs)
+
+
+def fplot_timeserie(*args: Any, **kwargs: Any) -> Figure:
+    from .timeserie import fplot_timeserie as _fplot_timeserie
+
+    return _fplot_timeserie(*args, **kwargs)
+
+
+def aplot_waffle(*args: Any, **kwargs: Any) -> Axes:
+    from .waffle import aplot_waffle as _aplot_waffle
+
+    return _aplot_waffle(*args, **kwargs)
+
+
+def fplot_waffle(*args: Any, **kwargs: Any) -> Figure:
+    from .waffle import fplot_waffle as _fplot_waffle
+
+    return _fplot_waffle(*args, **kwargs)
+
+
+def fplot_treemap(*args: Any, **kwargs: Any) -> go.Figure:
+    from .treemap import fplot_treemap as _fplot_treemap
+
+    return _fplot_treemap(*args, **kwargs)
+
+
+def fplot_sunburst(*args: Any, **kwargs: Any) -> go.Figure:
+    from .sunburst import fplot_sunburst as _fplot_sunburst
+
+    return _fplot_sunburst(*args, **kwargs)
+
+
+def plot_composite_bubble(*args: Any, **kwargs: Any) -> Figure:
+    from .composite import plot_composite_bubble as _plot_composite_bubble
+
+    return _plot_composite_bubble(*args, **kwargs)
+
+
+def plot_composite_treemap(*args: Any, **kwargs: Any) -> Optional[go.Figure]:
+    from .composite import plot_composite_treemap as _plot_composite_treemap
+
+    return _plot_composite_treemap(*args, **kwargs)
 
 
 @register_dataframe_accessor("mpl")
 class DataFrameAccessor:
     """Expose MatplotLibAPI plotting helpers as a pandas accessor.
 
+    All plot methods follow the BasePlot interface pattern, providing both
+    aplot_* (plot on existing axes) and fplot_* (plot on new figure) variants
+    for consistency and ease of use.
+
     Methods
     -------
     aplot_bubble
@@ -110,10 +269,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
@@ -135,7 +298,7 @@ class DataFrameAccessor:
         y: str,
         z: str,
         title: Optional[str] = None,
-        style: StyleTemplate = BUBBLE_STYLE_TEMPLATE,
+        style: Optional[StyleTemplate] = None,
         max_values: int = 50,
         center_to_mean: bool = False,
         sort_by: Optional[str] = None,
@@ -180,18 +343,21 @@ class DataFrameAccessor:
         Axes
             The Matplotlib axes object with the plot.
         """
-        return aplot_bubble(
+        bubble_style_template, Bubble = _bubble_imports()
+
+        return Bubble(
             pd_df=self._obj,
             label=label,
             x=x,
             y=y,
             z=z,
-            title=title,
-            style=style,
             max_values=max_values,
             center_to_mean=center_to_mean,
             sort_by=sort_by,
             ascending=ascending,
+        ).aplot(
+            title=title,
+            style=style or bubble_style_template,
             hline=hline,
             vline=vline,
             ax=ax,
@@ -204,7 +370,7 @@ class DataFrameAccessor:
         y: str,
         z: str,
         title: Optional[str] = None,
-        style: StyleTemplate = BUBBLE_STYLE_TEMPLATE,
+        style: Optional[StyleTemplate] = None,
         max_values: int = 50,
         center_to_mean: bool = False,
         sort_by: Optional[str] = None,
@@ -212,8 +378,6 @@ class DataFrameAccessor:
         hline: bool = False,
         vline: bool = False,
         figsize: Tuple[float, float] = FIG_SIZE,
-        save_path: Optional[str] = None,
-        savefig_kwargs: Optional[Dict[str, Any]] = None,
     ) -> Figure:
         """Plot a bubble chart on a new figure.
 
@@ -251,14 +415,25 @@ class DataFrameAccessor:
         Figure
             The new Matplotlib figure with the plot.
         """
-        return fplot_bubble(
+        bubble_style_template, Bubble = _bubble_imports()
+
+        return Bubble(
             pd_df=self._obj,
+            label=label,
+            x=x,
+            y=y,
+            z=z,
+            sort_by=sort_by,
+            ascending=ascending,
+            max_values=max_values,
+            center_to_mean=center_to_mean,
+        ).fplot(
             label=label,
             x=x,
             y=y,
             z=z,
             title=title,
-            style=style,
+            style=style or bubble_style_template,
             max_values=max_values,
             center_to_mean=center_to_mean,
             sort_by=sort_by,
@@ -266,8 +441,6 @@ class DataFrameAccessor:
             hline=hline,
             vline=vline,
             figsize=figsize,
-            save_path=save_path,
-            savefig_kwargs=savefig_kwargs,
         )
 
     def fplot_composite_bubble(
@@ -277,7 +450,7 @@ class DataFrameAccessor:
         y: str,
         z: str,
         title: Optional[str] = None,
-        style: StyleTemplate = BUBBLE_STYLE_TEMPLATE,
+        style: Optional[StyleTemplate] = None,
         max_values: int = 100,
         center_to_mean: bool = False,
         sort_by: Optional[str] = None,
@@ -319,6 +492,8 @@ class DataFrameAccessor:
         Figure
             The new Matplotlib figure with the composite plot.
         """
+        bubble_style_template, _ = _bubble_imports()
+
         return plot_composite_bubble(
             pd_df=self._obj,
             label=label,
@@ -326,7 +501,7 @@ class DataFrameAccessor:
             y=y,
             z=z,
             title=title,
-            style=style,
+            style=style or bubble_style_template,
             max_values=max_values,
             center_to_mean=center_to_mean,
             sort_by=sort_by,
@@ -375,7 +550,7 @@ class DataFrameAccessor:
             group=group,
             stacked=stacked,
             title=title,
-            style=style,
+            style=style or DISTRIBUTION_STYLE_TEMPLATE,
             ax=ax,
         )
 
@@ -455,7 +630,7 @@ class DataFrameAccessor:
         Axes
             The Matplotlib axes object with the histogram.
         """
-        return aplot_histogram_kde(
+        return aplot_histogram(
             pd_df=self._obj,
             column=column,
             bins=bins,
@@ -496,7 +671,7 @@ class DataFrameAccessor:
         Figure
             The new Matplotlib figure with the histogram.
         """
-        return fplot_histogram_kde(
+        return fplot_histogram(
             pd_df=self._obj,
             column=column,
             bins=bins,
@@ -594,7 +769,7 @@ class DataFrameAccessor:
         y: str,
         value: str,
         title: Optional[str] = None,
-        style: StyleTemplate = HEATMAP_STYLE_TEMPLATE,
+        style: Optional[StyleTemplate] = None,
         ax: Optional[Axes] = None,
     ) -> Axes:
         """Plot a heatmap for dense categorical combinations.
@@ -619,13 +794,15 @@ class DataFrameAccessor:
         Axes
             The Matplotlib axes object with the heatmap.
         """
+        heatmap_style_template, _, aplot_heatmap, _, _ = _heatmap_imports()
+
         return aplot_heatmap(
             pd_df=self._obj,
             x=x,
             y=y,
             value=value,
             title=title,
-            style=style,
+            style=style or DISTRIBUTION_STYLE_TEMPLATE,
             ax=ax,
         )
 
@@ -635,7 +812,7 @@ class DataFrameAccessor:
         y: str,
         value: str,
         title: Optional[str] = None,
-        style: StyleTemplate = HEATMAP_STYLE_TEMPLATE,
+        style: Optional[StyleTemplate] = None,
         figsize: Tuple[float, float] = FIG_SIZE,
     ) -> Figure:
         """Plot a heatmap on a new figure.
@@ -660,13 +837,15 @@ class DataFrameAccessor:
         Figure
             The new Matplotlib figure with the heatmap.
         """
+        heatmap_style_template, _, _, _, fplot_heatmap = _heatmap_imports()
+
         return fplot_heatmap(
             pd_df=self._obj,
             x=x,
             y=y,
             value=value,
             title=title,
-            style=style,
+            style=style or heatmap_style_template,
             figsize=figsize,
         )
 
@@ -675,7 +854,7 @@ class DataFrameAccessor:
         columns: Optional[List[str]] = None,
         method: CorrelationMethod = "pearson",
         title: Optional[str] = None,
-        style: StyleTemplate = HEATMAP_STYLE_TEMPLATE,
+        style: Optional[StyleTemplate] = None,
         ax: Optional[Axes] = None,
     ) -> Axes:
         """Plot a correlation matrix heatmap.
@@ -698,52 +877,17 @@ class DataFrameAccessor:
         Axes
             The Matplotlib axes object with the correlation matrix.
         """
+        heatmap_style_template, aplot_correlation_matrix, _, _, _ = _heatmap_imports()
+
         return aplot_correlation_matrix(
             pd_df=self._obj,
             columns=columns,
             method=method,
             title=title,
-            style=style,
+            style=style or DISTRIBUTION_STYLE_TEMPLATE,
             ax=ax,
         )
 
-    def fplot_correlation_matrix(
-        self,
-        columns: Optional[List[str]] = None,
-        method: CorrelationMethod = "pearson",
-        title: Optional[str] = None,
-        style: StyleTemplate = HEATMAP_STYLE_TEMPLATE,
-        figsize: Tuple[float, float] = FIG_SIZE,
-    ) -> Figure:
-        """Plot a correlation matrix heatmap on a new figure.
-
-        Parameters
-        ----------
-        columns : list[str], optional
-            Numeric columns to include. The default is ``None`` for all numeric columns.
-        method : CorrelationMethod, optional
-            Correlation method. The default is "pearson".
-        title : str, optional
-            Chart title.
-        style : StyleTemplate, optional
-            Styling template. The default is ``HEATMAP_STYLE_TEMPLATE``.
-        figsize : tuple[float, float], optional
-            Figure size. The default is FIG_SIZE.
-
-        Returns
-        -------
-        Figure
-            The new Matplotlib figure with the correlation matrix.
-        """
-        return fplot_correlation_matrix(
-            pd_df=self._obj,
-            columns=columns,
-            method=method,
-            title=title,
-            style=style,
-            figsize=figsize,
-        )
-
     def aplot_area(
         self,
         x: str,
@@ -1004,7 +1148,7 @@ class DataFrameAccessor:
         target: str,
         value: str,
         title: Optional[str] = None,
-        style: StyleTemplate = SANKEY_STYLE_TEMPLATE,
+        style: Optional[StyleTemplate] = None,
     ) -> go.Figure:
         """Plot a Sankey diagram for flow data.
 
@@ -1026,13 +1170,15 @@ class DataFrameAccessor:
         go.Figure
             The Plotly Sankey figure.
         """
+        sankey_style_template, fplot_sankey = _sankey_imports()
+
         return fplot_sankey(
             pd_df=self._obj,
             source=source,
             target=target,
             value=value,
             title=title,
-            style=style,
+            style=style or sankey_style_template,
         )
 
     def aplot_table(
@@ -1073,7 +1219,7 @@ class DataFrameAccessor:
             pd_df=self._obj,
             cols=cols,
             title=title,
-            style=style,
+            style=style or TABLE_STYLE_TEMPLATE,
             max_values=max_values,
             sort_by=sort_by,
             ascending=ascending,
@@ -1118,7 +1264,7 @@ class DataFrameAccessor:
             pd_df=self._obj,
             cols=cols,
             title=title,
-            style=style,
+            style=style or TABLE_STYLE_TEMPLATE,
             max_values=max_values,
             sort_by=sort_by,
             ascending=ascending,
@@ -1174,7 +1320,7 @@ class DataFrameAccessor:
             x=x,
             y=y,
             title=title,
-            style=style,
+            style=style or TIMESERIE_STYLE_TEMPLATE,
             max_values=max_values,
             sort_by=sort_by,
             ascending=ascending,
@@ -1231,7 +1377,7 @@ class DataFrameAccessor:
             x=x,
             y=y,
             title=title,
-            style=style,
+            style=style or TIMESERIE_STYLE_TEMPLATE,
             max_values=max_values,
             sort_by=sort_by,
             ascending=ascending,
@@ -1242,9 +1388,9 @@ class DataFrameAccessor:
     def aplot_wordcloud(
         self,
         text_column: str,
-        weight_column: Optional[str] = None,
+        weight_column: str,
         title: Optional[str] = None,
-        style: StyleTemplate = WORDCLOUD_STYLE_TEMPLATE,
+        style: Optional[StyleTemplate] = None,
         max_words: int = 50,
         stopwords: Optional[List[str]] = None,
         random_state: Optional[int] = None,
@@ -1276,12 +1422,14 @@ class DataFrameAccessor:
         Axes
             The Matplotlib axes object with the plot.
         """
+        wordcloud_style_template, aplot_wordcloud, _ = _wordcloud_imports()
+
         return aplot_wordcloud(
             pd_df=self._obj,
             text_column=text_column,
             weight_column=weight_column,
             title=title,
-            style=style,
+            style=style or wordcloud_style_template,
             max_words=max_words,
             stopwords=stopwords,
             random_state=random_state,
@@ -1291,9 +1439,9 @@ class DataFrameAccessor:
     def fplot_wordcloud(
         self,
         text_column: str,
-        weight_column: Optional[str] = None,
+        weight_column: str,
         title: Optional[str] = None,
-        style: StyleTemplate = WORDCLOUD_STYLE_TEMPLATE,
+        style: Optional[StyleTemplate] = None,
         max_words: int = 50,
         stopwords: Optional[List[str]] = None,
         random_state: Optional[int] = None,
@@ -1325,12 +1473,14 @@ class DataFrameAccessor:
         Figure
             The new Matplotlib figure with the plot.
         """
+        wordcloud_style_template, _, fplot_wordcloud = _wordcloud_imports()
+
         return fplot_wordcloud(
             pd_df=self._obj,
             text_column=text_column,
             weight_column=weight_column,
             title=title,
-            style=style,
+            style=style or wordcloud_style_template,
             max_words=max_words,
             stopwords=stopwords,
             random_state=random_state,
@@ -1339,36 +1489,104 @@ class DataFrameAccessor:
 
     def aplot_network(
         self,
-        source: str = "source",
-        target: str = "target",
-        weight: str = "weight",
+        edge_source_col: str = "source",
+        edge_target_col: str = "target",
+        edge_weight_col: str = "weight",
         title: Optional[str] = None,
-        style: StyleTemplate = NETWORK_STYLE_TEMPLATE,
-        sort_by: Optional[str] = None,
-        ascending: bool = False,
-        node_list: Optional[List] = None,
+        style: Optional[StyleTemplate] = None,
+        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
+
+        network_style_template, aplot_network, _, _, _, _, _ = _network_imports()
+
+        return aplot_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,
+            ax=ax,
+            **kwargs,
+        )
+
+    def aplot_network_node(
+        self,
+        node: Any,
+        edge_source_col: str = "source",
+        edge_target_col: str = "target",
+        edge_weight_col: str = "weight",
+        layout_seed: Optional[int] = None,
+        title: Optional[str] = None,
+        style: Optional[StyleTemplate] = None,
+        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.
 
@@ -1376,100 +1594,192 @@ 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
+
+        network_style_template, _, aplot_network_node, _, _, _, _ = _network_imports()
+
+        return aplot_network_node(
             pd_df=self._obj,
-            source=source,
-            target=target,
-            weight=weight,
+            node=node,
+            edge_source_col=edge_source_col,
+            edge_target_col=edge_target_col,
+            edge_weight_col=edge_weight_col,
             title=title,
-            style=style,
-            sort_by=sort_by,
-            ascending=ascending,
-            node_list=node_list,
+            style=style or network_style_template,
             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,
+        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,
+        title: Optional[str] = None,
+        style: Optional[StyleTemplate] = None,
+        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
+
+        network_style_template, _, _, aplot_network_components, _, _, _ = (
+            _network_imports()
+        )
+
         aplot_network_components(
             pd_df=self._obj,
-            source=source,
-            target=target,
-            weight=weight,
-            title=title,
-            style=style,
+            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,
+            title=title,
+            style=style or network_style_template,
             axes=axes,
+            **kwargs,
         )
 
     def fplot_network(
         self,
-        source: str = "source",
-        target: str = "target",
-        weight: str = "weight",
+        edge_source_col: str = "source",
+        edge_target_col: str = "target",
+        edge_weight_col: str = "weight",
         title: Optional[str] = None,
-        style: StyleTemplate = NETWORK_STYLE_TEMPLATE,
-        sort_by: Optional[str] = None,
-        ascending: bool = False,
-        node_list: Optional[List] = 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
         ----------
-        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
+
+        network_style_template, _, _, _, fplot_network, _, _ = _network_imports()
+
+        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 fplot_network_node(
+        self,
+        node: Any,
+        edge_source_col: str = "source",
+        edge_target_col: str = "target",
+        edge_weight_col: str = "weight",
+        layout_seed: Optional[int] = None,
+        title: Optional[str] = None,
+        style: Optional[StyleTemplate] = None,
+        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 FIG_SIZE.
 
@@ -1477,30 +1787,38 @@ class DataFrameAccessor:
         -------
         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
+
+        network_style_template, _, _, _, _, fplot_network_node, _ = _network_imports()
+
+        return fplot_network_node(
             pd_df=self._obj,
-            source=source,
-            target=target,
-            weight=weight,
+            node=node,
+            edge_source_col=edge_source_col,
+            edge_target_col=edge_target_col,
+            edge_weight_col=edge_weight_col,
             title=title,
-            style=style,
-            sort_by=sort_by,
-            ascending=ascending,
-            node_list=node_list,
+            style=style or network_style_template,
             figsize=figsize,
+            **kwargs,
         )
 
     def fplot_network_components(
         self,
-        source: str = "source",
-        target: str = "target",
-        weight: str = "weight",
+        edge_source_col: str = "source",
+        edge_target_col: str = "target",
+        edge_weight_col: str = "weight",
         title: Optional[str] = None,
-        style: StyleTemplate = NETWORK_STYLE_TEMPLATE,
-        sort_by: Optional[str] = None,
-        ascending: bool = False,
-        node_list: Optional[List] = None,
+        style: Optional[StyleTemplate] = None,
+        layout_seed: Optional[int] = None,
         figsize: Tuple[float, float] = FIG_SIZE,
         n_cols: Optional[int] = None,
     ) -> Figure:
@@ -1508,22 +1826,28 @@ class DataFrameAccessor:
 
         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 FIG_SIZE.
         n_cols : int, optional
@@ -1534,18 +1858,24 @@ 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
+
+        network_style_template, _, _, _, _, _, fplot_network_components = (
+            _network_imports()
+        )
+
         return fplot_network_components(
             pd_df=self._obj,
-            source=source,
-            target=target,
-            weight=weight,
+            edge_source_col=edge_source_col,
+            edge_target_col=edge_target_col,
+            edge_weight_col=edge_weight_col,
             title=title,
-            style=style,
-            sort_by=sort_by,
-            ascending=ascending,
-            node_list=node_list,
+            style=style or network_style_template,
             figsize=figsize,
             n_cols=n_cols,
+            **kwargs,
         )
 
     def fplot_treemap(
@@ -1598,7 +1928,7 @@ class DataFrameAccessor:
             sort_by=sort_by,
             max_values=max_values,
             ascending=ascending,
-            fig=fig,
+            fig=fig,  # type: ignore
         )
 
     def fplot_sunburst(
@@ -1608,10 +1938,6 @@ class DataFrameAccessor:
         values: str,
         style: StyleTemplate = TREEMAP_STYLE_TEMPLATE,
         title: Optional[str] = None,
-        sort_by: Optional[str] = None,
-        max_values: int = 100,
-        ascending: bool = False,
-        fig: Optional[go.Figure] = None,
     ) -> go.Figure:
         """Plot a sunburst chart on a new Plotly figure.
 
@@ -1635,6 +1961,7 @@ class DataFrameAccessor:
             Sort order. The default is `False`.
         fig : go.Figure, optional
             Existing Plotly figure to add to. If None, a new figure is created.
+
         Returns
         -------
         go.Figure
@@ -1647,10 +1974,6 @@ class DataFrameAccessor:
             values=values,
             title=title,
             style=style,
-            sort_by=sort_by,
-            ascending=ascending,
-            max_values=max_values,
-            fig=fig,
         )
 
     def fplot_composite_treemap(