+ * 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. + * + * @author [Your Name] + * @version 1.0 + */ +public class MultiStreamHeatExchanger extends Heater implements MultiStreamHeatExchangerInterface { + private static final long serialVersionUID = 1001; + static Logger logger = LogManager.getLogger(MultiStreamHeatExchanger.class); + + private boolean setTemperature = false; + private List+ * MultiStreamHeatExchangerInterface interface. + *
+ * + * Defines the contract for a multi-stream heat exchanger, enabling the simulation and management of + * multiple input and output streams. This interface extends the {@link ProcessEquipmentInterface} + * to integrate with the broader NeqSim process simulation framework. + * + *+ * Implementations of this interface should handle the addition and management of multiple streams, + * perform energy and mass balance calculations, and provide methods to analyze the performance and + * condition of the heat exchanger. + *
+ * + * @author + * @version 1.0 + */ +public interface MultiStreamHeatExchangerInterface extends ProcessEquipmentInterface { + + // ================================ + // Stream Management Methods + // ================================ + + /** + * Adds an inlet stream to the heat exchanger. + * + * @param inStream Input stream to be added + */ + void addInStream(StreamInterface inStream); + + /** + * Sets the feed stream at a specific index. + * + * @param index Index of the stream to set + * @param inStream Input stream to set at the specified index + * @throws IndexOutOfBoundsException if the index is out of range + */ + void setFeedStream(int index, StreamInterface inStream); + + /** + * Retrieves the output stream at the specified index. + * + * @param index Index of the output stream + * @return The output {@link StreamInterface} at the given index + * @throws IndexOutOfBoundsException if the index is out of range + */ + StreamInterface getOutStream(int index); + + /** + * Retrieves the input stream at the specified index. + * + * @param index Index of the input stream + * @return The input {@link StreamInterface} at the given index + * @throws IndexOutOfBoundsException if the index is out of range + */ + StreamInterface getInStream(int index); + + // ================================ + // Temperature Control Methods + // ================================ + + /** + * Sets the outlet temperature for the heat exchanger. + * + * @param temperature Desired outlet temperature + */ + void setOutTemperature(double temperature); + + /** + * Gets the outlet temperature of a specific output stream. + * + * @param index Index of the output stream + * @return Outlet temperature in Kelvin + */ + double getOutTemperature(int index); + + /** + * Gets the inlet temperature of a specific input stream. + * + * @param index Index of the input stream + * @return Inlet temperature in Kelvin + */ + double getInTemperature(int index); + + /** + * Sets the temperature difference (ΔT) for the heat exchanger calculations. + * + * @param dT Temperature difference to set + */ + void setdT(double dT); + + /** + * Enables or disables the use of a fixed temperature difference (ΔT) in calculations. + * + * @param useDeltaT True to use ΔT, false otherwise + */ + void setUseDeltaT(boolean useDeltaT); + + /** + * Sets the fixed temperature difference (ΔT) for calculations and enables its usage. + * + * @param deltaT Fixed temperature difference to set + */ + void setDeltaT(double deltaT); + + /** + * Retrieves the fixed temperature difference (ΔT) used in calculations. + * + * @return Temperature difference ΔT + */ + double getDeltaT(); + + // ================================ + // Thermodynamic and Energy Methods + // ================================ + + /** + * Calculates and retrieves the thermal effectiveness of the heat exchanger. + * + * @return Thermal effectiveness + */ + double getThermalEffectiveness(); + + /** + * Sets the thermal effectiveness of the heat exchanger. + * + * @param thermalEffectiveness Thermal effectiveness to set + */ + void setThermalEffectiveness(double thermalEffectiveness); + + /** + * Calculates the thermal effectiveness based on the Number of Transfer Units (NTU) and the + * capacity ratio (Cr). + * + * @param NTU Number of Transfer Units + * @param Cr Capacity ratio (Cmin/Cmax) + * @return Calculated thermal effectiveness + */ + double calcThermalEffectiveness(double NTU, double Cr); + + /** + * Retrieves the overall heat transfer coefficient times area (UA value). + * + * @return UA value + */ + double getUAvalue(); + + /** + * Sets the overall heat transfer coefficient times area (UA value). + * + * @param UAvalue UA value to set + */ + void setUAvalue(double UAvalue); + + /** + * Retrieves the hot and cold duty balance of the heat exchanger. + * + * @return Hot and cold duty balance + */ + double getHotColdDutyBalance(); + + /** + * Sets the hot and cold duty balance of the heat exchanger. + * + * @param hotColdDutyBalance Hot and cold duty balance to set + */ + void setHotColdDutyBalance(double hotColdDutyBalance); + + // ================================ + // Duty and Balance Methods + // ================================ + + /** + * Retrieves the duty (heat transfer) of the heat exchanger. + * + * @return Duty in appropriate units + */ + double getDuty(); + + /** + * Retrieves the mass balance of the heat exchanger. + * + * @param unit Unit of mass flow rate (e.g., "kg/sec") + * @return Mass balance value + */ + double getMassBalance(String unit); + + /** + * Retrieves the entropy production of the heat exchanger. + * + * @param unit Unit of entropy (e.g., "J/(kg*K)") + * @return Entropy production value + */ + double getEntropyProduction(String unit); + + // ================================ + // Flow Arrangement Methods + // ================================ + + /** + * Retrieves the flow arrangement of the heat exchanger. + * + * @return Flow arrangement as a String (e.g., "counterflow", "parallelflow") + */ + String getFlowArrangement(); + + /** + * Sets the flow arrangement of the heat exchanger. + * + * @param flowArrangement Name of the flow arrangement + */ + void setFlowArrangement(String flowArrangement); + + // ================================ + // Condition Analysis Methods + // ================================ + + /** + * Runs a condition analysis by comparing the current heat exchanger with a reference exchanger. + * + * @param refExchanger Reference {@link ProcessEquipmentInterface} heat exchanger for comparison + */ + void runConditionAnalysis(ProcessEquipmentInterface refExchanger); + + /** + * Runs a condition analysis using the current heat exchanger as the reference. + */ + void runConditionAnalysis(); + + // ================================ + // Guess Temperature Methods + // ================================ + + /** + * Retrieves the guessed outlet temperature used during initialization. + * + * @return Guessed outlet temperature + */ + double getGuessOutTemperature(); + + /** + * Sets the guessed outlet temperature in Kelvin. + * + * @param guessOutTemperature Guessed outlet temperature + */ + void setGuessOutTemperature(double guessOutTemperature); + + /** + * Sets the guessed outlet temperature with a specified unit. + * + * @param guessOutTemperature Guessed outlet temperature + * @param unit Unit of the temperature (e.g., "K", "C") + */ + void setGuessOutTemperature(double guessOutTemperature, String unit); + + // ================================ + // JSON Serialization Methods + // ================================ + + /** + * Serializes the heat exchanger's state to a JSON string. + * + * @return JSON representation of the heat exchanger + */ + String toJson(); + + // ================================ + // Additional Methods + // ================================ + + /** + * Runs the heat exchanger simulation with a unique identifier. + * + * @param id Unique identifier for the simulation run + */ + void run(UUID id); + + /** + * Displays the results of the heat exchanger simulation. Typically outputs temperatures, + * pressures, flow rates, etc. + */ + void displayResult(); +} diff --git a/src/test/java/neqsim/process/equipment/heatexchanger/MultiStreamHeatExchangerTest.java b/src/test/java/neqsim/process/equipment/heatexchanger/MultiStreamHeatExchangerTest.java new file mode 100644 index 0000000000..6648eaddb8 --- /dev/null +++ b/src/test/java/neqsim/process/equipment/heatexchanger/MultiStreamHeatExchangerTest.java @@ -0,0 +1,69 @@ +package neqsim.process.equipment.heatexchanger; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import org.apache.logging.log4j.LogManager; +import org.apache.logging.log4j.Logger; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; +import neqsim.process.equipment.stream.Stream; +import neqsim.thermodynamicoperations.ThermodynamicOperations; + +public class MultiStreamHeatExchangerTest { + static Logger logger = LogManager.getLogger(MultiStreamHeatExchangerTest.class); + + static neqsim.thermo.system.SystemInterface testSystem; + Stream gasStream; + + @BeforeEach + void setUp() { + testSystem = new neqsim.thermo.system.SystemSrkEos((273.15 + 60.0), 20.00); + testSystem.addComponent("methane", 120.00); + testSystem.addComponent("ethane", 120.0); + testSystem.addComponent("n-heptane", 3.0); + testSystem.createDatabase(true); + testSystem.setMixingRule(2); + ThermodynamicOperations testOps = new ThermodynamicOperations(testSystem); + testOps.TPflash(); + } + + + @Test + void testRun1() { + Stream stream_Hot = new Stream("Stream1", testSystem); + stream_Hot.setTemperature(100.0, "C"); + stream_Hot.setFlowRate(1000.0, "kg/hr"); + + Stream stream_Cold = new Stream("Stream2", testSystem.clone()); + stream_Cold.setTemperature(20.0, "C"); + stream_Cold.setFlowRate(310.0, "kg/hr"); + + Stream stream_Cold2 = new Stream("Stream3", testSystem.clone()); + stream_Cold2.setTemperature(0.0, "C"); + stream_Cold2.setFlowRate(50.0, "kg/hr"); + + MultiStreamHeatExchanger heatEx = new MultiStreamHeatExchanger("heatEx"); + heatEx.addInStream(stream_Hot); + heatEx.addInStream(stream_Cold); + heatEx.addInStream(stream_Cold2); + heatEx.setTemperatureApproach(5.0); + + + neqsim.process.processmodel.ProcessSystem operations = + new neqsim.process.processmodel.ProcessSystem(); + operations.add(stream_Hot); + operations.add(stream_Cold); + operations.add(stream_Cold2); + operations.add(heatEx); + + operations.run(); + + assertEquals(95, heatEx.getOutStream(1).getTemperature("C"), 1e-3); + assertEquals(95, heatEx.getOutStream(2).getTemperature("C"), 1e-3); + assertEquals(70.5921794735, heatEx.getOutStream(0).getTemperature("C"), 1e-3); + + } + + + +} +