Curves Image

   Home | Projects | People | Opportunities | Calendar | Register | Search    

NIST Materials Science and Engineering Laboratory / NIST Center for Theoretical and Computational Materials Science  
  NIST Home Page
CTCMS watermark


Basic Program Features
Software Archive
Bug Information
Disclaimer and Copyright

Software Archive


Wulffman is available both as a binary file and as source. Binaries are only available for some platforms; more may be made available in the future. Binary implementation uses the Qhull algorithm for hull construction and libraries are statically linked. Source code is written in C++, hence compiling from source requires a C++ compiler. Usage of the source codes could allow dynamic linking.

Downloading Software

Click the appropriate link to download the desired version of the software. Binaries are available as compressed files; source is available as a compressed tar file.

Wulffman version 1.0:

Wulffman version 1.2.4:

The major changes between V1.0 and V1.2 are:
  • Intersection of Wulff shapes.
  • Automatic calculation of surface area and volume.
  • PostScript printing of "flattened" Wulff shapes.
The changes between V1.2.1 and V1.2.2 allow Wulffman to be built using Xforms V0.86 and V0.88.

The only change between V1.2.2 and V1.2.3 is to allow the use of Miller indices when specifying facet orientations. You can now triple-toggle between [XYZ] for cartesian coordinates, [UVW] for unit cell coordinates, and [HKL] for Miller indices.

1.2.4 made some changes to help in compiling under Linux systems, and fixed two small bugs. 1.2.5 fixes one bug that lets it compile with gcc: source only.

1.2.5p1 patched the source tree to simplify building on gcc4 compilers on more recent Linux distros.


In order to run Wulffman , several pieces of software should be installed on your system. Below is a checklist of the software packages needed. Any optional software packages are indicated as such.

  1. Geomview: 3-D visualization package
  2. Xforms: The X form library used in Wulffman
  3. Qhull: Convex hull construction routines (optional, but highly recommended)
  4. Wulffman: Actual source or binary code for Wulffman The installation for each of these packages is detailed below.

    Geomview Installation

    The user is referred to the relevant section of the Geomview web site for installation and downloading instructions for Geomview.

    Xforms Installation

    XForms 1.0 was released under LGPL, but is difficult to find on the WWW, so for your convenience: libforms1_1.0.tar.gz If you don't like source, you can try to download the Xforms library in binary format for the platform of interest from the Xforms web site . Uncompress and extract the Xforms archive and follow the instructions in README.txt for installation.

    NOTE: You must use version 0.81 with Wulffman V1.0: v0.86 and later will not work! 0.81 doesn't appear to be available for download any more, so unless you have a copy stashed somewhere, you'll have to use a newer version of Wulffman.

    For Wulffman V1.2.2+, any version of XForms (0.81, 0.86, 0.88, or 1.0) should work.

    Qhull Installation

    Qhull is a service routine used by Wulffman to build the convex hull of facets, and hence the Wulff shape. The algorithm used by Qhull has proven highly efficient, and unless the user wishes to hack the Wulffman source and provide a convex hull algorithm that is more efficient than the current implementation (slow compared to qhull), installing Qhull is highly recommended. Qhull instllation instructions can be found at the Qhull web site.

    Wulffman Installation

    Wulffman is available in binary distribution for several platforms (see Versions ) or in source form. If your platform corresponds to one of those available in binary distribution, it is recommended that you directly install the binaries. If your platform is not supported, you should download the source and follow the source installation instructions. Any text preceded by a '%' or in italics corresponds to commands types on the UNIX command line.
    • Installation of Binary Distribution:
      1. Download the binary distribution for your platform

      2. Uncompress the Binary:
        % uncompress archive_name
      3. Install Wulffman as a Module to Geomview

    • Installation from source codes: (requires C and C++ compilers)
      1. Download source code
      2. Extract the source archive:
        % zcat wulffman_source.tar.Z | tar xvf -
        % cd wulffman
      3. Modify Makefile to reflect library locations, platform-specific compiler flags, ...
      4. Compile Codes:
        % make depend % make wulffman
      5. Install Wulffman as a Module to Geomview

    Center for Theoretical and Computational Materials Science, NIST
    Questions or comments:

NIST is an agency of the U.S. Department of Commerce

Last updated: Sep 29, 2002