-
Notifications
You must be signed in to change notification settings - Fork 16
/
experiments.html
222 lines (206 loc) · 12.4 KB
/
experiments.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
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
---
layout: idr
title: Experiments
redirect_from:
- experiments/
---
<!-- begin marketing header -->
<header class="marketing-hero">
<div class="row homepage text-center">
<div class="medium-12 columns">
<h1 class="hero-main-header">Experiments</h1>
<p class="hero-subheader small-10 medium-10 large-10 small-offset-1 medium-offset-1 large-offset-1">
Help for filling out templates for non-High Content Screen submissions
to the Image Data Resource (IDR)
</p>
</div>
</div>
</header>
<!-- begin intro section -->
<hr class="whitespace">
<div class="row column text-center">
<h2></h2> <!-- This space intentionally left blank -->
</div>
<hr>
<div class="row">
<div class="small-10 small-centered medium-10 medium-centered columns">
<div class="row horizontal">
<div>
<p>When submitting data to the IDR, you should provide 3 basic files:<p>
<ol>
<li><b>study file</b> describing the overall study and the experiments that were performed.
An experiment is a considered to be a discrete piece of work, usually with its own set of protocols</li>
<li><b>assay file(s)</b> describing the images in each experiment</li>
<li><b>processed data file(s)</b> containing summary results and/or a ‘hit' list for each experiment</li>
</ol>
<p>All files should be in tab-delimited text format. Templates are provided but can be modified to
suit your experiment. Add or remove columns from the templates as necessary. The templates can be
opened in Excel, Open Office etc.</p>
</div>
</div>
</div>
</div>
<!-- end intro section -->
<!-- begin study section -->
<hr class="whitespace">
<div class="row column text-center">
<h2>1. Study File</h2>
</div>
<hr>
<div class="row">
<div class="small-10 small-centered medium-10 medium-centered columns">
<div class="row horizontal">
<div>
<p>
This file should contain a general description of the study, and
then list the experiments(s) performed, along with the protocols describing how
each experiment was set up, imaged and the data analyzed.
</p>
<h3>1a. Study description:</h3>
<ul>
<li>Study title (mandatory)</li>
<li>Study description (mandatory)</li>
<li>Experiment publication (PubMed ID, if applicable)</li>
<li>Primary contact information (mandatory)</li>
</ul>
<h3>1b. Study experiments:</h3>
<p>For each experiment the following information should be included:</p>
<ul>
<li>Experiment description – a brief description of the aims
or contents of the experiment (mandatory)</li>
<li>Protocols –
<ul>
<li>cell growth</li>
<li>treatment (if applicable)</li>
<li>image acquisition and feature extraction</li>
<li>analysis – the analysis pipeline to go from the image data to the results</li>
</ul>
</li>
<li>Phenotypes identified – list any cellular phenotypes identified
e.g. large nucleus, elongated cell, delay of mitosis, localization of protein</li>
<li>Name of the assay file (mandatory)</li>
<li>Name of the processed data file (mandatory)</li>
<li>Description of each column in the processed data file (mandatory)</li>
<ul>
<p>
If there is more than one experiment in the study, then
copy and past the previous ‘experiment block' of text
so it can be filled in again for the next experiment.
</p>
</div>
</div>
</div>
</div>
<!-- end study section -->
<!-- begin assay section -->
<hr class="whitespace">
<div class="row column text-center">
<h2>2. Assay Files</h2>
</div>
<hr>
<div class="row">
<div class="small-10 small-centered medium-10 medium-centered columns">
<div class="row horizontal">
<div>
<p>Each experiment should have an assay file describing the samples and the images of them.
In this file, each image should have its own row, and it is almost like a time line,
with the starting sample described first (left hand side of the row) and then moving
through treatments to the sample (referencing the protocol names described in study file),
then the imaging assay, then the data analysis and finally listing the file with the results
in it. In more detail, working from left to right the row for each image should contain:</p>
<ul>
<li>sample information (e.g. species, cell line, genotype, organism part),</li>
<li>growth, treatment (if applicable), and image acquisition protocols should be listed, </li>
<li>assay name. Assay names are for each imaging ‘assay' but there may be several images
from an assay, e.g. several images from the same slide or organism part, in which case
they should all be given the same assay name to group them together. </li>
<li>Experimental conditions. Experimental conditions are any important variables
in the experiment e.g. were the cells treated with different compounds, the
protein targeted for labeling varies, or the organism part is different in each image. </li>
<li>Dataset name. This is usually the same as the assay name, but if you want to
give it a different ‘display name' in the image repository you can specify it here.</li>
<li>Image File Path – the path to the file on the file system (starting from the
folder which contains all the image files)</li>
<li>Image File name – the exact name of the image file</li>
<li>Channels – the label and what it targets, separated by a colon. Each pair of labels
and visualized object is separated by a semi-colon. E.g. DAPI:nuclei;TRITC:HA_Flag
tagged protein.</li>
<li>Data processing protocols – list the name of the data analysis protocol described
in the study file.</li>
<li>Processed data – the name of the file containing the processed data/summary results.</li>
<li>Comment[] columns can be added at any point and values in the square brackets
created as needed (although IDR curators may edit the values so that they are similar
across different studies) e.g. Comment [Image File Type] to say if the file is a raw
or derived image file.</li>
</div>
</div>
</div>
</div>
<!-- end library section -->
<!-- begin processed section -->
<hr class="whitespace">
<div class="row column text-center">
<h2>3. Processed Data Files</h2>
</div>
<hr>
<div class="row">
<div class="small-10 small-centered medium-10 medium-centered columns">
<div class="row horizontal">
<div>
<p>Each experiment should have a processed data file that contains summary
information about the results found. This may be a table from the
associated publication. This file can contain information relating
to each image or be values calculated from several images.</p>
<p>The information in the processed data should be linkable to the assay file
in some way e.g. dataset name</p>
<p>The contents of each column in the processed file should be described in the
study file so that it is clear what the values are.</p>
</div>
</div>
</div>
</div>
<!-- end processed section -->
<!-- begin outro section -->
<hr class="whitespace">
<div class="row column text-center">
<h2></h2> <!-- This space intentionally left blank -->
</div>
<hr>
<div class="row">
<div class="small-10 small-centered medium-10 medium-centered columns">
<div class="row horizontal">
<div>
<p>Lists of terms that can be used in the study and library file can be found in this
<a href="https://docs.google.com/spreadsheets/d/1S9of23dD8vY1QUv90RV_-Ugu0h6yTeNobuj92-OoSl8/edit#gid=0">
google doc</a>.</p>
<p>Example files can be found in
<a href="https://github.com/IDR/idr-metadata">https://github.com/IDR/idr-metadata</a>.
If you are
not familiar with github, it is a way of storing versions of files. You can
browse the files through the github interface. If you want to download a file
you can click on the ‘Raw' button on the top right hand side above the file
preview and then do File -> Save Page As in your browser, or if you are
familiar with github you can clone the repository. There are files in addition
to the study, library and processed files in the repository but you don't need
to provide these.</p>
<p>Examples of non-screen studies include:
<ul>
<li><a href="https://github.com/IDR/idr0018-neff-histopathology">
idr0018 - histopathology of gene knockouts</a></li>
<li><a href="https://github.com/IDR/idr0021-lawo-pericentriolarmaterial">
idr0021 - protein localization using 3D-SIM </a></li>
<li><a href="https://github.com/IDR/idr-metadata/tree/master/idr0023-szymborska-nuclearpore">
idr0023 - protein localization using dSTORM</a></li>
<li><a href="https://github.com/IDR/idr-metadata/tree/master/idr0027-dickerson-chromatin">
idr0027 - 3D-tracking of tagged chromatin loci</a></li>
<li><a href="https://github.com/IDR/idr-metadata/tree/master/idr0032-yang-meristem">
idr0032 - in situ hybridzation of RNA</a></li>
</ul></p>
<p>Email <a href="mailto:[email protected]">[email protected]</a>
with any questions.
</p>
</div>
</div>
</div>
</div>
<!-- end outro section -->