Class ProductionOptimizer

java.lang.Object

neqsim.process.util.optimization.ProductionOptimizer

public class ProductionOptimizer
extends Object

Utility class for production optimization based on capacity utilization and configurable constraints. The optimizer currently targets a single decision variable (feed flow) but keeps a structured record of objectives, constraint margins, and utilization limits so that more advanced workflows (multi-objective scoring, probabilistic margins, reporting) can be built on top.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) static interface	ProductionOptimizer.CapacityMetric	Function to compute capacity duty/limit for a specific equipment.
(package private) static final class	ProductionOptimizer.CapacityRange	Range container to support percentile-based capacity evaluations.
(package private) static final class	ProductionOptimizer.CapacityRule	Pair of capacity duty/max providers.
static enum	ProductionOptimizer.ConstraintDirection	Direction of a constraint comparison.
static enum	ProductionOptimizer.ConstraintSeverity	Severity classification for constraints.
static final class	ProductionOptimizer.ConstraintStatus	Outcome for a single constraint evaluation.
(package private) static final class	ProductionOptimizer.EquipmentConstraintRule	Constraint template applied to each matching equipment.
(package private) static interface	ProductionOptimizer.EquipmentMetric	Metric to evaluate per-equipment constraints.
private static final class	ProductionOptimizer.Evaluation	Result of a single iteration.
static final class	ProductionOptimizer.IterationRecord	Snapshot of each iteration to support diagnostics and plotting.
static final class	ProductionOptimizer.ManipulatedVariable	Definition of a manipulated decision variable.
static enum	ProductionOptimizer.ObjectiveType	Objective optimization direction.
static final class	ProductionOptimizer.OptimizationConfig	Builder-style configuration for the optimizer.
static final class	ProductionOptimizer.OptimizationConstraint	Simple container for constraint configuration.
static final class	ProductionOptimizer.OptimizationObjective	Simple container for objective configuration.
static final class	ProductionOptimizer.OptimizationResult	Result container for a completed optimization attempt.
static final class	ProductionOptimizer.OptimizationSummary	Lightweight summary of an optimization run intended for quick-consumption APIs.
static final class	ProductionOptimizer.ScenarioComparisonResult	Per-scenario KPI values and deltas versus the baseline scenario.
static final class	ProductionOptimizer.ScenarioKpi	Definition of a KPI to report alongside scenario comparisons.
static final class	ProductionOptimizer.ScenarioRequest	Scenario definition to enable side-by-side optimization comparisons.
static final class	ProductionOptimizer.ScenarioResult	Optimization result paired with a scenario name to aid reporting/comparison.
static enum	ProductionOptimizer.SearchMode	Supported search algorithms.
static final class	ProductionOptimizer.UtilizationRecord	Holds the utilization status for an equipment item.
static final class	ProductionOptimizer.UtilizationSeries	Series-friendly representation of utilization across iterations for plotting/reporting.

Field Summary

Fields

Modifier and Type	Field	Description
static final double	DEFAULT_UTILIZATION_LIMIT	Default maximum utilization used when no specific equipment rule is provided.

Constructor Summary

Constructors

Constructor	Description
ProductionOptimizer()

Method Summary

Modifier and Type	Method	Description
private ProductionOptimizer.OptimizationResult	binaryFeasibilitySearch(ProcessSystem process, List<ProductionOptimizer.ManipulatedVariable> variables, ProductionOptimizer.OptimizationConfig config, List<ProductionOptimizer.OptimizationObjective> objectives, List<ProductionOptimizer.OptimizationConstraint> constraints, List<ProductionOptimizer.IterationRecord> iterationHistory)
private ProductionOptimizer.OptimizationResult	binaryFeasibilitySearch(ProcessSystem process, StreamInterface feedStream, ProductionOptimizer.OptimizationConfig config, List<ProductionOptimizer.OptimizationObjective> objectives, List<ProductionOptimizer.OptimizationConstraint> constraints, List<ProductionOptimizer.IterationRecord> iterationHistory)
static List<ProductionOptimizer.UtilizationSeries>	buildUtilizationSeries(List<ProductionOptimizer.IterationRecord> iterationHistory)	Build utilization series for each equipment across the provided iteration history to facilitate charting or CSV export.
private String	buildVectorCacheKey(double[] candidate, ProductionOptimizer.OptimizationConfig config)
ProductionOptimizer.ScenarioComparisonResult	compareScenarios(List<ProductionOptimizer.ScenarioRequest> scenarios, List<ProductionOptimizer.ScenarioKpi> kpis)	Optimize multiple scenarios and compute KPI deltas versus the baseline (first) scenario.
private double[]	computeCentroid(double[][] simplex, int count)
private double[]	contract(double[] centroid, double[] point, double factor)
private ProductionOptimizer.CapacityRange	determineCapacityRange(ProcessEquipmentInterface unit, ProductionOptimizer.OptimizationConfig config)
private ProductionOptimizer.CapacityRule	determineCapacityRule(ProcessEquipmentInterface unit, ProductionOptimizer.OptimizationConfig config)
private double	determineUtilizationLimit(ProcessEquipmentInterface unit, ProductionOptimizer.OptimizationConfig config)
private ProductionOptimizer.Evaluation	evaluateCandidate(ProcessSystem process, List<ProductionOptimizer.ManipulatedVariable> variables, ProductionOptimizer.OptimizationConfig config, List<ProductionOptimizer.OptimizationObjective> objectives, List<ProductionOptimizer.OptimizationConstraint> constraints, double[] candidate, Map<String, ProductionOptimizer.Evaluation> cache)
private ProductionOptimizer.Evaluation	evaluateCandidate(ProcessSystem process, StreamInterface feedStream, ProductionOptimizer.OptimizationConfig config, List<ProductionOptimizer.OptimizationObjective> objectives, List<ProductionOptimizer.OptimizationConstraint> constraints, double candidateRate, Map<Long, ProductionOptimizer.Evaluation> cache)
private ProductionOptimizer.Evaluation	evaluateCandidateInternal(ProcessSystem process, List<ProductionOptimizer.ManipulatedVariable> variables, ProductionOptimizer.OptimizationConfig config, List<ProductionOptimizer.OptimizationObjective> objectives, List<ProductionOptimizer.OptimizationConstraint> constraints, double[] candidate)
private ProductionOptimizer.Evaluation	evaluateCandidateInternal(ProcessSystem process, StreamInterface feedStream, ProductionOptimizer.OptimizationConfig config, List<ProductionOptimizer.OptimizationObjective> objectives, List<ProductionOptimizer.OptimizationConstraint> constraints, double candidateRate)
private ProductionOptimizer.Evaluation	evaluateProcess(ProcessSystem process, ProductionOptimizer.OptimizationConfig config, List<ProductionOptimizer.OptimizationObjective> objectives, List<ProductionOptimizer.OptimizationConstraint> constraints, Map<String,Double> decisionVariables)
private double	feasibilityScore(ProductionOptimizer.Evaluation evaluation)
static String	formatScenarioComparisonTable(ProductionOptimizer.ScenarioComparisonResult comparison, List<ProductionOptimizer.ScenarioKpi> kpis)	Render scenario KPIs and bottleneck information side-by-side.
static String	formatUtilizationTable(List<ProductionOptimizer.UtilizationRecord> records)	Render a compact Markdown table describing utilization per unit.
static String	formatUtilizationTimeline(List<ProductionOptimizer.IterationRecord> iterationHistory)	Render a compact Markdown timeline showing bottlenecks across iterations.
private ProductionOptimizer.OptimizationResult	goldenSectionSearch(ProcessSystem process, List<ProductionOptimizer.ManipulatedVariable> variables, ProductionOptimizer.OptimizationConfig config, List<ProductionOptimizer.OptimizationObjective> objectives, List<ProductionOptimizer.OptimizationConstraint> constraints, List<ProductionOptimizer.IterationRecord> iterationHistory)
private ProductionOptimizer.OptimizationResult	goldenSectionSearch(ProcessSystem process, StreamInterface feedStream, ProductionOptimizer.OptimizationConfig config, List<ProductionOptimizer.OptimizationObjective> objectives, List<ProductionOptimizer.OptimizationConstraint> constraints, List<ProductionOptimizer.IterationRecord> iterationHistory)
private ProductionOptimizer.OptimizationResult	nelderMeadSearch(ProcessSystem process, List<ProductionOptimizer.ManipulatedVariable> variables, ProductionOptimizer.OptimizationConfig config, List<ProductionOptimizer.OptimizationObjective> objectives, List<ProductionOptimizer.OptimizationConstraint> constraints, List<ProductionOptimizer.IterationRecord> iterationHistory)
private ProductionOptimizer.OptimizationResult	nelderMeadSearch(ProcessSystem process, StreamInterface feedStream, ProductionOptimizer.OptimizationConfig config, List<ProductionOptimizer.OptimizationObjective> objectives, List<ProductionOptimizer.OptimizationConstraint> constraints, List<ProductionOptimizer.IterationRecord> iterationHistory)
ProductionOptimizer.OptimizationResult	optimize(ProcessSystem process, List<ProductionOptimizer.ManipulatedVariable> variables, ProductionOptimizer.OptimizationConfig config, List<ProductionOptimizer.OptimizationObjective> objectives, List<ProductionOptimizer.OptimizationConstraint> constraints)	Optimize multiple manipulated variables (feeds, pressures, temperatures) using multi-dimensional search strategies.
ProductionOptimizer.OptimizationResult	optimize(ProcessSystem process, StreamInterface feedStream, ProductionOptimizer.OptimizationConfig config, List<ProductionOptimizer.OptimizationObjective> objectives, List<ProductionOptimizer.OptimizationConstraint> constraints)	Optimize the feed stream rate of a process to respect utilization limits and constraints.
List<ProductionOptimizer.ScenarioResult>	optimizeScenarios(List<ProductionOptimizer.ScenarioRequest> scenarios)	Optimize a collection of named scenarios and return results for side-by-side comparison.
ProductionOptimizer.OptimizationResult	optimizeThroughput(ProcessSystem process, StreamInterface feedStream, double lowerBound, double upperBound, String rateUnit, List<ProductionOptimizer.OptimizationConstraint> additionalConstraints)	Convenience wrapper to maximize throughput with optional constraints and custom search config.
private ProductionOptimizer.OptimizationResult	particleSwarmSearch(ProcessSystem process, List<ProductionOptimizer.ManipulatedVariable> variables, ProductionOptimizer.OptimizationConfig config, List<ProductionOptimizer.OptimizationObjective> objectives, List<ProductionOptimizer.OptimizationConstraint> constraints, List<ProductionOptimizer.IterationRecord> iterationHistory)
private ProductionOptimizer.OptimizationResult	particleSwarmSearch(ProcessSystem process, StreamInterface feedStream, ProductionOptimizer.OptimizationConfig config, List<ProductionOptimizer.OptimizationObjective> objectives, List<ProductionOptimizer.OptimizationConstraint> constraints, List<ProductionOptimizer.IterationRecord> iterationHistory)
ProductionOptimizer.OptimizationSummary	quickOptimize(ProcessSystem process, StreamInterface feedStream)	Convenience wrapper that derives reasonable bounds from the current feed rate and returns a concise summary (max rate, limiting equipment, utilization margin).
ProductionOptimizer.OptimizationSummary	quickOptimize(ProcessSystem process, StreamInterface feedStream, String rateUnit, List<ProductionOptimizer.OptimizationConstraint> constraints)	Convenience wrapper that derives reasonable bounds from the current feed rate and returns a concise summary (max rate, limiting equipment, utilization margin).
private void	recordIteration(List<ProductionOptimizer.IterationRecord> iterationHistory, double candidate, String rateUnit, ProductionOptimizer.Evaluation evaluation, boolean feasible)
private double[]	reflect(double[] centroid, double[] point, double factor)
private void	shrink(double[][] simplex, List<ProductionOptimizer.ManipulatedVariable> variables)
private void	sortSimplexByScore(double[][] simplex, ProductionOptimizer.Evaluation[] evaluations)
private ProductionOptimizer.OptimizationResult	toResult(double rate, String unit, int iteration, ProductionOptimizer.Evaluation evaluation, List<ProductionOptimizer.IterationRecord> iterationHistory)

Methods inherited from class Object

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

Field Details

DEFAULT_UTILIZATION_LIMIT

public static final double DEFAULT_UTILIZATION_LIMIT

Default maximum utilization used when no specific equipment rule is provided.

See Also:

• Constant Field Values

Constructor Details

ProductionOptimizer

public ProductionOptimizer()

Method Details

optimize

public ProductionOptimizer.OptimizationResult optimize(ProcessSystem process,
 StreamInterface feedStream,
 ProductionOptimizer.OptimizationConfig config,
 List<ProductionOptimizer.OptimizationObjective> objectives,
 List<ProductionOptimizer.OptimizationConstraint> constraints)

Optimize the feed stream rate of a process to respect utilization limits and constraints.

Parameters:

process - the process model to evaluate

feedStream - the feed stream whose flow rate will be adjusted

config - optimizer configuration

objectives - list of objectives (optional) to compute a weighted score for reporting

constraints - list of constraints with optional penalties

Returns:

optimization result

optimize

public ProductionOptimizer.OptimizationResult optimize(ProcessSystem process,
 List<ProductionOptimizer.ManipulatedVariable> variables,
 ProductionOptimizer.OptimizationConfig config,
 List<ProductionOptimizer.OptimizationObjective> objectives,
 List<ProductionOptimizer.OptimizationConstraint> constraints)

Optimize multiple manipulated variables (feeds, pressures, temperatures) using multi-dimensional search strategies.

optimizeScenarios

public List<ProductionOptimizer.ScenarioResult> optimizeScenarios(List<ProductionOptimizer.ScenarioRequest> scenarios)

Optimize a collection of named scenarios and return results for side-by-side comparison.

Parameters:

scenarios - scenarios containing process, feed, config, objectives, and constraints

Returns:

list of scenario results in the same order as provided

compareScenarios

public ProductionOptimizer.ScenarioComparisonResult compareScenarios(List<ProductionOptimizer.ScenarioRequest> scenarios,
 List<ProductionOptimizer.ScenarioKpi> kpis)

Optimize multiple scenarios and compute KPI deltas versus the baseline (first) scenario.

Parameters:

scenarios - list of scenarios to optimize; first entry is treated as baseline

kpis - KPIs to compute per scenario (optional)

Returns:

comparison result with KPI deltas and raw results

optimizeThroughput

public ProductionOptimizer.OptimizationResult optimizeThroughput(ProcessSystem process,
 StreamInterface feedStream,
 double lowerBound,
 double upperBound,
 String rateUnit,
 List<ProductionOptimizer.OptimizationConstraint> additionalConstraints)

Convenience wrapper to maximize throughput with optional constraints and custom search config.

Parameters:

process - process system to run

feedStream - feed stream that will be adjusted

lowerBound - lower bound on the manipulated feed rate

upperBound - upper bound on the manipulated feed rate

rateUnit - engineering unit for rate

additionalConstraints - optional hard/soft constraints

Returns:

optimization result with utilization and constraint history

formatUtilizationTable

public static String formatUtilizationTable(List<ProductionOptimizer.UtilizationRecord> records)

Render a compact Markdown table describing utilization per unit.

formatScenarioComparisonTable

public static String formatScenarioComparisonTable(ProductionOptimizer.ScenarioComparisonResult comparison,
 List<ProductionOptimizer.ScenarioKpi> kpis)

Render scenario KPIs and bottleneck information side-by-side.

buildUtilizationSeries

public static List<ProductionOptimizer.UtilizationSeries> buildUtilizationSeries(List<ProductionOptimizer.IterationRecord> iterationHistory)

Build utilization series for each equipment across the provided iteration history to facilitate charting or CSV export.

formatUtilizationTimeline

public static String formatUtilizationTimeline(List<ProductionOptimizer.IterationRecord> iterationHistory)

Render a compact Markdown timeline showing bottlenecks across iterations.

toResult

private ProductionOptimizer.OptimizationResult toResult(double rate,
 String unit,
 int iteration,
 ProductionOptimizer.Evaluation evaluation,
 List<ProductionOptimizer.IterationRecord> iterationHistory)

quickOptimize

public ProductionOptimizer.OptimizationSummary quickOptimize(ProcessSystem process,
 StreamInterface feedStream)

Convenience wrapper that derives reasonable bounds from the current feed rate and returns a concise summary (max rate, limiting equipment, utilization margin).

quickOptimize

public ProductionOptimizer.OptimizationSummary quickOptimize(ProcessSystem process,
 StreamInterface feedStream,
 String rateUnit,
 List<ProductionOptimizer.OptimizationConstraint> constraints)

Convenience wrapper that derives reasonable bounds from the current feed rate and returns a concise summary (max rate, limiting equipment, utilization margin).

evaluateProcess

private ProductionOptimizer.Evaluation evaluateProcess(ProcessSystem process,
 ProductionOptimizer.OptimizationConfig config,
 List<ProductionOptimizer.OptimizationObjective> objectives,
 List<ProductionOptimizer.OptimizationConstraint> constraints,
 Map<String,Double> decisionVariables)

binaryFeasibilitySearch

private ProductionOptimizer.OptimizationResult binaryFeasibilitySearch(ProcessSystem process,
 StreamInterface feedStream,
 ProductionOptimizer.OptimizationConfig config,
 List<ProductionOptimizer.OptimizationObjective> objectives,
 List<ProductionOptimizer.OptimizationConstraint> constraints,
 List<ProductionOptimizer.IterationRecord> iterationHistory)

binaryFeasibilitySearch

private ProductionOptimizer.OptimizationResult binaryFeasibilitySearch(ProcessSystem process,
 List<ProductionOptimizer.ManipulatedVariable> variables,
 ProductionOptimizer.OptimizationConfig config,
 List<ProductionOptimizer.OptimizationObjective> objectives,
 List<ProductionOptimizer.OptimizationConstraint> constraints,
 List<ProductionOptimizer.IterationRecord> iterationHistory)

goldenSectionSearch

private ProductionOptimizer.OptimizationResult goldenSectionSearch(ProcessSystem process,
 StreamInterface feedStream,
 ProductionOptimizer.OptimizationConfig config,
 List<ProductionOptimizer.OptimizationObjective> objectives,
 List<ProductionOptimizer.OptimizationConstraint> constraints,
 List<ProductionOptimizer.IterationRecord> iterationHistory)

goldenSectionSearch

private ProductionOptimizer.OptimizationResult goldenSectionSearch(ProcessSystem process,
 List<ProductionOptimizer.ManipulatedVariable> variables,
 ProductionOptimizer.OptimizationConfig config,
 List<ProductionOptimizer.OptimizationObjective> objectives,
 List<ProductionOptimizer.OptimizationConstraint> constraints,
 List<ProductionOptimizer.IterationRecord> iterationHistory)

nelderMeadSearch

private ProductionOptimizer.OptimizationResult nelderMeadSearch(ProcessSystem process,
 StreamInterface feedStream,
 ProductionOptimizer.OptimizationConfig config,
 List<ProductionOptimizer.OptimizationObjective> objectives,
 List<ProductionOptimizer.OptimizationConstraint> constraints,
 List<ProductionOptimizer.IterationRecord> iterationHistory)

nelderMeadSearch

private ProductionOptimizer.OptimizationResult nelderMeadSearch(ProcessSystem process,
 List<ProductionOptimizer.ManipulatedVariable> variables,
 ProductionOptimizer.OptimizationConfig config,
 List<ProductionOptimizer.OptimizationObjective> objectives,
 List<ProductionOptimizer.OptimizationConstraint> constraints,
 List<ProductionOptimizer.IterationRecord> iterationHistory)

particleSwarmSearch

private ProductionOptimizer.OptimizationResult particleSwarmSearch(ProcessSystem process,
 StreamInterface feedStream,
 ProductionOptimizer.OptimizationConfig config,
 List<ProductionOptimizer.OptimizationObjective> objectives,
 List<ProductionOptimizer.OptimizationConstraint> constraints,
 List<ProductionOptimizer.IterationRecord> iterationHistory)

particleSwarmSearch

private ProductionOptimizer.OptimizationResult particleSwarmSearch(ProcessSystem process,
 List<ProductionOptimizer.ManipulatedVariable> variables,
 ProductionOptimizer.OptimizationConfig config,
 List<ProductionOptimizer.OptimizationObjective> objectives,
 List<ProductionOptimizer.OptimizationConstraint> constraints,
 List<ProductionOptimizer.IterationRecord> iterationHistory)

sortSimplexByScore

private void sortSimplexByScore(double[][] simplex,
 ProductionOptimizer.Evaluation[] evaluations)

computeCentroid

private double[] computeCentroid(double[][] simplex,
 int count)

reflect

private double[] reflect(double[] centroid,
 double[] point,
 double factor)

contract

private double[] contract(double[] centroid,
 double[] point,
 double factor)

shrink

private void shrink(double[][] simplex,
 List<ProductionOptimizer.ManipulatedVariable> variables)

evaluateCandidate

private ProductionOptimizer.Evaluation evaluateCandidate(ProcessSystem process,
 StreamInterface feedStream,
 ProductionOptimizer.OptimizationConfig config,
 List<ProductionOptimizer.OptimizationObjective> objectives,
 List<ProductionOptimizer.OptimizationConstraint> constraints,
 double candidateRate,
 Map<Long, ProductionOptimizer.Evaluation> cache)

evaluateCandidate

private ProductionOptimizer.Evaluation evaluateCandidate(ProcessSystem process,
 List<ProductionOptimizer.ManipulatedVariable> variables,
 ProductionOptimizer.OptimizationConfig config,
 List<ProductionOptimizer.OptimizationObjective> objectives,
 List<ProductionOptimizer.OptimizationConstraint> constraints,
 double[] candidate,
 Map<String, ProductionOptimizer.Evaluation> cache)

evaluateCandidateInternal

private ProductionOptimizer.Evaluation evaluateCandidateInternal(ProcessSystem process,
 StreamInterface feedStream,
 ProductionOptimizer.OptimizationConfig config,
 List<ProductionOptimizer.OptimizationObjective> objectives,
 List<ProductionOptimizer.OptimizationConstraint> constraints,
 double candidateRate)

evaluateCandidateInternal

private ProductionOptimizer.Evaluation evaluateCandidateInternal(ProcessSystem process,
 List<ProductionOptimizer.ManipulatedVariable> variables,
 ProductionOptimizer.OptimizationConfig config,
 List<ProductionOptimizer.OptimizationObjective> objectives,
 List<ProductionOptimizer.OptimizationConstraint> constraints,
 double[] candidate)

buildVectorCacheKey

private String buildVectorCacheKey(double[] candidate,
 ProductionOptimizer.OptimizationConfig config)

recordIteration

private void recordIteration(List<ProductionOptimizer.IterationRecord> iterationHistory,
 double candidate,
 String rateUnit,
 ProductionOptimizer.Evaluation evaluation,
 boolean feasible)

feasibilityScore

private double feasibilityScore(ProductionOptimizer.Evaluation evaluation)

determineUtilizationLimit

private double determineUtilizationLimit(ProcessEquipmentInterface unit,
 ProductionOptimizer.OptimizationConfig config)

determineCapacityRule

private ProductionOptimizer.CapacityRule determineCapacityRule(ProcessEquipmentInterface unit,
 ProductionOptimizer.OptimizationConfig config)

determineCapacityRange

private ProductionOptimizer.CapacityRange determineCapacityRange(ProcessEquipmentInterface unit,
 ProductionOptimizer.OptimizationConfig config)