pycba.prestress.plot_tendon#

plot_tendon(model, force, profiles, *, units=None, color='tab:red', show=False, figsize=None)[source]#

Draw the tendon and its equivalent loads in three stacked, x-aligned panels.

(a) the beam with its supports (no loads); (b) the specified cable drape - the tendon eccentricity profile, on its own (exaggerated) vertical scale, measured positive below the centroid; and (c) the equivalent (“balanced”) loads the tendon exerts, drawn on the bare beam (no support symbols). Read top to bottom, this shows how the drape becomes the balancing loads.

Parameters:

  • model (pycba.Beam or pycba.BeamAnalysis) – Supplies the geometry.

  • force (Union[float, Sequence[float]]) – As for equivalent_loads().

  • profiles (Sequence[Union[Parabola, CompoundParabola, Harp, DoubleHarp, None]]) – As for equivalent_loads().

  • units (str or pycba.units.UnitSystem, optional) – Display unit system for the load labels and the length axis.

  • color (str) – Colour for the load arrows/labels.

  • show (bool) – Call matplotlib.pyplot.show() before returning.

  • figsize (tuple(float, float), optional) – Figure size in inches. Defaults to 10 wide and ~3 in per subplot row, consistent with the other PyCBA result plots; pass a tuple to override.

Returns:

The figure and its three axes (beam, drape, loads).

Return type:

matplotlib.figure.Figure, tuple(matplotlib.axes.Axes)