pystra.loadcomb.LoadCombination#

class LoadCombination(lsf, dict_dist_comb, list_dist_resist, list_dist_other=None, corr=None, list_const=None, opt=None, dict_comb_cases=None)[source]#

Bases: object

Class for running load combination cases.

lsf#

Limit State Function

Type:: function

df_corr#

DataFrame of user defined correlation (if specified).

Type:: DataFrame

distributions_max#

Dictionary of maximum distributions

Type:: dict

distributions_pit#

Dictionary of point-in-time distributions

Type:: dict

distributions_other#

Dictionary of static distributions

Type:: dict

distributions_resistance#

Dictionary of resistance distributions

Type:: dict

dict_dist_comb#

Dictionary of distributions for all load combinations

Type:: dict

label_comb_vrs#

Labels of combination variables

Type:: str

label_comb_cases#

Labels of combination variables

Type:: str

label_resist#

Labels of resistance variables

Type:: str

label_other#

Labels of static variables

Type:: str

label_all#

Labels of all variables including design multiplier

Type:: str

Initialize class instance.

Parameters:

lsf (Function) – Limit State Function.
dict_dist_comb (Dictionary) – Nested dictionary of load effects and their corresponding max and pit distributions.
list_dist_resist (List) – List of resistance distribution.
list_dist_other (List, optional) – List of other remaining random variables.
corr (DataFrame, optional) – User-defined Dataframe containing correlations between random variables. Note: corr.index = corr.columns = [<list-of-rvs>]
list_const (List, optional) – List of LSF constants as Pystra Constants.
opt (Object, optional) – Pystra AnalysisOptions object to specify options for the reliability analysis.
dict_comb_cases (Dictionary, optional) – Dictionary containing the identifiers of load cases as keys and list of identifiers of max load effects as values, i.e. {<load-case-name>:[<max-load-effects>],}. By default, each combination load effect is taken as maximum in a load case.

Return type:

None.

Methods

`eval_lsf_kwargs`	Evaluate the LSF based on the supplied Keyword arguments, setting all others to set_value.
`get_dict_dist_comb`	Get the dictionary of distributions for all load combination cases.
`get_label`	Get Labels corresponding to label_type.
`get_num_comb`	Get the number of load combination cases.
`run_reliability_case`	Create and run reliability analysis using input LSF for a given load case, lcn.

get_label(label_type)[source]#

Get Labels corresponding to label_type.

Parameters:: label_type (String) – Label type. Possible values: “resist”, “other”, “comb_vrs”, “comb_cases”, “const”, and “all”.
Returns:: label – List of labels corresponding to label_type.
Return type:: List

get_num_comb()[source]#

Get the number of load combination cases.

Returns:: Number of load combination cases.
Return type:: Float

get_dict_dist_comb()[source]#

Get the dictionary of distributions for all load combination cases.

Returns:: Dictionary of distributions for all load combination cases.
Return type:: Dictionary

run_reliability_case(lcn=None, **kwargs)[source]#

Create and run reliability analysis using input LSF for a given load case, lcn.

Parameters:

lcn (float, optional) – Load case number. The default is 1.
**kwargs (Keyword arguments) – Specify any distribution overrides for the stochastic model random variables or constants as keyword arguments. Therefore, if kwargs contains any LSF argument, then kwarg specified distribution is used for that argument in the reliability analyses.

Returns:

form – FORM reliability analysis object.

Return type:

Pystra FORM object

eval_lsf_kwargs(set_value=0.0, set_const=None, **kwargs)[source]#

Evaluate the LSF based on the supplied Keyword arguments, setting all others to set_value.

Parameters:

set_value (Float, optional) – Set value of random variable LSF arguments other than those supplied as keyword arguments. The default is 0.0.
set_const (Float, optional) – Set value of constant LSF arguments other than those supplied as keyword arguments. The default is None.
**kwargs (Keyword arguments) – LSF Keyword arguments.

Returns:

gX – Evaluation of the LSF.

Return type:

Float