We here give a six-step tutorial of how to use the Linear Noise Approximation in iNA and explore the noise properties arising from a simple gene expression. The tutorial contains also some "Tasks" that may be skipped.
- Tutorial I: Gene Expression
This tutorial precedes our advanced tutorial that can be found here.
Over the past decades stochasticity in models of gene expression has received a lot of attention because genes are represented by only one or two copies in single cells. In this tutorial we consider a model describing transcription and translation which has become a standard model for single cell gene expression.
Here the dynamics involve the mRNA and protein species which are produced by effective reactions modeling transcription and translation events, respectively. The relevant parameters for this reaction scheme are
Unfortunately the SBML file format is very difficult to be read and written by humans. For this purpose Darren Wilkinson (Newcastle University) has developed a shorthand version of SBML that contains the basic SBML model structure. A script describing the gene expression mechanism reads:
@model:3.1.1=GeneExpression "Gene Expression" @units substance = mole: s=-6 volume = litre time = second: m=60 @compartments cell=1e-16 @species cell:[mRNA]=0 cell:[Protein]=0 cell:[Gene]=0.0166 @parameters k0=135.542 ks=4 kdp=5 kdm=10 @reactions @r=transcription "Transcription" Gene -> Gene + mRNA cell*k0*Gene @r=translation "Translation" mRNA -> mRNA + Protein cell*ks*mRNA @r=degrade_Protein "Protein degradation" Protein -> cell*kdp*Protein @r=degrade_mRNA "mRNA degradation" mRNA -> cell*kdm*mRNA
The first line of the above script
@model:2.4.1=GeneExpression "Gene Expression"
declares a model with name "Gene Expression". Note that the first two numbers after the colon denote the SBML specification Level 2 Version 4 while the last number denotes the shorthand SMBL specification.
The definition of units used for the model definition reads
@units substance = mole: s=-6 volume = litre time = second: m=60
meaning that amount of substance is specified in "micromole" (a particle number approximately given by Avogadro's number), time units in minutes (60 seconds) and volume in litres. Hence it follows that concentrations have units of "micromolar concentration" (M=10-6 mole per litre).
Next we define a compartment of volume 0.1fl with identifier "cell"
followed by a section defining the relevant species and their initial concentrations
@species ... cell:[Gene]=0.0166 ...
Here we declared the species "Gene" in compartment "cell" defined in units of concentrations which is indicated by the square brackets. The initial concentration of 0.0166 10-6 M corresponds to a single gene copy number in a volume 0.1fl. You may verify this yourself using the definition of micromolar (10-6 M) and femtolitre (fl=10-15l). Finally, a reaction describing the transcription of mRNA can be specified as
@reactions @r=transcription "Transcription" Gene -> Gene + mRNA cell*k0*Gene ...
where the second line denotes the reaction identifier and name, the third line denotes the reaction scheme while the last one denotes the propensity of the reaction. The propensity denotes the probability per unit time for a reaction to occur. Its unit in this case is mole/s which is a frequency. The latter is generally a function of the compartmental volumes, the concentrations of the species and globally or locally defined parameters. Note also that the involved species "Gene" and "mRNA" are defined in terms of concentrations.
Please copy the above model definition to a text file with the default file extension is ".sbmlsh". If you are interested in more information about SBML shorthand you can also a look at our SBMLsh page.
Once you start iNA, you will see the main window with the menu bar at the top of it. A click on the entry ``File" will allow you to select the SBML-sh file from a local directory. For the purpose of this tutorial we will load the file generated in Task I into iNA. Alternatively you can drag this link into the side panel of iNA (since version 0.4.1), iNA will download and import that model automatically.
The menu point File -> Open enables you to load an SBML file. Simply go to the location of the file on your hard drive and select the desired file.
Once opened, the model will show up in the tree on the left. Of course, you will also be able to load multiple files into iNA's GUI.
The tree on the left also allows you to inspect individual elements of the model definition. There are different tree nodes by which you can inspect the compartments, species, reactions and global quantities defined by the model. By selecting a node the corresponding information will be shown in the main window on the right side.
The node Compartments lists all compartments together with their associated volume that have been defined in the SBML file.
This view lists all compartments that have been defined in the model together with their associated volumes and the units.
The next node Species gives you a list of all defined species. The containing table also contains information about units in which each species have been defined, their compartments, and the amount in which the individual species are present at the beginning of a simulation.
This view list all species that comprise the reaction network together with their associated compartment, their initial value at the beginning of the simulation and the units in which it has been defined. Note that species can be defined in units of amount or concentrations.
Next the node Reactions gives information about the reactions comprising the network. The view is divided in two panels.
This view gives you a list of the chemical equations and the propensities of all individual reactions. Note that symbols of species are represented in the unit in which the species has been defined. In the example shown the unit of all species is concentration.
The upper panel displays the reaction scheme containing information about the stoichiometry, the participating species and the associated propensities. Note that locally defined parameters are listed in the table below while global parameters can be found by selecting the node Global Parameters.
This view collects all globally defined parameters together with their values.
Under the menu point "Analyses" you can access specific wizards which guide you through the configuration of the analyses. The "Steady State Analysis" is the most basic analysis offered by the software iNA and allows you to perform a full noise analysis under steady state conditions using the system size expansion, i.e., after a time span when all transients in the average concentrations have decayed. This type of analysis is the quickest way by which you can perform a full noise analysis with iNA.
Accessing wizards from the menu bar.
The "Steady State Analysis" wizard is particularly simple to configure. First, we will need to select the model "Gene Expression" from the list which contains all opened models.
The first stage of an analysis wizard allows you to select a model from the list of open files.
The system size expansion relies on the knowledge of the concentrations of the rate equations. The latter equations correspond to a macroscopic formulation of biochemical kinetics which is only valid in volumes of test-tube size or larger. Using the law of mass action, the deterministic rate equations for our model of gene expression can be formulated as
where the deterministic concentrations are denoted by the square brackets. However, this formulation ignores the discreteness of molecules and hence also the fluctuations which are intrinsic to the kinetics. Under steady state conditions the solution of these equations is particularly simple since the present example considers only linear reactions. General reaction networks are represented by a set of coupled and nonlinear equations. Therefore iNA computes the roots of the REs using a robust steady state solver.
The second stage of the Steady State Analysis wizard allows one to customize the numerical procedure.
The method is an iterative procedure and therefore you will be asked to specify the precision and maximum number of iterations to be used by the solver. Note that generally the number of iterations needed is proportional to the number of species in the network. Therefore you might need to increase this value when considering very large networks but the preset value is sufficient for the present example.
The final stage of a wizard gives a summary of the configuration.
Finally the wizard gives you a summary of your configuration and how much memory the results of the analysis will approximately use. The numeric values of the analysis are presented in two tables. The upper table lists the values of the concentrations that have been obtained as solutions of the deterministic rate equations for the selected. The second value has been computed by the EMREs and is supposed to give you a more accurate value for the true concentration as described by the CME. In the present case both results agree. This is been expected since the set of reactions describing the expression of the protein are unimolecular in nature. The more general case of gene expression involving also bimolecular reactions will be dealt with in the next tutorial. The lower table lists the values of the covariance matrix as computed by the LNA.
The results of the Steady state analysis are summarized in a table view and is exportable to a data file.
You might want now want to visualize the numerical results. This can be done through the button "Plot steady state statistics" at the bottom of the window.
Second, we need to select the species we want to analyze. In this example there only two species of immediate interest, namely mRNA and protein, and we will select both of them.
Select a subset of species that you want to analyze.
You can find the result in the tree on the left under the node Analyses. The graph shows a column plot in the main window. The height of each column indicates the value of the steady state concentration for each species. Here the blue column denotes the results given by rate equations, the red one those by the EMREs, both which are agreement as mentioned above. The plot also contains error bars which denote the standard deviation of the concentration fluctuations which has been computed by the LNA.
Visualization of the Steady State Analysis result in terms of a column plot. The blue column denotes the prediction of the average concentration by the REs together with the standard deviation denoted by an error bar which has been calculated by means of the LNA. The red column denotes the average concentrations as predicted by the EMREs.
The analysis performed in steady state conditions can also be performed as a function of time. This will provide you with information on how the fluctuations change over time. The time span we will consider here is the beginning of a simulation at which point the distribution of concentrations is sharply peaked about the deterministic initial conditions to the final time at which the steady state is reached. The wizard for this analysis can be accessed from the menu bar from "Analyses" -> "Time Course Analysis".
The Time Course Analysis wizard allows you to select the mode of analysis.
The third stage of the Time Course Analysis wizard guides you through the configuration of the ODE solver.
In order to obtain the time course, iNA provides a choice of different ODE solvers. For general purposes we recommend LSODA which automatically switches between stiff and non-stiff methods (stiffness arises from timescale separation in biochemical networks). The analysis is as simple to use as any conventional solver for deterministic REs as you find for instance in software like Copasi or CellDesigner. You only need to specify the final time of integration as well as the maximum relative and absolute errors. Therefore it is clear that all results obtained by the SSE methods should be checked whether they are consistent with integrations using smaller error estimates.
The result of the analysis is presented in a table view which you can access by the node of the analysis in the tree on the left. At the bottom of the table in the main window you will find a button to plot your result. The first plot should look like this:
Result of the time course analysis showing REs and LNA. The solid lines denote the concentrations as predicted by the REs while the colored areas denote the standard deviation calculated by the LNA.
This plot visualizes the time course according to the REs together with the prediction for the standard deviations as calculated by the LNA which is indicated by the colored areas.
Please convince yourself that the results from the steady-state analysis are consistent with the value of the time course analysis at time 2s. You can do so by selecting the analysis in the tree on the left and using the numerical values in the table view of the main window. Check this for the mean concentrations as well as for the individual variances of mRNA and Protein. You may also calculate the coefficient of variation, defined as the ratio of standard deviation to mean concentration, for both species.
The results in the preceding steps have been obtained by means of the LNA which is based on the system size expansion. You can verify your results using the Stochastic Simulation Algorithm. The wizard can be accessed from "Analyses" in the menu bar, and besides species selection it also offers several more configuration options.
The third stage of the Stochastic Simulation wizard allows you to adjust the number of realizations used for the statistical average.
The SSA is a Monte Carlo method which generates independent realizations of the stochastic process which are distributed according to the exact probability distribution solution of the Chemical Master Equation. iNA offers you two options, the direct method and an optimized method. The former is the original formulation by Gillespie while the latter is an improved variant which has been proposed by Cao which is generally preferable. The merit of these methods is that they are exact. However in order to extract the necessary statistics, ensemble averaging over a large number of samples might be required. The number of realizations used can be adjusted by the option "Ensemble size". The option ""Plot points" simply refers to the desired number of points in the output plot. Using the option "Thread count" you make efficient use of multi-core architectures depending on the hardware you have available. The standard setting should make all cores of your system available. Setting the ensemble size to 3000 realizations and final time to 2s generates the following plot view:
Result of the SSA with statistical averaging using 3000 independent realizations.
The result is in excellent agreement with the predictions of Linear Noise Approximation which is expected since the reaction probabilities are at most linear in the concentrations according to the law of mass action.
Export the data obtained from stochastic simulation to a text file and analyze it within a spreadsheet application like Excel, LibreOffice or Octave. You can do so by selecting the analysis in the tree on the left and using the button Save to data file at the bottom of the table view in the main window. Average the mean concentrations and variances over the time points from 1s to 2s. Note that, in principle, one could simply increase the number of realizations used for the ensemble average. This, however, is computationally very expensive mainly because of the use of the SSA. Additional time averaging is common to speed up convergence which is permitted in steady state conditions. Also calculate the coefficients of variations. Compare your results with those obtained from the steady state analysis in Task I. What do you find?