Class AutomaticScenarioGenerator

java.lang.Object

neqsim.process.safety.scenario.AutomaticScenarioGenerator

All Implemented Interfaces:

Serializable

public class AutomaticScenarioGenerator
extends Object
implements Serializable

Automatically generates safety scenarios from equipment failure modes.

This class creates comprehensive what-if scenarios by:

• Failure Mode Analysis: Identify equipment-specific failure modes
• Combination Generation: Create multi-failure scenarios
• HAZOP Integration: Map to standard HAZOP deviations
• Prioritization: Rank scenarios by severity and likelihood

Usage Example:

ProcessSystem process = new ProcessSystem();
// ... configure process ...

AutomaticScenarioGenerator generator = new AutomaticScenarioGenerator(process);

// Generate all single-failure scenarios
List<ProcessSafetyScenario> scenarios = generator
    .addFailureModes(FailureMode.COOLING_LOSS, FailureMode.VALVE_STUCK).generateSingleFailures();

// Generate combination scenarios (up to 2 simultaneous failures)
List<ProcessSafetyScenario> combinations = generator.generateCombinations(2);

// Run all scenarios
for (ProcessSafetyScenario scenario : scenarios) {
  scenario.applyTo(process.copy());
  process.run();
  // Analyze results
}

Version:

1.0

Author:

ESOL

See Also:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	AutomaticScenarioGenerator.EquipmentFailure	Represents a potential equipment failure.
static enum	AutomaticScenarioGenerator.FailureMode	Standard equipment failure modes.
static enum	AutomaticScenarioGenerator.HazopDeviation	Standard HAZOP deviation types.
static class	AutomaticScenarioGenerator.ScenarioRunResult	Result of running a single safety scenario.

Field Summary

Fields

Modifier and Type	Field	Description
private final Set<AutomaticScenarioGenerator.FailureMode>	enabledFailureModes
private final Map<String, List<String>>	equipmentToDeviations
private final List<AutomaticScenarioGenerator.EquipmentFailure>	identifiedFailures
private final ProcessSystem	processSystem
private static final long	serialVersionUID

Constructor Summary

Constructors

Constructor	Description
AutomaticScenarioGenerator(ProcessSystem processSystem)	Creates a scenario generator for a process system.

Method Summary

Modifier and Type	Method	Description
AutomaticScenarioGenerator	addFailureModes(AutomaticScenarioGenerator.FailureMode... modes)	Adds failure modes to consider.
private Map<String,Double>	captureKeyResults(ProcessSystem process)	Captures key result values from a process system after running a scenario.
private ProcessSafetyScenario	createCombinationScenario(AutomaticScenarioGenerator.EquipmentFailure... failures)
private ProcessSafetyScenario	createScenario(AutomaticScenarioGenerator.EquipmentFailure failure)
AutomaticScenarioGenerator	enableAllFailureModes()	Enables all failure modes.
List<ProcessSafetyScenario>	generateCombinations(int maxCombinationSize)	Generates combination scenarios (multiple simultaneous failures).
List<ProcessSafetyScenario>	generateSingleFailures()	Generates single-failure scenarios for all enabled failure modes.
String	getFailureModeSummary()	Gets a summary of identified failure modes by equipment type.
List<AutomaticScenarioGenerator.EquipmentFailure>	getIdentifiedFailures()	Gets all identified equipment failures.
private void	identifyEquipmentFailureModes()
private void	identifyFailuresForEquipment(ProcessEquipmentInterface equipment)
List<AutomaticScenarioGenerator.ScenarioRunResult>	runAllSingleFailures()	Runs all single-failure scenarios for enabled failure modes.
List<AutomaticScenarioGenerator.ScenarioRunResult>	runScenarios(List<ProcessSafetyScenario> scenarios)	Runs all generated scenarios and collects results.
static String	summarizeResults(List<AutomaticScenarioGenerator.ScenarioRunResult> results)	Generates a summary of scenario run results.

Methods inherited from class Object

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

Field Details

serialVersionUID

private static final long serialVersionUID

See Also:

• Constant Field Values

processSystem

private final ProcessSystem processSystem

enabledFailureModes

private final Set<AutomaticScenarioGenerator.FailureMode> enabledFailureModes

identifiedFailures

private final List<AutomaticScenarioGenerator.EquipmentFailure> identifiedFailures

equipmentToDeviations

private final Map<String, List<String>> equipmentToDeviations

Constructor Details

AutomaticScenarioGenerator

public AutomaticScenarioGenerator(ProcessSystem processSystem)

Creates a scenario generator for a process system.

Parameters:

processSystem - the process system to analyze

Method Details

addFailureModes

public AutomaticScenarioGenerator addFailureModes(AutomaticScenarioGenerator.FailureMode... modes)

Adds failure modes to consider.

Parameters:

modes - failure modes to enable

Returns:

this generator for chaining

enableAllFailureModes

public AutomaticScenarioGenerator enableAllFailureModes()

Enables all failure modes.

Returns:

this generator for chaining

generateSingleFailures

public List<ProcessSafetyScenario> generateSingleFailures()

Generates single-failure scenarios for all enabled failure modes.

Returns:

list of scenarios

generateCombinations

public List<ProcessSafetyScenario> generateCombinations(int maxCombinationSize)

Generates combination scenarios (multiple simultaneous failures).

Parameters:

maxCombinationSize - maximum number of simultaneous failures

Returns:

list of combination scenarios

getIdentifiedFailures

public List<AutomaticScenarioGenerator.EquipmentFailure> getIdentifiedFailures()

Gets all identified equipment failures.

Returns:

list of potential failures

getFailureModeSummary

public String getFailureModeSummary()

Gets a summary of identified failure modes by equipment type.

Returns:

formatted summary string

identifyEquipmentFailureModes

private void identifyEquipmentFailureModes()

identifyFailuresForEquipment

private void identifyFailuresForEquipment(ProcessEquipmentInterface equipment)

createScenario

private ProcessSafetyScenario createScenario(AutomaticScenarioGenerator.EquipmentFailure failure)

createCombinationScenario

private ProcessSafetyScenario createCombinationScenario(AutomaticScenarioGenerator.EquipmentFailure... failures)

runScenarios

public List<AutomaticScenarioGenerator.ScenarioRunResult> runScenarios(List<ProcessSafetyScenario> scenarios)

Runs all generated scenarios and collects results.

This method runs each scenario on a copy of the process system and captures key result values. Scenarios that fail to converge are recorded with their error messages.

Parameters:

scenarios - list of scenarios to run

Returns:

list of results for each scenario

runAllSingleFailures

public List<AutomaticScenarioGenerator.ScenarioRunResult> runAllSingleFailures()

Runs all single-failure scenarios for enabled failure modes.

Returns:

list of results

captureKeyResults

private Map<String,Double> captureKeyResults(ProcessSystem process)

Captures key result values from a process system after running a scenario.

Parameters:

process - the process system after scenario execution

Returns:

map of result name to value

summarizeResults

public static String summarizeResults(List<AutomaticScenarioGenerator.ScenarioRunResult> results)

Generates a summary of scenario run results.

Parameters:

results - list of scenario results

Returns:

formatted summary string