pycba.pattern.LoadPattern#

class LoadPattern(ba)[source]#

Bases: object

Automatically patterns dead and live loads to achieve critical load effects.

Initialize the LoadPattern class with the beam.

Parameters:: ba (BeamAnalysis) – A pycba.analysis.BeamAnalysis object. The default is None.
Return type:: None.

Methods

`analyze`	Conduct the load patterning analysis.
`set_dead_loads`	Set the nominal dead loads acting on the beam, and the maximum and minimum load factor.
`set_live_loads`	Set the nominal live loads acting on the beam, and the maximum and minimum load factor.
`to_LM`	Generate the factored load matrices used by `analyze()`.
`to_load_cases`	Generate the factored load arrangements used by `analyze()`.

set_dead_loads(LM, gamma_max, gamma_min)[source]#

Set the nominal dead loads acting on the beam, and the maximum and minimum load factor.

Parameters:

LM (Union[List[List[Union[int, float]]], LoadCase]) – The load matrix, or a LoadCase whose loads provide the matrix, for this load case.
gamma_max (float) – The maximum load factor.
gamma_min (float) – The minimum load factor.

Return type:

None.

set_live_loads(LM, gamma_max, gamma_min)[source]#

Set the nominal live loads acting on the beam, and the maximum and minimum load factor.

Parameters:

LM (Union[List[List[Union[int, float]]], LoadCase]) – The load matrix, or a LoadCase whose loads provide the matrix, for this load case.
gamma_max (float) – The maximum load factor.
gamma_min (float) – The minimum load factor.

Return type:

None.

analyze(npts=None)[source]#

Conduct the load patterning analysis.

Parameters:: npts (Optional[int]) – The number of evaluation points along a member for load effects.
Returns:: Envelopes – The load effect envelopes from the patterning.
Return type:: Envelopes

to_load_cases()[source]#

Generate the factored load arrangements used by analyze().

Returns:: A collection containing one generated factored load case for each design load pattern.
Return type:: LoadCases

to_LM()[source]#

Generate the factored load matrices used by analyze().

This is a debugging convenience for users who want to inspect the actual PyCBA load matrix for each generated load pattern without working through the intermediate LoadCases object.

Returns:: Mapping from generated load-pattern name to its factored load matrix. The dictionary preserves the analysis order.
Return type:: dict[str, List[List[Union[int, float]]]]