forked from BenjaminAmbrose/smfBox
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathanasoftware.html
116 lines (105 loc) · 8.8 KB
/
anasoftware.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
<!doctype html>
<!--
##############################################################
Ignore this boilerplate if you're just trying to edit the text.
Skip to the part that says 'The real text begins here'
##############################################################
Based on this theme: https://github.com/broccolini/dinky , which mentioned that attribution
is appreciated. Thanks, broccolini!
-->
<html lang="en">
<head>
<link rel="shortcut icon" href="favicon.ico" type="image/x-icon">
<base target="_blank">
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="citation_title" content="smfBox">
<meta name="citation_author" content="Craggs Lab">
<meta name="citation_publication_date" content="[insert publicaton date here]">
<title>smfBox - Craggs Lab</title>
<link rel="stylesheet" href="stylesheets/styles.css">
<link rel="stylesheet" href="stylesheets/prism.css">
<!--[if lt IE 9]>
<script src="javascript/html5shiv/html5shiv.js"></script>
<![endif]-->
<!--[if lt IE 8]>
<p class="browserupgrade">You are using an <strong>outdated</strong> browser. Please
<a href="http://browsehappy.com/">upgrade your browser</a> to improve your
experience.</p>
<![endif]-->
<script src="javascript/scale-fix/scale.fix.js"></script>
<script src="javascript/python-highlighting/prism.js"></script>
<script async src="javascript/Minimal-MathJax/MathJax.js?config=TeX-AMS_CHTML"></script>
<script src="javascript/update_figures.js"></script>
<script src="javascript/reference_list/reference_list.js"></script>
<meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
<meta name="viewport" content="width=device-width, initial-scale=1">
<link rel="stylesheet" type="text/css" media="screen" href="./stylesheets/fancybox.css" />
<style type="text/css">
a.fancybox img {
border: none;
}
</style>
</head>
<body>
<div class="wrapper">
<header>
<script src="header.js"></script>
</header>
<!--
##############################################################
The real text begins here.
##############################################################
-->
<section>
<h1 id="Data Analysis">Data Analysis</h1>
<br>
<p>
For analysis of data from the smfBox we recommend either the <a href="https://fretbursts.readthedocs.io/en/latest/" target="_self">FRETBursts</a> python package <a href="#Fretbursts">(Ingargiola 2016)</a>, or the MATLAB software package PAM. If using python and FRETBursts, we provide a few <a href="http://jupyter.org/" target="_self">Jupyter</a> Notebooks with which to do this.
Jupyter Notebooks run in browser, and can be easily edited by anyone with a knowledge of python whilst remaining accessible to non-programmers. They can also be published as stand alone .html's for transparent presentation of data alongside the analysis exactly as it was performed. <a href="./Jnotebooks/example.html" target="_self">See here for an example</a>. To set this up:
<p/>
<ul style="list-style-type:none">
<li>1. Install <a href="https://www.anaconda.com/download/" target="_self">Anaconda</a></li>
<li>2. In the anaconda prompt type "conda install fretbursts -c conda-forge", and follow instructions in the prompt. For more information on installing FRETbursts go <a href="https://fretbursts.readthedocs.io/en/latest/installation.html" target="_self">here<a/> </li>
<li>3. Download the analysis Jupyter Notebooks from our github. <a href="https://github.com/BenjaminAmbrose/smfBox/tree/master/Jnotebooks" target="_self">here</a></li>
<li>4. Open the anaconda navigator, run Jupyter, and navigate to the notebooks from within your web browser.</li>
<br>
<li>If you want to do more advanced analysis such as PDA (as we showed with hairpins in our paper), PAM can do this and supports HDF5 files. You can find instructions for installing PAM <a href="https://gitlab.com/PAM-PIE/PAM" target="_self">here</a> </li>
</ul>
<h1 id="Data Files"><a id="References"></a>Data Files</h1>
<figure style="max-width:559px;">
<img src="images/converters.png" style="mix-blend-mode: multiply; width:90%; padding-left:5%; ">
<figcaption>
<strong>Fig 1:</strong> Types of data converter we provide for the smfBox
</figcaption></figure>
<br>
<p>The standalone C software will automatically write files in the open source photon-HDF5 format <a href="#hdf5">(Ingargiola 2016)</a>, however the LabView acquisition software saves txt files which must be converted. The txt's contain the timestamp of each photon in one column and the detector it arrived at in a second column. For usage in analysis we have created python scripts which can convert these TXT files to hdf5's. This format contains not only the raw data but also can be written with sufficient metadata that the reader knows i. the origin and nature of the sample and experiment the data was acquired from and ii. Information required to interpret it. In this case the data originates from two unpolarised detectors acquired with a μs-ALEX scheme, and the script will write an HDF5 file which contains information for any analysis software to interpret it as such.
The scripts provided can convert a single TXT to a single HDF5, multiple TXT’s from one acquisition (iteration conversion) into one HDF5, or multiple runs into their respective HDF5's (batch conversion).
These conversion scripts are available as Jupyter Notebooks, as the analysis we provide is with the FRETBursts python module in Jupyter. However there is no reason why the code should not work in any other python environment as long as it has the phconvert module.
</p>
<p>phconvert will automatically install alongside FRETBursts if you have followed the instructions above.<p/>
<h1 id="Analysis"><a id="body"></a>Analysis</h1>
<ul style="list-style-type:none">
<li>We provide user friendly Jupyter notebooks for derivation and application of accurate FRET correction factors as shown in the paper. Once downloaded from the github you can run them in anaconda according to the instructions within, using shift+enter to execute each cell. Minimal modification of the code cells is necessary.
</li>
<li>1. If you are not doing accurate FRET and are only looking for relative changes, skip the correction factor derivation and move straight to the FRET analysis notebook (step 4).
</li>
<li>2. If you do intend to do accurate FRET, first run the spectral cross talk correction factor finder to get alpha and delta. This should work on a doubly labelled sample by identifying single dye species in solution. This is arguably a more robust approach as the singly fluorescent species extracted from the data are subject to exactly the same conditions as the doubly labelled species which the correction factors will then be applied to. However, this approach can be difficult for smaller datasets, or for samples with very good labelling efficiency, so you may wish to run this notebook on a separate donor only labelled sample to find alpha, and an acceptor only labelled sample to find delta.
</li>
<li>3. Next run the gamma / beta finder, this requires multiple FRET efficiencies to work. If your sample exhibits multiple states (eg. high FRET and low FRET) then this can work on a single data set, however multiple data sets with different FRET efficiencies can be read in to this notebook if necessary.
</li>
<li>4. With correction factors found you can run the FRET analysis notebook defining the four correction factors at the beginning. Burst-by-burst information (which include the FRET efficiency distribution) can be exported here as .csv's for further analysis else where if necessary</li>
<li> The <a href="https://github.com/OpenSMFS/FRETBursts/tree/master/notebooks" target="_self">FRETBursts github</a> also contains notebooks for the BVA and 2CDE analysis techniques which are worth looking into if you are interested in investigating dynamics. </li>
<br> Please note that if you use FRETBursts in the analysis for your own research, then you should cite the FRETBursts paper (see below).
</ul>
<h1 id="References"><a id="References"></a>References</h1>
<li>FRETBursts: An Open Source Toolkit for Analysis of Freely-Diffusing Single-Molecule FRET
Ingargiola et al. (2016). Available from: <a id="Fretbursts" href="http://dx.doi.org/10.1371/journal.pone.0160716" target="_self">10.1371/journal.pone.0160716</a></li>
<br>
<li>Ingargiola A, Laurence T, Boutelle R, Weiss S, Michalet X. Photon-HDF5: open data format and computational tools for timestamp-based single-molecule experiments. In: Single Molecule Spectroscopy and Superresolution Imaging IX. vol. 971405. SPIE; 2016. Available from: <a id="hdf5" href="http://dx.doi.org/10.1117/12.2212085" target="_self">10.1117/12.2212085</a><p/>
</li>
</section>
<br><footer><script src="footer.js"></script></footer>
<!--[if !IE]><script>fixScale(document);</script><![endif]-->
</body>
</html>