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¶

| 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¶
-
Tutorials
-
FluentAPI
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.
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.
Config: Structure, specifications and solver options.
Structure, specifications and solver options.
IsPremium: Listed in the Premium group of the object palette.
Listed in the Premium group of the object palette.
MobileCompatible: Not available in the mobile interfaces (always false).
Not available in the mobile interfaces (always false).
ObjectClass: Simulation object class (columns).
Simulation object class (columns).
Prefix: Default name prefix ('DWC-').
Default name prefix ("DWC-").
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.
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 |
Calculate(object): Calculates the object.
Calculates the object.
| Parameter | Type | Description |
|---|---|---|
args |
Object |
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.
CloseEditForm(): Closes the editor of this object, if it is open.
Closes the editor of this object, if it is open.
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.
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.
DeCalculate(): Decalculates the object.
Decalculates the object.
DisplayEditForm(): Opens the editor of this object.
Opens the editor of this object. A host that has no editor for it does nothing.
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 |
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 |
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 |
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 |
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 |
GetChartModelNames(): Names of the charts this unit draws (the Chart* constants).
Names of the charts this unit draws (the Chart* constants).
GetDisplayDescription(): Returns the one-line description shown in the object palette.
Returns the one-line description shown in the object palette.
GetDisplayName(): Returns the display name, 'Divided-Wall Column'.
Returns the display name, "Divided-Wall Column".
GetIconBitmapBytes(): Palette icon (64 × 64 PNG).
Palette icon (64 × 64 PNG).
GetPreferredGraphicObjectHeight(): Default height of the flowsheet icon (180, as the distillation column).
Default height of the flowsheet icon (180, as the distillation column).
GetPreferredGraphicObjectWidth(): Default width of the flowsheet icon (144, as the distillation column).
Default width of the flowsheet icon (144, as the distillation column).
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. |
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. |
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. |
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 |
GetStructuredReport(): Structured report used by the datasheets and the report tools.
Structured report used by the datasheets and the report tools.
HasAccess(): True when the current subscription covers this unit.
True when the current subscription covers this unit.
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. |
PopulateEditorPanel(object): Populates the cross-platform (Avalonia) editor panel.
Populates the cross-platform (Avalonia) editor panel.
| Parameter | Type | Description |
|---|---|---|
ctner |
Object |
PrepareSolve(): Reads the connected feeds and prepares the property package.
Reads the connected feeds and prepares the property package.
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.
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 |
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.
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 |
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 |
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.
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 |
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 |
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 |
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.
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.
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. |
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 |
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> |
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 |
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 |
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.
Fields¶
_editorForm: The classic (WinForms) editor open for this unit, if any.
The classic (WinForms) editor open for this unit, if any. Not saved.
BottomsPort: Outlet port of the bottoms product.
Outlet port of the bottoms product.
ChartCompositionMain: Chart name: liquid mole fractions along the product side path.
Chart name: liquid mole fractions along the product side path.
ChartCompositionPre: Chart name: liquid mole fractions along the feed side path.
Chart name: liquid mole fractions along the feed side path.
ChartFlows: Chart name: liquid and vapor flows against elevation.
Chart name: liquid and vapor flows against elevation.
ChartPressure: Chart name: pressure against elevation on both sides of the wall.
Chart name: pressure against elevation on both sides of the wall.
ChartTemperature: Chart name: temperature against elevation on both sides of the wall.
Chart name: temperature against elevation on both sides of the wall.
ChartTracking: Chart name: molecular tracking probability of the tracked compound.
Chart name: molecular tracking probability of the tracked compound.
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).
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.
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.