Resources :: GRAMM v1 :: Installation


GRAMM is compiled on SGI R10000, SGI R4000, SGI R4400, SGI R8000, Sun SPARC, IBM RS6000, DECAlpha, and PC (Windows and Linux). Windows version must work on all 32-bit flavors of the MS Windows operating system. Linux version was compiled on RedHat with glibc2.0.


  1. Copy the executable file gramm to some standard location (e.g. /usr/local/bin on Unix) or to a separate directory (e.g., gramm103) and include the directory in the path.
  2. Copy the data files (angXX.dat) to a separate directory (e.g., gramm103/dat). Define the environment variable GRAMMDAT with the name of this directory. How to define the environment variable:
    • Unix C-shell (csh) or Tc-shell (tcsh): add the line setenv GRAMMDAT  directory-name to .cshrc file
    • Unix Bourne shell (sh) and descendants (e.g. bash - standard shell on Linux, or Korn shell ksh): add the line export GRAMMDAT=directory-name to .profile file (or to .bashrc if using bash )
    • If unsure what shell you are using, type echo $SHELL at the command prompt.
    • After defining environment variable in Unix, 'source' your startup file or log into your account again. You can use echo $GRAMMDAT command to check the value of the variable.
    • MS Windows 95, 98, Me: add SET GRAMMDAT=directory-name to your autoexec.bat file, then reboot (Windows Me will convert SET command into registry entry while rebooting and purge autoexec.bat after that - this is normal).
    • MS Windows NT, 2000: use Environment tab in the System control panel Picture 1Picture 2 . If you are logged in as administrator, you will be able to add a  system-wide variable in the 'System Variables' section, otherwise use 'User Variables' section. First, select the proper section with a mouse, then type the new variable name and value in input lines at the bottom, and press Set button. After that, your new variable must appear in a list with other variables. On Windows XP the procedure is similar with the exception that the environment variables dialog is located at Control Panel -> System -> Advanced -> Environment Variables.
    • To check the values of environment variables under MS Windows, open "MS DOS" prompt window and type SET command.
  3. Copy the files,, to your working directory where you are planning to do the calculations. You will have to modify these files to define the task for GRAMM. If you are creating a shortcut in Windows to run GRAMM, you have to specify the working directory (start directory) in the shortcut properties and a parameter to pass to GRAMM when it is launched (e.g. gramm scan to dock or gramm coord to produce PDB output, see readme for details).
  4. The README file is included both in PostScript and MS Word formats. The file describes parameter files and typical sets of parameter values used to run GRAMM.
  5. NOTE: GRAMM takes as input molecular files in PDB format, and reads only the ATOM records from these files. In particular, HETATM records will be ignored.
  6. When you run GRAMM, it will create a gramm.log file in the working directory. If something goes wrong, look for messages in gramm.log . The typical problems are:
ERROR: no parameters (scan,coord) for GRAMM You have to run gramm scan or gramm coord , not just gramm
ERROR: ... step is too small for the max.(64x64x64) grid Either your molecules are too large, or your grid step is too small. In either case, the size of 3D grid used internally by GRAMM for projections of molecules will exceed 64x64x64 elements. GRAMM will refuse to use grids larger than this limit, since the computation time becomes too large even on modern processors. You have to either increase grid step or cut your receptor into several smaller overlapping fragments using some molecular modeling software and dock those fragments separately with the ligand.
ERROR IN OPENING Parameter files for your particular calculation ( is one of them) must be present in your current working directory (i.e. the directory that is current when you issue the command gramm)
ERROR IN OPENING angXX.dat Most likely, you did not properly define GRAMMDAT environment variable