BUSTER User Manual previous
Appendix D

Appendix D: Stereochemical restraints for ligands

Copyright © 1995-2004 by   Eric Blanc, Pietro Roversi, Clemens Vonrhein,
Gérard Bricogne and the Buster Development Group.
All rights reserved.


Content


Background

A small molecule can be represented by a SMILES string, which tersly condenses both the molecule's chemical composition and its connectivity (and optionally the stereochemistry of some or all of its stereogenic centers). Given a ligand's representation by a SMILES string, BUFFET offers a primitive way of generating the stereochemical restraints suitable for BUSTER-TNT, provided that the Daylight Toolkit and Daylight's RUBICON are available. The restraints generation is achieved by matching SMARTS patterns in the SMILES string. The SMARTS rules provided with the Daylight Toolkit are quite general, and therefore not very precise, but the geometrical restraints that are based on them avoid unrealistic mangling of the ligand's stereochemistry during the Maximum Likelihood refinement.

The script $BDG_home/bin/buster/SmilesGUI, described here, is provided for the generation of the stereochemical restraints based on a SMILES string, in the TNT format. It also generates a PDB file with atom labels matching those used in the TNT dictionary. Finally, the interactive script can generate another script, suitable for automation of the process.


Script requirements

Please note that the Daylight toolkit is not available for HP/Compaq Tru64/Digital UNIX.

The following environment variables need to be set:

   
    variable name notes
   
    BDG_java the java binary must implement the version 1.3 or above of the run-time environment
    DY_LICENSEDATA a valid licence for the Daylight's Toolkit (and optionally RUBICON). Beware of the spelling !
    DY_ROOT point to the root of the Daylight's distribution (usually /usr/local/daylight/v473). This environment variable is not strictly speaking mandatory if one does not use RUBICON, but it is useful for finding all kind of files.
    LD_LIBRARY_PATH must contain the location of libBalls.so, i.e. $BDG_home/bin/irixn32_exe or $BDG_home/bin/linux_exe and the location of the Daylight Toolkit shared libraries, usually $DY_ROOT/lib.
   

The script builds the CLASSPATH for the java program $BDG_home/lib/java/SmilesGUI.class.


Script input

  1. a 3-character name for the ligand (e.g. for 2-methyl-2,4-pentanediole one can choose "MPD" - notice that this name MUST match the one the ligand has in the PDB file);

  2. a SMILES string;

  3. [an optional 3D model of the ligand in PDB format, provided that the atoms order in the PDB file is identical to that in the SMILES string];

  4. an output directory to write the output files.
The GUI offers some flexibility for the restraints generation and PDB output. Please don't forget to save your preferences !

Script output

The following (optional) output is available:
  1. the stereochemical restraints describing the ligand in TNT format,
  2. a tentative 3D model for the ligand (identical to the input model when provided, otherwise generated by Daylight's RUBICON program),

  3. an assessement of the stereochemical quality of the 3D model,

  4. a script suitable for generation of TNT dictionaries and PDB models from the command-line.

Additional information

Some atom naming convention is required to identify chemically equivalent atoms in the model. This identification is carried out by appending the SMILES's serial number to each atom, which means that it cannot generate proper PDB from a molecule containing more than 100 non-H atoms. This naming scheme is obviously compatible between the TNT dictionary and the generated PDB.

There are a few caveats to keep in mind when using the $BDG_bin/buster/SmilesGUI script:

For those two reasons, the user might not want to use torsion angles generated by the script. Current defaults in BUSTER are to ignore torsion angles stereochemical restraints during refinement, including those for the ligand.

Please consult the documentation from the java GUI for more details about the program operation.


Last modification: 26.01.04