1090 |
27 May 09 |
nicklas |
== Requirements == |
1090 |
27 May 09 |
nicklas |
2 |
|
1117 |
10 Jun 09 |
nicklas |
1. BASE 2.13 or later. |
1138 |
24 Jun 09 |
nicklas |
2. Ant 1.7 or later (for installation only). |
1138 |
24 Jun 09 |
nicklas |
3. Access to a GenePattern server (3.2 or higher recommended). |
1090 |
27 May 09 |
nicklas |
6 |
|
1090 |
27 May 09 |
nicklas |
== Introduction == |
1090 |
27 May 09 |
nicklas |
8 |
|
1138 |
24 Jun 09 |
nicklas |
This package is an extensions/plug-in package to BASE that integrates BASE |
1138 |
24 Jun 09 |
nicklas |
with GenePattern. Some of the features: |
1090 |
27 May 09 |
nicklas |
11 |
|
1138 |
24 Jun 09 |
nicklas |
* Export experimental data in various GenePattern file formats. |
1138 |
24 Jun 09 |
nicklas |
* Run jobs on a GenePattern server using files from BASE. Module |
1138 |
24 Jun 09 |
nicklas |
parameters are entered in the BASE web interface. |
1138 |
24 Jun 09 |
nicklas |
* Start GenePattern visualizer modules with files from BASE. |
1138 |
24 Jun 09 |
nicklas |
16 |
|
1138 |
24 Jun 09 |
nicklas |
This extension doesn't include any GenePattern software. It uses |
1138 |
24 Jun 09 |
nicklas |
web services to communicate with GenePattern servers. BASE users |
1138 |
24 Jun 09 |
nicklas |
that want to use GenePattern must have an account on a separate |
1138 |
24 Jun 09 |
nicklas |
GenePattern server. |
1138 |
24 Jun 09 |
nicklas |
21 |
|
1090 |
27 May 09 |
nicklas |
For more information: |
1090 |
27 May 09 |
nicklas |
23 |
|
1090 |
27 May 09 |
nicklas |
* The homepage for this extension: |
1090 |
27 May 09 |
nicklas |
http://baseplugins.thep.lu.se/wiki/net.sf.basedb.genepattern |
1138 |
24 Jun 09 |
nicklas |
* The GenePattern homepage: |
1138 |
24 Jun 09 |
nicklas |
http://www.broad.mit.edu/cancer/software/genepattern/index.html |
1090 |
27 May 09 |
nicklas |
28 |
|
1090 |
27 May 09 |
nicklas |
== Installation == |
1090 |
27 May 09 |
nicklas |
30 |
|
1090 |
27 May 09 |
nicklas |
1. Download the gp-integration-*.tar.gz file. |
1090 |
27 May 09 |
nicklas |
2. Unpack the downloaded file to a directory of your choice. |
1138 |
24 Jun 09 |
nicklas |
3. Download GenePattern files from a GenePattern server. |
1138 |
24 Jun 09 |
nicklas |
Type `ant -f download.xml`. This will dowload the files from the public |
1138 |
24 Jun 09 |
nicklas |
GenePattern server at http://genepattern.broad.mit.edu/gp. You may |
1138 |
24 Jun 09 |
nicklas |
download from an alternate location by setting the `genepattern.url` |
1138 |
24 Jun 09 |
nicklas |
property: `ant -f download.xml -Dgenepattern.url=http://your.genepattern.server/gp` |
1138 |
24 Jun 09 |
nicklas |
This will download the following files. |
1138 |
24 Jun 09 |
nicklas |
* runVisualizer.jar: This file is added to gp-integration.jar/resources/visualizer |
1138 |
24 Jun 09 |
nicklas |
* GenePattern.zip: The `GenePattern.jar` and `lib/gp-modules.jar` are extracted |
1138 |
24 Jun 09 |
nicklas |
to the `lib/genepattern` directory. |
1138 |
24 Jun 09 |
nicklas |
4. Copy the `gp-integration.jar` file and the `lib` directory, including sub- |
1104 |
29 May 09 |
nicklas |
directories and files, to your BASE extensions directory, `WEB-INF/extensions`. |
1138 |
24 Jun 09 |
nicklas |
5. Run the 'Extensions -> Manual scan' command if you have disabled automatic |
1090 |
27 May 09 |
nicklas |
installation. Otherwise, just wait a bit and the automatic installation will |
1090 |
27 May 09 |
nicklas |
find and install the new extension. |
1138 |
24 Jun 09 |
nicklas |
6. Run the plug-in installation wizard by clicking the 'New' button on the |
1090 |
27 May 09 |
nicklas |
'Administrate -> Plugins -> Definitions' page. Make sure the option for |
1090 |
27 May 09 |
nicklas |
the 'Extensions directory' is selected. Install all plug-ins found in |
1090 |
27 May 09 |
nicklas |
the gp-integration.jar file. |
1090 |
27 May 09 |
nicklas |
7. Done. |
1090 |
27 May 09 |
nicklas |
52 |
|
1138 |
24 Jun 09 |
nicklas |
== Using == |
1104 |
29 May 09 |
nicklas |
54 |
|
1138 |
24 Jun 09 |
nicklas |
'''Register GenePattern account with BASE'''[[br]] |
1138 |
24 Jun 09 |
nicklas |
BASE users that want's to use this extensions must have access to at |
1138 |
24 Jun 09 |
nicklas |
least one GenePattern server. The first step is to register the account |
1138 |
24 Jun 09 |
nicklas |
information with BASE. Go to `Extensions -> GenePattern options`. Add |
1138 |
24 Jun 09 |
nicklas |
information for one or more GenePattern servers. For each server the |
1138 |
24 Jun 09 |
nicklas |
following information should be provided: |
1138 |
24 Jun 09 |
nicklas |
61 |
|
1138 |
24 Jun 09 |
nicklas |
* Server url: Only include the root url (not the /gp) |
1138 |
24 Jun 09 |
nicklas |
* Login: Your login information (email) |
1138 |
24 Jun 09 |
nicklas |
* Password: If the server requires a password |
1138 |
24 Jun 09 |
nicklas |
* BASE server URL: The URL to BASE as seen from the GenePattern server. |
1138 |
24 Jun 09 |
nicklas |
The default value is usually correct, but may need to be changed due |
1138 |
24 Jun 09 |
nicklas |
to, for example, proxies. |
1138 |
24 Jun 09 |
nicklas |
68 |
|
1138 |
24 Jun 09 |
nicklas |
Use the `Test` button to verify the login information. If there is problem with |
1138 |
24 Jun 09 |
nicklas |
transfering files to the GenePattern server an incorrect value for the BASE server |
1138 |
24 Jun 09 |
nicklas |
URL is most likely the cause. |
1138 |
24 Jun 09 |
nicklas |
72 |
|
1138 |
24 Jun 09 |
nicklas |
'''Configuring the GenePattern analysis plug-in'''[[br]] |
1138 |
24 Jun 09 |
nicklas |
Before it is possible to run jobs on a GenePattern server the `GenePattern analysis` |
1138 |
24 Jun 09 |
nicklas |
plug-in must be configured. Each GenePattern module requires a separate configuration. |
1138 |
24 Jun 09 |
nicklas |
Go to the `Administrate -> Plugins -> Definitions` page and find the |
1138 |
24 Jun 09 |
nicklas |
`GenePattern analysis` plug-in. Create a new configuration and start the |
1138 |
24 Jun 09 |
nicklas |
configuration sequence. |
1138 |
24 Jun 09 |
nicklas |
79 |
|
1138 |
24 Jun 09 |
nicklas |
1. In the first step you select a GenePattern server and a module. Use the |
1138 |
24 Jun 09 |
nicklas |
`Get list` button to retrieve a list of installed modules on the selected |
1138 |
24 Jun 09 |
nicklas |
GenePattern server. Note! The selected GenePattern server is used only |
1138 |
24 Jun 09 |
nicklas |
during configuration. Users may select a different server (as long as |
1138 |
24 Jun 09 |
nicklas |
the module is installed there) for executing jobs. |
1138 |
24 Jun 09 |
nicklas |
2. In the second step you can set default values for all non-file parameters |
1138 |
24 Jun 09 |
nicklas |
and link file parameters with BASE file types. The linking to file types |
1138 |
24 Jun 09 |
nicklas |
makes it possible for BASE to suggest a default file that is already |
1138 |
24 Jun 09 |
nicklas |
associated with the bioassay set. |
1138 |
24 Jun 09 |
nicklas |
89 |
|
1138 |
24 Jun 09 |
nicklas |
'''Using the GenePattern analysis plug-in'''[[br]] |
1138 |
24 Jun 09 |
nicklas |
To run a job on a GenePattern server the `GenePattern analysis` plug-in is |
1138 |
24 Jun 09 |
nicklas |
used from the bioassay set view. |
1138 |
24 Jun 09 |
nicklas |
93 |
|
1138 |
24 Jun 09 |
nicklas |
1. In the first step some information about the new child bioassay set can |
1138 |
24 Jun 09 |
nicklas |
be entered. The user must also select a GenePattern server and specify |
1138 |
24 Jun 09 |
nicklas |
a directory in the BASE file system were the result files should be |
1138 |
24 Jun 09 |
nicklas |
saved. |
1138 |
24 Jun 09 |
nicklas |
2. In the second step input files and other parameter values are entered. |
1138 |
24 Jun 09 |
nicklas |
99 |
|
1138 |
24 Jun 09 |
nicklas |
To run a visualizer module, use the `GenePattern visualizer` button |
1138 |
24 Jun 09 |
nicklas |
from the bioassay set view. |
1138 |
24 Jun 09 |
nicklas |
102 |
|
1138 |
24 Jun 09 |
nicklas |
1. In the first step you select a GenePattern server and a module. Use the |
1138 |
24 Jun 09 |
nicklas |
`Get list` button to retreive a list of installed modules on the selected |
1138 |
24 Jun 09 |
nicklas |
GenePattern server. |
1138 |
24 Jun 09 |
nicklas |
2. In the second step input files and other parameter values are entered. |
1138 |
24 Jun 09 |
nicklas |
3. After this, the visualizer applet is started. This applet is just a wrapper |
1138 |
24 Jun 09 |
nicklas |
that downloads the required module and the data files to the local computer |
1138 |
24 Jun 09 |
nicklas |
and starts a Java program. Please be patient as this may take some while. |
1138 |
24 Jun 09 |
nicklas |
110 |
|
1090 |
27 May 09 |
nicklas |
== Known issues == |
1090 |
27 May 09 |
nicklas |
112 |
|
1090 |
27 May 09 |
nicklas |
None. |
1090 |
27 May 09 |
nicklas |
114 |
|
1090 |
27 May 09 |
nicklas |
== Compiling == |
1090 |
27 May 09 |
nicklas |
116 |
|
1090 |
27 May 09 |
nicklas |
To compile this package you also need: |
1090 |
27 May 09 |
nicklas |
118 |
|
1138 |
24 Jun 09 |
nicklas |
1. Ant 1.7 |
1090 |
27 May 09 |
nicklas |
2. Java 1.6 |
1090 |
27 May 09 |
nicklas |
121 |
|
1090 |
27 May 09 |
nicklas |
Follow these instructions: |
1090 |
27 May 09 |
nicklas |
123 |
|
1090 |
27 May 09 |
nicklas |
1. Download the source code from the subversion repository. See |
1090 |
27 May 09 |
nicklas |
http://baseplugins.thep.lu.se/wiki/net.sf.basedb.genepattern |
1090 |
27 May 09 |
nicklas |
for instructions. |
1090 |
27 May 09 |
nicklas |
127 |
|
1138 |
24 Jun 09 |
nicklas |
2. Type `ant download-lib` to automatically download the BASE and GenePattern |
1138 |
24 Jun 09 |
nicklas |
files that are needed for compilation. |
1090 |
27 May 09 |
nicklas |
130 |
|
1090 |
27 May 09 |
nicklas |
3. Type 'ant' to compile the code and generate the 'gp-integration.jar' file |
1090 |
27 May 09 |
nicklas |
in the project directory. |
1090 |
27 May 09 |
nicklas |
133 |
|
1138 |
24 Jun 09 |
nicklas |
4. Use 'ant package' to create a downloadable tar.gz package. Note that this |
1138 |
24 Jun 09 |
nicklas |
package doesn't include any of the GenePattern files. |
1090 |
27 May 09 |
nicklas |
136 |
|
1090 |
27 May 09 |
nicklas |
Tip: If you need different values for any of the properties defined in |
1090 |
27 May 09 |
nicklas |
the 'build.xml' file, create a file named 'build.properties' and set |
1090 |
27 May 09 |
nicklas |
the values there. |