RNA model: Difference between revisions

From OxDNA
Jump to navigation Jump to search
No edit summary
 
(15 intermediate revisions by 2 users not shown)
Line 1: Line 1:
===Description of the oxRNA model===
===Description of the oxRNA model===
The RNA model, oxRNA, treats each RNA nucleotide as a single rigid body with multiple interaction sites, following the coarse-graining apporach adopted for the DNA model.  
The RNA model, oxRNA, treats each RNA nucleotide as a single rigid body with multiple interaction sites, following the coarse-graining approach adopted for the DNA model.  
The nucleotides interact with pairwise interaction potentials, which are listed below:


#Backbone connectivity <math>V_{\rm backbone}</math>,
The nucleotides interact with the following pairwise interaction potentials:
#Excluded volume <math>V_{\rm exc}</math>,
 
#Hydrogen bonding <math>V_{\rm  H.B.}</math>,
#Backbone connectivity <math>V_{\rm backbone~}</math>,
#Nearest-neighbour stacking <math>V_{\rm stack}</math>,
#Excluded volume <math>V_{\rm exc~}</math>,
#Cross-stacking between base-pair steps in a duplex <math>V_{cross st.}</math>,
#Hydrogen bonding <math>V_{\rm  H.B.~}</math>,
#Coaxial stacking <math>V_{\rm cx stack}</math>.
#Nearest-neighbor stacking <math>V_{\rm stack~}</math>,
#Cross-stacking in a duplex <math>V_{\rm cross~st.}</math>,
#Coaxial stacking <math>V_{\rm cx.~stack}</math>.


which are schematically illustrated in the picture:
which are schematically illustrated in the picture:
Line 16: Line 17:


===Simulation units===
===Simulation units===
The code uses dimensionless energy, mass, length and timescales for convenience. The relationship between simulation units (SU) and SI units is given below.
The code uses units for energy, mass, length and time that are convenient for a typical system. The relationship between simulation units (SU) and SI units is given below.


{|
{|
Line 24: Line 25:
|-
|-
| 1 unit of length
| 1 unit of length
| 8.518x10<math>^{-10}</math> m
| 8.4x10<math>^{-10}</math> m
|-
|-
| 1 unit of energy
| 1 unit of energy
Line 33: Line 34:
|-
|-
| 1 unit of force
| 1 unit of force
| 4.863x10<math>^{-11}</math> N
| 49.3x10<math>^{-11}</math> N
|-
|-
| 1 unit of mass
| 1 unit of mass
Line 43: Line 44:
|}
|}


===Running a simulation with the oxRNA model===


===Running simulation with the oxRNA model===
The oxRNA model is integrated into the oxDNA simulation code. In particular, it is possible to use the Virtual Move Monte Carlo (VMMC), Monte Carlo (MC) and Molecular Dynamics (MD) simulation algorithms using the same format of input file as for the DNA model. The format of the configuration files is also the same as for the DNA model, described in [[Documentation]]. When running simulations of the oxRNA model, the following additional line must be included in the input file to specify that the RNA model is to be used:
 
The oxRNA model is integrated into the oxDNA simulation code. In particular, it is possible to use Virtual Move Monte Carlo (VMMC), Monte Carlo (MC) and Molecular Dynamics (MD) simulation algorithms using the same format of input file as for the DNA model, with the following additional line included in the input file to specify RNA model:
<pre>
<pre>
interaction_type = RNA
interaction_type = RNA
</pre>
</pre>


The RNA model comes with two parametrizations, the average-base and sequence-dependent one. In the average-base parametrization, the <math>V_{\rm  H.B.}</math> interaction strengths are the same for all Watson-Crick and wobble base pairs (AU, GC, GU) and 0 for all other types of base pairs. The interaction strengths have the same strength for all possible pairs of nucleotides interacting with stacking interaction <math>V_{\rm stack}</math>.  
The RNA model comes with two parametrizations, the average-base and sequence-dependent one. In the average-base parametrization, the <math>V_{\rm  H.B.}</math> interaction strengths are the same for all Watson-Crick and wobble base pairs (AU, GC, GU) and 0 for all other types of base pairs, and the interaction strengths have the same strength for all possible pairs of nucleotides interacting with the stacking interaction <math>V_{\rm stack}</math>.  
In the sequence-dependent version of the model, the interaction strengths of <math>V_{\rm stack}</math> and <math>V_{\rm H.B.}</math> depend on the type of interacting bases.  
In the sequence-dependent version of the model, the interaction strengths of <math>V_{\rm stack}</math> and <math>V_{\rm H.B.}</math> depend on the type of interacting bases (interactions for <math>V_{\rm H.B.}</math> are still 0 for base pairs other than  AU, GC or GU).


The average-base parametrization is used by default. In order to use the sequence-dependent version of the model, the following options need to be added into the input file:
The average-base parametrization is used by default. In order to use the sequence-dependent version of the model, the following options need to be added into the input file:
Line 60: Line 60:
</pre>
</pre>


Note that the file <tt>rna_sequence_dependent_parameters.txt</tt> needs to be located in the directory where you run the simulation, or full location of the file needs to be specified in <tt>seq_dep_file</tt> option.
Note that the file <tt>rna_sequence_dependent_parameters.txt</tt> needs to be located in the directory where you run the simulation, or the full location of the file needs to be specified in the <tt>seq_dep_file</tt> option.


Furthermore, the configuration files need to be generated so that the nucleotides are positioned so that they satisfy RNA potentials (for instance in the case of duplex, they need to be initialized in an A-helical structure). For this purpose, a script  <tt>generate-RNA.py</tt> is provided in <tt>UTILS/</tt> subdirectory of the source code main directory.
Furthermore, the initial configuration files need to be generated so that the nucleotides are positioned in an arrangement that satisfies the RNA potentials (for instance in the case of a duplex, they need to be initialized in an A-helical structure). For this purpose, a script  <tt>generate-RNA.py</tt> is provided in the <tt>UTILS/</tt> subdirectory of the source code main directory.
For instance, if one wants to generate an initial configuration of three strands, two of them complementary (with sequence 3'-GCAAGUCG-5' and its complementary) and in a duplex configuration, and one single strand with sequence 3'-ACCCGU-5', one needs to create the following file text file, called for example <tt>sequences.txt</tt>:
For instance, if one wants to generate an initial configuration consisting of three strands, two of them complementary (with sequence 3'-GCAAGUCG-5' and its complementary) in a duplex configuration, and one single strand with sequence 3'-ACCCGU-5', one needs to create the following text file, called for example <tt>sequences.txt</tt>:
<pre>
<pre>
DOUBLE GCAAGUCG
DOUBLE GCAAGUCG
ACCCGU
ACCCGU
</pre>
</pre>
 
Note that the sequences are always specified in 3'-5' order.
In order to create the initial configuration files <tt>generated.top</tt> and <tt>generated.conf</tt> with the duplex and single strand randomly placed in a simulation cube with side of length 20 in simulation units, run the script  
In order to create the initial configuration files <tt>generated.top</tt> and <tt>generated.conf</tt> with the duplex and single strand randomly placed in a simulation cube with side of length 20 in simulation units, run the script  
<pre>
<pre>
./generate-RNA.py sequences.txt generated 20.0
generate-RNA.py sequences.txt generated 20.0
</pre>
</pre>


which will created the configuration files. Those can then be used as initial configuration for the simulations. Other input command options that apply to oxDNA, such as use of external forces, apply with the same syntax to oxRNA as well and are described in more detail in the model documentation.
which will create the configuration files. These can then be used as an initial configuration for a simulation. Other input file options that apply to oxDNA, such external_forces=1 (for the use of external forces), can be used with oxRNA with the same syntax (see [[Documentation]] for a full list and for further details).




For an example on how to use VMMC simulations to determine the melting temperature of an RNA duplex, please see the following tutorial: [[RNA_duplex_melting]]
For an example on how to use VMMC simulations to determine the melting temperature of an RNA duplex, please see the [[RNA duplex melting]] tutorial.


===Visualization of RNA configurations===  
===Visualization of RNA configurations===  


In order to visualize the configurations of the oxRNA model, one can use the <tt>traj2chimera.py</tt> script, as described for the oxDNA model. It is however necessary to first set environment variable <tt>OXRNA</tt> to 1 in order for the script to properly generate visual representation of oxRNA:
In order to visualize the configurations of the oxRNA model, one can use the <tt>traj2chimera.py</tt> script, as described for the oxDNA model. It is however necessary to first set the environment variable <tt>OXRNA</tt> to 1 in order for the script to properly generate visual representation of oxRNA:
<pre>
<pre>
export OXRNA=1
export OXRNA=1
</pre>
</pre>


The visualization of configuration specified in, for example, <tt>generated.top</tt> and <tt>generated.conf</tt> can be then obtained by running
The visualization of a configuration specified in, for example, <tt>generated.top</tt> and <tt>generated.conf</tt> can then be obtained by running
<pre>
<pre>
traj2chimera.py generated.conf generated.top  
traj2chimera.py generated.conf generated.top  
</pre>
</pre>
in the <tt>UTILS/</tt> directory   
in the <tt>UTILS/</tt> directory   
which creates files <tt>generated.conf.pdb</tt> and <tt>chimera.com</tt> which can then be visualized with [http://www.cgl.ucsf.edu/chimera/download.html Chimera software]
which creates the files <tt>generated.conf.pdb</tt> and <tt>chimera.com</tt> which can then be visualized with [http://www.cgl.ucsf.edu/chimera/download.html Chimera software]
by running the following command:
by running the following command:
<pre>
<pre>
Line 101: Line 101:
</pre>  
</pre>  
in the command line, where <tt>chimera.com</tt> needs to be present in the directory where you started Chimera.
in the command line, where <tt>chimera.com</tt> needs to be present in the directory where you started Chimera.


===References===
===References===

Latest revision as of 17:40, 11 March 2014

Description of the oxRNA model

The RNA model, oxRNA, treats each RNA nucleotide as a single rigid body with multiple interaction sites, following the coarse-graining approach adopted for the DNA model.

The nucleotides interact with the following pairwise interaction potentials:

  1. Backbone connectivity ,
  2. Excluded volume ,
  3. Hydrogen bonding ,
  4. Nearest-neighbor stacking ,
  5. Cross-stacking in a duplex ,
  6. Coaxial stacking .

which are schematically illustrated in the picture:

Image duplex combined annotated.png


Simulation units

The code uses units for energy, mass, length and time that are convenient for a typical system. The relationship between simulation units (SU) and SI units is given below.

Simulation unit Physical unit
1 unit of length 8.4x10 m
1 unit of energy 4.142x10 J
1 unit of temperature 3000 K
1 unit of force 49.3x10 N
1 unit of mass 5.34x10 kg
1 unit of time 3.06x10 s

Running a simulation with the oxRNA model

The oxRNA model is integrated into the oxDNA simulation code. In particular, it is possible to use the Virtual Move Monte Carlo (VMMC), Monte Carlo (MC) and Molecular Dynamics (MD) simulation algorithms using the same format of input file as for the DNA model. The format of the configuration files is also the same as for the DNA model, described in Documentation. When running simulations of the oxRNA model, the following additional line must be included in the input file to specify that the RNA model is to be used:

interaction_type = RNA

The RNA model comes with two parametrizations, the average-base and sequence-dependent one. In the average-base parametrization, the interaction strengths are the same for all Watson-Crick and wobble base pairs (AU, GC, GU) and 0 for all other types of base pairs, and the interaction strengths have the same strength for all possible pairs of nucleotides interacting with the stacking interaction . In the sequence-dependent version of the model, the interaction strengths of and depend on the type of interacting bases (interactions for are still 0 for base pairs other than AU, GC or GU).

The average-base parametrization is used by default. In order to use the sequence-dependent version of the model, the following options need to be added into the input file:

use_average_seq = 0
seq_dep_file = rna_sequence_dependent_parameters.txt

Note that the file rna_sequence_dependent_parameters.txt needs to be located in the directory where you run the simulation, or the full location of the file needs to be specified in the seq_dep_file option.

Furthermore, the initial configuration files need to be generated so that the nucleotides are positioned in an arrangement that satisfies the RNA potentials (for instance in the case of a duplex, they need to be initialized in an A-helical structure). For this purpose, a script generate-RNA.py is provided in the UTILS/ subdirectory of the source code main directory. For instance, if one wants to generate an initial configuration consisting of three strands, two of them complementary (with sequence 3'-GCAAGUCG-5' and its complementary) in a duplex configuration, and one single strand with sequence 3'-ACCCGU-5', one needs to create the following text file, called for example sequences.txt:

DOUBLE GCAAGUCG
ACCCGU

Note that the sequences are always specified in 3'-5' order. In order to create the initial configuration files generated.top and generated.conf with the duplex and single strand randomly placed in a simulation cube with side of length 20 in simulation units, run the script

generate-RNA.py sequences.txt generated 20.0

which will create the configuration files. These can then be used as an initial configuration for a simulation. Other input file options that apply to oxDNA, such external_forces=1 (for the use of external forces), can be used with oxRNA with the same syntax (see Documentation for a full list and for further details).


For an example on how to use VMMC simulations to determine the melting temperature of an RNA duplex, please see the RNA duplex melting tutorial.

Visualization of RNA configurations

In order to visualize the configurations of the oxRNA model, one can use the traj2chimera.py script, as described for the oxDNA model. It is however necessary to first set the environment variable OXRNA to 1 in order for the script to properly generate visual representation of oxRNA:

export OXRNA=1

The visualization of a configuration specified in, for example, generated.top and generated.conf can then be obtained by running

traj2chimera.py generated.conf generated.top 

in the UTILS/ directory which creates the files generated.conf.pdb and chimera.com which can then be visualized with Chimera software by running the following command:

chimera generated.conf.pdb chimera.com

or alternatively, you can load generated.conf.pdb in the Chimera software and then click on Tools->General Controls->Command line and specify

read chimera.com

in the command line, where chimera.com needs to be present in the directory where you started Chimera.

References

The model and its performance is discussed in detail in the following reference:

P. Šulc, F. Romano, T. E. Ouldridge, J. P. K. Doye, A. A. Louis: A nucleotide-level coarse-grained model of RNA, submitted