766 |
16 Sep 08 |
jari |
$Id$ |
766 |
16 Sep 08 |
jari |
2 |
|
895 |
08 Dec 08 |
jari |
= About `se.lu.onk.VirtualArray` = |
766 |
16 Sep 08 |
jari |
4 |
|
996 |
26 Mar 09 |
jari |
The `se.lu.onk.VirtualArray` plug-in is a program that creates a |
996 |
26 Mar 09 |
jari |
virtual array design for bioassays. A consequence is that the position |
996 |
26 Mar 09 |
jari |
number of each spot is changed to a negative value. The new positions |
996 |
26 Mar 09 |
jari |
are a descending integer sequence starting from -1. |
766 |
16 Sep 08 |
jari |
9 |
|
2126 |
08 Nov 13 |
jari |
`se.lu.onk.VirtualArray` is open source software. See the file |
2126 |
08 Nov 13 |
jari |
license.txt for copying conditions. |
766 |
16 Sep 08 |
jari |
12 |
|
2126 |
08 Nov 13 |
jari |
The package was created by Johan Enell. |
766 |
16 Sep 08 |
jari |
14 |
|
766 |
16 Sep 08 |
jari |
15 |
|
766 |
16 Sep 08 |
jari |
== Downloading == |
766 |
16 Sep 08 |
jari |
17 |
|
895 |
08 Dec 08 |
jari |
`se.lu.onk.VirtualArray` can be obtained from |
766 |
16 Sep 08 |
jari |
19 |
|
766 |
16 Sep 08 |
jari |
http://baseplugins.thep.lu.se/wiki/PluginDownload |
766 |
16 Sep 08 |
jari |
21 |
|
766 |
16 Sep 08 |
jari |
22 |
|
772 |
18 Sep 08 |
jari |
== Installation and upgrade == |
766 |
16 Sep 08 |
jari |
24 |
|
2126 |
08 Nov 13 |
jari |
''This plug-in is only tested in BASE through the |
2126 |
08 Nov 13 |
jari |
Base1PluginExecuter and may work also in BASE |
766 |
16 Sep 08 |
jari |
1.2.17. Please report failure or success in BASE 1.2 through |
766 |
16 Sep 08 |
jari |
http://baseplugins.thep.lu.se. These installation instructions only |
766 |
16 Sep 08 |
jari |
describe how to get the plug-in to work with the Base1PluginExecuter |
2126 |
08 Nov 13 |
jari |
in the latest BASE version 3.2.x version.'' |
766 |
16 Sep 08 |
jari |
31 |
|
766 |
16 Sep 08 |
jari |
If you downloaded a binary package you only need to follow these |
766 |
16 Sep 08 |
jari |
instructions. If you prefer to compile the package yourself, read the |
766 |
16 Sep 08 |
jari |
instructions about compiling and creating a distribution before doing |
766 |
16 Sep 08 |
jari |
the installation steps described here. |
766 |
16 Sep 08 |
jari |
36 |
|
766 |
16 Sep 08 |
jari |
You need to understand how to install plug-ins in BASE, please refer |
766 |
16 Sep 08 |
jari |
to BASE documentation at http://base.thep.lu.se for general |
766 |
16 Sep 08 |
jari |
instructions on plug-in installation. The BASE documentation contains |
772 |
18 Sep 08 |
jari |
a chapter on plug-ins. If you have read the plug-in information you |
772 |
18 Sep 08 |
jari |
should be able to follow this path |
766 |
16 Sep 08 |
jari |
42 |
{{{ |
766 |
16 Sep 08 |
jari |
# cd /path/to/base/plugins |
895 |
08 Dec 08 |
jari |
# download VirtualArray-version.tgz |
895 |
08 Dec 08 |
jari |
# untar VirtualArray-version.tgz |
895 |
08 Dec 08 |
jari |
# ln -s VirtualArray-version VirtualArray |
766 |
16 Sep 08 |
jari |
47 |
}}} |
776 |
18 Sep 08 |
jari |
The symbolic link in the last line above allows for easier change to |
766 |
16 Sep 08 |
jari |
future version of the plug-in. |
766 |
16 Sep 08 |
jari |
50 |
{{{ |
766 |
16 Sep 08 |
jari |
# Log in to your BASE as admin |
895 |
08 Dec 08 |
jari |
# Upload the configuration file lib/pluginVirtualArray.base` |
776 |
18 Sep 08 |
jari |
# Create/update a configuration for the plug-in where you select the |
895 |
08 Dec 08 |
jari |
plug-in definition file `pluginVirtualArray.base`. BASE |
879 |
05 Dec 08 |
jari |
will respond that plug-ins where configured but ... |
776 |
18 Sep 08 |
jari |
# Re-configure the plug-in without selecting a file, set the `Plugin |
776 |
18 Sep 08 |
jari |
executables path` and proceed to next window by clicking |
772 |
18 Sep 08 |
jari |
`Next`. This is explained in the BASE documentation and needs to |
772 |
18 Sep 08 |
jari |
be done even when you update your plug-in. |
766 |
16 Sep 08 |
jari |
# In this parameter window set the `Name of executable`. The value |
766 |
16 Sep 08 |
jari |
of this parameter and `Plugin executables path` should add up to |
776 |
18 Sep 08 |
jari |
the absolute path to the binary `run`, i.e., |
895 |
08 Dec 08 |
jari |
/path/to/base/plugins/VirtualArray/run. How this string looks |
766 |
16 Sep 08 |
jari |
like depends on your plug-in directory structure. |
2126 |
08 Nov 13 |
jari |
# Create a formula (not needed when you upgrade): |
2126 |
08 Nov 13 |
jari |
- Go to View -> Formulas page and click on the New button. |
2126 |
08 Nov 13 |
jari |
- In the popup window enter the following information: |
2126 |
08 Nov 13 |
jari |
Name: reporter |
2126 |
08 Nov 13 |
jari |
Expressions: rep('id') |
2126 |
08 Nov 13 |
jari |
Value type: Integer |
2126 |
08 Nov 13 |
jari |
Avg. method: None |
2126 |
08 Nov 13 |
jari |
// All other parameters can be left at their default values. |
2126 |
08 Nov 13 |
jari |
- Save. |
2126 |
08 Nov 13 |
jari |
# Test the plug-in and when you are satisfied, share the plug-in and |
2126 |
08 Nov 13 |
jari |
formula to your users. |
766 |
16 Sep 08 |
jari |
76 |
}}} |
766 |
16 Sep 08 |
jari |
77 |
|
766 |
16 Sep 08 |
jari |
78 |
|
766 |
16 Sep 08 |
jari |
== Compiling == |
766 |
16 Sep 08 |
jari |
80 |
|
895 |
08 Dec 08 |
jari |
You must checkout the `se.lu.onk.VirtualArray` from the repository, |
766 |
16 Sep 08 |
jari |
follow the instructions below. Then download and untar the |
766 |
16 Sep 08 |
jari |
`se.lu.onk.BaseFile` package available from |
766 |
16 Sep 08 |
jari |
http://baseplugins.thep.lu.se/wiki/PluginDownload. This package is |
766 |
16 Sep 08 |
jari |
known to work with `se.lu.onk.BaseFile` version 1.0. |
766 |
16 Sep 08 |
jari |
86 |
{{{ |
766 |
16 Sep 08 |
jari |
check out project, see instructions below |
895 |
08 Dec 08 |
jari |
# cd /path/to/se.lu.onk.VirtualArray |
804 |
01 Oct 08 |
jari |
# wget http://baseplugins.thep.lu.se/attachment/wiki/se.lu.onk.BaseFile/BaseFile-1.0.tgz?format=raw -O BaseFile-1.0.tgz |
804 |
01 Oct 08 |
jari |
# wget http://baseplugins.thep.lu.se/attachment/wiki/se.lu.onk.BaseFile/BaseFile-1.0.tgz.MD5?format=raw -O BaseFile-1.0.tgz.MD5 |
788 |
18 Sep 08 |
jari |
# optionally compare the MD5 sum of the downloaded file and the MD5-file |
766 |
16 Sep 08 |
jari |
# tar zxpf BaseFile-1.0.tgz |
766 |
16 Sep 08 |
jari |
# ln -s BaseFile-1.0 BaseFile |
766 |
16 Sep 08 |
jari |
or |
766 |
16 Sep 08 |
jari |
# mv BaseFile-1.0 BaseFile |
766 |
16 Sep 08 |
jari |
96 |
}}} |
766 |
16 Sep 08 |
jari |
It is important that the `BaseFile` package is located in directory |
766 |
16 Sep 08 |
jari |
`BaseFile`. Now simple issue `ant`. This will create a jar file |
895 |
08 Dec 08 |
jari |
`dist/VirtualArray.jar`. |
766 |
16 Sep 08 |
jari |
100 |
|
766 |
16 Sep 08 |
jari |
101 |
|
766 |
16 Sep 08 |
jari |
== Creating a distribution == |
766 |
16 Sep 08 |
jari |
103 |
|
776 |
18 Sep 08 |
jari |
Update the version number in `build.xml`, and issue `ant |
776 |
18 Sep 08 |
jari |
package`. This creates a distribution package with all required |
776 |
18 Sep 08 |
jari |
components, including BaseFile.jar and associated files. |
766 |
16 Sep 08 |
jari |
107 |
|
766 |
16 Sep 08 |
jari |
108 |
|
766 |
16 Sep 08 |
jari |
== Bug Reporting == |
766 |
16 Sep 08 |
jari |
110 |
|
895 |
08 Dec 08 |
jari |
You can report `se.lu.onk.VirtualArray` bugs on |
766 |
16 Sep 08 |
jari |
112 |
|
766 |
16 Sep 08 |
jari |
http://baseplugins.thep.lu.se/newticket |
766 |
16 Sep 08 |
jari |
114 |
|
766 |
16 Sep 08 |
jari |
Use user `base` and password `base`. |
766 |
16 Sep 08 |
jari |
116 |
|
766 |
16 Sep 08 |
jari |
117 |
|
766 |
16 Sep 08 |
jari |
== Subversion Access == |
766 |
16 Sep 08 |
jari |
119 |
|
895 |
08 Dec 08 |
jari |
The `se.lu.onk.VirtualArray` source repository is available via anonymous |
766 |
16 Sep 08 |
jari |
subversion access, issue: |
766 |
16 Sep 08 |
jari |
122 |
|
895 |
08 Dec 08 |
jari |
`svn co http://baseplugins.thep.lu.se/svn/plugins/base1/se.lu.onk.VirtualArray/trunk se.lu.onk.VirtualArray` |
766 |
16 Sep 08 |
jari |
124 |
|
766 |
16 Sep 08 |
jari |
There is no guarantees about the contents or quality of the latest |
766 |
16 Sep 08 |
jari |
code in the subversion repository: it is not unheard of for code that |
766 |
16 Sep 08 |
jari |
is known to be broken to be committed to the repository. Use at your |
766 |
16 Sep 08 |
jari |
own risk. You may prefer to check out a released version instead, then |
776 |
18 Sep 08 |
jari |
replace `trunk` with `tags/version` in the above example. |
766 |
16 Sep 08 |
jari |
130 |
|
766 |
16 Sep 08 |
jari |
131 |
|
766 |
16 Sep 08 |
jari |
132 |
---------------------------------------------------------------------- |
766 |
16 Sep 08 |
jari |
133 |
{{{ |
2126 |
08 Nov 13 |
jari |
Copyright (C) 2008, 2009, 2013 Jari Häkkinen |
766 |
16 Sep 08 |
jari |
135 |
|
895 |
08 Dec 08 |
jari |
This file is part of the se.lu.onk.VirtualArray plug-in for |
895 |
08 Dec 08 |
jari |
BASE. Available at http://baseplugins.thep.lu.se/ and BASE web site is |
766 |
16 Sep 08 |
jari |
http://base.thep.lu.se |
766 |
16 Sep 08 |
jari |
139 |
|
766 |
16 Sep 08 |
jari |
This is free software; you can redistribute it and/or modify it under |
766 |
16 Sep 08 |
jari |
the terms of the GNU General Public License as published by the Free |
766 |
16 Sep 08 |
jari |
Software Foundation; either version 3 of the License, or (at your |
766 |
16 Sep 08 |
jari |
option) any later version. |
766 |
16 Sep 08 |
jari |
144 |
|
766 |
16 Sep 08 |
jari |
This package is distributed in the hope that it will be useful, but |
766 |
16 Sep 08 |
jari |
WITHOUT ANY WARRANTY; without even the implied warranty of |
766 |
16 Sep 08 |
jari |
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
766 |
16 Sep 08 |
jari |
General Public License for more details. |
766 |
16 Sep 08 |
jari |
149 |
|
766 |
16 Sep 08 |
jari |
You should have received a copy of the GNU General Public License |
766 |
16 Sep 08 |
jari |
along with this package. If not, see <http://www.gnu.org/licenses/>. |
766 |
16 Sep 08 |
jari |
152 |
}}} |