helmholtz_free_energy: Helmholtz Free Energy of Generalized Gamma Distribution

helmholtz_free_energyR Documentation

Helmholtz Free Energy of Generalized Gamma Distribution

Description

This function computes the Helmholtz Free Energy (HFE) for member of the Generalized Gamma (GG) Distribution family. The Helmholtz free energy represents the driving force for NVT systems, the thermodynamic potential that measures the “useful” work obtainable from a closed thermodynamic system at a constant temperature and volume.

GG density is given as:

exp(-y^\alpha)*\alpha*y^(\alpha*\delta - 1)/(scale*\gamma(\delta))

(see (Wikipedia))

A list of the member of the GG distribution family with the corresponding parameter settings is provided in Table 1 from reference (1). For example, to compute the HFE of a Weibull distribution model, we just set: alpha > 0 and delta = 1 (notice that parameter are named different in reference (1)).

Usage

helmholtz_free_energy(model, R = 8.31446261815324, T.abs = 310.15, ...)

## S4 method for signature 'missingORNULL'
helmholtz_free_energy(
  model,
  R = 8.31446261815324,
  T.abs = 310.15,
  pars,
  log.base = exp(1),
  kj = FALSE,
  terms = FALSE
)

## S4 method for signature 'cdfMODEL'
helmholtz_free_energy(
  model,
  R = 8.31446261815324,
  T.abs = 310.15,
  log.base = exp(1),
  kj = FALSE,
  terms = FALSE
)

## S4 method for signature 'cdfMODELlist'
helmholtz_free_energy(
  model,
  R = 8.31446261815324,
  T.abs = 310.15,
  log.base = exp(1),
  kj = FALSE,
  terms = FALSE
)

## S4 method for signature 'ProbDistrList'
helmholtz_free_energy(
  model,
  R = 8.31446261815324,
  T.abs = 310.15,
  log.base = exp(1),
  kj = FALSE,
  terms = FALSE
)

Arguments

model

An object from any of the classes created in MethylIT pipeline: cdfMODEL, cdfMODELlist, or ProbDistrList. If given, then the parameter values are taken from the model.

R

A number or NULL. The gas constant is given as default values, which is proportionality constant that relates the energy scale in physics to the temperature scale and the scale used for amount of substance.

T.abs

Absolute temperature (in Kelvin units). Default is T.abs = 310.15.

pars

Optional. A numerical vector containing the model parameter values in the given in order: alpha, scale, and delta.

log.base

A positive number. The same as in function log.

kj

Logical. Whether to return the result in KJ * mol^-1.

terms

logical(1). If term = TRUE, then a numerical vector with terms contributing to the Helmholtz free energy are provided.

Details

The values of the constants R and T.abs can be simply 1, which implies dimensionless units units, with perhaps no physical interpretation, only carrying informational meaning, i.e., only meaningful in the framework of information theory.

Value

Helmholtz free energy of system according to the model. If R is the gas constant and T.abs given in Kelvin units, then the energy is returned in Joule per mol units.

References

  1. Crooks, Gavin E. (2015) The Amoroso Distribution. arXiv:1005.3274v2.

See Also

gibb_entropy

Examples

## Loading the probability distribution models
data(gof, "MethylIT")
## Helmholtz free energy at 310.15 K (Kelvin) in J * mol^-1
helmholtz_free_energy (gof)

genomaths/MethylIT documentation built on Feb. 3, 2024, 1:24 a.m.