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"> |
3387 |
28 May 07 |
nicklas |
5 |
<!-- |
3387 |
28 May 07 |
nicklas |
$Id$ |
3387 |
28 May 07 |
nicklas |
7 |
|
3675 |
16 Aug 07 |
jari |
Copyright (C) 2007 Nicklas Nordborg, Philippe Rocca-Serra, Martin Svensson |
3387 |
28 May 07 |
nicklas |
9 |
|
3387 |
28 May 07 |
nicklas |
This file is part of BASE - BioArray Software Environment. |
3387 |
28 May 07 |
nicklas |
Available at http://base.thep.lu.se/ |
3387 |
28 May 07 |
nicklas |
12 |
|
3387 |
28 May 07 |
nicklas |
BASE is free software; you can redistribute it and/or |
3387 |
28 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 |
3387 |
28 May 07 |
nicklas |
of the License, or (at your option) any later version. |
3387 |
28 May 07 |
nicklas |
17 |
|
3387 |
28 May 07 |
nicklas |
BASE is distributed in the hope that it will be useful, |
3387 |
28 May 07 |
nicklas |
but WITHOUT ANY WARRANTY; without even the implied warranty of |
3387 |
28 May 07 |
nicklas |
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
3387 |
28 May 07 |
nicklas |
GNU General Public License for more details. |
3387 |
28 May 07 |
nicklas |
22 |
|
3387 |
28 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/>. |
3387 |
28 May 07 |
nicklas |
25 |
--> |
5706 |
23 Aug 11 |
nicklas |
26 |
<chapter id="protocols" chunked="0"> |
5706 |
23 Aug 11 |
nicklas |
27 |
<title>Protocols</title> |
3157 |
05 Mar 07 |
martin |
28 |
|
5706 |
23 Aug 11 |
nicklas |
29 |
<para> |
5706 |
23 Aug 11 |
nicklas |
30 |
A protocol is a document describing some kind of process that |
5706 |
23 Aug 11 |
nicklas |
31 |
is typically performed in the lab to create an item |
5706 |
23 Aug 11 |
nicklas |
32 |
of some type (for example, how to create an extract from a sample). |
5706 |
23 Aug 11 |
nicklas |
33 |
It can also represent a procedure for running software programs to |
5706 |
23 Aug 11 |
nicklas |
34 |
extract measured data (for example, from a scanned microarray image). |
5706 |
23 Aug 11 |
nicklas |
35 |
A protocol in the simplest form is just a name with an optional link to a file. |
5706 |
23 Aug 11 |
nicklas |
36 |
The file may for example be a PDF or some other document with a more |
5706 |
23 Aug 11 |
nicklas |
37 |
detailed description. |
5706 |
23 Aug 11 |
nicklas |
38 |
</para> |
3387 |
28 May 07 |
nicklas |
39 |
|
3387 |
28 May 07 |
nicklas |
40 |
<para> |
5706 |
23 Aug 11 |
nicklas |
41 |
Protocols are typically added to a BASE server by an administrator |
5706 |
23 Aug 11 |
nicklas |
42 |
and can be managed from <menuchoice> |
3387 |
28 May 07 |
nicklas |
43 |
<guimenu>Administrate</guimenu> |
5706 |
23 Aug 11 |
nicklas |
44 |
<guimenuitem>Protocols</guimenuitem> |
3387 |
28 May 07 |
nicklas |
45 |
</menuchoice>. |
3387 |
28 May 07 |
nicklas |
46 |
</para> |
5706 |
23 Aug 11 |
nicklas |
47 |
|
5706 |
23 Aug 11 |
nicklas |
48 |
|
3387 |
28 May 07 |
nicklas |
49 |
<figure |
5706 |
23 Aug 11 |
nicklas |
50 |
id="protocols.figures.edit_protocol"> |
5706 |
23 Aug 11 |
nicklas |
51 |
<title>Protocol properties</title> |
3387 |
28 May 07 |
nicklas |
52 |
<screenshot> |
3387 |
28 May 07 |
nicklas |
53 |
<mediaobject> |
3387 |
28 May 07 |
nicklas |
54 |
<imageobject> |
3387 |
28 May 07 |
nicklas |
55 |
<imagedata |
5706 |
23 Aug 11 |
nicklas |
56 |
fileref="figures/edit_protocol.png" format="PNG" /> |
3387 |
28 May 07 |
nicklas |
57 |
</imageobject> |
3387 |
28 May 07 |
nicklas |
58 |
</mediaobject> |
3387 |
28 May 07 |
nicklas |
59 |
</screenshot> |
3387 |
28 May 07 |
nicklas |
60 |
</figure> |
3387 |
28 May 07 |
nicklas |
61 |
|
3387 |
28 May 07 |
nicklas |
62 |
<helptext external_id="protocol.edit" |
3387 |
28 May 07 |
nicklas |
63 |
title="Edit protocol"> |
3387 |
28 May 07 |
nicklas |
64 |
|
3387 |
28 May 07 |
nicklas |
65 |
<para> |
3387 |
28 May 07 |
nicklas |
66 |
This tab allows users to enter essential |
3387 |
28 May 07 |
nicklas |
67 |
information about a protocol. |
5706 |
23 Aug 11 |
nicklas |
68 |
</para> |
3387 |
28 May 07 |
nicklas |
69 |
|
3387 |
28 May 07 |
nicklas |
70 |
<variablelist> |
3387 |
28 May 07 |
nicklas |
71 |
<varlistentry> |
3387 |
28 May 07 |
nicklas |
72 |
<term><guilabel>Name</guilabel></term> |
3387 |
28 May 07 |
nicklas |
73 |
<listitem> |
3387 |
28 May 07 |
nicklas |
74 |
<para> |
3387 |
28 May 07 |
nicklas |
75 |
The name of the protocol. |
3387 |
28 May 07 |
nicklas |
76 |
</para> |
3387 |
28 May 07 |
nicklas |
77 |
</listitem> |
3387 |
28 May 07 |
nicklas |
78 |
</varlistentry> |
3387 |
28 May 07 |
nicklas |
79 |
<varlistentry> |
3387 |
28 May 07 |
nicklas |
80 |
<term><guilabel>Type</guilabel></term> |
3387 |
28 May 07 |
nicklas |
81 |
<listitem> |
3387 |
28 May 07 |
nicklas |
82 |
<para> |
3387 |
28 May 07 |
nicklas |
83 |
The protocol type of the protocol. The list |
3387 |
28 May 07 |
nicklas |
84 |
may evolve depending on additions by the server |
5706 |
23 Aug 11 |
nicklas |
85 |
administrator. Selecting the proper protocol type |
5706 |
23 Aug 11 |
nicklas |
86 |
is important and enables BASE to automatically guess |
5706 |
23 Aug 11 |
nicklas |
87 |
the most likely protocol when creating new items. |
5706 |
23 Aug 11 |
nicklas |
88 |
<nohelp> |
5706 |
23 Aug 11 |
nicklas |
89 |
See <xref linkend="subtypes" /> for more information. |
5706 |
23 Aug 11 |
nicklas |
90 |
</nohelp> |
3387 |
28 May 07 |
nicklas |
91 |
</para> |
3387 |
28 May 07 |
nicklas |
92 |
</listitem> |
3387 |
28 May 07 |
nicklas |
93 |
</varlistentry> |
3387 |
28 May 07 |
nicklas |
94 |
<varlistentry> |
5706 |
23 Aug 11 |
nicklas |
95 |
<term><guilabel>External ID</guilabel></term> |
5706 |
23 Aug 11 |
nicklas |
96 |
<listitem> |
5706 |
23 Aug 11 |
nicklas |
97 |
<para> |
5706 |
23 Aug 11 |
nicklas |
98 |
An ID identifying this protocol in an external |
5706 |
23 Aug 11 |
nicklas |
99 |
database. The value does not have to be unique. |
5706 |
23 Aug 11 |
nicklas |
100 |
</para> |
5706 |
23 Aug 11 |
nicklas |
101 |
</listitem> |
5706 |
23 Aug 11 |
nicklas |
102 |
</varlistentry> |
5706 |
23 Aug 11 |
nicklas |
103 |
<varlistentry> |
3387 |
28 May 07 |
nicklas |
104 |
<term><guilabel>File</guilabel></term> |
3387 |
28 May 07 |
nicklas |
105 |
<listitem> |
3387 |
28 May 07 |
nicklas |
106 |
<para> |
3387 |
28 May 07 |
nicklas |
107 |
A document containing the protocol description, |
5706 |
23 Aug 11 |
nicklas |
108 |
e.g. PDF documents from kit providers to |
3387 |
28 May 07 |
nicklas |
109 |
the protocol. Use the <guibutton>Select</guibutton> |
3387 |
28 May 07 |
nicklas |
110 |
button to select or upload a file. |
3387 |
28 May 07 |
nicklas |
111 |
</para> |
3387 |
28 May 07 |
nicklas |
112 |
</listitem> |
3387 |
28 May 07 |
nicklas |
113 |
</varlistentry> |
3387 |
28 May 07 |
nicklas |
114 |
<varlistentry> |
3387 |
28 May 07 |
nicklas |
115 |
<term><guilabel>Description</guilabel></term> |
3387 |
28 May 07 |
nicklas |
116 |
<listitem> |
3387 |
28 May 07 |
nicklas |
117 |
<para> |
3387 |
28 May 07 |
nicklas |
118 |
A description of the protocol. |
3387 |
28 May 07 |
nicklas |
119 |
</para> |
3387 |
28 May 07 |
nicklas |
120 |
</listitem> |
3387 |
28 May 07 |
nicklas |
121 |
</varlistentry> |
3387 |
28 May 07 |
nicklas |
122 |
</variablelist> |
3387 |
28 May 07 |
nicklas |
123 |
|
3387 |
28 May 07 |
nicklas |
124 |
<seeother> |
3387 |
28 May 07 |
nicklas |
125 |
<other external_id="protocol.edit.parameters">Protocol parameters</other> |
5795 |
10 Oct 11 |
nicklas |
126 |
<other external_id="annotations.edit">Annotations</other> |
3387 |
28 May 07 |
nicklas |
127 |
</seeother> |
3387 |
28 May 07 |
nicklas |
128 |
</helptext> |
3387 |
28 May 07 |
nicklas |
129 |
|
5706 |
23 Aug 11 |
nicklas |
130 |
<sect1 id="protocols.parameters"> |
3387 |
28 May 07 |
nicklas |
131 |
<title>Protocol parameters</title> |
3157 |
05 Mar 07 |
martin |
132 |
|
3387 |
28 May 07 |
nicklas |
133 |
<helptext external_id="protocol.edit.parameters" |
3387 |
28 May 07 |
nicklas |
134 |
title="Protocol parameters"> |
3157 |
05 Mar 07 |
martin |
135 |
|
3387 |
28 May 07 |
nicklas |
136 |
<para> |
3387 |
28 May 07 |
nicklas |
137 |
BASE users may declare parameters attached to a particular |
3387 |
28 May 07 |
nicklas |
138 |
protocol. Parameters are selected from a list of annotation |
3387 |
28 May 07 |
nicklas |
139 |
types which have been flagged as parameters. Annotation |
3387 |
28 May 07 |
nicklas |
140 |
types which has been selected as parameters show up in the |
3387 |
28 May 07 |
nicklas |
141 |
regular annotation dialog whenever the protocol is used for |
3387 |
28 May 07 |
nicklas |
142 |
an item. <nohelp>For more information see |
3387 |
28 May 07 |
nicklas |
143 |
<xref linkend="annotations" />.</nohelp> |
3387 |
28 May 07 |
nicklas |
144 |
</para> |
3387 |
28 May 07 |
nicklas |
145 |
|
3387 |
28 May 07 |
nicklas |
146 |
<nohelp> |
3387 |
28 May 07 |
nicklas |
147 |
<figure |
3387 |
28 May 07 |
nicklas |
148 |
id="protocols.figures.protocol_parameters"> |
3387 |
28 May 07 |
nicklas |
149 |
<title>Protocol parameters</title> |
3387 |
28 May 07 |
nicklas |
150 |
<screenshot> |
3387 |
28 May 07 |
nicklas |
151 |
<mediaobject> |
3387 |
28 May 07 |
nicklas |
152 |
<imageobject> |
3387 |
28 May 07 |
nicklas |
153 |
<imagedata |
3387 |
28 May 07 |
nicklas |
154 |
fileref="figures/protocol_parameters.png" format="PNG" /> |
3387 |
28 May 07 |
nicklas |
155 |
</imageobject> |
3387 |
28 May 07 |
nicklas |
156 |
</mediaobject> |
3387 |
28 May 07 |
nicklas |
157 |
</screenshot> |
3387 |
28 May 07 |
nicklas |
158 |
</figure> |
3387 |
28 May 07 |
nicklas |
159 |
</nohelp> |
3157 |
05 Mar 07 |
martin |
160 |
|
3387 |
28 May 07 |
nicklas |
161 |
<variablelist> |
3387 |
28 May 07 |
nicklas |
162 |
<varlistentry> |
3387 |
28 May 07 |
nicklas |
163 |
<term><guilabel>Annotation types</guilabel></term> |
3387 |
28 May 07 |
nicklas |
164 |
<listitem> |
3387 |
28 May 07 |
nicklas |
165 |
<para> |
3387 |
28 May 07 |
nicklas |
166 |
This list contains the annotation types selected |
3387 |
28 May 07 |
nicklas |
167 |
as parameters for the protocol. |
3387 |
28 May 07 |
nicklas |
168 |
</para> |
3387 |
28 May 07 |
nicklas |
169 |
</listitem> |
3387 |
28 May 07 |
nicklas |
170 |
</varlistentry> |
3387 |
28 May 07 |
nicklas |
171 |
<varlistentry> |
3387 |
28 May 07 |
nicklas |
172 |
<term><guibutton>Add annotation types</guibutton></term> |
3387 |
28 May 07 |
nicklas |
173 |
<listitem> |
3387 |
28 May 07 |
nicklas |
174 |
<para> |
4487 |
08 Sep 08 |
jari |
175 |
Use this button to open a pop-up where you can select |
3387 |
28 May 07 |
nicklas |
176 |
annotation type to use for parameters. The list only |
3387 |
28 May 07 |
nicklas |
177 |
shows annotations types which has the |
3387 |
28 May 07 |
nicklas |
178 |
<guilabel>Protocol parameter</guilabel> flag set. |
3387 |
28 May 07 |
nicklas |
179 |
</para> |
3387 |
28 May 07 |
nicklas |
180 |
</listitem> |
3387 |
28 May 07 |
nicklas |
181 |
</varlistentry> |
3387 |
28 May 07 |
nicklas |
182 |
<varlistentry> |
3387 |
28 May 07 |
nicklas |
183 |
<term><guibutton>Remove</guibutton></term> |
3387 |
28 May 07 |
nicklas |
184 |
<listitem> |
3387 |
28 May 07 |
nicklas |
185 |
<para> |
3387 |
28 May 07 |
nicklas |
186 |
Removes the selected annotation types from the list. |
3387 |
28 May 07 |
nicklas |
187 |
</para> |
3387 |
28 May 07 |
nicklas |
188 |
</listitem> |
3387 |
28 May 07 |
nicklas |
189 |
</varlistentry> |
3387 |
28 May 07 |
nicklas |
190 |
</variablelist> |
3387 |
28 May 07 |
nicklas |
191 |
|
3387 |
28 May 07 |
nicklas |
192 |
<seeother> |
3387 |
28 May 07 |
nicklas |
193 |
<other external_id="protocol.edit">Edit protocol</other> |
5795 |
10 Oct 11 |
nicklas |
194 |
<other external_id="annotations.edit">Annotations</other> |
3387 |
28 May 07 |
nicklas |
195 |
</seeother> |
3387 |
28 May 07 |
nicklas |
196 |
|
3387 |
28 May 07 |
nicklas |
197 |
</helptext> |
5795 |
10 Oct 11 |
nicklas |
198 |
|
5795 |
10 Oct 11 |
nicklas |
199 |
<para> |
5795 |
10 Oct 11 |
nicklas |
200 |
The <guilabel>Annotations</guilabel> tab allows BASE users to use |
5795 |
10 Oct 11 |
nicklas |
201 |
annotation types to refine protocol description. More about annotating items |
5795 |
10 Oct 11 |
nicklas |
202 |
can be read in <xref linkend="annotations.annotating" />. |
5795 |
10 Oct 11 |
nicklas |
203 |
</para> |
3387 |
28 May 07 |
nicklas |
204 |
</sect1> |
3372 |
24 May 07 |
philippe |
205 |
</chapter> |