Class ThreePhaseSeparator

java.lang.Object

neqsim.util.NamedBaseClass

neqsim.process.SimulationBaseClass

neqsim.process.equipment.ProcessEquipmentBaseClass

neqsim.process.equipment.separator.Separator

neqsim.process.equipment.separator.ThreePhaseSeparator

All Implemented Interfaces:

Serializable, Runnable, AutoSizeable, CapacityConstrainedEquipment, ProcessEquipmentInterface, SeparatorInterface, StateVectorProvider, SimulationInterface, NamedInterface

public class ThreePhaseSeparator
extends Separator

ThreePhaseSeparator class.

Version:

$Id: $Id

Author:

Even Solbraa

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class Separator

Separator.Builder

Field Summary

Fields

Modifier and Type	Field	Description
(package private) double	aqueousInGas
(package private) String	aqueousInGasSpec
(package private) double	aqueousInOil
(package private) String	aqueousInOilSpec
(package private) double	gasInAqueous
(package private) String	gasInAqueousSpec
(package private) double	gasInOil
(package private) String	gasInOilSpec
private double	gasOutletFlowFraction	Gas outlet valve flow fraction (0.0 = fully closed, 1.0 = fully open).
private double	lastEnthalpy
private double	lastFlowRate
private double	lastPressure
(package private) static org.apache.logging.log4j.Logger	logger	Logger object for class.
(package private) double	oilInAqueous
(package private) String	oilInAqueousSpec
(package private) double	oilInGas
(package private) String	oilInGasSpec
private double	oilLevel	Oil level height in meters (bottom of separator to top of oil phase).
private double	oilOutletFlowFraction	Oil outlet valve flow fraction (0.0 = fully closed, 1.0 = fully open).
private static final long	serialVersionUID	Serialization version UID.
(package private) String	specifiedStream
(package private) boolean	useTempMultiPhaseCheck
private double	waterLevel	Water level height in meters (bottom of separator to water-oil interface).
private double	waterOutletFlowFraction	Water outlet valve flow fraction (0.0 = fully closed, 1.0 = fully open).
(package private) StreamInterface	waterOutStream

Fields inherited from class Separator

DEFAULT_DROPLET_CUTSIZE_LIMIT, DEFAULT_INLET_MOMENTUM_LIMIT, DEFAULT_K_VALUE_LIMIT, DEFAULT_LIQUID_DENSITY_FOR_SIZING, DEFAULT_MIN_OIL_RETENTION_TIME, DEFAULT_MIN_WATER_RETENTION_TIME, gasOutStream, gasSystem, gasVolume, inletStreamMixer, isInitTransient, liquidLevel, liquidOutStream, liquidSystem, liquidVolume, numberOfInputStreams, separatorMechanicalDesign, separatorSection, thermoSystem, thermoSystem2, thermoSystemCloned, waterSystem

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
ThreePhaseSeparator(String name)	Constructor for ThreePhaseSeparator.
ThreePhaseSeparator(String name, StreamInterface inletStream)	Constructor for ThreePhaseSeparator.

Method Summary

Modifier and Type	Method	Description
double	calcInterfaceSettlingTime()	Calculate the oil-water interface settling time.
double	calcOilRetentionTime()	Calculate oil retention time between NIL and NLL.
double	calcWaterRetentionTime()	Calculate water retention time below NIL.
void	displayResult()	displayResult.
double	getEntropyProduction(String unit)	getEntropyProduction.
double	getExergyChange(String unit, double surroundingTemperature)	Get exergy change production of the process equipment.
double	getGasOutletFlowFraction()	Get the gas outlet valve flow fraction.
double	getMassBalance(String unit)	getMassBalance.
double	getOilLevel()	Get the oil level (height from bottom of separator to top of oil phase).
double	getOilOutletFlowFraction()	Get the oil outlet valve flow fraction.
StreamInterface	getOilOutStream()	getOilOutStream.
double	getOilThickness()	Get the oil phase thickness (oil level minus water level).
String	getPerformanceSummary()	Get a summary of all performance parameters with limit checks.
double	getWaterLevel()	Get the water level (height from bottom of separator to water-oil interface).
double	getWaterOutletFlowFraction()	Get the water outlet valve flow fraction.
StreamInterface	getWaterOutStream()	Getter for the field waterOutStream.
void	initializeTransientCalculation()	Initializes three-phase separator for transient calculations.
boolean	isWithinAllLimits()	Check if all separator performance parameters are within limits.
void	run(UUID id)	In this method all thermodynamic and unit operations will be calculated in a steady state calculation.
void	runTransient(double dt, UUID id)	runTransient
void	setEntrainment(double val, String specType, String specifiedStream, String phaseFrom, String phaseTo)	setEntrainment.
void	setGasOutletFlowFraction(double fraction)	Set the gas outlet valve flow fraction (simulates valve position).
void	setInletStream(StreamInterface inletStream)	setInletStream.
void	setOilLevel(double level)	Set the oil level (height from bottom of separator to top of oil phase).
void	setOilOutletFlowFraction(double fraction)	Set the oil outlet valve flow fraction (simulates valve position).
void	setTempPres(double temp, double pres)	setTempPres.
void	setWaterLevel(double level)	Set the water level (height from bottom of separator to water-oil interface).
void	setWaterOutletFlowFraction(double fraction)	Set the water outlet valve flow fraction (simulates valve position).
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.
private void	updateLiquidLevelFromWaterAndOil()	Updates the parent class liquidLevel based on water and oil levels.
private void	updateWaterAndOilLevelsFromPhases()	Updates water and oil levels from phase volumes in the thermodynamic system.

Methods inherited from class Separator

addCapacityConstraint, addSeparatorSection, addStream, autoSize, autoSize, autoSize, builder, calcDropletCutSize, calcDropletCutSizeAtHLL, calcGasAreaAboveLevel, calcGasVelocityAboveLevel, calcInletMomentumFlux, calcInletMomentumFlux, calcKValue, calcKValueAtHLL, calcLiquidVolume, calcSegmentArea, clearCapacityConstraints, disableConstraint, disableConstraints, enableConstraints, enforceHeadspace, equals, evaluateFireExposure, evaluateFireExposure, getBottleneckConstraint, getCapacityConstraints, getCapacityDuty, getCapacityMax, getCapacityUtilization, getConstraintSummary, getDeRatedGasLoadFactor, getDeRatedGasLoadFactor, getDesignGasLoadFactor, getDesignLiquidLevelFraction, getEfficiency, getEnabledConstraintNames, getExergyChange, getFeedStream, getGas, getGasCarryunderFraction, getGasLoadFactor, getGasLoadFactor, getGasOutStream, getGasSuperficialVelocity, getHeatDuty, getHeatDuty, getHeatInput, getHeatInput, getInnerSurfaceArea, getInternalDiameter, getLiquid, getLiquidCarryoverFraction, getLiquidLevel, getLiquidOutStream, getMaxAllowableGasFlowRate, getMaxAllowableGasVelocity, getMaxUtilization, getMechanicalDesign, getOperatingEnvelopeViolation, getOrientation, getPressure, getPressureDrop, getResultTable, getSeparatorLength, getSeparatorSection, getSeparatorSection, getSeparatorSections, getSimulationValidationErrors, getSizingReport, getSizingReportJson, getStateVector, getThermoSystem, getUnwettedArea, getWettedArea, hashCode, initDesignFromFlow, initializeCapacityConstraints, initMechanicalDesign, isAutoSized, isCapacityExceeded, isConstraintEnabled, isDropletCutSizeWithinLimit, isDropletCutSizeWithinLimit, isEnforceCapacityLimits, isHardLimitExceeded, isInletMomentumWithinLimit, isInletMomentumWithinLimit, isKValueWithinLimit, isKValueWithinLimit, isOilRetentionTimeAboveMinimum, isOilRetentionTimeAboveMinimum, isOverloaded, isSetHeatInput, isSimulationValid, isSinglePhase, isWaterRetentionTimeAboveMinimum, isWaterRetentionTimeAboveMinimum, isWithinOperatingEnvelope, levelFromVolume, liquidArea, removeCapacityConstraint, setDesignGasLoadFactor, setDesignLiquidLevelFraction, setDropletCutSizeLimit, setDuty, setDuty, setEfficiency, setEnforceCapacityLimits, setGasCarryunderFraction, setHeatDuty, setHeatDuty, setHeatInput, setHeatInput, setInletMomentumLimit, setInternalDiameter, setKValueLimit, setLiquidCarryoverFraction, setLiquidLevel, setMinOilRetentionTime, setMinWaterRetentionTime, setOrientation, setPressureDrop, setSeparatorLength, sizeFromFlow, useAllConstraints, useAPIConstraints, useConstraints, useEquinorConstraints, useGasCapacityConstraints, useGasScrubberConstraints, useLiquidCapacityConstraints, validateSetup

Methods inherited from class ProcessEquipmentBaseClass

copy, getConditionAnalysisMessage, getController, getEffectiveCapacityFactor, getEnergyStream, getFailureMode, getMassBalance, getMinimumFlow, getPressure, getProperty, getReport_json, getSpecification, getTemperature, getTemperature, isActive, isActive, isCapacityAnalysisEnabled, isFailed, isSetEnergyStream, reportResults, restoreFromFailure, run_step, runConditionAnalysis, 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, setName, 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, setName, setTagName

Methods inherited from interface ProcessEquipmentInterface

getFluid, getRestCapacity, needRecalculation

Methods inherited from interface SimulationInterface

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

Methods inherited from interface StateVectorProvider

getStateDimension, getStateNames

Field Details

serialVersionUID

private static final long serialVersionUID

Serialization version UID.

See Also:

• Constant Field Values

logger

static org.apache.logging.log4j.Logger logger

Logger object for class.

waterOutStream

StreamInterface waterOutStream

specifiedStream

String specifiedStream

gasInAqueous

double gasInAqueous

gasInAqueousSpec

String gasInAqueousSpec

gasInOil

double gasInOil

gasInOilSpec

String gasInOilSpec

oilInGas

double oilInGas

oilInGasSpec

String oilInGasSpec

oilInAqueous

double oilInAqueous

oilInAqueousSpec

String oilInAqueousSpec

aqueousInGas

double aqueousInGas

aqueousInGasSpec

String aqueousInGasSpec

aqueousInOil

double aqueousInOil

aqueousInOilSpec

String aqueousInOilSpec

useTempMultiPhaseCheck

boolean useTempMultiPhaseCheck

lastEnthalpy

private double lastEnthalpy

lastFlowRate

private double lastFlowRate

lastPressure

private double lastPressure

waterLevel

private double waterLevel

Water level height in meters (bottom of separator to water-oil interface).

oilLevel

private double oilLevel

Oil level height in meters (bottom of separator to top of oil phase).

gasOutletFlowFraction

private double gasOutletFlowFraction

Gas outlet valve flow fraction (0.0 = fully closed, 1.0 = fully open).

oilOutletFlowFraction

private double oilOutletFlowFraction

Oil outlet valve flow fraction (0.0 = fully closed, 1.0 = fully open).

waterOutletFlowFraction

private double waterOutletFlowFraction

Water outlet valve flow fraction (0.0 = fully closed, 1.0 = fully open).

Constructor Details

ThreePhaseSeparator

public ThreePhaseSeparator(String name)

Constructor for ThreePhaseSeparator.

Parameters:

name - name of separator

ThreePhaseSeparator

public ThreePhaseSeparator(String name,
 StreamInterface inletStream)

Constructor for ThreePhaseSeparator.

Parameters:

name - a String object

inletStream - a StreamInterface object

Method Details

setEntrainment

public void setEntrainment(double val,
 String specType,
 String specifiedStream,
 String phaseFrom,
 String phaseTo)

setEntrainment.

Overrides:

setEntrainment in class Separator

Parameters:

val - a double

specType - a String object

specifiedStream - a String object

phaseFrom - a String object

phaseTo - a String object

setInletStream

public void setInletStream(StreamInterface inletStream)

setInletStream.

Overrides:

setInletStream in class Separator

Parameters:

inletStream - a StreamInterface object

getWaterOutStream

public StreamInterface getWaterOutStream()

Getter for the field waterOutStream.

Returns:

a StreamInterface object

getOilOutStream

public StreamInterface getOilOutStream()

getOilOutStream.

Returns:

a StreamInterface object

setWaterLevel

public void setWaterLevel(double level)

Set the water level (height from bottom of separator to water-oil interface).

Parameters:

level - water level in meters

getWaterLevel

public double getWaterLevel()

Get the water level (height from bottom of separator to water-oil interface).

Returns:

water level in meters

setOilLevel

public void setOilLevel(double level)

Set the oil level (height from bottom of separator to top of oil phase).

Parameters:

level - oil level in meters

getOilLevel

public double getOilLevel()

Get the oil level (height from bottom of separator to top of oil phase).

Returns:

oil level in meters

getOilThickness

public double getOilThickness()

Get the oil phase thickness (oil level minus water level).

Returns:

oil thickness in meters

setGasOutletFlowFraction

public void setGasOutletFlowFraction(double fraction)

Set the gas outlet valve flow fraction (simulates valve position).

Parameters:

fraction - flow fraction (0.0 = fully closed, 1.0 = fully open)

getGasOutletFlowFraction

public double getGasOutletFlowFraction()

Get the gas outlet valve flow fraction.

Returns:

flow fraction (0.0 = fully closed, 1.0 = fully open)

setOilOutletFlowFraction

public void setOilOutletFlowFraction(double fraction)

Set the oil outlet valve flow fraction (simulates valve position).

Parameters:

fraction - flow fraction (0.0 = fully closed, 1.0 = fully open)

getOilOutletFlowFraction

public double getOilOutletFlowFraction()

Get the oil outlet valve flow fraction.

Returns:

flow fraction (0.0 = fully closed, 1.0 = fully open)

setWaterOutletFlowFraction

public void setWaterOutletFlowFraction(double fraction)

Set the water outlet valve flow fraction (simulates valve position).

Parameters:

fraction - flow fraction (0.0 = fully closed, 1.0 = fully open)

getWaterOutletFlowFraction

public double getWaterOutletFlowFraction()

Get the water outlet valve flow fraction.

Returns:

flow fraction (0.0 = fully closed, 1.0 = fully open)

updateLiquidLevelFromWaterAndOil

private void updateLiquidLevelFromWaterAndOil()

Updates the parent class liquidLevel based on water and oil levels.

updateWaterAndOilLevelsFromPhases

private void updateWaterAndOilLevelsFromPhases()

Updates water and oil levels from phase volumes in the thermodynamic system.

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 Separator

Parameters:

id - UUID

initializeTransientCalculation

public void initializeTransientCalculation()

Initializes three-phase separator for transient calculations.

Overrides:

initializeTransientCalculation in class Separator

runTransient

public void runTransient(double dt,
 UUID id)

runTransient

This method calculates thermodynamic and unit operations using difference equations if available and calculateSteadyState is true. Use setCalculateSteadyState to set the parameter. Sets calc identifier UUID.

Specified by:

runTransient in interface SimulationInterface

Overrides:

runTransient in class Separator

Parameters:

dt - Delta time [s]

id - Calculation identifier

setTempPres

public void setTempPres(double temp,
 double pres)

setTempPres.

Overrides:

setTempPres in class Separator

Parameters:

temp - a double

pres - a double

displayResult

public void displayResult()

displayResult.

Specified by:

displayResult in interface ProcessEquipmentInterface

Overrides:

displayResult in class Separator

getEntropyProduction

public double getEntropyProduction(String unit)

getEntropyProduction.

Specified by:

getEntropyProduction in interface ProcessEquipmentInterface

Overrides:

getEntropyProduction in class Separator

Parameters:

unit - a String object

Returns:

a double

getMassBalance

public double getMassBalance(String unit)

getMassBalance.

Specified by:

getMassBalance in interface ProcessEquipmentInterface

Overrides:

getMassBalance in class Separator

Parameters:

unit - a String object

Returns:

a double

getExergyChange

public double getExergyChange(String unit,
 double surroundingTemperature)

Get exergy change production of the process equipment.

Specified by:

getExergyChange in interface ProcessEquipmentInterface

Overrides:

getExergyChange in class Separator

Parameters:

unit - Supported units are J and kJ

surroundingTemperature - The surrounding temperature in Kelvin

Returns:

change in exergy in specified unit

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 Separator

Returns:

json string.

toJson

public String toJson(ReportConfig cfg)

Serializes the Process Equipment with configurable level of detail.

Specified by:

toJson in interface ProcessEquipmentInterface

Overrides:

toJson in class Separator

Parameters:

cfg - report configuration

Returns:

json string

calcOilRetentionTime

public double calcOilRetentionTime()

Calculate oil retention time between NIL and NLL. Per API 12J and TR3500 SR-83381: Should be 3-5 minutes for light oils.

For three-phase separator, oil retention time is calculated for the oil layer between the water-oil interface (NIL) and the oil surface (NLL).

Overrides:

calcOilRetentionTime in class Separator

Returns:

oil retention time in minutes

calcWaterRetentionTime

public double calcWaterRetentionTime()

Calculate water retention time below NIL. Per API 12J and TR3500 SR-83381: Should be 3-5 minutes for light oils.

For three-phase separator, water retention time is calculated for the water layer below the water-oil interface (NIL).

Overrides:

calcWaterRetentionTime in class Separator

Returns:

water retention time in minutes

calcInterfaceSettlingTime

public double calcInterfaceSettlingTime()

Calculate the oil-water interface settling time. This is the time for oil droplets to rise through the water layer and water droplets to settle through the oil layer.

Returns:

interface settling time in minutes

isWithinAllLimits

public boolean isWithinAllLimits()

Check if all separator performance parameters are within limits. Uses default limits from Equinor TR3500 and API 12J.

For three-phase separator, also checks interface settling time.

Overrides:

isWithinAllLimits in class Separator

Returns:

true if all parameters are within limits

getPerformanceSummary

public String getPerformanceSummary()

Get a summary of all performance parameters with limit checks.

For three-phase separator, includes interface settling information.

Overrides:

getPerformanceSummary in class Separator

Returns:

performance summary as formatted string