   *** Help file for the HMO-program "HUECKEL.TOS" (Jul. 1992, UwS) ***

General information:
  This program's purpose is to calculate the MO vectors and eigenvalues
  (MO levels) of organic Pi-systems according to the Hueckel approximation.
  The heart if this program is a diagonalization of the Hueckel matrix
  as proposed by Givens and Householder.
  The usual procedure is as folows: 
  -> enter the number of atoms             (1)
  -> enter the topologic (bond) matrix     (2)
  -> possibly enter hetero atoms           (3)
  -> solve the LCAO eigenvalue equations   (4)
  -> specify the occupation                (5)
  -> output results                        (6)(7)(8)

Whenever you are asked to enter a string (e.g. a file name or title), you 
can edit this using the cursor keys (<- and ->), the shifted cursor keys
(Sh <- and Sh ->) to move the cursor to the leftmost and rightmost character,
<Backspace> and <Delete> (as usual), and <Esc> to delete the whole input 
field. 
All menus can be exited using the <Esc> key.
You will never need to move the mouse while using this program!
This program is fully interactive. Redirection of input/output is
neither necessary nor recommended.


(1) New Title and/or Molecule
    Here you can edit a project title. You can leave it empty, if you want.
    Afterwards you are queried about a new molecule. If you answer positively
    and the new atom number is not smaller than the old one, you can keep
    the old topological matrix and hetero atom information. Otherwise
    all information is erased.
    After finishing you automatically find yourself in menu item (2).

(2) Edit the topological matrix
    This matrix contains information about bonds between atoms.
    You can easily enter new ones or erase old bonds. It can be wise to draw
    a molecule sceleton before, and to provide atomic numbers.
    Defining a ring or a chain only makes sence if the atomic indices in the
    ring or in the chain are succeeding (e.g. benzene, annulene, butadiene).

(3) Hetero Atoms
    This menu item allows input of hetero atoms. At the moment I have provided  
    only data for N and O (1 and 2 pi electrons in each case). Typical
    examples are: 
    - Pyridine with N as one-pi-donor
    - Aniline, pyrrol, and indol with N as two-pi-donor
    - Benzophenone and acroleine with O as one-pi-donor
    - Furane, anisole and di-vinyl-ether with O as two-pi-donor
    - Fluorine, Chlorine, and Bromine (single bonded)
    A chemical bond between two hetero atoms is not provided.
    The statistics shows all defined hetero atoms and their corrective
    parameters for the Coulomb integral (alpha -> alpha + delta alpha), 
    and the resonance integrals (beta -> beta * factor).
    
(4) Solution of the eigenvalue equation
    This is a very passive menu item. All you have to to is to wait, until
    your computer has solved the eigenvalue problem. Since this is a N^3
    procedure (N denoting the number of basis functions), large molecules
    demand for your patience. In the mean time you can have a cup of 
    coffee/tea or read about the Givens/Householder diagonalization.

(5) MO occupation numbers
    Within this menu item you can specify the occupation numbers either
    automatically via the Aufbau principle or manually.
    For the first way you only need to know the charge of the molecule,
    which gives the total number of electrons. The occupied orbitals are
    selected according to increasing energy. In case of degeneracy the
    remaining electrons are divided among the degenerate orbitals.
    If you chose the second way, you are asked for the occupation numbers
    for each MO in increasing order. You can end this procedure prematurely
    by specifying a negative occupation number.
    After finishing the density matrix (bond orders) and the free valences 
    are calculated.

(6) Output on the screen
    The program prints the energies, the occupation numbers and the 
    corresponding coefficient vectors for all MOs onto the screen. 
    Afterwards you may read the total energy and the resonance 
    stabilization (if hetero atoms are absent) in comparison to ethene 
    units. The succeeding bond orders are calculated according to the
    Mulliken population analysis. (In the Hueckel scheme this is just
    the AO density matrix.) 1.0 denotes a complete, ethene-like pi-bond.
    The diagonal elements of this matrix mean the atomic populations.
    From those the atomic partial charges are calculated and printed, too.
    The free valence of an atom is a very crude estimate about its 
    reactivity or its unsaturatedness. 
    At any time of the output procedure you can stop it by pressing 'q' or
    ESC. You can halt it by CTRL-s and continue by CTRL-s.

(7) Output on printer or file
    Here the results are given on a line printer (parallel port) or written
    onto a disk file in ASCII format for later editing. You can choose
    whether if you prefer output of the toplogical matrix and the hetero
    atoms data, too. 
    If you specify an existing file (e.g. MOLECULE.DAT) the data are appended
    instead of overwritten.
    
(8) Draw a MO diagram
    This is a very simple drawing subprogram to render a simple MO level
    diagram. If you current system environment does not allow direct
    Line A calls or you are not in the high resolution mode, you are 
    not recommended to call this menu item.
    After drawing you are able to save the graphics (in screen format) 
    or to send it directly to an attached printer via the (Scrdmp-Function).

(i) Input from control file
    The program provides a simple interface to files which describe
    molecules and what you have calculated for them. You are encouraged 
    to view such files via a normal ASCII editor and to modify
    its contents (especially the topological matrix). 
    All these control files should end with .CTL and should reside in a
    subdirectory called INPUT. In this case it is only necessary to give
    the file name without the extension.
    This menu item is able to read such a file and to interpret its data
    groups. You are told about the reading process. If MO vectors and
    occupation numbers are found, the density matrix is calculated 
    automatically.
    
(o) Output to control file
	This is the counterpart to (i). The total current information is 
	being written onto control file.

(h) HELP
    This is a tiny version of the UNIX "more" command to view a file.
    You can utilize the following keys:
    - <SPACE> scroll downwards one screenfull
    - b       scroll backwards one screenfull
    - q       leave HELP mode
    - others  proceed by one line
    
(0) END
    
    
Suggestions:
- Confirm the Hueckel 4n+2 rule!
- Why is naphthalene more reactive at its alpha position than at beta?
  Try to simulate the transition state by an intermediate!
- Follow the HOMO-LUMO separation in conjugated polyene chains!
- Where are the most reactive sites in anthracene and phenanthrene?
  Answer these questions with the bond orders and free valences!
- Does Azulene posess a dipole moment?


--- END ---



