333333333 3333 AVS USER'S 333333333333GUIDE Release 4 May, 1992 Advanced Visual Systems Inc.33333333 Part Number: 320-0011-02, Rev B NOTICE This document, and the software and other products described or referenced in it, are con®dential and proprietary products of Advanced Visual Systems Inc. (AVS Inc.) or its licensors. They are provided under, and are subject to, the terms and conditions of a written license agreement between AVS Inc. and its customer, and may not be transferred, disclosed or otherwise provided to third parties, unless otherwise permitted by that agreement. NO REPRESENTATION OR OTHER AFFIRMATION OF FACT CONTAINED IN THIS DOCUMENT, INCLUDING WITHOUT LIMITATION STATEMENTS REGARDING CAPACITY, PERFORMANCE, OR SUITABILITY FOR USE OF SOFTWARE DESCRIBED HEREIN, SHALL BE DEEMED TO BE A WARRANTY BY AVS INC. FOR ANY PURPOSE OR GIVE RISE TO ANY LIABILITY OF AVS INC. WHATSOEVER. AVS INC. MAKES NO WARRANTY OF ANY KIND IN OR WITH REGARD TO THIS DOCUMENT, INCLUDING BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. AVS INC. SHALL NOT BE RESPONSIBLE FOR ANY ERRORS THAT MAY APPEAR IN THIS DOCUMENT AND SHALL NOT BE LIABLE FOR ANY DAMAGES, INCLUDING WITHOUT LIMITATION INCIDENTAL, INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES, ARISING OUT OF OR RELATED TO THIS DOCUMENT OR THE INFORMATION CONTAINED IN IT, EVEN IF AVS INC. HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. The speci®cations and other information contained in this document for some purposes may not be complete, current or correct, and are subject to change without notice. The reader should consult AVS Inc. for more detailed and current information. Copyright 1989, 1990, 1991, 1992 Advanced Visual Systems Inc. All Rights Reserved AVS is a trademark of Advanced Visual Systems Inc. STARDENT is a registered trademark of Stardent Computer Inc. IBM is a registered trademark of International Business Machines Corporation. AIX, AIXwindows, and RISC System/6000 are trademarks of International Business Machines Corporation. DEC and VAX are registered trademarks of Digital Equipment Corporation. NFS was created and developed by, and is a trademark of Sun Microsystems, Inc. HP is a trademark of Hewlett-Packard. CRAY is a registered trademark of Cray Research, Inc. Sun Microsystems is a registered trademark of Sun Microsystems, Inc. SPARC is a registered trademark of SPARC International. SPARCstation is a registered trademark of SPARC International, licensed exclusively to Sun Microsystems, Inc. OpenWindows, SunOS, XDR, and XGL are trademarks of Sun Microsystems, Inc. UNIX and OPEN LOOK are registered trademarks of UNIX System Laboratories, Inc. Motif is a trademark of the Open Software Foundation. IRIS and Silicon Graphics are registered trademarks of Silicon Graphics, Inc. IRIX, IRIS Indigo, IRIS GL, Elan Graphics, and Personal IRIS are trademarks of Silicon Graphics, Inc. Mathematica is a trademark of Wolfram Research, Inc. X WINDOW SYSTEM is a trademark of MIT. PostScript is a registered trademark of Adobe Systems, Inc. FLEXlm is a trademark of Highland Software, Inc. RESTRICTED RIGHTS LEGEND (U.S. Department of Defense Users) Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the Rights In Technical Data and Computer Software clause at DFARS 252.227±7013. RESTRICTED RIGHTS NOTICE (U.S. Government Users excluding DoD) Notwithstanding any other lease or license agreement that may pertain to, or accompany the delivery of this computer software, the rights of the Government regarding its use, reproduction and disclosure are as set forth in the Commercial Computer Software Ð Restricted Rights clause at FAR 52.227±19(c)(2). Advanced Visual Systems Inc. 300 Fifth Ave. Waltham, MA 02154 TABLE OF CONTENTS 1 Introduction to AVS Introduction 1-1 Scientific Visualization Techniques 1-3 Pixel-Based Visualization 1-3 Colormap Lookup 1-3 Further Pixel Processing 1-4 High-Quality Pixel-Based Visualization 1-4 Geometry-Based Visualization 1-4 The AVS Subsystems 1-5 Command Language Interpreter 1-6 AVS Modules 1-6 Modules: Ports and Parameters 1-7 Data Inputs 1-8 Input Parameters 1-9 Data Outputs 1-11 Subroutine Modules and Coroutine Modules 1-11 Standard Modules and Module Libraries 1-12 User-Written Modules 1-12 AVS Networks 1-12 Data Flow in an AVS Network 1-13 Network Control Panel 1-15 AVS Display Windows 1-15 An Example 1-15 Mapper Modules: Geometries 1-16 Compositing Mapping Techniques 1-17 Mapper Modules that Produce Images 1-19 Combining Imaging Techniques 1-21 Producing Graphs 1-22 Techniques Combined 1-24 Curvilinear, Vector Data 1-24 Note on Platforms 1-25 AVS Documentation 1-26 AVS USER’S GUIDE CONTENTS-1 TABLE OF CONTENTS 2 Importing Data into AVS Introduction 2-1 AVS Data Types 2-1 Primitive Data 2-2 byte 2-2 integer 2-2 single-precision floating point 2-2 double-precision floating point 2-2 text strings 2-3 Aggregate Data 2-3 Field Data 2-3 Geometric Data 2-3 Unstructured Cell Data 2-4 Molecule Data Type 2-4 Colormap Data 2-4 AVS Data Type Reference Table 2-4 Data Import Strategies 2-5 Field Data 2-7 Uniform Fields 2-8 Rectilinear Fields 2-9 Irregular Fields 2-10 AVS Data Interchange Application: ADIA 2-12 AVS Module: read field 2-12 Native Field Input 2-12 ASCII Header 2-13 Separator Characters 2-13 Binary Area 2-13 Example 1 2-14 Example 2 2-15 Example 3 2-15 Data-Parsing Input 2-16 ASCII Description File 2-17 Example 1 2-22 Example 2 2-23 Example 3 2-24 Example 4 2-25 Example 5 2-25 Hints on Using read field 2-26 read field Limitations 2-27 AVS Module: read plot3d 2-28 AVS Module: read image 2-29 read image Data File Format 2-29 AVS Module: read volume 2-30 read volume Data File Format 2-30 Programming Examples 2-31 Geometry Data 2-32 CONTENTS-2 AVS USER’S GUIDE TABLE OF CONTENTS AVS Module: geometry viewer 2-33 AVS Module: read geom 2-34 AVS Module: pdb to geom 2-34 AVS Geometry Filters 2-35 Automatic Data Filtering 2-36 Shell-Level Usage of Geometry Filter Utilities 2-36 Postprocessor Filters 2-37 Programming Examples 2-38 Unstructured Cell Data 2-39 AVS Module: read ucd 2-39 ASCII UCD File Format 2-39 Example ASCII UCD File 2-41 Programming Examples 2-42 read_ucd.c 2-42 gen_ucd.f 2-42 ucd_thresh.c 2-42 ucd_extract.c 2-42 Colormap Data 2-43 AVS Module: generate colormap 2-43 Molecule Data Type 2-44 AVS Module: Read structure file 2-45 3 Starting AVS Introduction 3-1 Platform Dependencies 3-1 Controlling AVS Startup 3-2 The Main Menu: Basic Interface 3-4 Subsystem Control Panels 3-4 Switching Among the Subsystems: Data Viewers Button 3-6 Cancelling Operations 3-7 Learning AVS 3-7 AVS Demo Suite 3-7 The Data Viewer 3-8 Using On-Line Help 3-8 Help Buttons 3-8 Module Editor 3-11 Shell-Level Help 3-11 File Browsers and Dialog Typein Panels 3-11 Exiting AVS: Saving Work 3-13 AVS Command-Line Options 3-14 AVS .avsrc Startup File 3-20 .avsrc Startup File Format 3-21 .avsrc Startup File Keywords 3-21 AVS Environment Variables 3-26 Adding to the Applications Menu 3-28 AVS USER’S GUIDE CONTENTS-3 TABLE OF CONTENTS 4 Image Viewer Subsystem Introduction 4-1 Entering the Image Viewer 4-3 Leaving the Image Viewer 4-4 Image Viewer: Basic Layout 4-4 Image Viewer Control Panel 4-5 Top Control Bar 4-6 Transform Selection Controls 4-6 Current Image Controls 4-8 Function Key Usage 4-10 Menu Selection Controls 4-11 Submenu Controls 4-11 Viewport Windows and Scenes 4-12 Transforming Viewports 4-12 Current Viewport: Switching Among Viewports 4-13 Resizing Viewports 4-14 Browsers 4-14 Images Submenu 4-14 Read Image 4-15 Write Image 4-16 Duplicate Image 4-16 Delete Image 4-17 Show Image/Hide Image 4-17 Zoom In/Zoom Out 4-17 Raise/Lower: Image Stacking Order 4-18 Raise to Front/Lower to Back 4-19 Color Dithering Options 4-19 Views Submenu 4-20 Create Scene 4-20 Create View 4-21 Delete View and Deleting Scenes 4-21 Save Scene 4-21 Read Scene 4-22 Scale X, Y, X and Y 4-22 Edit Background Color 4-23 Image Processing Submenu 4-24 Basic Procedure: Select Processing Technique 4-25 Zoom to Image: Techniques on Whole Images 4-26 Shift-Left Mouse Button: Techniques on Subimages 4-27 In Place/New Window 4-28 Set Current Image: Multiple Techniques on One Image 4-29 Restore Current Image 4-30 Raise Control Panel: Window Management 4-30 Select Processing Technique 4-31 Limitations 4-32 CONTENTS-4 AVS USER’S GUIDE TABLE OF CONTENTS Defining Image Processing Techniques 4-33 Labels Submenu 4-34 Current Label: Creating Labels 4-34 Editing a Label 4-35 Picking and Moving a Label 4-36 Title: Making a Label Into a Title 4-36 Label Menu Selection 4-36 Action Submenu: Flipbook Animation 4-39 Size: A Caution 4-40 Store Frames 4-41 Append Frame 4-41 Total Frames 4-41 Current Frame 4-41 Step Forward/Step Backward 4-41 Continuous 4-42 Bounce 4-42 Replay Speed 4-42 Delete Current Frame 4-42 Save Cycle 4-42 Read Cycle 4-43 A Network for Geometries 4-43 Image Viewer Command Language Interpreter 4-43 5 Geometry Viewer Subsystem Introduction 5-1 Renderers 5-2 Entering the Geometry Viewer 5-4 Spaceballs and Dialboxes 5-5 Leaving the Geometry Viewer 5-5 Scenes, Objects, Lights, and Cameras 5-6 Objects 5-7 Where Objects Appear in World Space 5-8 Geometry Viewer Control Panel 5-9 Top Control Bar 5-9 Transform Selection Area 5-9 Mouse Transformations 5-12 Transforming Objects 5-12 Transforming Lights 5-13 Transforming Cameras 5-14 Transforming Texture Maps 5-15 Transforming Labels 5-16 Precise Transformations 5-16 Degree of Rotation: Arrow Keys 5-17 Absolute and Relative 5-17 Override 5-19 AVS USER’S GUIDE CONTENTS-5