ecl-logo Documentation

SimulateEquilibriumConstant

SimulateEquilibriumConstant[reaction, temperature]equilibriumConstantObject

computes the equilibirum constant of the given reaction between two nucleic acid oligomers at the specified concentration with traditional Nearest Neighbor thermodynamic analysis.

SimulateEquilibriumConstant[reactantAplusB, temperature]equilibriumConstantObject

finds the product of reaction from 'reactantA' + 'reactantB', then computes the equilibirum constant.

SimulateEquilibriumConstant[reactantEquilibriumProduct, temperature]equilibriumConstantObject

infers the type of reaction from the given 'reactant' 'product' state and computes the equilibirum constant for that reaction.

SimulateEquilibriumConstant[reactionMechanism, temperature]equilibriumConstantObject

computes the equilibirum constant from the reaction in the given mechanism.

SimulateEquilibriumConstant[oligomer, temperature]equilibriumConstantObject

considers the hybridization reaction between the given oligomer and its reverse complement.

SimulateEquilibriumConstant[structure, temperature]equilibriumConstantObject

considers the melting reaction whereby all of the bonds in the given structure are melted.

SimulateEquilibriumConstant[enthalpy, entropy, temperature]equilibriumConstantObject

computes the equilibirum constant from the given enthalpy and entropy of a reaction.

SimulateEquilibriumConstant[freeEnergy, temperature]equilibriumConstantObject

computes the equilibirum constant from the given Gibbs free energy of a reaction.

Details

  • Equilibrium constant is calculated from EquilibriumConstant = E^(-ΔG/(R*T)).
  • DNA Nearest Neighbor parameters from Object[Report, Literature, "id:kEJ9mqa1Jr7P"]: Allawi, Hatim T., and John SantaLucia. "Thermodynamics and NMR of internal GT mismatches in DNA." Biochemistry 36.34 (1997): 10581-10594.
  • RNA Nearest Neighbor parameters from Object[Report, Literature, "id:M8n3rxYAnNkm"]: Xia, Tianbing, et al. "Thermodynamic parameters for an expanded nearest-neighbor model for formation of RNA duplexes with Watson-Crick base pairs." Biochemistry 37.42 (1998): 14719-14735.
  • If given a nucleic acid sequence, strand, or sequence length, this function assumes a two-state binding between the provided sequence and a perfect reverse complement.
  • Given a structure, considers only the bonded regions of the structure.
  • Supported polymer types are DNA and RNA.
  • Untyped sequences or lengths default to DNA if there is ambiguity.
  • Enthalpy is independent of salt concentration, while entropy values for a given salt concentration. MonovalentSaltConcentration and DivalentSaltConcentration can be used to specify the concentration of monovalent salt (Na+, K+) and divalent salt (Mg2+) respectively. The entropy correction term is calculated as: 0.368*(Sequence Length - 1)*ln[(Na+) + 140*(Mg2+)] from Object[Report,Literature, "id:eGakld09nLXo"]: von Ahsen, et al. "Application of a Thermodynamic Nearest-Neighbor Model to Estimate Nucleic Acid Stability and Optimize Probe Design:Prediction of Melting Points of Multiple Mutations of Apolipoprotein B-3500 and Factor V with a Hybridization Probe Genotyping Assay on the LightCycler" Clinical Chemistry 45.12 (1999) 2094-2101.
  • If thermodynamic paramaters are provided, a second order reaction (A + B AB) is assumed.
  • Temperature defaults to 37.0 °C.
  • Input
    Output
    General Options

Examples

Basic Examples  (5)

Compute the equilibrium constant of a hybridization reaction between given sequence and its reverse complement:

Find the product of DNA['GGACTGACGCGTTGA']+DNA['TCAACGCGTCAGTCC'], then compute the equilibrium constant:

Specify reaction from one structure to another:

Compute the equilibrium constant from entropy and enthalpy:

Compute the equilibrium constant from free energy:

Additional Examples  (17)

Temperature is defaulted to 37 Celsius if not specified:

Input enthalpy and entropy as distributions:

Input enthalpy, entropy and temperature as distributions:

Input free energy as a distribution:

Input free energy and temperature as distributions:

Specify reaction from one structure to another:

Compute the equilibrium constant from a simple ReactionMechanism contains only one reaction:

Pull strand from given sample:

Pull strand from given model:

Given reaction model:

Given structure, computes equilibrium constant of all bonded regions:

Compute the distribution of equilibrium constant of all 15-mer hybridization reactions with their reverse complements:

Given a strand:

Given a typed sequence:

Given untyped length:

Structure with no bonds returns 1:

Can handle degenerate sequence and return a distribution:

Options  (10)

AlternativeParameterization  (1)

Using AlternativeParameterization to specially useful if there is no thermo properties in the original polymer:

BufferModel  (1)

Specify a specific buffer, from which salt concentration will be computed:

DivalentSaltConcentration  (1)

Specify divalent salt concentration in buffer:

MonovalentSaltConcentration  (1)

Specify monovalent salt concentration in buffer:

Output  (1)

Return equilibrium constant distribution instead of mean:

Polymer  (1)

Specify polymer for untyped sequences:

ReactionType  (1)

Given an object, specify if the strands should be hybridized or the structure melted:

Template  (2)

The Options from a previous equilibrium constant simulation (object reference) can be used to preform an identical simulation on new oligomer:

The Options from a previous equilibrium constant simulation (object) can be used to preform an identical simulation on new oligomer:

ThermodynamicsModel  (1)

Using ThermodynamicsModel to explicitly provide the thermodynamic parameters or to override the values taken from Thermodynamics field in the model oligomer:

Overloads  (5)

Maps  (5)

Maps over Free Energy input:

Maps over enthalpy input:

Maps over entropy input:

MapThread over enthalpy and entropy input:

Maps over temperature input:

Messages  (11)

BadPolymerType  (1)

Specified polymer type does not match input:

InvalidPolymerType  (1)

With vague integer-type polymer and polymer option Null, a warning is shown and polymer option switches to Automatic:

InvalidSaltConcentration  (1)

MonovalentSaltConcentration and DivalentSaltConcentration cannot both be 0 Molar:

InvalidSequence  (1)

Given invalid sequence:

InvalidStrand  (1)

Given an invalid strand:

LengthExceedMax  (1)

Given sequence that is too long:

ReactionTypeNull  (1)

Given an object with ReactionType option set to Null:

ReactionTypeWarning  (1)

Given an object with no structure bonds and ReactionType option set to Melting:

UnsupportedMechanism  (1)

Given ReactionMechanism that is too complicated:

UnsupportedReactionType  (2)

Given unknown reaction type:

Given too many reactants: