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)