Class ProcessSafetyReportBuilder

java.lang.Object

neqsim.process.util.report.safety.ProcessSafetyReportBuilder

public class ProcessSafetyReportBuilder
extends Object

Builder that collects safety information for a ProcessSystem. The builder aggregates condition monitoring messages, equipment safety margins, relief valve diagnostics and thermodynamic KPIs before serializing the result using the familiar Report utilities.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static interface	ProcessSafetyReportBuilder.DoubleSupplier

Field Summary

Fields

Modifier and Type	Field	Description
private ConditionMonitor	conditionMonitor
private static final org.apache.logging.log4j.Logger	logger
private final ProcessSystem	processSystem
private ReportConfig	reportConfig
private String	scenarioLabel
private ProcessSafetyThresholds	thresholds

Constructor Summary

Constructors

Constructor	Description
ProcessSafetyReportBuilder(ProcessSystem processSystem)	Create a builder for the supplied process system.

Method Summary

Modifier and Type	Method	Description
ProcessSafetyReport	build()	Build the ProcessSafetyReport.
private ProcessSafetyReport.ReliefDeviceAssessment	buildReliefAssessment(SafetyReliefValve valve, ProcessSafetyThresholds thresholds)
private ProcessSafetyReport.ReliefDeviceAssessment	buildReliefAssessment(SafetyValve valve, ProcessSafetyThresholds thresholds)
private SeverityLevel	classifyConditionSeverity(String messageLower)
private List<ProcessSafetyReport.ConditionFinding>	collectConditionFindings(ConditionMonitor monitor)
private List<ProcessSafetyReport.ReliefDeviceAssessment>	collectReliefAssessments(ProcessSafetyThresholds appliedThresholds)
private List<ProcessSafetyReport.SafetyMarginAssessment>	collectSafetyMargins(ProcessSafetyThresholds appliedThresholds)
private ProcessSafetyReport.SystemKpiSnapshot	collectSystemKpis(ProcessSafetyThresholds thresholds)
private double	extractMassFlow(StreamInterface stream)
private String	generateEquipmentJson()
private SeverityLevel	gradeHighIsBad(double warningThreshold, double criticalThreshold, double value)
private SeverityLevel	gradeSafetyMargin(ProcessSafetyThresholds thresholds, double marginFraction)
private SeverityLevel	gradeUtilisation(ProcessSafetyThresholds thresholds, double utilisation)
private double	normalizeOpenFraction(ValveInterface valve)
private double	safeDouble(ProcessSafetyReportBuilder.DoubleSupplier supplier)
ProcessSafetyReportBuilder	withConditionMonitor(ConditionMonitor monitor)	Provide a pre-configured ConditionMonitor.
ProcessSafetyReportBuilder	withReportConfig(ReportConfig cfg)	Configure report serialization options.
ProcessSafetyReportBuilder	withScenarioLabel(String label)	Optional descriptive scenario label included in serialized output.
ProcessSafetyReportBuilder	withThresholds(ProcessSafetyThresholds thresholds)	Configure safety thresholds.

Methods inherited from class Object

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

Field Details

logger

private static final org.apache.logging.log4j.Logger logger

processSystem

private final ProcessSystem processSystem

conditionMonitor

private ConditionMonitor conditionMonitor

thresholds

private ProcessSafetyThresholds thresholds

reportConfig

private ReportConfig reportConfig

scenarioLabel

private String scenarioLabel

Constructor Details

ProcessSafetyReportBuilder

public ProcessSafetyReportBuilder(ProcessSystem processSystem)

Create a builder for the supplied process system.

Parameters:

processSystem - process to analyse

Method Details

withConditionMonitor

public ProcessSafetyReportBuilder withConditionMonitor(ConditionMonitor monitor)

Provide a pre-configured ConditionMonitor. If not supplied the builder will instantiate one based on the process itself.

Parameters:

monitor - monitor instance

Returns:

this builder

withThresholds

public ProcessSafetyReportBuilder withThresholds(ProcessSafetyThresholds thresholds)

Configure safety thresholds.

Parameters:

thresholds - thresholds

Returns:

this builder

withReportConfig

public ProcessSafetyReportBuilder withReportConfig(ReportConfig cfg)

Configure report serialization options.

Parameters:

cfg - report configuration

Returns:

this builder

withScenarioLabel

public ProcessSafetyReportBuilder withScenarioLabel(String label)

Optional descriptive scenario label included in serialized output.

Parameters:

label - scenario label

Returns:

this builder

build

public ProcessSafetyReport build()

Build the ProcessSafetyReport. The method is thread-safe but will copy internal data to avoid exposing mutable state.

Returns:

built report

collectConditionFindings

private List<ProcessSafetyReport.ConditionFinding> collectConditionFindings(ConditionMonitor monitor)

classifyConditionSeverity

private SeverityLevel classifyConditionSeverity(String messageLower)

collectSafetyMargins

private List<ProcessSafetyReport.SafetyMarginAssessment> collectSafetyMargins(ProcessSafetyThresholds appliedThresholds)

gradeSafetyMargin

private SeverityLevel gradeSafetyMargin(ProcessSafetyThresholds thresholds,
 double marginFraction)

collectReliefAssessments

private List<ProcessSafetyReport.ReliefDeviceAssessment> collectReliefAssessments(ProcessSafetyThresholds appliedThresholds)

buildReliefAssessment

private ProcessSafetyReport.ReliefDeviceAssessment buildReliefAssessment(SafetyReliefValve valve,
 ProcessSafetyThresholds thresholds)

buildReliefAssessment

private ProcessSafetyReport.ReliefDeviceAssessment buildReliefAssessment(SafetyValve valve,
 ProcessSafetyThresholds thresholds)

safeDouble

private double safeDouble(ProcessSafetyReportBuilder.DoubleSupplier supplier)

extractMassFlow

private double extractMassFlow(StreamInterface stream)

normalizeOpenFraction

private double normalizeOpenFraction(ValveInterface valve)

gradeUtilisation

private SeverityLevel gradeUtilisation(ProcessSafetyThresholds thresholds,
 double utilisation)

collectSystemKpis

private ProcessSafetyReport.SystemKpiSnapshot collectSystemKpis(ProcessSafetyThresholds thresholds)

gradeHighIsBad

private SeverityLevel gradeHighIsBad(double warningThreshold,
 double criticalThreshold,
 double value)

generateEquipmentJson

private String generateEquipmentJson()