OnWorks favicon

mpb-data - Online in the Cloud

Run mpb-data in OnWorks free hosting provider over Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator

This is the command mpb-data that can be run in the OnWorks free hosting provider using one of our multiple free online workstations such as Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator



mpb-data - transformations of HDF5 files output by MPB


mpb-data [OPTION]... [HDF5FILE]...


mpb-data is a utility to perform additional processing and transformations of HDF5 files
output by MPB, the MIT Photonic-Bands program. In particular, it is designed to make the
output more amenable to visualization by reformatting it into a rectangular grid,
extending it to multiple periods, and rescaling the data.

MIT Photonic Bands (MPB) is a free program to compute the band structures (dispersion
relations) and electromagnetic modes of periodic dielectric structures.

HDF5 is a free, portable binary format and supporting library developed by the National
Center for Supercomputing Applications at the University of Illinois in Urbana-Champaign.
A single h5 file can contain multiple data sets; by default, mpb-data operates on all of
the MPB-produced datasets in the file, but this can be changed via the -d option, or by
using the syntax HDF5FILE:DATASET.

mpb-data writes its output datasets as additional datasets in the input file(s), with
"-new" appended to the dataset names. Alternatively, it can write its output to a
separate file, specified by the -o option.

Note also that, by default, the output datasets are identical to the input datasets; you
must use one or more of the options below to specify a transformation (e.g. the -r/-e and
-n options are very useful).


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

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

-v Verbose output.

-o file
Write output datasets to file (for the first input file only) rather than as
additional datasets in the input file(s) (the default).

-r Output a rectangular cell with the same volume as the cell of the input data. This
option is particularly useful for visualizing data from non-orthogonal unit cells
(e.g. a triangular lattice), as otherwise the data will appear skewed or warped in
most graphics programs. This option should almost always be accompanied by the -n
option to ensure a uniform resolution.

-e x,y,z
As the -r option, but also make the first axis of the output along the x,y,z
direction (in Cartesian coordinates) instead of along the first lattice vector as
for -r.

-P phaseangle
For complex-valued datasets, this option causes the output values to be rotated by
phaseangle degrees in the complex plane. That is, they are multiplied by exp(2 pi
i phaseangle / 360).

-n n Output n grid points per lattice unit ("a"). This is useful not only for
interpolating to finer (or coarser) resolutions, but also to ensure that the
resolution is uniform in each direction (to prevent the data from looking distorted
when you visualize it).

-x mx, -y my, -z mz
This tells mpb-data to output multiple periods in the corresponding lattice
directions. to use a particular slice of a two- or three-dimensional dataset.
e.g. -x 3.2 causes the output of 3.2 periods in the first lattice direction. The
default is to output only a single period.

-m s Output s periods in each lattice direction; equivalent to: -x s -y s -z s.

-T The output has the first two dimensions (x and y) transposed. This is useful in
conjunction with the parallel (MPI) version of MPB, which for performance reasons
outputs all arrays with the first two dimensions transposed. -T can undo this

-p Pixellized output. Normally, the input data is linearly interpolated to the output
grid, but the -p option causes it to instead use the nearest grid point in the
input data. This is useful, for example, if you want to study the discretization
of the dielectric-function representation.

-d name
Use dataset name from the input files; otherwise, the first dataset from each file
is used. Alternatively, use the syntax HDF5FILE:DATASET, which allows you to
specify a different dataset for each file. You can use the h5ls command (included
with hdf5) to find the names of datasets within a file.

Note that this option is generally unnecessary, since mpb-data can already find the
relevant dataset(s) for files created by MPB. Also, note that mpb-data treats the
dataset specified by this option as a real scalar dataset and does not include the
exp(ikx) factors when extending the dataset to multiple periods.

Use mpb-data online using onworks.net services

Free Servers & Workstations

Download Windows & Linux apps

  • 1
    rEFInd is a fork of the rEFIt boot
    manager. Like rEFIt, rEFInd can
    auto-detect your installed EFI boot
    loaders and it presents a pretty GUI
    menu of boot option...
    Download rEFInd
  • 2
    ExpressLuke GSI
    ExpressLuke GSI
    This SourceForge download page was to
    grant users to download my source built
    GSIs, based upon phhusson's great
    work. I build both Android Pie and
    Android 1...
    Download ExpressLuke GSI
  • 3
    Music Caster
    Music Caster
    Music Caster is a tray music player
    that lets you cast your local music to a
    Google Cast device. On the first run,
    you will need to click the arrow in your
    Download Music Caster
  • 4
    PyQt is the Python bindings for
    Digia's Qt cross-platform
    application development framework. It
    supports Python v2 and v3 and Qt v4 and
    Qt v5. PyQt is avail...
    Download PyQt
  • 5
    Sardi is a complete restyling and
    optimisation of svg code. 6 choices for
    your applications and 10 kind of folders
    to use in your file manager. The sardi
    Download Sardi
  • 6
    LMMS Digital Audio Workstation
    LMMS Digital Audio Workstation
    LMMS is a free cross-platform software
    which allows you to produce music with
    your computer. If you like this project
    consider getting involved in the project
    Download LMMS Digital Audio Workstation
  • More »

Linux commands