source: trunk/doc/src/docbook/user/biomaterials.xml @ 5797

Last change on this file since 5797 was 5797, checked in by Nicklas Nordborg, 10 years ago

References #1590: Documentation cleanup

New and updated screenshots for chapter 16 - Biomaterial LIMS.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Id
File size: 61.1 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE chapter PUBLIC
3    "-//Dawid Weiss//DTD DocBook V3.1-Based Extension for XML and graphics inclusion//EN"
4    "../../../../lib/docbook/preprocess/dweiss-docbook-extensions.dtd">
5<!--
6  $Id: biomaterials.xml 5797 2011-10-11 12:55:26Z nicklas $
7 
8  Copyright (C) 2007 Peter Johansson, Nicklas Nordborg, Philippe Rocca-Serra, Martin Svensson
9  Copyright (C) 2008, 2009 Jari Häkkinen, Martin Svensson
10 
11  This file is part of BASE - BioArray Software Environment.
12  Available at http://base.thep.lu.se/
13 
14  BASE is free software; you can redistribute it and/or
15  modify it under the terms of the GNU General Public License
16  as published by the Free Software Foundation; either version 3
17  of the License, or (at your option) any later version.
18 
19  BASE is distributed in the hope that it will be useful,
20  but WITHOUT ANY WARRANTY; without even the implied warranty of
21  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
22  GNU General Public License for more details.
23 
24  You should have received a copy of the GNU General Public License
25  along with BASE. If not, see <http://www.gnu.org/licenses/>.
26-->
27<chapter id="biomaterials">
28  <?dbhtml dir="biomaterials" filename="index.html" ?>
29
30  <title>Biomaterial LIMS</title>
31
32    <para>
33      The generic term biomaterial refers to any biological material used in an experiment.
34      Biomaterial is divided in three main components, <emphasis>biosources</emphasis>, <emphasis>samples</emphasis>
35      and <emphasis>extracts</emphasis>. The biomaterials can then be subclassified further by
36      the use of subtypes (see <xref linkend="subtypes"/>). BASE has, for example, defined two extracts subtypes:
37      <emphasis>Labeled extract</emphasis> (used in microarray experiments)
38      and <emphasis>Library</emphasis> (used in sequencing experiments).   
39      The order used in presenting those entities is not innocuous as it represents the
40      sequence of transformation a source material undergoes until it is in a state compatible
41      for further exeperimental processing. This progression is actually
42      mimicked in the BASE
43      <guimenu>Biomaterial LIMS</guimenu>
44      menu again to insist on this natural progression.
45    </para>
46    <itemizedlist>
47      <listitem>
48        <simpara>
49          Biosources correspond to the native biological entity used in an experiment
50          prior to any treatment.
51        </simpara>
52      </listitem>
53      <listitem>
54        <simpara>
55          Samples are central to BASE to describe the sample processing. So samples can
56          be created from other samples if user want to track sample processing event in a
57          finely granular fashion.
58        </simpara>
59      </listitem>
60      <listitem>
61        <simpara>
62          Extracts correspond to nucleic acid material extracted from a tissue sample or a
63          cell culture sample.
64        </simpara>
65      </listitem>
66    </itemizedlist>
67    <para>
68      BASE allows users to create any of the these entities fairly freely, however it is
69      expected that users will follow the natural path of the laboratory workflow.
70    </para>
71
72 
73  <sect1 id="biomaterials.biosources">
74    <?dbhtml filename="biosources.html" ?>
75    <title>Biosources</title>
76
77
78    <para>
79      Biosources correspond to the native biological entity used in an experiment prior to any treatment.
80      Biosources can be added to BASE by most users and are managed from <menuchoice>
81        <guimenu>Biomaterial LIMS</guimenu>
82        <guimenuitem>Biosources</guimenuitem>
83      </menuchoice>.
84      Use the &gbNew; button to create a new biosource. This brings up the dialog below.
85    </para>
86
87      <figure id="biomaterials.figures.biosource-tab-1">
88        <title>Biosource properties</title>
89        <screenshot>
90          <mediaobject>
91            <imageobject>
92              <imagedata 
93                fileref="figures/biosource-tab-1.png" format="PNG" />
94            </imageobject>
95          </mediaobject>
96        </screenshot>
97      </figure>
98      <helptext external_id="biosource.edit" title="Biosource properties">
99
100        <variablelist>
101          <varlistentry>
102            <term>
103              <guilabel>Name</guilabel>
104            </term>
105            <listitem>
106              <para>
107                This is the only mandatory field. BASE by default assigns
108                <replaceable>New biosource</replaceable>
109                as name but it is advised to provide unique sensible names.
110              </para>
111            </listitem>
112          </varlistentry>
113          <varlistentry>
114            <term>
115              <guilabel>Type</guilabel>
116            </term>
117            <listitem>
118              <para>
119              The subtype of the biosource. The list
120              may evolve depending on additions by the server
121              administrator. Selecting the proper subtype
122              is recommended and enables BASE to automatically guess
123              the most likely subtype when creating child biomaterial.
124              <nohelp>
125              See <xref linkend="subtypes" /> for more information.
126              </nohelp>
127              </para>
128            </listitem>
129          </varlistentry>
130          <varlistentry>
131            <term>
132              <guilabel>External ID</guilabel>
133            </term>
134            <listitem>
135              <para>
136                An external reference identifiers (e.g. a patient identification
137                code) can be supplied using this field.
138              </para>
139            </listitem>
140          </varlistentry>
141          <varlistentry>
142            <term>
143              <guilabel>Description</guilabel>
144            </term>
145            <listitem>
146              <para>A free text description can be supplied using this field.</para>
147            </listitem>
148          </varlistentry>
149        </variablelist>
150        <seeother>
151          <other external_id="annotations.edit">Annotations</other>
152        </seeother>
153      </helptext>
154
155      <para>
156        The <guilabel>Annotations</guilabel> tab allows BASE users to use
157        annotation types to refine biosource description. More about annotating items
158        can be read in <xref linkend="annotations.annotating" />
159      </para>
160
161  </sect1>
162  <sect1 id="biomaterial.samples">
163    <?dbhtml filename="samples.html" ?>
164    <title>Samples</title>
165    <para>
166      Samples result from processing events applied to biosource material or other samples
167      before they are turned into an extract. In other words, samples can be created from
168      biosource items or from one or more sample items. When a sample is created from several
169      other samples, a pooling event is performed.
170    </para>
171    <para>
172      For every step of transformation from biosource to sample, it is possible to provide
173      information about the protocol used to perform this task. It is not enforced in BASE
174      but it should serve as guidance when devising the granularity of the sample processing
175      task. Also, it is good practice to provide protocol information to ensure MIAME
176      compliance.
177    </para>
178    <para>
179      Use
180      <menuchoice>
181        <guimenu>Biomaterial LIMS</guimenu>
182        <guimenuitem>Samples</guimenuitem>
183      </menuchoice>
184      to get to the list of samples.
185    </para>
186   
187    <sect2 id="biomaterial.samples.create">
188      <title>Create sample</title>
189   
190      <para>
191        Beside the common way, using the &gbNew; button, a sample can be created in one of
192        the following ways:
193      </para>
194        <variablelist>
195          <varlistentry>
196            <term>from either biosource list- or single view- page.</term>
197            <listitem>
198              <para>
199                No matter how complex the sample processing phase is, at least one
200                sample has to be anchored to a biosource. Therefore, a natural way
201                to create an sample is to click on
202                <guiicon>
203                  <inlinemediaobject>
204                    <imageobject>
205                      <imagedata fileref="figures/add.png" format="PNG" />
206                    </imageobject>
207                  </inlinemediaobject>
208                </guiicon>
209                in the <guilabel>Samples</guilabel> column of the biosource list view. There is also a
210                corresponding button,
211                <guibutton>New sample&hellip;</guibutton>
212                in the toolbar when viewing a single biosource.
213              </para>
214            </listitem>
215          </varlistentry>
216          <varlistentry>
217            <term>from the sample list page</term>
218            <listitem>
219              <para>
220                Child samples can be created from a single parent by clicking on the
221                <guiicon>
222                  <inlinemediaobject>
223                    <imageobject>
224                      <imagedata fileref="figures/add.png" format="PNG" />
225                    </imageobject>
226                  </inlinemediaobject>
227                </guiicon> icon in the <guilabel>Child samples</guilabel> column.
228                Pooled samples can be created by first selecting the parents
229                from the list of samples and then click the <guibutton>Pool&hellip;</guibutton>
230                button in the toolbar.
231              </para>
232            </listitem>
233          </varlistentry>
234        </variablelist>
235    </sect2>
236     
237    <sect2 id="biomaterial.samples.properties">
238      <title>Sample properties</title>
239        <figure id="biomaterials.figures.biosample-tab-1">
240          <title>Sample properties</title>
241          <screenshot>
242            <mediaobject>
243              <imageobject>
244                <imagedata 
245                  fileref="figures/biosample-tab-1.png" format="PNG" />
246              </imageobject>
247            </mediaobject>
248          </screenshot>
249        </figure>
250        <helptext external_id="sample.edit" title="Edit sample">
251          <variablelist>
252            <varlistentry>
253              <term>
254                <guilabel>Name</guilabel>
255              </term>
256              <listitem>
257                <para>
258                  The sample's name (required). BASE by default assigns names to
259                  samples (by suffixing
260                  <replaceable>s#</replaceable>
261                  when creating a sample from an existing biosource or
262                  <replaceable>New Sample</replaceable>
263                  otherwise) but it is possible to edit at will.
264                </para>
265              </listitem>
266            </varlistentry>
267            <varlistentry>
268              <term>
269                <guilabel>Type</guilabel>
270              </term>
271              <listitem>
272                <para>
273                The subtype of the sample. The list
274                may evolve depending on additions by the server
275                administrator. Selecting the proper subtype
276                is recommended and enables BASE to automatically guess
277                the most likely subtype when creating child biomaterial.
278                <nohelp>
279                See <xref linkend="subtypes" /> for more information.
280                </nohelp>
281                </para>
282              </listitem>
283            </varlistentry>
284            <varlistentry>
285              <term>
286                <guilabel>External ID</guilabel>
287              </term>
288              <listitem>
289                <para>
290                  An identification used to identify the sample outside BASE.
291                </para>
292              </listitem>
293            </varlistentry>
294            <varlistentry>
295              <term>
296                <guilabel>Original quantity</guilabel>
297              </term>
298              <listitem>
299                <para>
300                  This is meant to report information about the actual mass of
301                  sample created.
302                </para>
303              </listitem>
304            </varlistentry>
305            <varlistentry>
306              <term>
307                <guilabel>Created</guilabel>
308              </term>
309              <listitem>
310                <para>
311                  A date when the sample was created. The information can be
312                  important when running quality controls on data and account for
313                  potential confounding factor (e.g. day effect).
314                </para>
315              </listitem>
316            </varlistentry>
317            <varlistentry>
318              <term>
319                <guilabel>Registered</guilabel>
320              </term>
321              <listitem>
322                <para>The date at which the sample was entered in BASE.</para>
323              </listitem>
324            </varlistentry>
325            <varlistentry>
326              <term>
327                <guilabel>Protocol</guilabel>
328              </term>
329              <listitem>
330                <para>The protocol used to produce this sample.</para>
331              </listitem>
332            </varlistentry>
333            <varlistentry>
334              <term>
335                <guilabel>Bioplate</guilabel>
336              </term>
337              <listitem>
338                <para>The bioplate where this sample is located.</para>
339              </listitem>             
340            </varlistentry>
341            <varlistentry>
342              <term>
343                <guilabel>Biowell</guilabel>
344              </term>
345              <listitem>
346                <para>
347                  Biowell that holds this sample.
348                  <guilabel>Bioplate</guilabel> has to be defined before
349                  biowell can be selected.
350                </para>
351              </listitem>             
352            </varlistentry>
353            <varlistentry>
354              <term>
355                <guilabel>Description</guilabel>
356              </term>
357              <listitem>
358                <para>
359                  A text field to report any information that not can be captured
360                  otherwise.
361                </para>
362              </listitem>
363            </varlistentry>
364          </variablelist>
365         
366          <seeother>
367            <other external_id="sample.parents">Parents</other>
368            <other external_id="annotations.edit">Annotations &amp; parameters</other>
369            <other external_id="annotations.edit.inherited">Inherited annotations</other>
370          </seeother>
371        </helptext>
372    </sect2>
373   
374    <sect2 id="biomaterial.samples.parents">
375      <title>Sample parents</title>
376        <figure id="biomaterials.figures.biosample-tab-2">
377          <title>Sample parents</title>
378          <screenshot>
379            <mediaobject>
380              <imageobject>
381                <imagedata 
382                  fileref="figures/biosample-tab-2.png" format="PNG" />
383              </imageobject>
384            </mediaobject>
385          </screenshot>
386        </figure>
387       
388        <helptext external_id="sample.parents" title="Sample's parents">
389          <para>
390            This is meant to keep track of the sample origin. BASE
391            distinguishes between two cases which are controlled by the
392            <guilabel>Parent type</guilabel>
393            radio-button in the edit pop-up window.
394          </para>
395          <itemizedlist>
396            <listitem>
397              <para>
398                If the parent is a biosource the radio-button is set to
399                <guilabel>Biosource</guilabel>. Only a single biosource
400                can be used as the parent. This option is automatically
401                selected if the user selects a biosource with the
402                <guibutton>Select biosource</guibutton> button.
403              </para>
404            </listitem>
405            <listitem>
406              <para>
407                When the parent is one or several other samples the radio-button is
408                set to <guilabel>Sample</guilabel>. This option is automatically
409                selected if the user add samples with the <guibutton>Add samples</guibutton> button.           
410                For each parent sample, it is
411                possible to specify the amount used in µg. This will automatically
412                update the <guilabel>remaining quantity</guilabel> of the parent.
413              </para>
414            </listitem>
415          </itemizedlist>
416         
417          <seeother>
418            <other external_id="sample.edit">Sample properties</other>
419            <other external_id="annotations.edit">Annotations &amp; parameters</other>
420            <other external_id="annotations.edit.inherited">Inherited annotations</other>
421          </seeother>
422        </helptext>
423    </sect2>
424    <para>
425      The <guilabel>Annotations</guilabel> tab allows BASE users to use
426      annotation types to refine sample description. More about annotating items
427      can be read in <xref linkend="annotations.annotating" />
428    </para>
429       
430    <para>
431      This <guilabel>Inherited annotations</guilabel> tab contains a list of those annotations
432      that are inherited from the sample's parents. Information about working with inherited
433      annotations can be found in <xref linkend="annotations.inheriting" />.
434    </para>
435  </sect1>
436
437  <sect1 id="biomaterials.extracts">
438    <?dbhtml filename="extracts.html" ?>
439    <title>Extracts</title>
440    <para>
441      Extract items should be used to describe the events that transform a sample material
442      into an extract material. An extract can be created from one sample item or from one or
443      more extract items. When an extract is created from several other extracts, a pooling
444      event is performed.
445    </para>
446    <para>
447      During the transformation from samples to extracts, it is possible to provide
448      information about the protocol used to perform this task. It is not enforced in BASE
449      but it should serve as guidance when devising the granularity of the sample processing
450      task. Also, it is good practice to provide protocol information.
451    </para>
452    <para>
453      Use
454      <menuchoice>
455        <guimenu>Biomaterial LIMS</guimenu>
456        <guimenuitem>Extracts</guimenuitem>
457      </menuchoice>
458      to get to the list of extracts.
459    </para>
460    <sect2 id="biomaterials.extracts.create">
461      <title>Create extract</title>
462      <para>
463        Beside the common way, using the &gbNew; button, an extract can be created in one of
464        the following ways:
465        <variablelist>
466          <varlistentry>
467            <term>from either sample list- or single view- page.</term>
468            <listitem>
469              <para>
470                No matter how complex the extract processing phase is, at least one
471                extract has to be anchored to a sample. Therefore, a natural way to
472                create an extract is to click on
473                <guiicon>
474                  <inlinemediaobject>
475                    <imageobject>
476                      <imagedata fileref="figures/add.png" format="PNG" />
477                    </imageobject>
478                  </inlinemediaobject>
479                </guiicon>
480                in the <guilabel>Child extracts</guilabel> column for the sample that should be a parent of the
481                extract.  There is also a corresponding button,
482                <guibutton>New child extract&hellip;</guibutton>
483                in the toolbar when viewing a single sample.
484              </para>
485            </listitem>
486          </varlistentry>
487          <varlistentry>
488            <term>from the extract list page</term>
489            <listitem>
490              <para>
491                Child extracts can be created from a single parent by clicking on the
492                <guiicon>
493                  <inlinemediaobject>
494                    <imageobject>
495                      <imagedata fileref="figures/add.png" format="PNG" />
496                    </imageobject>
497                  </inlinemediaobject>
498                </guiicon> icon in the <guilabel>Child extracts</guilabel> column.
499                Pooled extract can be created by first selecting the parents
500                from the list of extracts and then press
501                <guibutton>Pool&hellip;</guibutton>
502                in the toolbar. The selected extracts will be put into the parent
503                property.
504              </para>
505            </listitem>
506          </varlistentry>
507        </variablelist>
508      </para>
509    </sect2>
510    <sect2 id="biomaterials.extracts.properties">
511      <title>Extract properties</title>
512     
513        <figure id="biomaterials.figures.extract-tab-1">
514          <title>Extract properties</title>
515          <screenshot>
516            <mediaobject>
517              <imageobject>
518                <imagedata 
519                  fileref="figures/extract-tab-1.png" format="PNG" />
520              </imageobject>
521            </mediaobject>
522          </screenshot>
523        </figure>
524        <helptext external_id="extract.edit" title="Edit extract">
525          <variablelist>
526            <varlistentry>
527              <term>
528                <guilabel>Name</guilabel>
529              </term>
530              <listitem>
531                <para>
532                  A mandatory field for providing the extract name. BASE by
533                  default assigns names to extract (by suffixing
534                  <replaceable>e#</replaceable>
535                  when creating an extract from an existing sample or
536                  <replaceable>New extract</replaceable>
537                  otherwise) but it is possible to edit it at will.
538                </para>
539              </listitem>
540            </varlistentry>
541            <varlistentry>
542              <term>
543                <guilabel>Type</guilabel>
544              </term>
545              <listitem>
546                <para>
547                The subtype of the extract. The list
548                may evolve depending on additions by the server
549                administrator. Selecting the proper subtype
550                is recommended and enables BASE to automatically guess
551                the most likely subtype when creating child biomaterial and
552                bioassays.
553                <nohelp>
554                See <xref linkend="subtypes" /> for more information.
555                </nohelp>
556                </para>
557              </listitem>
558            </varlistentry>
559            <varlistentry>
560              <term>
561                <guilabel>Tag</guilabel>
562              </term>
563              <listitem>
564                <para>
565                  If the extract has been marked with a tag, select it here. Note
566                  that the subtype of the extract usually limits what kind of tag
567                  that can be used. For example, a <emphasis>labeled extract</emphasis>
568                  should be tagged with a <emphasis>label</emphasis>.
569                </para>
570              </listitem>
571            </varlistentry>
572            <varlistentry>
573              <term>
574                <guilabel>External ID</guilabel>
575              </term>
576              <listitem>
577                <para>The extracts identification outside BASE</para>
578              </listitem>
579            </varlistentry>
580            <varlistentry>
581              <term>
582                <guilabel>Original quantity</guilabel>
583              </term>
584              <listitem>
585                <para>
586                  Holds information about the original mass of the created
587                  extract.
588                </para>
589              </listitem>
590            </varlistentry>
591            <varlistentry>
592              <term>
593                <guilabel>Created</guilabel>
594              </term>
595              <listitem>
596                <para>
597                  The date when the extract was created. The information can be
598                  important when running quality controls on data and account for
599                  potential confounding factor (e.g. day effect)
600                </para>
601              </listitem>
602            </varlistentry>
603            <varlistentry>
604              <term>
605                <guilabel>Registered</guilabel>
606              </term>
607              <listitem>
608                <para>
609                  This is automatically populated with a date at which the sample
610                  was entered in BASE system.
611                </para>
612              </listitem>
613            </varlistentry>
614            <varlistentry>
615              <term>
616                <guilabel>Protocol</guilabel>
617              </term>
618              <listitem>
619                <para>
620                  The extraction protocol that was used to produce the extract.
621                </para>
622              </listitem>
623            </varlistentry>
624            <varlistentry>
625              <term>
626                <guilabel>Bioplate</guilabel>
627              </term>
628              <listitem>
629                <para>The bioplate where this extract is located.</para>
630              </listitem>             
631            </varlistentry>
632            <varlistentry>
633              <term>
634                <guilabel>Biowell</guilabel>
635              </term>
636              <listitem>
637                <para>
638                  Biowell that holds this extract.
639                  <guilabel>Bioplate</guilabel> has to be defined before
640                  biowell can be selected.
641                </para>
642              </listitem>             
643            </varlistentry>
644            <varlistentry>
645              <term>
646                <guilabel>Description</guilabel>
647              </term>
648              <listitem>
649                <para>
650                  A text field to report any information that not can be captured
651                  otherwise.
652                </para>
653              </listitem>
654            </varlistentry>
655          </variablelist>
656          <seeother>
657            <other external_id="extract.edit.parents">Parents</other>
658            <other external_id="annotations.edit">Annotations &amp; parameters</other>
659            <other external_id="annotations.edit.inherited">Inherited annotations</other>
660          </seeother>
661        </helptext>
662  </sect2>
663 
664  <sect2 id="biomaterials.extracts.parents">
665    <title>Extract parents</title>
666        <figure id="biomaterials.figures.extract-tab-2">
667          <title>Extract parents</title>
668          <screenshot>
669            <mediaobject>
670              <imageobject>
671                <imagedata 
672                  fileref="figures/extract-tab-2.png" format="PNG" />
673              </imageobject>
674            </mediaobject>
675          </screenshot>
676        </figure>
677        <helptext external_id="extract.parents" title="Extract's parents">
678          <para>
679            This is meant to keep track of the extract origin. BASE
680            distinguishes between two cases which are controlled by the
681            <guilabel>Parent type</guilabel>
682            radio-button in the edit pop-up window.
683          </para>
684          <itemizedlist>
685            <listitem>
686              <para>
687                If the parent is a sample the radio-button is set to
688                <guilabel>Sample</guilabel>. Only a single sample
689                can be used as the parent. This option is automatically
690                selected if the user selects a sample with the
691                <guibutton>Select sample</guibutton> button.
692              </para>
693            </listitem>
694            <listitem>
695              <para>
696                When the parent is one or several other extracts the radio-button is
697                set to <guilabel>Extract</guilabel>. This option is automatically
698                selected if the user add extracts with the <guibutton>Add extracts</guibutton> button.           
699              </para>
700            </listitem>
701          </itemizedlist>
702         
703          <para>
704            For each parent item, it is
705            possible to specify the amount used in micrograms. This will automatically
706            update the <guilabel>remaining quantity</guilabel> of the parent.
707          </para>
708         
709          <seeother>
710            <other external_id="extract.edit">Extract properties</other>
711            <other external_id="annotations.edit">Annotations &amp; parameters</other>
712            <other external_id="annotations.edit.inherited">Inherited annotations</other>
713          </seeother>
714        </helptext>
715
716    <para>
717      The <guilabel>Annotations</guilabel> tab allows BASE users to use
718      annotation types to refine extract description. More about annotating items
719      can be read in <xref linkend="annotations.annotating" />
720    </para>
721       
722    <para>
723      This <guilabel>Inherited annotations</guilabel> tab contains a list of those annotations
724      that are inherited from the extract's parents. Information about working with inherited
725      annotations can be found in <xref linkend="annotations.inheriting" />.
726    </para>
727
728
729  </sect2>
730
731
732  </sect1>
733
734  <sect1 id="biomaterials.tags">
735    <?dbhtml filename="tags.html" ?>
736    <title>Tags</title>
737    <para>
738      Before attempting to create tagged extracts, users should make sure that the
739      appropriate tag object is present in BASE. To browse the list of tags, go to
740      <menuchoice>
741        <guimenu>Biomaterial LIMS</guimenu>
742        <guimenuitem>Tags</guimenuitem>
743      </menuchoice>
744    </para>
745
746    <figure id="biomaterials.figures.tags">
747      <title>Tag properties</title>
748      <screenshot>
749        <mediaobject>
750          <imageobject>
751            <imagedata 
752              fileref="figures/edit_tag.png" format="PNG" />
753          </imageobject>
754        </mediaobject>
755      </screenshot>
756    </figure>
757
758    <helptext external_id="tag.edit" title="Edit tag">
759      <para>
760        The tag item is very simple and does not need much explanation. There are only
761        a few properties for a tag.
762        <variablelist>
763          <varlistentry>
764            <term>
765              <guilabel>Name</guilabel>
766            </term>
767            <listitem>
768              <para>The name of the tag (required).</para>
769            </listitem>
770          </varlistentry>
771          <varlistentry>
772            <term>
773              <guilabel>Type</guilabel>
774            </term>
775            <listitem>
776              <para>
777              The subtype of the tag. The list
778              may evolve depending on additions by the server
779              administrator. Selecting the proper subtype
780              is important and enables BASE to automatically guess
781              the most likely tag when creating tagged extracts (eg.
782              a <emphasis>Label</emphasis> for a <emphasis>Labeled extract</emphasis> 
783              or a <emphasis>Barcode</emphasis> for a <emphasis>Library</emphasis>).
784              <nohelp>
785              See <xref linkend="subtypes" /> for more information.
786              </nohelp>
787              </para>
788            </listitem>
789          </varlistentry>
790          <varlistentry>
791            <term>
792              <guilabel>Description</guilabel>
793            </term>
794            <listitem>
795              <para>
796                An explaining text or other information associated with the
797                tag.
798              </para>
799            </listitem>
800          </varlistentry>
801        </variablelist>
802      </para>
803    </helptext>
804
805  </sect1>
806
807 
808  <sect1 id="biomaterials.bioplates">
809    <?dbhtml filename="bioplates.html" ?>
810    <title>Bioplates</title>
811    <para>
812      With bioplates it is possible to organize biomaterial such as samples and extracts
813      into wells. Each plate has a number of wells that is defined by the plate geometry.
814    </para>
815    <para>
816      Use
817      <menuchoice>
818        <guimenu>Biomaterial LIMS</guimenu>
819        <guimenuitem>Bioplates</guimenuitem>
820      </menuchoice>
821      to get to the list of bioplates.   
822    </para>
823    <sect2 id="biomaterials.bioplate.properties">
824      <title>Bioplate properties</title>     
825
826      <figure id="biomaterials.figures.bioplate-tab-1">
827        <title>Bioplate properties</title>
828        <screenshot>
829          <mediaobject>
830            <imageobject>
831              <imagedata 
832                fileref="figures/bioplate-tab-1.png" format="PNG" />
833            </imageobject>
834          </mediaobject>
835        </screenshot>
836      </figure>
837
838      <helptext external_id="bioplate.edit" title="Edit bioplate">
839        <para>
840          <variablelist>
841            <varlistentry>
842              <term><guilabel>Name</guilabel></term>
843              <listitem>
844                <para>
845                  The bioplate name. The name does not have to be unique but it is
846                  recommended to keep it unique. BASE by default assigns
847                  <replaceable>New bioplate</replaceable> as name.
848                  This field is mandatory.
849                </para>
850              </listitem>
851            </varlistentry>
852            <varlistentry>
853              <term><guilabel>Bioplate type</guilabel></term>
854              <listitem>
855                <para>
856                  The type of the bioplate may be a generic storage plate that
857                  can store any type of biomaterial or a locked plate that
858                  can only store a single type of biomaterial. This field
859                  is mandatory and can only be set for new bioplates.
860                  <nohelp>See <xref linkend="biomaterials.bioplatetypes" /> for more
861                  information.</nohelp>
862                </para>
863              </listitem>             
864            </varlistentry>
865            <varlistentry>
866              <term><guilabel>Plate geometry</guilabel></term>
867              <listitem>
868                <para>
869                  Information about the plate design defining the
870                  number of  rows and columns on the bioplate.
871                  This field is mandatory and can only be set for new bioplates.
872                </para>
873              </listitem>             
874            </varlistentry>
875            <varlistentry>
876              <term><guilabel>Freezer</guilabel></term>
877              <listitem>
878                <para>The freezer where the bioplate is stored. Optional.</para>
879              </listitem>
880            </varlistentry>
881            <varlistentry>
882              <term><guilabel>Barcode</guilabel></term>
883              <listitem>
884                <para>
885                  Barcode of the bioplate.
886                  Optional.
887                </para>
888              </listitem>
889            </varlistentry>
890            <varlistentry>
891              <term><guilabel>Description</guilabel></term>
892              <listitem>
893                <para>
894                  Other useful information about the bioplate. Optional.
895                </para>
896              </listitem>
897            </varlistentry>
898          </variablelist>
899        </para>
900       
901        <seeother>
902          <other external_id="annotations.edit">Annotations</other>
903        </seeother>
904      </helptext>
905     
906    <para>
907      The <guilabel>Annotations</guilabel> tab allows BASE users to use
908      annotation types to refine bioplate description. More about annotating items
909      can be read in <xref linkend="annotations.annotating" />
910    </para>
911
912    </sect2>
913    <sect2 id="biomaterials.bioplate.biowells">
914      <title>Biowells</title>
915      <para>
916        Biowells existence are managed through the bioplate they
917        belong to. Creating a bioplate will automatically create the
918        biowells (as given by the selected geometry) on the plate.
919        The wells are initially empty. To add biomaterial to the plate
920        go to the single-item view page for the bioplate. This page
921        includes an overview of the layout of the plate. Clicking
922        on an empty well will open a popup dialog that allows you
923        to select a biomaterial. The same dialog can also be accessed from
924        the <guilabel>Wells</guilabel> tab. Assigning a biomaterial to a
925        biowell can also be done when editing a sample or extract, or
926        by using the <link linkend="biomaterials.placeonplate">Place-on-plate
927        wizard</link>.
928      </para>
929     
930      <figure id="biomaterials.figures.biowell">
931        <title>Biowell properties</title>
932        <screenshot>
933          <mediaobject>
934            <imageobject>
935              <imagedata 
936                fileref="figures/biowell.png" format="PNG" />
937            </imageobject>
938          </mediaobject>
939        </screenshot>
940      </figure>
941
942        <helptext external_id="biowell.edit" title="Edit biowell">
943          <para>
944            <variablelist>
945              <varlistentry>
946                <term><guilabel>Bioplate</guilabel></term>
947                <listitem>
948                  <para>
949                    Shows which bioplate the biowell is located on.
950                    This property is read-only.
951                  </para>
952                </listitem>
953              </varlistentry>
954              <varlistentry>             
955                <term><guilabel>Well location</guilabel></term>
956                <listitem>
957                  <para>
958                    The biowell location on the bioplate in row+column format.
959                    This property is read-only.
960                  </para>
961                </listitem>
962              </varlistentry>
963              <varlistentry>
964                <term><guilabel>Biomaterial type</guilabel></term>
965                <listitem>
966                  <para>
967                    The type of biomaterial stored in this biowell. This
968                    property must be selected before before a
969                    biomaterial can be selected. On some plates this
970                    is locked due to settings in the bioplate's type.
971                  </para>
972                </listitem>
973              </varlistentry>
974              <varlistentry>             
975                <term><guilabel>Biomaterial</guilabel></term>
976                <listitem>
977                  <para>
978                    Name of the biomaterial in this biowell. Before changing
979                    this you must select the appropriate <guilabel>Biomaterial type</guilabel>.
980                    A biomaterial can only be placed in a single well. If the selected
981                    biomaterial is already placed in another location it will be moved.
982                  </para>
983                </listitem>
984              </varlistentry>
985            </variablelist>
986          </para>
987        </helptext> 
988    </sect2>
989   
990    <sect2 id="biomaterials.bioplatetypes">
991      <title>Bioplate types</title>
992     
993      <helptext external_id="bioplatetype.view.properties" title="Bioplate types">
994      <para>
995        Bioplate types are used to subclassify bioplates and may put restrictions on them.
996        BASE ships with a few pre-defined bioplate types. The <emphasis>Storage plate</emphasis> type
997        is a generic plate type that can be used for all types of biomaterial and doesn't
998        have any other restrictions on it. The reaction plate types are locked to a single
999        type of biomaterial and have a restriction that biomaterial can never be moved out from
1000        a well once it has been placed there.
1001      </para>
1002      </helptext>
1003     
1004      <figure id="biomaterials.figures.bioplatetype">
1005        <title>Bioplate type properties</title>
1006        <screenshot>
1007          <mediaobject>
1008            <imageobject>
1009              <imagedata 
1010                fileref="figures/edit_bioplatetype.png" format="PNG" />
1011            </imageobject>
1012          </mediaobject>
1013        </screenshot>
1014      </figure>
1015     
1016          <helptext external_id="bioplatetype.edit" title="Edit bioplate type">
1017          <para>
1018            <variablelist>
1019              <varlistentry>
1020                <term><guilabel>Name</guilabel></term>
1021                <listitem>
1022                  <para>
1023                    The name of the bioplate type.
1024                  </para>
1025                </listitem>
1026              </varlistentry>
1027              <varlistentry>             
1028                <term><guilabel>Biomaterial type</guilabel></term>
1029                <listitem>
1030                  <para>
1031                    Select if bioplates using this type should be locked to
1032                    specific biomaterial type or not. This property can only
1033                    be set for new bioplate types.
1034                  </para>
1035                </listitem>
1036              </varlistentry>
1037              <varlistentry>             
1038                <term><guilabel>Biomaterial subtype</guilabel></term>
1039                <listitem>
1040                  <para>
1041                    If a specific biomaterial type has been selected
1042                    it is also possible to further restrict the use
1043                    of the bioplate to a certain biomaterial subtype.
1044                    The restriction is not enforced by the core but is mainly used
1045                    by the gui to provide smart filters in selection
1046                    lists, in the bioplate event wizards, etc.
1047                  </para>
1048                </listitem>
1049              </varlistentry>
1050              <varlistentry>
1051                <term><guilabel>Well lock mode</guilabel></term>
1052                <listitem>
1053                  <para>
1054                    This option controls the wells on bioplates using this type.
1055                    There are four options:
1056                    <itemizedlist>
1057                      <listitem>
1058                        <para><guilabel>Unlocked</guilabel>:
1059                          The wells are unlocked and biomaterial can be added
1060                          and removed freely any number of times.
1061                        </para>
1062                      </listitem>
1063                      <listitem>
1064                        <para><guilabel>Locked after add+clear</guilabel>:
1065                          A biomaterial can be placed once in the well and
1066                          then moved to another bioplate. After that the well
1067                          becomes locked and it is not possible to add a
1068                          different biomaterial to it.
1069                        </para>
1070                      </listitem>
1071                      <listitem>
1072                        <para><guilabel>Locked after add</guilabel>:
1073                          The wells are locked as soon as biomaterial is
1074                          added to them. The biomaterial can't be moved to another
1075                          place or be replaced with other biomaterial.
1076                        </para>
1077                      </listitem>
1078                      <listitem>
1079                        <para><guilabel>Locked at plate creation</guilabel>:
1080                          The wells are locked as soon as the bioplate has been
1081                          saved to the database. This lock mode is primarily intended
1082                          to be used when plug-ins are creating and populating the
1083                          bioplate as a single event.
1084                        </para>
1085                      </listitem>
1086                    </itemizedlist>
1087                  </para>
1088                </listitem>
1089              </varlistentry>
1090              <varlistentry>             
1091                <term><guilabel>Description</guilabel></term>
1092                <listitem>
1093                  <para>
1094                    Other useful information about the bioplate type. Optional.
1095                  </para>
1096                </listitem>
1097              </varlistentry>
1098            </variablelist>
1099          </para>
1100        </helptext> 
1101    </sect2>
1102   
1103    <sect2 id="biomaterials.bioplateevents">
1104      <title>Bioplate events</title>
1105   
1106      <para>
1107        Certain actions can be applied collectively to the biomaterial on a bioplate,
1108        either as a whole or a subset that is picked by the user.
1109        A list of the available actions can be found on the list page
1110        <menuchoice>
1111          <guimenu>Biomaterial LIMS</guimenu>
1112          <guimenuitem>Bioplate event types</guimenuitem>
1113        </menuchoice>.
1114       
1115        Although it is possible to create more event types here there is usually no
1116        meaning to do so, since each event needs a specailized GUI wizard to take
1117        care of it. The possibility to add more event types should be seen as an
1118        opportunity for extension development.
1119      </para>
1120     
1121      <sect3 id="biomaterials.placeonplate">
1122        <title>The place-on-plate event</title>
1123     
1124        <figure id="biomaterials.figures.placeonplate">
1125          <title>Place on plate wizard</title>
1126          <screenshot>
1127            <mediaobject>
1128              <imageobject>
1129                <imagedata 
1130                  fileref="figures/place_on_plate.png" format="PNG" />
1131              </imageobject>
1132            </mediaobject>
1133          </screenshot>
1134        </figure>
1135     
1136        <helptext external_id="bioplateevent.place-on-plate" title="Place on plate">
1137        <para>
1138          This event is available on the sample and extract list pages and can be used
1139          to place multiple biomaterial on a bioplate in one go. Click on
1140          the <guibutton>Place on plate</guibutton> button to start the wizard.
1141          The wizard will automatically use the selected biomaterials or, if none
1142          are selected, all listed biomaterials that aren't alredy located on a
1143          plate.
1144
1145          <variablelist>
1146            <varlistentry>
1147              <term><guilabel>Event name</guilabel></term>
1148              <listitem>
1149                <para>
1150                  Give a name to the event, or keep the suggested name.
1151                </para>
1152              </listitem>
1153            </varlistentry>
1154            <varlistentry>
1155              <term><guilabel>Event date</guilabel></term>
1156              <listitem>
1157                <para>
1158                  The date of the event.
1159                </para>
1160              </listitem>
1161            </varlistentry>
1162            <varlistentry>
1163              <term><guilabel>Protocol</guilabel></term>
1164              <listitem>
1165                <para>
1166                  The protocol used in the event, if any.
1167                </para>
1168              </listitem>
1169            </varlistentry>
1170            <varlistentry>
1171              <term><guilabel>Hardware</guilabel></term>
1172              <listitem>
1173                <para>
1174                  The hardware item used in the event, if any.
1175                </para>
1176              </listitem>
1177            </varlistentry>
1178            <varlistentry>
1179              <term><guilabel>Description</guilabel></term>
1180              <listitem>
1181                <para>
1182                  Other comments about the event.
1183                </para>
1184              </listitem>
1185            </varlistentry>
1186            <varlistentry>
1187              <term><guilabel>Select plate...</guilabel></term>
1188              <listitem>
1189                <para>
1190                  You need to select an existing plate on which the
1191                  biomaterial should be placed. It is only possible to
1192                  use one plate in each event. If you want to place biomaterial
1193                  on more than one plate, the wizard must be repeated for
1194                  each destination plate.
1195                </para>
1196              </listitem>
1197            </varlistentry>
1198            <varlistentry>
1199              <term><guilabel>Clear</guilabel></term>
1200              <listitem>
1201                <para>
1202                  Clear all current placement.
1203                </para>
1204              </listitem>
1205            </varlistentry>
1206            <varlistentry>
1207              <term><guilabel>Place by row/column</guilabel></term>
1208              <listitem>
1209                <para>
1210                  Automatically place the remaining biomaterial by filling empty wells,
1211                  starting with rows or columns.
1212                </para>
1213              </listitem>
1214            </varlistentry>
1215            <varlistentry>
1216              <term><guilabel>Items to place</guilabel></term>
1217              <listitem>
1218                <para>
1219                  This column contains the biomaterial that should be placed on the plate.
1220                  When a destination plate has been selected, it is displayed as a grid to
1221                  the right. To place a biomaterial either use the <guibutton>Place by row</guibutton>
1222                  or <guibutton>Place by column</guibutton> buttons, or select an item in this
1223                  list. When an item has been selected, click on the destination well on the
1224                  plate. The coordinate of the well is displayed in the gray area before the
1225                  biomaterial name and a line is drawn between it and the destination well.
1226                  The destination well is also marked with an icon.
1227                  If the <guilabel>Auto-select next unmapped item</guilabel> is selected
1228                  the selection is automatically moved to the next biomaterial which can then
1229                  be placed by selecting another destination well. If a mistake is made it is
1230                  easy to correct. Simply re-select the item and then click on the correct well.
1231                </para>
1232              </listitem>
1233            </varlistentry>
1234
1235          </variablelist>
1236         
1237          When the biomaterial has been placed on the plate (it is not neccessary to place all of them)
1238          click on <guibutton>Save</guibutton> to store everything. BASE will create a plate event
1239          for the selected destination plate and "other"-type events for each biomaterial that was
1240          placed on it.
1241        </para>
1242        </helptext> 
1243      </sect3>
1244
1245      <sect3 id="biomaterials.move">
1246        <title>The move biomaterials event</title>
1247     
1248        <figure id="biomaterials.figures.move">
1249          <title>Move biomaterials wizard</title>
1250          <screenshot>
1251            <mediaobject>
1252              <imageobject>
1253                <imagedata 
1254                  fileref="figures/move_biomaterials.png" format="PNG" />
1255              </imageobject>
1256            </mediaobject>
1257          </screenshot>
1258        </figure>
1259     
1260        <helptext external_id="bioplateevent.move" title="Move biomaterials">
1261        <para>
1262          This event is available on the single-item view page of a bioplate
1263          and can be used to move biomaterial from one plate to another. Click on
1264          the <guibutton>Move biomaterial</guibutton> button to start the wizard.
1265          <variablelist>
1266            <varlistentry>
1267              <term><guilabel>Event name</guilabel></term>
1268              <listitem>
1269                <para>
1270                  Give a name to the event, or keep the suggested name.
1271                </para>
1272              </listitem>
1273            </varlistentry>
1274            <varlistentry>
1275              <term><guilabel>Event date</guilabel></term>
1276              <listitem>
1277                <para>
1278                  The date of the event.
1279                </para>
1280              </listitem>
1281            </varlistentry>
1282            <varlistentry>
1283              <term><guilabel>Protocol</guilabel></term>
1284              <listitem>
1285                <para>
1286                  The protocol used in the event, if any.
1287                </para>
1288              </listitem>
1289            </varlistentry>
1290            <varlistentry>
1291              <term><guilabel>Hardware</guilabel></term>
1292              <listitem>
1293                <para>
1294                  The hardware item used in the event, if any.
1295                </para>
1296              </listitem>
1297            </varlistentry>
1298            <varlistentry>
1299              <term><guilabel>Description</guilabel></term>
1300              <listitem>
1301                <para>
1302                  Other comments about the event.
1303                </para>
1304              </listitem>
1305            </varlistentry>
1306            <varlistentry>
1307              <term><guilabel>Select plate...</guilabel></term>
1308              <listitem>
1309                <para>
1310                  You need to select an existing plate to which the
1311                  biomaterial should be moved. It is only possible to
1312                  use one plate in each event. If you want to move biomaterial
1313                  to more than one plate, the wizard must be repeated for
1314                  each destination plate.
1315                </para>
1316              </listitem>
1317            </varlistentry>
1318            <varlistentry>
1319              <term><guilabel>Clear</guilabel></term>
1320              <listitem>
1321                <para>
1322                  Clear all current mapping between the source and destination plates.
1323                </para>
1324              </listitem>
1325            </varlistentry>
1326            <varlistentry>
1327              <term><guilabel>Place by row/column</guilabel></term>
1328              <listitem>
1329                <para>
1330                  Automatically move the remaining biomaterial by filling empty wells,
1331                  starting with rows or columns.
1332                </para>
1333              </listitem>
1334            </varlistentry>
1335            <varlistentry>
1336              <term><guilabel>Predefined mapping</guilabel></term>
1337              <listitem>
1338                <para>
1339                  Use this button to select a predefined mapping between source
1340                  and destination wells. The biomaterial will be moved according
1341                  to the mapping.
1342                </para>
1343              </listitem>
1344            </varlistentry>
1345            <varlistentry>
1346              <term><guilabel>Source plate</guilabel></term>
1347              <listitem>
1348                <para>
1349                  This displays the source plate as a grid with icons that indicate
1350                  filled and movable wells.
1351                 
1352                  When a destination plate has been selected, it is displayed as a similar grid to
1353                  the right. To move a biomaterial either use the <guibutton>Place by row</guibutton>,
1354                  <guibutton>Place by column</guibutton> or <guibutton>Predefined mapping</guibutton>
1355                  buttons, or select a well on the source plate. When a source well has been selected,
1356                  click on a well on the destination plate. A line is drawn between the source and
1357                  destination wells and the icons are updated to show what is going on. The
1358                  wells on the destination plate will also show the coordinate of the mapped
1359                  source well unless the <guilabel>Show source coordinates</guilabel>
1360                  checkbox is deselected. If a mistake is made it is
1361                  easy to correct. Simply re-select the source well and then click on the correct
1362                  destination well.
1363                   
1364                </para>
1365              </listitem>
1366            </varlistentry>
1367          </variablelist>
1368
1369          When the biomaterial has been mapped between the source and destination plates
1370          (it is not neccessary to map all of them) click on <guibutton>Save</guibutton> to store everything.
1371          BASE will create a plate event for the selected plates and "other"-type events for each
1372          biomaterial that was moved.
1373
1374        </para>
1375        </helptext>
1376      </sect3>
1377     
1378      <sect3 id="biomaterials.create_child">
1379        <title>The create child plate event</title>
1380     
1381        <figure id="biomaterials.figures.create_child_1">
1382          <title>Create child plate wizard - step 1</title>
1383          <screenshot>
1384            <mediaobject>
1385              <imageobject>
1386                <imagedata 
1387                  fileref="figures/create_child_plate_1.png" format="PNG" />
1388              </imageobject>
1389            </mediaobject>
1390          </screenshot>
1391        </figure>
1392     
1393        <helptext external_id="bioplateevent.create-child-1" title="Create child plate - step 1">
1394        <para>
1395          This event is available on the single-item view page of a bioplate
1396          when the bioplate is limited to a single type of biomaterial (eg.
1397          only samples or only extracts). The event is used to create either
1398          a child bioplate with biomaterial that is derived from the biomaterial
1399          on the parent plate or to create one or more physical bioassays. Click on
1400          the <guibutton>Create child bioplate</guibutton> button to start the wizard.
1401        </para>
1402       
1403        <para>
1404          The wizard has two steps. In the first step you set properties that
1405          are related to the event and to the creation of child plates and
1406          biomaterial. The first step is divied into three main sections.
1407        </para>
1408       
1409       
1410        <bridgehead>Event</bridgehead>
1411       
1412        <variablelist>
1413          <varlistentry>
1414            <term><guilabel>Event name</guilabel></term>
1415            <listitem>
1416              <para>
1417                Give a name to the event, or keep the suggested name.
1418              </para>
1419            </listitem>
1420          </varlistentry>
1421          <varlistentry>
1422            <term><guilabel>Event date</guilabel></term>
1423            <listitem>
1424              <para>
1425                The date of the event.
1426              </para>
1427            </listitem>
1428          </varlistentry>
1429          <varlistentry>
1430            <term><guilabel>Protocol</guilabel></term>
1431            <listitem>
1432              <para>
1433                The protocol used in the event, if any.
1434              </para>
1435            </listitem>
1436          </varlistentry>
1437          <varlistentry>
1438            <term><guilabel>Hardware</guilabel></term>
1439            <listitem>
1440              <para>
1441                The hardware item used in the event, if any.
1442              </para>
1443            </listitem>
1444          </varlistentry>
1445          <varlistentry>
1446            <term><guilabel>Description</guilabel></term>
1447            <listitem>
1448              <para>
1449                Other comments about the event.
1450              </para>
1451            </listitem>
1452          </varlistentry>
1453        </variablelist>
1454         
1455        <bridgehead>Child biomaterial</bridgehead>
1456        <variablelist>
1457          <varlistentry>
1458            <term><guilabel>Type</guilabel></term>
1459            <listitem>
1460              <para>
1461                The type of child items to create. If the source plate
1462                contains samples, you can select between sample and
1463                extract and if the source plate contains extract you
1464                can select between extract and physical bioassay.
1465              </para>
1466            </listitem>
1467          </varlistentry>
1468          <varlistentry>
1469            <term><guilabel>Subtype</guilabel></term>
1470            <listitem>
1471              <para>
1472                The subtype to assign to the newly created biomaterial
1473                (or physical bioassay). The list of options is automatically
1474                updated based on the selection in the <guilabel>Type</guilabel>
1475                list.
1476              </para>
1477            </listitem>
1478          </varlistentry>
1479          <varlistentry>
1480            <term><guilabel>Tag</guilabel></term>
1481            <listitem>
1482              <para>
1483                Visible when creating child extracts only. Select the tag to
1484                assign to the new extract. If no tag is selected and the
1485                source biomaterial is also extracts, the children will get the
1486                same tag as their parents.
1487              </para>
1488            </listitem>
1489          </varlistentry>
1490          <varlistentry>
1491            <term><guilabel>Original quantity</guilabel></term>
1492            <listitem>
1493              <para>
1494                The original quantity of the new biomaterial. Not visible when
1495                creating a physical bioassay.
1496              </para>
1497            </listitem>
1498          </varlistentry>
1499          <varlistentry>
1500            <term><guilabel>Used quantity</guilabel></term>
1501            <listitem>
1502              <para>
1503                The quantity that was used from the parent biomaterial
1504                in the process of creating child biomaterial.
1505              </para>
1506            </listitem>
1507          </varlistentry>
1508          <varlistentry>
1509            <term><guilabel>Description</guilabel></term>
1510            <listitem>
1511              <para>
1512                Other comments about the new biomaterial.
1513              </para>
1514            </listitem>
1515          </varlistentry>
1516        </variablelist>
1517       
1518       
1519        <bridgehead>Child plates</bridgehead>
1520        <variablelist>
1521          <varlistentry>
1522            <term><guilabel>No. of plates</guilabel></term>
1523            <listitem>
1524              <para>
1525                The number of child plates to create. The default value is 1.
1526              </para>
1527            </listitem>
1528          </varlistentry>
1529          <varlistentry>
1530            <term><guilabel>Name prefix</guilabel></term>
1531            <listitem>
1532              <para>
1533                The child plates will be named using the prefix plus a running number
1534                starting with 0. Eg. New plate.0.
1535              </para>
1536            </listitem>
1537          </varlistentry>
1538          <varlistentry>
1539            <term><guilabel>Geometry</guilabel></term>
1540            <listitem>
1541              <para>
1542                The geometry of the child plates. The default is the same
1543                geometry as the parent plate. This option is replaced with
1544                <guilabel>Size of bioassay</guilabel> when creating a
1545                physical bioassay.
1546              </para>
1547            </listitem>
1548          </varlistentry>
1549          <varlistentry>
1550            <term><guilabel>Plate type</guilabel></term>
1551            <listitem>
1552              <para>
1553                The plate type of the child plates. Not used when creating a
1554                physical bioassay.
1555              </para>
1556            </listitem>
1557          </varlistentry>
1558          <varlistentry>
1559            <term><guilabel>Freezer</guilabel></term>
1560            <listitem>
1561              <para>
1562                The freezer in which the new child plates are located. Not used
1563                when creating a physical bioassay.
1564              </para>
1565            </listitem>
1566          </varlistentry>
1567          <varlistentry>
1568            <term><guilabel>Description</guilabel></term>
1569            <listitem>
1570              <para>
1571                Other comments about the new child plates.
1572              </para>
1573            </listitem>
1574          </varlistentry>
1575        </variablelist>
1576       
1577        <seeother>
1578          <other external_id="bioplateevent.create-child-2">Create child plate - step 2</other>
1579        </seeother>
1580        </helptext>
1581
1582        <figure id="biomaterials.figures.create_child_2">
1583          <title>Create child plate wizard - step 2</title>
1584          <screenshot>
1585            <mediaobject>
1586              <imageobject>
1587                <imagedata 
1588                  fileref="figures/create_child_plate_2.png" format="PNG" />
1589              </imageobject>
1590            </mediaobject>
1591          </screenshot>
1592        </figure>
1593     
1594        <helptext external_id="bioplateevent.create-child-2" title="Create child plate - step 2">
1595        <para>
1596          The second step display the source plate and new child plates as a grid.
1597          To create child biomaterial either use the <guibutton>Place by row</guibutton>,
1598          <guibutton>Place by column</guibutton> or <guibutton>Predefined mapping</guibutton>
1599          buttons, or select a well on the source plate. When a source well has been selected,
1600          click on a well on the destination plate. A line is drawn between the source and
1601          destination wells and the icons are updated to show what is going on. The
1602          wells on the destination plate will also show the coordinate of the mapped
1603          source well unless the <guilabel>Show source coordinates</guilabel>
1604          checkbox is deselected. If a mistake is made it is
1605          easy to correct. Simply re-select the source well and then click on the correct
1606          destination well.
1607        </para>
1608       
1609        <para>
1610          When a child biomaterial is selected you have the option to override the
1611          automatially generated name. It is also possible to change the name
1612          and barcode of the child plate.
1613        </para>
1614       
1615        <note>
1616          The principle is the same when creating physical bioassays, except that no
1617          new child biomaterial is created.
1618        </note>
1619       
1620        <para>
1621          When the biomaterial has been mapped between the source and destination plates
1622          (it is not neccessary to map all of them) click on <guibutton>Save</guibutton> 
1623          to store everything. BASE will create a plate event for the selected plates
1624          and "create" or "bioassay"-type events for each biomaterial that was used.
1625        </para>
1626       
1627        <seeother>
1628          <other external_id="bioplateevent.create-child-1">Create child plate - step 1</other>
1629        </seeother>
1630       
1631        </helptext>
1632      </sect3>
1633    </sect2>
1634   
1635  </sect1>
1636 
1637  <sect1 id="biomaterials.lists">
1638    <?dbhtml filename="lists.html" ?>
1639    <title>Biomaterial lists</title>
1640   
1641    <para>
1642      TODO
1643    </para>
1644 
1645  </sect1>
1646
1647  <sect1 id="biomaterials.bioassays">
1648    <?dbhtml filename="bioassays.html" ?>
1649    <title>Physical bioassays</title>
1650    <para>
1651      A physical bioassay represents the application of one or more extracts
1652      to an experimental setup designed to measure quantities that we are
1653      interested in. For example, a <emphasis>Hybridization</emphasis> event corresponds
1654      to the application of one or more <emphasis>Labeled extracts</emphasis>
1655      materials to a microarray slide under conditions detailed in hybridization protocols.
1656      Use
1657      <menuchoice>
1658        <guimenu>View</guimenu>
1659        <guimenuitem>Physical bioassays</guimenuitem>
1660      </menuchoice>
1661      to get to the bioassays.
1662    </para>
1663   
1664    <sect2 id="biomaterials.bioassays.create">
1665      <title>Create physical bioassays</title>
1666      <para>
1667        In BASE, there are two possible routes to create a physical bioassay except the
1668        common way with the &gbNew; button at the list page.
1669      </para>
1670      <variablelist>
1671        <varlistentry>
1672          <term>from the extract list view page</term>
1673          <listitem>
1674            <para>
1675              Select at least one extract, to create a bioassay from, by
1676              ticking the selection boxes before the name field.
1677              Click on the <guibutton>New physical bioassay&hellip;</guibutton>
1678              in the toolbar.
1679            </para>
1680          </listitem>
1681        </varlistentry>
1682        <varlistentry>
1683          <term>from the extract single-item page</term>
1684          <listitem>
1685            <para>
1686              When viewing an extract in single-item view, click on the
1687              <guibutton>New physical bioassay&hellip;</guibutton>
1688              button in the toolbar.
1689            </para>
1690          </listitem>
1691        </varlistentry>
1692      </variablelist>
1693    </sect2>
1694   
1695    <sect2 id="biomaterials.bioassays.properties">
1696      <title>Bioassay properties</title>
1697
1698 
1699        <figure id="biomaterials.figures.bioassays-tab-1">
1700          <title>Physical bioassay properties</title>
1701          <screenshot>
1702            <mediaobject>
1703              <imageobject>
1704                <imagedata 
1705                  fileref="figures/physicalbioassay-tab-1.png" format="PNG" />
1706              </imageobject>
1707            </mediaobject>
1708          </screenshot>
1709        </figure> 
1710       
1711        <helptext external_id="physicalbioassay.edit" title="Edit physical bioassay">
1712        <variablelist>
1713          <varlistentry>
1714            <term>
1715              <guilabel>Name</guilabel>
1716            </term>
1717            <listitem>
1718              <para>
1719                The bioassay's name (required). It is recommended that the default
1720                name is replaced with something that is unique.
1721              </para>
1722            </listitem>
1723          </varlistentry>
1724          <varlistentry>
1725            <term>
1726              <guilabel>Type</guilabel>
1727            </term>
1728            <listitem>
1729              <para>
1730              The subtype of the bioassay. The list
1731              may evolve depending on additions by the server
1732              administrator. Selecting the proper subtype
1733              is recommended and enables BASE to automatically guess
1734              the most likely subtype when assignint source biomaterials
1735              and when creating derived bioassays.
1736              <nohelp>
1737              See <xref linkend="subtypes" /> for more information.
1738              </nohelp>
1739              </para>
1740            </listitem>
1741          </varlistentry>
1742          <varlistentry>
1743            <term>
1744              <guilabel>Size</guilabel>
1745            </term>
1746            <listitem>
1747              <para>
1748                The size of the bioassay is the number of independent
1749                positions on the bioassay. Depending on the
1750                characteristics of the bioassay, multiple biomaterials
1751                may share the same position, but are then usually
1752                required to have different tags. Two biomaterials
1753                in different positions can use the same tag.
1754                The default value is 1, but some platforms, for example
1755                Illumina BeadArrays, has slides with 6 or 8 positions
1756                and sequencing flow cells have 8 lanes.
1757              </para>
1758            </listitem>
1759          </varlistentry>
1760
1761          <varlistentry>
1762            <term>
1763              <guilabel>Created</guilabel>
1764            </term>
1765            <listitem>
1766              <para>
1767                A date should be provided. The information can be important when
1768                running quality controls on data and account for potential
1769                confounding factor (e.g. to account for a day effect).
1770              </para>
1771            </listitem>
1772          </varlistentry>
1773
1774          <varlistentry>
1775            <term>
1776              <guilabel>Registered</guilabel>
1777            </term>
1778            <listitem>
1779              <para>
1780                This field is automatically populated with a date at which the
1781                hybridization was entered in BASE system.
1782              </para>
1783            </listitem>
1784          </varlistentry>
1785
1786          <varlistentry>
1787            <term>
1788              <guilabel>Protocol</guilabel>
1789            </term>
1790            <listitem>
1791              <para>
1792                The protocol that was used to create the bioassay.
1793              </para>
1794            </listitem>
1795          </varlistentry>
1796
1797          <varlistentry>
1798            <term>
1799              <guilabel>Hardware</guilabel>
1800            </term>
1801            <listitem>
1802              <para>
1803                Information about the machine (if any) that was used when creating
1804                the bioassay.
1805              </para>
1806            </listitem>
1807          </varlistentry>
1808
1809          <varlistentry>
1810            <term>
1811              <guilabel>Array slide</guilabel>
1812            </term>
1813            <listitem>
1814              <para>The array slide that was used for the bioassay.</para>
1815            </listitem>
1816          </varlistentry>
1817
1818          <varlistentry>
1819            <term>
1820              <guilabel>Description</guilabel>
1821            </term>
1822            <listitem>
1823              <para>
1824                A free text field to report any information that can not be captured
1825                otherwise.
1826              </para>
1827            </listitem>
1828          </varlistentry>
1829        </variablelist>
1830        <seeother>
1831          <other external_id="physicalbioassay.extracts">Extracts</other>
1832          <other external_id="annotations.edit">Annotations &amp; parameters</other>
1833          <other external_id="annotations.edit.inherited">Inherited annotations</other>
1834        </seeother>
1835        </helptext>
1836      </sect2>
1837     
1838      <sect2 id="biomaterials.bioassays.extracts">
1839        <title>Parent extracts</title>
1840       
1841        <figure id="biomaterials.figures.bioassay-tab-2">
1842          <title>Parent extracts</title>
1843          <screenshot>
1844            <mediaobject>
1845              <imageobject>
1846                <imagedata 
1847                  fileref="figures/physicalbioassay-tab-2.png" format="PNG" />
1848              </imageobject>
1849            </mediaobject>
1850          </screenshot>
1851        </figure>
1852       
1853        <helptext external_id="physicalbioassay.extracts" title="Extracts">
1854        <para>
1855          This important tab allows users to select the extracts used by the
1856          bioassay, and specify the amount of material used, expressed in microgram.
1857        </para>
1858        <para>
1859          Use the <guibutton>Add extracts</guibutton> button to add
1860          items and the <guibutton>Remove</guibutton> button to remove items.
1861          Select one or several extracts in the list and write the used
1862          mass and position number in the fields below the list.
1863        </para>
1864       
1865        <seeother>
1866          <other external_id="physicalbioassay.edit">Edit physical bioassay</other>
1867          <other external_id="annotations.edit">Annotations &amp; parameters</other>
1868          <other external_id="annotations.edit.inherited">Inherited annotations</other>
1869        </seeother>
1870        </helptext>
1871       
1872      </sect2>
1873     
1874     
1875    <para>
1876      The <guilabel>Annotations</guilabel> tab allows BASE users to use
1877      annotation types to refine bioassay description. More about annotating items
1878      can be read in <xref linkend="annotations.annotating" />
1879    </para>
1880       
1881    <para>
1882      This <guilabel>Inherited annotations</guilabel> tab contains a list of those annotations
1883      that are inherited from the bioassay's parents. Information about working with inherited
1884      annotations can be found in <xref linkend="annotations.inheriting" />.
1885    </para>
1886     
1887  </sect1>
1888</chapter>
Note: See TracBrowser for help on using the repository browser.