1188 |
11 Feb 10 |
jari |
$Id$ |
1188 |
11 Feb 10 |
jari |
2 |
|
360 |
28 Jul 07 |
dominic |
Release Note: Tab2Mage Export Current Implementation |
399 |
15 Aug 07 |
dominic |
4 |
============================================== |
399 |
15 Aug 07 |
dominic |
Installation |
399 |
15 Aug 07 |
dominic |
6 |
----------------- |
366 |
02 Aug 07 |
dominic |
7 |
|
501 |
28 Nov 07 |
dominic |
- Place Tab2MageExporter.jar and ebi-plugins-utils.jar into the $BASE2_HOME/www/plugins/ directory on your BASE2 server. |
399 |
15 Aug 07 |
dominic |
- Install as new plugins uk.ac.ebi.nugo.plugins.Tab2MageExporter contained in $BASE_HOME/www/plugins/Tab2MageExporter.jar. |
399 |
15 Aug 07 |
dominic |
10 |
|
490 |
28 Nov 07 |
dominic |
Note: If you get a class Loader error while installing the exporter, you have two options: |
490 |
28 Nov 07 |
dominic |
12 |
|
1188 |
11 Feb 10 |
jari |
i) Upgrade to BASE 2.14.1 or |
490 |
28 Nov 07 |
dominic |
ii) Place the two jar files: Tab2MageExporter.jar and ebi-plugins-utils.jar in your base installation classpath - i.e. : $BASE2_HOME/web-inf/lib, restart the tomcat server and proceed to install the plugin. In step (3) below, do not specify the plugin's path. Note that BASE do not recommend this approach but it's just a work around for a bug in base versions earlier than 2.4.6. |
490 |
28 Nov 07 |
dominic |
15 |
|
399 |
15 Aug 07 |
dominic |
1. In the BASE web client, go to Administrate -> Plugins -> Definitions. |
399 |
15 Aug 07 |
dominic |
2. Click New. |
399 |
15 Aug 07 |
dominic |
3. In the dialog that opens, |
399 |
15 Aug 07 |
dominic |
for class enter " uk.ac.ebi.nugo.plugins.Tab2MageExporter". |
399 |
15 Aug 07 |
dominic |
for path enter the path to the plugin jar file, i.e. <BASE_HOME>/www/plugins/ Tab2MageExporter.jar |
399 |
15 Aug 07 |
dominic |
4. Click Save. |
399 |
15 Aug 07 |
dominic |
The new plugins appears under the name "Tab2Mage Exporter" in the plugins list and is now ready for use. |
399 |
15 Aug 07 |
dominic |
23 |
|
410 |
30 Aug 07 |
dominic |
For other users to use the plugin as detailed in the next section, please share it to the appropriate users by manually setting the permissions on the plugin (sharing it to group 'Everyone' should be sufficient in most cases). |
399 |
15 Aug 07 |
dominic |
25 |
|
399 |
15 Aug 07 |
dominic |
General Installation instruction is available at: http://base.thep.lu.se/chrome/site/doc/html/admindoc/plugin_installation/plugins.installation.html#plugins.installation |
399 |
15 Aug 07 |
dominic |
27 |
========================================================================================== |
399 |
15 Aug 07 |
dominic |
Use |
399 |
15 Aug 07 |
dominic |
29 |
------- |
399 |
15 Aug 07 |
dominic |
Important Notice/ Warning: |
399 |
15 Aug 07 |
dominic |
31 |
----------------------------------- |
399 |
15 Aug 07 |
dominic |
To use the tab2mage export plugin, you do not need to configure the plugin as it requires no configuration. |
366 |
02 Aug 07 |
dominic |
33 |
|
447 |
30 Oct 07 |
dominic |
The exported tab2mage file would be located on the base2 file system (in the location you have specified). This file can thereafter be downloaded to your desktop environment. After the download, please create an archive including the tab2mage export file and the associated raw data files, for onward submission to a the Array Express repository. |
366 |
02 Aug 07 |
dominic |
35 |
|
447 |
30 Oct 07 |
dominic |
It is advisable to verify that your experiment has all the required annotations and that it is Miame Complaint before running the exporter. To do this go to the Experiment detail view page and click on the overview tab. |
366 |
02 Aug 07 |
dominic |
37 |
|
399 |
15 Aug 07 |
dominic |
The Tab2Mage export fails with a message, if: |
399 |
15 Aug 07 |
dominic |
- No bioassay is assigned to an experiment |
399 |
15 Aug 07 |
dominic |
- If the logged in user do not own the experiment or has no read permission on the experiment. |
399 |
15 Aug 07 |
dominic |
- If experimental factors have not been specified for an experiment. |
447 |
30 Oct 07 |
dominic |
- Also, note that if experimental factors (annotation type) for an experiment have been specified, and the annotation types are shared to Project. Do set the Project active before exporting in Tab2mage otherwise export fails. |
1188 |
11 Feb 10 |
jari |
- Finally, if an array slide or array design has not been provided for Hybridization. |
399 |
15 Aug 07 |
dominic |
44 |
|
399 |
15 Aug 07 |
dominic |
Besides, using the experiment overview functionality would help to prevent most of these failure points. |
399 |
15 Aug 07 |
dominic |
46 |
|
399 |
15 Aug 07 |
dominic |
1. In the BASE web client, go to View -> Experiment |
399 |
15 Aug 07 |
dominic |
2. Go to the experiment detail view page. |
399 |
15 Aug 07 |
dominic |
3. Verify your experiment with the BASE experiment overview functionality as mentioned above |
399 |
15 Aug 07 |
dominic |
4. Click on the export tab and on the export GUI thats appears, the experiment has been configured as indicated by the black x. |
399 |
15 Aug 07 |
dominic |
5. The overwrite field has also been configured and set to false by default. Do change this to true if you want to overwrite an exisiting file. |
399 |
15 Aug 07 |
dominic |
6. Set the file path where the export file and it's name: (e.g. tab2mage.txt) should be saved on the base2 file system using the browse button for the Save As field. This is a mandatory field. |
399 |
15 Aug 07 |
dominic |
7. Specify the date you would like the experiment to be made public or released by a public respository e.g. Array Express. and click Next |
399 |
15 Aug 07 |
dominic |
8. On the next screen click Finish and wait for the job to complete. You will be shown the progress of the Tab2mage export in the dialog, with the page refreshing itself regularly. |
399 |
15 Aug 07 |
dominic |
55 |
|
447 |
30 Oct 07 |
dominic |
56 |
================================================================================== |
447 |
30 Oct 07 |
dominic |
57 |
|
447 |
30 Oct 07 |
dominic |
What is not supported |
447 |
30 Oct 07 |
dominic |
59 |
---------------------------------- |
447 |
30 Oct 07 |
dominic |
- Inherited annotations are not exported or supported for Protocol parameters in this current version. |
399 |
15 Aug 07 |
dominic |
61 |
|
447 |
30 Oct 07 |
dominic |
- Material Characteristics - not available in the current base2 release and therefore cannot be exported. This requires MGED entries. Ontologies and control vocabularies would be distributed with base2 in the nearest future and can then be supported. |
447 |
30 Oct 07 |
dominic |
63 |
|
447 |
30 Oct 07 |
dominic |
- Experiment Quality control - is not supported in base2, hence this will be missing in the tab2mage export at the experiment section |
447 |
30 Oct 07 |
dominic |
65 |
|
447 |
30 Oct 07 |
dominic |
- Experiment publication’s pages, issues and volume are not supported. |
447 |
30 Oct 07 |
dominic |
67 |
|
447 |
30 Oct 07 |
dominic |
68 |
|
399 |
15 Aug 07 |
dominic |
69 |
==================================================================================================== |
366 |
02 Aug 07 |
dominic |
Tab2Mage Sections |
399 |
15 Aug 07 |
dominic |
71 |
---------------------------- |
360 |
28 Jul 07 |
dominic |
Experiment Section |
360 |
28 Jul 07 |
dominic |
73 |
----------------------------- |
399 |
15 Aug 07 |
dominic |
- Provides information about an experiment. |
360 |
28 Jul 07 |
dominic |
- The user must specify the release date for the experiment when initiating the tab2mage export. |
360 |
28 Jul 07 |
dominic |
76 |
|
360 |
28 Jul 07 |
dominic |
Protocol Section |
360 |
28 Jul 07 |
dominic |
78 |
------------------------ |
360 |
28 Jul 07 |
dominic |
- This section displays all the protocols used within an experiment. The associated parameters are also displayed if any |
399 |
15 Aug 07 |
dominic |
- Protocol parameters are delimited with a semi colon. |
360 |
28 Jul 07 |
dominic |
81 |
|
360 |
28 Jul 07 |
dominic |
Hybridization Section |
360 |
28 Jul 07 |
dominic |
83 |
------------------------------- |
360 |
28 Jul 07 |
dominic |
Hybridization - Protocol Section |
360 |
28 Jul 07 |
dominic |
85 |
--------------------------------------------- |
399 |
15 Aug 07 |
dominic |
- If protocol has not been utilized in the experiment then |
399 |
15 Aug 07 |
dominic |
- no protocol id is displayed in the hybridization section. |
360 |
28 Jul 07 |
dominic |
88 |
|
360 |
28 Jul 07 |
dominic |
Hybridization - BiomaterialXteristics |
360 |
28 Jul 07 |
dominic |
90 |
------------------------------------------------- |
360 |
28 Jul 07 |
dominic |
- These are all the xteristics and annotations of a biosource, excluding annotations of deleted annotation types or characteristics. |
360 |
28 Jul 07 |
dominic |
- if a biosource exist i.e. has been used in an experiment , there might be biomaterial xteristics. |
360 |
28 Jul 07 |
dominic |
- if no biosource is used, then there would be no biomaterial xteristics in the export. |
360 |
28 Jul 07 |
dominic |
94 |
|
360 |
28 Jul 07 |
dominic |
Hybridization - Experimental Factors |
360 |
28 Jul 07 |
dominic |
96 |
-------------------------------------------------- |
360 |
28 Jul 07 |
dominic |
- if experimental factors have been declared for an experiment but has a null value (i.e. it’s value has not been specified). |
360 |
28 Jul 07 |
dominic |
- the default value for the experimental factor would be displayed, if it has been specified during the creation of the linked annotation type. |
400 |
15 Aug 07 |
dominic |
99 |
|
360 |
28 Jul 07 |
dominic |
100 |
|
360 |
28 Jul 07 |
dominic |
101 |
|
360 |
28 Jul 07 |
dominic |
102 |
/** |
399 |
15 Aug 07 |
dominic |
*This is a release note created for the tab2mage export developed at the EBI for Base2 and NutriBase. |
360 |
28 Jul 07 |
dominic |
104 |
/* |