Modeig98 On-Line Reference

Modeig98 User Manual

Below is the index for the User manual. The links in the index will take you to the given section. The sections are located just below this index. (i.e. you can scroll down to browse through the manual).

  1. Introduction / About MODEIG98 - General Description
  2. Improvements / Modifications from the Last Version
  3. Installation
  4. Using MODEIG98
  5. Using the Utilities
  6. The Design Process
  7. Input Files
  8. Output Files
  9. Examples
  10. Discussion on Complex Refractive Indices
  11. Error Codes
  12. FAQ: Frequently Asked Questions
  13. Credits
  How to use this Manual
  Web Page Additions/Changes
  More about Modeig Calculations
  Modeig98 User Manual ...
  Modeig/II User Manual
  What's New
  Frequently Asked Questions
  Information about current Beta
  Material Systems Introduction
  System Requirements
  Contacting the Authors
  Example Files
  Modeig98 GUI Preview
  More about Front-ends...
  Last Updated: 07-15-98 ... ... (more below) ... ...


Introduction / About MODEIG98
  This is the introduction that will be prepared by Dr. Evans and myself. This introduction should include a good deal of theory????????????????????????????????????????????????????????????????????
Improvements/Modifications from Last the Version (What's New in Modeig98)
  The MODEIG98 update encompasses converting the program code to the FORTRAN 90 programming language thereby enabling cross platform compatibility, the addition of subroutines to calcualte the index of refraction for a variety of materials systems and the ability to accept input files with up to 100 layers.

  • Modified Command Line Interface
  • File based interface that will provide the ability to use/create other front-end interfaces for modeig98. Currently available are a Windows based front-end as well as UNIX and DOS script/bat files to provide command line functionality
  • The integration of the program to convert the *.ly file to an index profile file (*.ip).
  • The addition of On-line help information
  • Viewing of an example input file
  • MODEIG98 Viewer
  • MODEIG98 will remember the last used active input and output files
  • Addition of on-line command summary
  • The integration of the Overlap program (calculates the overlap integral for multiple near field files.)
  • The addition of other material systems including:
    • InGaAsP
    • AL2O3
    • AlGaInP
    • AlGaInAs (lattice-matched)
    • AlGaInAs (lattice-mismatched)
    • GaAsP
    • GaInP
    • InGaAs
    • InGaAsP (lattice matched to InP)
    • Si
    • SiO2
  • The increase in the number of layers that MODEIG can handle from 40 to 100 layers.
  • Input files are no longer case sensitive.

  • Input files can be named *.m98
  • Output file extensions modified to the following:
    • Output file: *.ot
    • Layer file: *.ly
    • Database file: *.db
    • Nearfield file: *.nf
    • Farfield file: *.ff
    • Index Profile file: *.ip
    • Overlap Output file: *.ovp
  • 2-D input files are no longer supported.
  • Invalid/Outdated input flags:
    • The following flags for the CASE statement are no longer valid.
    • The following flags for the STRUCT statement are no longer valid.
    • The following flags for the LAYER statement are no longer valid.
    • The following flags for the OUTPUT statement are no longer valid.
    • The following flags for the LOOPZ statement are no longer valid.
      (ALPERC1**, ALPERC2**, ALPERC3**, ALPERC4**)
  • ** ALPERC (STRUCT & LAYER) input flag replaced with MATSYS, XPERC and YPERC flags. This was done to support multiple material systems.

  • MODEIG98 is a 32-bit program. To run MODEIG98 on a PC, the user will need Windows95, WindowsNT or win32s.
  • Verify that you have downloaded the correct file for your operating system. (XX refers to the version number)
    UNIX based Alpha mod98uXX.tar.gz
    Macintosh mod98mXX.hqx
    Mac PowerPC mod98pXX.hqx
  • Use the uncompression program for your operating system to uncompress the files into the given directory. The suggested directory is 'C:\modeig98'. This is suggested for pc users to better interface the Windows GUI. (NOTE: If at all possible, DO NOT use any directory whose name is longer than 8 characters for the PC!)
    Win95,WinNT,win32s Pkzip 2.0 / Winzip
    UNIX based Alpha gzip and tar
    Macintosh stuffit
    Mac PowerPC stuffit
  • Verify that the correct files have been uncompressed into the desired directory. Files that should be included in the distribution are as follows; (if any files are missing, please see the comment page on how to contact the authors.
    Win95,WinNT,win32s UNIX based Alpha Macintosh Mac PowerPC
  • That is it! The modeig98.exe (for PC) or modeig98 (for UNIX-alpha or Macintosh) is the program - execute it to start.

For more information on running the program, associated files, etc. type 'help' at the modeig98 prompt.

Using MODEIG98
  Information pertaining to using Modeig98 is presented in the sub-sections below.
  • The MODEIG98 user interface was desigend to mimic a command line entry system. In MODEIG98, the commands either; 1. Modify the active filenames, 2. Operate on the active files or 3. Display information.
  • The active file names will always be displayed directly above the MODEIG98 prompt.
  • Commands are not case sensitive, but filenames could be case sensitive depending on the operating system.
  • Typically, the user should only need to type the first 4 letters of any given command.
COMMANDS This will display a short list of available commands.

USAGE: commands
HELP This will display the help file , using the MODEIG98 Viewer.

USAGE: help
ABOUT This will display an about file using the MODEIG98 viewer. Basically a file containing program title authors and version information.

USAGE: about
EXAMPLE This will display a well documented input file using the MODEIG98 viewer.

USAGE: example
VIEW MODEIG98 Viewer. This will display the file specified. Once view has been successfully started, the following commands can be used to navigate through the file;

[return] - advance 23 lines (one screen)
b[return] - return to the top of the file (lines 1-23).
q[return] - quit viewer and return to the MODEIG98 prompt.

USAGE: view [filename]
EDIT A command that has been left in from the old MODEIG/II version for backward compatibility. See the MODEIG/II documentation for more information.
INFILE This command will modify the active input file name and optionally the output file prefix (no extension - all output file names will be this prefix with a designated extension). If the output file prefix is not included, it will be set to the input file prefix.

USAGE: infile [infilepfx].m98 ([outfilepfx])

where: [infilepfx] is the input file prefix
[outfilepfx] is the output file prefix

example1 : 'infile file1.m98'
results in: infile=file1.m98 outfile=file1

example2 : 'infile file2.m98 file3'
results in: infile=file2.m98 outfile=file3
OUTFILE This command will modify the active output file prefix (no extension - all output file names will be this prefix with a designated extension)

USAGE: outfile [outputfileprefix]

example1 : 'outfile file1'
results in: outfile=file1
EVAL This command will read the active input file and evaluate it - creating the output files that are requested in the input file.

USAGE: eval
LAYER This command will read the active input file and determine the layer information (same info that would be found in the layer file) and writes it to a temporary file (m98layer.tmp) then uses the modeig98 viewer to display the information.

USAGE: layer
PROFILE This command will read the active input file, determine the layer information in the same manner as the layer command, then writes out the profile file which conatins a description of the index profile of the structure. The output file will be [outputfileprefix].ip

USAGE: profile
OVERLAP This command will compute the overlap integral of multiple near field files vs. one reference near field file.

USAGE: overlap [reference-file].nf

Then the user will be prompted to enter from 1 to 20 near field files to compare with the reference file. If the user wishes to cancel the operation, then they can enter '!' instead of a file name. If the user wishes to continue the operation, then after entering all the files that they desire, then can enter a '.' to complete the file list. At this point, the program will compute the integral and output the results into a file called

CRICKET This option toggles the print cricket graph character on and off. If on, then Modeig98 will place a '*' as the first and only character on the first line of the *.db, *.nf, *.ff files. This will allow cricket graph to read the column labels from the file.

USAGE: cricket
QUIT Quits program

USAGE: quit
EXIT Quits program

USAGE: exit
  An Example of how to evaluate an input file
  • After starting modeig98, select the active input file using the infile command:

    [infile=default.m98 outfile=default]
    modeig98> infile myfile.m98

  • The infile and outfiles will be modified to display your active input file:

    [infile=myfile.m98 outfile=myfile]

  • If you want to change the output file prefix, you can use the outfile command:

    [infile=myfile.m98 outfile=myfile]
    modeig98> outfile new

  • The outfiles will be modified to display your active output file prefix:

    [infile=myfile.m98 outfile=new]

  • Then to evaluate the input file, use the eval command:

    [infile=myfile.m98 outfile=new]
    modeig98> eval
  Output Files
*.db Database file
*.ot Output file
*.ly Layer file
*.nf Near Field file
*.ff Far Field file
*.ip Index Profile file
*.ovp Overlap Integral file
  Associated Files
modeig98.exe - modeig program
m98help.txt - this help file
m98about.txt - about modeig98 file
m98layer.tmp - temporary file for layer and profile commands
modeig98.cfg - modeig98 configuration file (do not modify, as changes may be overwritten)
m98examp.txt - Example input file (for example command)
6. Using the Utilities
  Overlap Integral Utility
  Material Systems Utility
  Index Profile Utility
  BAT/Script File Utilities
  Windows GUI Front End
  Details for Creating alternate Front End User Interfaces
7. The Design Process
8. Input File
9. Output Files
10. Examples
11. Discussion on Complex Refractive Indices
12. Error Codes
13. FAQ: Frequently Asked Questions
14. Credits