suboptimumg.plotting.grid_plot_3d#

class suboptimumg.plotting.grid_plot_3d.PlotType(*values)[source]#

Bases: str, Enum

Plot types for 3D grid plotting.

CONTOUR = 'contour'#
SURFACE = 'surface'#
suboptimumg.plotting.grid_plot_3d.plot_grid_3D(x_list, y_list, z_data_dict, subplot_titles, title, x_label, y_label, z_label_dict, rows, cols, plot_type, theme=None, font_config=FontConfig(large=24, medium=16, small=12), layout_config=LayoutConfig(width=1000, height=700, grid_width_per_col=400, grid_height_per_row=350, grid_horizontal_spacing=0.08, grid_vertical_spacing=0.12, margin={'l': 70, 'r': 50, 't': 90, 'b': 70}, plot_bgcolor='white', scene_bgcolor='rgba(240, 240, 240, 0.8)', title_x=0.5, title_xanchor='center', title_yanchor='top'), colorbar_config=ColorbarConfig(thickness=15, length=0.7), smoothing_config=SmoothingConfig(interp_factor=5, smoothing_sigma=0, interp_method='linear'))[source]#

Generic 3D grid plotting utility for contour or surface plots.

Requires grid-based input data (2D z arrays).

Parameters:

  • x_list (numpy.ndarray) – 1D numpy array of x coordinates defining the grid x-axis

  • y_list (numpy.ndarray) – 1D numpy array of y coordinates defining the grid y-axis

  • z_data_dict (dict[str, np.ndarray]) – Dictionary mapping event keys to z-data 2D arrays. Each z array must have shape (len(x_list), len(y_list))

  • subplot_titles (list[str]) – List of subplot titles in order

  • title (str) – Overall grid title

  • x_label (str) – X-axis label

  • y_label (str) – Y-axis label

  • z_label_dict (dict[str, str]) – Dictionary mapping event keys to z-axis labels

  • rows (int) – Number of rows in the grid

  • cols (int) – Number of columns in the grid

  • plot_type (PlotType) – PlotType enum (CONTOUR or SURFACE)

  • theme (str, optional) – Color theme name

  • font_config (FontConfig, optional) – FontConfig object for font settings

  • layout_config (LayoutConfig, optional) – LayoutConfig object for layout settings

  • colorbar_config (ColorbarConfig, optional) – ColorbarConfig object for colorbar settings

  • smoothing_config (SmoothingConfig, optional) – SmoothingConfig object for smoothing settings

Returns:

Plotly figure object

Return type:

go.Figure