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