Wulffman
Documentation




Table Of Contents





Running Wulffman


Wulffman is a module to be used with Geomview, a 3-D visualization environment written by the Geometry Center at the University of Minnesota. The best way to learn how to use Wulffman is to experiment; it won't bite! The basic procedure for running WUlffman is as follows:

  1. Start Geomview
  2. Within the Modules panel of the Geomview window, click on Wulffman . The Wulffman control window should become visible.
  3. Open the Symmetry Tool and select a point group.
  4. Open the Facet Tool and enter some facets of interest
  5. Click Go in either the Control or Facet Windows. The Wulff shape should be generated and output to Geomview.
For a description of the details of Wulffman, read the documentation below, or use the on-line Help contained in each Wulffman window. The HTML documents and those contained within the program contain the same content, although there are no graphics within the program Help.




Basic Program Features


Overview

Wulffman is designed to construct the global Wulff shape that results from the intersection of one or more constituent Wulff shapes. The Global Shape Window in Wulffman is used to spawn, close, or destroy all of the windows associated with each sub-shape. Each individual sub-shape has its own set of specifications (Symmetry, Facets, Preferences,...) each of which is controlled by a distinct set of windows. The actual Wulff shape displayed by Geomview can then be either one of the individual sub-shapes or the intersection of any subset of all possible sub-shapes. A schematic representation of the relationship between the global window and all of the individual windows is shown below.


Window interrelationships in Wulffman. The Global Shape Window (top) control the existence of all sub-shape windows (Labeled windows 1, 2, and n for convenience).

Layout

The basic layout of the program invovles separation of the primary functions of the code into "Tool" windows and "Information" windows. Tool windows contain tools that the user can use to manipulate the program. Information windows contain information about selected aspects of each of the tools. Each primary window contains a colored field in the upper left portion of the window indicating its name.

Buttons

Normal
These buttons perform a simple function when pressed and do not remain active after their selection. An example of a normal button is the Close button present in all windows.
Toggle
These buttons control Wulffman's tool and information windows. When a toggle is activated, it changes color and the desired window is opened; closing the window acts to release the toggle, as does pushing the toggle while the window is active. Most of the buttons in the Main Window are toggles.
Exclusive
"Exclusive" buttons are used to select between a group of mutually exclusive options. When an exclusive button is active, it is colored, and selection of other buttons within its group automatically deactivates it. An example of this can be found in the selection of crystal systems .

There are two buttons that are used throughout the application: the Close and Help buttons. Close acts to close the window in which it is pressed, usually activating a toggle in the Main Window . The Help button brings up help about the features of the window in which it is pressed; global help is available by pressing Help in the Main window.

Data Fields

There are several instances where the user is presented with data fields that can be edited. Instances of editable data fields occur in the Facet Tool, Custom Tool, Matrix Info, and Coord Xform windows. An editable data field appears as a "down" box, and clicking on it with the mouse generates a cursor. Normal keystrokes and cursor movement commands then function within this field. Some data fields are not always editable by the user. These fields are represented by simple flat boxes around the data in question (see Coord Xform for an example). Clicking on these fields will have no effect .


Meta Window


This window controls all the Wulff shapes at once. It allows you to create new shapes, duplicate existing ones, and delete shapes. It also controls the intersection of shapes and provides statistics about the shape being shown by Geomview. The five buttons at the top of the window function as follows:

Information can be found in the Statistics section about the displayed shape including the surface area, contained volume, and the total numbers of facets, edges, and vertices displayed by Geomview. Note that Euler's theorem governs the relationship between these three quantities: v - e + f = 2.

At the bottom of the window is a list of all the shapes which will be intersected to form the final shape. For most applications, only one Wulff shape will be examined. Each shape is described with one line on the form. From left to right: