We can offer you the DOS/Windows3.1 binaries of 

                                 ICON-EDiT

                          an Extended-Hueckel and 
                     Oscillator Strength Calculation
                                  Package

            by Gion Calzaferri, Ruedi Rytz, and Martin Braendle

               Institute for Inorganic and Physical Chemistry
                  Freiestrasse 3, 3012 Berne, Switzerland

                         Copyright by the Authors

--------------------------------------------------------------------------------

   THE FULL VERSION FOR IBM RS/6000 AS WELL AS FOR DOS/WINDOWS ALONG WITH A
   DETAILED MANUAL WILL BE MADE AVAILABLE BY MARCH 1996. IT WILL BE DISTRIBUTED
   ON DISKETTES TO A PRICE OF US$ 60 TO COVER OUR EXPENSES. YOU CAN ODER IT BY
   SENDING A FAX TO PROF. DR. G. CALZAFERRI (FAX: +41 31 631 39 94). DO NOT
   FORGET TO INCLUDE YOUR SHIPPING ADDRESS.

--------------------------------------------------------------------------------


CONTENTS OF THIS FILE

1) What is ICON-EDiT?
2) What does the distribution contain?
3) How do I install the package?
4) How do I run ICONC?
5) How do I run EDiT?
6) What are the requirements of your PC?
7) References


1) What is ICON-EDiT?

ICON-EDiT is a FORTRAN program package that performs extended-Hueckel and 
oscillator strength calculations on molecules.

s,p,d orbitals, a two-body repulsive energy term, different Wolfsberg-Helmholz
formulas, charge iteration procedures, geometry variation and an FMO option are
included.

ICON-EDiT consists of three parts, INPUTC, ICONC, and EDiT.


INPUTC

The INPUTC part of the package is a self-explanatory input program. It reads
the necessary parameters such as the valence orbital ionization energies
(VOIEs), the Slater-type orbitals (STOs) as well as the charge-iteration
parameters from the ASCII data files ATOMDEF.DAT, VOI.DAT, and FOI.DAT in order
to generate the file SOMENAME.KAR (Cartesian coordinates) or SOMENAME.GEN
(internal coordinates with geometry variation). As ICONC is designed to work
with Cartesian coordinates, the previously generated internal coordinate file
SOMENAME.GEN can be converted to a Cartesian file named TEMP.KAR (cf. INPUTC
Option #3). The parameter files may be extended and/or adapted to meet the
requirements of the user.


ICONC

ICONC performs extended-Hueckel calculations on files created by INPUTC.


EDiT

EDiT allows to calculate oscillator strengths of electronic dipole-induced
transitions (EDiTs) based on Slater-type extended-Hueckel wave functions.


ICON-EDiT runs on  PC, VAX, IBM RISC and many more. No machine specific 
specialties have been included.


2) What does the distribution contain?


PROGRAMS

The 32-bit binaries of INPUTC, ICONC, and EDiT compiled by MICROSOFT FORTRAN
PowerStation are distributed along with the appropriate DOS (DOSXMSF.EXE) and
Windows (DOSXNT.386) extender programs.


PARAMETER FILES

The parameter files are

  o ATOMDEF.DAT containing the atom symbols, the number of valence electrons,
    the quantum numbers of the orbitals, the corresponding Slater exponents,
    and the Coulomb integrals. For most of the main group elements the quantum
    number ND has been set equal to zero. A quantum number of zero means that
    the corresponding atomic orbital is skipped. To include d orbitals ND = 0
    has to be substituted with ND = 3, 4 or 5 depending on the period to which
    the atom belongs.

    Special notation: atomic symbols followed by M, -, 1, 2 or 3 have the
    meanings: metal, anion, cation, higher oxidation states.

    Be careful! It is always wise to check whether the parameters are well
    suited to your problem.

  o VOI.DAT and FOI.DAT containing the charge iteration parameters for main
    group and transition elements, respectively.


INPUT FILES

Some ready to use example files are

 o for ICONC (Cartesian coordinates)

   - BIPY.KAR
   - H2O.KAR
   - GLYCIN.KAR
   - NICO4IT.KAR (with charge iteration)

 o for ICONC (internal coordinates)

   - BENZENE.GEN
   - H2.GEN (with variation; after calculation cf. ENERTOT.DAT, ENERNI.DAT)
   - CH4.GEN (with variation and MOBY output, cf. ch4.mo)
   - PROPEN_F.GEN (FMO calculation)


 o for EDiT calculations

   - MNO4-.GEN
   - MNO4-.EDI
   - MNO4-.MO


For comparison the following output files are included

 o for ICONC

   - BIPY.OUT
   - H2O.OUT
   - GLYCIN.OUT
   - NICO4IT.OUT
   - BENZENE.OUT
   - H2.OUT
   - CH4.OUT
   - PROPEN_F.OUT
   
 o for EDiT

   - MnO4-.EDO
   - MnO4-.EDS


3) How do I install the package?


You may wish to copy all distributed files to your hard disk in a directory
called C:\ICONEDIT. Unpack the two archives by typing

  PKUNZIP *.ZIP

Under DOS you are ready to go. However, if you plan to use the programs under 
Windows (DOS Shell) you should install the 32-bit extender program DOSXNT.386 
by adding the line

  DEVICE=C:\ICONEDIT\DOSXNT.386

to the [Enh386] section of your SYSTEM.INI file. If you wish to copy the files
to different directories to meet your requirements you are encouraged to do
so.  However, make sure that the 32-bit DOS extender DOSXMSF.EXE can be loaded
and do not forget that INPUTC needs to open ATOMDEF.DAT, VOI.DAT, and FOI.DAT.
EDiT will use the files SOMENAME.GEN, SOMENAME.MO, and SOMENAME.EDI as its
input.


4) How do I run ICONC?

For input files that are already in Cartesian coordinates (files with the
extension KAR) simply type at the DOS prompt

  ICONC < SOMENAME.KAR > SOMENAME.OUT

(If you wish to keep the distributed output files for comparison make sure 
you do not overwrite them by choosing a different name.)

ICONC will read the input from SOMENAME.KAR. Its output will be written to
stdout (the standard output device). You may wish to redirect it to a file
( > SOMENAME.OUT).


Input files that are in internal coordinates have to be converted to Cartesian
coordinates prior to running ICONC. You do this with INPUTC. Type INPUTC at the
DOS prompt and choose option #3. Follow the instructions of the program. If you
are done you should notice two new files in your working directory, namely
TEMP.KAR and TEMP.VAR. (The TEMP.VAR file is written to check that geometry
variation has succeeded, you needn't care for the moment.) Then type

  ICONC < TEMP.KAR > SOMENAME.OUT


5) How do I run EDiT?


In order to run EDiT you need to have the files SOMENAME.GEN, SOMENAME.MO, and
SOMENAME.EDI. If you don't know what the GEN files are about refer to section
1. The file SOMENAME.MO can be written with the ICONC program by choosing the
appropriate output option in the INPUTC program. (Originally, we introduced the
*.MO files to meet the requirements of the molecular modeling package MOBY by
Udo Hoeweler, Springer Verlag, Berlin 1993. We then found it convenient for the
EDiT program as well.) To do so answer the question in INPUTC "Do you want to
define additional parameter? [N]" with Y. Choose option #2 "Controlling output
options". MOBY output is then requested by choosing #22. Now you are ready to
run ICONC as described in section 4. MOBY output is then dumped to
SOMENAME.MO.  The file SOMENAME.EDI has to be prepared separately with an ASCII
editor. Check the file MnO4-.EDI in this distribution and comments made therein
to get an overview of possible KEYWORDS that are controlling EDiT output. Run
the program from the DOS prompt by typing

  EDiT < SOMENAME.EDI > SOMENAME.EDO

(Note: On DOS Machines the name EDiT may interfere with the DOS EDITOR, you may
wish to rename EDiT to EDiTOR, Electronic Dipole-induced Transitions by Slater-
type ORbitals.)


6) What are the requirements of your PC?

ICON-EDiT runs on PC i386 and higher. As all declared data must load into
memory at startup, a compromise between the desire to treat as large systems
as possible and the memory requirement had to be made. We decided to compile
ICON-EDiT for 100 atoms and 400 AOs. This allows to run the program on a
machine with 16 Mb of built-in RAM without needing to access virtual memory. If
you have less RAM available it is still possible to run ICON-EDiT by allowing
the program to page out parts of the memory to the hard disk (pageing).
Virtual memory management is considerably different under DOS and Windows3.1.
Under DOS the virtual memory is managed by Phar Lap DOS extender. Disk space
will be used on the drive where DOSXMSF.EXE is located. This will NOT WORK on a
compressed drive. Hence, if you use DriveSpace you will have to relocate your 
swap file by adding something like

  SET DOSX=-SWAPDIR X:\TMP 

to AUTOEXEC.BAT. If you run the programs under Windows3.1 in a DOS shell,
Windows will take care of your swap file. The size can be adjusted by starting
the Control Panel application and selecting the 386 Enhanced icon. HOWEVER, WE
STRONGLY RECOMMEND NOT TO USE THE PROGRAMS WITHIN Windows.


7) References

for 

  o ICONC
    - G. Calzaferri, L. Forss, and I. Kamber, J. Phys. Chem., 93 (1989) 5366
    - G. Calzaferri and R. Hoffmann, J. Chem. Soc. Dalton Trans., (1991) 917 
    - M. Braendle and G. Calzaferri, Helv. Chim. Acta, 76 (1993) 924
    - G. Calzaferri and C. Marcolli, J. Phys. Chem., 99 (1995) 3895

  o FMO
    - L. Libit and R. Hoffmann, J. Am. Chem. Soc., 96 (1974) 1370

  o EDiT
    - G. Calzaferri and R. Rytz, J. Phys. Chem., 99 (1995) 12141


Enjoy using this package

Ruedi Rytz and Gion Calzaferri