-
Notifications
You must be signed in to change notification settings - Fork 18
/
Copy pathindex.html
200 lines (163 loc) · 9.87 KB
/
index.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
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
<!DOCTYPE html>
<html>
<head>
<meta charset='utf-8'>
<meta http-equiv="X-UA-Compatible" content="chrome=1">
<meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1">
<link href='https://fonts.googleapis.com/css?family=Architects+Daughter' rel='stylesheet' type='text/css'>
<link rel="stylesheet" type="text/css" href="stylesheets/stylesheet.css" media="screen">
<link rel="stylesheet" type="text/css" href="stylesheets/github-light.css" media="screen">
<link rel="stylesheet" type="text/css" href="stylesheets/print.css" media="print">
<!--[if lt IE 9]>
<script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
<![endif]-->
<title>Dirt by Computational-Plant-Science</title>
</head>
<body>
<header>
<div class="inner">
<h1>Dirt</h1>
<h2>The source code of the publication :Image-based high-throughput field phenotyping of crop roots"</h2>
<a href="https://github.com/Computational-Plant-Science/DIRT" class="button"><small>View project on</small> GitHub</a>
</div>
</header>
<div id="content-wrapper">
<div class="inner clearfix">
<section id="main-content">
<h1>
<a id="dirt-11---an-automatic-high-throughput-root-phenotyping-platform" class="anchor" href="#dirt-11---an-automatic-high-throughput-root-phenotyping-platform" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>DIRT 1.1 - An automatic high throughput root phenotyping platform</h1>
<p>(c) 2014 Alexander Bucksch - <a href="mailto:bucksch@gatech.edu">bucksch@gatech.edu</a>, Georgia Institute of Technology<br>
(c) 2016 Alexander Bucksch - <a href="mailto:bucksch@uga.edu">bucksch@uga.edu</a>, University of Georgia, Athens<br>
Web application by Abhiram Das - <a href="mailto:adas30@biology.gatech.edu">adas30@biology.gatech.edu</a></p>
<p>Web application: <a href="http://dirt.iplantcollaborative.org">http://dirt.iplantcollaborative.org</a></p>
<p>User and developer group: <a href="https://groups.google.com/forum/#!forum/dirt-users">https://groups.google.com/forum/#!forum/dirt-users</a></p>
<h2>
<a id="dependencies" class="anchor" href="#dependencies" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Dependencies</h2>
<p>The software is written and tested in:</p>
<ul>
<li>python 2.7 <a href="https://www.python.org">https://www.python.org</a>
</li>
</ul>
<h3>
<a id="required-packages" class="anchor" href="#required-packages" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Required packages:</h3>
<ul>
<li>the graphtools package <a href="http://graph-tool.skewed.de">http://graph-tool.skewed.de</a>
</li>
<li>the mahotas package <a href="http://luispedro.org/software/mahotas">http://luispedro.org/software/mahotas</a>
</li>
<li>the numpy package <a href="http://sourceforge.net/projects/numpy/">http://sourceforge.net/projects/numpy/</a>
</li>
<li>the scipy package <a href="http://www.scipy.org/SciPy">http://www.scipy.org/SciPy</a>
</li>
</ul>
<h3>
<a id="optional-packages" class="anchor" href="#optional-packages" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Optional packages:</h3>
<p>Optionally binaries of standard OCR and BarCode software can be used for tag recognition: </p>
<ul>
<li><p>tesseract <a href="https://code.google.com/p/tesseract-ocr/">https://code.google.com/p/tesseract-ocr/</a><br>
paths have to be adjusted in /DIRTocr/pytesser.py (line 12-14)</p></li>
<li><p>zbar <a href="http://zbar.sourceforge.net">http://zbar.sourceforge.net</a><br>
path has to be adjusted in /DIRTocr/<strong>init</strong>.py (line 28)</p></li>
</ul>
<h2>
<a id="command-line-usage" class="anchor" href="#command-line-usage" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Command line usage</h2>
<ul>
<li> full path to the root image<br>
</li>
<li> ID which will be a folder name in the working directory. Integer value needed.<br>
</li>
<li> multiplier for the automatically determined mask threshold. 1.0 works fine and is default. For example, if a flashlight is used to take root images, then 0.6 is a good choice.<br>
</li>
<li> number of roots placed at the right of the root crown, 0 - excised root analysis is off<br>
</li>
<li> 1 - crown root analysis is on, 0 - crown root analysis is off<br>
</li>
<li> 1 - is on, 0 - is off. Off refers to a pre-existing segmention done with DIRT. Binary masks as input images are detected automatically.<br>
</li>
<li> a simple decimal e.g. 25.4. If 0.0 is used, then the output will have pixels as unit.<br>
</li>
<li> 1 - reconstruction is turned on, 0 - reconstruction is turned off<br>
</li>
<li> 1 - plotting data is stored, 0 - plotting data is not stored<br>
</li>
<li> 1 - the full trait set is put into one excel file containing empty cells for traits that were not computed, 0 - only computed files are written to the output file<br>
</li>
<li> full path to folder were the result is stored<br>
</li>
<li> full path to .csv file containing the traits to be computed'<br>
</li>
</ul>
<h4>
<a id="example" class="anchor" href="#example" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Example:</h4>
<pre><code>python main.py /Documents/image_name.jpg 8 25.0 1 1 1 25.1 0 0 0 /Documents/image_folder/ /Documents/traits.csv
</code></pre>
<p>Notes on common questions:</p>
<ul>
<li>Input is restricted to .jpg, .png and .tif images<br>
</li>
<li>It is not possible to analyze only an excised root when a root crown is in the image. However, it is possible to analyze compute images containing only excised roots.<br>
</li>
</ul>
<h4>
<a id="running-dirt-on-folder-content" class="anchor" href="#running-dirt-on-folder-content" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Running DIRT on folder content</h4>
<p>For convenience we provide the runOnFolder script, that executes DIRT on all images in a specified folder.
Note we made the masking threshold available on the command line because of user requests.</p>
<h4>
<a id="example-1" class="anchor" href="#example-1" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Example:</h4>
<pre><code>python runOnFolder.py /Users/image_folder/ <masking threshold>
</code></pre>
<p>Please adjust line 86 according to the description above and note that the script uses 6 cores to compute images in parallel. The number of cores can be adjusted in line 80.</p>
<h2>
<a id="updates-in-dirt-11-11-january-2016" class="anchor" href="#updates-in-dirt-11-11-january-2016" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Updates in DIRT 1.1 (11 January 2016):</h2>
<ul>
<li>Minor bug fixes in Preprocessing.py to allow smaller circle markers and fix a possible missdetection of the experiment tag as the circle.<br>
Thanks to Linda Zamariola (U Bologna) for finding this issue.<br>
</li>
</ul>
<h2>
<a id="updates-in-dirt-11-4-november-2015" class="anchor" href="#updates-in-dirt-11-4-november-2015" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Updates in DIRT 1.1 (4 November 2015):</h2>
<ul>
<li>Minor bug fixes in the excised root calculations. Thanks to Alexandre Grondin (U Nebraska) for discovering and validating the fixes.<br>
</li>
</ul>
<h2>
<a id="changes-in-dirt-11-14-january-2015" class="anchor" href="#changes-in-dirt-11-14-january-2015" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Changes in DIRT 1.1 (14 January 2015):</h2>
<ul>
<li>storage of trait values is changed from a list data structure to a dictionary to allow trait selection controlled by the file traits.csv<br>
</li>
<li>added support for trait selection to reduce computation time. See example file traits.csv (1 - trait is computed, 0 - trait is not computed)<br>
</li>
<li>removed unused tip-diameter switch on the command line<br>
</li>
<li>add stem reconstruction switch on the command line to turn the experimental stem reconstruction on/off<br>
</li>
<li>output file now uses the codes in the trait.csv file and only contains selected traits<br>
</li>
<li>removed several unused variables and minor bugs fixed<br>
</li>
<li>added command line option to turn storage of numpy arrays on/off. These files can be used to plot the individual root statistics and can be found in the "Plots" folders.<br>
</li>
<li>new (experimental, not validated) traits added due to community requests: projected root area, width and depth of the skeleton (medial axis), top and bottom angle for monocots, segmentation of adventious and basal roots for legumes to retrieve taproot and hypocotyl diameter and adventious and basal root counts.<br>
</li>
<li>added computational statistics such as computation time and graph size to help balancing grid installations<br>
</li>
<li>added an option to have an output file with all possible traits that contains empty cells for not computed traits in the output.csv file. This was a developer request to enable faster ingestion into data bases<br>
</li>
</ul>
</section>
<aside id="sidebar">
<a href="https://github.com/Computational-Plant-Science/DIRT/zipball/master" class="button">
<small>Download</small>
.zip file
</a>
<a href="https://github.com/Computational-Plant-Science/DIRT/tarball/master" class="button">
<small>Download</small>
.tar.gz file
</a>
<p class="repo-owner"><a href="https://github.com/Computational-Plant-Science/DIRT"></a> is maintained by <a href="https://github.com/Computational-Plant-Science">Computational-Plant-Science</a>.</p>
<p>This page was generated by <a href="https://pages.github.com">GitHub Pages</a> using the Architect theme by <a href="https://twitter.com/jasonlong">Jason Long</a>.</p>
</aside>
</div>
</div>
</body>
</html>