001package org.biopax.paxtools.model.level3;
002
003
004/**
005 * The apparent equilibrium constant, K', and associated values.  Concentrations in the equilibrium constant equation
006 * refer to the total concentrations of all forms of particular biochemical reactants. For example,
007 * in the equilibrium constant equation for the biochemical reaction in which ATP is hydrolyzed to ADP and inorganic
008 * phosphate:
009 * 
010 * K' = [ADP][P<sub>i</sub>]/[ATP].
011 * The concentration of ATP refers to the total concentration of all of the following species:
012 * 
013 * [ATP] = [ATP<sup>4-</sup>] + [HATP<sup>3-</sup>] + [H<sub>2</sub>ATP<sup>2-</sup>] + [MgATP<sup>2-</sup>] +
014 * [MgHATP<sup>-</sup>] + [Mg<sub>2</sub>ATP].
015 * 
016 * The apparent equilibrium constant is formally dimensionless, and can be kept so by inclusion of as many of the
017 * terms (1 mol/dm3) in the numerator or denominator as necessary.  It is a function of temperature (T),
018 * ionic strength (I), pH, and pMg (pMg = -log10[Mg2+]). Therefore, these quantities must be specified to be precise,
019 * and values for KEQ for biochemical reactions may be represented as 5-tuples of the form (K' T I pH pMg).  This
020 * property may have multiple values, representing different measurements for K' obtained under the different
021 * experimental conditions listed in the 5-tuple.
022 */
023public interface KPrime extends ChemicalConstant
024{
025
026        /**
027         * The apparent equilibrium constant K'. Concentrations in the equilibrium constant equation refer to the total
028         * concentrations of  all forms of particular biochemical reactants. For example,
029         * in the equilibrium constant equation for the biochemical reaction in which ATP is hydrolyzed to ADP and
030         * inorganic phosphate:
031         * 
032         * K' = [ADP][P<sub>i</sub>]/[ATP],
033         * 
034         * The concentration of ATP refers to the total concentration of all of the following species:
035         * 
036         * [ATP] = [ATP<sup>4-</sup>] + [HATP<sup>3-</sup>] + [H<sub>2</sub>ATP<sup>2-</sup>] + [MgATP<sup>2-</sup>] +
037         * [MgHATP<sup>-</sup>] + [Mg<sub>2</sub>ATP].
038         * 
039         * The apparent equilibrium constant is formally dimensionless, and can be kept so by inclusion of as many of
040         * the terms (1 mol/dm<sup>3</sup>) in the numerator or denominator as necessary.  It is a function of
041         * temperature (T), ionic strength (I), pH, and pMg (pMg = -log<sub>10</sub>[Mg<sup>2+</sup>]).
042         * @return The apparent equilibrium constant K'
043         */
044        float getKPrime();
045
046        /**
047         * The apparent equilibrium constant K'. Concentrations in the equilibrium constant equation refer to the total
048         * concentrations of  all forms of particular biochemical reactants. For example,
049         * in the equilibrium constant equation for the biochemical reaction in which ATP is hydrolyzed to ADP and
050         * inorganic phosphate:
051         * 
052         * K' = [ADP][P<sub>i</sub>]/[ATP],
053         * 
054         * The concentration of ATP refers to the total concentration of all of the following species:
055         * 
056         * [ATP] = [ATP<sup>4-</sup>] + [HATP<sup>3-</sup>] + [H<sub>2</sub>ATP<sup>2-</sup>] + [MgATP<sup>2-</sup>] +
057         * [MgHATP<sup>-</sup>] + [Mg<sub>2</sub>ATP].
058         * 
059         * The apparent equilibrium constant is formally dimensionless, and can be kept so by inclusion of as many of
060         * the terms (1 mol/dm<sup>3</sup>) in the numerator or denominator as necessary.  It is a function of
061         * temperature (T), ionic strength (I), pH, and pMg (pMg = -log<sub>10</sub>[Mg<sup>2+</sup>]).
062         * (Definition from EcoCyc)
063         * @param kPrime The apparent equilibrium constant K'
064         */
065        void setKPrime(float kPrime);
066
067}