Class BatchStudy

java.lang.Object

neqsim.process.util.optimization.BatchStudy

All Implemented Interfaces:

Serializable

public class BatchStudy
extends Object
implements Serializable

Parallel parameter study for rapid concept screening.

This class enables cloud-scale batch simulations by:

• Parameter Variation: Define ranges for design variables
• Parallel Execution: Run thousands of cases concurrently
• Multi-Objective Ranking: Compare by CAPEX, OPEX, emissions, etc.
• Result Aggregation: Collect and analyze results efficiently

Usage Example:

ProcessSystem baseCase = new ProcessSystem();
// ... configure base case ...

BatchStudy study = BatchStudy.builder(baseCase).vary("heater.duty", 1.0e6, 5.0e6, 5) // 5 values
    .vary("compressor.pressure", 30.0, 80.0, 6) // 6 values
    .addObjective("power", Objective.MINIMIZE).addObjective("throughput", Objective.MAXIMIZE)
    .parallelism(8).build();

BatchStudyResult result = study.run();

System.out.println("Total cases: " + result.getTotalCases());
System.out.println("Best case: " + result.getBestCase("power"));

result.exportToCSV("batch_results.csv");

Version:

1.0

Author:

ESOL

See Also:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	BatchStudy.BatchStudyResult	Results of a batch study.
static class	BatchStudy.Builder	Builder for BatchStudy.
static class	BatchStudy.CaseResult	Result of a single case.
static enum	BatchStudy.Objective	Optimization direction.
static class	BatchStudy.ObjectiveDefinition	Definition of an objective.
static class	BatchStudy.ParameterSet	A set of parameter values for one case.
private static class	BatchStudy.ParameterVariation	Definition of a parameter variation.

Field Summary

Fields

Modifier and Type	Field	Description
private final ProcessSystem	baseCase
private final Map<String, Function<ProcessSystem, Double>>	objectiveExtractors
private final Map<String, BatchStudy.ObjectiveDefinition>	objectives
private int	parallelism
private static final long	serialVersionUID
private boolean	stopOnFailure
private String	studyName
private final List<BatchStudy.ParameterVariation>	variations

Constructor Summary

Constructors

Modifier	Constructor	Description
private	BatchStudy(BatchStudy.Builder builder)

Method Summary

Modifier and Type	Method	Description
private void	applyParameter(ProcessSystem process, String paramPath, double value)
static BatchStudy.Builder	builder(ProcessSystem baseCase)	Creates a builder for a batch study.
private List<BatchStudy.ParameterSet>	generateAllCases()
private void	generateCasesRecursive(List<BatchStudy.ParameterSet> cases, Map<String,Double> currentValues, int varIndex)
int	getTotalCases()	Gets the total number of cases to be run.
BatchStudy.BatchStudyResult	run()	Runs the batch study.
private BatchStudy.CaseResult	runCase(BatchStudy.ParameterSet params)

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

baseCase

private final ProcessSystem baseCase

variations

private final List<BatchStudy.ParameterVariation> variations

objectives

private final Map<String, BatchStudy.ObjectiveDefinition> objectives

objectiveExtractors

private final Map<String, Function<ProcessSystem, Double>> objectiveExtractors

parallelism

private int parallelism

studyName

private String studyName

stopOnFailure

private boolean stopOnFailure

Constructor Details

BatchStudy

private BatchStudy(BatchStudy.Builder builder)

Method Details

builder

public static BatchStudy.Builder builder(ProcessSystem baseCase)

Creates a builder for a batch study.

Parameters:

baseCase - the base process system to vary

Returns:

a new builder

run

public BatchStudy.BatchStudyResult run()

Runs the batch study.

Returns:

results of all cases

generateAllCases

private List<BatchStudy.ParameterSet> generateAllCases()

generateCasesRecursive

private void generateCasesRecursive(List<BatchStudy.ParameterSet> cases,
 Map<String,Double> currentValues,
 int varIndex)

runCase

private BatchStudy.CaseResult runCase(BatchStudy.ParameterSet params)

applyParameter

private void applyParameter(ProcessSystem process,
 String paramPath,
 double value)

getTotalCases

public int getTotalCases()

Gets the total number of cases to be run.

Returns:

case count