Class RiskEvent

java.lang.Object

neqsim.process.safety.risk.RiskEvent

public class RiskEvent
extends Object

Represents a risk event for probabilistic safety analysis.

A risk event combines an initiating event with its frequency (events per year) and conditional probability. Events can be linked in event trees to model escalation sequences.

Frequencies are typically sourced from industry databases such as:

• OREDA (Offshore Reliability Data)
• HSE Hydrocarbon Release Database
• CCPS Guidelines
• OGP Risk Assessment Data Directory

Author:

NeqSim team

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	RiskEvent.Builder	Builder class for RiskEvent.
static enum	RiskEvent.ConsequenceCategory	Consequence severity categories per industry standards.

Field Summary

Fields

Modifier and Type	Field	Description
private double	conditionalProbability
private RiskEvent.ConsequenceCategory	consequenceCategory
private final String	description
private double	frequency
private final InitiatingEvent	initiatingEvent
private final String	name
private RiskEvent	parentEvent
private ProcessSafetyScenario	scenario

Constructor Summary

Constructors

Constructor	Description
RiskEvent(String name, String description, InitiatingEvent initiatingEvent)	Creates a new risk event with description.
RiskEvent(String name, InitiatingEvent initiatingEvent)	Creates a new risk event.

Method Summary

Modifier and Type	Method	Description
static RiskEvent.Builder	builder()	Builder pattern for constructing risk events.
double	getAbsoluteFrequency()	Calculates the absolute frequency considering parent event chain.
double	getConditionalProbability()
RiskEvent.ConsequenceCategory	getConsequenceCategory()
String	getDescription()
double	getFrequency()
InitiatingEvent	getInitiatingEvent()
String	getName()
RiskEvent	getParentEvent()
double	getRiskIndex()	Calculates the risk index (frequency × severity).
ProcessSafetyScenario	getScenario()
boolean	isInitiatingEvent()	Checks if this is a root/initiating event (no parent).
void	setConditionalProbability(double probability)
void	setConsequenceCategory(RiskEvent.ConsequenceCategory category)
void	setFrequency(double frequency)
void	setParentEvent(RiskEvent parent)
void	setScenario(ProcessSafetyScenario scenario)
String	toString()

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Details

name

private final String name

description

private final String description

initiatingEvent

private final InitiatingEvent initiatingEvent

frequency

private double frequency

conditionalProbability

private double conditionalProbability

parentEvent

private RiskEvent parentEvent

scenario

private ProcessSafetyScenario scenario

consequenceCategory

private RiskEvent.ConsequenceCategory consequenceCategory

Constructor Details

RiskEvent

public RiskEvent(String name,
 InitiatingEvent initiatingEvent)

Creates a new risk event.

Parameters:

name - unique identifier for the event

initiatingEvent - the type of initiating event

RiskEvent

public RiskEvent(String name,
 String description,
 InitiatingEvent initiatingEvent)

Creates a new risk event with description.

Parameters:

name - unique identifier for the event

description - detailed description of the event

initiatingEvent - the type of initiating event

Method Details

builder

public static RiskEvent.Builder builder()

Builder pattern for constructing risk events.

Returns:

new builder instance

getName

public String getName()

getDescription

public String getDescription()

getInitiatingEvent

public InitiatingEvent getInitiatingEvent()

getFrequency

public double getFrequency()

setFrequency

public void setFrequency(double frequency)

getConditionalProbability

public double getConditionalProbability()

setConditionalProbability

public void setConditionalProbability(double probability)

getParentEvent

public RiskEvent getParentEvent()

setParentEvent

public void setParentEvent(RiskEvent parent)

getScenario

public ProcessSafetyScenario getScenario()

setScenario

public void setScenario(ProcessSafetyScenario scenario)

getConsequenceCategory

public RiskEvent.ConsequenceCategory getConsequenceCategory()

setConsequenceCategory

public void setConsequenceCategory(RiskEvent.ConsequenceCategory category)

getAbsoluteFrequency

public double getAbsoluteFrequency()

Calculates the absolute frequency considering parent event chain.

For events in an event tree, the absolute frequency is the product of the initiating event frequency and all conditional probabilities along the branch.

Returns:

absolute frequency (events per year)

getRiskIndex

public double getRiskIndex()

Calculates the risk index (frequency × severity).

Returns:

risk index value

isInitiatingEvent

public boolean isInitiatingEvent()

Checks if this is a root/initiating event (no parent).

Returns:

true if this is an initiating event

toString

public String toString()

Overrides:

toString in class Object