• Copyright Notice and document origin information
• Contents list and links to chapters
• Figures list of all figures, images and diagrams
• Tables list of all tables and charts

Introduction

• The IRIS Explorer System
• How to Use This Guide
• Contents of This Guide

1. Getting Started

• Overview
• Launching a Map
  • Opening Your First Map
  • Opening Subsequent Maps
  • Quitting IRIS Explorer
  • Opening Modules
• Image Processing
  • Opening the Image Map
  • Experimenting with the Image Map
• Numerical Mathematics
  • Opening the Heat-flux Map
  • Experimenting with the Heat-flux Map
• Molecular Chemistry
  • Opening the Chemistry Map
  • Experimenting with the Chemistry Map
• Atmospheric Physics
  • Opening the Volume Map
  • Experimenting with the Volume Map
• Computational Fluid Dynamics
  • Opening the Cfd Map
  • Experimenting with the Cfd Map

2. Working with the Map Editor

• Overview
• The Map Editor
  • Opening the Map Editor
  • Quitting the Map Editor
  • Editing Maps and Modules
• The Module Librarian
  • Launching a Module
    • Finding a Module in the Librarian
    • Placing the Module In the Map Editor
  • Launching a Map
  • Saving Maps and Modules
  • Removing Maps and Modules
• Modules
  • What Modules Do
    • General Module Functions
    • Specific Module Functions
  • How Modules Work
    • Selecting a Module
    • Resizing the Control Panel
    • Using the Pop-up Menu
    • Using Drag-and-Drop Operations
    • Getting Help
    • Replacing Modules
• Wiring Module Ports Together
  • Making a Compatible Connection
  • Wiring Modules Together
  • Connecting Several Modules
  • Disconnecting and Reconnecting Modules
  • Wire Routing
• Firing Modules
  • Forcing a Firing
  • Using the Synchronization Ports
  • Temporarily Disabling a Module
• Logging Module Output
  • Logging Map Data
  • Logging Module Data
  • Reviewing Log Messages
• Understanding IRIS Explorer Data Types
  • Defining the Data Types
  • Using the Data Types
  • Looking at Module Data Types
    • Mixed Data types
    • Image Processing Modules
• Setting Module Parameters
  • Buttons
  • Sliders
  • Dials
  • Text Type-in Slots
  • File Browsers
  • Option Menus and Scrolled Lists
  • Drawing Areas
• Organizing the Module Librarian
  • Creating New Categories
  • Moving Modules Around
  • Storing Modules on the Shelf
  • Removing Modules from the Librarian
  • Saving the Librarian Configuration
• Common Problems
  • You Need a Larger Memory Arena than Your System Can Give You
  • No Object Is Displayed in the Render Window
  • No Change in Object with Change in Parameters
  • Viewing Lattice Data in the Render Module
  • The Module Librarian Does Not Display a Saved Map
  • A Saved Map is Empty When Reopened
  • When You Try to Destroy a Module, Nothing Happens
  • You Cannot Launch a Module Librarian Remotely
  • You Get a Shared Library Error When You Launch a Remote Module
  • You Cannot Connect Two Modules, or a Module Produces Unexpected Data

3. Using Modules

• Overview
• Creating Colormaps
  • Resetting the Color Bands
    • Selecting an Output Mode
    • Setting the Domain Limits
    • Selecting a Color Band
    • Adding and Removing Control Points
    • Using Slope Control Points
  • Using Custom Colormaps
    • Creating a Custom Colormap
    • Saving a Colormap
• Generating a Lattice
  • Setting Lattice Parameters
    • Controlling Lattice Size
    • Lattice Coordinates
    • Data Values
  • Displaying a Lattice
• Slicing Volumetric Data
  • Using OrthoSlice
  • Using Slice
  • Using ProbeLat
• Generating a Histogram
  • Displaying Histograms
  • Sorting the Data
  • Selecting Channels
• Displaying Images
• Visualizing Data
  • Ports on Render
  • Modes of Operation
  • Selecting an Object
  • Moving an Object
  • Using the Pop-up Menu
  • Using Graphical Shortcuts
  • Wireframe Rendering
  • Editing Object Properties
    • Using the Material Editor
    • Using the Color Editor
    • Using the Transform Sliders
  • Displaying Transparent Objects
  • Changing the Lighting
    • Editing a Light
  • Manipulating Objects
• Constructing Loops
  • Defining a Loop
  • Loop Controllers
  • How Loops Work
  • Wiring a Loop
    • Control Arcs
    • Saving Loops
  • Halting a Loop Iteration
• The IL Controller Module

4. Editing Control Panels and Functions

• Overview
• Using the Control Panel Editor
  • Choosing Parameter Widgets
    • Parameter Types
    • Widget Types
    • Hiding Widgets
    • Widget Decorations
    • Editing a Scrolled List
  • Moving and Resizing Widgets
  • Setting Widget Properties
  • Setting Widget Values and Limits
• Creating Menu Items
  • Setting up the Menu Bar
  • Setting up Menu Items
• Menus in Group Control Panels
• Using the Parameter Function Editor
  • Running the Parameter Function Editor
  • Defining a Parameter Expression
    • Typecasting Parameters
    • Using Strings
    • Combining Functions
    • Linking Independent Parameters
  • Creating a Parameter Function
  • Summarizing the Process
    • Saving the Parameter Functions

5. Creating Groups and Applications

• Overview
• Module Groups
  • Types of Groups
  • Selecting Modules
  • Creating a Group
• Editing a Group
  • The Group Control Panel
  • Promoting Ports
  • Required Input Ports
  • Renaming Ports
  • Selecting Parameters
  • Grouping Optional Ports
  • Grouping Modules in a Loop
• Creating a Group Control Panel
  • The Default Control Panel
  • The Designer Control Panel
• Opening a Group
  • Modifying Connections
  • Redefining a Group
• Defining an Application
  • Creating an Application
    • Setting Parameters in an Application
  • Saving the Application
  • Running an Application
  • Quitting an Application
  • Application Busy Indicators
    • Debugging an Application

6. Scripting

• Overview
  • Running IRIS Explorer by Script
  • Creating Simple Scripts
    • Defining Command Variables
    • Saving a Script
  • Advanced Uses
• Using the Skm Commands
  • Command Syntax
  • Interactive Help
• Creating More Complex Scripts
  • Specifying Symbols
    • Setting Off Comments
    • Using the Define Command
  • Testing Variable Types
    • Creating a Procedure
    • Using a Procedure
• Output from Skm
• The Skm Editor Window
  • The Skm Output Viewer
  • The Skm Command History Window
  • The Skm Cursor
  • The Skm Command Input

7. Datascribe

• Overview
• The DataScribe
  • Opening the DataScribe
  • Quitting the DataScribe
  • Scope of the DataScribe
• Creating Scripts and Templates
  • Setting up Templates
    • Opening a New Template
    • Using the Overview Pane
• The Data Type Palette
  • Glyphs
    • The Shape Icon
    • The Node Type Icon
    • Component Menu Button
  • Building a Script
    • Wiring Input and Output Templates
    • Running IRIS Explorer
• Designing Templates for Your Data
  • Reading in Data
    • Checking EOF
    • Reading in Lattices
    • Reading in Binary Files
• Data Structures
  • Scalars
  • Scalar Glyphs
  • Arrays
  • Array Glyphs
    • Hierarchy in Arrays
    • Using Array Indices in Expressions
  • Lattices
  • Lattice Glyphs
    • Lattice Components
    • Lattice Types
  • Sets
    • Saving a Set
    • Using Nested Sets
• Using a Pattern Glyph
  • Using the Glyph Property Sheet
• Defining Parameters and Constants
  • Making a Parameters Template
  • Making a Constants Template
• Connecting Templates
  • Ordering Variables in a Script
  • Connecting Data Items Between Templates
• Selecting Array Components
  • Converting Formatted ASCII Files
    • Using the Property Sheet Ruler
    • More Complex Expressions
• Saving Scripts and Modules
  • Saving Modules With Control Panels
  • Checking for Errors
  • Creating a Diagnostic Template
• Using a DataScribe Module with the Map Editor
• Finding and Correcting Errors
  • Tracking Down Errors
  • Interpreting Parsing Messages

A. Configuring Your IRIS Explorer Environment

• The .explorerrc Configuration File
  • Remote Execution of Modules
    • Software Requirements
    • Defining Hosts for Remote Modules
  • If IRIS Explorer Is Not Installed in /usr/explorer
    • Using the Switch Statement in a Shared .cshrc
  • The .explorerrc File
  • Configuration Commands
    • Setting the Module Path
    • set
    • category
    • host
• IRIS Explorer Environment Variables
• Remote Execution and Passwords
• Running the X Server
  • Selecting a Visual

B. The Skm Language

• Skm Syntax
  • The Skm Data Types
    • The Comment Character
  • IRIS Explorer Operators
  • Command Syntax
  • IRIS Explorer-related Command Descriptions
    • start
    • destroy
    • start-map
    • connect
    • Testing Variable Types
• Skm Language Features
  • Comparison Operators
    • eq?
    • eqv?
  • Conditional Operators
  • String Operators
    • string?
    • string-length
    • string-ref
    • string-set!
    • string=?
    • substring
    • string-append
  • Loading Script Files
• Procedures in Skm
  • Using a Skm Procedure
  • Skm Output
  • Looping
  • Lexical Scoping of Variables
    • The let Construct
  • List Processing
• Module Interface to Scripting
  • Global Namespace
  • A Complex Example
  • Known Bugs
  • References
  • Copyright Notice

Figure 2-1 The Map Editor
Figure 2-2 The Module Librarian
Figure 2-3 Module Launch Menu
Figure 2-4 A Simple Map Example
Figure 2-5 General Structure of a Module
Figure 2-6 Micro Control Panel/Title Bar
Figure 2-7 Diminutif Control Panel
Figure 2-8 Full-scale Control Panel
Figure 2-9 Module Pop-up Menu
Figure 2-10 Module Input Ports
Figure 2-11 Module Output Ports
Figure 2-12 Making Connections between Modules
Figure 2-13 Making Multiple Connections
Figure 2-14 Example of Map Connections
Figure 2-15 Controlling Module Firing with Fire Ports
Figure 2-16 The Map Log Window
Figure 2-17 Module Log Window
Figure 2-18 Log Window Pop-up Menu
Figure 2-19 Button Widgets
Figure 2-20 Slider Widgets
Figure 2-21 Dial Widgets
Figure 2-22 Text Type-in Slots
Figure 2-23 A File Browser
Figure 2-24 Option Menu Widgets
Figure 2-25 Scrolled List Widget
Figure 2-26 A Drawing Area Widget
Figure 2-27 Experimenting with Widgets
Figure 2-28 Module Category

Figure 3-1 The GenerateColormap Module
Figure 3-2 Adding Control Points to a Color Band
Figure 3-3 Slope Control Points
Figure 3-4 A Map using GenerateColormap
Figure 3-5 The GenLat Module
Figure 3-6 The OrthoSlice Module
Figure 3-7 Slicing a Volume with OrthoSlice
Figure 3-8 The Slice Module
Figure 3-9 Slice Extended Beyond Lattice Bounds
Figure 3-10 Slicing a Volume with Slice
Figure 3-11 The ProbeLat Module
Figure 3-12 Probe Forms
Figure 3-13 Slicing a Volume with ProbeLat
Figure 3-14 The Histogram Module
Figure 3-15 An Image in the DisplayImg Module
Figure 3-16 Example Showing Two Images in DisplayImg
Figure 3-17 The Render Module
Figure 3-18 A Selected Object
Figure 3-19 Render Pop-up Menu
Figure 3-20 The Render Decorations
Figure 3-21 Wireframe Object in Render
Figure 3-22 The Material Editor
Figure 3-23 The Color Editor
Figure 3-24 The Transform Sliders
Figure 3-25 Light Editor
Figure 3-26 The Trackball Manipulator
Figure 3-27 A Loop in a Map
Figure 3-28 Loop Controller Modules
Figure 3-29 Build Options for Loop Controller
Figure 3-30 Loop Wiring in AnimateIso Map
Figure 3-31 Looping Control Arc
Figure 3-32 Ambiguous Looping Scheme
Figure 3-33 Module Menu on Active Loop Controller

Figure 4-1 The Control Panel Editor
Figure 4-2 Selecting a Widget Type
Figure 4-3 A Selection of Widgets
Figure 4-4 The Decorations Menu
Figure 4-5 Scrolled List Properties
Figure 4-6 Widget Handlebox
Figure 4-7 The Menu Bar Editor
Figure 4-8 The Menu Editor
Figure 4-9 The Parameter Function Editor
Figure 4-10 Module Pop-up Menu
Figure 4-11 Connections for a Parameter Function
Figure 4-12 Parameter Functions for a Module
Figure 4-13 Simple Example with a Parameter Function
Figure 4-14 Messages in the P-Func Editor
Figure 4-15 A Parameter Function Using Two Variables

Figure 5-1 An Image Processing Map
Figure 5-2 The Closed Group
Figure 5-3 The Open Group
Figure 5-4 The Group Editor
Figure 5-5 Renaming a Port
Figure 5-6 The Group Control Panel
Figure 5-7 The New Group Control Panel

Figure 6-1 The Skm Editor Window

Figure 7-1 Templates and Scripts
Figure 7-2 Template Icons
Figure 7-3 New Template Dialog Box
Figure 7-4 Input and Overview Templates
Figure 7-5 DataScribe Data Type Palette
Figure 7-6 Glyph Forms
Figure 7-7 The Shape and Node Type Icons
Figure 7-8 A New Array Structure
Figure 7-9 A Hierarchical Array
Figure 7-10 An Open Vector Glyph
Figure 7-11 A Simple DataScribe Script
Figure 7-12 Overview Output Port
Figure 7-13 The DataScribe Module in the Map Editor
Figure 7-14 A Scalar Glyph
Figure 7-15 An Array Glyph
Figure 7-16 A Complex 3D Array
Figure 7-17 A 3D Uniform Lattice
Figure 7-18 A 3D Perimeter Lattice
Figure 7-19 A 3D Curvilinear Lattice
Figure 7-20 A 3D Generic Lattice
Figure 7-21 A Set for a Bounding Box
Figure 7-22 Nested Sets
Figure 7-23 A Pattern Glyph
Figure 7-24 File Structure for Pattern Template
Figure 7-25 An Input Template Using Patterns
Figure 7-26 The Glyph Property Sheet
Figure 7-27 Parameters Template Title Bar
Figure 7-28 Constants Template Title Bar
Figure 7-29 Making the First Connection
Figure 7-30 A Script Using Patterns
Figure 7-31 Array Component Dialog Window
Figure 7-32 Selecting the X Value of a 2D Array
Figure 7-33 Component Dialog Window for X Values
Figure 7-34 Component Dialog Window for Data Values
Figure 7-35 New Menus for Input Template
Figure 7-36 Output Lattice Coordinate Vector
Figure 7-37 Output Coordinate Values (xCoord)
Figure 7-38 Output Coordinate Values (allX)
Figure 7-39 The Output Template Ruler
Figure 7-40 Reading a Formatted ASCII File
Figure 7-41 Ruler for Reading an ASCII File
Figure 7-42 Writing a Formatted ASCII File
Figure 7-43 An Output Array Ruler
Figure 7-44 A Curvilinear 3D Lattice Reader
Figure 7-45 The PLOT3D Script