thermal_cable_model.visualization — Plotting Utilities

Plotting utilities for thermal simulation results.

plot_temperature_history(result, cable_indices=None, show_ambient=True, show_current=True, time_unit='hours', figsize=(14, 8))

Plot conductor, insulation, surface, and soil temperatures vs time.

Parameters:

• result (TransientResult)

• cable_indices (list[int], optional) – Which cables to plot. Defaults to all.

• show_ambient (bool) – Overlay the ambient ground temperature.

• show_current (bool) – Add a secondary axis with the load current.

• time_unit ({"seconds", "hours", "days"})

• figsize (tuple)

Return type:

Figure

plot_cross_section(positions_x, depths, outer_radii, temperatures=None, cable_names=None, soil_extent=(-1.0, 1.0, 2.5), figsize=(10, 8))

Plot a 2-D cross-section of the cable arrangement.

Parameters:

• positions_x (list[float]) – Horizontal positions [m].

• depths (list[float]) – Burial depths [m] (positive downward).

• outer_radii (list[float]) – Cable outer radii [m].

• temperatures (list[float], optional) – Conductor temperatures to annotate.

• cable_names (list[str], optional)

• soil_extent ((x_min, x_max, y_max_depth))

• figsize (tuple[float, float])

Return type:

Figure