123 |
12 Jul 06 |
jari |
$Id$ |
123 |
12 Jul 06 |
jari |
2 |
|
275 |
21 May 07 |
peter |
3 |
--------------------------------------------------------------------- |
275 |
21 May 07 |
peter |
4 |
{{{ |
123 |
12 Jul 06 |
jari |
Copyright (C) 2006 Jari Häkkinen |
285 |
22 May 07 |
jari |
Copyright (C) 2007 Jari Häkkinen, Peter Johansson |
123 |
12 Jul 06 |
jari |
7 |
|
275 |
21 May 07 |
peter |
This file is part of se.lu.thep.affymetrix package for BASE, |
275 |
21 May 07 |
peter |
http://baseplugins.thep.lu.se/wiki/se.thep.lu.se.affymetrix |
123 |
12 Jul 06 |
jari |
10 |
|
275 |
21 May 07 |
peter |
se.lu.thep.affymetrix package for BASE is free software; you can |
275 |
21 May 07 |
peter |
redistribute it and/or modify it under the terms of the GNU General |
275 |
21 May 07 |
peter |
Public License as published by the Free Software Foundation; either |
275 |
21 May 07 |
peter |
version 2 of the License, or (at your option) any later version. |
123 |
12 Jul 06 |
jari |
15 |
|
275 |
21 May 07 |
peter |
se.lu.thep.affymetrix package for BASE is distributed in the hope that |
275 |
21 May 07 |
peter |
it will be useful, but WITHOUT ANY WARRANTY; without even the implied |
275 |
21 May 07 |
peter |
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See |
275 |
21 May 07 |
peter |
the GNU General Public License for more details. |
123 |
12 Jul 06 |
jari |
20 |
|
123 |
12 Jul 06 |
jari |
You should have received a copy of the GNU General Public License |
123 |
12 Jul 06 |
jari |
along with this program; if not, write to the Free Software |
123 |
12 Jul 06 |
jari |
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, |
123 |
12 Jul 06 |
jari |
USA. |
275 |
21 May 07 |
peter |
25 |
}}} |
275 |
21 May 07 |
peter |
26 |
---------------------------------------------------------------------- |
123 |
12 Jul 06 |
jari |
27 |
|
285 |
22 May 07 |
jari |
== About se.lu.thep.affymetrix package == |
123 |
12 Jul 06 |
jari |
29 |
|
286 |
22 May 07 |
jari |
''A short diversion before we proceed, this paragraph is aimed at |
286 |
22 May 07 |
jari |
people starting with an empty BASE server. The default BASE |
286 |
22 May 07 |
jari |
installation comes set up to store the same reporter (probeset) |
286 |
22 May 07 |
jari |
information as BASE 1.2.x do. This set up is not optimal for |
286 |
22 May 07 |
jari |
Affymetrix data but can still be used. In order to understand how to |
286 |
22 May 07 |
jari |
define what reporter information is stored in BASE and how to change |
286 |
22 May 07 |
jari |
what is stored, you may want to visit |
345 |
27 Jun 07 |
jari |
http://base.thep.lu.se/chrome/site/doc/html/appendix/appendix.extendedproperties.html |
286 |
22 May 07 |
jari |
before you start using your shiny BASE installation.'' |
286 |
22 May 07 |
jari |
39 |
|
279 |
22 May 07 |
jari |
Send comments, suggestion, complaints, or questions regarding this |
285 |
22 May 07 |
jari |
package to the |
285 |
22 May 07 |
jari |
[http://base.thep.lu.se/wiki/MailingLists BASE mailing lists]. |
123 |
12 Jul 06 |
jari |
43 |
|
275 |
21 May 07 |
peter |
This file contains information on se.lu.thep.affymetrix package. This |
278 |
22 May 07 |
peter |
package contains the RMAExpress and Plier plug-ins. |
123 |
12 Jul 06 |
jari |
46 |
|
345 |
27 Jun 07 |
jari |
The plug-ins in this package are installed in the |
345 |
27 Jun 07 |
jari |
[http://base2.thep.lu.se:8080/demo BASE2 demo server]. You can try |
345 |
27 Jun 07 |
jari |
them there before deciding to install them in your local BASE server. |
123 |
12 Jul 06 |
jari |
50 |
|
275 |
21 May 07 |
peter |
For installation or updating instructions please see file INSTALL. |
156 |
10 Aug 06 |
jari |
52 |
|
156 |
10 Aug 06 |
jari |
53 |
|
285 |
22 May 07 |
jari |
== What is RMAExpress and Plier plug-ins for BASE? == |
123 |
12 Jul 06 |
jari |
55 |
|
276 |
21 May 07 |
peter |
RMAExpress and Plier are two similar plug-ins needed to make use of |
416 |
07 Sep 07 |
jari |
Affymetrix expression chip data in BASE. Affymetrix data can be |
416 |
07 Sep 07 |
jari |
imported into BASE as files, but if one wants to perform clustering |
416 |
07 Sep 07 |
jari |
and other analysis available in BASE, the data in these files have to |
416 |
07 Sep 07 |
jari |
be extracted and imported into BASE. NOTE, these plug-ins cannot |
416 |
07 Sep 07 |
jari |
handle snp chip data. |
123 |
12 Jul 06 |
jari |
62 |
|
285 |
22 May 07 |
jari |
These plug-ins do not implement the RMA method and Plier method, but |
285 |
22 May 07 |
jari |
rather rely on third-party binary packages for the algorithm |
285 |
22 May 07 |
jari |
implementations. |
123 |
12 Jul 06 |
jari |
66 |
|
276 |
21 May 07 |
peter |
The RMAExpress plug-in relies on RMAExpressConsole available in the |
276 |
21 May 07 |
peter |
RMAExpress package available at http://rmaexpress.bmbolstad.com/. The |
276 |
21 May 07 |
peter |
RMA algorithm is published in scientific journals, for more |
276 |
21 May 07 |
peter |
information please refer to the RMAExpress web site. In short RMA is |
276 |
21 May 07 |
peter |
the Robust Multichip Average. It consists of three steps: a background |
285 |
22 May 07 |
jari |
adjustment, quantile normalization, and finally a summarizing. |
124 |
18 Jul 06 |
jari |
73 |
|
276 |
21 May 07 |
peter |
The Plier plug-in relies on `apt-probeset-summarize` included in |
276 |
21 May 07 |
peter |
Affymetrix Power Tools (APT) available at |
276 |
21 May 07 |
peter |
http://www.affymetrix.com/support/developer/powertools/index.affx. |
293 |
23 May 07 |
peter |
`apt-probeset-summarize` provides several methods and options. For |
293 |
23 May 07 |
peter |
time being there is no way to to set these options through the BASE |
293 |
23 May 07 |
peter |
GUI. The option `plier-mm` is hard-coded into the plug-in, which |
294 |
23 May 07 |
peter |
should be a good choice in most situations. In short the option means |
293 |
23 May 07 |
peter |
mismatch probe is used as adjustment for perfect match, quantile |
293 |
23 May 07 |
peter |
normalization is done, and PLIER is used for summarizing probesets. |
293 |
23 May 07 |
peter |
For more information regarding the PLIER algorithm please refer to the |
293 |
23 May 07 |
peter |
Affymetrix home page. |
276 |
21 May 07 |
peter |
85 |
|
123 |
12 Jul 06 |
jari |
86 |
|
285 |
22 May 07 |
jari |
== What is required for use of these plug-ins for BASE? == |
123 |
12 Jul 06 |
jari |
88 |
|
285 |
22 May 07 |
jari |
This section is a short introduction to get going with the plug-ins |
285 |
22 May 07 |
jari |
and Affymetrix data in BASE. More documentation is available at |
345 |
27 Jun 07 |
jari |
http://base.thep.lu.se/ and you should read them to learn how to use |
345 |
27 Jun 07 |
jari |
BASE. |
123 |
12 Jul 06 |
jari |
93 |
|
285 |
22 May 07 |
jari |
1. You need to install the plug-in and make BASE aware of the new |
285 |
22 May 07 |
jari |
plug-in, see INSTALL for instruction for installation instructions. |
285 |
22 May 07 |
jari |
96 |
|
285 |
22 May 07 |
jari |
2. You need to import probe set information into BASE (reporter |
285 |
22 May 07 |
jari |
information in BASE language), i.e. import AffyChip_annot.csv into |
285 |
22 May 07 |
jari |
BASE. This is only needed to do once, and optionally later if |
285 |
22 May 07 |
jari |
reporter information should be updated. This step can only be |
285 |
22 May 07 |
jari |
performed by a user with reporter administrative (create) |
285 |
22 May 07 |
jari |
privileges, an ordinary BASE user does NOT have this privilege. |
285 |
22 May 07 |
jari |
103 |
|
345 |
27 Jun 07 |
jari |
There is more than one way to create plug-in configurations. Here |
345 |
27 Jun 07 |
jari |
we outline the most straightforward route. There is a chapter in |
345 |
27 Jun 07 |
jari |
the BASE manual devoted for plug-in installation, follow the link |
345 |
27 Jun 07 |
jari |
above to find the document. |
285 |
22 May 07 |
jari |
108 |
|
126 |
20 Jul 06 |
jari |
- First you need to create an plug-in configuration for the |
126 |
20 Jul 06 |
jari |
'Reporter importer' plug-in. Locate the 'Reporter importer' |
126 |
20 Jul 06 |
jari |
plug-in definition ('Administrate' -> 'Plugins' -> |
126 |
20 Jul 06 |
jari |
'Definitions'). Click on it and choose 'New configuration ...', |
126 |
20 Jul 06 |
jari |
name the configuration and choose 'Save and configure'. |
125 |
20 Jul 06 |
jari |
114 |
|
126 |
20 Jul 06 |
jari |
- A 'Parser settings' dialog will appear. Set fields according to |
126 |
20 Jul 06 |
jari |
this list: |
285 |
22 May 07 |
jari |
117 |
{{{ |
126 |
20 Jul 06 |
jari |
Data header : "Probe Set ID","GeneChip Array",.* |
126 |
20 Jul 06 |
jari |
Data splitter: (?!"),(?=") |
126 |
20 Jul 06 |
jari |
Remove quotes: true |
126 |
20 Jul 06 |
jari |
Name : \Probe Set ID\ |
126 |
20 Jul 06 |
jari |
Reporter ID : \Probe Set ID\ |
285 |
22 May 07 |
jari |
123 |
}}} |
285 |
22 May 07 |
jari |
Finalize by clicking 'Next'. Note, the above example will |
285 |
22 May 07 |
jari |
perform a minimalistic import of annotation information, please |
285 |
22 May 07 |
jari |
read the BASE documentation on how to import more probeset |
285 |
22 May 07 |
jari |
related information. However, don't worry about that now, you |
285 |
22 May 07 |
jari |
can always fix the annotation later. |
125 |
20 Jul 06 |
jari |
129 |
|
126 |
20 Jul 06 |
jari |
- Import the reporters by choosing 'View' -> 'Reporters' and the |
126 |
20 Jul 06 |
jari |
clicking on 'Import...'. Click 'Next' without changing the 'auto |
156 |
10 Aug 06 |
jari |
detect' settings. Supply the file name in the next dialog, click |
126 |
20 Jul 06 |
jari |
'Next'. Set the 'Update existing reporters' to "true" if an |
126 |
20 Jul 06 |
jari |
update of already stored reporter information is wanted. Start |
286 |
22 May 07 |
jari |
the import by clicking 'Next' in the parameter dialog. |
125 |
20 Jul 06 |
jari |
136 |
|
345 |
27 Jun 07 |
jari |
The reporter information is now in the database. You may delete |
345 |
27 Jun 07 |
jari |
the AffyChip_annot.csv file from BASE if you wish, it is not |
345 |
27 Jun 07 |
jari |
needed anymore. You may want to update reporter information when |
345 |
27 Jun 07 |
jari |
Affymetrix releases a new version of their annotation but remember |
345 |
27 Jun 07 |
jari |
there is no versioning for this type of information in BASE. If |
345 |
27 Jun 07 |
jari |
you update reporter information you only need to redo the last |
345 |
27 Jun 07 |
jari |
step. |
126 |
20 Jul 06 |
jari |
144 |
|
286 |
22 May 07 |
jari |
3. You need to define the design of the !AffyChip in BASE, |
286 |
22 May 07 |
jari |
i.e. import the !AffyChip.cdf file. This is only needed to do once |
286 |
22 May 07 |
jari |
for every !AffyChip design to be added into BASE. This step can |
286 |
22 May 07 |
jari |
only be performed by a user with array LIMS administrative |
286 |
22 May 07 |
jari |
(create) privileges, an ordinary BASE user does NOT have this |
286 |
22 May 07 |
jari |
privilege. |
123 |
12 Jul 06 |
jari |
151 |
|
126 |
20 Jul 06 |
jari |
- Define a new array design through 'Array LIMS' -> 'Array |
126 |
20 Jul 06 |
jari |
Designs'. Click on 'New ...'. In the 'Create array design' |
285 |
22 May 07 |
jari |
dialog, set the 'Name' (use the file name of the CDF file for |
188 |
26 Oct 06 |
jari |
convenience), tick the Affy chip tick box, choose a CDF file, |
188 |
26 Oct 06 |
jari |
and optionally write a description. Click on next, and the new |
188 |
26 Oct 06 |
jari |
design is created. |
126 |
20 Jul 06 |
jari |
158 |
|
126 |
20 Jul 06 |
jari |
- Remember to share the design to all users/roles/groups that |
126 |
20 Jul 06 |
jari |
should have access to it (sharing it to group Everyone should be |
127 |
22 Jul 06 |
jari |
sufficient in most cases). |
126 |
20 Jul 06 |
jari |
162 |
|
285 |
22 May 07 |
jari |
4. Create an experiment, i.e., grouping .cel files into an |
285 |
22 May 07 |
jari |
experiment. |
123 |
12 Jul 06 |
jari |
165 |
|
127 |
22 Jul 06 |
jari |
- Upload the .cel files into BASE. |
124 |
18 Jul 06 |
jari |
167 |
|
127 |
22 Jul 06 |
jari |
- Create raw bio assay for these files, one per file: Choose |
127 |
22 Jul 06 |
jari |
'View' -> 'Raw bioassays', click on 'New ...'. In the dialog set |
127 |
22 Jul 06 |
jari |
the 'Name', choose the proper 'Raw data type' (i.e., |
127 |
22 Jul 06 |
jari |
"Affymetrix"), choose the 'Array design' that matches the .cel |
127 |
22 Jul 06 |
jari |
file, and choose the 'CEL file'. (The other fields are not |
127 |
22 Jul 06 |
jari |
needed but may be handy to fill in.) Click on 'Save'. |
127 |
22 Jul 06 |
jari |
174 |
|
127 |
22 Jul 06 |
jari |
- Create the experiment: Choose 'View' -> 'Experiment', click on |
127 |
22 Jul 06 |
jari |
'New ...'. In the dialog set the 'Name', choose the proper 'Raw |
127 |
22 Jul 06 |
jari |
data type' (i.e., "Affymetrix"), and add 'Raw bioassays'. |
127 |
22 Jul 06 |
jari |
178 |
|
285 |
22 May 07 |
jari |
5. Select the experiment and create a new root bioassay set for it. |
127 |
22 Jul 06 |
jari |
180 |
|
127 |
22 Jul 06 |
jari |
- Locate the newly created experiment and click on 'Analyze'. |
127 |
22 Jul 06 |
jari |
182 |
|
285 |
22 May 07 |
jari |
- Click on 'New root bioassay set ...', select the algorithm you |
285 |
22 May 07 |
jari |
want to use in the import, and click 'Next' in the pop-up |
285 |
22 May 07 |
jari |
dialog. Select the 'Raw bioassays' to include in the new root |
285 |
22 May 07 |
jari |
bioassay set and type a name for the bioassay set. Click on |
127 |
22 Jul 06 |
jari |
'Next' to start the plug-in. |
127 |
22 Jul 06 |
jari |
188 |
|
285 |
22 May 07 |
jari |
6. When the plug-in is finished the resulting expression values will |
285 |
22 May 07 |
jari |
be accessible in BASE. |
574 |
07 Feb 08 |
jari |
[[br]][[br]] |
574 |
07 Feb 08 |
jari |
In some cases the reporter annotation file from Affymetrix fails |
574 |
07 Feb 08 |
jari |
to describe all probe sets on the chip, you may get a message like |
574 |
07 Feb 08 |
jari |
''Error: Unable to import root bioassay. Item not found: |
574 |
07 Feb 08 |
jari |
Reporter[externalId=AFFX-2315060]''. In this case you have to fall |
574 |
07 Feb 08 |
jari |
back to importing the probe set information using the CDF |
574 |
07 Feb 08 |
jari |
file, simply do |
574 |
07 Feb 08 |
jari |
[[br]][[br]] |
574 |
07 Feb 08 |
jari |
Import the reporters by choosing 'View' -> 'Reporters' and the |
574 |
07 Feb 08 |
jari |
clicking on 'Import...'. Click 'Next' without changing the 'auto |
574 |
07 Feb 08 |
jari |
detect' settings. Supply the CDF file name in the next dialog, |
574 |
07 Feb 08 |
jari |
click 'Next'. Start the import by clicking 'Next' in the parameter |
574 |
07 Feb 08 |
jari |
dialog. This will add the missing probe sets without changing |
574 |
07 Feb 08 |
jari |
existing probe sets. The new probe sets will not have any |
574 |
07 Feb 08 |
jari |
annotations associated with them since the CDFs do not contain |
574 |
07 Feb 08 |
jari |
such information. |
285 |
22 May 07 |
jari |
207 |
|
285 |
22 May 07 |
jari |
7. You made it here. This means that the plug-in works and you are |
345 |
27 Jun 07 |
jari |
ready to start using Affymetrix data in BASE. The get the most out |
345 |
27 Jun 07 |
jari |
of BASE you should now read the BASE manual and documentation |
345 |
27 Jun 07 |
jari |
available at http://base.thep.lu.se/ |