001package org.biopax.paxtools.model.level3;
002
003
004/**
005 * Standard transformed Gibbs energy change for a reaction written in terms of biochemical reactants
006 * (sums of species), delta-G'<sup>o</sup>.
007 * 
008 * delta-G'<sup>o</sup> = -RT lnK' and delta-G'<sup>o</sup> = delta-H'<sup>o</sup> - T
009 * delta-S'<sup>o</sup>
010 * 
011 * delta-G'<sup>o</sup> has units of kJ/mol.  Like K', it is a function of temperature (T), ionic
012 * strength (I), pH, and pMg (pMg = -log<sub>10</sub>[Mg<sup>2+</sup>]). Therefore, these quantities
013 * must be specified, and values for DELTA-G for biochemical reactions are represented as 5-tuples
014 * of the form (delta-G'<sup>o</sup> T I pH pMg).
015 * 
016 * This property may have multiple values, representing different measurements for
017 * delta-G'<sup>o</sup> obtained under the different experimental conditions listed in the 5-tuple.
018 */
019public interface DeltaG extends ChemicalConstant
020{
021
022        /**
023         * For biochemical reactions, this property refers to the standard transformed Gibbs energy change for a
024         * reaction written in terms of biochemical reactants (sums of species), delta-G'<sup>o</sup>.
025         * 
026         * delta-G'<sup>o</sup> = -RT lnK'
027         * and
028         * delta-G'<sup>o</sup> = delta-H'<sup>o</sup> - T delta-S'<sup>o</sup>
029         * 
030         * delta-G'<sup>o</sup> has units of kJ/mol.  Like K', it is a function of temperature (T),
031         * ionic strength (I), pH, and pMg (pMg = -log<sub>10</sub>[Mg<sup>2+</sup>]). Therefore,
032         * these quantities must be specified, and values for DELTA-G for biochemical reactions are represented as
033         * 5-tuples of the form (delta-G'<sup>o</sup> T I pH pMg).
034         * @return delta-G'<sup>o</sup> for this condition
035         */
036        float getDeltaGPrime0();
037
038        /**
039         * For biochemical reactions, this property refers to the standard transformed Gibbs energy change for a
040         * reaction written in terms of biochemical reactants (sums of species), delta-G'<sup>o</sup>.
041         * 
042         * delta-G'<sup>o</sup> = -RT lnK'
043         * and
044         * delta-G'<sup>o</sup> = delta-H'<sup>o</sup> - T delta-S'<sup>o</sup>
045         * 
046         * delta-G'<sup>o</sup> has units of kJ/mol.  Like K', it is a function of temperature (T),
047         * ionic strength (I), pH, and pMg (pMg = -log<sub>10</sub>[Mg<sup>2+</sup>]). Therefore,
048         * these quantities must be specified, and values for DELTA-G for biochemical reactions are represented as
049         * 5-tuples of the form (delta-G'<sup>o</sup> T I pH pMg).
050         * @param deltaGPrime0 delta-G'<sup>o</sup> for this condition
051         */
052        void setDeltaGPrime0(float deltaGPrime0);
053
054}