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

  • model_type

  • file_extension

  • output_extension

:param : :param location_column: :param section_column: :param axis: :param show_principal_axes: :param pba_scale: :param : :param connect_centers: See plot_sg_3d_beam(). :param show_origin_axis: See plot_sg_3d_beam(). :param mesh_color: Color string for mesh wireframe lines (plotly notation). :type mesh_color: str, optional :param mesh_width: Mesh line width in pixels. :type mesh_width: float, optional :param projection: Initial 3D camera projection type. Default 'orthographic'. :type projection: {‘orthographic’, ‘perspective’}, optional :param show_projection_buttons: Whether to add HTML buttons for switching between orthographic and

perspective projection. Default True.

Parameters:

  • 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