Installation of FLUDViz: UNIX Source

Requirements
and
Implementation

The Unix distribution for FLUDViz in source code format requires certain supporting software. FLUDViz -
  • depends on common Web Metrics resource code; you must install these resources before compiling the FLUDViz source.
  • is written in standard C; therefore you will need an ANSI standard C compiler.
  • is written as a GLUT/Tk application and as such requires the GLUT/Tk API for compilation and run-time support for OpenGL. See the GLUT/Tk website for more details.
  • launches a Tcl/Tk process for the control menu. Thus you need a Tcl/Tk implementation installed on your system.
  • uses a few Unix system calls (system, getenv).
  • uses Netscape for text display and to show pages of website.

Download

On your machine, create the standard directory structure for WebMetrics if it does not already exist. Code specific to FLUDViz will be stored in $WEB_TOOLS/FLUDViz/; its lib-flud subdirectory contains application-specific functions used by FLUDViz.

Go to our NIST Web Metrics download page to download the FLUDViz software. Copy FLUDViz-source.tar.gz into the $WEBMET_TOOLS/ directory and then do:

   gunzip FLUDViz-source.tar.gz
          (to produce FLUDViz-source.tar)
   tar -xvf FLUDViz-source.tar
          (to generate the FLUDViz tree)

FLUDViz Files

The following explains the purpose of the various files in the FLUDViz directory. Most of these can be used as is, but a few may require minor editing. The file that will most likely need some modification is Makefile (see below).
FLUDViz directory
contains the main code needed for FLUDViz
Makefile
Should build your system with a little editing - read it for self-documentation. The file contains absolute directory names for various resources which should be changed to reflect their new location on your machine. Look for commented lines containing "MODIFY?" as likely places to edit. Note especially that the RESOURCES variable must be set to the name of your resource directory and the DIR_GLUT variable must contain to the location of your GLUT/Tk directory.

The current version of the makefile is interpretable by GNU/make (see http://www.gnu.ai.mit.edu/home.html). For other implementations of make, YMMV.

fludviz.c
source code for FLUDViz
fludviz.tk
tk code for FLUDViz control window
README
Very general overview documentation
big-picture.prt
Documentation file that relates the functions of the program to the OpenGL display lists being generated. You will need big-picture.prt only if you are trying to figure out the internal logic of the code - it is not necessary for compilation.
lib-flud subdirectory
has application-specific functions used by FLUDViz
f-*.c
various functions used by FLUDViz
defs.h
application-specific definitions used by these functions
meta.h
all definitions used by the lib-flud functions

Compilation
and
Cleanup

Here are the steps for building the executable from source code:
  1. Compilation of FLUDViz depends on the prior download and compilation of the generic graphics functions, as described on the Web Metrics resources page.
  2. Compilation of FLUDViz depends on the prior download and compilation of GLUT/Tk, as described in the GLUT/Tk website.
  3. Make sure GNU make is installed (see http://www.gnu.ai.mit.edu/home.html if you need to download it).
  4. Go to the FLUDViz directory and edit the Makefile there. Look for the lines with a "MODIFY?" comment and make sure that they point to the proper directories.
  5. Execute the make command (the GNU version) to build the executable fludviz.
  6. FLUDViz needs the environment variable CHAR_GEOM set to $WEB_TOOLS/resources/ogl/char-geom.dat. If FLUDViz cannot find this file it will produce lots of error messages.
  7. You can delete the original FLUDViz-source.tar file to save room, if desired.

Overview | Installation | Operation | Results
Version 2.1
Page last modified: 15 May 2002
National Institute of Standards and Technology (NIST)