Enum Class ConstraintSeverityLevel

java.lang.Object

java.lang.Enum<ConstraintSeverityLevel>

neqsim.process.util.optimizer.ConstraintSeverityLevel

All Implemented Interfaces:

Serializable, Comparable<ConstraintSeverityLevel>, Constable

public enum ConstraintSeverityLevel
extends Enum<ConstraintSeverityLevel>

Unified severity level for all constraint types in the optimization framework.

This enum provides a common 4-level severity classification that maps between:

• CapacityConstraint.ConstraintSeverity — equipment-level (CRITICAL/HARD/SOFT/ADVISORY)
• ProductionOptimizer.ConstraintSeverity — optimizer-level (HARD/SOFT)
• ProcessSimulationEvaluator.ConstraintDefinition.isHard() — boolean flag

Optimizer behavior by level:

Constraint severity levels and optimizer behavior

Level	Optimizer Impact	Example
CRITICAL	Solution rejected; optimizer may abort	Compressor surge, overspeed trip
HARD	Solution marked infeasible	Design capacity, max power
SOFT	Penalty applied to objective	Recommended operating range
ADVISORY	No optimization impact; reporting only	Turndown ratio, design deviation

Version:

1.0

Author:

NeqSim Development Team

See Also:

• ProcessConstraint

Nested Class Summary

Nested classes/interfaces inherited from class Enum

Enum.EnumDesc<E>

Enum Constant Summary

Enum Constants

Enum Constant	Description
ADVISORY	Advisory — informational only with no optimization impact.
CRITICAL	Critical violation — equipment damage or safety hazard.
HARD	Hard violation — solution is infeasible if violated.
SOFT	Soft violation — undesirable but acceptable.

Constructor Summary

Constructors

Modifier	Constructor	Description
private	ConstraintSeverityLevel()

Method Summary

Modifier and Type	Method	Description
static ConstraintSeverityLevel	fromCapacitySeverity(CapacityConstraint.ConstraintSeverity severity)	Converts from CapacityConstraint.ConstraintSeverity to unified severity.
static ConstraintSeverityLevel	fromIsHard(boolean isHard)	Converts from the boolean isHard flag used in ProcessSimulationEvaluator.ConstraintDefinition to unified severity.
static ConstraintSeverityLevel	fromOptimizerSeverity(ProductionOptimizer.ConstraintSeverity severity)	Converts from ProductionOptimizer.ConstraintSeverity to unified severity.
CapacityConstraint.ConstraintSeverity	toCapacitySeverity()	Converts this unified severity to the 4-level CapacityConstraint.ConstraintSeverity.
boolean	toIsHard()	Converts this unified severity to a boolean hard/soft flag.
ProductionOptimizer.ConstraintSeverity	toOptimizerSeverity()	Converts this unified severity to the 2-level ProductionOptimizer.ConstraintSeverity.
static ConstraintSeverityLevel	valueOf(String name)	Returns the enum constant of this class with the specified name.
static ConstraintSeverityLevel[]	values()	Returns an array containing the constants of this enum class, in the order they are declared.

Methods inherited from class Enum

clone, compareTo, describeConstable, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Details

CRITICAL

public static final ConstraintSeverityLevel CRITICAL

Critical violation — equipment damage or safety hazard. Optimizer must stop or reject solution immediately.

HARD

public static final ConstraintSeverityLevel HARD

Hard violation — solution is infeasible if violated. Optimizer marks solution as infeasible.

SOFT

public static final ConstraintSeverityLevel SOFT

Soft violation — undesirable but acceptable. Optimizer applies penalty to objective function.

ADVISORY

public static final ConstraintSeverityLevel ADVISORY

Advisory — informational only with no optimization impact. Used for reporting and monitoring.

Constructor Details

ConstraintSeverityLevel

private ConstraintSeverityLevel()

Method Details

values

public static ConstraintSeverityLevel[] values()

Returns an array containing the constants of this enum class, in the order they are declared.

Returns:

an array containing the constants of this enum class, in the order they are declared

valueOf

public static ConstraintSeverityLevel valueOf(String name)

Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum class has no constant with the specified name

NullPointerException - if the argument is null

fromCapacitySeverity

public static ConstraintSeverityLevel fromCapacitySeverity(CapacityConstraint.ConstraintSeverity severity)

Converts from CapacityConstraint.ConstraintSeverity to unified severity.

Parameters:

severity - the equipment-level severity

Returns:

the equivalent unified severity level

fromOptimizerSeverity

public static ConstraintSeverityLevel fromOptimizerSeverity(ProductionOptimizer.ConstraintSeverity severity)

Converts from ProductionOptimizer.ConstraintSeverity to unified severity.

Parameters:

severity - the optimizer-level severity (HARD or SOFT)

Returns:

the equivalent unified severity level

fromIsHard

public static ConstraintSeverityLevel fromIsHard(boolean isHard)

Converts from the boolean isHard flag used in ProcessSimulationEvaluator.ConstraintDefinition to unified severity.

Parameters:

isHard - true for hard constraints, false for soft

Returns:

HARD if isHard is true, SOFT otherwise

toOptimizerSeverity

public ProductionOptimizer.ConstraintSeverity toOptimizerSeverity()

Converts this unified severity to the 2-level ProductionOptimizer.ConstraintSeverity.

CRITICAL maps to HARD (since the 2-level enum has no critical level). ADVISORY maps to SOFT.

Returns:

the equivalent optimizer severity

toCapacitySeverity

public CapacityConstraint.ConstraintSeverity toCapacitySeverity()

Converts this unified severity to the 4-level CapacityConstraint.ConstraintSeverity.

Returns:

the equivalent equipment-level severity

toIsHard

public boolean toIsHard()

Converts this unified severity to a boolean hard/soft flag.

Returns:

true for CRITICAL and HARD; false for SOFT and ADVISORY