MAID: an automated map-fitting routine. Copyright David G. Levitt, 2000.

MAID by David Levitt at the University of Minnesota uses torsion angle molecular dynamics for automated building of the amino acid sequence of a protein into an electron density map and is described in:

"A new software routine that automates the fitting of protein X-ray crystallographic electron density maps." D. G. Levitt. (2001). Acta Crystallogr. D57, 1013-1019. 

Since David's research now focusses on pharmacokinetics, with David's permission MAID can be obtained below.

IMPORTANT POINTS:
  • MAID runs best on a 64 bit computer and, although you can run it on a 32 bit machine, it tends to stop prematurely and may not complete all three stages of the model-building process, namely "trace", "extend" and "expand". Therefore it is recommended that you run it on a 64 bit machine with a 64 bit operating system, although you may still get a useful starting model of the structure if you do run it on a 32 bit system. Anyhow, I am confident that the 64 bit version on a 64 bit machine will work as well as MAID used to on an SGI, a long time ago and its a lot quicker!

  • There is a simple GUI for running MAID in batch- or background-mode without having to read the manual and this is called MAIDaid. If you run the MAIDaid GUI, you can now ignore the rest of this paragraph. MAID itself requires the electron density map to be in X-PLOR/CNS ASCII format and it should be normalised, i.e. the mean density should be zero and the RMS density should be 1.0. Maps not already in this format can be converted using MAPMAN (in the Uppsala suite) or re-calculated using the PHENIX gui as follows: in the PHENIX 'Maps' tab, use the 'FFT map coefficients' option and set 'Map scaling' to 'sigma' and 'Format' to 'XPLOR'. However, this normalisation is now done automatically by MAIDaid, whenever needed. MAIDaid will also read CCP4 maps, convert them to X-PLOR format and normalise them, as required.

  • By default, PHENIX produces a map covering the unit cell and CCP4 produces a map which covers just the asymmetric unit. This may or may not give MAID some problems! It may be better to build a dummy water molecule roughly in the middle of the protein density and save it as PDB file. Subsequently using PHENIX or CCP4 to calculate the map around this water molecule with say a 35 - 40 Angstrom border may give better results.
Linux


Original linux version
This version of MAID can be compiled using most UNIX and Linux compilers. Follow the compiler directions in the MANUAL to choose your compiler. (Special thanks to Ralf Grosse-Kunstleve (nwgk@cci.lbl.gov) for allowing me (DGL) to use the "compiler farm".)

Click on the underlined file - and direct it to the directory you want:
Download MAID code, manual and makefile (tar and zipped) by clicking on: maid_unix_12nov01.tar.gz
     In the directory where the  .tar.gz file is located:
     Unzip the file: gunzip filename.tar.gz
     untar the file: tar xvf file.tar
This will create a new subdirectory glmaid_unix  containing all the files you need to compile MAID.
Read either MANUAL5_word.doc or MANUAL5_word.txt for instructions for compiling and running MAID.

Newer linux version
A newer linux version which includes the maidaid GUI for starting the batch version of MAID can be obtained here:

64 bit or here 32 bit (Sep 2015).

Note that the only difference between these two files is that maid and maidaid have been compiled on 64 and 32 bit linux. If it turns out that you need to compile everything from source, either will be fine because the programs themselves are identical in each. Remember that MAID will nearly always work better on a 64 bit system.

To run the program, unzip the files with your linux file manager or as described above, then go to the linux_maid folder and double-click on the maidaid file icon or use a terminal window to enter the following command in the linux_maid folder: ./maidaid

In case of problems, first ensure that both maidbatch and maidaid are executable i.e. type: chmod u+x maidbatch maidaid

If maidbatch does not work, you can compile it from source by opening a terminal window in the folder where the program files are and typing "make" noting that you will, of course, need to have 'make' and g++ installed first. It is also fairly easy to compile maidaid by installing the latest FLTK library from the website (www.fltk.org) in the usual unix way (i.e. "./configure", "make", "sudo make install"). It seems to work better if you install FLTK from source in this way rather than getting it via your linux package manager. In the maid folder, open a terminal window and type: "fltk-config --compile maidaid.cxx" to compile maidaid itself. Finally, if the maidaid font size turns out to be too small, installing the X freetype font library (libxft-dev) with your package manager and repeating the FLTK build will help.

Note that this linux version is based on the tweaked one I made for Windows, so please read the paragraphs below since they give the general idea of what to do. 

Windows

David's original code for the batch version of MAID has been tweaked by myself (J. Cooper) so that it can be compiled by MinGW and run on Windows. There is also a basic GUI, which I have called MAIDaid, for launching MAID without having to read the manual, although there is an on-screen help button, if needed. The Windows version can be obtained as a zip file here:

64 bit or here 32 bit (Sep 2015).

The files are within a folder called 'maid' which contains the original program manual (MANUAL5_WORD.txt and .doc). The easiest option should be to run MAID using the MAIDaid GUI which you can start by just double-clicking MAIDaid.exe. You can even make a neat short-cut to this program on the Windows desktop! However, please remember that the MAIDaid.exe file must be in the same folder as maidbatch.exe, which is the batch version of the MAID program. In the unlikely event that MAIDaid starts OK but stops when you click on 'Prepare files', right-click on the executable and select 'Troubleshoot compatibility' to sort it out. Note, the 'screen' i.e. interactive version of MAID hasn't (yet) been compiled for Windows (or Linux).

A folder (test_maps) with a few sample maps in the right format and the corresponding amino acid sequences is provided for testing purposes.

If necessary, maidbatch can be compiled using g++ in MinGW or MinGW-w64 (as appropriate) and MSYS which provides a Windows 'make' program (note that GNU make.exe and the 'makefile' are provided). MAIDaid can be compiled with MinGW or MinGW-w64 (as appropriate) using MSYS, firstly to install FLTK and then to run the compile_MAIDaid.bat file.


Mac

I
'm afraid all the people with MACs round here have left, so I haven't been able to prepare anything, but it shouldn't be too hard to compile the program using the source code for the Linux version.

Compatibility

Note that for some reason Coot may not manage to read in PDB files produced by MAID so you may need to renumber all of the residues with a PDB file utility, such as PDBSET, and insert the right the CRYST and SCALE cards. Just type the following in a command shell:

pdbset xyzin input.pdb xyzout output.pdb
cell 55 66 77 90 90 90
spac P212121
renum 1
end


with appropriate filenames and values for your crystal symmetry. The residue numbering, etc, can be corrected in Coot later.

As of Aug 2015 I have been able to iron-out a couple of annoying bugs in maidaid so it is a lot more stable on Windows and linux but please let me know how it goes.

jon.cooper@ucl.ac.uk