modelSpecies
Information
All of the details below are pertinent to the Fluid model (and the derived Ion model) which inherits from this model. Only some of the details apply to the Solid model because it excludes the transport and exchange of material.
This model is based on the following fixed assumptions:
- All boundaries are rectangular.
- The material is orthorhombic. This implies that a gradient which induces diffusion along an axis does not induce diffusion along axes orthogonal to it [Bejan2006, pp. 691–692].
- The coordinate system (x, y, z) is aligned with the principle axes of transport. For example, if the material is stratified, then the layers must be parallel to one of the planes in the rectilinear grid.
- The effective transport lengths (kL) are common to material, translational, and thermal transport.
- There is no radiative heat transfer (or it must be linearized and added to the thermal conductance).
- Rotational momentum is not stored or transfered.
Figure 1 shows how instances of Species models are connected within a Subregion. A single species in a single phase is called a configuration. The generalized resistances (R) affect the force and rates of chemical exchange and heat flow associated with differences in activity, velocity, and temperature (respectively) between each configuration and a common node. These exchange processes are diffusive. Each resistor generates heat in the Species instance that contains it.
Figure 1: Exchange of a quantity (material, translational momentum, or thermal energy) among configurations
(A, B, and C) within a subregion.
Figure 2 shows how
a configuration
is connected between neighboring instances of a
Subregion.
Material, translational momentum, and thermal energy are transported by both advection and diffusion.
Upstream discretization is applied if it is enabled via the upstreamX,
etc. parameters. Like for exchange, the transport resistances are inside the
Species model.
Figure 2: Transport of a quantity associated with the same configuration
between subregions (1 and 2).
The Species instances within a Phase are combined by Dalton's law of partial pressures (see the Dalton connector), as shown in Figure 3a. The pressures are additive, and each species is assumed to exist at the total extensive volume of the phase. Within a Subregion, the Phases are combined by Amagat's law of partial volumes (see the Amagat connector), as shown in Figure 3b. The volumes are additive, and each species is assumed to exist at the total pressure in the subregion.
a: Pressures of species (A, B, and C) are additive within a phase. |
b: Volumes of phases (I, II, and III) are additive within a subregion. |
| Figure 3: Methods of attributing pressure and volume. | |
Notes regarding the parameters:
- The effective transport lengths (kL) may be different that the geometric lengths along the transport axes due to tortouisity. The tortouisity may be anisotropic.
- If the interval for chemical exchange (τ′), mobility (μ),
thermal independity (ν), fluidity (η), or thermal resistivity (θ)
is zero, then
it should usually be set as
finalso that index reduction may be performed. If two configurations are connected through theirintra,inter, orboundariesconnectors and both have zero generalized resistivities for a quantity, then index reduction [Mattsson1993] is necessary. - Even if an initialization parameter is not selected for explicit use, it may be used a guess value.
- If
ConsThermo.ICis used for a state (viaconsMaterialorconsEnergy), then the associated initial condition (IC) will be applied forever instead of the corresponding conservation equation. - If
consEnergyisConsThermo.steady, then NT∂s/∂t + Mφ∂φ/∂t is treated as zero and removed from the energy balance. - If a transport axis is not included (via the outer
inclTrans[:]parameter which maps to{inclTransX, inclTransY, inclTransZ}in the Subregion model), then the associated pair of boundaries is removed from the model. - The
startvalues of the initial conditions for pressure and temperature (pIC and TIC) are the global default pressure and temperature (via theouterinstance of the Environment model). Thestartvalues of the initial conditions for other intensive properties (ρIC, hIC, and gIC) are related to the initial pressure and temperature by the characteristics of the species. Thestartvalue of the initial condition for the extensive volume (VIC) is the volume of the subregion. Thestartvalue for particle number (NIC) is related to it via the material characteristics and the initial pressure and temperature. In order to apply other values for any of these initial conditions, it may be necessary to do so before translating the model.
In the boundaries connector array, the transverse translational flow (mΦdot) is only the
force due to diffusion. Translational advection is calculated from the current and the velocity.
The thermal flow (Q̇) is only the rate of heat transfer due to diffusion. The advection of
thermal energy is determined from the current and the thermodynamic state at the boundary.
For the variables that relate to transport, the first index is the axis and the second index is the side. The sides are ordered from negative to positive, according to the Side enumeration. Velocity and force are additionally indexed by the orientation of the momentum with respect to the boundary. The orientations are ordered following the normal axis in Cartesian space, according to the Orient enumeration.
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| Integer | n_intra | 0 | Number of exchange connections within the phase |
| Integer | n_inter | 0 | Number of exchange connections with other phases |
| Assumptions | |||
| Integer | n_trans | 1 | Number of transport axes |
| Initialization | |||
| Q.Amount | N_IC | Initial amount of material | |
| Q.Density | rho_IC | Initial density | |
| Q.Volume | V_IC | Initial volume | |
| Q.PressureAbsolute | p_IC | Initial pressure | |
| Q.TemperatureAbsolute | T_IC | Initial temperature | |
| Q.Potential | h_IC | Initial specific enthalpy | |
| Q.Potential | g_IC | Initial Gibbs potential | |
| Independence factors | |||
| Q.NumberAbsolute[n_intra,n_trans] | k_intra_Phi | ones(n_intra, n_trans) | For translational exchange among species within the phase |
| Q.NumberAbsolute[n_intra] | k_intra_Q | ones(n_intra) | For thermal exchange among species within the phase |
Connectors
| Type | Name | Default | Description |
|---|---|---|---|
| Connectors.Intra[n_intra] | intra | Connectors to exchange translational momentum and energy within the phase | |
| Connectors.Inter[n_inter] | inter | Connectors to exchange translational momentum and energy with all other species | |
| Connectors.Dalton | dalton | Connector for additivity of pressure |
Components
| Type | Name | Default | Description |
|---|---|---|---|
| Q.Mobility | mu | Data.mu(T, v) | Mobility |
| Q.TimeAbsolute | nu | Data.nu(T, v) | Thermal independity |
| Q.Amount | N | Amount of material | |
| Q.TemperatureAbsolute | T | Temperature | |
| Q.Velocity[n_trans] | phi | Velocity | |
| Q.PressureAbsolute | p | Pressure | |
| Q.Potential | g | Specific Gibbs energy | |
| Q.Mass | M | Mass | |
| Q.VolumeSpecific | v | Specific volume | |
| Q.Potential | h | Specific enthalpy | |
| Q.NumberAbsolute | s | Specific entropy | |
| Q.Density | rho | 1/v | Density |
| Q.MassVolumic | mrho | Data.m*rho | Volumic mass |
| Q.Amount | S | N*s | Entropy |
| Q.CapacityThermalSpecific | c_p | Data.c_p(T, p) | Isobaric specific heat capacity |
| Q.CapacityThermalSpecific | c_v | Data.c_v(T, p) | Isochoric specific heat capacity |
| Q.PressureReciprocal | beta | Data.beta(T, p) | Isothermal compressibility |
| Q.TimeAbsolute[n_intra,n_trans] | tau_PhiE_intra | {Data.m*mu*k_intra_Phi[i, :] for i in 1:n_intra} | Time constants for translational intra-phase exchange |
| Q.TimeAbsolute[n_inter,n_trans] | tau_PhiE_inter | {Data.m*mu*k_inter_Phi[i, :] for i in 1:n_inter} | Time constants for translational inter-phase exchange |
| Q.TimeAbsolute[n_intra] | tau_QE_intra | c_p*nu*k_intra_Q | Time constants for thermal intra-phase exchange |
| Q.TimeAbsolute[n_inter] | tau_QE_inter | c_p*nu*k_inter_Q | Time constants for thermal inter-phase exchange |
| Q.Force[n_trans] | f_DE | sum(intra[i].mPhidot for i in 1:n_intra) + sum(inter[i].mPhidot for i in 1:n_inter) | Friction from other configurations (diffusive exchange) |
| Q.Power | Edot_DE | sum(intra[i].phi*intra[i].mPhidot for i in 1:n_intra) + sum(inter[i].phi*inter[i].mPhidot for i in 1:n_inter) + sum(intra.Qdot) + sum(inter.Qdot) | Rate of diffusion of energy from other configurations |
Contents
| Name | Description |
|---|---|