yaeos__equilibria_saturation_points Module

Saturation points

Description

Bubble, dew, and liquid-liquid saturation points at specified temperature or pressure. The module first iterates a scalar Newton method on with successive-substitution updates of , and falls back to a full Newton solve in if that does not converge. A non-converged result is returned with kind = "failed".

Examples

sat = saturation_pressure(model, z, T, kind="bubble")
sat = saturation_temperature(model, z, P, kind="dew")

Uses

  • module~~yaeos__equilibria_saturation_points~~UsesGraph module~yaeos__equilibria_saturation_points yaeos__equilibria_saturation_points ieee_arithmetic ieee_arithmetic module~yaeos__equilibria_saturation_points->ieee_arithmetic module~yaeos__constants yaeos__constants module~yaeos__equilibria_saturation_points->module~yaeos__constants module~yaeos__equilibria_auxiliar yaeos__equilibria_auxiliar module~yaeos__equilibria_saturation_points->module~yaeos__equilibria_auxiliar module~yaeos__equilibria_equilibrium_state yaeos__equilibria_equilibrium_state module~yaeos__equilibria_saturation_points->module~yaeos__equilibria_equilibrium_state module~yaeos__models_ar yaeos__models_ar module~yaeos__equilibria_saturation_points->module~yaeos__models_ar iso_fortran_env iso_fortran_env module~yaeos__constants->iso_fortran_env module~yaeos__equilibria_auxiliar->module~yaeos__constants module~yaeos__equilibria_auxiliar->module~yaeos__models_ar module~yaeos__models_base yaeos__models_base module~yaeos__equilibria_auxiliar->module~yaeos__models_base module~yaeos__equilibria_equilibrium_state->module~yaeos__constants module~yaeos__models_ar->module~yaeos__constants module~yaeos__models_ar->module~yaeos__models_base module~yaeos__substance yaeos__substance module~yaeos__models_base->module~yaeos__substance module~yaeos__substance->module~yaeos__constants

Used by

  • module~~yaeos__equilibria_saturation_points~~UsedByGraph module~yaeos__equilibria_saturation_points yaeos__equilibria_saturation_points module~yaeos__equilibria yaeos__equilibria module~yaeos__equilibria->module~yaeos__equilibria_saturation_points module~yaeos yaeos module~yaeos->module~yaeos__equilibria

Variables

Type Visibility Attributes Name Initial
integer, public :: iters_first_step = 30

Maximum iterations for the initial scalar Newton step of saturation_pressure.

integer, public :: iters_first_step_temperature = 100

Maximum iterations for the initial scalar Newton step of saturation_temperature.

integer, public :: max_iterations = 2000

Maximum number of iterations for the full Newton solver

real(kind=pr), public :: step_tol = 0.1_pr

Currently unused (the scalar pressure step is limited to in code).

real(kind=pr), public :: tol = 1e-6_pr

Convergence tolerance for the saturation solvers


Functions

public function saturation_pressure(model, n, t, kind, p0, y0, max_iters)

Saturation pressure calculation function.

Read more…

Arguments

Type IntentOptional Attributes Name
class(ArModel), intent(in), target :: model

EOS used to evaluate phase fugacities.

real(kind=pr), intent(in) :: n(:)

Composition vector [moles / molar fraction]

real(kind=pr), intent(in) :: t

Temperature [K]

character(len=*), intent(in) :: kind

[bubble|dew|liquid-liquid]

real(kind=pr), intent(in), optional :: p0

Initial pressure [bar], defaults to the Wilson estimate

real(kind=pr), intent(in), optional :: y0(:)

Initial guess used as to build (y/z for bubble and liquid-liquid, z/y for dew); defaults to .

integer, intent(in), optional :: max_iters

Currently ignored: the full Newton solve uses the module variable max_iterations.

Return Value type(EquilibriumState)

public function saturation_temperature(model, n, p, kind, t0, y0, max_iters)

Saturation temperature calculation function.

Read more…

Arguments

Type IntentOptional Attributes Name
class(ArModel), intent(in), target :: model

EOS used to evaluate phase fugacities.

real(kind=pr), intent(in) :: n(:)

Composition vector [moles / molar fraction]

real(kind=pr), intent(in) :: p

Pressure [bar]

character(len=*), intent(in) :: kind

[bubble|dew|liquid-liquid]

real(kind=pr), intent(in), optional :: t0

Initial temperature [K], defaults to 250 K

real(kind=pr), intent(in), optional :: y0(:)

Initial guess used as to build (y/z for bubble and liquid-liquid, z/y for dew); defaults to .

integer, intent(in), optional :: max_iters

Currently ignored: the full Newton solve uses the module variable max_iterations.

Return Value type(EquilibriumState)