(c) 1990-2016 SciTech Software
Dr. Andrew C.R. Martin,
UCL and The University of Reading
EMail: andrew@bioinf.org.uk
Bioplib is a library of routines for the manipulation of protein structure and sequence using the C programming language. In addition, the term `Bioplib' refers to routines for more general C programming purposes.
This library is copyright (c) 1990-2016 and was mostly originally written by Dr. Andrew C.R. Martin while self-employed. Many enhancements and some additional routines have been written while at The University of Reading (2000-2003) and at UCL (1993-1999 and 2004 onwards).
BiopLib is licensed under the GPL Version 3. Commercial licences are also available - see COPYING.DOC.
By default, PDBML (XML) format files are supported. If you wish to do this, you need to install libxml2
If you do not need PDBML (XML) support, then you can skip this step.
This will normally be already installed and available on Linux systems. If not then it is installed on Fedora/CentOS systems using (as root):
yum -y install libxml2 libxml2-devel
or on Debian/Ubuntu systems using:
sudo apt-get install libxml2 libxml2-dev
On other systems, you will need to install libxml2 manually from http://xmlsoft.org/downloads.html
If you have downloaded a gzipped tar file, do:
zcat bioplib-X.Y.tar.gz | tar -xvf -
-or-
gunzip bioplib-X.Y.tar.gz
tar -xvf bioplib-X.Y.tar
-or- (if you have Gnu tar)
tar -zxvf bioplib-X.Y.tar.gz
(where X.Y is the major and minor version numbers - e.g. 3.0)
If you have chosen to download a ZIP file, unpack this using
unzip bioplib-X.Y.zip
This will create a directory called bioplib-X.Y
Enter this directory and then go into the src sub-directory:
cd bioplib-X.Y/src
These directories will be created when you install BiopLib if they do not exist already:
~/include
~/include/bioplib
~/lib
~/data
You can also choose to install the files elsewhere, but need to modify the Makefile as described below.
If you are using the GNU C compiler and wish to install BiopLib in the default directories and provide PDBML (XML) support, no configuration changes should be needed and this section can be skipped.
Otherwise, modify the Makefile as required for your system.
If you have chosen alternative locations for the include, library and data directories then you will need to change:
Note that the complete path is required, you cannot do ~/lib.
If you wish to use dynamic libraries (see 'Additional installation options', below), you may also wish to change their location by changing:
If you do not require PDBML (XML) support, comment out the relevant COPT line from the Makefile.
make
make doxygen
make install
make installdata
If you are using BiopLib routines that access BiopLib data directories, you must set the environment variable DATADIR to point to the directory in which you have installed the BiopLib data files (default $HOME/data)
sh/bash:
export DATADIR=$HOME/data
csh/tcsh:
setenv DATADIR $HOME/data
(This command should be placed in your .bashrc, .profile, .tcsh or .cshrc file as appropriate for your shell.)
If you are using the BiopLib interactive help support in your programs, you must set the environment variable HELPDIR to point to the directory in which you have installed the BiopLib help files (default $HOME/help)
sh/bash:
export HELPDIR=$HOME/data
csh/tcsh:
setenv HELPDIR $HOME/data
(This command should be placed in your .bashrc, .profile, .tcsh or .cshrc file as appropriate for your shell.)
You can use BiopLib as a set of shared libraries:
make shared
make installshared
You can clean up your compilation directory with:
make clean
bioplib-X.Y/doc/doxygen/docsrcinput/page_01.dox
or, after doing 'make doxygen', read the formatted version by pointing a web browser at:
bioplib-X.Y/doc/html/index.html