suboptimumg.plotting.plotting_constants

Configuration objects for plotting module.

This module provides Plotly-style configuration objects to control various aspects of plots without cluttering function interfaces. All magic numbers are centralized here for easy customization.

pydantic model suboptimumg.plotting.plotting_constants.ColorbarConfig

Bases: BaseModel

Colorbar configuration for 3D plots.

Fields:

• length (float)

• thickness (int)

field thickness: int = 15

field length: float = 0.7

pydantic model suboptimumg.plotting.plotting_constants.FontConfig

Bases: BaseModel

Font configuration for plot elements.

Simplified to three sizes that work across all plot types: - Large: Titles - Medium: Subtitles, axis labels, legend titles - Small: Tick labels, legend items, contour labels

Fields:

• large (int)

• medium (int)

• small (int)

field large: int = 24

field medium: int = 16

field small: int = 12

pydantic model suboptimumg.plotting.plotting_constants.LayoutConfig

Bases: BaseModel

Layout configuration for plot dimensions and spacing.

Unified dimensions that work across all plot types. Users can override when creating custom plots if needed.

Fields:

• grid_height_per_row (int)

• grid_horizontal_spacing (float)

• grid_vertical_spacing (float)

• grid_width_per_col (int)

• height (int)

• margin (Dict[str, int])

• plot_bgcolor (str)

• scene_bgcolor (str)

• title_x (float)

• title_xanchor (str)

• title_yanchor (str)

• width (int)

field width: int = 1000

field height: int = 700

field grid_width_per_col: int = 400

field grid_height_per_row: int = 350

field grid_horizontal_spacing: float = 0.08

field grid_vertical_spacing: float = 0.12

field margin: Dict[str, int] [Optional]

field plot_bgcolor: str = 'white'

field scene_bgcolor: str = 'rgba(240, 240, 240, 0.8)'

field title_x: float = 0.5

field title_xanchor: str = 'center'

field title_yanchor: str = 'top'

pydantic model suboptimumg.plotting.plotting_constants.ReferenceLineConfig

Bases: BaseModel

Configuration for reference lines (h_line, v_line).

This class combines the line value, label, and styling into a single object. Pass instances of this class to plotting functions instead of separate parameters.

Fields:

• color (str)

• dash (str)

• label (str | None)

• value (float | None)

• width (int)

field value: float | None = None

field label: str | None = None

field width: int = 4

field dash: str = 'dash'

field color: str = 'red'

pydantic model suboptimumg.plotting.plotting_constants.SceneConfig

Bases: BaseModel

3D scene configuration for surface plots.

Fields:

• aspect_ratio_x (float)

• aspect_ratio_y (float)

• aspect_ratio_z (float)

• camera_distance (float)

• camera_up_x (float)

• camera_up_y (float)

• camera_up_z (float)

• camera_z (float)

• default_view_angle (int)

field aspect_ratio_x: float = 1.0

field aspect_ratio_y: float = 1.0

field aspect_ratio_z: float = 0.8

field camera_distance: float = 2.0

field camera_z: float = 0.8

field default_view_angle: int = -60

field camera_up_x: float = 0

field camera_up_y: float = 0

field camera_up_z: float = 1

pydantic model suboptimumg.plotting.plotting_constants.SmoothingConfig

Bases: BaseModel

Smoothing and interpolation configuration.

Fields:

• interp_factor (int)

• interp_method (str)

• smoothing_sigma (float)

field interp_factor: int = 5

field smoothing_sigma: float = 0

field interp_method: str = 'linear'