Macromolecular Geometry
Calculation Programs

"geometry" code library 2.3.1

Overview

This is a general "code base" for geometric calculations on macromolecular structures. It includes: (1) code and executables for calculating Voronoi polyhedra and Delaunay triangulations; (2) programs to calculate related geometric quantities -- such as accessible surfaces, helix axes, least-squares fits, H-bonds, VDW contacts, and crystal symmetry; and (3) many data files associated with this -- e.g. standard volumes and radii.

The primary use of this computer code is for volume or surface calculations. If you use it for calculating volumes, please refer to the following reference:

Authorship, Copying, Building, Using...

This code was assembled by Mark Gerstein. Much of it was written by Mark Gerstein but there are substantial contributions from Julian Graham, Jerry Tsai, Yehouda Harpaz, David Hinds, Neil Voss, and others. The code is currently maintained by Neil Voss (vossman77 [at] yahoo.com) This code is copyright 1995, 1999, 2005.

You are free to use it for whatever academic calculations you may wish to. However, you are asked to:

  1. Cite the references above when you use the programs for published work;
  2. Keep this statement with the programs;
  3. Not incorporate this code into any commercial programs without obtaining explicit permission from the author.

Contact Mark Gerstein if you have any questions or difficulties.

Most everything here is written in the C language and compiles using make under Unix. It has so far been tested on DEC alphas, SG Indigos, PowerPCs and i486s thorugh Core 2 Duos and Opterons running many different distros of Linux. To get everything going, just type 'configure' then 'make' in the top level directory and all the libraries and executables should be built and tested.

Organization

data . This subdirectory contains various data files pertinent to the calculations -- e.g. standard radii and volumes for atoms.

src-prog / README . These were the original programs distributed with version 1.0 of the code -- calculation of Voronoi volumes, accessible surfaces, and the Delauney triangulation.

src-prog2 / README .This directory contains extra programs for finding H-bonds, VDW contacts, and helix axes.

src-prog3 / README . This directory contains programs to calculate packing efficiency, generate crystal symmetry, and do RMS fitting.

sh / README . This directory contains perl scripts for condensing and expanding volume data files.

src-lib / lib . The library source and binary is contained in these subdirectories.

sample-runs .Sample runs are in this directory.

bin . The executables.

Location of the code

This file and all the computer code is located at the following URL:

http://geometry.molmovdb.org/files/libproteingeometry-2.3.1.tgz

This URL is a tar achive that contains the source code plus sample output and scripts for checking out the programs. To extract files from the archive use the command 'tar zxvf libproteingeom-2.*.tgz' .

Unpacked versions of all the computer code is located at:

http://geometry.molmovdb.org/files/libproteingeometry/

History

25 October 1995 -- Version 1.0, released code

3 May 1996 -- Version 1.1, Corrected bug that prevented the calculation of hydrogen volumes, Corrected bug (I think) that lead to the first atom type being given a zero radius. To make doubly sure this doesn't happen, just make this first atom type a dummy type ("JUNK").

7 June 1996 -- Version 1.101, Added a few references to this README

26 November 1996 -- Version 1.102, Fixed typing of GLY CA (was C4H, now C4HH)

24 December 1996 -- Version 1.103, Updated this README file to better document the calculation of Delauney Tessellations

25 July 1997 -- Created version "1.0" of "extra-mbg" programs.

10 September 1999 -- Version 2.0b1

23 August 2007 -- Version 2.3

25 October 2007 -- Version 2.3.1, Richards Radii fix

see the ChangeLog

Other References

Regarding surfaces and volumes, you may also want to look at: