IRIS Explorer Module Writers' Guide

Table of Contents


Contents

Introduction

1. Building a Module

2. Understanding the Module Builder

3. Using the Lattice Data Type

4. Using the Pyramid Data Type

5. Using the Geometry Data Type

6. Using the Pick Data Type

7. Using the Parameter Data Type

8. Creating User-defined Data Types

9. Advanced Module Writing

10. Module Prototyping with Shape

A. Using Makefiles

B. The Firing Algorithm

Figures

Figure 1-1 The Module Builder Window for C Users
 Figure 1-2 The Module Builder Window for Fortran Users
 Figure 1-3 Module Builder File Menu
 Figure 1-4 Input Ports Window
 Figure 1-5 The Lattice Constraints Window
 Figure 1-6 The Output Ports Window
 Figure 1-7 Lattice Constraints for the Output Port
 Figure 1-8 The Function Args Window for C Users
 Figure 1-9 The Function Args Window for Fortran Users
 Figure 1-10 The Connections Window
 Figure 1-11 Input Port Popup Menu
 Figure 1-12 Array Function Argument
 Figure 1-13 Port Popup Menu for a Parameter
 Figure 1-14 Function Argument Menu for an Array Item
 Figure 1-15 Setting the Storage Size for C Users
 Figure 1-16 Setting the Storage Size for Fortran Users
 Figure 1-17 Control Panel Editor and Control Panel
 Figure 1-18 Menu Bar Editor
 Figure 1-19 Menu Editor
 Figure 1-20 Build Options Control Panel
 Figure 1-21 Build Menu Options
 Figure 1-22 The Function Args Window for C Users
 Figure 1-23 The Function Args Window for Fortran Users
 Figure 1-24 The Connections Window

Figure 2-1 Module Builder Main Window
 Figure 2-2 Input Ports Window
 Figure 2-3 Lattice Constraints Window
 Figure 2-4 Sequence of Type Coercions
 Figure 2-5 The Pyramid Constraints Window
 Figure 2-6 Output Port Window
 Figure 2-7 Function Arguments Window for a C Function
 Figure 2-8 Function Arguments Window for a Fortran Subroutine
 Figure 2-9 Function Argument Reference menu for C (above) and Fortran (below)
 Figure 2-10 Connections Window
 Figure 2-11 Connections Menu for the "Molecule" Port
 Figure 2-12 Highlights in the Connections Window
 Figure 2-13 Setting a Constant Value for a Function Argument
 Figure 2-14 Connections Popup Menu for an Array Function Argument
 Figure 2-15 The Prototypes Menu
 Figure 2-16 Function Prototype Window
 Figure 2-17 The Build Menu
 Figure 2-17 The Build Options Menu

Figure 3-1 Data Flow Between Input and Output Lattices
 Figure 3-2 Schematic Structure of the Lattice Data Type
 Figure 3-3 Lattice Variables
 Figure 3-4 Storing Arrays in C and Fortran
 Figure 3-5 Array Neighbors
 Figure 3-6 Storing Data Values
 Figure 3-7 A 2-D Uniform Lattice Structure
 Figure 3-8 A 3-D Uniform Lattice Structure
 Figure 3-9 Data Set for a 2-D Perimeter Lattice
 Figure 3-10 Storing Perimeter Coordinates
 Figure 3-11 Example of a 3-D Perimeter Lattice
 Figure 3-12 Storing Curvilinear Coordinates
 Figure 3-13 Curvilinear Lattices with various values for nDim and nCoordVar
 Figure 3-14 Defining Lattice Constraints

Figure 4-1 Pyramid Dictionary Reference Elements
 Figure 4-2 Memory Layout of a 2-D Lattice
 Figure 4-3 Layers in a Tetrahedral Grid
 Figure 4-4 Top and Bottom of Compressed Tetrahedral Grid
 Figure 4-5 Layers in a Compressed Grid
 Figure 4-6 Connections in a Tetrahedron
 Figure 4-7 Preprocessing a Pyramid Dictionary

Figure 5-1 Schematic Structure of the Geometry Data Type
 Figure 5-2 Inventor Scene Graph
 Figure 5-3 Output from Geometry Example

Figure 6-1 Schematic Structure of the Pick Data Type
 Figure 6-2 Schematic Structure of the PickHit Data Type
 Figure 6-3 The Pick Map

Figure 7-1 Schematic Structure of the Parameter Type

Figure 8-1 IRIS Explorer Types Information Flow

Figure 9-1 Spectrum of Module Complexity
 Figure 9-2 The Module Structure
 Figure 9-3 The Hook Function Window

Figure 10-1 The LatFunction Module Control Panel
 Figure 10-2 How Shape Assigns Variable Names
 Figure 10-3 LatFunction in the testVol Map
 Figure 10-4 Output from the color-xform Map
 Figure 10-5 Output from the heat-flux Map

Figure B-1 Map Topology
 Figure B-2 Multiple Firing in a Map
 Figure B-3 Frame Identifiers
 Figure B-4 Map Firings
 Figure B-5 Frame Assembly
 Figure B-6 Parallel Data Flows
 Figure B-7 Data Handling in a Module

Tables

Table 1-1 Function Arguments for the C Function
 Table 1-2 Function Arguments for the Fortran Subroutine
 Table 2-1 Colormap Lattice Constraints
 Table 2-2 Primitive Data Types in C and Fortran
 Table 2-3 Function Argument References
 Table 3-1 Lattice Primitive Types
 Table 3-2 Lattice Subroutines
 Table 4-1 Standard Dictionary Reference Elements
 Table 4-2 User-defined Values in the Chemistry Pyramid
 Table 4-3 Pyramid Subroutines
 Table 4-4 Pyramid Dictionary Subroutines
 Table 5-1 IRIS Explorer Shared Memory Node Classes
 Table 5-2 Geometry Subroutines
 Table 6-1 Pick Subroutines
 Table 7-1 Parameter Subroutines
 Table 8-1 Scalar Types in IRIS Explorer
 Table 8-2 A Simple-typed Member
 Table 8-3 Labels on Lattice Scalars
 Table 8-4 Member of a Data Type
 Table 9-1 X Window API Subroutines
 Table 9-2 While Module Ports
 Table 9-3 Interpreter Module Files
 Table 10-1 Data Types in C and Shape
 Table 10-2 C-like Functions in Shape
 Table 10-3 Functions Specific to Shape
 Table A-1 User-definable make Variables
 Table A-2 System-required Variables
 Table B-1 Topology Influence Table for DisplayImg
Last modified: Wed Apr 23 16:18:06 1997 [ Documentation Home ]

© NAG Ltd. Oxford, UK, 1997