sgio.plot_sg_3d_beam_plotly#

sgio.plot_sg_3d_beam_plotly(csv_file: str | Path, section_dir: str | Path, input_format: str = 'vabs', model_type: str = 'BM2', file_extension: str | None = None, output_extension: str = '.K', location_column: str = 'location', section_column: str = 'cs', axis: int = 0, mesh_color: str = 'rgba(30,30,30,0.9)', mesh_width: float = 1.5, mesh_style: str = 'regions', show_principal_axes: bool = True, pba_scale: float = 0.6, connect_centers: bool = True, show_origin_axis: bool = True, aspect_mode: str = 'cube', projection: str = 'orthographic', show_projection_buttons: bool = True, output_html: str | Path | None = None, title: str = '', **read_kwargs)#

Plot multiple beam cross-sections in 3D using plotly (HTML output).

Functionally equivalent to plot_sg_3d_beam() but renders with plotly so the interactive 3D view runs smoothly in a browser even for meshes with thousands of edges.

Parameters:

  • csv_file (str or Path) – Layout CSV file.

  • section_dir (str or Path) – Directory containing section input files.

  • input_format – See plot_sg_3d_beam().

  • model_type – See plot_sg_3d_beam().

  • file_extension – See plot_sg_3d_beam().

  • output_extension – See plot_sg_3d_beam().

  • location_column – See plot_sg_3d_beam().

  • section_column – See plot_sg_3d_beam().

  • axis – See plot_sg_3d_beam().

  • show_principal_axes – See plot_sg_3d_beam().

  • pba_scale – See plot_sg_3d_beam().

  • connect_centers – See plot_sg_3d_beam().

  • show_origin_axis – See plot_sg_3d_beam().

  • mesh_color (str, optional) – Color string for mesh wireframe lines (plotly notation).

  • mesh_width (float, optional) – Mesh line width in pixels.

  • projection ({'orthographic', 'perspective'}, optional) – Initial 3D camera projection type. Default 'orthographic'.

  • show_projection_buttons (bool, optional) – Whether to add HTML buttons for switching between orthographic and perspective projection. Default True.

  • output_html (str or Path, optional) – If given, the figure is written to this HTML file.

  • title (str, optional) – Optional figure title.

  • **read_kwargs – Forwarded to sgio.read().

Returns:

The constructed plotly figure.

Return type:

plotly.graph_objects.Figure