section_force_diagram_3d

opsvis.section_force_diagram_3d(sf_type, sfac=1.0, nep=17, fmt_secforce1={'color': 'blue', 'dash_capstyle': 'butt', 'dash_joinstyle': 'round', 'linestyle': 'solid', 'linewidth': 2.0, 'marker': '', 'markersize': 1, 'solid_capstyle': 'round', 'solid_joinstyle': 'round'}, fmt_secforce2={'color': 'blue', 'dash_capstyle': 'butt', 'dash_joinstyle': 'round', 'linestyle': 'solid', 'linewidth': 1.0, 'marker': '', 'markersize': 1, 'solid_capstyle': 'round', 'solid_joinstyle': 'round'}, ref_vert_lines=True, end_max_values=True, dir_plt=0, node_supports=True, ax=False, alt_model_plot=1)[source]

Display section forces diagram of a 3d beam column model.

This function plots section forces diagrams for 3d beam column elements with or without element loads. For now only ‘-beamUniform’ constant transverse or axial element loads are supported.

Parameters:

  • sf_type (str) – type of section force: ‘N’ - normal force, ‘Vy’ or ‘Vz’ - shear force, ‘My’ or ‘Mz’ - bending moments, ‘T’ - torsional moment.

  • sfac (float) – scale factor by wich the values of section forces are multiplied.

  • nep (int) – number of evaluation points including both end nodes (default: 17)

  • fmt_secforce1 (dict) – line format dictionary for section force distribution curve.

  • fmt_secforce2 (dict) – line format dictionary for auxiliary reference lines.

  • end_max_values (bool) – True means show the values at element ends and extreme (max, min) value between the ends.

  • {0 (dir_plt) – direction in which to plot the load effects: 0 (default) - as defined in the code for each load effect type 1 - in the y-axis (default for N, Vy, T, Mz) 2 - in the z-axis (default for Vz, My)

  • 1 – direction in which to plot the load effects: 0 (default) - as defined in the code for each load effect type 1 - in the y-axis (default for N, Vy, T, Mz) 2 - in the z-axis (default for Vz, My)

  • 2} – direction in which to plot the load effects: 0 (default) - as defined in the code for each load effect type 1 - in the y-axis (default for N, Vy, T, Mz) 2 - in the z-axis (default for Vz, My)

  • ax – Optional axis to plot to.

  • alt_model_plot (int) – 1 - for using the plot_model command, 2 - for using simplified model plotting. Other integer - for no model plotting. In this case the model can be plotted outside this command using the axes (ax) object. Default is 1.

Returns:

the minimum overall value of the section force.

maxVal (float): the maximum overall value of the section force.

ax: the axes object.

Return type:

minVal (float)

Usage:

See example: demo_cantilever_3el_3d.py

Todo:

Add support for other element loads available in OpenSees: partial (trapezoidal) uniform element load, and ‘beamPoint’ element load.

See example Statics of a 3d 3-element cantilever beam