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 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176
|
$Id: README,v 1.16 2007/04/23 20:05:34 trevor Exp $
Copyright (C) 2001-2006 Toshiaki Katayama <k@bioruby.org>
= BioRuby
BioRuby is an open source Ruby library for developing bioinformatics
software. Object oriented scripting language Ruby has many features
suitable for bioinfomatics research, for example, clear syntax to
express complex objects, regular expressions for text handling as
powerful as Perl's, a wide variety of libraries including web service
etc. As the syntax of the Ruby language is simple and very clean, we
believe that it is easy to learn for beginners, easy to use for
biologists, and also powerful enough for the software developers.
In BioRuby, you can retrieve biological database entries from flat
files, internet web servers and local relational databases. These
database entries can be parsed to extract information you need.
Biological sequences can be treated with the fulfilling methods of the
Ruby's String class and with regular expressions. Daily tools like
Blast, Fasta, Hmmer and many other softwares for the biological
analysis can be executed within the BioRuby script, and the results
can be fully parsed to extract the portion you need. BioRuby supports
major biological database formats and provides many ways for accessing
them through flatfile indexing, SQL, web services etc. Various web
services including KEGG API can be easily utilized by the BioRuby.
== FOR MORE INFORMATION
BioRuby's official website is at ((<URL:http://bioruby.org/>)).
You will find links to the related resouces including downloads,
mailing lists, Wiki documentations etc. in the top page.
* ((<URL:http://bioruby.org/>))
== WHERE TO OBTAIN
--- WWW
The stable release is freely available from the BioRuby website.
* ((<URL:http://bioruby.org/archive/>))
--- CVS
If you need the latest development version, anonymous CVS is provided at
* ((<URL:http://cvs.bioruby.org/>))
and can be obtained by the following procedure.
% cvs -d :pserver:anonymous@cvs.bioruby.org:/export/cvs login
CVS password: (no password is required, just push return)
% cvs -d :pserver:anonymous@cvs.bioruby.org:/export/cvs co bioruby
--- RubyGems
((<RubyGems|URL:http://rubyforge.org/projects/rubygems/>)) version of
the BioRuby package is also available for easy installation.
* ((<URL:http://rubyforge.org/projects/bioruby/>))
== REQUIREMENTS
* Ruby 1.8.2 or later -- ((<URL:http://www.ruby-lang.org/>))
(Ruby 1.8.4 or later is recommended)
== OPTIONAL REQUIREMENTS
Some optional libraries can be utilized to extend BioRuby's functionality.
If your needs meets the following conditions, install them from the "Ruby
Application Archive" at ((<URL:http://raa.ruby-lang.org/>)).
For faster parsing of the BLAST XML output format:
* [RAA:xmlparser]
Creating faster flatfile index using Berkley DB:
* [RAA:bdb]
Accessing BioSQL database created by other Open Bio* libraries:
* [RAA:ruby-dbi] and at least one driver from [RAA:mysql-ruby],
[RAA:postgres], [RAA:oracle]
== INSTALL
In the bioruby source directory (such as bioruby-x.x.x/), run install.rb
as follows:
% ruby install.rb config
% ruby install.rb setup
% su
# ruby install.rb install
If your operating system supports 'sudo' command (such as Mac OS X),
try the following procedure instead of the above.
% ruby install.rb config
% ruby install.rb setup
% sudo ruby install.rb install
You can run tests by
% ruby install.rb test
and run
% ruby install.rb --help
for more details.
--- RubyGems
If you are using RubyGems, just type
% gems install bio
== SETUP
If you want to use the OBDA (Open Bio Database Access) to obtain database
entries, copy a sample configtation file in the BioRuby distribution
bioruby-x.x.x/etc/bioinformatics/seqdatabase.ini
to
/etc/bioinformatics/seqdatabase.ini (system wide configuration)
or
~/.bioinformatics/seqdatabase.ini (personal configuration)
and chage the contens according to your preference. For more
informations on the OBDA, see ((<URL:http://obda.open-bio.org/>)).
== USAGE
You can load all BioRuby classes just by requiring 'bio.rb'. All the
BioRuby classes and modules are located under the module name 'Bio' to
separate the name space.
#!/usr/bin/env ruby
require 'bio'
Also read other documentations in the 'doc' directory.
bioruby-x.x.x/doc/
--- RubyGems
In RubyGems, you need to load 'rubygems' library before using 'bio'.
#!/usr/bin/env ruby
require 'rubygems'
require_gem 'bio'
== LICENSE
BioRuby can be freely distributed under the same terms as Ruby.
Note that, install.rb included in the BioRuby package comes from
[RAA:setup] developed by Minero Aoki, and modified by Moses Hohman.
== CONTACT
Current staffs of the BioRuby project can be reached by sending e-mail
to <staff@bioruby.org>.
|