You're reading the documentation for a development version. For the latest stable documentation, please have a look at v5.1.X.
Continuous stirred tank reactor model¶
Group /input/model/unit_XXX - UNIT_TYPE = CSTR¶
For information on model equations, refer to Continuous stirred tank reactor model (CSTR).
UNIT_TYPE
Specifies the type of unit operation model
Type: string
Range: \(\texttt{CSTR}\)
Length: 1
NCOMP
Number of chemical components in the chromatographic medium
Type: int
Range: \(\geq 1\)
Length: 1
NPARTYPE
Number of particle types (optional, defaults to 0). Each particle type is configured in its own group
particle_type_XXX, see below.
Type: int
Range: \(\geq 0\)
Length: 1
INIT_C
Initial concentrations for each component in the bulk liquid phase
Unit: \(\mathrm{mol}\,\mathrm{m}_{\mathrm{IV}}^{-3}\)
Type: double
Range: \(\geq 0\)
Length: \(\texttt{NCOMP}\)
The volumes are given by one of two mutually exclusive parameterizations. Specifying fields of both is an error.
Variable volume: \(\texttt{INIT_LIQUID_VOLUME}\) and \(\texttt{CONST_SOLID_VOLUME}\). The bulk liquid volume is a state that evolves with the net flow rate.
Constant volume: \(\texttt{LIQUID_VOLUME}\) and a porosity. The bulk liquid volume is prescribed and does not change.
The porosity is named after what it describes, consistently with the 1D column units. Particles that have pores hold liquid of their own, so the ratio is the one of the bulk liquid alone and the field is \(\texttt{COL_POROSITY}\). Particles in rapid equilibrium hold no liquid, so all of it is bulk liquid and the field is \(\texttt{TOTAL_POROSITY}\). Without particles, \(\texttt{NPARTYPE} = 0\), the field is \(\texttt{COL_POROSITY}\).
The bulk liquid volume is the liquid outside the particles. The liquid held in the particle pores belongs to the particle volume, not to it.
INIT_LIQUID_VOLUME
Initial volume of the bulk liquid of the variable volume parameterization
Unit: \(\mathrm{m}^{3}\)
Type: double
Range: \(\geq 0\)
Length: 1
CONST_SOLID_VOLUME
Total volume \(V^{p}\) of the particles of the variable volume parameterization, including the liquid in their pores. Required if \(\texttt{NPARTYPE} \geq 1\) and the particle types have pores, otherwise optional and defaulting to \(0\).
Unit: \(\mathrm{m}^{3}\)
Type: double
Range: \(\geq 0\)
Length: 1
LIQUID_VOLUME
Prescribed volume of the bulk liquid. Requires the flow rates to cancel in every section, that is \(F_{\text{in}} = F_{\text{out}} + F_{\text{filter}}\).
Unit: \(\mathrm{m}^{3}\)
Type: double
Range: \(> 0\)
Length: 1
COL_POROSITY / TOTAL_POROSITY
Ratio of the bulk liquid volume to the total volume, \(\varepsilon = V^{\ell} / (V^{\ell} + V^{p})\), where \(V^{p}\) is the total volume of the particles including their pore liquid. Which of the two names applies is described above. Only used together with \(\texttt{LIQUID_VOLUME}\) and fixes the particle volume to \(V^{p} = V^{\ell} (1 - \varepsilon) / \varepsilon\). Required if \(\texttt{NPARTYPE} \geq 1\), otherwise optional and defaulting to 1.
Type: double
Range: \((0,1]\)
Length: 1
Sensitivities are available with respect to \(\texttt{CONST_SOLID_VOLUME}\) in both parameterizations and with respect to the liquid volume under the name that was used to specify it, that is \(\texttt{INIT_LIQUID_VOLUME}\) or \(\texttt{LIQUID_VOLUME}\). Note that changing one of the two volumes leaves the other one untouched, so the porosity changes implicitly.
INIT_STATE
Full state vector for initialization (optional, \(\texttt{INIT_C}\), \(\texttt{INIT_CP}\), \(\texttt{INIT_CS}\), and the liquid volume field will be ignored; if length is \(2\texttt{NDOF}\), then the second half is used for time derivatives). The ordering of the state vector is defined in Unit Operation state vector ordering.
Unit: \(various\)
Type: double
Range: \(\mathbb{R}\)
Length: \(\texttt{NDOF} / 2\texttt{NDOF}\)
FLOWRATE_FILTER
Flow rate of pure liquid without components (optional, defaults to \(0\))
Unit: \(\mathrm{m}^{3}\,\mathrm{s}^{-1}\)
Type: double
Range: \(\geq 0\)
Length: \(1 / \texttt{NSEC}\)
PAR_TYPE_VOLFRAC
Volume fractions of the particle types, have to sum to 1. Required if \(\texttt{NPARTYPE} > 1\).
Type: double
Range: \([0,1]\)
Length: \(\texttt{NPARTYPE}\)
NREAC_LIQUID
Number of bulk liquid phase reaction models (optional, only if liquid reactions are present).
Type: int
Range: \(\geq 0\)
Length: 1
Group /input/model/unit_XXX/particle_type_XXX¶
One group per particle type, i.e. \(\texttt{NPARTYPE}\) groups numbered particle_type_000, particle_type_001, and so on.
Each holds the particle geometry, the film and pore transport, the binding model and the particle reactions, see Particle Model.
A particle type in rapid equilibrium with the bulk liquid only contributes bound states to the state vector, so apart from \(\texttt{HAS_FILM_DIFFUSION}\), which is required, the particle transport fields of Particle Model do not apply to it. Since the bulk liquid of a well mixed vessel is not flowing, a velocity dependent \(\texttt{FILM_DIFFUSION_DEP}\) is not supported.
ADSORPTION_MODEL
Specifies the type of binding model of this particle type
Type: string
Range: See Section Binding models
Length: 1
NBOUND
Number of bound states for each component of this particle type. The bound states are kept if \(\texttt{ADSORPTION_MODEL}\) is \(\texttt{NONE}\), which leaves states that solid phase and cross-phase reactions can act on.
Type: int
Range: \(\geq 0\)
Length: \(\texttt{NCOMP}\)
INIT_CP
Initial concentrations for each component in the particle liquid phase of this particle type. This field is optional and defaults to \(\texttt{INIT_C}\). A particle type in rapid equilibrium with the bulk liquid has no liquid phase of its own, so specifying it there is an error.
Unit: \(\mathrm{mol}\,\mathrm{m}_{\mathrm{MP}}^{-3}\)
Type: double
Range: \(\geq 0\)
Length: \(\texttt{NCOMP}\)
INIT_CS
Initial concentrations for each bound state of each component in the solid phase of this particle type in component-major ordering. This field is optional and defaults to all 0.
Unit: \(\mathrm{mol}\,\mathrm{m}_{\mathrm{SP}}^{-3}\)
Type: double
Range: \(\geq 0\)
Length: \(\texttt{NBOUND}\)
NREAC_SOLID
Number of solid phase reaction models of this particle type (optional, only if solid phase reactions are present).
Type: int
Range: \(\geq 0\)
Length: 1
NREAC_CROSS_PHASE
Number of cross-phase reaction models of this particle type (optional, only if cross-phase reactions are present).
Type: int
Range: \(\geq 0\)
Length: 1
Group /input/model/unit_XXX/particle_type_XXX/adsorption¶
Contains the parameters of the binding model given in \(\texttt{ADSORPTION_MODEL}\), see Binding models.
Group /input/model/unit_XXX/discretization¶
USE_ANALYTIC_JACOBIAN
Determines whether the analytically computed Jacobian matrix (faster) is used (value is 1) instead of a Jacobian generated by algorithmic differentiation (slower, value is 0)
Type: int
Range: \(\{0, 1\}\)
Length: 1
LINEAR_SOLVER
Sparse linear solver that is used for the linear systems of the unit operation (optional, defaults to \(\texttt{SparseLU}\))
Type: string
Range: \(\texttt{SparseLU}\), …
Length: 1
The group is optional and additionally holds the settings of the nonlinear solver used for consistent initialization, see Nonlinear solver for consistent initialization. The spatial discretization of a general rate particle type is given in its own group, see Particle Model.
Group /input/model/unit_XXX/liquid_reaction_YYY¶
Each bulk liquid phase reaction is specified in another subgroup liquid_reaction_YYY, see Reaction models. Solid phase and cross-phase reactions are placed in the group of the respective particle type.