Delayed Coker¶

DWSIM Plus

Available with a DWSIM Plus (Patreon) subscription.

Shortcut Delayed Coker. Feed: vacuum residue. Products: 5 material outlets (dry gas, LPG, naphtha, LGO, HGO). Coke is reported (not streamed); heater duty (endothermic) is absorbed from the energy connector. Yields anchor on feed CCR using Nelson / Gary & Handwerk correlations; the remainder of the mass balance splits to LGO/HGO. Lights (dry gas, LPG, naphtha, LGO) are emitted as moles of a single surrogate compound each; HGO keeps the feed pseudocomponents. Metals concentrate in coke.

DWSIM.UnitOperations.Refining.Coker.CokerUnitOperation
Assembly DWSIM.UnitOperations.Refining.dll · Object ← BaseClass ← UnitOpBaseClass ← CokerUnitOperation

At a glance¶

Delayed Coker in the example flowsheet

Port	Index	Connected in the example
Inlet, material	`0`	Vacuum-resid
Inlet, energy	`1`	Heater-duty
Outlet, material	`0`	Dry-gas
Outlet, material	`1`	LPG
Outlet, material	`2`	Coker-naphtha
Outlet, material	`3`	LGO
Outlet, material	`4`	HGO

Example¶

This code runs on every build of this site, and the output below is what it printed.

Python

# Dry gas, LPG, naphtha and LGO leave as one surrogate compound each;
# the heavy gas oil keeps the feed pseudos. Coke stays in the drum.
fs = Flowsheet.Create("CokerExample").WithCompounds("Methane", "Propane", "2,2,4-trimethylpentane", "N-dodecane")
# Vacuum residue as two pseudocomponents: name, NBP (K), SG, MW
resid = [("VR-1", 820.0, 0.99, 650.0), ("VR-2", 900.0, 1.02, 900.0)]
for name, nbp, sg, mw in resid:
    CompoundExtensions.WithPseudoComponent(fs, name, Q.Kelvin(nbp), sg, mw,
                                           paraffinFrac=0.30, naphtenicFrac=0.30, aromaticFrac=0.40)
fs.WithPropertyPackage(PropertyPackages.PengRobinson)

feed = fs.AddMaterialStream("Vacuum-resid").At(Q.Celsius(300.0), Q.Bar(5.0))
for name, *_ in resid:
    feed.SetCompoundMassFlow(name, 25.0)                  # kg/s each, 50 kg/s in total
    comp = feed.Object.Phases[0].Compounds[name]
    ContaminantKeys.Set(comp, ContaminantKeys.CCR_wt_pct, 20.0)
    ContaminantKeys.Set(comp, ContaminantKeys.WtPctSulfur, 3.5)

products = [fs.AddMaterialStream(tag) for tag in ("Dry-gas", "LPG", "Coker-naphtha", "LGO", "HGO")]
heater = fs.AddEnergyStream("Heater-duty")

coker = (fs.AddCoker("DCU-1")
         .WithHeaterOutletTemperature(Q.Celsius(495.0))
         .WithDrumPressure(Q.Bar(2.0))
         .WithCokeFromCCRFactor(1.6)             # wt% coke per wt% CCR
         .WithLGOofGasOil(0.55)
         .ConnectFeed(feed, 0)
         .ConnectEnergyFeed(heater, 1))
for port, stream in enumerate(products):
    coker.ConnectProduct(stream, port)

fs.AutoLayout()
fs.Solve()

r = coker.Object.Results
liquids = sum(s.MassFlowKgPerSecond for s in products)
print(f"Coke yield        = {r.CokeMassFlow / r.FeedMassFlow * 100.0:.1f} wt% ({r.CokeMassFlow * 86.4:.0f} t/d)")
print(f"Gas (C1-C4)       = {(products[0].MassFlowKgPerSecond + products[1].MassFlowKgPerSecond) / r.FeedMassFlow * 100.0:.1f} wt%")
print(f"Naphtha           = {products[2].MassFlowKgPerSecond / r.FeedMassFlow * 100.0:.1f} wt%")
print(f"LGO + HGO         = {(products[3].MassFlowKgPerSecond + products[4].MassFlowKgPerSecond) / r.FeedMassFlow * 100.0:.1f} wt%")
print(f"Products + coke   = {liquids + r.CokeMassFlow:.2f} kg/s (feed {r.FeedMassFlow:.2f} kg/s)")
print(f"Heater duty       = {heater.EnergyFlowKW / 1000.0:.1f} MW")

Output

Coke yield        = 32.0 wt% (1382 t/d)
Gas (C1-C4)       = 10.7 wt%
Naphtha           = 18.1 wt%
LGO + HGO         = 39.2 wt%
Products + coke   = 50.00 kg/s (feed 50.00 kg/s)
Heater duty       = 19.9 MW

DWSIM 10.2.11.0, generated 2026-10-08.

Properties¶

IDs accepted by GetPropertyValue, SetPropertyValue, the sensitivity analysis, the optimizer, the Adjust block and dynamic events. Units are SI; pass another unit system to GetPropertyValue to get them converted.

ID	Unit (SI)	Input
`Heater Outlet Temperature`	K	yes
`Drum Pressure`	Pa	yes
`Heater Duty Per Kg Feed`	J/kg	yes
`Coke-from-CCR Factor`	NF	yes
`Fallback CCR`	NF	yes
`Feed Mass Flow`	kg/s	result
`CCR Used`	NF	result
`Dry Gas Yield`	NF	result
`LPG Yield`	NF	result
`Naphtha Yield`	NF	result
`LGO Yield`	NF	result
`HGO Yield`	NF	result
`Coke Yield`	NF	result
`Coke Mass Flow`	kg/s	result
`Heater Duty`	kW	result
`Heater Duty Estimate`	kW	result
`Ni In Coke`	kg/s	result
`V In Coke`	kg/s	result
`Feed xP`	NF	result
`Feed xN`	NF	result
`Feed xA`	NF	result

Learn more¶

User guide
- Delayed Coker
FluentAPI
- Refining.CokerBuilder

API members¶

Public members declared by this class. Inherited members are documented on the base classes.

Constructors¶

CokerUnitOperation()

C#VB.NET

public CokerUnitOperation()

Public Sub New()

Properties¶

ComponentDescription: Gets or sets the CAPE-OPEN component description for this unit operation.

Gets or sets the CAPE-OPEN component description for this unit operation.

C#VB.NET

public override string ComponentDescription { get; set; }

Public Overrides Property ComponentDescription As String

Config: Gets or sets the configuration of this delayed coker: the heater outlet temperature, drum pressure, heater duty per...

Gets or sets the configuration of this delayed coker: the heater outlet temperature, drum pressure, heater duty per kg of feed, CCR-based coke, gas and naphtha yield correlations, gas and gas oil splits, feed PNA corrections, sulfur and nitrogen partitioning across the products and coke, and the product surrogate compounds.

C#VB.NET

public CokerConfiguration Config { get; set; }

Public Property Config As CokerConfiguration

IsRefining: Gets a value indicating that this unit operation belongs to the refining group.

Gets a value indicating that this unit operation belongs to the refining group. Always true; the object palette uses it to list the unit under the Refinery category.

C#VB.NET

public bool IsRefining { get; }

Public ReadOnly Property IsRefining As Boolean

MobileCompatible: Gets a value indicating whether this unit operation is compatible with mobile interfaces.

Gets a value indicating whether this unit operation is compatible with mobile interfaces. Always false.

C#VB.NET

public override bool MobileCompatible { get; }

Public Overrides ReadOnly Property MobileCompatible As Boolean

ObjectClass: Gets the simulation object class category (Reactors).

Gets the simulation object class category (Reactors).

C#VB.NET

public override SimulationObjectClass ObjectClass { get; }

Public Overrides Property ObjectClass As SimulationObjectClass

Prefix: Gets the default name prefix for this unit operation ('COK-').

Gets the default name prefix for this unit operation ("COK-").

C#VB.NET

public string Prefix { get; }

Public ReadOnly Property Prefix As String

Methods¶

Calculate(object): Calculates the object.

Calculates the object.

Parameter	Type	Description
`args`	`Object`

C#VB.NET

public override void Calculate(object args = null)

Public Overrides Sub Calculate(args As Object = Nothing)

CloneXML(): Creates a deep copy of this object by round-tripping through XML serialization.

Creates a deep copy of this object by round-tripping through XML serialization.

C#VB.NET

public override object CloneXML()

Public Overrides Function CloneXML() As Object

CloseEditForm(): Closes the editor of this object, if it is open.

Closes the editor of this object, if it is open.

C#VB.NET

public override void CloseEditForm()

Public Overrides Sub CloseEditForm()

CreateConnectors(): Creates the graphic connector definitions on the flowsheet: a Feed inlet on the left, a Heater Duty energy inlet at...

Creates the graphic connector definitions on the flowsheet: a Feed inlet on the left, a Heater Duty energy inlet at the bottom, and five product outlets (Dry Gas, LPG, Naphtha, LGO, HGO) on the right.

C#VB.NET

public void CreateConnectors()

Public Sub CreateConnectors()

DeCalculate(): Decalculates the object.

Decalculates the object.

C#VB.NET

public override void DeCalculate()

Public Overrides Sub DeCalculate()

DisplayEditForm(): Opens the editor of this object.

Opens the editor of this object. A host that has no editor for it does nothing.

C#VB.NET

public override void DisplayEditForm()

Public Overrides Sub DisplayEditForm()

Draw(object): Draws the unit operation icon on the given SkiaSharp canvas.

Draws the unit operation icon on the given SkiaSharp canvas. Draw mode 2 uses the embedded PNG image (falling back to the vector icon if it cannot be loaded), draw mode 1 draws the vector icon as a silhouette, and other modes draw the vector icon.

Parameter	Type	Description
`g`	`Object`	The SkiaSharp canvas (`SKCanvas`).

C#VB.NET

public void Draw(object g)

Public Sub Draw(g As Object)

GetDisplayDescription(): Returns the description string for this unit operation type.

Returns the description string for this unit operation type.

C#VB.NET

public override string GetDisplayDescription()

Public Overrides Function GetDisplayDescription() As String

GetDisplayName(): Returns the display name for this unit operation type.

Returns the display name for this unit operation type.

C#VB.NET

public override string GetDisplayName()

Public Overrides Function GetDisplayName() As String

GetIconBitmapBytes(): Returns the raw bytes of the icon image for this unit operation, rendered from the vector icon at 64 x 64 pixels.

Returns the raw bytes of the icon image for this unit operation, rendered from the vector icon at 64 x 64 pixels.

C#VB.NET

public override byte[] GetIconBitmapBytes()

Public Overrides Function GetIconBitmapBytes() As Byte()

GetPreferredGraphicObjectHeight(): Returns the preferred height of the flowsheet graphic object, in pixels.

Returns the preferred height of the flowsheet graphic object, in pixels.

C#VB.NET

public override double GetPreferredGraphicObjectHeight()

Public Overrides Function GetPreferredGraphicObjectHeight() As Double

GetPreferredGraphicObjectWidth(): Returns the preferred width of the flowsheet graphic object, in pixels.

Returns the preferred width of the flowsheet graphic object, in pixels.

C#VB.NET

public override double GetPreferredGraphicObjectWidth()

Public Overrides Function GetPreferredGraphicObjectWidth() As Double

GetProperties(PropertyType): Get a list of all properties of the object.

Get a list of all properties of the object.

Parameter	Type	Description
`proptype`	`PropertyType`	Type of the property.

C#VB.NET

public override string[] GetProperties(PropertyType proptype)

Public Overrides Function GetProperties(proptype As PropertyType) As String()

GetPropertyUnit(string, IUnitsOfMeasure): Gets the units of a property.

Gets the units of a property.

Parameter	Type	Description
`prop`	`String`	Property identifier.
`su`	`IUnitsOfMeasure`	Units system to use. Null to use the default (SI) system.

C#VB.NET

public override string GetPropertyUnit(string prop, IUnitsOfMeasure su)

Public Overrides Function GetPropertyUnit(prop As String, su As IUnitsOfMeasure) As String

GetPropertyValue(string, IUnitsOfMeasure): Returns the value of a named property, converting from SI to the current unit system.

Returns the value of a named property, converting from SI to the current unit system. Falls back to extra properties if the property is not found in the base implementation.

Parameter	Type	Description
`prop`	`String`	The property identifier string.
`su`	`IUnitsOfMeasure`	Optional units-of-measure system used for conversion; uses the shared SI system when `Nothing`.

C#VB.NET

public override object GetPropertyValue(string prop, IUnitsOfMeasure su)

Public Overrides Function GetPropertyValue(prop As String, su As IUnitsOfMeasure) As Object

LoadData(List<XElement>): Restores the unit operation state from a list of XML elements previously produced by SaveData.

Restores the unit operation state from a list of XML elements previously produced by SaveData.

Parameter	Type	Description
`data`	`List<XElement>`	The list of `XElement` objects containing serialized state.

C#VB.NET

public override bool LoadData(List<XElement> data)

Public Overrides Function LoadData(data As List(Of XElement)) As Boolean

PopulateEditorPanel(object): Populates the cross-platform (Avalonia) editor panel with controls: buttons that open the configuration and results...

Populates the cross-platform (Avalonia) editor panel with controls: buttons that open the configuration and results forms. Other container types are ignored.

Parameter	Type	Description
`ctner`	`Object`	The editor panel (layout container) to populate.

C#VB.NET

public void PopulateEditorPanel(object ctner)

Public Sub PopulateEditorPanel(ctner As Object)

ReturnInstance(string): Creates and returns a new instance for deserialization.

Creates and returns a new instance for deserialization.

Parameter	Type	Description
`typename`	`String`	The type name to instantiate (not used).

C#VB.NET

public object ReturnInstance(string typename)

Public Function ReturnInstance(typename As String) As Object

SaveData(): Serializes the unit operation state to a list of XML elements for persistence.

Serializes the unit operation state to a list of XML elements for persistence.

C#VB.NET

public override List<XElement> SaveData()

Public Overrides Function SaveData() As List(Of XElement)

SetPropertyValue(string, object, IUnitsOfMeasure): Sets the value of a property.

Sets the value of a property.

Parameter	Type	Description
`prop`	`String`	Property identifier.
`propval`	`Object`	Property value to set at the specified units.
`su`	`IUnitsOfMeasure`	Units system to use. Null to use the default (SI) system.

C#VB.NET

public override bool SetPropertyValue(string prop, object propval, IUnitsOfMeasure su)

Public Overrides Function SetPropertyValue(prop As String, propval As Object, su As IUnitsOfMeasure) As Boolean

UpdateEditForm(): Redraws the editor of this object with the current values, if it is open.

Redraws the editor of this object with the current values, if it is open.

C#VB.NET

public override void UpdateEditForm()

Public Overrides Sub UpdateEditForm()

Fields¶

_editorForm: The classic (WinForms) editor window open for this unit operation, if any.

The classic (WinForms) editor window open for this unit operation, if any. Not saved with the flowsheet.

C#VB.NET

public FormEditorCoker _editorForm

Public _editorForm As FormEditorCoker