descriptionBioPerl core
homepage URLhttp://bioperl.org
repository URLgit://github.com/bioperl/bioperl-live.git
ownercjfields@bioperl.org
last changeFri, 21 Apr 2017 15:47:08 +0000 (21 10:47 -0500)
last refreshFri, 26 May 2017 05:23:32 +0000 (26 07:23 +0200)
content tags
add:
README.md

Build Status Coverage Status DOI Documentation Status

Getting Started

Please see the the INSTALL or INSTALL.WIN documents for installation instructions.

About BioPerl

BioPerl is a package of public domain Perl tools for computational molecular biology.

Our website (http://bioperl.org/) provides an online resource of modules, scripts, and web links for developers of Perl-based software for life science research.

Contact Information

Please submit bugs, in particular about documentation which you think is unclear, or about problems in installation. We are also very interested in functions which don't work the way you think they do!

The Directory Structure

The BioPerl directory structure is organized as follows:

Documentation

For documentation on BioPerl see the HOWTO documents online at http://bioperl.org/howtos.

Useful documentation in the form of example code can also be found in the examples/ and scripts/ directories. The current collection includes scripts that run BLAST, index flat files, parse PDB structure files, make primers, retrieve ESTs based on tissue, align protein to nucleotide sequence, run GENSCAN on multiple sequences, and much more! See bioscripts.pod for a complete listing.

Individual *.pm modules have their own embedded POD documentation as well. A complete set of hyperlinked POD, or module, documentation is available at http://www.bioperl.org/.

Remember that 'perldoc' is your friend. You can use it to read any file containing POD formatted documentation without needing any type of translator (e.g. 'perldoc Bio::SeqIO').

If you used the Build.PL installation, and depending on your platform, you may have documentation installed as man pages, which can be accessed in the usual way.

Releases

BioPerl releases are always available from the website at http://www.bioperl.org/DIST or in CPAN. The latest code can be found at https://github.com/bioperl.

From the 1.0 release until the 1.6 release even numbers (e.g. 1.4) indicated stable releases. Stable releases were well tested and recommended for most uses. Odd numbers (e.g. 1.3) were development releases which one would only use if one were interested in the latest features. The final number (e.g. in 1.2.1) is the point or patch release. The higher the number the more bug fixes has been incorporated. In theory you can upgrade from one point or patch release to the next with no changes to your own code (for production cases, obviously check things out carefully before you switch over).

The upcoming 1.7 release will be the last release series to utilize the alternating 'stable'/'developer' convention. Starting immediately after the final 1.6 branch, we will start splitting BioPerl into several smaller easier-to-manage distributions. These will have independent versions, all likely starting with v1.7.0. We do not anticipate major API changes in the 1.7.x release series, merely that the code will be restructured in a way to make maintenance more feasible. We anticipate retaining semantic versioning until the 2.x release.

Caveats and Warnings

When you run the tests with ./Build test some tests may issue warnings messages or even fail. Sometimes this is because we didn't have anyone to test the test system on the combination of your operating system, version of perl, and associated libraries and other modules. Because BioPerl depends on several outside libraries we may not be able to test every single combination so if there are warnings you may find that the package is still perfectly useful.

If you install the bioperl-run system and run tests when you don't have the program installed you'll get messages like program XXX not found, skipping tests. That's okay, BioPerl is doing what it is supposed to do. If you wanted to run the program you'd need to install it first.

Not all scripts in the examples/ directory are correct and up-to-date. If you find an issue with a script please submit a bug report to https://github.com/bioperl/bioperl-live/issues and consider helping out in their maintenance.

If you are confused about what modules are appropriate when you try and solve a particular issue in bioinformatics we urge you to look at HOWTO documents first.

A simple module summary

Here is a quick summary of many of the useful modules and how the toolkit is laid out:

All modules are in the Bio/ namespace,

Upgrading from an older version

If you have a previously installed version of BioPerl on your system some of these notes may help you.

shortlog
2017-04-21 Chris FieldsMerge pull request #223 from zmughal/travis-perl-helpersmaster
2017-04-20 Zakariyya MughalSplit coverage into separate builds223/head
2017-04-20 Zakariyya MughalFix count of tests
2017-04-20 Zakariyya MughalUse Travis Perl helper script
2017-04-19 Zakariyya MughalAdd COVERAGE to build matrix
2017-04-17 Chris FieldsMerge pull request #222 from zmughal/test-fix-from...
2017-04-17 Chris FieldsMerge pull request #221 from zmughal/travis-test-most
2017-04-17 Chris FieldsMerge pull request #219 from zmughal/doc-prosite-fix
2017-04-17 Chris FieldsMerge pull request #220 from zmughal/test-prosite-scan
2017-04-14 Zakariyya MughalClean up test: use the $db in scope and reuse variable222/head
2017-04-14 Zakariyya MughalTest requires networking
2017-04-14 Zakariyya MughalTravis CI: Add Test::Most dependency221/head
2017-04-14 Zakariyya MughalDocument Prosite parser implementation details219/head
2017-04-14 Zakariyya MughalAdd a test for PrositeScan220/head
2017-04-14 Zakariyya MughalProsite format must be fasta
2017-04-14 Zakariyya MughalFix typo: change $fatch to $match
...
tags
6 months ago release-1-7-1
7 months ago release-1-7-0
8 months ago release-1-7-0-RC6
10 months ago release-1-7-0-RC5
10 months ago release-1-7-0-RC4
2 years ago release-1-6-zenodo
2 years ago release-1-6-924 Minor release to deal with META...
3 years ago release-1-6-923 Latest release, with several bug...
3 years ago release-1-6-922
3 years ago release-1-6-921
3 years ago release-1-6-920
3 years ago release-1-6-910 Point release, mainly bug fixes
6 years ago bioperl-release-1-6-901
6 years ago bioperl-release-1-6-9 BioPerl core 1.6.9 release
7 years ago bioperl-release-1-6-1
7 years ago bioperl-1-6-0_006
...
heads
4 weeks ago master
2 months ago fix_use_of_inline-c
2 months ago fix_get_taxonids
3 months ago v1.6.x
10 months ago topic/phyloxml_output_refac
10 months ago limit-dockerhub-trigger
2 years ago topic/taxdb-to-sqlite2
2 years ago topic/rework-db-taxonomy
2 years ago topic/local_build
3 years ago topic/sf_lite_fixes
3 years ago topic/cjfields_psl_fixes
3 years ago topic/assembly-less
3 years ago topic/yinjun111-simplealign
3 years ago storable_db
4 years ago topic/tree_api_refresh
5 years ago reorganization_2.x
...