3157 |
05 Mar 07 |
martin |
1 |
<?xml version="1.0" encoding="UTF-8"?> |
3159 |
05 Mar 07 |
martin |
2 |
<!DOCTYPE chapter PUBLIC |
3159 |
05 Mar 07 |
martin |
3 |
"-//Dawid Weiss//DTD DocBook V3.1-Based Extension for XML and graphics inclusion//EN" |
3192 |
13 Mar 07 |
martin |
4 |
"../../../../lib/docbook/preprocess/dweiss-docbook-extensions.dtd"> |
3403 |
29 May 07 |
nicklas |
5 |
<!-- |
3403 |
29 May 07 |
nicklas |
$Id$ |
3403 |
29 May 07 |
nicklas |
7 |
|
3675 |
16 Aug 07 |
jari |
Copyright (C) 2007 Peter Johansson, Nicklas Nordborg, Philippe Rocca-Serra, Martin Svensson |
4889 |
06 Apr 09 |
nicklas |
Copyright (C) 2008 Jari Häkkinen |
3403 |
29 May 07 |
nicklas |
10 |
|
3403 |
29 May 07 |
nicklas |
This file is part of BASE - BioArray Software Environment. |
3403 |
29 May 07 |
nicklas |
Available at http://base.thep.lu.se/ |
3403 |
29 May 07 |
nicklas |
13 |
|
3403 |
29 May 07 |
nicklas |
BASE is free software; you can redistribute it and/or |
3403 |
29 May 07 |
nicklas |
modify it under the terms of the GNU General Public License |
4477 |
05 Sep 08 |
jari |
as published by the Free Software Foundation; either version 3 |
3403 |
29 May 07 |
nicklas |
of the License, or (at your option) any later version. |
3403 |
29 May 07 |
nicklas |
18 |
|
3403 |
29 May 07 |
nicklas |
BASE is distributed in the hope that it will be useful, |
3403 |
29 May 07 |
nicklas |
but WITHOUT ANY WARRANTY; without even the implied warranty of |
3403 |
29 May 07 |
nicklas |
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
3403 |
29 May 07 |
nicklas |
GNU General Public License for more details. |
3403 |
29 May 07 |
nicklas |
23 |
|
3403 |
29 May 07 |
nicklas |
You should have received a copy of the GNU General Public License |
4509 |
11 Sep 08 |
jari |
along with BASE. If not, see <http://www.gnu.org/licenses/>. |
3403 |
29 May 07 |
nicklas |
26 |
--> |
3403 |
29 May 07 |
nicklas |
27 |
<chapter id="reporters" chunked="0"> |
3403 |
29 May 07 |
nicklas |
28 |
<title>Reporters</title> |
5795 |
10 Oct 11 |
nicklas |
29 |
|
3403 |
29 May 07 |
nicklas |
30 |
<helptext external_id="reporter.view.properties" |
3403 |
29 May 07 |
nicklas |
31 |
title="About reporters"> |
3403 |
29 May 07 |
nicklas |
32 |
<para> |
3403 |
29 May 07 |
nicklas |
33 |
Reporter, a term coined by the MAGE object model refers to |
3403 |
29 May 07 |
nicklas |
34 |
spotted DNA sequence on a microarray. Reporters are |
3403 |
29 May 07 |
nicklas |
35 |
therefore usually described by a sequence and a series of |
3403 |
29 May 07 |
nicklas |
36 |
database identifiers qualifying that sequence. Reporters are |
3403 |
29 May 07 |
nicklas |
37 |
generally understood as the thing biologists are interested |
3403 |
29 May 07 |
nicklas |
38 |
in when carrying out DNA microarray experiments. |
3403 |
29 May 07 |
nicklas |
39 |
</para> |
3403 |
29 May 07 |
nicklas |
40 |
<para> |
4487 |
08 Sep 08 |
jari |
41 |
In BASE, reporters also refer to Affymetrix Probeset ID but |
3403 |
29 May 07 |
nicklas |
42 |
reporters can be used to describe genes, transcripts, exons |
3403 |
29 May 07 |
nicklas |
43 |
or any other sequence entity of biological relevance. |
3403 |
29 May 07 |
nicklas |
44 |
</para> |
3403 |
29 May 07 |
nicklas |
45 |
</helptext> |
3403 |
29 May 07 |
nicklas |
46 |
|
3403 |
29 May 07 |
nicklas |
47 |
<sect1 id="reportertypes"> |
3403 |
29 May 07 |
nicklas |
48 |
<title>Reporter types</title> |
3403 |
29 May 07 |
nicklas |
49 |
|
3403 |
29 May 07 |
nicklas |
50 |
<helptext external_id="reportertype.view.properties" |
3403 |
29 May 07 |
nicklas |
51 |
title="About reporter types"> |
3403 |
29 May 07 |
nicklas |
52 |
<para> |
3403 |
29 May 07 |
nicklas |
53 |
<guilabel>Reporter Type</guilabel> |
3403 |
29 May 07 |
nicklas |
54 |
allows classification of reporters based on their usage |
3403 |
29 May 07 |
nicklas |
55 |
and qualification defined during the array design |
3403 |
29 May 07 |
nicklas |
56 |
specification. |
5795 |
10 Oct 11 |
nicklas |
57 |
<nohelp> |
3403 |
29 May 07 |
nicklas |
58 |
You can manage the reporter types by going to |
3403 |
29 May 07 |
nicklas |
59 |
<menuchoice> |
3403 |
29 May 07 |
nicklas |
60 |
<guimenu>Administrate</guimenu> |
3403 |
29 May 07 |
nicklas |
61 |
<guimenuitem>Types</guimenuitem> |
3403 |
29 May 07 |
nicklas |
62 |
<guisubmenu>Reporter types</guisubmenu> |
3403 |
29 May 07 |
nicklas |
63 |
</menuchoice>. |
5795 |
10 Oct 11 |
nicklas |
64 |
</nohelp> |
3403 |
29 May 07 |
nicklas |
65 |
</para> |
5795 |
10 Oct 11 |
nicklas |
66 |
</helptext> |
3403 |
29 May 07 |
nicklas |
67 |
|
3403 |
29 May 07 |
nicklas |
68 |
<figure |
3405 |
29 May 07 |
nicklas |
69 |
id="reporterstypes.figures.properties"> |
3403 |
29 May 07 |
nicklas |
70 |
<title>Reporter type properties</title> |
3403 |
29 May 07 |
nicklas |
71 |
<screenshot> |
3403 |
29 May 07 |
nicklas |
72 |
<mediaobject> |
3403 |
29 May 07 |
nicklas |
73 |
<imageobject> |
3403 |
29 May 07 |
nicklas |
74 |
<imagedata |
3403 |
29 May 07 |
nicklas |
75 |
fileref="figures/reportertype.png" format="PNG" /> |
3403 |
29 May 07 |
nicklas |
76 |
</imageobject> |
3403 |
29 May 07 |
nicklas |
77 |
</mediaobject> |
3403 |
29 May 07 |
nicklas |
78 |
</screenshot> |
3403 |
29 May 07 |
nicklas |
79 |
</figure> |
3403 |
29 May 07 |
nicklas |
80 |
|
3403 |
29 May 07 |
nicklas |
81 |
<helptext external_id="reportertype.edit" |
3403 |
29 May 07 |
nicklas |
82 |
title="Reporter type properties"> |
3403 |
29 May 07 |
nicklas |
83 |
|
3403 |
29 May 07 |
nicklas |
84 |
<variablelist> |
3403 |
29 May 07 |
nicklas |
85 |
<varlistentry> |
3403 |
29 May 07 |
nicklas |
86 |
<term><guilabel>Name</guilabel></term> |
3403 |
29 May 07 |
nicklas |
87 |
<listitem> |
3403 |
29 May 07 |
nicklas |
88 |
<para> |
3403 |
29 May 07 |
nicklas |
89 |
The name of the reporter type. It is advised to define the name |
3403 |
29 May 07 |
nicklas |
90 |
so that it is compatible with the |
3403 |
29 May 07 |
nicklas |
91 |
<ulink url="http://www.mged.org/Workgroups/MIAME/miame.html" |
3403 |
29 May 07 |
nicklas |
92 |
>MIAME requirements</ulink> |
3403 |
29 May 07 |
nicklas |
93 |
and recommendations issues by microarray data |
3403 |
29 May 07 |
nicklas |
94 |
repositories. Alternately, the local reporter type |
3403 |
29 May 07 |
nicklas |
95 |
could be submitted to those repositories for term |
3403 |
29 May 07 |
nicklas |
96 |
inclusion. |
3403 |
29 May 07 |
nicklas |
97 |
</para> |
3403 |
29 May 07 |
nicklas |
98 |
</listitem> |
3403 |
29 May 07 |
nicklas |
99 |
</varlistentry> |
3403 |
29 May 07 |
nicklas |
100 |
<varlistentry> |
3403 |
29 May 07 |
nicklas |
101 |
<term><guilabel>Description</guilabel></term> |
3403 |
29 May 07 |
nicklas |
102 |
<listitem> |
3403 |
29 May 07 |
nicklas |
103 |
<para> |
3403 |
29 May 07 |
nicklas |
104 |
A description of the reporter type. |
3403 |
29 May 07 |
nicklas |
105 |
</para> |
3403 |
29 May 07 |
nicklas |
106 |
</listitem> |
3403 |
29 May 07 |
nicklas |
107 |
</varlistentry> |
3403 |
29 May 07 |
nicklas |
108 |
</variablelist> |
3403 |
29 May 07 |
nicklas |
109 |
</helptext> |
3403 |
29 May 07 |
nicklas |
110 |
|
3403 |
29 May 07 |
nicklas |
111 |
</sect1> |
3157 |
05 Mar 07 |
martin |
112 |
|
3157 |
05 Mar 07 |
martin |
113 |
|
3403 |
29 May 07 |
nicklas |
114 |
<sect1 id="reporter.manage"> |
3403 |
29 May 07 |
nicklas |
115 |
<title>Reporters</title> |
3403 |
29 May 07 |
nicklas |
116 |
|
3403 |
29 May 07 |
nicklas |
117 |
<para> |
3403 |
29 May 07 |
nicklas |
118 |
Go to |
3403 |
29 May 07 |
nicklas |
119 |
<menuchoice> |
3403 |
29 May 07 |
nicklas |
120 |
<guimenu>View</guimenu> |
5795 |
10 Oct 11 |
nicklas |
121 |
<guimenuitem>Reporters</guimenuitem> |
3403 |
29 May 07 |
nicklas |
122 |
</menuchoice> to view and manage the reporters. |
3403 |
29 May 07 |
nicklas |
123 |
</para> |
3403 |
29 May 07 |
nicklas |
124 |
|
3403 |
29 May 07 |
nicklas |
125 |
<sect2 id="reporters.import"> |
3403 |
29 May 07 |
nicklas |
126 |
<title>Import/update reporter from files</title> |
3403 |
29 May 07 |
nicklas |
127 |
|
3403 |
29 May 07 |
nicklas |
128 |
<para> |
3403 |
29 May 07 |
nicklas |
129 |
Reporters are used to represent genes, transcripts, |
3403 |
29 May 07 |
nicklas |
130 |
exons and therefore come in their thousands. To solve |
4487 |
08 Sep 08 |
jari |
131 |
this problem, BASE relies on |
3403 |
29 May 07 |
nicklas |
132 |
<emphasis>Reporter import plug-ins</emphasis>. |
3403 |
29 May 07 |
nicklas |
133 |
Those need to be specifically configured to deal with |
3403 |
29 May 07 |
nicklas |
134 |
a particular input file format. This input file can be |
3403 |
29 May 07 |
nicklas |
135 |
typically be an Axon GAL file or an Affymetrix CSV file |
3403 |
29 May 07 |
nicklas |
136 |
which both provide information about reporters and their |
4432 |
01 Sep 08 |
jari |
137 |
annotations. See <xref linkend="import_data" /> |
3403 |
29 May 07 |
nicklas |
138 |
for more information about importing and <xref |
3403 |
29 May 07 |
nicklas |
139 |
linkend="plugins.configuration" /> |
3403 |
29 May 07 |
nicklas |
140 |
for more information about configuring file formats. |
3403 |
29 May 07 |
nicklas |
141 |
</para> |
3403 |
29 May 07 |
nicklas |
142 |
|
3403 |
29 May 07 |
nicklas |
143 |
<note> |
3403 |
29 May 07 |
nicklas |
144 |
<title>Dealing with Affymetrix probesets</title> |
3403 |
29 May 07 |
nicklas |
145 |
<para> |
4487 |
08 Sep 08 |
jari |
146 |
In BASE, Affymetrix probesets should be treated as reporters. |
3403 |
29 May 07 |
nicklas |
147 |
The probeset ID could be stored in both the |
3403 |
29 May 07 |
nicklas |
148 |
<guilabel>Name</guilabel> and the <guilabel>External ID</guilabel> |
3403 |
29 May 07 |
nicklas |
149 |
fields of the reporter table. |
3403 |
29 May 07 |
nicklas |
150 |
Storing the probeset ID should be enough |
3403 |
29 May 07 |
nicklas |
151 |
as most analysis tools allow retrieval of updated |
3403 |
29 May 07 |
nicklas |
152 |
information based on the probeset ID from |
3403 |
29 May 07 |
nicklas |
153 |
web resources. |
3403 |
29 May 07 |
nicklas |
154 |
</para> |
4403 |
21 Aug 08 |
jari |
155 |
<para> |
4403 |
21 Aug 08 |
jari |
156 |
For some Affymetrix chips the associated CSV file does not |
4403 |
21 Aug 08 |
jari |
157 |
list all reporters on the actual chip. This will lead to |
4403 |
21 Aug 08 |
jari |
158 |
problems in later use of the affected chip types. Simply use |
4403 |
21 Aug 08 |
jari |
159 |
the associated CDF file to import the missing probesets into |
4403 |
21 Aug 08 |
jari |
160 |
BASE, make sure not to upgrade existing reporters when |
5706 |
23 Aug 11 |
nicklas |
161 |
starting the plug-in. |
4403 |
21 Aug 08 |
jari |
162 |
</para> |
3403 |
29 May 07 |
nicklas |
163 |
</note> |
3403 |
29 May 07 |
nicklas |
164 |
|
3403 |
29 May 07 |
nicklas |
165 |
</sect2> |
3403 |
29 May 07 |
nicklas |
166 |
|
3403 |
29 May 07 |
nicklas |
167 |
<sect2 id="reporters.create"> |
3403 |
29 May 07 |
nicklas |
168 |
<title>Manual management of reporters</title> |
3403 |
29 May 07 |
nicklas |
169 |
|
3403 |
29 May 07 |
nicklas |
170 |
<para> |
3403 |
29 May 07 |
nicklas |
171 |
Reporters can also be created or edited manually |
3403 |
29 May 07 |
nicklas |
172 |
one-by-one. This follows the same pattern as for |
3403 |
29 May 07 |
nicklas |
173 |
all other items and is described in general terms |
3403 |
29 May 07 |
nicklas |
174 |
in <xref linkend="webclient.items"/>. |
3403 |
29 May 07 |
nicklas |
175 |
</para> |
3403 |
29 May 07 |
nicklas |
176 |
|
3403 |
29 May 07 |
nicklas |
177 |
<figure id="reporters.figures.properties"> |
3403 |
29 May 07 |
nicklas |
178 |
<title>Reporter properties</title> |
3403 |
29 May 07 |
nicklas |
179 |
<screenshot> |
3403 |
29 May 07 |
nicklas |
180 |
<mediaobject> |
3403 |
29 May 07 |
nicklas |
181 |
<imageobject> |
3403 |
29 May 07 |
nicklas |
182 |
<imagedata fileref="figures/reporter-1.png" format="PNG" /> |
3403 |
29 May 07 |
nicklas |
183 |
</imageobject> |
3403 |
29 May 07 |
nicklas |
184 |
</mediaobject> |
3403 |
29 May 07 |
nicklas |
185 |
</screenshot> |
3403 |
29 May 07 |
nicklas |
186 |
</figure> |
3403 |
29 May 07 |
nicklas |
187 |
|
3403 |
29 May 07 |
nicklas |
188 |
<helptext external_id="reporter.edit" |
3403 |
29 May 07 |
nicklas |
189 |
title="Reporer properties"> |
3403 |
29 May 07 |
nicklas |
190 |
|
3403 |
29 May 07 |
nicklas |
191 |
<para> |
3403 |
29 May 07 |
nicklas |
192 |
This tab shows core information that would be |
3403 |
29 May 07 |
nicklas |
193 |
common to all BASE instances. |
3403 |
29 May 07 |
nicklas |
194 |
</para> |
3403 |
29 May 07 |
nicklas |
195 |
|
3403 |
29 May 07 |
nicklas |
196 |
<variablelist> |
3403 |
29 May 07 |
nicklas |
197 |
<varlistentry> |
3403 |
29 May 07 |
nicklas |
198 |
<term><guilabel>Name</guilabel></term> |
3403 |
29 May 07 |
nicklas |
199 |
<listitem> |
3403 |
29 May 07 |
nicklas |
200 |
<para> |
3403 |
29 May 07 |
nicklas |
201 |
The name of the reporter. This is often the same |
3403 |
29 May 07 |
nicklas |
202 |
as the <guilabel>External ID</guilabel>. |
3403 |
29 May 07 |
nicklas |
203 |
</para> |
3403 |
29 May 07 |
nicklas |
204 |
</listitem> |
3403 |
29 May 07 |
nicklas |
205 |
</varlistentry> |
3403 |
29 May 07 |
nicklas |
206 |
<varlistentry> |
3403 |
29 May 07 |
nicklas |
207 |
<term><guilabel>External ID</guilabel></term> |
3403 |
29 May 07 |
nicklas |
208 |
<listitem> |
3403 |
29 May 07 |
nicklas |
209 |
<para> |
3403 |
29 May 07 |
nicklas |
210 |
The external ID of the reporter as it is defined in |
3403 |
29 May 07 |
nicklas |
211 |
some database. The ID must be unique within BASE. The |
3403 |
29 May 07 |
nicklas |
212 |
external ID is what plug-ins uses to match reporter |
3403 |
29 May 07 |
nicklas |
213 |
information found in raw data files, array design files, |
3403 |
29 May 07 |
nicklas |
214 |
etc. |
3403 |
29 May 07 |
nicklas |
215 |
</para> |
3403 |
29 May 07 |
nicklas |
216 |
</listitem> |
3403 |
29 May 07 |
nicklas |
217 |
</varlistentry> |
3403 |
29 May 07 |
nicklas |
218 |
<varlistentry> |
3403 |
29 May 07 |
nicklas |
219 |
<term><guilabel>Type</guilabel></term> |
3403 |
29 May 07 |
nicklas |
220 |
<listitem> |
3403 |
29 May 07 |
nicklas |
221 |
<para> |
3403 |
29 May 07 |
nicklas |
222 |
Optionally select a reporter type. |
3403 |
29 May 07 |
nicklas |
223 |
</para> |
3403 |
29 May 07 |
nicklas |
224 |
</listitem> |
3403 |
29 May 07 |
nicklas |
225 |
</varlistentry> |
3403 |
29 May 07 |
nicklas |
226 |
<varlistentry> |
3403 |
29 May 07 |
nicklas |
227 |
<term><guilabel>Gene symbol</guilabel></term> |
3403 |
29 May 07 |
nicklas |
228 |
<listitem> |
3403 |
29 May 07 |
nicklas |
229 |
<para> |
3403 |
29 May 07 |
nicklas |
230 |
The gene this reporter represents. |
3403 |
29 May 07 |
nicklas |
231 |
</para> |
3403 |
29 May 07 |
nicklas |
232 |
</listitem> |
3403 |
29 May 07 |
nicklas |
233 |
</varlistentry> |
3403 |
29 May 07 |
nicklas |
234 |
</variablelist> |
3403 |
29 May 07 |
nicklas |
235 |
|
3403 |
29 May 07 |
nicklas |
236 |
<seeother> |
3403 |
29 May 07 |
nicklas |
237 |
<other external_id="reporter.view.properties">About reporters</other> |
3403 |
29 May 07 |
nicklas |
238 |
<other external_id="reporter.edit.extended">Extended properties</other> |
3403 |
29 May 07 |
nicklas |
239 |
</seeother> |
3403 |
29 May 07 |
nicklas |
240 |
</helptext> |
5795 |
10 Oct 11 |
nicklas |
241 |
|
3403 |
29 May 07 |
nicklas |
242 |
<figure id="reporters.figures.extended_properties"> |
3403 |
29 May 07 |
nicklas |
243 |
<title>Extended reporter properties</title> |
3403 |
29 May 07 |
nicklas |
244 |
<screenshot> |
3403 |
29 May 07 |
nicklas |
245 |
<mediaobject> |
3403 |
29 May 07 |
nicklas |
246 |
<imageobject> |
3403 |
29 May 07 |
nicklas |
247 |
<imagedata fileref="figures/reporter-2.png" format="PNG" /> |
3403 |
29 May 07 |
nicklas |
248 |
</imageobject> |
3403 |
29 May 07 |
nicklas |
249 |
</mediaobject> |
3403 |
29 May 07 |
nicklas |
250 |
</screenshot> |
3403 |
29 May 07 |
nicklas |
251 |
</figure> |
3403 |
29 May 07 |
nicklas |
252 |
|
3403 |
29 May 07 |
nicklas |
253 |
<helptext external_id="reporter.edit.extended" |
3403 |
29 May 07 |
nicklas |
254 |
title="Extended reporter properties"> |
3403 |
29 May 07 |
nicklas |
255 |
|
3403 |
29 May 07 |
nicklas |
256 |
<para> |
3403 |
29 May 07 |
nicklas |
257 |
Reporters belong to a special class whose properties |
3403 |
29 May 07 |
nicklas |
258 |
can be defined and extended by system |
3403 |
29 May 07 |
nicklas |
259 |
administrators. This is done by modifying the |
3403 |
29 May 07 |
nicklas |
260 |
<filename>extended-properties.xml</filename> file during |
3403 |
29 May 07 |
nicklas |
261 |
database configuration or upgrade. All fields on |
3403 |
29 May 07 |
nicklas |
262 |
this tab are automatically generated based on this |
3403 |
29 May 07 |
nicklas |
263 |
configuration and can be different from one server |
3403 |
29 May 07 |
nicklas |
264 |
to the next. |
3403 |
29 May 07 |
nicklas |
265 |
<nohelp> |
5738 |
15 Sep 11 |
nicklas |
266 |
See <xref linkend="installation.main" /> |
3403 |
29 May 07 |
nicklas |
267 |
and <xref linkend="appendix.extendedproperties" /> |
3403 |
29 May 07 |
nicklas |
268 |
for more information. |
3403 |
29 May 07 |
nicklas |
269 |
</nohelp> |
3403 |
29 May 07 |
nicklas |
270 |
|
3403 |
29 May 07 |
nicklas |
271 |
<note> |
3403 |
29 May 07 |
nicklas |
272 |
<para> |
3403 |
29 May 07 |
nicklas |
273 |
It is possible to configure the extended properties |
3403 |
29 May 07 |
nicklas |
274 |
so that links to the primary external databases can |
3403 |
29 May 07 |
nicklas |
275 |
be made. For example, the <guilabel>Cluster ID</guilabel> |
3403 |
29 May 07 |
nicklas |
276 |
is linked to the <ulink |
3403 |
29 May 07 |
nicklas |
277 |
url="http://www.ncbi.nlm.nih.gov/entrez/query.fcgi?db=unigene" |
4487 |
08 Sep 08 |
jari |
278 |
>UniGene database at NCBI</ulink>. |
3403 |
29 May 07 |
nicklas |
279 |
</para> |
3403 |
29 May 07 |
nicklas |
280 |
</note> |
3403 |
29 May 07 |
nicklas |
281 |
</para> |
3403 |
29 May 07 |
nicklas |
282 |
|
3403 |
29 May 07 |
nicklas |
283 |
<seeother> |
3403 |
29 May 07 |
nicklas |
284 |
<other external_id="reporter.edit">Reporter properties</other> |
3403 |
29 May 07 |
nicklas |
285 |
</seeother> |
3403 |
29 May 07 |
nicklas |
286 |
</helptext> |
3403 |
29 May 07 |
nicklas |
287 |
</sect2> |
3403 |
29 May 07 |
nicklas |
288 |
|
3157 |
05 Mar 07 |
martin |
289 |
|
3403 |
29 May 07 |
nicklas |
290 |
<sect2 id="reporter.delete"> |
3403 |
29 May 07 |
nicklas |
291 |
<title>Deleting reporters</title> |
3403 |
29 May 07 |
nicklas |
292 |
|
5795 |
10 Oct 11 |
nicklas |
293 |
<caution> |
3487 |
13 Jun 07 |
peter |
294 |
<title>Deleted reporters cannot be restored</title> |
3403 |
29 May 07 |
nicklas |
295 |
<para> |
3403 |
29 May 07 |
nicklas |
296 |
Reporters are treated differently from other |
3403 |
29 May 07 |
nicklas |
297 |
items (e.g biosources or protocols) since they |
3840 |
16 Oct 07 |
jari |
298 |
does not use the trashcan mechanism (see |
3840 |
16 Oct 07 |
jari |
299 |
<xref linkend="webclient.trashcan" />). |
3403 |
29 May 07 |
nicklas |
300 |
The deletion happens immediately and is an unrecoverable |
3403 |
29 May 07 |
nicklas |
301 |
event. BASE will always show a warning message which you must |
3403 |
29 May 07 |
nicklas |
302 |
confirm before the reporters are deleted. |
3403 |
29 May 07 |
nicklas |
303 |
</para> |
5795 |
10 Oct 11 |
nicklas |
304 |
</caution> |
3403 |
29 May 07 |
nicklas |
305 |
|
3403 |
29 May 07 |
nicklas |
306 |
<para> |
3596 |
24 Jul 07 |
nicklas |
307 |
Reporters which has been referenced to from reporter lists, raw data, array |
3487 |
13 Jun 07 |
peter |
308 |
designs, plates or any other item cannot be deleted. |
3403 |
29 May 07 |
nicklas |
309 |
</para> |
3596 |
24 Jul 07 |
nicklas |
310 |
|
3596 |
24 Jul 07 |
nicklas |
311 |
<sect3 id="reporter.delete.batch"> |
3596 |
24 Jul 07 |
nicklas |
312 |
<title>Batch deletion</title> |
3596 |
24 Jul 07 |
nicklas |
313 |
<para> |
4403 |
21 Aug 08 |
jari |
314 |
A common problem is to delete reporters that has been accidentally |
3596 |
24 Jul 07 |
nicklas |
315 |
created. The regular web interface is usually no good since it |
5706 |
23 Aug 11 |
nicklas |
316 |
only allows you to delete a limited number of reporters at a time. To solve |
3596 |
24 Jul 07 |
nicklas |
317 |
this problem the reporter import plug-in can be used in delete mode. |
3596 |
24 Jul 07 |
nicklas |
318 |
You can use the same file as you used when importing. Just select |
3596 |
24 Jul 07 |
nicklas |
319 |
the <userinput>delete</userinput> option for the <guilabel>mode</guilabel> |
3596 |
24 Jul 07 |
nicklas |
320 |
parameter in the configuration wizard and continue as usual. |
3596 |
24 Jul 07 |
nicklas |
321 |
If the plug-in is used in delete mode from a reporter list it will |
3596 |
24 Jul 07 |
nicklas |
322 |
only remove the reporters from the reporter list. The reporters are not |
3596 |
24 Jul 07 |
nicklas |
323 |
deleted from the database. |
3596 |
24 Jul 07 |
nicklas |
324 |
</para> |
3596 |
24 Jul 07 |
nicklas |
325 |
|
3596 |
24 Jul 07 |
nicklas |
326 |
<note> |
3596 |
24 Jul 07 |
nicklas |
327 |
<para> |
3596 |
24 Jul 07 |
nicklas |
328 |
It may be a bit confusing to delete things from an import plug-in. But |
3596 |
24 Jul 07 |
nicklas |
329 |
since plug-ins can only belong to one category and we wanted to re-use |
3596 |
24 Jul 07 |
nicklas |
330 |
existing file format definitions this was our only option. |
3596 |
24 Jul 07 |
nicklas |
331 |
</para> |
3596 |
24 Jul 07 |
nicklas |
332 |
</note> |
3596 |
24 Jul 07 |
nicklas |
333 |
</sect3> |
3596 |
24 Jul 07 |
nicklas |
334 |
|
3403 |
29 May 07 |
nicklas |
335 |
</sect2> |
3157 |
05 Mar 07 |
martin |
336 |
|
3403 |
29 May 07 |
nicklas |
337 |
</sect1> |
3157 |
05 Mar 07 |
martin |
338 |
|
3403 |
29 May 07 |
nicklas |
339 |
<sect1 id="reporterlists"> |
3403 |
29 May 07 |
nicklas |
340 |
<title>Reporter lists</title> |
3403 |
29 May 07 |
nicklas |
341 |
<para> |
4487 |
08 Sep 08 |
jari |
342 |
BASE allows for defining sets of reporters for a |
3403 |
29 May 07 |
nicklas |
343 |
particular use, for instance to define a list of |
5706 |
23 Aug 11 |
nicklas |
344 |
reporters to be used on an array. There are several ways to do |
3403 |
29 May 07 |
nicklas |
345 |
so: |
3403 |
29 May 07 |
nicklas |
346 |
</para> |
5706 |
23 Aug 11 |
nicklas |
347 |
<itemizedlist> |
3403 |
29 May 07 |
nicklas |
348 |
<listitem> |
3403 |
29 May 07 |
nicklas |
349 |
<para> |
3403 |
29 May 07 |
nicklas |
350 |
Use the <guibutton>New reporter list</guibutton> button on the |
3403 |
29 May 07 |
nicklas |
351 |
<menuchoice> |
3403 |
29 May 07 |
nicklas |
352 |
<guimenu>View</guimenu> |
3403 |
29 May 07 |
nicklas |
353 |
<guimenuitem>Reporters</guimenuitem> |
5706 |
23 Aug 11 |
nicklas |
354 |
</menuchoice> page. This creates a reporter list with the current |
5706 |
23 Aug 11 |
nicklas |
355 |
selection or filtered out reporters. |
3403 |
29 May 07 |
nicklas |
356 |
</para> |
3403 |
29 May 07 |
nicklas |
357 |
</listitem> |
3403 |
29 May 07 |
nicklas |
358 |
|
3403 |
29 May 07 |
nicklas |
359 |
<listitem> |
3403 |
29 May 07 |
nicklas |
360 |
<para> |
3403 |
29 May 07 |
nicklas |
361 |
Use the <guibutton>New</guibutton> button on the |
3403 |
29 May 07 |
nicklas |
362 |
<menuchoice> |
3403 |
29 May 07 |
nicklas |
363 |
<guimenu>View</guimenu> |
3403 |
29 May 07 |
nicklas |
364 |
<guimenuitem>Reporter lists</guimenuitem> |
5706 |
23 Aug 11 |
nicklas |
365 |
</menuchoice> page. This creates an initially empty reporter list |
5706 |
23 Aug 11 |
nicklas |
366 |
that can be filled later. |
3403 |
29 May 07 |
nicklas |
367 |
</para> |
3403 |
29 May 07 |
nicklas |
368 |
</listitem> |
3403 |
29 May 07 |
nicklas |
369 |
|
5706 |
23 Aug 11 |
nicklas |
370 |
<listitem> |
5706 |
23 Aug 11 |
nicklas |
371 |
<para> |
5706 |
23 Aug 11 |
nicklas |
372 |
Use the <guibutton>New reporter list</guibutton> button on the |
5706 |
23 Aug 11 |
nicklas |
373 |
<guilabel>Features</guilabel> tab on the single-item view page |
5706 |
23 Aug 11 |
nicklas |
374 |
for an array design. This creates a reporter list with all or some of |
5706 |
23 Aug 11 |
nicklas |
375 |
the reporters used on the array design. |
5706 |
23 Aug 11 |
nicklas |
376 |
</para> |
5706 |
23 Aug 11 |
nicklas |
377 |
</listitem> |
5706 |
23 Aug 11 |
nicklas |
378 |
|
5706 |
23 Aug 11 |
nicklas |
379 |
<listitem> |
5706 |
23 Aug 11 |
nicklas |
380 |
<para> |
5706 |
23 Aug 11 |
nicklas |
381 |
Use the <guibutton>New reporter list</guibutton> button on the |
5706 |
23 Aug 11 |
nicklas |
382 |
<guilabel>Raw data</guilabel> tab on the single-item view page |
5706 |
23 Aug 11 |
nicklas |
383 |
for a raw bioassay. This creates a reporter list with all or some of |
5706 |
23 Aug 11 |
nicklas |
384 |
the reporters used by the raw bioassay. |
5706 |
23 Aug 11 |
nicklas |
385 |
</para> |
5706 |
23 Aug 11 |
nicklas |
386 |
</listitem> |
5706 |
23 Aug 11 |
nicklas |
387 |
|
5706 |
23 Aug 11 |
nicklas |
388 |
<listitem> |
5706 |
23 Aug 11 |
nicklas |
389 |
<para> |
5706 |
23 Aug 11 |
nicklas |
390 |
Use the <guibutton>New reporter list</guibutton> button on the |
5706 |
23 Aug 11 |
nicklas |
391 |
<guilabel>Spot data</guilabel> tab on the single-item view page |
5706 |
23 Aug 11 |
nicklas |
392 |
for a bioassay set in the experiment analysis section. |
5706 |
23 Aug 11 |
nicklas |
393 |
This creates a reporter list with all or some of |
5706 |
23 Aug 11 |
nicklas |
394 |
the reporters used by the current bioassay set. |
5706 |
23 Aug 11 |
nicklas |
395 |
</para> |
5706 |
23 Aug 11 |
nicklas |
396 |
</listitem> |
5706 |
23 Aug 11 |
nicklas |
397 |
|
5706 |
23 Aug 11 |
nicklas |
398 |
<listitem> |
5706 |
23 Aug 11 |
nicklas |
399 |
<para> |
5706 |
23 Aug 11 |
nicklas |
400 |
Use the <guibutton>New reporter list</guibutton> button on the |
5706 |
23 Aug 11 |
nicklas |
401 |
<guilabel>Reporter search</guilabel> tab in experiment explorer. |
5706 |
23 Aug 11 |
nicklas |
402 |
This creates a reporter list with all or some of |
5706 |
23 Aug 11 |
nicklas |
403 |
the reporters used by the current bioassay set. |
5706 |
23 Aug 11 |
nicklas |
404 |
</para> |
5706 |
23 Aug 11 |
nicklas |
405 |
</listitem> |
5706 |
23 Aug 11 |
nicklas |
406 |
|
5706 |
23 Aug 11 |
nicklas |
407 |
</itemizedlist> |
5706 |
23 Aug 11 |
nicklas |
408 |
|
3403 |
29 May 07 |
nicklas |
409 |
<figure |
3403 |
29 May 07 |
nicklas |
410 |
id="reporterlists.figures.create"> |
3403 |
29 May 07 |
nicklas |
411 |
<title> |
3403 |
29 May 07 |
nicklas |
412 |
The Create reporter list called from |
3403 |
29 May 07 |
nicklas |
413 |
the reporters page. |
3403 |
29 May 07 |
nicklas |
414 |
</title> |
3403 |
29 May 07 |
nicklas |
415 |
<screenshot> |
3403 |
29 May 07 |
nicklas |
416 |
<mediaobject> |
3403 |
29 May 07 |
nicklas |
417 |
<imageobject> |
3403 |
29 May 07 |
nicklas |
418 |
<imagedata fileref="figures/reporterlist-1.png" format="PNG" /> |
3403 |
29 May 07 |
nicklas |
419 |
</imageobject> |
3403 |
29 May 07 |
nicklas |
420 |
</mediaobject> |
3403 |
29 May 07 |
nicklas |
421 |
</screenshot> |
3403 |
29 May 07 |
nicklas |
422 |
</figure> |
3403 |
29 May 07 |
nicklas |
423 |
|
3403 |
29 May 07 |
nicklas |
424 |
<helptext external_id="reporterlist.edit" |
3403 |
29 May 07 |
nicklas |
425 |
title="Create reporter list"> |
3403 |
29 May 07 |
nicklas |
426 |
|
3403 |
29 May 07 |
nicklas |
427 |
<variablelist> |
3403 |
29 May 07 |
nicklas |
428 |
<varlistentry> |
3403 |
29 May 07 |
nicklas |
429 |
<term><guilabel>Name</guilabel></term> |
3403 |
29 May 07 |
nicklas |
430 |
<listitem> |
3403 |
29 May 07 |
nicklas |
431 |
<para> |
3403 |
29 May 07 |
nicklas |
432 |
The name of the reporter list. |
3403 |
29 May 07 |
nicklas |
433 |
</para> |
3403 |
29 May 07 |
nicklas |
434 |
</listitem> |
3403 |
29 May 07 |
nicklas |
435 |
</varlistentry> |
3403 |
29 May 07 |
nicklas |
436 |
<varlistentry> |
4403 |
21 Aug 08 |
jari |
437 |
<term><guilabel>External ID</guilabel></term> |
3403 |
29 May 07 |
nicklas |
438 |
<listitem> |
3403 |
29 May 07 |
nicklas |
439 |
<para> |
3403 |
29 May 07 |
nicklas |
440 |
An optional external ID. This value is useful, |
3403 |
29 May 07 |
nicklas |
441 |
for example, for a tool that automatically |
4403 |
21 Aug 08 |
jari |
442 |
updates the reporter list from some external source. |
3403 |
29 May 07 |
nicklas |
443 |
It is not used by BASE. |
3403 |
29 May 07 |
nicklas |
444 |
</para> |
3403 |
29 May 07 |
nicklas |
445 |
</listitem> |
3403 |
29 May 07 |
nicklas |
446 |
</varlistentry> |
3403 |
29 May 07 |
nicklas |
447 |
<varlistentry> |
3403 |
29 May 07 |
nicklas |
448 |
<term><guilabel>Which reporters</guilabel></term> |
3403 |
29 May 07 |
nicklas |
449 |
<listitem> |
3403 |
29 May 07 |
nicklas |
450 |
<para> |
3403 |
29 May 07 |
nicklas |
451 |
Select one of the options for specifying which reporters |
5706 |
23 Aug 11 |
nicklas |
452 |
should be included in the list. This option is only available |
5706 |
23 Aug 11 |
nicklas |
453 |
when creating a new reporter list, not when editing an existing |
5795 |
10 Oct 11 |
nicklas |
454 |
list. The default is to create a list with <emphasis>all</emphasis> |
5795 |
10 Oct 11 |
nicklas |
455 |
reporters that are in the current list. |
3403 |
29 May 07 |
nicklas |
456 |
</para> |
3403 |
29 May 07 |
nicklas |
457 |
</listitem> |
3403 |
29 May 07 |
nicklas |
458 |
</varlistentry> |
3403 |
29 May 07 |
nicklas |
459 |
<varlistentry> |
3403 |
29 May 07 |
nicklas |
460 |
<term><guilabel>Description</guilabel></term> |
3403 |
29 May 07 |
nicklas |
461 |
<listitem> |
3403 |
29 May 07 |
nicklas |
462 |
<para> |
3403 |
29 May 07 |
nicklas |
463 |
A description of the reporter list. |
3403 |
29 May 07 |
nicklas |
464 |
</para> |
3403 |
29 May 07 |
nicklas |
465 |
</listitem> |
3403 |
29 May 07 |
nicklas |
466 |
</varlistentry> |
3403 |
29 May 07 |
nicklas |
467 |
</variablelist> |
5706 |
23 Aug 11 |
nicklas |
468 |
|
5706 |
23 Aug 11 |
nicklas |
469 |
<tip> |
5706 |
23 Aug 11 |
nicklas |
470 |
<para> |
5706 |
23 Aug 11 |
nicklas |
471 |
To add or remove reporters to the list use the |
5706 |
23 Aug 11 |
nicklas |
472 |
<guilabel>Reporters</guilabel> tab on the single-item |
5706 |
23 Aug 11 |
nicklas |
473 |
view page of a reporter list. This tab lists all |
5706 |
23 Aug 11 |
nicklas |
474 |
reporters in the list and there are functions for |
5706 |
23 Aug 11 |
nicklas |
475 |
removing, adding and importing reporters to the list. |
5706 |
23 Aug 11 |
nicklas |
476 |
</para> |
5706 |
23 Aug 11 |
nicklas |
477 |
</tip> |
5706 |
23 Aug 11 |
nicklas |
478 |
|
5706 |
23 Aug 11 |
nicklas |
479 |
|
3403 |
29 May 07 |
nicklas |
480 |
</helptext> |
3372 |
24 May 07 |
philippe |
481 |
|
5795 |
10 Oct 11 |
nicklas |
482 |
|
5795 |
10 Oct 11 |
nicklas |
483 |
<sect2 id="reporterlists.merge"> |
5795 |
10 Oct 11 |
nicklas |
484 |
<title>Merging reporter lists</title> |
5795 |
10 Oct 11 |
nicklas |
485 |
|
5795 |
10 Oct 11 |
nicklas |
486 |
<para> |
5795 |
10 Oct 11 |
nicklas |
487 |
It is possible to modify a reporter list by merging it with other reporter |
5795 |
10 Oct 11 |
nicklas |
488 |
lists. Go to the single-item view page for a reporter list. There should be |
5795 |
10 Oct 11 |
nicklas |
489 |
three buttons in the toolbar corresponding to three main merge variants: |
5795 |
10 Oct 11 |
nicklas |
490 |
</para> |
5795 |
10 Oct 11 |
nicklas |
491 |
|
5795 |
10 Oct 11 |
nicklas |
492 |
<itemizedlist> |
5795 |
10 Oct 11 |
nicklas |
493 |
<listitem> |
5795 |
10 Oct 11 |
nicklas |
494 |
<para> |
5795 |
10 Oct 11 |
nicklas |
495 |
<guilabel>Union:</guilabel> Add all reporters from |
5795 |
10 Oct 11 |
nicklas |
496 |
the source lists to the destination list. |
5795 |
10 Oct 11 |
nicklas |
497 |
</para> |
5795 |
10 Oct 11 |
nicklas |
498 |
</listitem> |
5795 |
10 Oct 11 |
nicklas |
499 |
<listitem> |
5795 |
10 Oct 11 |
nicklas |
500 |
<para> |
5795 |
10 Oct 11 |
nicklas |
501 |
<guilabel>Intersection:</guilabel> Keep only reporters |
5795 |
10 Oct 11 |
nicklas |
502 |
that are present in all selected lists. |
5795 |
10 Oct 11 |
nicklas |
503 |
</para> |
5795 |
10 Oct 11 |
nicklas |
504 |
</listitem> |
5795 |
10 Oct 11 |
nicklas |
505 |
<listitem> |
5795 |
10 Oct 11 |
nicklas |
506 |
<para> |
5795 |
10 Oct 11 |
nicklas |
507 |
<guilabel>Complement:</guilabel> Keep only reporters that |
5795 |
10 Oct 11 |
nicklas |
508 |
are unique for the destination list. |
5795 |
10 Oct 11 |
nicklas |
509 |
</para> |
5795 |
10 Oct 11 |
nicklas |
510 |
</listitem> |
5795 |
10 Oct 11 |
nicklas |
511 |
</itemizedlist> |
5795 |
10 Oct 11 |
nicklas |
512 |
|
5795 |
10 Oct 11 |
nicklas |
513 |
<para> |
5795 |
10 Oct 11 |
nicklas |
514 |
All three buttons open up the same dialog with different default selections. |
5795 |
10 Oct 11 |
nicklas |
515 |
</para> |
5795 |
10 Oct 11 |
nicklas |
516 |
|
5795 |
10 Oct 11 |
nicklas |
517 |
<figure |
5795 |
10 Oct 11 |
nicklas |
518 |
id="reporterlists.figures.merge"> |
5795 |
10 Oct 11 |
nicklas |
519 |
<title>Merge reporter lists</title> |
5795 |
10 Oct 11 |
nicklas |
520 |
<screenshot> |
5795 |
10 Oct 11 |
nicklas |
521 |
<mediaobject> |
5795 |
10 Oct 11 |
nicklas |
522 |
<imageobject> |
5795 |
10 Oct 11 |
nicklas |
523 |
<imagedata fileref="figures/reporterlist-merge.png" format="PNG" /> |
5795 |
10 Oct 11 |
nicklas |
524 |
</imageobject> |
5795 |
10 Oct 11 |
nicklas |
525 |
</mediaobject> |
5795 |
10 Oct 11 |
nicklas |
526 |
</screenshot> |
5795 |
10 Oct 11 |
nicklas |
527 |
</figure> |
5795 |
10 Oct 11 |
nicklas |
528 |
|
5795 |
10 Oct 11 |
nicklas |
529 |
<helptext external_id="reporterlist.merge" |
5795 |
10 Oct 11 |
nicklas |
530 |
title="Merge reporter lists"> |
5795 |
10 Oct 11 |
nicklas |
531 |
|
5795 |
10 Oct 11 |
nicklas |
532 |
|
5795 |
10 Oct 11 |
nicklas |
533 |
<variablelist> |
5795 |
10 Oct 11 |
nicklas |
534 |
<varlistentry> |
5795 |
10 Oct 11 |
nicklas |
535 |
<term><guilabel>This list</guilabel></term> |
5795 |
10 Oct 11 |
nicklas |
536 |
<listitem> |
5795 |
10 Oct 11 |
nicklas |
537 |
<para>Shows the name of the current reporter list.</para> |
5795 |
10 Oct 11 |
nicklas |
538 |
</listitem> |
5795 |
10 Oct 11 |
nicklas |
539 |
</varlistentry> |
5795 |
10 Oct 11 |
nicklas |
540 |
<varlistentry> |
5795 |
10 Oct 11 |
nicklas |
541 |
<term><guilabel>What to do</guilabel></term> |
5795 |
10 Oct 11 |
nicklas |
542 |
<listitem> |
5795 |
10 Oct 11 |
nicklas |
543 |
<para> |
5795 |
10 Oct 11 |
nicklas |
544 |
In this drop-down list you can select if you want to |
5795 |
10 Oct 11 |
nicklas |
545 |
<emphasis>add</emphasis>, <emphasis>keep</emphasis> |
5795 |
10 Oct 11 |
nicklas |
546 |
or <emphasis>remove</emphasis> reporters from the |
5795 |
10 Oct 11 |
nicklas |
547 |
selected list based on if a reporter is present in one |
5795 |
10 Oct 11 |
nicklas |
548 |
or all of some other reporter lists (selected below). |
5795 |
10 Oct 11 |
nicklas |
549 |
The image to the right gives an overview what will |
5795 |
10 Oct 11 |
nicklas |
550 |
happen for the currently selected alternatives. The |
5795 |
10 Oct 11 |
nicklas |
551 |
red-colored areas indicate which reporters that are |
5795 |
10 Oct 11 |
nicklas |
552 |
included in the final list. The white-colored areas |
5795 |
10 Oct 11 |
nicklas |
553 |
indicate reporters that doesn't pass the filter and |
5795 |
10 Oct 11 |
nicklas |
554 |
are excluded from the final list. |
5795 |
10 Oct 11 |
nicklas |
555 |
</para> |
5795 |
10 Oct 11 |
nicklas |
556 |
</listitem> |
5795 |
10 Oct 11 |
nicklas |
557 |
</varlistentry> |
5795 |
10 Oct 11 |
nicklas |
558 |
<varlistentry> |
5795 |
10 Oct 11 |
nicklas |
559 |
<term><guilabel>Reporter lists</guilabel></term> |
5795 |
10 Oct 11 |
nicklas |
560 |
<listitem> |
5795 |
10 Oct 11 |
nicklas |
561 |
<para> |
5795 |
10 Oct 11 |
nicklas |
562 |
You will need to select at least one more list |
5795 |
10 Oct 11 |
nicklas |
563 |
to merge with. |
5795 |
10 Oct 11 |
nicklas |
564 |
</para> |
5795 |
10 Oct 11 |
nicklas |
565 |
</listitem> |
5795 |
10 Oct 11 |
nicklas |
566 |
</varlistentry> |
5795 |
10 Oct 11 |
nicklas |
567 |
|
5795 |
10 Oct 11 |
nicklas |
568 |
</variablelist> |
5795 |
10 Oct 11 |
nicklas |
569 |
|
5795 |
10 Oct 11 |
nicklas |
570 |
|
5795 |
10 Oct 11 |
nicklas |
571 |
</helptext> |
5795 |
10 Oct 11 |
nicklas |
572 |
</sect2> |
5795 |
10 Oct 11 |
nicklas |
573 |
|
5795 |
10 Oct 11 |
nicklas |
574 |
|
5795 |
10 Oct 11 |
nicklas |
575 |
|
3403 |
29 May 07 |
nicklas |
576 |
</sect1> |
3372 |
24 May 07 |
philippe |
577 |
</chapter> |