Asphaltenes (PC-SAFT)¶
DWSIM Plus
Available with a DWSIM Plus (Patreon) subscription.
PC-SAFT for crude oils with asphaltenes, after Chapman and co-workers (Ting 2003, Gonzalez 2005-2008, Panuganti 2012): no association term, the asphaltene a single pre-aggregated pseudo-component, and its precipitation a second, asphaltene-rich liquid. The oil is described by the light gases from the database and the SARA pseudo-components that AsphalteneCharacterization creates (heavy gas, saturates, aromatics + resins, asphaltenes). Those carry their PC-SAFT parameters and SARA class in the compound's extra properties; the package reads them, and fills the binary parameters of each pair from the SARA class when the pair has none of its own.
DWSIM.Extensions.PropertyPackages.Asphaltenes.AsphaltenesPropertyPackage
Assembly DWSIM.Extensions.PropertyPackages.Asphaltenes.dll · Object ← PropertyPackage ← PCSAFT2PropertyPackage ← AsphaltenesPropertyPackage
Name in the flowsheet Asphaltenes (PC-SAFT) · FluentAPI PropertyPackages.Plus.Asphaltenes
Scope¶
The package predicts asphaltene precipitation from crude oils with the PC-SAFT equation of state, in the
approach of Chapman and co-workers: the asphaltene is a pre-aggregated, non-associating pseudo-component of
1700 g/mol, and precipitation is the split of the oil into a second, asphaltene-rich liquid. It is the
PC-SAFT package with a flash of its own, a characterization of the oil and a table of binary
parameters (asph_kij.dat). The asphaltene-rich liquid is reported in the stream's solid phase, so the
precipitated amount reads as the solid flow and a separator or a filter can take it out.
Characterization: The oil is entered as its light gases (database compounds), an optional
C4-C6 heavy-gas lump and the stock-tank oil with its molar mass, density and SARA
analysis (saturates, aromatics, resins, asphaltenes in wt%). The stock-tank oil becomes three
pseudo-components: saturates, aromatics + resins and asphaltenes, with PC-SAFT parameters from the
correlations of Panuganti et al. (2012). Saturates follow the n-alkane correlations; aromatics + resins and
asphaltenes blend a benzene-derivative and a polynuclear-aromatic correlation through an aromaticity
γ. The aromaticity of the aromatics + resins is set so that the model matches the stock-tank oil
density at 15 °C. A separator gas and oil can be recombined at a gas-oil ratio instead of entering the
live fluid composition. The Asphaltene Characterization tool (Utilities menu) does this and adds the
compounds, the package and a stream to the flowsheet; from scripts, Flowsheet.WithAsphalteneOil.
Flash: The PC-SAFT vapor-liquid flash runs first. A stability test on the oil liquid, started from asphaltene-rich trial phases, decides whether an asphaltene phase forms; a trial counts only when it is enriched in asphaltene, so a stable oil never splits on numerical noise. An unstable oil is split by successive substitution followed by Newton on the mole numbers, and below the bubble point the vapor, the oil and the asphaltene-rich liquid are solved together. PH, PS, TV and PV flashes iterate on this PT flash.
Tools: The Asphaltene Envelope tool draws the bubble-point line and the upper and lower onset pressures against temperature, also with gas injected (CO2, N2, a hydrocarbon gas), the precipitated amount along an isotherm and the onset of a titration of the dead oil with a precipitant (n-heptane, n-pentane). The Asphaltene Tuning tool fits the asphaltene aromaticity or dispersion energy to measured onset pressures; one measured onset at one temperature is usually enough. The Pipe Network flow assurance report computes the precipitated amount along a pipe whose fluid uses this package.
Validation: With the parameters of Panuganti et al. for Jamaluddin's fluid A (SPE 74393), the bubble point, upper and lower onsets at 361-440 K and the onsets with 5-20 mol% N2 agree with the ThermoPack implementation of PC-SAFT within 0.05 %, and the precipitated amount along the 400 K isotherm within 0.01 percentage point.
Example¶
This code runs on every build of this site, and the output below is what it printed.
# Jamaluddin's fluid A (SPE 74393): the gas compounds, a C4-C6 heavy gas and the stock-tank oil
oil = AsphalteneCase()
for name, pct in [("Nitrogen", 0.496), ("Carbon dioxide", 11.38), ("Hydrogen sulfide", 3.219),
("Methane", 27.36), ("Ethane", 9.361), ("Propane", 6.47)]:
oil.WithGas(name, pct)
oil.HeavyGas, oil.HeavyGasMolPct, oil.HeavyGasMW = True, 6.116, 67.1
oil.StockTankOilMolPct, oil.StockTankOilMW, oil.StockTankOilDensity = 35.617, 229.2, 865.0
oil.Saturates, oil.Aromatics, oil.Resins, oil.Asphaltenes = 57.4, 30.8, 10.4, 1.4 # SARA, wt%
oil.AromaticsResinsToSaturatesMW = 1.4258
# the asphaltene parameters fitted to the measured onsets (Panuganti et al., 2012)
oil.UseAsphalteneParameters = True
oil.AsphalteneM, oil.AsphalteneSigma, oil.AsphalteneEpsilon = 28.0, 4.35, 413.2
fs = (Flowsheet.Create("AsphaltenesExample")
.WithCompounds("Nitrogen", "Carbon dioxide", "Hydrogen sulfide", "Methane", "Ethane", "Propane")
.WithAsphalteneOil(oil, "Reservoir Oil")) # adds the pseudo-components, the package and the stream
feed = fs.MaterialStream("Reservoir Oil").At(Q.Kelvin(400.0), Q.Bar(300.0)).WithMassFlow(Q.KgPerSecond(10.0))
outlet = fs.AddMaterialStream("Choke Outlet")
fs.AddValve("Choke").WithOutletPressure(Q.Bar(200.0)).ConnectFeed(feed).ConnectProduct(outlet)
fs.AutoLayout()
fs.Solve()
out = outlet.Object
solid = out.Phases[7] # the asphaltene-rich phase is reported as the solid
asph = out.Phases[0].Compounds["Asphaltenes"].MassFlow
print(f"Outlet temperature = {out.GetTemperature() - 273.15:.1f} C")
print(f"Precipitate = {solid.Properties.massflow:.4f} kg/s, "
f"{100 * solid.Compounds['Asphaltenes'].MassFlow / asph:.1f} % of the asphaltenes")
print(f"Asphaltenes in the deposit = {100 * solid.Compounds['Asphaltenes'].MassFraction:.1f} wt%")
# bubble point and the upper and lower onsets at 400 K
study = AsphalteneStudyInput()
study.TMin, study.TMax, study.TPoints, study.Isotherm = 400.0, 400.0, 1, False
point = fs.AsphalteneEnvelope("Reservoir Oil", study).Envelopes[0].Item2[0]
print(f"Upper onset at 400 K = {point.UpperOnset / 1e5:.1f} bar")
print(f"Bubble point at 400 K = {point.BubblePressure / 1e5:.1f} bar")
print(f"Lower onset at 400 K = {point.LowerOnset / 1e5:.1f} bar")
Output
Outlet temperature = 129.8 C
Precipitate = 0.0611 kg/s, 28.4 % of the asphaltenes
Asphaltenes in the deposit = 52.1 wt%
Upper onset at 400 K = 249.5 bar
Bubble point at 400 K = 197.6 bar
Lower onset at 400 K = 175.6 bar
DWSIM 10.2.16.0, generated 2026-11-11.
Property methods¶
How the package calculates each property, as it reports it in PropertyMethodsInfo (the property package editor shows the same list).
| Property | Method |
|---|---|
| Vapor fugacity | PC-SAFT EOS |
| Liquid fugacity | PC-SAFT EOS |
| Vapor enthalpy, entropy, Cp/Cv | Lee-Kesler for mixtures without associating compounds (default) / PC-SAFT EOS |
| Liquid enthalpy, entropy, Cp/Cv | Lee-Kesler for mixtures without associating compounds (default) / PC-SAFT EOS |
| Vapor density | PC-SAFT EOS |
| Liquid density | PC-SAFT EOS |
| Vapor viscosity | Experimental / Lucas / Jossi-Stiel-Thodos |
| Liquid viscosity | Experimental / Letsou-Stiel |
| Vapor thermal conductivity | Experimental / Ely-Hanley |
| Liquid thermal conductivity | Experimental / Latini |
| Surface tension | Experimental / Brock-Bird |
| Solid density | PC-SAFT EOS (the asphaltene-rich liquid reported as the solid phase) |
| Solid enthalpy, entropy, Cp/Cv | As the liquid phase, with no heat of fusion (the precipitate is an asphaltene-rich liquid) |
Default flash algorithm: Universal.
Configuration saved with the flowsheet¶
The package writes its settings to the simulation file (SaveData) and reads them back on load (LoadData). The elements below are the ones this package adds to those of every property package, as written for the example.
| Element | Content in the example | What it holds |
|---|---|---|
UseLeeKeslerEnthalpy |
true |
Lee-Kesler enthalpy and entropy for mixtures without an associating compound (true by default); the asphaltene model has no association, so the PC-SAFT departure functions are used only when the flowsheet holds water, an alcohol or another associating compound |
UseLeeKeslerCpCv |
true |
The same switch for Cp and Cv |
InteractionParameters |
41 InteractionParameter entries (Compound1, Compound2, CAS1, CAS2, Value) |
kij (Value) and kij,T (ValueT, 1/K, written when not zero) of the pairs of the flowsheet compounds, from the asphaltene table (asph_kij.dat, by compound or by SARA class) or entered in the editor |
CompoundParameters |
10 CompoundParameterSet entries (Compound, CAS_ID, MW, m, sigma, epsilon_k, assocparam, kAiBi, epsilon_AiBi, m_over_M, scheme, copolymer, coseq) |
PC-SAFT parameters of the flowsheet compounds (m, σ in Å, ε/k in K); the pseudo-components also carry their SARA class and parameters in the compound itself, so a saved flowsheet keeps them |
First InteractionParameter of InteractionParameters in the example
First CompoundParameterSet of CompoundParameters in the example
Settings common to every property package, as saved for the example
| Element | Value |
|---|---|
Type |
72 characters |
ComponentName |
Asphaltenes (PC-SAFT) |
ComponentDescription |
120 characters |
Tag |
Asphaltenes (PC-SAFT) |
UseHenryConstants |
true |
AutoEstimateMissingNRTLUNIQUACParameters |
true |
UseImmiscibleListForLiquid2InitialEstimates |
true |
SingleCompoundCheckThreshold |
0.99999 |
OverrideKvalFugCoeff |
false |
OverrideEnthalpyCalculation |
false |
OverrideEntropyCalculation |
false |
LiquidDensityCalculationMode_Subcritical |
Rackett_and_ExpData |
LiquidDensityCalculationMode_Supercritical |
Rackett_and_ExpData |
LiquidDensity_CorrectExpDataForPressure |
true |
LiquidDensity_UsePenelouxVolumeTranslation |
true |
LiquidViscosityCalculationMode_Subcritical |
ExpData |
LiquidViscosityCalculationMode_Supercritical |
Letsou_Stiel |
LiquidViscosity_CorrectExpDataForPressure |
true |
LiquidViscosity_MixingRule |
MoleAverage |
VaporPhaseFugacityCalculationMode |
Ideal |
SolidPhaseFugacityCalculationMethod |
FromLiquidFugacity |
SolidPhaseFugacity_UseIdealLiquidPhaseFugacity |
false |
SolidPhaseEnthalpy_UsesCp |
false |
EnthalpyEntropyCpCvCalculationMode |
LeeKesler |
LiquidEnthalpyEntropyCpCvCalculationMode_EOS |
EOS |
LiquidFugacity_UsePoyntingCorrectionFactor |
true |
ActivityCoefficientModels_IgnoreMissingInteractionParameters |
false |
IgnoreVaporFractionLimit |
false |
IgnoreSalinityLimit |
false |
CalculateAdditionalMaterialStreamProperties |
true |
FlashCalculationApproach |
NestedLoops |
DisplayMissingCompoundPropertiesWarning |
false |
ForcedSolids |
[] |
PropertyOverrides |
{} |
FlashSettings |
36 Setting entries |
Learn more¶
-
User guide
-
Used with
API members¶
Public members declared by this class. Inherited members are documented on the base classes.
Constructors¶
Properties¶
FlashBase: The package's own flash: the PC-SAFT flash plus the asphaltene-rich liquid.
The package's own flash: the PC-SAFT flash plus the asphaltene-rich liquid.
Methods¶
AUX_SOLIDDENS(): Density of the precipitate: the PC-SAFT liquid density at its composition.
Density of the precipitate: the PC-SAFT liquid density at its composition.
Clone()
DefaultPairKij(ICompoundConstantProperties, ICompoundConstantProperties): The default kij of a compound pair from asph_kij.dat: by CAS number where the table has the compound (the light...
The default kij of a compound pair from asph_kij.dat: by CAS number where the table has the compound (the light gases, n-heptane), by SARA class otherwise; null when the method has none (the pair then keeps pcsaft_ip.dat, or zero).
| Parameter | Type | Description |
|---|---|---|
a |
ICompoundConstantProperties |
|
b |
ICompoundConstantProperties |
DW_CalcEnthalpy(Array, double, double, State): Calculates the enthalpy of a mixture.
Calculates the enthalpy of a mixture.
| Parameter | Type | Description |
|---|---|---|
Vx |
Array |
Vector of doubles containing the molar composition of the mixture. |
T |
Double |
Temperature (K) |
P |
Double |
Pressure (Pa) |
st |
State |
State enum indicating the state of the mixture (liquid or vapor). |
DW_CalcEnthalpyDeparture(Array, double, double, State): Calculates the enthalpy departure of a mixture.
Calculates the enthalpy departure of a mixture.
| Parameter | Type | Description |
|---|---|---|
Vx |
Array |
Vector of doubles containing the molar composition of the mixture. |
T |
Double |
Temperature (K) |
P |
Double |
Pressure (Pa) |
st |
State |
State enum indicating the state of the mixture (liquid or vapor). |
DW_CalcEntropy(Array, double, double, State): Calculates the entropy of a mixture.
Calculates the entropy of a mixture.
| Parameter | Type | Description |
|---|---|---|
Vx |
Array |
Vector of doubles containing the molar composition of the mixture. |
T |
Double |
Temperature (K) |
P |
Double |
Pressure (Pa) |
st |
State |
State enum indicating the state of the mixture (liquid or vapor). |
DW_CalcEntropyDeparture(Array, double, double, State): Calculates the entropy departure of a mixture.
Calculates the entropy departure of a mixture.
| Parameter | Type | Description |
|---|---|---|
Vx |
Array |
Vector of doubles containing the molar composition of the mixture. |
T |
Double |
Temperature (K) |
P |
Double |
Pressure (Pa) |
st |
State |
State enum indicating the state of the mixture (liquid or vapor). |
DW_CalcSolidHeatCapacityCp(double, double[], List<ICompoundConstantProperties>): Heat capacity of the precipitate, from the slope of its (liquid) enthalpy.
Heat capacity of the precipitate, from the slope of its (liquid) enthalpy.
| Parameter | Type | Description |
|---|---|---|
T |
Double |
|
Vx |
Double[] |
|
cprops |
List<ICompoundConstantProperties> |
EnsureParameters(IEnumerable<ICompoundConstantProperties>): Gives every characterized compound of the given set its PC-SAFT parameters, and every pair without a kij of its own...
Gives every characterized compound of the given set its PC-SAFT parameters, and every pair without a kij of its own the default of its classes. A pair the user edited (or a file restored) keeps its value.
| Parameter | Type | Description |
|---|---|---|
compounds |
IEnumerable<ICompoundConstantProperties> |
LoadData(List<XElement>)
| Parameter | Type | Description |
|---|---|---|
data |
List<XElement> |
ReturnInstance(string)
| Parameter | Type | Description |
|---|---|---|
typename |
String |
RunPostMaterialStreamSetRoutine()
SaveData()
SupportsComponent(ICompoundConstantProperties)
| Parameter | Type | Description |
|---|---|---|
comp |
ICompoundConstantProperties |
Fields¶
ClassId
EnvelopeSettings: The last settings of the Asphaltene Envelope tool for a stream of this package; saved with the flowsheet.
The last settings of the Asphaltene Envelope tool for a stream of this package; saved with the flowsheet.
PackageName
TuningSet: The last inputs of the Asphaltene Tuning tool (measured onsets) for a stream of this package; saved with the flowsheet.
The last inputs of the Asphaltene Tuning tool (measured onsets) for a stream of this package; saved with the flowsheet.