Class BlackOilSeparator

java.lang.Object

neqsim.util.NamedBaseClass

neqsim.process.SimulationBaseClass

neqsim.process.equipment.ProcessEquipmentBaseClass

neqsim.process.equipment.blackoil.BlackOilSeparator

All Implemented Interfaces:

Serializable, Runnable, ProcessEquipmentInterface, ProcessElementInterface, SimulationInterface, NamedInterface

public class BlackOilSeparator
extends ProcessEquipmentBaseClass

Equilibrium Black-Oil separator at given (P_out, T_out).

Extends ProcessEquipmentBaseClass so it can be added to a ProcessSystem and participate in sequential flowsheet execution alongside compositional equipment.

Inlet and outlet fluids are represented as SystemBlackOil objects (not SystemInterface). Access them via getBlackOilInlet(), getOilOut(), getGasOut(), getWaterOut().

Version:

2.0

Author:

esol

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
private SystemBlackOil	gasOut
private SystemBlackOil	inlet
private BlackOilFlashResult	lastResult
private SystemBlackOil	oilOut
private double	outletPressure
private double	outletTemperature
private static final long	serialVersionUID	Serialization version UID.
private SystemBlackOil	waterOut

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
BlackOilSeparator(String name, SystemBlackOil inlet, double outletPressure, double outletTemperature)	Constructs a BlackOilSeparator.

Method Summary

Modifier and Type	Method	Description
SystemBlackOil	getBlackOilInlet()	Returns the inlet Black-Oil fluid.
SystemBlackOil	getGasOut()	Returns the gas outlet stream after separation.
BlackOilFlashResult	getLastFlashResult()	Returns the last flash result from the most recent run.
SystemBlackOil	getOilOut()	Returns the oil outlet stream after separation.
double	getOutletPressure()	Returns the separator outlet pressure.
double	getOutletTemperature()	Returns the separator outlet temperature.
Map<String,String>	getResultsMap()	Returns key results as a string map for reporting.
SystemBlackOil	getWaterOut()	Returns the water outlet stream after separation.
void	run(UUID id)	In this method all thermodynamic and unit operations will be calculated in a steady state calculation.
void	runSeparation()	Legacy run method for backward compatibility (no UUID tracking).
void	setInlet(SystemBlackOil inlet)	Sets the inlet Black-Oil fluid.
void	setOutletPressure(double outletPressure)	Sets the separator outlet pressure.
void	setOutletTemperature(double outletTemperature)	Sets the separator outlet temperature.
String	toJson()	Serializes the Process Equipment along with its state to a JSON string.

Methods inherited from class ProcessEquipmentBaseClass

addCapacityConstraint, addController, copy, displayResult, equals, getAvailableMargin, getAvailableMarginPercent, getBottleneckConstraint, getCapacityConstraints, getConditionAnalysisMessage, getConstraintEvaluationReport, getController, getController, getControllers, getEffectiveCapacityFactor, getEnergyStream, getEntropyProduction, getExergyChange, getFailureMode, getMassBalance, getMassBalance, getMaxUtilization, getMaxUtilizationPercent, getMechanicalDesign, getMinimumFlow, getPressure, getPressure, getProperty, getReferenceDesignation, getReport_json, getResultTable, getSpecification, getTemperature, getTemperature, getThermoSystem, getUtilizationSummary, hashCode, initElectricalDesign, initializeDefaultConstraints, initInstrumentDesign, initMechanicalDesign, isActive, isActive, isCapacityAnalysisEnabled, isCapacityExceeded, isFailed, isHardLimitExceeded, isNearCapacityLimit, isSetEnergyStream, reportResults, restoreFromFailure, run_step, runConditionAnalysis, setCapacityAnalysisEnabled, setController, setEnergyStream, setEnergyStream, setFailureMode, setFlowValveController, setMinimumFlow, setPressure, setReferenceDesignation, setRegulatorOutSignal, setSpecification, setTemperature, simulateDegradedOperation, simulateTrip, solved, toJson

Methods inherited from class SimulationBaseClass

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

Methods inherited from class NamedBaseClass

getName, getTagNumber, setName, setTagNumber

Methods inherited from class Object

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

Methods inherited from interface NamedInterface

getName, getTagName, getTagNumber, setName, setTagName, setTagNumber

Methods inherited from interface ProcessEquipmentInterface

getCapacityDuty, getCapacityMax, getElectricalDesign, getEquipmentState, getExergyChange, getExergyDestruction, getExergyDestruction, getFluid, getInletStreams, getInstrumentDesign, getOperatingEnvelopeViolation, getOutletFlowRate, getOutletPressure, getOutletStreams, getOutletTemperature, getReferenceDesignationString, getRestCapacity, getSimulationValidationErrors, isSimulationValid, isWithinOperatingEnvelope, needRecalculation, validateSetup

Methods inherited from interface SimulationInterface

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

Field Details

serialVersionUID

private static final long serialVersionUID

Serialization version UID.

See Also:

• Constant Field Values

inlet

private SystemBlackOil inlet

outletPressure

private double outletPressure

outletTemperature

private double outletTemperature

oilOut

private SystemBlackOil oilOut

gasOut

private SystemBlackOil gasOut

waterOut

private SystemBlackOil waterOut

lastResult

private BlackOilFlashResult lastResult

Constructor Details

BlackOilSeparator

public BlackOilSeparator(String name,
 SystemBlackOil inlet,
 double outletPressure,
 double outletTemperature)

Constructs a BlackOilSeparator.

Parameters:

name - equipment name used in the process system

inlet - the inlet Black-Oil fluid

outletPressure - separator outlet pressure in bar(a)

outletTemperature - separator outlet temperature in Kelvin

Method Details

setInlet

public void setInlet(SystemBlackOil inlet)

Sets the inlet Black-Oil fluid.

Parameters:

inlet - a SystemBlackOil object

getBlackOilInlet

public SystemBlackOil getBlackOilInlet()

Returns the inlet Black-Oil fluid.

Returns:

a SystemBlackOil object

getOilOut

public SystemBlackOil getOilOut()

Returns the oil outlet stream after separation.

Returns:

a SystemBlackOil object, or null if not yet run

getGasOut

public SystemBlackOil getGasOut()

Returns the gas outlet stream after separation.

Returns:

a SystemBlackOil object, or null if not yet run

getWaterOut

public SystemBlackOil getWaterOut()

Returns the water outlet stream after separation.

Returns:

a SystemBlackOil object, or null if not yet run

getLastFlashResult

public BlackOilFlashResult getLastFlashResult()

Returns the last flash result from the most recent run.

Returns:

a BlackOilFlashResult object, or null if not yet run

getOutletPressure

public double getOutletPressure()

Returns the separator outlet pressure.

Returns:

outlet pressure in bar(a)

setOutletPressure

public void setOutletPressure(double outletPressure)

Sets the separator outlet pressure.

Parameters:

outletPressure - outlet pressure in bar(a)

getOutletTemperature

public double getOutletTemperature()

Returns the separator outlet temperature.

Returns:

outlet temperature in Kelvin

setOutletTemperature

public void setOutletTemperature(double outletTemperature)

Sets the separator outlet temperature.

Parameters:

outletTemperature - outlet temperature in Kelvin

run

public void run(UUID id)

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

Parameters:

id - UUID

runSeparation

public void runSeparation()

Legacy run method for backward compatibility (no UUID tracking).

toJson

public String toJson()

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

Specified by:

toJson in interface ProcessEquipmentInterface

Overrides:

toJson in class ProcessEquipmentBaseClass

Returns:

json string.

getResultsMap

public Map<String,String> getResultsMap()

Returns key results as a string map for reporting.

Returns:

map of result name to value string