pystra.ddo

Design decision optimization and societal risk acceptance.

The objects in this module sit above the reliability methods. They do not change how FORM, SORM, or simulation analyses are run; instead DDO evaluates an objective subject to a selected acceptability criterion. The initial implementation provides the LQI criterion for minimum acceptable life-safety levels using the life quality index (LQI) and societal willingness-to-pay (SWTP) values.

Functions

annualized_safety_cost	Return the annualized safety cost used by the JCSS LQI example.
finite_difference_derivative	Return a central finite-difference derivative for a scalar design.
get_swtp	Return the SWTP value per statistical life for a country code.
get_swtp_index_record	Return the SWTP index record for a country code.
get_swtp_record	Return a country-level SWTP record.
index_swtp_record	Return a Rackwitz SWTP record indexed to a newer target year.
jcss_lqi_acceptability	Return the finite-difference JCSS LQI acceptability margin.
jcss_lqi_acceptability_margin	Return the JCSS marginal LQI acceptability margin.
jcss_lqi_is_acceptable	Return True when the JCSS marginal LQI condition is satisfied.
jcss_lqi_risk_cost	Return the JCSS LQI life-safety risk cost.
jcss_lqi_risk_cost_from_result	Return JCSS LQI risk cost from an aggregated risk result.
jcss_systematic_reconstruction_objective	Return the JCSS infinite-horizon reconstruction objective.
lqi_k1	Return the LQI safety cost ratio K1.
lqi_target_reliability	Return an LQI target reliability for a safety cost ratio.
plot_summary	Plot a one-dimensional design decision optimization summary.
present_value_factor	Return the JCSS-style present value factor for a constant annual flow.
swtp_table	Return the built-in country SWTP table as a dataframe.

Classes

CostBenefitModel	Cost-benefit objective for a reliability design study.
DDO	Evaluate a decision context with an objective and acceptability criterion.
DDOCriterion	Base interface for DDO acceptability criteria.
DDOObjective	Base interface for DDO objectives.
DesignStudy	Evaluate reliability results over a one-dimensional design range.
FatalityConsequence	Expected fatalities conditional on structural failure.
LQI	Minimum acceptable life-safety criterion using LQI/SWTP.
LQITarget	Target failure probability and reliability index from an LQI criterion.
RiskResult	Expected annual risk quantities for a component or scenario model.
RiskStudy	Evaluate a risk model over design alternatives.
SWTP	Societal willingness to pay per statistical life.
SWTPIndexRecord	Index data used to update an anchored SWTP value.
SWTPRecord	Country-level societal willingness-to-pay value.
ScenarioRiskModel	Scenario-table risk model for aggregated risk studies.