
BMP - version 0.1
Automated search model generation and Molecular Replacememt

########################################
About BMP
########################################

BMP is an automated scheme for Molecular Replacement. Given 
a target sequence and experimental structure factors, it will 
search for homologous structures, create a set of suitable 
search models from the template structures, do molecular 
replacement, and test the solutions with some rounds of restrained 
refinement.

* IMPORTANT * IMPORTANT * IMPORTANT **

BMP relies heavily on the use of web-based sevices and applications 
for carrying out the template search part of the procedure. It also
retrieves PDB files from the web to construct the search models. If
you are sensitive about your target sequence data it is suggested that
you download and install the fasta34 program so that you can run the 
sequence-based searches locally. This is availble from the EBI site:

ftp://ftp.ebi.ac.uk/pub/software/unix/fasta/

***************************************


########################################
Installation
########################################

BMP has a few dependencies which must be present on your system 
before it can be installed.

    * Mandatory:
          o CCP4 6.0 or higher,
          o Python 2.3 or later,
          o Mafft or Clustalw,
          o Gnuplot.
    * Optional:
          o Fasta34,
          o Perl + SOAP-Lite perl module (for SSM search).

To install BMP simply run the install.sh script as follows:

./install.sh

This will install BMP under your CCP4 installation.

Note: you must have write permissions for the $CCP4 folder to
be able to install BMP. If you do not have write permissions 
for this folder you should contact your system administrator 
and ask them to install BMP for you. 
 

########################################
Installing the BMP tasks in CCP4i
########################################

To install the BMP CCP4i task carry out the following steps:

  1. Start the CCP4i gui and select 'Install/uninstall Tasks'
     from the 'System Administration' menu.

  2. Select 'install a new task'.

  3. Under the 'Install Package Information' section select
     the BMP.tar.gz file which should be in the folder:
     $CCP4/ccp4i

  4. Click on the 'Apply' button.

  5. Restart ccp4i. The BMP tasks should appear in the 
     'Program List' and 'Molecular Replacement' menus.


########################################
Running BMP
########################################

BMP can be used via the CCP4i gui or from the command line. Here
is an example of how to use BMP on the command-line:

bmp HKLIN foo_in.mtz SEQIN foo.seq HKLOUT foo_out.mtz XYZOUT foo.pdb 
 
BMP is similar to other CCP4 programs in that it requires keywords.
The user will be prompted for these keywords at the begining of a 
job or they can be written to a file and passed into the program 
on the command line.

For details of the keywords for BMP see the bmp.html file in the 
$CCP4/html folder.


########################################
Authors
########################################

Ronan Keegan, CCP4, Daresbury Laboratory
Martyn Winn, CCP4, Daresbury Laboratory
