Reactor_ Equilibrium Class
Represents an Equilibrium Reactor that determines product composition by minimising the
Gibbs free energy along reaction-extent coordinates for a set of equilibrium-type reactions.
Supports isothermal, adiabatic, and outlet-temperature operating modes.
Definition
Namespace: DWSIM.UnitOperations.Reactors
Assembly: DWSIM.UnitOperations (in DWSIM.UnitOperations.dll) Version: 10.0.0.0
Assembly: DWSIM.UnitOperations (in DWSIM.UnitOperations.dll) Version: 10.0.0.0
C#
[SerializableAttribute]
public class Reactor_Equilibrium : ReactorVB
<SerializableAttribute>
Public Class Reactor_Equilibrium
Inherits Reactor- Inheritance
- Object BaseClass UnitOpBaseClass Reactor Reactor_Equilibrium
Constructors
| Reactor_Equilibrium | Initializes a new default instance of the Reactor_Equilibrium class. |
| Reactor_Equilibrium(String, String) | Initializes a new instance of the Reactor_Equilibrium class with a name and description. |
Properties
| AdjustVarType |
If an Adjust object is attached to this object, returns a variable describing how this object is used by it (manipulated, controlled or reference).
(Inherited from BaseClass) |
| Annotation | (Inherited from BaseClass) |
| AttachedAdjustId |
If an Adjust object is attached to this object, returns its ID.
(Inherited from BaseClass) |
| AttachedInfoCarrierId | (Inherited from BaseClass) |
| AttachedSpecId |
If an Specification object is attached to this object, returns its ID.
(Inherited from BaseClass) |
| AttachedUtilities | (Inherited from BaseClass) |
| Bottom | (Inherited from BaseClass) |
| Calculated | (Inherited from BaseClass) |
| CanUsePreviousResults | (Inherited from BaseClass) |
| ComponentConversions | Gets the dictionary of calculated component conversions, keyed by compound name. (Inherited from Reactor) |
| ComponentDescription |
Gets or sets the CAPE-OPEN component description for this unit operation.
(Inherited from UnitOpBaseClass) |
| ComponentIDs | Gets or sets the list of compound IDs participating in the equilibrium reactions. |
| ComponentName |
Gets or sets the CAPE-OPEN component name for this unit operation.
(Inherited from UnitOpBaseClass) |
| Conversions | Gets the dictionary of calculated reaction conversions, keyed by reaction ID. (Inherited from Reactor) |
| CreateChartAction | (Inherited from BaseClass) |
| DebugMode | (Inherited from BaseClass) |
| DebugText | (Inherited from BaseClass) |
| DeltaP | Gets or sets the pressure drop across the reactor (Pa). (Inherited from Reactor) |
| DeltaQ | Gets or sets the heat duty exchanged by the reactor (kW). (Inherited from Reactor) |
| DeltaT | Gets or sets the temperature change across the reactor (K). (Inherited from Reactor) |
| DetailedDebugReport | (Inherited from BaseClass) |
| Dimensions |
Gets or sets the list of physical dimensions (e.g. vessel diameter, length) associated with this unit operation.
(Inherited from UnitOpBaseClass) |
| DynamicsOnly | (Inherited from BaseClass) |
| DynamicsSpec | (Inherited from BaseClass) |
| EnergyFlow |
Energy Flow property. Only implemented for Energy Streams.
(Inherited from BaseClass) |
| EquipmentTypes |
Gets the list of available equipment type names supported by this unit operation.
(Inherited from UnitOpBaseClass) |
| ErrorMessage |
Gets or sets the error message regarding the last calculation attempt.
(Inherited from BaseClass) |
| ExternalLoopMaximumIterations | Gets or sets the maximum number of iterations for the outer energy-balance loop. |
| ExternalLoopTolerance | Gets or sets the convergence tolerance for the outer (energy-balance) iteration loop. |
| ExternalSolverConfigData |
Gets or sets serialized configuration data for the external solver associated with this unit operation.
(Inherited from UnitOpBaseClass) |
| ExternalSolverID |
Gets or sets the unique identifier of an external solver to be used for this unit operation.
(Inherited from UnitOpBaseClass) |
| ExtraProperties | (Inherited from BaseClass) |
| ExtraPropertiesDescriptions | (Inherited from BaseClass) |
| ExtraPropertiesTypes | (Inherited from BaseClass) |
| ExtraPropertiesUnitTypes | (Inherited from BaseClass) |
| FinalGibbsEnergy | Gets or sets the final total Gibbs free energy of the system (kJ/mol) after reaction. |
| FlowSheet |
Gets the current flowsheet where this object is located.
(Inherited from BaseClass) |
| GHGEmissionData | (Inherited from BaseClass) |
| GraphicObject |
Gets or sets the graphic object representation of this object in the flowsheet.
(Inherited from BaseClass) |
| HasPropertiesForDynamicMode | Gets a value indicating whether this reactor exposes dedicated dynamic-mode properties. (Overrides BaseClassHasPropertiesForDynamicMode) |
| Height | (Inherited from BaseClass) |
| InfoCarrierVarType | (Inherited from BaseClass) |
| InitialGibbsEnergy | Gets or sets the initial total Gibbs free energy of the system (kJ/mol) before reaction. |
| InternalLoopMaximumIterations | Gets or sets the maximum number of iterations for the inner optimisation loop. |
| InternalLoopTolerance | Gets or sets the convergence tolerance for the inner (reaction-extent) optimisation loop. |
| IsAdjustAttached |
Checks if an Adjust operation is attached to this object.
(Inherited from BaseClass) |
| IsDirty | (Inherited from BaseClass) |
| IsFunctional | (Inherited from BaseClass) |
| IsInfoCarrierAttached | (Inherited from BaseClass) |
| IsSink | (Inherited from BaseClass) |
| IsSource | (Inherited from BaseClass) |
| IsSpecAttached |
Checks if an Specification operation is attached to this object.
(Inherited from BaseClass) |
| LastSolutionInputSnapshot | (Inherited from BaseClass) |
| LastUpdated | (Inherited from BaseClass) |
| Left | (Inherited from BaseClass) |
| MobileCompatible | Gets a value indicating whether this reactor is compatible with mobile/cross-platform interfaces. (Overrides BaseClassMobileCompatible) |
| Name |
Object's Unique ID (Name)
(Inherited from BaseClass) |
| ObjectClass | Gets or sets the simulation object class category (Reactors). (Inherited from Reactor) |
| OutletTemperature | Gets or sets the specified reactor outlet temperature (K) when OutletTemperature is selected. (Inherited from Reactor) |
| OverrideCalculationRoutine | (Inherited from BaseClass) |
| ParticleSizeDistributions |
Gets or sets the dictionary of particle size distribution data, keyed by compound or stream name.
(Inherited from UnitOpBaseClass) |
| Phases |
Phase collection, only implemented for Material Streams.
(Inherited from BaseClass) |
| PreferredFlashAlgorithmTag | (Inherited from BaseClass) |
| PreviousReactionExtents | Gets or sets the dictionary of reaction extents from the previous iteration, used for warm-starting. |
| ProductAssembly | (Inherited from BaseClass) |
| ProductAuthor | (Inherited from BaseClass) |
| ProductContactInfo | (Inherited from BaseClass) |
| ProductDescription | (Inherited from BaseClass) |
| ProductName | (Inherited from BaseClass) |
| ProductPage | (Inherited from BaseClass) |
| ProductVersion | (Inherited from BaseClass) |
| PropertyPackage |
Gets or sets the property package associated with this object.
(Inherited from UnitOpBaseClass) |
| ReactionExtents | Gets or sets the dictionary of calculated reaction extents, keyed by reaction ID. |
| Reactions | Gets or sets the list of active reaction IDs assigned to this reactor from the reaction set. (Inherited from Reactor) |
| ReactionSetID | Gets or sets the ID of the reaction set used by this reactor. (Inherited from Reactor) |
| ReactionSetName | Gets or sets the display name of the reaction set used by this reactor. (Inherited from Reactor) |
| ReactionsSequence | Gets or sets the ordered sequence of reaction groups (parallel reactions within each group are solved simultaneously). (Inherited from Reactor) |
| ReactorOperationMode | Gets or sets the thermal operating mode of the reactor (isothermal, adiabatic, outlet temperature, or non-isothermal/non-adiabatic). (Inherited from Reactor) |
| Right | (Inherited from BaseClass) |
| SelectedEquipmentType |
Gets or sets the name of the equipment type currently selected for this unit operation.
(Inherited from UnitOpBaseClass) |
| SpecVarType |
If an Specification object is attached to this object, returns a variable describing how this object is used by it (target or source).
(Inherited from BaseClass) |
| StoreDetailedDebugReport | (Inherited from BaseClass) |
| SupportsDynamicMode | Gets a value indicating whether this reactor supports dynamic simulation mode. (Overrides BaseClassSupportsDynamicMode) |
| SupportsParticleSizeDistributions |
Gets a value indicating whether this unit operation supports particle size distribution calculations.
(Inherited from UnitOpBaseClass) |
| SupportsRestoreStateAfterError |
Gets a value indicating whether this unit operation supports restoring its state after a solver error.
(Inherited from UnitOpBaseClass) |
| Top | (Inherited from BaseClass) |
| UseIPOPTSolver | Gets or sets whether the IPOPT solver is used for the optimisation (otherwise a simplex method is used). |
| UsePreviousSolution | Gets or sets whether the solver uses the previous solution as a starting point. |
| UserDefinedChartNames | (Inherited from BaseClass) |
| Visible | (Inherited from BaseClass) |
| Width | (Inherited from BaseClass) |
Methods
| AddButtonsToDynEditor | |
| AddDynamicProperty | (Inherited from BaseClass) |
| AddExtraProperty | (Inherited from BaseClass) |
| AppendDebugLine | (Inherited from BaseClass) |
| Calculate |
Performs the equilibrium reactor calculation by minimising Gibbs free energy along
the reaction-extent coordinates and solving the energy balance.
(Overrides BaseClassCalculate(Object)) |
| Calculate_Internal | Internal solver that minimises Gibbs energy using IPOPT or simplex to find the equilibrium extents. |
| Calculate_Internal_Old | Legacy internal solver method retained for backward compatibility. |
| Calculate_Relaxation | Solves the equilibrium reactions using a successive-relaxation approach, processing reactions one at a time. |
| CheckDirtyStatus |
Checks whether the unit operation's input data has changed since the last successful solve,
and updates the dirty flag accordingly.
(Inherited from UnitOpBaseClass) |
| CheckSpec |
Checks if a value is valid.
(Inherited from BaseClass) |
| ClearExtraProperties | (Inherited from BaseClass) |
| ClearPropertyPackageInstance |
Removes the externally set property package instance from this unit operation,
reverting to the flowsheet-level property package lookup.
(Inherited from UnitOpBaseClass) |
| Clone |
Clones the current object, returning a new one with identical properties.
(Inherited from BaseClass) |
| CloneJSON | Creates a deep copy of this reactor via JSON serialization. (Overrides BaseClassCloneJSON) |
| CloneXML | Creates a deep copy of this reactor via XML serialization. (Overrides BaseClassCloneXML) |
| CloseDynamicsEditForm | (Inherited from BaseClass) |
| CloseEditForm | Closes and disposes the editing form. (Overrides BaseClassCloseEditForm) |
| ConnectEnergyStream | (Inherited from BaseClass) |
| ConnectFeedEnergyStream | (Inherited from BaseClass) |
| ConnectFeedMaterialStream | (Inherited from BaseClass) |
| ConnectProductEnergyStream | (Inherited from BaseClass) |
| ConnectProductMaterialStream | (Inherited from BaseClass) |
| CopyDataToClipboard |
Copies the object properties to the Clipboard.
(Inherited from BaseClass) |
| CreateDimensionsList |
Initializes the list of equipment dimensions for this unit operation.
Override to populate the Dimensions collection with dimension entries.
(Inherited from UnitOpBaseClass) |
| CreateDynamicProperties | Registers the dynamic properties for dynamic simulation mode. (Overrides BaseClassCreateDynamicProperties) |
| CreateNew | (Inherited from BaseClass) |
| DeCalculate | Clears the calculated results from the outlet material streams. (Overrides UnitOpBaseClassDeCalculate) |
| DeCalculate(Object) | (Inherited from BaseClass) |
| DisplayDynamicsEditForm | Opens or activates the dynamics property editor form for this reactor. (Overrides BaseClassDisplayDynamicsEditForm) |
| DisplayEditForm | Opens or activates the editing form for this reactor. (Overrides BaseClassDisplayEditForm) |
| DisplayExtraPropertiesEditForm | (Inherited from BaseClass) |
| Dispose | (Inherited from BaseClass) |
| Dispose(Boolean) | (Inherited from BaseClass) |
| FT |
Formats a property string, adding its units in parenthesis.
(Inherited from BaseClass) |
| FunctionValue2G | |
| FunctionValue2G(Double) | |
| FunctionValue2N | |
| FunctionValueRLX | |
| GetAsObject | (Inherited from BaseClass) |
| GetBytesFromResource | (Inherited from BaseClass) |
| GetCalculationModes |
Returns the list of available calculation mode names for this unit operation.
(Inherited from UnitOpBaseClass) |
| GetChartModel | (Inherited from BaseClass) |
| GetChartModelNames | (Inherited from BaseClass) |
| GetConnectionPortsInfo | (Inherited from BaseClass) |
| GetConnectionPortsList | (Inherited from BaseClass) |
| GetConvFactors |
Calculates the concentration-unit conversion factors for every stoichiometric component in
the given reaction, based on the reaction basis (molar, mass, activity, fugacity, etc.).
(Inherited from Reactor) |
| GetDebugReport |
Runs the unit operation in debug mode and returns a formatted text report
containing intermediate calculation steps and any error information.
(Inherited from UnitOpBaseClass) |
| GetDebugWriter | (Inherited from BaseClass) |
| GetDefaultProperties | (Inherited from BaseClass) |
| GetDisplayDescription | Returns the localised display description for this reactor. (Overrides BaseClassGetDisplayDescription) |
| GetDisplayName | Returns the localised display name for this reactor. (Overrides BaseClassGetDisplayName) |
| GetDynamicContents |
Returns the current mass held in the accumulation stream of this unit operation.
(Inherited from UnitOpBaseClass) |
| GetDynamicProperty | (Inherited from BaseClass) |
| GetDynamicPropertyUnitType | (Inherited from BaseClass) |
| GetDynamicResidenceTime |
Returns the dynamic residence time of this unit operation, computed as volume divided
by the total volumetric inlet flow rate.
(Inherited from UnitOpBaseClass) |
| GetDynamicVolume |
Returns the dynamic volume of this unit operation from its dynamic property store.
(Inherited from UnitOpBaseClass) |
| GetEditingForm | (Inherited from BaseClass) |
| GetEnergyBalanceResidual | (Inherited from BaseClass) |
| GetEnergyConsumption |
Returns the total energy consumed by this unit operation by summing the energy flows
from all connected energy streams and the energy connector.
(Inherited from UnitOpBaseClass) |
| GetExtraPropertyValue | (Inherited from BaseClass) |
| GetFlowsheet | (Inherited from BaseClass) |
| GetIconBitmap | Returns the icon bitmap resource for this unit operation. (Overrides BaseClassGetIconBitmap) |
| GetIconBitmapBytes | Returns the icon bitmap as a byte array. (Overrides BaseClassGetIconBitmapBytes) |
| GetKeyPropertyNames |
Returns the names of the key output properties reported by this unit operation.
(Inherited from UnitOpBaseClass) |
| GetKeyPropertyUnits |
Returns the display unit string for a named key property.
(Inherited from UnitOpBaseClass) |
| GetKeyPropertyValue |
Returns the current numeric value of a named key property in SI units.
(Inherited from UnitOpBaseClass) |
| GetMassBalanceResidual | (Inherited from BaseClass) |
| GetPowerGeneratedOrConsumed | (Inherited from BaseClass) |
| GetPreferredGraphicObjectHeight | (Inherited from BaseClass) |
| GetPreferredGraphicObjectWidth | (Inherited from BaseClass) |
| GetProperties | Returns an array of property identifiers for the specified property type. (Overrides BaseClassGetProperties(PropertyType)) |
| GetProperties2 | (Inherited from BaseClass) |
| GetPropertyDescription | Returns a human-readable description of the specified property. (Overrides BaseClassGetPropertyDescription(String)) |
| GetPropertyUnit | Returns the unit string for the specified property. (Overrides BaseClassGetPropertyUnit(String, IUnitsOfMeasure)) |
| GetPropertyUnits2 | (Inherited from BaseClass) |
| GetPropertyValue | Returns the value of the specified property, converted to the given unit system. (Overrides UnitOpBaseClassGetPropertyValue(String, IUnitsOfMeasure)) |
| GetPropertyValue2 | (Inherited from BaseClass) |
| GetReport | Generates a plain-text report of the reactor results using the specified units and format. (Overrides BaseClassGetReport(IUnitsOfMeasure, CultureInfo, String)) |
| GetStructuredReport | Generates a structured report of the reactor results as a list of typed tuples. (Overrides BaseClassGetStructuredReport) |
| GetVersion | (Inherited from BaseClass) |
| IsDynamicProperty | (Inherited from BaseClass) |
| LoadData | Restores the reactor state, including reaction extents and component IDs, from XML. (Overrides ReactorLoadData(ListXElement)) |
| ObjectCopy | (Inherited from BaseClass) |
| PerformPostCalcValidation | (Inherited from BaseClass) |
| ProcessAdvancedKineticReactionRate |
Evaluates a user-defined Python script that returns the reaction rate for an advanced
kinetic expression. The script receives the reactor, reaction, temperature, pressure, and
component amounts as variables and must set the variable r to the computed rate.
(Inherited from Reactor) |
| RemoveDynamicProperty | (Inherited from BaseClass) |
| RemoveExtraProperty | (Inherited from BaseClass) |
| ReturnPenaltyValue | |
| RunDynamicModel | Executes one dynamic simulation time step for the equilibrium reactor. (Overrides BaseClassRunDynamicModel) |
| SaveData | Serializes the reactor state, including reaction extents and component IDs, to XML. (Overrides ReactorSaveData) |
| SetCalculationMode |
Sets the active calculation mode for this unit operation by numeric identifier.
(Inherited from UnitOpBaseClass) |
| SetCanUsePreviousResults | (Inherited from BaseClass) |
| SetDirtyStatus | (Inherited from BaseClass) |
| SetDynamicProperty | (Inherited from BaseClass) |
| SetExtraPropertyValue | (Inherited from BaseClass) |
| SetFlowsheet |
Sets the Flowsheet to which this object belongs to.
(Inherited from BaseClass) |
| SetKeyPropertyValue |
Sets the value of a named key property, converting from the supplied units to SI internally.
(Inherited from UnitOpBaseClass) |
| SetPropertyPackageInstance |
Assigns an externally supplied property package instance to this unit operation,
bypassing the flowsheet-level property package lookup.
(Inherited from UnitOpBaseClass) |
| SetPropertyValue | Sets the value of the specified property from the given value and unit system. (Overrides BaseClassSetPropertyValue(String, Object, IUnitsOfMeasure)) |
| SetPropertyValue2 | (Inherited from BaseClass) |
| Solve |
Solves the unit operation, optionally saving and restoring state on error
when the flowsheet option RestoreUnitOperationStateAfterError is enabled.
(Inherited from UnitOpBaseClass) |
| StoreDebugReport | (Inherited from BaseClass) |
| ToString | (Inherited from BaseClass) |
| TransferAdditionalSolidData | (Inherited from BaseClass) |
| Unsolve |
Decalculates the object.
(Inherited from UnitOpBaseClass) |
| UpdateDimensionsList |
Updates the equipment dimensions list after a successful calculation.
Override to refresh computed dimension values.
(Inherited from UnitOpBaseClass) |
| UpdateDynamicsEditForm | (Inherited from BaseClass) |
| UpdateEditForm | Refreshes the editing form with updated data. (Overrides BaseClassUpdateEditForm) |
| UpdateExtraPropertiesEditForm | (Inherited from BaseClass) |
| Validate | Validates that inlet and outlet streams are connected before calculation. (Overrides BaseClassValidate) |
Fields
Extension Methods
| GetEnergyStream | (Defined by StreamListExtender) |
| GetEnumNames | (Defined by General) |
| GetInletEnergyStream | (Defined by StreamListExtender) |
| GetInletMaterialStream | (Defined by StreamListExtender) |
| GetOutletEnergyStream | (Defined by StreamListExtender) |
| GetOutletMaterialStream | (Defined by StreamListExtender) |
| IsValidDouble | (Defined by General) |