Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
MPB(1)			  MIT Photonic-Bands Package			MPB(1)

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	struc-
       tures (dispersion relations) and	electromagnetic	modes of periodic  di-
       electric	 structures, and is applicable both to photonic	crystals (pho-
       tonic 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  fre-
       quency.

       More  information on MPB, including a detailed manual, can be found on-
       line 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.   In-
       teractive 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 vari-
       able=value  as arguments	to mpb (before the control files).  This over-
       rides 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 Massachu-
       setts Institute of Technology.

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

MPB			       January 27, 2000				MPB(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | BUGS | AUTHORS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=mpb&sektion=1&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help