Class MultiStreamHeatExchanger2

java.lang.Object

neqsim.util.NamedBaseClass

neqsim.process.SimulationBaseClass

neqsim.process.equipment.ProcessEquipmentBaseClass

neqsim.process.equipment.TwoPortEquipment

neqsim.process.equipment.heatexchanger.Heater

neqsim.process.equipment.heatexchanger.MultiStreamHeatExchanger2

All Implemented Interfaces:

Serializable, Runnable, HeaterInterface, MultiStreamHeatExchangerInterface, ProcessEquipmentInterface, TwoPortInterface, SimulationInterface, NamedInterface

public class MultiStreamHeatExchanger2
extends Heater
implements MultiStreamHeatExchangerInterface

MultiStreamHeatExchanger2 class.

Author:

esol

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
private List<Double>	allLoad
private Double	approachTemperature
private double	coldLoad
private List<Double>	coldTempAll
private Map<String, List<Map<String,Object>>>	compositeCurvePoints
private double	damping
private final int	extremeAttempts
private final double	extremeEnergy
private final double	extremeUA
private List<SystemInterface>	fluidInlet
private List<Double>	hInlet
private double	hotLoad
private List<Double>	hotTempAll
private List<Double>	inletTemps
private List<StreamInterface>	inStreams
private double	jacobiDelta
private double	localRange
(package private) static org.apache.logging.log4j.Logger	logger	Logger object for class.
private List<Double>	massFlows
private int	maxIterations
private List<Double>	outletTemps
private List<StreamInterface>	outStreams
private List<Double>	pressures
private List<Double>	prevOutletTemps
private static final long	serialVersionUID
private static final String	SINGULAR_JACOBIAN_MSG	Message used when the Jacobian is singular.
private int	stallCounter
private final int	stallLimit
private List<Double>	streamLoads
private List<String>	streamTypes
private List<Double>	tempDiff
(package private) SystemInterface	thermoSystem
private double	tolerance
private Double	UA
private List<Object>	unknownOutlets

Fields inherited from class Heater

coolingMediumTemperature, dT, lastDuty, lastFlowRate, lastOutPressure, lastOutTemperature, lastPressure, lastPressureDrop, lastTemperature, mechanicalDesign, pressureOut, setOutPressure, setTemperature, system, temperatureOut

Fields inherited from class TwoPortEquipment

inStream, outStream

Fields inherited from class ProcessEquipmentBaseClass

conditionAnalysisMessage, energyStream, hasController, isSolved, properties, report

Fields inherited from class SimulationBaseClass

calcIdentifier, calculateSteadyState, time

Fields inherited from class NamedBaseClass

name

Constructor Summary

Constructors

Constructor	Description
MultiStreamHeatExchanger2(String name)	Constructor for MultiStreamHeatExchanger2.

Method Summary

Modifier and Type	Method	Description
void	addInStream(StreamInterface inStream)	Adds an inlet stream to the heat exchanger.
void	addInStreamMSHE(StreamInterface inStream, String streamType, Double outletTemp)	Adds an inlet stream to the multi-stream heat exchanger.
double	calcThermalEffectiveness(double NTU, double Cr)	Calculates the thermal effectiveness based on the Number of Transfer Units (NTU) and the capacity ratio (Cr).
private double	calculateIntervalTemp(double loadStart, double targetLoad, double loadEnd, double tempStart, double tempEnd)
double	calculateUA()	Calculates the overall heat transfer coefficient (UA) for the heat exchanger.
Map<String, List<Map<String,Object>>>	compositeCurve()	Calculates the composite curve data for the heat exchanger.
void	displayResult()	displayResult.
double	energyDiff()	Calculates the energy difference between the inlet and outlet streams.
private double	enthalpyTPFlash(int index, double pressure, double temperature)
Map<String, List<Map<String,Object>>>	getCompositeCurve()	Returns hot and cold composite curves.
double	getDeltaT()	Retrieves the fixed temperature difference (ΔT) used in calculations.
double	getDuty()	getDuty.
String	getFlowArrangement()	Retrieves the flow arrangement of the heat exchanger.
double	getGuessOutTemperature()	Retrieves the guessed outlet temperature used during initialization.
double	getHotColdDutyBalance()	Retrieves the hot and cold duty balance of the heat exchanger.
StreamInterface	getInStream(int i)	Retrieves the input stream at the specified index.
double	getInTemperature(int i)	Gets the inlet temperature of a specific input stream.
StreamInterface	getOutStream(int i)	Retrieves the output stream at the specified index.
double	getOutTemperature(int i)	Gets the outlet temperature of a specific output stream.
double	getTemperatureApproach()	getTemperatureApproach.
double	getThermalEffectiveness()	Gets the thermal effectiveness of the heat exchanger.
double	getUA()	getUA.
double	getUAvalue()	Retrieves the overall heat transfer coefficient times area (UA value).
private double	initializeOutletGuess(int i)
private double	interpolateTemperature(List<Map<String,Object>> points, double load)
private double	intervalLoad(int i, double tempStart, double tempEnd)
private double[]	linearSystemOneUnknown(double[][] A, double[] b)
private double[]	linearSystemThreeUnknowns(double[][] A, double[] b)
private double[]	linearSystemTwoUnknowns(double[][] A, double[] b)
private double[][]	numericalJacobiOneUnknown(List<Integer> unknownIndices)
private double[][]	numericalJacobiThreeUnknowns(List<Integer> unknownIndices)
private double[][]	numericalJacobiTwoUnknowns(List<Integer> unknownIndices)
void	oneUnknown()	Calculates the outlet temperatures for the heat exchanger when there is one unknown.
double	pinch()	Calculates the minimum approach temperature for the heat exchanger.
private void	resetOfExtremesAndStalls(List<Integer> unknownIndices, boolean localMin, boolean UATest)
private double[]	residualFunctionOneUnknown()
private double[]	residualFunctionThreeUnknowns()
private double[]	residualFunctionTwoUnknowns()
void	run(UUID id)	In this method all thermodynamic and unit operations will be calculated in a steady state calculation.
void	runConditionAnalysis()	Runs a condition analysis using the current heat exchanger as the reference.
void	setDeltaT(double dT)	Sets the fixed temperature difference (ΔT) for calculations and enables its usage.
void	setFeedStream(int index, StreamInterface stream)	Sets the feed stream at a specific index.
void	setFlowArrangement(String arrangement)	Sets the flow arrangement of the heat exchanger.
void	setGuessOutTemperature(double temp)	Sets the guessed outlet temperature in Kelvin.
void	setGuessOutTemperature(double temp, String unit)	Sets the guessed outlet temperature with a specified unit.
void	setHotColdDutyBalance(double value)	Sets the hot and cold duty balance of the heat exchanger.
void	setTemperatureApproach(double temperatureApproach)	setTemperatureApproach.
void	setThermalEffectiveness(double effectiveness)	Sets the thermal effectiveness of the heat exchanger.
void	setUAvalue(double UAvalue)	Sets the overall heat transfer coefficient times area (UA value).
void	setUseDeltaT(boolean use)	Enables or disables the use of a fixed temperature difference (ΔT) in calculations.
private boolean	stallDetection(List<Integer> unknownIndices)
void	threeUnknowns()	Calculates the outlet temperatures for the heat exchanger when there are three unknowns.
String	toJson()	Serializes the Process Equipment along with its state to a JSON string.
String	toJson(ReportConfig cfg)	Serializes the Process Equipment with configurable level of detail.
void	twoUnknowns()	Calculates the outlet temperatures for the heat exchanger when there are two unknowns.

Methods inherited from class Heater

getCapacityDuty, getCapacityMax, getDuty, getEnergyInput, getEntropyProduction, getExergyChange, getMechanicalDesign, getPressureDrop, getUtilitySpecification, initMechanicalDesign, isSetEnergyInput, needRecalculation, runTransient, setdT, setDuty, setEnergyInput, setOutPressure, setOutPressure, setOutStream, setOutTemperature, setOutTemperature, setOutTP, setPressureDrop, setSetEnergyInput, setUtilityApproachTemperature, setUtilityHeatCapacityRate, setUtilityOverallHeatTransferCoefficient, setUtilityReturnTemperature, setUtilitySpecification, setUtilitySupplyTemperature

Methods inherited from class TwoPortEquipment

getInletPressure, getInletStream, getInletTemperature, getMassBalance, getOutletPressure, getOutletStream, getOutletTemperature, setInletPressure, setInletStream, setInletTemperature, setOutletPressure, setOutletStream, setOutletTemperature, validateSetup

Methods inherited from class ProcessEquipmentBaseClass

copy, equals, getConditionAnalysisMessage, getController, getEnergyStream, getMassBalance, getMinimumFlow, getPressure, getPressure, getProperty, getReport_json, getResultTable, getSpecification, getTemperature, getTemperature, getThermoSystem, hashCode, isActive, isActive, isSetEnergyStream, reportResults, run_step, runConditionAnalysis, setController, setEnergyStream, setEnergyStream, setFlowValveController, setMinimumFlow, setPressure, setRegulatorOutSignal, setSpecification, setTemperature, solved

Methods inherited from class SimulationBaseClass

getCalculateSteadyState, getCalculationIdentifier, getTime, increaseTime, isRunInSteps, setCalculateSteadyState, setCalculationIdentifier, setRunInSteps, setTime

Methods inherited from class NamedBaseClass

getName, getTagName, setName, setTagName

Methods inherited from class Object

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

Methods inherited from interface MultiStreamHeatExchangerInterface

getEntropyProduction, getMassBalance, runConditionAnalysis, setdT, setOutTemperature

Methods inherited from interface NamedInterface

getName, getTagName, setName, setTagName

Methods inherited from interface ProcessEquipmentInterface

equals, getCapacityDuty, getCapacityMax, getConditionAnalysisMessage, getController, getExergyChange, getExergyChange, getFluid, getMassBalance, getMechanicalDesign, getPressure, getPressure, getReport_json, getRestCapacity, getResultTable, getSpecification, getTemperature, getTemperature, getThermoSystem, hashCode, initMechanicalDesign, needRecalculation, reportResults, setController, setPressure, setRegulatorOutSignal, setSpecification, setTemperature, validateSetup

Methods inherited from interface SimulationInterface

getCalculateSteadyState, getCalculationIdentifier, getTime, increaseTime, isRunInSteps, run, run_step, run_step, runTransient, runTransient, setCalculateSteadyState, setCalculationIdentifier, setRunInSteps, setTime, solved

Methods inherited from interface TwoPortInterface

getInStream, getOutStream

Field Details

serialVersionUID

private static final long serialVersionUID

See Also:

• Constant Field Values

logger

static org.apache.logging.log4j.Logger logger

Logger object for class.

thermoSystem

SystemInterface thermoSystem

tolerance

private double tolerance

maxIterations

private int maxIterations

jacobiDelta

private double jacobiDelta

SINGULAR_JACOBIAN_MSG

private static final String SINGULAR_JACOBIAN_MSG

Message used when the Jacobian is singular.

See Also:

• Constant Field Values

extremeEnergy

private final double extremeEnergy

See Also:

• Constant Field Values

extremeUA

private final double extremeUA

See Also:

• Constant Field Values

extremeAttempts

private final int extremeAttempts

See Also:

• Constant Field Values

prevOutletTemps

private List<Double> prevOutletTemps

stallCounter

private int stallCounter

stallLimit

private final int stallLimit

See Also:

• Constant Field Values

localRange

private double localRange

damping

private double damping

approachTemperature

private Double approachTemperature

UA

private Double UA

hotLoad

private double hotLoad

coldLoad

private double coldLoad

compositeCurvePoints

private Map<String, List<Map<String,Object>>> compositeCurvePoints

hInlet

private List<Double> hInlet

fluidInlet

private List<SystemInterface> fluidInlet

allLoad

private List<Double> allLoad

hotTempAll

private List<Double> hotTempAll

coldTempAll

private List<Double> coldTempAll

tempDiff

private List<Double> tempDiff

inStreams

private List<StreamInterface> inStreams

outStreams

private List<StreamInterface> outStreams

streamTypes

private List<String> streamTypes

inletTemps

private List<Double> inletTemps

outletTemps

private List<Double> outletTemps

unknownOutlets

private List<Object> unknownOutlets

pressures

private List<Double> pressures

massFlows

private List<Double> massFlows

streamLoads

private List<Double> streamLoads

Constructor Details

MultiStreamHeatExchanger2

public MultiStreamHeatExchanger2(String name)

Constructor for MultiStreamHeatExchanger2.

Parameters:

name - Name of the heat exchanger

Method Details

addInStream

public void addInStream(StreamInterface inStream)

Adds an inlet stream to the heat exchanger.

Specified by:

addInStream in interface MultiStreamHeatExchangerInterface

Parameters:

inStream - Input stream to be added

addInStreamMSHE

public void addInStreamMSHE(StreamInterface inStream,
 String streamType,
 Double outletTemp)

Adds an inlet stream to the multi-stream heat exchanger.

Parameters:

inStream - a StreamInterface object

streamType - a String object

outletTemp - a Double object

setTemperatureApproach

public void setTemperatureApproach(double temperatureApproach)

setTemperatureApproach.

Parameters:

temperatureApproach - a double

setUAvalue

public void setUAvalue(double UAvalue)

Sets the overall heat transfer coefficient times area (UA value).

Specified by:

setUAvalue in interface MultiStreamHeatExchangerInterface

Parameters:

UAvalue - UA value to set

run

public void run(UUID id)

In this method all thermodynamic and unit operations will be calculated in a steady state calculation.

Specified by:

run in interface SimulationInterface

Overrides:

run in class Heater

Parameters:

id - UUID

oneUnknown

public void oneUnknown()

Calculates the outlet temperatures for the heat exchanger when there is one unknown.

residualFunctionOneUnknown

private double[] residualFunctionOneUnknown()

numericalJacobiOneUnknown

private double[][] numericalJacobiOneUnknown(List<Integer> unknownIndices)

linearSystemOneUnknown

private double[] linearSystemOneUnknown(double[][] A,
 double[] b)

twoUnknowns

public void twoUnknowns()

Calculates the outlet temperatures for the heat exchanger when there are two unknowns.

residualFunctionTwoUnknowns

private double[] residualFunctionTwoUnknowns()

numericalJacobiTwoUnknowns

private double[][] numericalJacobiTwoUnknowns(List<Integer> unknownIndices)

linearSystemTwoUnknowns

private double[] linearSystemTwoUnknowns(double[][] A,
 double[] b)

threeUnknowns

public void threeUnknowns()

Calculates the outlet temperatures for the heat exchanger when there are three unknowns.

residualFunctionThreeUnknowns

private double[] residualFunctionThreeUnknowns()

numericalJacobiThreeUnknowns

private double[][] numericalJacobiThreeUnknowns(List<Integer> unknownIndices)

linearSystemThreeUnknowns

private double[] linearSystemThreeUnknowns(double[][] A,
 double[] b)

energyDiff

public double energyDiff()

Calculates the energy difference between the inlet and outlet streams.

Returns:

a double representing the total energy difference

pinch

public double pinch()

Calculates the minimum approach temperature for the heat exchanger.

Returns:

a double

calculateUA

public double calculateUA()

Calculates the overall heat transfer coefficient (UA) for the heat exchanger.

Returns:

the overall heat transfer coefficient (UA) value in W/K

enthalpyTPFlash

private double enthalpyTPFlash(int index,
 double pressure,
 double temperature)

compositeCurve

public Map<String, List<Map<String,Object>>> compositeCurve()

Calculates the composite curve data for the heat exchanger.

Returns:

a Map object

initializeOutletGuess

private double initializeOutletGuess(int i)

intervalLoad

private double intervalLoad(int i,
 double tempStart,
 double tempEnd)

calculateIntervalTemp

private double calculateIntervalTemp(double loadStart,
 double targetLoad,
 double loadEnd,
 double tempStart,
 double tempEnd)

interpolateTemperature

private double interpolateTemperature(List<Map<String,Object>> points,
 double load)

resetOfExtremesAndStalls

private void resetOfExtremesAndStalls(List<Integer> unknownIndices,
 boolean localMin,
 boolean UATest)

stallDetection

private boolean stallDetection(List<Integer> unknownIndices)

getCompositeCurve

public Map<String, List<Map<String,Object>>> getCompositeCurve()

Returns hot and cold composite curves.

Returns:

a Map object

getUA

public double getUA()

getUA.

Returns:

a double

getTemperatureApproach

public double getTemperatureApproach()

getTemperatureApproach.

Returns:

a double

getOutStream

public StreamInterface getOutStream(int i)

Retrieves the output stream at the specified index.

Specified by:

getOutStream in interface MultiStreamHeatExchangerInterface

Parameters:

i - Index of the output stream

Returns:

The output StreamInterface at the given index

getInStream

public StreamInterface getInStream(int i)

Retrieves the input stream at the specified index.

Specified by:

getInStream in interface MultiStreamHeatExchangerInterface

Parameters:

i - Index of the input stream

Returns:

The input StreamInterface at the given index

getInTemperature

public double getInTemperature(int i)

Gets the inlet temperature of a specific input stream.

Specified by:

getInTemperature in interface MultiStreamHeatExchangerInterface

Parameters:

i - Index of the input stream

Returns:

Inlet temperature in Kelvin

getOutTemperature

public double getOutTemperature(int i)

Gets the outlet temperature of a specific output stream.

Specified by:

getOutTemperature in interface MultiStreamHeatExchangerInterface

Parameters:

i - Index of the output stream

Returns:

Outlet temperature in Kelvin

getDuty

public double getDuty()

getDuty.

Specified by:

getDuty in interface MultiStreamHeatExchangerInterface

Overrides:

getDuty in class Heater

Returns:

a double

displayResult

public void displayResult()

displayResult.

Specified by:

displayResult in interface ProcessEquipmentInterface

Overrides:

displayResult in class Heater

runConditionAnalysis

public void runConditionAnalysis()

Runs a condition analysis using the current heat exchanger as the reference.

Specified by:

runConditionAnalysis in interface MultiStreamHeatExchangerInterface

getGuessOutTemperature

public double getGuessOutTemperature()

Retrieves the guessed outlet temperature used during initialization.

Specified by:

getGuessOutTemperature in interface MultiStreamHeatExchangerInterface

Returns:

Guessed outlet temperature

setGuessOutTemperature

public void setGuessOutTemperature(double temp)

Sets the guessed outlet temperature in Kelvin.

Specified by:

setGuessOutTemperature in interface MultiStreamHeatExchangerInterface

Parameters:

temp - Guessed outlet temperature

setGuessOutTemperature

public void setGuessOutTemperature(double temp,
 String unit)

Sets the guessed outlet temperature with a specified unit.

Specified by:

setGuessOutTemperature in interface MultiStreamHeatExchangerInterface

Parameters:

temp - Guessed outlet temperature

unit - Unit of the temperature (e.g., "K", "C")

setFlowArrangement

public void setFlowArrangement(String arrangement)

Sets the flow arrangement of the heat exchanger.

Specified by:

setFlowArrangement in interface MultiStreamHeatExchangerInterface

Parameters:

arrangement - Name of the flow arrangement

getFlowArrangement

public String getFlowArrangement()

Retrieves the flow arrangement of the heat exchanger.

Specified by:

getFlowArrangement in interface MultiStreamHeatExchangerInterface

Returns:

Flow arrangement as a String (e.g., "counterflow", "parallelflow")

setThermalEffectiveness

public void setThermalEffectiveness(double effectiveness)

Sets the thermal effectiveness of the heat exchanger.

Specified by:

setThermalEffectiveness in interface MultiStreamHeatExchangerInterface

Parameters:

effectiveness - Thermal effectiveness to set

getThermalEffectiveness

public double getThermalEffectiveness()

Gets the thermal effectiveness of the heat exchanger.

Specified by:

getThermalEffectiveness in interface MultiStreamHeatExchangerInterface

Returns:

Thermal effectiveness

getHotColdDutyBalance

public double getHotColdDutyBalance()

Retrieves the hot and cold duty balance of the heat exchanger.

Specified by:

getHotColdDutyBalance in interface MultiStreamHeatExchangerInterface

Returns:

Hot and cold duty balance

setHotColdDutyBalance

public void setHotColdDutyBalance(double value)

Sets the hot and cold duty balance of the heat exchanger.

Specified by:

setHotColdDutyBalance in interface MultiStreamHeatExchangerInterface

Parameters:

value - Hot and cold duty balance to set

calcThermalEffectiveness

public double calcThermalEffectiveness(double NTU,
 double Cr)

Calculates the thermal effectiveness based on the Number of Transfer Units (NTU) and the capacity ratio (Cr).

Specified by:

calcThermalEffectiveness in interface MultiStreamHeatExchangerInterface

Parameters:

NTU - Number of Transfer Units

Cr - Capacity ratio (Cmin/Cmax)

Returns:

Calculated thermal effectiveness

setUseDeltaT

public void setUseDeltaT(boolean use)

Enables or disables the use of a fixed temperature difference (ΔT) in calculations.

Specified by:

setUseDeltaT in interface MultiStreamHeatExchangerInterface

Parameters:

use - True to use ΔT, false otherwise

setFeedStream

public void setFeedStream(int index,
 StreamInterface stream)

Sets the feed stream at a specific index.

Specified by:

setFeedStream in interface MultiStreamHeatExchangerInterface

Parameters:

index - Index of the stream to set

stream - Input stream to set at the specified index

setDeltaT

public void setDeltaT(double dT)

Sets the fixed temperature difference (ΔT) for calculations and enables its usage.

Specified by:

setDeltaT in interface MultiStreamHeatExchangerInterface

Parameters:

dT - Fixed temperature difference to set

getDeltaT

public double getDeltaT()

Retrieves the fixed temperature difference (ΔT) used in calculations.

Specified by:

getDeltaT in interface MultiStreamHeatExchangerInterface

Returns:

Temperature difference ΔT

getUAvalue

public double getUAvalue()

Retrieves the overall heat transfer coefficient times area (UA value).

Specified by:

getUAvalue in interface MultiStreamHeatExchangerInterface

Returns:

UA value

toJson

public String toJson()

Serializes the Process Equipment along with its state to a JSON string.

Specified by:

toJson in interface MultiStreamHeatExchangerInterface

Specified by:

toJson in interface ProcessEquipmentInterface

Overrides:

toJson in class Heater

Returns:

json string.

toJson

public String toJson(ReportConfig cfg)

Serializes the Process Equipment with configurable level of detail.

Specified by:

toJson in interface MultiStreamHeatExchangerInterface

Specified by:

toJson in interface ProcessEquipmentInterface

Overrides:

toJson in class Heater

Parameters:

cfg - report configuration

Returns:

json string