Workflow

In this section you will learn how to create synthetic single molecule videos and trajectories. Exported data can be used for result validation, algorithm testing or external illustration.

The procedure includes four steps:

  1. Create a simulation-based project
  2. Generate random FRET state sequences
  3. Create intensity trajectories and images
  4. Validate and export data

Create a simulation-based project

The first step in simulating data is to create a new simulation-based project.

After the project creation is completed, it is recommended to save it to a .mash file that should regularly be overwritten in order to keep traceability and access to the results.

To create a new simulation-based project:

  1. Open the experiment settings window by pressing New project in the project management area and selecting simulate data.

  2. Name your project and define the plot colors by configuring tab Divers. If necessary, modify settings any time after project creation.

  3. Finalize the creation of your project by pressing Save; the experiment settings window now closes and the interface switches to module Simulation.

  4. Save modifications to a .mash file by pressing Save project in the project management area.


Generate random FRET state sequences

A FRET state sequence is the ideal FRET trajectory of a single molecule. It consists in a succession of plateaus dwelling at a particular FRETj value before transiting to the next FRETj’ value.

Sequences are started by randomly drawing a FRET value from the pre-defined state configuration FRETj and using the vector of normalized initial state probabilities Π such as:

\Pi_{n}=\begin{pmatrix}\pi_{1}\ \pi_{2}\ ...\ \pi_{n}\end{pmatrix}

with πj the probability to start a chain in state j.

Considering a population of unsynchronized molecules, the probability πj is the probability to be in state j at a random time of the process, obtained by solving the equation system:

\textup{P}{\Pi}' = \lambda{\Pi}'

where Π’ is the non-normalized initial state probability vector, λ is the eigenvalue associated to Π’, and P is the transition probability matrix described such as:

\textup{P}=\begin{pmatrix}p_{1,1} & p_{1,2} & ... & p_{1,n}\ p_{2,1} & p_{2,2} & ... & p_{2,n}\ \vdots & \vdots & \ddots  & \vdots  \p_{n,1} & p_{n,2} & ... & p_{n,n}\end{pmatrix}

Initial state probabilities are then normalized by the sum, such as:

\pi_{j}=\frac{\pi_{j}'}{\sum_{j'}\left(\pi_{j'}' \right )}

This approach comes down to segmenting an infinitely long chain at a random position. Therefore, it is only valid for chains that complete there cycles within an observation time, meaning with no discontinuity in folding kinetics like kinetic traps or other sudden changes in folding dynamics. For such limiting cases, transition probabilities must be pre-defined; see Remarks for details.

In MASH-FRET, off-diagonal transition probabilities are calculated from dwell times Δtjj’ given in second, the repartition factors wjj’ of transitions from state j, and the exposure time per frame texp given in second, such as:

p_{jj'}=\frac{t_{\textup{exp}}}{\Delta t_{jj'}} \times w_{jj'}

The repartition factor wjj’ is simply the proportion of transitions from state j to state j’ among all transitions occurring from state j. It can be expressed in number of state transitions Njj’ such as:

w_{jj{'}} = \frac{N_{jj{'}}}{\sum_{k \neq j} N_{jk}}

Repartition factors can be set via preset parameter files (by default, factors are set to uniform values); see Remarks for more details.

Diagonal terms are calculated from off-diagonal probabilities such as:

p_{jj}=1-\sum_{j'\neq j} p_{jj'}

FRET state sequences are elongated by randomly drawing a next FRET value using the normalized off-diagonal transition probabilities wij such as:

w_{ij}=\frac{p_{ij}}{\sum_{j'\neq i}\left(p_{ij'} \right )}

The duration of the corresponding plateau is randomly generated from an exponential distribution using the decay constant kjj’. The advantage of random dwell time generation as opposed to time-step simulation is the possibility to include the time-averaging of abrupt state transitions within a time step.

The operation is repeated until the sequence length reaches the observation time and the number of sequences equals the number of molecules N. The observation time is limited by the video length L but can be randomly distributed by introducing fluorophore photobleaching.

FRET state sequence

To generate FRET state sequences:

  1. Set parameters:

    Video length
    Frame rate
    Number of molecules
    State configuration; see Remarks for more details
    Transition rates; see Remarks for more details
    Photobleaching

  2. Press Generate to generate random FRET state sequences,

  3. Generate new state sequences whenever one of the parameters is changed.


Create intensity trajectories and images

FRET state sequences are then converted into donor and acceptor fluorescence intensities using Itot,em, the pure donor emission in the absence of acceptor.

Differences in donor and acceptor emission detection efficiencies and quantum yields is introduced here, by adjusting donor fluorescence intensities with the gamma factor γ.

Imperfect experimental setup is simulated by adding channel-specific bleedthrough bt and direct excitation dE to the respective fluorescence intensities.

Conversion to fluorescence

Final camera-detected intensity-time traces are obtained by adding channel-specific background and uniform camera noise. If the chosen noise model does not include shot noise of photon emission, intensities are distributed following a Poisson distribution prior adding the camera contribution; see Camera SNR characteristics for more information.

Conversion to image counts

Images in the single molecule video (SMV) are created one by one, with the first image corresponding to the first time point in intensity-time traces.

Like in a 2-color FRET experiment, horizontal dimensions of the video are equally split into donor (left) and acceptor (right) channels. Single molecules are then spread randomly on the donor channel and translated into the acceptor channel.

At molecule coordinates, pixel values are set to donor or acceptor pure fluorescence intensities, including gamma factor and setup bias. All other sources of detected lights are then added as channel-specific background intensities that can be uniform, spatially distributed and/or dynamic in time.

Pixels are then convolved with channel-specific point spread functions to obtain realistic diffraction-limited images and uniform camera noise is added to all pixels to convert fluorescence intensities to camera-detected signal.

Building SMV

To create intensity trajectories and images:

  1. Set parameters:

    Video dimensions
    Pixel size
    Bit rate
    Camera SNR characteristics
    Molecule coordinates
    Donor emission
    Cross-talks
    Point spread functions
    Background

  2. Press Update to convert FRET state sequences into camera-detected intensity trajectories and images. The execution time can be long; see Remarks for details.

  3. Update intensity data whenever one of the parameters is changed.


Validate and export data

Simulated data and simulation parameters can be exported to various file formats. Intensities can be converted into photon counts or image counts before being written to files. When exporting the SMV, video frames are successively written in files until the video length is reached.

After export, even if no file was exported, simulated intensity-time traces and FRET state sequences are made immediately available in modules Trace processing, Histogram analysis and Transition analysis.

To validate and export data to files:

  1. Set parameters:

    File options
    Intensity units

  2. Press Export files to start writing files and refresh data in modules Trace processing, Histogram analysis and Transition analysis. The execution time can be long; see Remarks for details.


Remarks

To bypass the limitations of the user interface and (1), work with more than five states, (2), set pre-defined initial state probabilities and/or transition repartition factors, or (3), set parameters for individual molecules, simulation parameters can be loaded from external files; see Pre-set parameters for more information.

Updating intensity data and writing SMVs to files can be relatively time consuming depending on which camera characteristics are chosen; see Camera SNR characteristics for more information.