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

MatplotLibAPI/Pie.py

@@ -1,70 +0,0 @@
-"""Pie and donut chart helpers."""
-
-from typing import Any, Dict, Optional, Tuple
-
-import matplotlib.pyplot as plt
-import pandas as pd
-import seaborn as sns
-from matplotlib.axes import Axes
-from matplotlib.figure import Figure
-
-from .StyleTemplate import PIE_STYLE_TEMPLATE, StyleTemplate, validate_dataframe
-from ._visualization_utils import _get_axis, _wrap_aplot
-
-
-def aplot_pie_donut(
-    pd_df: pd.DataFrame,
-    category: str,
-    value: str,
-    donut: bool = False,
-    title: Optional[str] = None,
-    style: StyleTemplate = PIE_STYLE_TEMPLATE,
-    ax: Optional[Axes] = None,
-    **kwargs: Any,
-) -> Axes:
-    """Plot pie or donut charts for categorical share visualization."""
-    validate_dataframe(pd_df, cols=[category, value])
-    plot_ax = _get_axis(ax)
-    labels = pd_df[category].astype(str).tolist()
-    sizes = pd_df[value]
-
-    wedgeprops: Optional[Dict[str, Any]] = None
-    if donut:
-        wedgeprops = {"width": 0.3}
-    wedges, *_ = plot_ax.pie(
-        sizes,
-        labels=labels,
-        autopct="%1.1f%%",
-        colors=sns.color_palette(style.palette),
-        wedgeprops=wedgeprops,
-    )
-    plot_ax.axis("equal")
-    if title:
-        plot_ax.set_title(title)
-    return plot_ax
-
-
-def fplot_pie_donut(
-    pd_df: pd.DataFrame,
-    category: str,
-    value: str,
-    donut: bool = False,
-    title: Optional[str] = None,
-    style: StyleTemplate = PIE_STYLE_TEMPLATE,
-    figsize: Tuple[float, float] = (8, 8),
-    save_path: Optional[str] = None,
-    savefig_kwargs: Optional[Dict[str, Any]] = None,
-) -> Figure:
-    """Plot pie or donut charts on a new figure."""
-    return _wrap_aplot(
-        aplot_pie_donut,
-        pd_df=pd_df,
-        figsize=figsize,
-        category=category,
-        value=value,
-        donut=donut,
-        title=title,
-        style=style,
-        save_path=save_path,
-        savefig_kwargs=savefig_kwargs,
-    )

MatplotLibAPI/Pivot.py

@@ -1,134 +0,0 @@
-"""Pivot chart helpers for bar and line plots."""
-
-from typing import Optional, cast
-
-import matplotlib.pyplot as plt
-import pandas as pd
-from matplotlib.axes import Axes
-
-from .StyleTemplate import (
-    PIVOTBARS_STYLE_TEMPLATE,
-    PIVOTLINES_STYLE_TEMPLATE,
-    StyleTemplate,
-    format_func,
-    string_formatter,
-    validate_dataframe,
-)
-
-
-def _pivot_and_sort_data(
-    data: pd.DataFrame,
-    index: str,
-    columns: str,
-    values: str,
-    aggfunc: str = "sum",
-    sort_by: Optional[str] = None,
-    ascending: bool = False,
-) -> pd.DataFrame:
-    """Pivot and sort a DataFrame.
-
-    Parameters
-    ----------
-    data : pd.DataFrame
-        The input DataFrame.
-    index : str
-        The column to use as the pivot table index.
-    columns : str
-        The column to use for pivot table columns.
-    values : str
-        The column to aggregate.
-    aggfunc : str, optional
-        The aggregation function, by default "sum".
-    sort_by : str, optional
-        The column to sort by.
-    ascending : bool, optional
-        The sort order, by default `False`.
-
-    Returns
-    -------
-    pd.DataFrame
-        A pivoted and sorted DataFrame.
-    """
-    pivot_df = pd.pivot_table(
-        data, values=values, index=[index], columns=[columns], aggfunc=aggfunc
-    )
-    if sort_by:
-        pivot_df = pivot_df.sort_values(by=sort_by, ascending=ascending)
-    return pivot_df.reset_index()
-
-
-def plot_pivoted_bars(
-    data: pd.DataFrame,
-    label: str,
-    x: str,
-    y: str,
-    agg: str = "sum",
-    style: StyleTemplate = PIVOTBARS_STYLE_TEMPLATE,
-    title: Optional[str] = None,
-    sort_by: Optional[str] = None,
-    ascending: bool = False,
-    ax: Optional[Axes] = None,
-    stacked: bool = False,
-) -> Axes:
-    """Plot a bar chart from a pivot table.
-
-    Parameters
-    ----------
-    data : pd.DataFrame
-        The DataFrame containing the data to plot.
-    label : str
-        The column to pivot into series.
-    x : str
-        The column for the x-axis.
-    y : str
-        The column for the y-values.
-    agg : str, optional
-        The aggregation function for the pivot. The default is "sum".
-    style : StyleTemplate, optional
-        The style configuration. The default is `PIVOTBARS_STYLE_TEMPLATE`.
-    title : str, optional
-        The plot title.
-    sort_by : str, optional
-        The column to sort by.
-    ascending : bool, optional
-        The sort order. The default is `False`.
-    ax : Axes, optional
-        The axes to draw on.
-    stacked : bool, optional
-        Whether to stack the bars. The default is `False`.
-
-    Returns
-    -------
-    Axes
-        The matplotlib axes with the bar chart.
-    """
-    validate_dataframe(data, cols=[label, x, y], sort_by=sort_by)
-
-    pivot_df = _pivot_and_sort_data(
-        data,
-        index=x,
-        columns=label,
-        values=y,
-        aggfunc=agg,
-        sort_by=sort_by,
-        ascending=ascending,
-    )
-
-    if ax is None:
-        ax = cast(Axes, plt.gca())
-
-    pivot_df.plot(kind="bar", x=x, stacked=stacked, ax=ax, alpha=0.7)
-
-    ax.set_ylabel(string_formatter(y))
-    ax.set_xlabel(string_formatter(x))
-    if title:
-        ax.set_title(title)
-
-    ax.legend(
-        fontsize=style.font_size - 2,
-        title_fontsize=style.font_size + 2,
-        labelcolor="linecolor",
-        facecolor=style.background_color,
-    )
-    ax.tick_params(axis="x", rotation=90)
-    return ax

MatplotLibAPI/Sankey.py

@@ -1,46 +0,0 @@
-"""Sankey plotting helpers."""
-
-from typing import Any, Dict, List, Optional
-
-import pandas as pd
-import plotly.graph_objects as go
-
-from .StyleTemplate import SANKEY_STYLE_TEMPLATE, StyleTemplate, validate_dataframe
-
-
-def fplot_sankey(
-    pd_df: pd.DataFrame,
-    source: str,
-    target: str,
-    value: str,
-    title: Optional[str] = None,
-    style: StyleTemplate = SANKEY_STYLE_TEMPLATE,
-    save_path: Optional[str] = None,
-    savefig_kwargs: Optional[Dict[str, Any]] = None,
-) -> go.Figure:
-    """Plot a Sankey diagram showing flows between categories."""
-    validate_dataframe(pd_df, cols=[source, target, value])
-
-    labels: List[str] = list(pd.unique(pd.concat([pd_df[source], pd_df[target]])))
-    label_to_index: Dict[str, int] = {name: idx for idx, name in enumerate(labels)}
-
-    sankey = go.Sankey(
-        node=dict(label=labels, pad=15, thickness=20, color=style.font_color),
-        link=dict(
-            source=[label_to_index[val] for val in pd_df[source]],
-            target=[label_to_index[val] for val in pd_df[target]],
-            value=pd_df[value],
-        ),
-    )
-
-    fig = go.Figure(sankey)
-    if title:
-        fig.update_layout(
-            title_text=title, font=dict(color=style.font_color, size=style.font_size)
-        )
-    if save_path:
-        if save_path.lower().endswith((".html", ".htm")):
-            fig.write_html(save_path, **(savefig_kwargs or {}))
-        else:
-            fig.write_image(save_path, **(savefig_kwargs or {}))
-    return fig

MatplotLibAPI/Sunburst.py

@@ -1,89 +0,0 @@
-"""Sunburst chart plotting utilities."""
-
-from typing import Any, Dict, Optional
-
-import pandas as pd
-import plotly.graph_objects as go
-
-from .StyleTemplate import (
-    TREEMAP_STYLE_TEMPLATE,
-    StyleTemplate,
-    validate_dataframe,
-)
-
-
-def fplot_sunburst(
-    pd_df: pd.DataFrame,
-    labels: str,
-    parents: str,
-    values: str,
-    style: StyleTemplate = TREEMAP_STYLE_TEMPLATE,
-    title: Optional[str] = None,
-    sort_by: Optional[str] = None,
-    ascending: bool = False,
-    max_values: int = 100,
-    fig: Optional[go.Figure] = None,
-    save_path: Optional[str] = None,
-    savefig_kwargs: Optional[Dict[str, Any]] = None,
-) -> go.Figure:
-    """Return a figure containing the sunburst plot.
-
-    Parameters
-    ----------
-    pd_df : pd.DataFrame
-        DataFrame containing the data to plot.
-    labels : str
-        Column representing the labels of the sectors.
-    parents : str
-        Column representing the parent of each sector.
-    values : str
-        Column containing values for each sunburst sector.
-    style : StyleTemplate, optional
-        Style configuration. The default is `TREEMAP_STYLE_TEMPLATE`.
-    title : str, optional
-        Plot title.
-    sort_by : str, optional
-        Column used to sort data.
-    ascending : bool, optional
-        Sort order for the data. The default is `False`.
-    max_values : int, optional
-        Maximum number of rows to plot. The default is 100.
-    fig : go.Figure, optional
-        Existing figure to add the sunburst chart to.
-
-    Returns
-    -------
-    go.Figure
-        Figure containing the sunburst plot.
-    """
-    cols = [labels, parents, values]
-    validate_dataframe(pd_df, cols=cols, sort_by=sort_by)
-    if not sort_by:
-        sort_by = values
-    df = pd_df.sort_values(by=sort_by, ascending=ascending)[cols].head(max_values)
-
-    trace = go.Sunburst(
-        labels=df[labels],
-        parents=df[parents],
-        values=df[values],
-        textinfo="label+percent entry",
-    )
-
-    if not fig:
-        fig = go.Figure(trace)
-    else:
-        fig.add_trace(trace)
-
-    fig.update_layout(
-        title=title,
-        plot_bgcolor=style.background_color,
-        paper_bgcolor=style.background_color,
-        font=dict(family=style.font_name, size=style.font_size, color=style.font_color),
-        showlegend=style.legend if style else True,
-    )
-    if save_path:
-        if save_path.lower().endswith((".html", ".htm")):
-            fig.write_html(save_path, **(savefig_kwargs or {}))
-        else:
-            fig.write_image(save_path, **(savefig_kwargs or {}))
-    return fig

MatplotLibAPI/Waffle.py

@@ -1,86 +0,0 @@
-"""Waffle chart helpers."""
-
-from typing import Any, Dict, Optional, Tuple
-
-import pandas as pd
-import seaborn as sns
-from matplotlib.axes import Axes
-from matplotlib.figure import Figure
-from matplotlib.patches import Rectangle
-import matplotlib.pyplot as plt
-
-from .StyleTemplate import PIE_STYLE_TEMPLATE, StyleTemplate, validate_dataframe
-from ._visualization_utils import _get_axis, _wrap_aplot
-
-
-def aplot_waffle(
-    pd_df: pd.DataFrame,
-    category: str,
-    value: str,
-    rows: int = 10,
-    title: Optional[str] = None,
-    style: StyleTemplate = PIE_STYLE_TEMPLATE,
-    ax: Optional[Axes] = None,
-    **kwargs: Any,
-) -> Axes:
-    """Plot a simple waffle chart as a grid of proportional squares."""
-    validate_dataframe(pd_df, cols=[category, value])
-    plot_ax = _get_axis(ax)
-    total = float(pd_df[value].sum())
-    squares = rows * rows
-    colors = sns.color_palette(style.palette, n_colors=len(pd_df))
-    plot_ax.set_aspect("equal")
-
-    start = 0
-    for idx, (label, val) in enumerate(zip(pd_df[category], pd_df[value])):
-        count = int(round((val / total) * squares))
-        for square in range(start, min(start + count, squares)):
-            row = square // rows
-            col = square % rows
-            plot_ax.add_patch(
-                Rectangle(
-                    (col, rows - row),
-                    1,
-                    1,
-                    facecolor=colors[idx],
-                    edgecolor=style.background_color,
-                )
-            )
-        start += count
-
-    plot_ax.set_xlim(0, rows)
-    plot_ax.set_ylim(0, rows + 1)
-    plot_ax.axis("off")
-    if title:
-        plot_ax.set_title(title)
-    legend_handles = [Rectangle((0, 0), 1, 1, color=color) for color in colors]
-    plot_ax.legend(
-        legend_handles, pd_df[category], loc="upper center", ncol=3, frameon=False
-    )
-    return plot_ax
-
-
-def fplot_waffle(
-    pd_df: pd.DataFrame,
-    category: str,
-    value: str,
-    rows: int = 10,
-    title: Optional[str] = None,
-    style: StyleTemplate = PIE_STYLE_TEMPLATE,
-    figsize: Tuple[float, float] = (8, 8),
-    save_path: Optional[str] = None,
-    savefig_kwargs: Optional[Dict[str, Any]] = None,
-) -> Figure:
-    """Plot waffle charts on a new figure."""
-    return _wrap_aplot(
-        aplot_waffle,
-        pd_df=pd_df,
-        figsize=figsize,
-        category=category,
-        value=value,
-        rows=rows,
-        title=title,
-        style=style,
-        save_path=save_path,
-        savefig_kwargs=savefig_kwargs,
-    )

MatplotLibAPI/_typing.py

@@ -1,17 +0,0 @@
-"""Internal type aliases used across MatplotLibAPI."""
-
-from typing import Any, Callable, Literal, Union
-
-from typing_extensions import TypeAlias
-
-import numpy.typing as npt
-
-
-# ``DataFrame.corr`` supports the three built-in correlation methods or a callable
-# that operates on two array-like inputs and returns a float. Using a local alias
-# avoids depending on the private ``pandas._typing`` module, which is not
-# considered stable across releases.
-CorrelationMethod: TypeAlias = Union[
-    Literal["pearson", "kendall", "spearman"],
-    Callable[[npt.NDArray[Any], npt.NDArray[Any]], float],
-]

matplotlibapi-3.3.0.dist-info/RECORD

@@ -1,26 +0,0 @@
-MatplotLibAPI/Area.py,sha256=Y-tk6Di3Foj3yOGVbbOwDnPtL9rDh-VV2XTeaZcybgk,2095
-MatplotLibAPI/Bar.py,sha256=Y8mP_UWyU2h5T38L7j-Vnt0t9WSeCbV6Gw_-_48x3Bw,2243
-MatplotLibAPI/BoxViolin.py,sha256=8nnXGyDwrjiNJOiJHEYEcJMqD6JIF5JT8aZ0y4AXgLY,2008
-MatplotLibAPI/Bubble.py,sha256=KvneYBrrGiGKuRyLjNDcOK-hUl_KwMaJKP_XO6Hx1jo,12844
-MatplotLibAPI/Composite.py,sha256=nsg1eAVf-6uzd4QrNNwp2sLCtCzeQ0d-DHHsEFeF6eY,10304
-MatplotLibAPI/Heatmap.py,sha256=SRT8pCKtEaJ1PivxxzCuXp-OBu4ljno2PGB_XXvFxzY,3369
-MatplotLibAPI/Histogram.py,sha256=znkQAVOa2-DMIKopCl_3-8JpDtymfGm4Bi4IyNXSVqs,1869
-MatplotLibAPI/Network.py,sha256=4ZyQlmy2v-AXWFJ2casfdQLwpL8JUcN7j2ZOOtUsTM0,62298
-MatplotLibAPI/Pie.py,sha256=p0JuSP8h3TflEuvmGpPqNHO7hbAnse8hmMWBiZtzfsE,1882
-MatplotLibAPI/Pivot.py,sha256=6qH8e6U1TzUQcAIBmA_KMuHER2Uxp0-GFtwy9eJuS9A,3403
-MatplotLibAPI/Sankey.py,sha256=SpijCISghlsLqPuaWvnBP6vB-CV9k7FUGUi5LC6bKVc,1501
-MatplotLibAPI/StyleTemplate.py,sha256=gO-Wj3akH3pc_Z1Dh2NPYKIZjmavhSHv53r_8dmsIgM,8356
-MatplotLibAPI/Sunburst.py,sha256=kqjEruXDDeuJpUKqbMw_VdT7fY0O4qzUNsIuwaTamdc,2584
-MatplotLibAPI/Table.py,sha256=CA4K772ByaSBc9toDXUojUJL2AzD-mEtTF7KPlFsp74,6559
-MatplotLibAPI/Timeserie.py,sha256=TGtshXXEwYEomxRCSb1MGzTTcgqk-M_GbQImVVP6RvE,10204
-MatplotLibAPI/Treemap.py,sha256=VBBk6MpNXoQtnxFzR1YPhIx6Lz9b7yJNHBMbQDhvefM,4848
-MatplotLibAPI/Waffle.py,sha256=uplRhUBDWUhSwPnI_GzU1O2D_RQXW_0OJ51m01PFKLg,2517
-MatplotLibAPI/Wordcloud.py,sha256=AMzMdvGyWVaYTettvurJNxJxQvrUDe9Tj4X8LOpZVOk,12314
-MatplotLibAPI/__init__.py,sha256=PC1LkW3tbXluk5f_Zv2MqO1xppvdIl9AQEo9k7P5b4o,2365
-MatplotLibAPI/_typing.py,sha256=Or3IPNceWKdyEk3CGXJb09FZR_fvT732oF0iWrx1ex8,598
-MatplotLibAPI/_visualization_utils.py,sha256=qIv7c0Mi3qK-saGxmKngw23uWxKFSAYjiH3uYTSr5Po,2215
-MatplotLibAPI/accessor.py,sha256=rOvpQVg_3uds8f4EoiCfkBOzYPLuPwCC2jtCmFpwwNA,62042
-matplotlibapi-3.3.0.dist-info/METADATA,sha256=SZtMcfCN_V1nzgSIwRsB8Thdojj0E8ePm_3rVNuOfRs,5887
-matplotlibapi-3.3.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-matplotlibapi-3.3.0.dist-info/licenses/LICENSE,sha256=hMErKLb6YZR3lRR5zr-vxeFkvY69QAaafgSpZ5-P1dQ,1067
-matplotlibapi-3.3.0.dist-info/RECORD,,