drippy.multifactor

Plotting functions for multi-factor/DOE models.

Functions

_get_figure_and_multi_axes(...)

doe_scatter_plot(→ tuple[matplotlib.figure.Figure, ...)

Creates scatter plots of y vs each factor.

doe_mean_plot(→ tuple[matplotlib.figure.Figure, ...)

Creates mean plots of y grouped by each factor's levels.

doe_sd_plot(→ tuple[matplotlib.figure.Figure, ...)

Creates standard deviation plots of y by each factor's levels.

contour_plot(→ tuple[matplotlib.figure.Figure, ...)

Creates a contour plot of y over the 2D factor space.

Module Contents

drippy.multifactor._get_figure_and_multi_axes(fig: matplotlib.figure.Figure | None, axes: numpy.ndarray | None, n: int) → tuple[matplotlib.figure.Figure, numpy.ndarray][source]
drippy.multifactor.doe_scatter_plot(data: drippy.data.EDAData, fig: matplotlib.figure.Figure | None = None, axes: numpy.ndarray | None = None) → tuple[matplotlib.figure.Figure, numpy.ndarray][source]

Creates scatter plots of y vs each factor.

One subplot per factor in data.factors.

Parameters:

  • data – EDAData container. Requires factors.

  • fig – Matplotlib figure. If None, creates new figure.

  • axes – 1-D array of Axes, one per factor. If None, creates new axes.

Returns:

(fig, axes) where axes is a 1-D array of Axes.

drippy.multifactor.doe_mean_plot(data: drippy.data.EDAData, fig: matplotlib.figure.Figure | None = None, axes: numpy.ndarray | None = None) → tuple[matplotlib.figure.Figure, numpy.ndarray][source]

Creates mean plots of y grouped by each factor’s levels.

Shows group means connected by a line and a horizontal grand-mean reference line for each factor.

Parameters:

  • data – EDAData container. Requires factors.

  • fig – Matplotlib figure. If None, creates new figure.

  • axes – 1-D array of Axes, one per factor. If None, creates new axes.

Returns:

(fig, axes) where axes is a 1-D array of Axes.

drippy.multifactor.doe_sd_plot(data: drippy.data.EDAData, fig: matplotlib.figure.Figure | None = None, axes: numpy.ndarray | None = None) → tuple[matplotlib.figure.Figure, numpy.ndarray][source]

Creates standard deviation plots of y by each factor’s levels.

Shows group standard deviations connected by a line and a horizontal overall-SD reference line for each factor.

Parameters:

  • data – EDAData container. Requires factors.

  • fig – Matplotlib figure. If None, creates new figure.

  • axes – 1-D array of Axes, one per factor. If None, creates new axes.

Returns:

(fig, axes) where axes is a 1-D array of Axes.

drippy.multifactor.contour_plot(data: drippy.data.EDAData, fig: matplotlib.figure.Figure | None = None, ax: matplotlib.axes.Axes | None = None, doe: bool = False) → tuple[matplotlib.figure.Figure, matplotlib.axes.Axes][source]

Creates a contour plot of y over the 2D factor space.

Uses tricontourf for robustness with irregular/DOE grids.

Parameters:

  • data – EDAData container. Requires exactly 2 factors.

  • fig – Matplotlib figure. If None, creates new figure.

  • ax – Matplotlib axes. If None, creates new axes.

  • doe – If True, overlays design point markers.

Returns:

The figure and axes containing the plot.