Class MultiStreamHeatExchanger

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.MultiStreamHeatExchanger

All Implemented Interfaces:

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

public class MultiStreamHeatExchanger
extends Heater
implements MultiStreamHeatExchangerInterface

MultiStreamHeatExchanger class.

Extends the Heater class to support multiple input and output streams, enabling the simulation of complex heat exchange processes such as those found in LNG heat exchangers.

Version:

1.0

Author:

ESOL

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
private double	deltaT
protected double	dT
private double	duty
private boolean	firstTime
private String	flowArrangement
private double	guessOutTemperature
private String	guessOutTemperatureUnit
private double	hotColdDutyBalance
private List<StreamInterface>	inStreams
(package private) int	iterations
(package private) static org.apache.logging.log4j.Logger	logger	Logger object for class.
(package private) int	MAX_ITERATIONS
private double	NTU
private List<StreamInterface>	outStreams
private int	outStreamSpecificationNumber
private static final long	serialVersionUID
private boolean	setTemperature
private SystemInterface	system
private double	temperatureApproach
protected double	temperatureOut
private double	thermalEffectiveness
private double	UAvalue
private boolean	UAvalueIsSet
private boolean	useDeltaT

Fields inherited from class Heater

coolingMediumTemperature, lastDuty, lastFlowRate, lastOutPressure, lastOutTemperature, lastPressure, lastPressureDrop, lastTemperature, mechanicalDesign, pressureOut, setOutPressure

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
MultiStreamHeatExchanger(String name)	Constructor for MultiStreamHeatExchanger.
MultiStreamHeatExchanger(String name, List<StreamInterface> inStreams)	Constructor for MultiStreamHeatExchanger with initial input streams.

Method Summary

Modifier and Type	Method	Description
void	addInStream(StreamInterface inStream)	Adds an inlet stream to the 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).
void	displayResult()	displayResult.
double	getDeltaT()	Retrieves the fixed temperature difference (ΔT) used in calculations.
double	getDuty()	getDuty.
double	getDuty(int streamNumber)	Calculates the heat duty for a specified stream in the multi-stream heat exchanger.
double	getEntropyProduction(String unit)	getEntropyProduction.
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.
double	getMassBalance(String unit)	getMassBalance.
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()	Getter for the field temperatureApproach.
double	getThermalEffectiveness()	Gets the thermal effectiveness of the heat exchanger.
double	getUAvalue()	Retrieves the overall heat transfer coefficient times area (UA value).
int	numerOfFeedStreams()	Returns the number of feed streams connected to the heat exchanger.
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	runConditionAnalysis(ProcessEquipmentInterface refExchanger)	runConditionAnalysis.
void	runSpecifiedStream(UUID id)	Runs the heat exchanger simulation using a specified stream approach.
void	setDeltaT(double deltaT)	Sets the fixed temperature difference (ΔT) for calculations and enables its usage.
void	setdT(double dT)	setdT.
void	setFeedStream(int index, StreamInterface inStream)	Sets the feed stream at a specific index.
void	setFlowArrangement(String flowArrangement)	Sets the flow arrangement of the heat exchanger.
void	setGuessOutTemperature(double guessOutTemperature)	Sets the guessed outlet temperature in Kelvin.
void	setGuessOutTemperature(double guessOutTemperature, String unit)	Sets the guessed outlet temperature with a specified unit.
void	setHotColdDutyBalance(double hotColdDutyBalance)	Sets the hot and cold duty balance of the heat exchanger.
void	setName(String name)	Setter for the field name.
void	setOutletTemperature(double temperature)	Set the outlet temperature of the heater.
void	setOutTemperature(double temperature)	Deprecated. use setOutletTemperature(double) instead
void	setTemperatureApproach(double temperatureApproach)	Setter for the field temperatureApproach.
void	setThermalEffectiveness(double thermalEffectiveness)	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 useDeltaT)	Enables or disables the use of a fixed temperature difference (ΔT) in calculations.
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.

Methods inherited from class Heater

addCapacityConstraint, autoSize, autoSize, autoSize, clearCapacityConstraints, getBottleneckConstraint, getCapacityConstraints, getCapacityDuty, getCapacityMax, getDuty, getEnergyInput, getExergyChange, getMaxDesignDuty, getMaxDesignDuty, getMaxOutletTemperature, getMaxOutletTemperature, getMaxUtilization, getMechanicalDesign, getMinOutletTemperature, getMinOutletTemperature, getPressureDrop, getSizingReport, getSizingReportJson, getUtilitySpecification, hasMaxOutletTemperatureLimit, hasMinOutletTemperatureLimit, initializeCapacityConstraints, initMechanicalDesign, isAutoSized, isCapacityExceeded, isHardLimitExceeded, isSetEnergyInput, needRecalculation, removeCapacityConstraint, runTransient, setDuty, setEnergyInput, setMaxDesignDuty, setMaxDesignDuty, setMaxOutletTemperature, setMaxOutletTemperature, setMinOutletTemperature, setMinOutletTemperature, setOutletPressure, setOutletPressure, setOutletTemperature, setOutStream, setOutTP, setPressureDrop, setSetEnergyInput, setUtilityApproachTemperature, setUtilityHeatCapacityRate, setUtilityOverallHeatTransferCoefficient, setUtilityReturnTemperature, setUtilitySpecification, setUtilitySupplyTemperature

Methods inherited from class TwoPortEquipment

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

Methods inherited from class ProcessEquipmentBaseClass

copy, equals, getConditionAnalysisMessage, getController, getEffectiveCapacityFactor, getEnergyStream, getFailureMode, getMassBalance, getMinimumFlow, getPressure, getPressure, getProperty, getReport_json, getResultTable, getSpecification, getTemperature, getTemperature, getThermoSystem, hashCode, isActive, isActive, isCapacityAnalysisEnabled, isFailed, isSetEnergyStream, reportResults, restoreFromFailure, run_step, setCapacityAnalysisEnabled, setController, setEnergyStream, setEnergyStream, setFailureMode, setFlowValveController, setMinimumFlow, setPressure, setRegulatorOutSignal, setSpecification, setTemperature, simulateDegradedOperation, simulateTrip, solved

Methods inherited from class SimulationBaseClass

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

Methods inherited from class NamedBaseClass

getName, getTagName, setTagName

Methods inherited from class Object

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

Methods inherited from interface CapacityConstrainedEquipment

disableAllConstraints, enableAllConstraints, getAvailableMargin, getAvailableMarginPercent, getMaxUtilizationPercent, getUtilizationSummary, isCapacityAnalysisEnabled, isNearCapacityLimit, setCapacityAnalysisEnabled

Methods inherited from interface NamedInterface

getName, getTagName, setTagName

Methods inherited from interface ProcessEquipmentInterface

equals, getCapacityDuty, getCapacityMax, getConditionAnalysisMessage, getController, getExergyChange, getExergyChange, getFluid, getMassBalance, getMechanicalDesign, getOperatingEnvelopeViolation, getPressure, getPressure, getReport_json, getRestCapacity, getResultTable, getSimulationValidationErrors, getSpecification, getTemperature, getTemperature, getThermoSystem, hashCode, initMechanicalDesign, isSimulationValid, isWithinOperatingEnvelope, 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, setOutPressure, setOutPressure, setOutTemperature

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.

setTemperature

private boolean setTemperature

outStreams

private List<StreamInterface> outStreams

inStreams

private List<StreamInterface> inStreams

system

private SystemInterface system

NTU

private double NTU

temperatureOut

protected double temperatureOut

dT

protected double dT

temperatureApproach

private double temperatureApproach

UAvalueIsSet

private boolean UAvalueIsSet

UAvalue

private double UAvalue

duty

private double duty

hotColdDutyBalance

private double hotColdDutyBalance

firstTime

private boolean firstTime

guessOutTemperature

private double guessOutTemperature

guessOutTemperatureUnit

private String guessOutTemperatureUnit

outStreamSpecificationNumber

private int outStreamSpecificationNumber

thermalEffectiveness

private double thermalEffectiveness

flowArrangement

private String flowArrangement

useDeltaT

private boolean useDeltaT

deltaT

private double deltaT

MAX_ITERATIONS

int MAX_ITERATIONS

iterations

int iterations

Constructor Details

MultiStreamHeatExchanger

public MultiStreamHeatExchanger(String name)

Constructor for MultiStreamHeatExchanger.

Parameters:

name - Name of the heat exchanger

MultiStreamHeatExchanger

public MultiStreamHeatExchanger(String name,
 List<StreamInterface> inStreams)

Constructor for MultiStreamHeatExchanger with initial input streams.

Parameters:

name - Name of the heat exchanger

inStreams - Initial list of input streams

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

setFeedStream

public void setFeedStream(int index,
 StreamInterface inStream)

Sets the feed stream at a specific index.

Specified by:

setFeedStream in interface MultiStreamHeatExchangerInterface

Parameters:

index - Index of the stream to set

inStream - Input stream to set at the specified index

setName

public void setName(String name)

Setter for the field name.

Specified by:

setName in interface NamedInterface

Overrides:

setName in class NamedBaseClass

Parameters:

name - a String object

setdT

public void setdT(double dT)

setdT.

Specified by:

setdT in interface HeaterInterface

Specified by:

setdT in interface MultiStreamHeatExchangerInterface

Overrides:

setdT in class Heater

Parameters:

dT - 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

setOutletTemperature

public void setOutletTemperature(double temperature)

Set the outlet temperature of the heater.

Specified by:

setOutletTemperature in interface MultiStreamHeatExchangerInterface

Specified by:

setOutletTemperature in interface TwoPortInterface

Overrides:

setOutletTemperature in class Heater

Parameters:

temperature - Temperature in Kelvin

setOutTemperature

@Deprecated
public void setOutTemperature(double temperature)

Deprecated.

use setOutletTemperature(double) instead

Set the outlet temperature of the heater.

Specified by:

setOutTemperature in interface MultiStreamHeatExchangerInterface

Specified by:

setOutTemperature in interface TwoPortInterface

Overrides:

setOutTemperature in class Heater

Parameters:

temperature - 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

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

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

getUAvalue

public double getUAvalue()

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

Specified by:

getUAvalue in interface MultiStreamHeatExchangerInterface

Returns:

UA value

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

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 guessOutTemperature)

Sets the guessed outlet temperature in Kelvin.

Specified by:

setGuessOutTemperature in interface MultiStreamHeatExchangerInterface

Parameters:

guessOutTemperature - Guessed outlet temperature

setGuessOutTemperature

public void setGuessOutTemperature(double guessOutTemperature,
 String unit)

Sets the guessed outlet temperature with a specified unit.

Specified by:

setGuessOutTemperature in interface MultiStreamHeatExchangerInterface

Parameters:

guessOutTemperature - Guessed outlet temperature

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

getEntropyProduction

public double getEntropyProduction(String unit)

getEntropyProduction.

Specified by:

getEntropyProduction in interface MultiStreamHeatExchangerInterface

Specified by:

getEntropyProduction in interface ProcessEquipmentInterface

Overrides:

getEntropyProduction in class Heater

Parameters:

unit - a String object

Returns:

a double

getMassBalance

public double getMassBalance(String unit)

getMassBalance.

Specified by:

getMassBalance in interface MultiStreamHeatExchangerInterface

Specified by:

getMassBalance in interface ProcessEquipmentInterface

Overrides:

getMassBalance in class TwoPortEquipment

Parameters:

unit - a String object

Returns:

a double

runConditionAnalysis

public void runConditionAnalysis(ProcessEquipmentInterface refExchanger)

runConditionAnalysis.

Specified by:

runConditionAnalysis in interface MultiStreamHeatExchangerInterface

Specified by:

runConditionAnalysis in interface ProcessEquipmentInterface

Overrides:

runConditionAnalysis in class ProcessEquipmentBaseClass

Parameters:

refExchanger - a ProcessEquipmentInterface object

runConditionAnalysis

public void runConditionAnalysis()

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

Specified by:

runConditionAnalysis in interface MultiStreamHeatExchangerInterface

getThermalEffectiveness

public double getThermalEffectiveness()

Gets the thermal effectiveness of the heat exchanger.

Specified by:

getThermalEffectiveness in interface MultiStreamHeatExchangerInterface

Returns:

Thermal effectiveness

setThermalEffectiveness

public void setThermalEffectiveness(double thermalEffectiveness)

Sets the thermal effectiveness of the heat exchanger.

Specified by:

setThermalEffectiveness in interface MultiStreamHeatExchangerInterface

Parameters:

thermalEffectiveness - Thermal effectiveness to set

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")

setFlowArrangement

public void setFlowArrangement(String flowArrangement)

Sets the flow arrangement of the heat exchanger.

Specified by:

setFlowArrangement in interface MultiStreamHeatExchangerInterface

Parameters:

flowArrangement - Name of the flow arrangement

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

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 hotColdDutyBalance)

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

Specified by:

setHotColdDutyBalance in interface MultiStreamHeatExchangerInterface

Parameters:

hotColdDutyBalance - Hot and cold duty balance to set

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

setUseDeltaT

public void setUseDeltaT(boolean useDeltaT)

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

Specified by:

setUseDeltaT in interface MultiStreamHeatExchangerInterface

Parameters:

useDeltaT - True to use ΔT, false otherwise

getDeltaT

public double getDeltaT()

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

Specified by:

getDeltaT in interface MultiStreamHeatExchangerInterface

Returns:

Temperature difference ΔT

setDeltaT

public void setDeltaT(double deltaT)

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

Specified by:

setDeltaT in interface MultiStreamHeatExchangerInterface

Parameters:

deltaT - Fixed temperature difference 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

runSpecifiedStream

public void runSpecifiedStream(UUID id)

Runs the heat exchanger simulation using a specified stream approach.

Parameters:

id - Unique identifier for the run

getTemperatureApproach

public double getTemperatureApproach()

Getter for the field temperatureApproach.

Returns:

a double

setTemperatureApproach

public void setTemperatureApproach(double temperatureApproach)

Setter for the field temperatureApproach.

Parameters:

temperatureApproach - a double

numerOfFeedStreams

public int numerOfFeedStreams()

Returns the number of feed streams connected to the heat exchanger.

Returns:

the number of input streams.

getDuty

public double getDuty(int streamNumber)

Calculates the heat duty for a specified stream in the multi-stream heat exchanger. The heat duty is determined as the difference in enthalpy between the outlet and inlet streams for the given stream index.

Parameters:

streamNumber - the index of the stream for which the heat duty is to be calculated. Must be less than the total number of input streams.

Returns:

the heat duty (in appropriate energy units) for the specified stream in W

Throws:

IndexOutOfBoundsException - if the specified stream index is out of bounds.