DVRP Library Documentation

A Parallel Library to Support 3D-Visualization and Computational Steering

RRZN Universität Hannover

Karsten Chmielewski

Nils Jensen

$Date: 2006/12/08 15:26:12 $

The DVRP Library is a parallel high-throughput 3D-visualization component to enable interactive 3D visualization and computational steering in Fortran- and C-based applications. The DVRP Library maps data to graphics objects, communicates with 3D streaming servers, and forwards remote commands to the linked applications. The implementation is written in C and optionally uses the Message Passing Interface (MPI). Since 2000, the DVRP Library has been developed at the computer center (RRZN) of the University of Hannover.

Please report any errors or inconsistencies found in either the library or this documentation to along with any suggestions for improvements.

News: April 2006. Function to tag active data (see DVRP_MASK). Revised text and links.

News: August 2003. Improved computational steering: user-defined call-backs can be defined to be called when parameters are changed while the simulation is suspended (see DVRP_STEERING_UPDATE). Extended documentation: the DVRP_SPLIT routine to allocate a processor exclusively to the DVRP Library has been documented.

News: April 2003. Changes to the DVRP Library comprise a new facility for the visualization of molecules (see DVRP_MOLECULE in the detailed description and Sample 9) and a simplified scheme for slicer-colorization (see DVRP_COLORFUNCTION in the detailed description and Sample Program 4). All sample programs are now hyper-linked and available as DVR-Streams. With the DocShow-VR plugin installed one can immediately explore the output of the sample programs.

Download. The complete source code of all sample programs as well as the Fortran 95 interface and its dependent sub-modules are available for download.

Table of Contents
1. Introduction and Tutorial
1.1. Background
1.2. DVRP Library Interface
1.2.1. Platform Dependencies
1.2.2. Global Scope of Variables
1.3. DVRP Library Organization
1.4. Sample Program 1
1.5. Sample Program 2
1.6. Sample Program 3
1.7. Sample Program 4
1.8. Sample Program 5
1.9. Sample Program 6
1.10. Sample Program 7
1.11. Sample Program 8
1.12. Sample Program 9
2. Fortran 90/95-Interface
2.1. The DVRP module
2.2. Initialization and Clean-up
2.2.1. DVRP_INIT
2.2.2. DVRP_EXIT
2.2.3. DVRP_OUTPUT_FTP
2.2.4. DVRP_OUTPUT_LOCAL
2.2.5. DVRP_OUTPUT_RTSP
2.2.6. DVRP_SPLIT
2.2.7. DVRP_SPLIT_EXIT
2.3. Logging
2.3.1. DVRP_LOG
2.3.2. DVRP_LOG_DISABLE
2.3.3. DVRP_LOG_ENABLE
2.3.4. DVRP_LOG_EVENT
2.3.5. DVRP_LOG_EXIT
2.3.6. DVRP_LOG_INIT
2.3.7. DVRP_LOG_SYMBOL
2.3.8. DVRP_VERBOSE
2.4. Virtual Camera and 3D-Scene Generation
2.4.1. DVRP_CAMERA
2.4.2. DVRP_BOUNDINGBOX
2.4.3. DVRP_VISUALIZE
2.5. Material Properties and Color Management
2.5.1. DVRP_COLORTABLE_HLS
2.5.2. DVRP_COLORTABLE_RGB
2.5.3. DVRP_MATERIAL
2.5.4. DVRP_MATERIAL_HLS
2.5.5. DVRP_MATERIAL_RGB
2.5.6. DVRP_COLORFUNCTION
2.6. Geometric Primitives and Compound Objects
2.6.1. DVRP_CONE
2.6.2. DVRP_CYLINDER
2.6.3. DVRP_PARTICLES
2.6.4. DVRP_POLYGONS
2.6.5. DVRP_MOLECULE
2.7. Visualization of Volume-Data
2.7.1. DVRP_DATA
2.7.2. DVRP_MASK
2.7.3. DVRP_GRID
2.7.4. DVRP_RESULTS
2.7.5. DVRP_SLICER
2.7.6. DVRP_THRESHOLD
2.7.7. DVRP_VERTICES
2.8. Steering
2.8.1. DVRP_STEERING_INIT
2.8.2. DVRP_STEERING_UPDATE
A. Fortran Math Model
A.1. T3E Kind Specifications
A.2. Intel-x86 Kind Specifications (NAGWare f95)
A.3. Sun Ultra-Enterprise Kind Specifications
A.4. HLRN IBM-Regatta Kind Specifications
B. HLS Color Model
C. DVR Binary Format Specification
References
Alphabetical Listing of DVRP Library Functions
List of Tables
1-1. Supported Platforms
1-2. Type Correspondences in C and Fortran on the T3E
1-3. Type Correspondences in C and Fortran on Intel-x86
1-4. Type Correspondences in C and Fortran on Sun Ultra-Enterprise
1-5. Type Correspondences in C and Fortran on the HLRN IBM-Regatta
2-1. Mode Parameters (DVRP_VISUALIZE)
2-2. Mode Parameters (DVRP_MATERIAL_HLS)
2-3. Mode Parameters (DVRP_COLORFUNCTION)
2-4. Mode Parameters (DVRP_PARTICLES)
A-1. T3E Integer Kind Specifications
A-2. T3E Real Kind Specifications
A-3. Intel-x86 Integer Kind Specifications
A-4. Intel-x86 Real Kind Specifications
A-5. Sun Ultra-Enterprise Integer Kind Specifications
A-6. Sun Ultra-Enterprise Real Kind Specifications
A-7. HLRN IBM-Regatta Integer Kind Specifications
A-8. HLRN IBM-Regatta Real Kind Specifications
List of Figures
1-1. Output of Demo 1
1-2. Output of Demo 2
1-3. Output of Demo 3
1-4. Graphical user interface for computational steering
1-5. Graphical user interface for computational streaming
1-6. Output of Demo 4 (iso-surface)
1-7. Output of Demo 4 (slicer)
1-8. Output of Demo 5
1-9. Output of Demo 6
1-10. Output of Demo 7
1-11. Output of Demo 8
1-12. Output of Demo 9
B-1. HLS Color Model
C-1. DVR Binary Format Specification
  Next
  Introduction and Tutorial