Skip to content

Divided-Wall Column

DWSIM Plus

Available with a DWSIM Plus (Patreon) subscription.

Divided-wall (Petlyuk) distillation column, solved simultaneously by Newton-Raphson over the whole stage network: common top section, the two sides of the wall (feed side and product side) and common bottom section, with the liquid and vapor splits at the ends of the wall. Ports Inlets 0..n-1 : feeds, located by Feeds Inlet n (last) : reboiler duty (energy) Outlet 0 : distillate (liquid for a total condenser, vapor for a partial one) Outlet 1 : bottoms Outlets 2.. : side products, in the order of SideDraws Outlet (last) : condenser duty (energy) The duty ports always come last and are found by type. Requires the level 2 DWSIM Patreon subscription.

DWSIM.UnitOperations.DividedWallColumn.DividedWallColumnUnitOperation
Assembly DWSIM.UnitOperations.DividedWallColumn.dll · Object ← BaseClass ← UnitOpBaseClass ← DividedWallColumnUnitOperation

At a glance

Divided-Wall Column in the example flowsheet

Port Index Connected in the example
Inlet, material 0 Feed
Inlet, energy 1 Qr
Outlet, material 0 Pentane
Outlet, material 1 Heptane
Outlet, material 2 Hexane
Outlet, energy 3 Qc

Example

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

fs = (Flowsheet.Create("DividedWallColumnExample")
      .WithCompounds("N-pentane", "N-hexane", "N-heptane")
      .WithPropertyPackage(PropertyPackages.PengRobinson))

# 100 kmol/h of saturated liquid at 2 atm, 40/20/40 mol %
feed = (fs.AddMaterialStream("Feed").WithPressure(Q.Atm(2.0)).WithVaporFraction(0.0)
        .SetCompoundMolarFlow("N-pentane", 11.111)       # mol/s
        .SetCompoundMolarFlow("N-hexane", 5.556)
        .SetCompoundMolarFlow("N-heptane", 11.111))
pentane, hexane, heptane = (fs.AddMaterialStream(n) for n in ("Pentane", "Hexane", "Heptane"))

# 9 stages above the wall, 23 on each side of it, 14 below; feed and side draw at stage 14 of their sides
dwc = (fs.AddDividedWallColumn("DWC-1")
       .WithSections(9, 23, 23, 14)
       .WithPressures(Q.Atm(2.0))
       .WithFeed(feed, DwcSection.Prefractionator, 14)
       .WithDistillate(pentane)
       .WithBottoms(heptane)
       .WithSideProduct(hexane, DwcSection.Main, 14, DwcSideSpecType.ComponentMoleFraction, 0.92, "N-hexane")
       .WithCondenserDuty(fs.AddEnergyStream("Qc"))
       .WithReboilerDuty(fs.AddEnergyStream("Qr"))
       .WithCondenserSpec(DwcEndSpecType.ComponentMoleFraction, 0.99, "N-pentane")
       .WithReboilerSpec(DwcEndSpecType.ComponentMoleFraction, 0.99, "N-heptane")
       .WithSplitFlows(Q.KmolPerHour(33.5), Q.KmolPerHour(84.5)))   # liquid and vapor sent to the feed side

fs.OrthogonalLayout()
fs.Solve()

r = dwc.Object.Results
print(f"Converged in {r.Iterations} iterations, residual {r.ResidualNorm:.1e}")
print(f"Condenser duty = {r.CondenserDuty:.1f} kW, reboiler duty = {r.ReboilerDuty:.1f} kW")
print(f"Reflux ratio   = {r.RefluxRatio:.3f}")
for name, flow, x in (("Pentane", r.DistillateFlow, r.DistillateComposition[0]),
                      ("Hexane", r.SideProducts[0].Flow, r.SideProducts[0].Composition[1]),
                      ("Heptane", r.BottomsFlow, r.BottomsComposition[2])):
    print(f"{name:8s} {flow * 3.6:6.2f} kmol/h, purity {x * 100:.2f} mol %")

Output

Converged in 14 iterations, residual 4.1e-08
Condenser duty = 843.5 kW, reboiler duty = 929.1 kW
Reflux ratio   = 2.048
Pentane   40.36 kmol/h, purity 99.00 mol %
Hexane    20.88 kmol/h, purity 92.00 mol %
Heptane   38.76 kmol/h, purity 99.00 mol %

DWSIM 10.2.16.0, generated 2026-11-11.

Structure

The column is a Petlyuk arrangement in one shell, made of four sections with stages numbered from the top of each section:

Section Setting Role
Top TopStages rectifying section above the wall, with the condenser (total or partial)
Prefractionator PrefractionatorStages feed side of the wall
Main MainStages product side of the wall, where the side draws usually are
Bottom BottomStages stripping section below the wall, with the reboiler

The liquid leaving the last stage of the top section splits between the two sides of the wall, and so does the vapor leaving the first stage of the bottom section. The splits are given either as fractions (LiquidSplitRatio, VaporSplitRatio) or as the flows sent to the feed side (LiquidSplitFlow, VaporSplitFlow, mol/s); in the second case the fraction is solved for. Feeds can enter any stage of any section, and side draws (liquid or vapor) can leave any stage, so a four-product Kaibel column is two side draws on the product side.

WallPosition moves the wall to an end of the shell. With Top there is no top section and each side of the wall has its own condenser: the feed side distillate leaves through the distillate port, the product side one through the port after the side products, and the product side condenser takes SecondEndSpec. With Bottom there is no bottom section and each side has its own reboiler, in the same way. In both cases the split at the end the wall reaches disappears, and the shortcut design and the interlink optimization, which are written for the Petlyuk column, are not available.

Specifications

The condenser and the reboiler take one specification each: reflux or boilup ratio, product flow (molar or mass), mole or mass fraction of a compound, molar flow or recovery of a compound, heat duty or temperature. A side draw has a fixed molar flow, or a mole fraction or recovery of a compound, in which case its flow is solved for.

The wall is adiabatic unless WallHeatTransferCoefficient (W/m2.K) and WallArea (m2) are both set. Heat then flows between the stages that face each other across the wall, \(Q = U A_{jk} (T_j - T_k)\), where \(A_{jk}\) is the part of the wall area the two stages share when each side spreads its stages evenly over the wall height. WallDuty in the results is the net heat from the feed side to the product side.

Secondary specifications

SecondarySpecs sets properties of the products directly, as on the distillation column: each entry names a product (distillate, bottoms, a side product or the second product of a wall at an end), a property (a distillation curve point such as D86 95%, a product property such as Flash Point (Closed Cup) or Density @ 20 C, or any material stream property ID), a target and a tolerance in SI units, and the free variable it moves: the value of a condenser or reboiler specification, the value of a side draw specification (rate, purity or recovery) or a wall split. The column solves as usual inside an outer loop of Newton steps with a Broyden-updated Jacobian, each solve starting from the last converged profile, and the configuration keeps the variable values of the best solution. Each variable serves one specification, and a target the column cannot reach is reported as not met. WithSecondarySpec on the builder adds one.

How the column is solved

All the stages are solved together by Newton's method on the MESH equations in the Naphtali-Sandholm form (temperature and component flows per stage, with Murphree efficiencies per section). The stages are ordered by elevation, the two sides of the wall interleaved, which keeps the Jacobian banded. The Jacobian comes from grouped finite differences, so each iteration needs only a few property evaluations per stage.

The first estimate comes from a constant molar overflow profile followed by bubble-point sweeps. Purity and recovery specifications that the direct solution cannot reach from that estimate are approached by continuation: the column is first solved with ratio specifications, then the targets move step by step to the requested values. The converged profile is saved with the flowsheet and starts the next calculation, so a re-solve after a small change takes a few iterations.

Design tools

DwcShortcutDesigner.Design sizes a new column from the feed: Underwood minimum vapor (the Vmin diagram), the preferred split and the stage numbers of each section by the three-column (Triantafyllou-Smith) model with Fenske, Gilliland and Kirkbride. DwcShortcutDesigner.Apply writes the result to a configuration.

MolecularTracking follows the probability that a molecule of the middle compound leaves a stage in the vapor, \(\beta = K V / (K V + L)\), and suggests the side draw stage where \(\beta\) crosses 0.5; MolecularTracking.Sweep solves the column with the draw on each candidate stage and reports the reboiler duty of each. InterlinkOptimizer.Optimize searches the liquid and vapor splits that give the lowest reboiler duty with the product specifications held.

All three are on the Design tab of the editor.

References

  • Buitimea-Cerón, G. A., Hahn, J., Medina-Herrera, N., Jiménez-Gutiérrez, A., Loredo-Medrano, J. A. and Tututi-Avila, S. (2021). Dividing-Wall Column Design: Analysis of Methodologies Tailored to Process Simulators. Processes 9, 1189. https://doi.org/10.3390/pr9071189
  • Montonati, G., Nazemzadeh, N., Abildskov, J. and Mansouri, S. S. (2022). Divided Wall Distillation Column Design using Molecular Tracking. AIChE Journal 68(2), e17504. https://doi.org/10.1002/aic.17504

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.

All 255 properties
ID Name Unit (SI) Input
Top Section Stages yes
Prefractionator Stages yes
Product Side Stages yes
Bottom Section Stages yes
Condenser Pressure Pa yes
Condenser Pressure Drop Pa yes
Column Pressure Drop Pa yes
Condenser Specification Value yes
Reboiler Specification Value yes
Liquid Split Ratio yes
Vapor Split Ratio yes
Liquid to Prefractionator mol/s yes
Vapor to Prefractionator mol/s yes
Top Section Efficiency yes
Prefractionator Efficiency yes
Product Side Efficiency yes
Bottom Section Efficiency yes
Wall Heat Transfer Coefficient W/[m2.K] yes
Wall Area m2 yes
Feed 1 Stage yes
Side Draw 1 Specification Value yes
Side Draw 1 Stage yes
Condenser Duty kW result
Reboiler Duty kW result
Reflux Ratio result
Boilup Ratio result
Distillate Molar Flow mol/s result
Bottoms Molar Flow mol/s result
Condenser Temperature K result
Reboiler Temperature K result
Calculated Liquid Split Ratio result
Calculated Vapor Split Ratio result
Calculated Liquid to Prefractionator mol/s result
Calculated Vapor to Prefractionator mol/s result
Newton Iterations result
Solution Time s result
Estimated Diameter mm result
Estimated Height m result
Estimated Shell Weight kg result
Estimated Wall Weight kg result
Wall Heat Flow kW result
Side Draw 1 Molar Flow mol/s result
Stage Temperature: Condenser K result
Stage Liquid Flow: Condenser mol/s result
Stage Vapor Flow: Condenser mol/s result
Stage Temperature: T1 K result
Stage Liquid Flow: T1 mol/s result
Stage Vapor Flow: T1 mol/s result
Stage Temperature: T2 K result
Stage Liquid Flow: T2 mol/s result
Stage Vapor Flow: T2 mol/s result
Stage Temperature: T3 K result
Stage Liquid Flow: T3 mol/s result
Stage Vapor Flow: T3 mol/s result
Stage Temperature: T4 K result
Stage Liquid Flow: T4 mol/s result
Stage Vapor Flow: T4 mol/s result
Stage Temperature: T5 K result
Stage Liquid Flow: T5 mol/s result
Stage Vapor Flow: T5 mol/s result
Stage Temperature: T6 K result
Stage Liquid Flow: T6 mol/s result
Stage Vapor Flow: T6 mol/s result
Stage Temperature: T7 K result
Stage Liquid Flow: T7 mol/s result
Stage Vapor Flow: T7 mol/s result
Stage Temperature: T8 K result
Stage Liquid Flow: T8 mol/s result
Stage Vapor Flow: T8 mol/s result
Stage Temperature: T9 K result
Stage Liquid Flow: T9 mol/s result
Stage Vapor Flow: T9 mol/s result
Stage Temperature: P1 K result
Stage Liquid Flow: P1 mol/s result
Stage Vapor Flow: P1 mol/s result
Stage Temperature: M1 K result
Stage Liquid Flow: M1 mol/s result
Stage Vapor Flow: M1 mol/s result
Stage Temperature: P2 K result
Stage Liquid Flow: P2 mol/s result
Stage Vapor Flow: P2 mol/s result
Stage Temperature: M2 K result
Stage Liquid Flow: M2 mol/s result
Stage Vapor Flow: M2 mol/s result
Stage Temperature: P3 K result
Stage Liquid Flow: P3 mol/s result
Stage Vapor Flow: P3 mol/s result
Stage Temperature: M3 K result
Stage Liquid Flow: M3 mol/s result
Stage Vapor Flow: M3 mol/s result
Stage Temperature: P4 K result
Stage Liquid Flow: P4 mol/s result
Stage Vapor Flow: P4 mol/s result
Stage Temperature: M4 K result
Stage Liquid Flow: M4 mol/s result
Stage Vapor Flow: M4 mol/s result
Stage Temperature: P5 K result
Stage Liquid Flow: P5 mol/s result
Stage Vapor Flow: P5 mol/s result
Stage Temperature: M5 K result
Stage Liquid Flow: M5 mol/s result
Stage Vapor Flow: M5 mol/s result
Stage Temperature: P6 K result
Stage Liquid Flow: P6 mol/s result
Stage Vapor Flow: P6 mol/s result
Stage Temperature: M6 K result
Stage Liquid Flow: M6 mol/s result
Stage Vapor Flow: M6 mol/s result
Stage Temperature: P7 K result
Stage Liquid Flow: P7 mol/s result
Stage Vapor Flow: P7 mol/s result
Stage Temperature: M7 K result
Stage Liquid Flow: M7 mol/s result
Stage Vapor Flow: M7 mol/s result
Stage Temperature: P8 K result
Stage Liquid Flow: P8 mol/s result
Stage Vapor Flow: P8 mol/s result
Stage Temperature: M8 K result
Stage Liquid Flow: M8 mol/s result
Stage Vapor Flow: M8 mol/s result
Stage Temperature: P9 K result
Stage Liquid Flow: P9 mol/s result
Stage Vapor Flow: P9 mol/s result
Stage Temperature: M9 K result
Stage Liquid Flow: M9 mol/s result
Stage Vapor Flow: M9 mol/s result
Stage Temperature: P10 K result
Stage Liquid Flow: P10 mol/s result
Stage Vapor Flow: P10 mol/s result
Stage Temperature: M10 K result
Stage Liquid Flow: M10 mol/s result
Stage Vapor Flow: M10 mol/s result
Stage Temperature: P11 K result
Stage Liquid Flow: P11 mol/s result
Stage Vapor Flow: P11 mol/s result
Stage Temperature: M11 K result
Stage Liquid Flow: M11 mol/s result
Stage Vapor Flow: M11 mol/s result
Stage Temperature: P12 K result
Stage Liquid Flow: P12 mol/s result
Stage Vapor Flow: P12 mol/s result
Stage Temperature: M12 K result
Stage Liquid Flow: M12 mol/s result
Stage Vapor Flow: M12 mol/s result
Stage Temperature: P13 K result
Stage Liquid Flow: P13 mol/s result
Stage Vapor Flow: P13 mol/s result
Stage Temperature: M13 K result
Stage Liquid Flow: M13 mol/s result
Stage Vapor Flow: M13 mol/s result
Stage Temperature: P14 K result
Stage Liquid Flow: P14 mol/s result
Stage Vapor Flow: P14 mol/s result
Stage Temperature: M14 K result
Stage Liquid Flow: M14 mol/s result
Stage Vapor Flow: M14 mol/s result
Stage Temperature: P15 K result
Stage Liquid Flow: P15 mol/s result
Stage Vapor Flow: P15 mol/s result
Stage Temperature: M15 K result
Stage Liquid Flow: M15 mol/s result
Stage Vapor Flow: M15 mol/s result
Stage Temperature: P16 K result
Stage Liquid Flow: P16 mol/s result
Stage Vapor Flow: P16 mol/s result
Stage Temperature: M16 K result
Stage Liquid Flow: M16 mol/s result
Stage Vapor Flow: M16 mol/s result
Stage Temperature: P17 K result
Stage Liquid Flow: P17 mol/s result
Stage Vapor Flow: P17 mol/s result
Stage Temperature: M17 K result
Stage Liquid Flow: M17 mol/s result
Stage Vapor Flow: M17 mol/s result
Stage Temperature: P18 K result
Stage Liquid Flow: P18 mol/s result
Stage Vapor Flow: P18 mol/s result
Stage Temperature: M18 K result
Stage Liquid Flow: M18 mol/s result
Stage Vapor Flow: M18 mol/s result
Stage Temperature: P19 K result
Stage Liquid Flow: P19 mol/s result
Stage Vapor Flow: P19 mol/s result
Stage Temperature: M19 K result
Stage Liquid Flow: M19 mol/s result
Stage Vapor Flow: M19 mol/s result
Stage Temperature: P20 K result
Stage Liquid Flow: P20 mol/s result
Stage Vapor Flow: P20 mol/s result
Stage Temperature: M20 K result
Stage Liquid Flow: M20 mol/s result
Stage Vapor Flow: M20 mol/s result
Stage Temperature: P21 K result
Stage Liquid Flow: P21 mol/s result
Stage Vapor Flow: P21 mol/s result
Stage Temperature: M21 K result
Stage Liquid Flow: M21 mol/s result
Stage Vapor Flow: M21 mol/s result
Stage Temperature: P22 K result
Stage Liquid Flow: P22 mol/s result
Stage Vapor Flow: P22 mol/s result
Stage Temperature: M22 K result
Stage Liquid Flow: M22 mol/s result
Stage Vapor Flow: M22 mol/s result
Stage Temperature: P23 K result
Stage Liquid Flow: P23 mol/s result
Stage Vapor Flow: P23 mol/s result
Stage Temperature: M23 K result
Stage Liquid Flow: M23 mol/s result
Stage Vapor Flow: M23 mol/s result
Stage Temperature: B1 K result
Stage Liquid Flow: B1 mol/s result
Stage Vapor Flow: B1 mol/s result
Stage Temperature: B2 K result
Stage Liquid Flow: B2 mol/s result
Stage Vapor Flow: B2 mol/s result
Stage Temperature: B3 K result
Stage Liquid Flow: B3 mol/s result
Stage Vapor Flow: B3 mol/s result
Stage Temperature: B4 K result
Stage Liquid Flow: B4 mol/s result
Stage Vapor Flow: B4 mol/s result
Stage Temperature: B5 K result
Stage Liquid Flow: B5 mol/s result
Stage Vapor Flow: B5 mol/s result
Stage Temperature: B6 K result
Stage Liquid Flow: B6 mol/s result
Stage Vapor Flow: B6 mol/s result
Stage Temperature: B7 K result
Stage Liquid Flow: B7 mol/s result
Stage Vapor Flow: B7 mol/s result
Stage Temperature: B8 K result
Stage Liquid Flow: B8 mol/s result
Stage Vapor Flow: B8 mol/s result
Stage Temperature: B9 K result
Stage Liquid Flow: B9 mol/s result
Stage Vapor Flow: B9 mol/s result
Stage Temperature: B10 K result
Stage Liquid Flow: B10 mol/s result
Stage Vapor Flow: B10 mol/s result
Stage Temperature: B11 K result
Stage Liquid Flow: B11 mol/s result
Stage Vapor Flow: B11 mol/s result
Stage Temperature: B12 K result
Stage Liquid Flow: B12 mol/s result
Stage Vapor Flow: B12 mol/s result
Stage Temperature: B13 K result
Stage Liquid Flow: B13 mol/s result
Stage Vapor Flow: B13 mol/s result
Stage Temperature: B14 K result
Stage Liquid Flow: B14 mol/s result
Stage Vapor Flow: B14 mol/s result
Stage Temperature: Reboiler K result
Stage Liquid Flow: Reboiler mol/s result
Stage Vapor Flow: Reboiler mol/s result

Learn more

API members

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

Constructors

DividedWallColumnUnitOperation(): Creates a column with the default structure (8, 20, 20 and 8 stages), one feed and one side draw.

Creates a column with the default structure (8, 20, 20 and 8 stages), one feed and one side draw.

public DividedWallColumnUnitOperation()
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.

public override string ComponentDescription { get; set; }
Public Overrides Property ComponentDescription As String

Config: Structure, specifications and solver options.

Structure, specifications and solver options.

public DwcConfiguration Config { get; set; }
Public Property Config As DwcConfiguration

IsPremium: Listed in the Premium group of the object palette.

Listed in the Premium group of the object palette.

public bool IsPremium { get; }
Public ReadOnly Property IsPremium As Boolean

MobileCompatible: Not available in the mobile interfaces (always false).

Not available in the mobile interfaces (always false).

public override bool MobileCompatible { get; }
Public Overrides ReadOnly Property MobileCompatible As Boolean

ObjectClass: Simulation object class (columns).

Simulation object class (columns).

public override SimulationObjectClass ObjectClass { get; }
Public Overrides Property ObjectClass As SimulationObjectClass

Prefix: Default name prefix ('DWC-').

Default name prefix ("DWC-").

public string Prefix { get; }
Public ReadOnly Property Prefix As String

SecondProductPort: Outlet port of the product side distillate (wall at the top) or bottoms (wall at the bottom): right after the side...

Outlet port of the product side distillate (wall at the top) or bottoms (wall at the bottom): right after the side products. With the wall in the middle there is no such port.

public int SecondProductPort { get; }
Public ReadOnly Property SecondProductPort As Integer

Methods

AccessMessage(string): Message shown when the subscription does not cover this unit.

Message shown when the subscription does not cover this unit.

Parameter Type Description
tag String
public static string AccessMessage(string tag)
Public Shared Function AccessMessage(tag As String) As String

Calculate(object): Calculates the object.

Calculates the object.

Parameter Type Description
args Object
public override void Calculate(object args = null)
Public Overrides Sub Calculate(args As Object = Nothing)

CloneXML(): Returns a copy of the unit made through its XML data; it works at any subscription level so copy and paste never fails.

Returns a copy of the unit made through its XML data; it works at any subscription level so copy and paste never fails.

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.

public override void CloseEditForm()
Public Overrides Sub CloseEditForm()

CondenserDutyStream(): The energy stream on the condenser duty port (the feed side condenser with the wall at the top), or null.

The energy stream on the condenser duty port (the feed side condenser with the wall at the top), or null.

public EnergyStream CondenserDutyStream()
Public Function CondenserDutyStream() As EnergyStream

CreateConnectors(): Creates or repositions the ports: the feeds and the reboiler duty on the inlet side; distillate, bottoms, the side...

Creates or repositions the ports: the feeds and the reboiler duty on the inlet side; distillate, bottoms, the side products and the condenser duty on the outlet side. Feed and side product ports are added or removed (disconnecting what was attached) to match the configuration; the duty ports stay last.

public void CreateConnectors()
Public Sub CreateConnectors()

DeCalculate(): Decalculates the object.

Decalculates the object.

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.

public override void DisplayEditForm()
Public Overrides Sub DisplayEditForm()

Draw(object): Draws the column: filled and outlined in the status color, a black outline in silhouette mode (draw mode 1), or the...

Draws the column: filled and outlined in the status color, a black outline in silhouette mode (draw mode 1), or the photo (draw mode 2), grayed out when the unit is inactive.

Parameter Type Description
g Object
public void Draw(object g)
Public Sub Draw(g As Object)

DutyPort(bool, int): Port index of the n-th energy port on the inlet or outlet side, or -1.

Port index of the n-th energy port on the inlet or outlet side, or -1.

Parameter Type Description
inlet Boolean
n Int32
public int DutyPort(bool inlet, int n)
Public Function DutyPort(inlet As Boolean, n As Integer) As Integer

EndSpecUnit(DwcEndSpecType, IUnitsOfMeasure): Display unit of an end specification value, or '' for dimensionless ones ('%' for recoveries).

Display unit of an end specification value, or "" for dimensionless ones ("%" for recoveries).

Parameter Type Description
t DwcEndSpecType
su IUnitsOfMeasure
public static string EndSpecUnit(DwcEndSpecType t, IUnitsOfMeasure su)
Public Shared Function EndSpecUnit(t As DwcEndSpecType, su As IUnitsOfMeasure) As String

EvaluateSecondarySpec(DwcResults, DwcSecondarySpec): The value of a secondary specification's property on a solution, in SI units.

The value of a secondary specification's property on a solution, in SI units.

Parameter Type Description
r DwcResults
s DwcSecondarySpec
public double EvaluateSecondarySpec(DwcResults r, DwcSecondarySpec s)
Public Function EvaluateSecondarySpec(r As DwcResults, s As DwcSecondarySpec) As Double

GetChartModel(string): Returns the OxyPlot model of chart name, or null before the first solution.

Returns the OxyPlot model of chart name, or null before the first solution.

Parameter Type Description
name String
public override object GetChartModel(string name)
Public Overrides Function GetChartModel(name As String) As Object

GetChartModelNames(): Names of the charts this unit draws (the Chart* constants).

Names of the charts this unit draws (the Chart* constants).

public override List<string> GetChartModelNames()
Public Overrides Function GetChartModelNames() As List(Of String)

GetDisplayDescription(): Returns the one-line description shown in the object palette.

Returns the one-line description shown in the object palette.

public override string GetDisplayDescription()
Public Overrides Function GetDisplayDescription() As String

GetDisplayName(): Returns the display name, 'Divided-Wall Column'.

Returns the display name, "Divided-Wall Column".

public override string GetDisplayName()
Public Overrides Function GetDisplayName() As String

GetIconBitmapBytes(): Palette icon (64 × 64 PNG).

Palette icon (64 × 64 PNG).

public override byte[] GetIconBitmapBytes()
Public Overrides Function GetIconBitmapBytes() As Byte()

GetPreferredGraphicObjectHeight(): Default height of the flowsheet icon (180, as the distillation column).

Default height of the flowsheet icon (180, as the distillation column).

public override double GetPreferredGraphicObjectHeight()
Public Overrides Function GetPreferredGraphicObjectHeight() As Double

GetPreferredGraphicObjectWidth(): Default width of the flowsheet icon (144, as the distillation column).

Default width of the flowsheet icon (144, as the distillation column).

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.
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.
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.
public override object GetPropertyValue(string prop, IUnitsOfMeasure su)
Public Overrides Function GetPropertyValue(prop As String, su As IUnitsOfMeasure) As Object

GetReport(IUnitsOfMeasure, CultureInfo, string): Text report: structure, specifications, convergence, duties, products, size estimate and the stage profile.

Text report: structure, specifications, convergence, duties, products, size estimate and the stage profile.

Parameter Type Description
su IUnitsOfMeasure
ci CultureInfo
numberformat String
public override string GetReport(IUnitsOfMeasure su, CultureInfo ci, string numberformat)
Public Overrides Function GetReport(su As IUnitsOfMeasure, ci As CultureInfo, numberformat As String) As String

GetStructuredReport(): Structured report used by the datasheets and the report tools.

Structured report used by the datasheets and the report tools.

public override List<Tuple<ReportItemType, string[]>> GetStructuredReport()
Public Overrides Function GetStructuredReport() As List(Of Tuple(Of ReportItemType, String()))

HasAccess(): True when the current subscription covers this unit.

True when the current subscription covers this unit.

public static bool HasAccess()
Public Shared Function HasAccess() As Boolean

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

Populates the cross-platform (Avalonia) editor panel.

Parameter Type Description
ctner Object
public void PopulateEditorPanel(object ctner)
Public Sub PopulateEditorPanel(ctner As Object)

PrepareSolve(): Reads the connected feeds and prepares the property package.

Reads the connected feeds and prepares the property package.

public DividedWallColumnUnitOperation.SolveContext PrepareSolve()
Public Function PrepareSolve() As DividedWallColumnUnitOperation.SolveContext

ReboilerDutyStream(): The energy stream on the reboiler duty port (the feed side reboiler with the wall at the bottom), or null.

The energy stream on the reboiler duty port (the feed side reboiler with the wall at the bottom), or null.

public EnergyStream ReboilerDutyStream()
Public Function ReboilerDutyStream() As EnergyStream

ReturnInstance(string): Returns a new, unconnected instance (used by the object palette).

Returns a new, unconnected instance (used by the object palette).

Parameter Type Description
typename String
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.

public override List<XElement> SaveData()
Public Overrides Function SaveData() As List(Of XElement)

SecondaryFromSI(string, double): Converts from SI to a unit; unchanged when the unit is empty.

Converts from SI to a unit; unchanged when the unit is empty.

Parameter Type Description
unit String
v Double
public static double SecondaryFromSI(string unit, double v)
Public Shared Function SecondaryFromSI(unit As String, v As Double) As Double

SecondaryProductOptions(DwcConfiguration): The products of the current configuration a secondary specification can read, as (product, index, label).

The products of the current configuration a secondary specification can read, as (product, index, label).

Parameter Type Description
cfg DwcConfiguration
public List<Tuple<DwcSecondaryProduct, int, string>> SecondaryProductOptions(DwcConfiguration cfg = null)
Public Function SecondaryProductOptions(cfg As DwcConfiguration = Nothing) As List(Of Tuple(Of DwcSecondaryProduct, Integer, String))

SecondaryPropertyNames(): The properties offered in the editors: every curve at the standard points, then the product properties.

The properties offered in the editors: every curve at the standard points, then the product properties.

public static List<string> SecondaryPropertyNames()
Public Shared Function SecondaryPropertyNames() As List(Of String)

SecondaryToSI(string, double): Converts a value in a unit to SI; unchanged when the unit is empty.

Converts a value in a unit to SI; unchanged when the unit is empty.

Parameter Type Description
unit String
v Double
public static double SecondaryToSI(string unit, double v)
Public Shared Function SecondaryToSI(unit As String, v As Double) As Double

SecondaryUnits(IUnitsOfMeasure, string): The flowsheet unit a property's target is shown in, and the one its tolerance is shown in ('' when unitless or unknown).

The flowsheet unit a property's target is shown in, and the one its tolerance is shown in ("" when unitless or unknown).

Parameter Type Description
su IUnitsOfMeasure
property String
public static Tuple<string, string> SecondaryUnits(IUnitsOfMeasure su, string property)
Public Shared Function SecondaryUnits(su As IUnitsOfMeasure, [property] As String) As Tuple(Of String, String)

SecondaryVariableOptions(DwcConfiguration): The free variables of the current configuration, in the order the editors list them.

The free variables of the current configuration, in the order the editors list them.

Parameter Type Description
cfg DwcConfiguration
public List<DividedWallColumnUnitOperation.SecondaryVariableOption> SecondaryVariableOptions(DwcConfiguration cfg = null)
Public Function SecondaryVariableOptions(cfg As DwcConfiguration = Nothing) As List(Of DividedWallColumnUnitOperation.SecondaryVariableOption)

SecondCondenserDutyStream(): The energy stream on the product side condenser duty port (wall at the top), or null.

The energy stream on the product side condenser duty port (wall at the top), or null.

public EnergyStream SecondCondenserDutyStream()
Public Function SecondCondenserDutyStream() As EnergyStream

SecondReboilerDutyStream(): The energy stream on the product side reboiler duty port (wall at the bottom), or null.

The energy stream on the product side reboiler duty port (wall at the bottom), or null.

public EnergyStream SecondReboilerDutyStream()
Public Function SecondReboilerDutyStream() As EnergyStream

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

SideSpecUnit(DwcSideSpecType, IUnitsOfMeasure): Display unit of a side draw specification value.

Display unit of a side draw specification value.

Parameter Type Description
t DwcSideSpecType
su IUnitsOfMeasure
public static string SideSpecUnit(DwcSideSpecType t, IUnitsOfMeasure su)
Public Shared Function SideSpecUnit(t As DwcSideSpecType, su As IUnitsOfMeasure) As String

SolveConfiguration(DwcConfiguration, DwcWarmStart, out DwcWarmStart, Action<string>): Solves a configuration with the connected feeds without writing the products: used by the design tools (side draw...

Solves a configuration with the connected feeds without writing the products: used by the design tools (side draw sweep, interlink optimization). Checks the subscription level.

Parameter Type Description
cfg DwcConfiguration
warmStart DwcWarmStart
solution DwcWarmStart
log Action<String>
public DwcResults SolveConfiguration(DwcConfiguration cfg, DwcWarmStart warmStart, out DwcWarmStart solution, Action<string> log = null)
Public Function SolveConfiguration(cfg As DwcConfiguration, warmStart As DwcWarmStart, solution As DwcWarmStart, log As Action(Of String) = Nothing) As DwcResults

ToDisplay(double, string): Converts a value from SI to unit (unchanged when the unit is not a known one).

Converts a value from SI to unit (unchanged when the unit is not a known one).

Parameter Type Description
si Double
unit String
public static double ToDisplay(double si, string unit)
Public Shared Function ToDisplay(si As Double, unit As String) As Double

ToSI(double, string): Converts a value in unit to SI (unchanged when the unit is not a known one).

Converts a value in unit to SI (unchanged when the unit is not a known one).

Parameter Type Description
v Double
unit String
public static double ToSI(double v, string unit)
Public Shared Function ToSI(v As Double, unit As String) As Double

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.

public override void UpdateEditForm()
Public Overrides Sub UpdateEditForm()

Fields

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

The classic (WinForms) editor open for this unit, if any. Not saved.

public FormEditorDividedWallColumn _editorForm
Public _editorForm As FormEditorDividedWallColumn

BottomsPort: Outlet port of the bottoms product.

Outlet port of the bottoms product.

public const int BottomsPort = 1
Public Const BottomsPort As Integer = 1

ChartCompositionMain: Chart name: liquid mole fractions along the product side path.

Chart name: liquid mole fractions along the product side path.

public const string ChartCompositionMain = "Liquid Composition (Product Side)"
Public Const ChartCompositionMain As String = "Liquid Composition (Product Side)"

ChartCompositionPre: Chart name: liquid mole fractions along the feed side path.

Chart name: liquid mole fractions along the feed side path.

public const string ChartCompositionPre = "Liquid Composition (Prefractionator Side)"
Public Const ChartCompositionPre As String = "Liquid Composition (Prefractionator Side)"

ChartFlows: Chart name: liquid and vapor flows against elevation.

Chart name: liquid and vapor flows against elevation.

public const string ChartFlows = "Liquid and Vapor Flows"
Public Const ChartFlows As String = "Liquid and Vapor Flows"

ChartPressure: Chart name: pressure against elevation on both sides of the wall.

Chart name: pressure against elevation on both sides of the wall.

public const string ChartPressure = "Pressure Profile"
Public Const ChartPressure As String = "Pressure Profile"

ChartTemperature: Chart name: temperature against elevation on both sides of the wall.

Chart name: temperature against elevation on both sides of the wall.

public const string ChartTemperature = "Temperature Profile"
Public Const ChartTemperature As String = "Temperature Profile"

ChartTracking: Chart name: molecular tracking probability of the tracked compound.

Chart name: molecular tracking probability of the tracked compound.

public const string ChartTracking = "Molecular Tracking"
Public Const ChartTracking As String = "Molecular Tracking"

DistillatePort: Outlet port of the distillate (the overhead vapor with a partial condenser).

Outlet port of the distillate (the overhead vapor with a partial condenser).

public const int DistillatePort = 0
Public Const DistillatePort As Integer = 0

FirstFeedPort: Inlet port of the first feed; the other feeds follow, and the reboiler duty takes the last inlet port.

Inlet port of the first feed; the other feeds follow, and the reboiler duty takes the last inlet port.

public const int FirstFeedPort = 0
Public Const FirstFeedPort As Integer = 0

FirstSidePort: Outlet port of the first side product; the other side products follow, and the condenser duty takes the last outlet...

Outlet port of the first side product; the other side products follow, and the condenser duty takes the last outlet port.

public const int FirstSidePort = 2
Public Const FirstSidePort As Integer = 2

RequiredAccessLevel: Patreon subscription level needed to calculate and save this unit.

Patreon subscription level needed to calculate and save this unit.

public const int RequiredAccessLevel = 2
Public Const RequiredAccessLevel As Integer = 2