-
Notifications
You must be signed in to change notification settings - Fork 3
/
Copy pathINSTALL
102 lines (62 loc) · 2.79 KB
/
INSTALL
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
Bio::EnsEMBL::XS
Version 2.3.2
OBTAINING THE ENSEMBL API EXTENSIONS
------------------------------------
The latest version can be obtained by cloning the GitHub repo::
git clone https://github.com/Ensembl/ensembl-xs.git
PREREQUISITES
-------------
The Ensembl API extensions require an installation of the Ensembl Perl API.
See http://www.ensembl.org/info/docs/api/api_installation.html for instructions
on how to install the API.
Like the Ensembl API, the extensions are designed to run with all perl versions >= 5.8.9.
QUICK INSTALL
-------------
The Ensembl API extensions can be be installed from source code.
To install the extensions from the command line:
$ cd ensembl-xs # assume ensembl-xs is the directory name of the cloned repo
$ perl Makefile.PL
$ make
$ make test
$ make install # may need root access
After the installation, the user may continue to use the Ensembl API as usual, since
this will now automatically detect the availability of the extensions and use them where
appropriate.
BUILDING AND TESTING
--------------------
This section describes the "make" and "make test" commands which build
and test the Ensembl API extensions. If you ran these without incident,
then you can probably skip this section.
The 'make' command will build the extensions modules in the
usual manner.
make
The 'make test' command runs the test scripts in the 'xs/t' subdirectory.
make test
BENCHMARKING
------------
The 'bin/' directory of the distribution contains a bunch of perl scripts which compare
the running time of the original procedures in the Ensembl API and of the corresponding
extensions.
Each script runs tests for one single procedure, e.g. to benchmark the 'rearrange' method
of module Bio::EnsEMBL::Utils::Argument against its reimplementation:
$ cd bin
$ perl rearrange-bench.pl
Each script runs the original and optimised version on a set of tasks and for each one
it shows a comparison of the running time in the two cases.
INSTALLATION
------------
This section describes the final installation of the Ensembl API extensions
via the "make install".
The 'make install' will install the modules and scripts on your system.
You may need administrator privileges to perform this task.
Alternately you can can install the extensions to a local
directory (see ExtUtils::MakeMaker for full details), e.g.
$ perl Makefile.PL PREFIX=/home/user
Don't forget to update your PERL5LIB environment variable if you do
this, or add a line to your script to tell Perl where to find the files,
e.g.
use lib qw( /home/user/lib/perl5/site_perl/5.10.0 );
AUTHOR
------
The module and the extensions have been written by Alessandro Vullo <[email protected]>
with the assistance of Andy Yates and contribution of Will McLaren.