CCL Home Page
Up Directory CCL q2m.ascii


Q2M(1OSC)                 OSC utilities                 Q2M(1OSC)



NAME
     q2m - convert cartesian coordinate table to Sybyl MOL file

SYNOPSIS
     q2m [ -i inpfile ] [ -o outfile ] [ -s string ] [ -f optfile
     ]  [ -n molname ] [ -d length ] [ -m unit ] [ -l link-list ]
     [ -u unlink-list ] [ -a maxatoms ] [ -b maxbonds ] [ inpfile
     [ outfile ] ]

DESCRIPTION
     The program q2m converts a table of cartesian coordinates of
     atoms  to  a  SYBYL MOL file format (SYBYL is a trademark of
     Tripos Associates). It creates appropriate  atom  types  and
     bond  types  based  on  interatomic  distances. The table of
     cartesian coordinates has to contain one column which  iden-
     tifies  element  either  by  its  chemical symbol, or atomic
     mass, or atomic number. The MOL file so created can be  read
     into SYBYL for display or further manipulation.

OPTIONs
     Option arguments contain  characters  which  are  frequently
     conflicting with the shell interpretation. For safety, it is
     advised that inclose them in single quotes.

     -i inpfile
          File inpfile contains cartesian coordinates. If inpfile
          is  not  specified,  standard input (stdin) is assumed.
          inpfile can be also specified without -i option  letter
          as the first argument after all options.

     -o outfile
          File outfile will contain resulting MOL file.  If  out-
          file  is  not  specified  standard  output  (stdout) is
          assumed.  outfile can  be  also  specified  without  -o
          option  together  with inpfile after all options as the
          second argument.

     -s string
          The order and type of columns in the table is given  by
          string.  Column is a series of nonblank characters fol-
          lowed by one or more  spaces  or  TABs.  The  following
          colum types are recognized: M - atomic mass, A - atomic
          number, C - chemical symbol (may be followed by  digits
          or  other  characters),  S  -  column to discard, X - X
          coordinate, Y - Y coordinate, Z -  Z  coordinate.  Only
          one  M, A, or C column may be specified. The X, Y, or Z
          columns cannot be repeated.

     -f optfile
          The options will be read from optfile. The optfile con-
          tains options in the same format as if they appeared on
          the command line.



OSC                 Last change: 27 Mar 1991                    1






Q2M(1OSC)                 OSC utilities                 Q2M(1OSC)



     -n molname
          Using this option you can specify molecule name  to  be
          included in the MOL file or otherwise it will be set to
          "Unknown".

     -d length
          This  is  the  length  of  longest  possible  bond  [in
          Angstroms]  in  the molecule.  All atoms closer to each
          other than length are considered bonded by  a  chemical
          bond.  Exception is used for hydrogen atoms. Two hydro-
          gen atoms are considered bonded only if they are closer
          than  0.8  Angstrom.  If  length  is  not specified 1.7
          Angstrom is assumed.

     -m unit
          The coordinates in the input file may be specified in B
          (bohrs,   i.e.   atomic   units)   N   (nanometers)   A
          (Angstroms). If this option is not specified, Angstroms
          are assumed.

     -l link-list
          Sometimes you want to include bonds which will  not  be
          found  by a simple distance checking. You may specify a
          list of bonded atom pairs and a type of bond  by  which
          atoms are bonded. The link-list consist of entries of a
          type ibj separated by commas or spaces. i is the number
          of  first  atom,  j  is  a  number of second atom and b
          specifies a type of bond between them. The bond type  b
          may  one  of  the following: : (unspecified - when bond
          type is not known), - (single), = (double), # (triple),
          a  (amide  bond),  r  (aromatic), . (dummy - not a true
          bond, but marker rather), u (unusual - nobody yet knows
          what  it  is).  This option may be used not only to add
          new bonds but also to specify a correct bond  type  for
          bonds  which  are found from interactomic distance com-
          parisons. The link-list should be  enclosed  in  single
          quotes for safety.

     -u unlink-list
          Sometimes you want to  remove  some  bonds  which  were
          found  by  simple  distance  check. This option removes
          bonds between atom pairs specified by unlink-list. Atom
          numbers  and  their pairs can be separated by spaces or
          any other nondigit characters.

     -a maxatoms
          If your coordinate table  may  contain  more  than  100
          atoms,  you  need to specify larger limit for number of
          atoms with this option.

     -b maxbonds
          If your molecule may contain more than 200  bonds,  you



OSC                 Last change: 27 Mar 1991                    2






Q2M(1OSC)                 OSC utilities                 Q2M(1OSC)



          need  to  specify larger limit for number of bonds with
          this option.

EXAMPLES
     q2m -s SXYZM -m B -d 1.6 -l  1-4,1=2  -n  propanal  test.inp
     requests  that  file  test.inp  is converted to MOL file and
     sent to standard ouput.  The coordinates  are  given  origi-
     nally  in  atomic  units.  The columns 2-4 contain cartesian
     coordinates, while 5-th column contains atomic masses. Atoms
     are  considered  bonded if they are closer than 1.6 Angstrom
     to each another.  The single bond is specified between atoms
     1 and 4, and double bond between atoms 1 and 2.

FILES
     The program resides in /loclib/q2m  directory.  Examples  of
     use   are   given  in  /loclib/q2m/test.  The  docs  are  in
     /loclib/q2m/doc.

SEE ALSO
     To familiarize yourself with MOL file format read  appropri-
     ate  pages  of  SYBYL manual or use on-line help facility of
     SYBYL.

DIAGNOSTICS
     Most error messages are self-explanatory.

BUGS
     Program does not find some atoms types and you have to enter
     correct  types  by  editing resulting MOL file. This program
     does not contain substructure searches  necessary  to  match
     some of the SYBYL atom types, however, most basic atom types
     are assigned correctly. Report bugs to the author.

AUTHOR
     Jan Labanowski, Ohio Supercomputer Center, 1224 Kinnear  Rd,
     Columbus,  OH  43212-1163,  ph.  614-292-9279, FAX: 614-292-
     7168, e-mail: jkl@ccl.net, JKL@OHSTPY.BITNET.


















OSC                 Last change: 27 Mar 1991                    3



Modified: Mon Apr 12 16:00:00 1993 GMT
Page accessed 6656 times since Sat Apr 17 21:37:36 1999 GMT