pycba.results.Envelopes#

class Envelopes(vResults)[source]#

Bases: object

Envelopes load effects from a vector of BeamResults.

x#

Coordinates along the beam.

Type:: np.ndarray

Vmax, Vmin

Maximum and minimum shear force envelopes.

Type:: np.ndarray

Mmax, Mmin

Maximum and minimum bending moment envelopes.

Type:: np.ndarray

Vco_Mmax#

Shear coincident with the moment maximum at each point.

Type:: np.ndarray

Vco_Mmin#

Shear coincident with the moment minimum at each point.

Type:: np.ndarray

Mco_Vmax#

Moment coincident with the shear maximum at each point.

Type:: np.ndarray

Mco_Vmin#

Moment coincident with the shear minimum at each point.

Type:: np.ndarray

Rmax, Rmin

Reaction history matrices (nsup x nres).

Type:: np.ndarray

Rmaxval, Rminval

Maximum and minimum reaction per support.

Type:: np.ndarray

Constructs the envelope of each load effect given a vector of results for the beam. Also tracks coincident (co-existing) load effects: the value of the other effect (V or M) at the analysis that caused each envelope extreme.

Parameters:: vResults (List[MemberResults]) – The vector of results from each analysis that are to be enveloped.
Return type:: None.

Methods

`augment`	Augments this set of envelopes with another compatible set, making this the envelopes of the two sets of envelopes.
`plot`	Plots the envelopes of bending and shear.
`sum`	Adds another compatible set of envelopes to this one element-wise.
`zero_like`	Returns a zeroed zet of envelopes like the reference `pycba.results.Envelopes`.

classmethod zero_like(env)[source]#

Returns a zeroed zet of envelopes like the reference pycba.results.Envelopes. This is necessary since a pycba.results.Envelopes object stores information about the beam from which it came. This facilitates the creation of an envelope of envelopes.

Parameters:: env (Envelopes) – A pycba.results.Envelopes to be used as the basis for a zeroed pycba.results.Envelopes object.
Returns:: A pycba.results.Envelopes object of zero-valued envelopes.
Return type:: Envelopes

augment(env)[source]#

Augments this set of envelopes with another compatible set, making this the envelopes of the two sets of envelopes. Coincident values are updated to match whichever envelope governs at each point.

All envelopes must be from the same pycba.bridge.BridgeAnalysis object.

If the envelopes have a different number of analyses (due to differing vehicle lengths, for example), then only the reaction extreme are retained, and not the entire reaction history.

Parameters:: env (Envelopes) – A compatible pycba.results.Envelopes object.
Raises:: ValueError – All envelopes must be for the same bridge.
Return type:: None.

sum(env)[source]#

Adds another compatible set of envelopes to this one element-wise. This is useful for superimposing load effects from different sources, e.g. a patterned UDL envelope with a moving vehicle envelope.

All envelopes must be for the same beam geometry.

If the envelopes have a different number of analyses (due to differing vehicle lengths, for example), then only the reaction extremes are retained, and not the entire reaction history.

Parameters:: env (Envelopes) – A compatible pycba.results.Envelopes object.
Raises:: ValueError – All envelopes must be for the same beam geometry.
Return type:: None.

plot(each=False, **kwargs)[source]#

Plots the envelopes of bending and shear.

Parameters:

each (Boolean) – Wether or not to show each BMD and SFD in the enveloping. The default is False
**kwargs (Dict) – Matplotlib keyword arguments for plotting.

Return type:

None.