NAME

       mpb - compute eigenmodes of periodic dielectric structures

SYNOPSIS

       mpb [OPTION]... [DEFINITION]... [CTLFILE]...

DESCRIPTION

       MIT  Photonic  Bands  (MPB)  is  a free program to compute the band structures (dispersion relations) and
       electromagnetic modes of periodic dielectric structures, and is  applicable  both  to  photonic  crystals
       (photonic  band-gap  materials)  and a wide range of other optical problems. Its features include: fully-
       vectorial, 3D computations; a flexible user-interface based upon the GNU Guile scripting language; output
       in HDF format; and iterative, targeted eigensolver methods to address very large problems by solving  for
       only a few states near a specified frequency.

       More  information  on  MPB,  including  a  detailed  manual,  can  be  found online at the MPB home page:
       http://ab-initio.mit.edu/mpb/

       A typical invocation of MPB looks like:

           mpb foo.ctl >& foo.out

       This causes MPB to process the control file foo.ctl and redirect its output to foo.out.   (One  typically
       redirects  output  to  a file, as the output is verbose and contains a number of comma-delimited datasets
       that one can extract by grepping.)

       You can also use MPB in an interactive mode, in which you can type in MPB commands (in Scheme/Guile)  and
       immediately see their results.  Interactive mode is entered when you invoke mpb with no control files, or
       if  your  control files don't contain any run statements (which disable interactive mode), or if the last
       control file ends by setting (set! interactive? true) in which case interactive mode is entered after the
       control files execute.

       Another useful feature is that you can alter parameters in your control files from the command  line,  by
       including  definitions  of  the form variable=value as arguments to mpb (before the control files).  This
       overrides the values of variables defined with define-param in the control file  (including  all  of  the
       predefined MPB input variables).

       Multiple  control  files and definitions are executed in sequence, in the order they are specified on the
       command line.

OPTIONS

       -h, --help
              Display help on the command-line options and usage.

       -V, --version
              Print the version number and copyright info for mpb.

       -v, --verbose
              Verbose output.

BUGS

       Send bug reports to S. G. Johnson, stevenj@alum.mit.edu.

AUTHORS

       Written by Steven G. Johnson.  Copyright (c) 1999-2012 by the Massachusetts Institute of Technology.

SEE ALSO

       mpb-split(1), mpb-data(1)

MPB                                             January 27, 2000                                          MPB(1)