mythos.energy.dna1.base_functions
=================================

.. py:module:: mythos.energy.dna1.base_functions

.. autoapi-nested-parse::

   Base energy functions for DNA1 model.

   These functions are based on the oxDNA1 model paper found here:
   https://ora.ox.ac.uk/objects/uuid:b2415bb2-7975-4f59-b5e2-8c022b4a3719/files/mdcac62bc9133143fc05070ed20048c50



Functions
---------

.. autoapisummary::

   mythos.energy.dna1.base_functions.f1
   mythos.energy.dna1.base_functions.f2
   mythos.energy.dna1.base_functions.f3
   mythos.energy.dna1.base_functions.f4
   mythos.energy.dna1.base_functions.f5


Module Contents
---------------

.. py:function:: f1(r: mythos.utils.types.ARR_OR_SCALAR, r_low: mythos.utils.types.Scalar, r_high: mythos.utils.types.Scalar, r_c_low: mythos.utils.types.Scalar, r_c_high: mythos.utils.types.Scalar, eps: mythos.utils.types.Scalar, a: mythos.utils.types.Scalar, r0: mythos.utils.types.Scalar, r_c: mythos.utils.types.Scalar, b_low: mythos.utils.types.Scalar, b_high: mythos.utils.types.Scalar) -> mythos.utils.types.ARR_OR_SCALAR

   The radial part of the stacking and hydrogen-bonding potentials.

   This is based on equation 2.7 from the oxDNA paper.


.. py:function:: f2(r: mythos.utils.types.ARR_OR_SCALAR, r_low: mythos.utils.types.Scalar, r_high: mythos.utils.types.Scalar, r_c_low: mythos.utils.types.Scalar, r_c_high: mythos.utils.types.Scalar, k: mythos.utils.types.Scalar, r0: mythos.utils.types.Scalar, r_c: mythos.utils.types.Scalar, b_low: mythos.utils.types.Scalar, b_high: mythos.utils.types.Scalar) -> mythos.utils.types.ARR_OR_SCALAR

   The radial part of the cross-stacking and coaxial stacking potentials.

   This is based on equation 2.8 from the oxDNA paper.


.. py:function:: f3(r: mythos.utils.types.ARR_OR_SCALAR, r_star: mythos.utils.types.Scalar, r_c: mythos.utils.types.Scalar, eps: mythos.utils.types.Scalar, sigma: mythos.utils.types.Scalar, b: mythos.utils.types.Scalar) -> mythos.utils.types.ARR_OR_SCALAR

   The radial part of the excluded volume potential.

   This is based on equation 2.9 from the oxDNA paper.


.. py:function:: f4(theta: mythos.utils.types.ARR_OR_SCALAR, theta0: mythos.utils.types.Scalar, delta_theta_star: mythos.utils.types.Scalar, delta_theta_c: mythos.utils.types.Scalar, a: mythos.utils.types.Scalar, b: mythos.utils.types.Scalar) -> mythos.utils.types.ARR_OR_SCALAR

   The angular modulation factor used in stacking, hydrogen-bonding, cross-stacking and coaxial stacking.

   This is based on equation 2.10 from the oxDNA paper.


.. py:function:: f5(x: mythos.utils.types.ARR_OR_SCALAR, x_star: mythos.utils.types.Scalar, x_c: mythos.utils.types.Scalar, a: mythos.utils.types.Scalar, b: mythos.utils.types.Scalar) -> mythos.utils.types.ARR_OR_SCALAR

   Another modulating term which is used to impose right-handedness (effectively a one-sided modulation).

   This is based on equation 2.11 from the oxDNA paper.