pystra.ddo.RiskResult#

class RiskResult(annual_failure_rate, expected_fatalities=0.0, expected_economic_loss=0.0, scenarios=None, metadata=None)[source]#

Bases: object

Expected annual risk quantities for a component or scenario model.

Parameters:

  • annual_failure_rate (float) – Annual probability or rate of the represented failure event. For scenario studies this may be the sum of joint failure-state rates.

  • expected_fatalities (float) – Expected fatalities per year.

  • expected_economic_loss (float) – Expected economic loss per year, excluding SWTP life-safety valuation.

  • scenarios (Optional[DataFrame]) – Scenario table used to derive the expected values. This is useful for joint failure states and nonlinear consequence models.

  • metadata (Optional[Mapping[str, Any]]) – User-supplied context such as model name, design point, or units.

Methods

from_scenarios

Aggregate a scenario table into annual risk quantities.

getBeta

Return beta for reliability-result compatibility.

getFailure

Return annual_failure_rate for reliability-result compatibility.

life_safety_cost

Return SWTP-valued expected annual life-safety cost.

to_dict

Return scalar risk quantities as a dictionary.

total_risk_cost

Return expected annual economic plus optional life-safety risk cost.
classmethod from_scenarios(scenarios, weight_col='probability', fatalities_col='fatalities', economic_loss_col='economic_loss', failure_col=None, metadata=None)[source]#

Aggregate a scenario table into annual risk quantities.

The scenario weights may be annual probabilities or annual rates. No independence assumptions are made, so rows may represent joint failure states produced by an upstream reliability model. If failure_col is omitted, every row is treated as a failure/loss scenario for the purpose of annual_failure_rate.

Return type:

RiskResult

property beta: float | None#

Return the generalized reliability index when rate is probability-like.

getFailure()[source]#

Return annual_failure_rate for reliability-result compatibility.

Return type:

float

getBeta()[source]#

Return beta for reliability-result compatibility.

Return type:

Optional[float]

life_safety_cost(swtp)[source]#

Return SWTP-valued expected annual life-safety cost.

Return type:

float

total_risk_cost(swtp=None, include_life_safety=True)[source]#

Return expected annual economic plus optional life-safety risk cost.

Return type:

float

to_dict()[source]#

Return scalar risk quantities as a dictionary.

Return type:

dict