Installation & Functionality README for AtomView ver 1.0

AtomView is an application written in SGI's Performer. For more specific information on the code itself, we have provided a file "_psuedo_code.txt" within the tar file.  This page covers how to set-up AtomView version 1.0 to run on your SGI desktop workstation with a CAVE-Simulator, IDesk, or CAVE, and contains the following information:

1. Initial Setup:

REQUIREMENTS: Pre-installed: CAVE-Libs and SGI Performer

1. Download the atomview.tar.gz file from our site
2. Unzip and untar the atomview.tar.gz file. This can be put anywhere and will create a atomview directory upon untaring and unzipping.
3. Unzip and untar the optional atoms.tar.gz file. AtomView expects atom files to be in a standard common place. This place was chosen to be the atomview directory itself.  So the atom files must be untarred and placed within this directory for the program to work correctly.

4. Now to compile the code you must be in the atomview directory, then type "make".

2. How to Run AtomView:

1. To run the AtomView, enter the atomview directory and type atomview you will be prompted for information or you may enter the same parameters after the atomview command using the following syntax.

Usage: atomview -file "basefilename" -range "minfilenumber":"maxfilenumber"
 
where "basefilename" is the root name of a file for a sequence of files of the form "basefilename"."filenumber". The range defines the minimum filenumber ("minfilenumber") and the maximum filenumber ("maxfilenumber"). The program will then read in all files (from min to max filenumber) and interpolate linearly between the datasets for time-animations of the data.

Other Optional Flags: -cave, -desk, -wall, -simulator
Each of these flags defines a different display device that the program is running on since it can NOT automatically sense the the differences between and IDesk and a CAVE. So the -cave flag tells it to adjust its user-interface geometry for display inside of a CAVE and the -desk flag adjusts the user-interface geometry for the immersadesk. The default is -cave

-default: Forces the program to use internally created geometries to represent the atoms. The internal geometry is a sphere, but you can select the resolution of the sphere (number of facets) using the -refinement option. Using fewer facets created more jagged spheres, but less complicated scenes can be drawn faster in 3D. If the default (internal) geometries are not used, then the program will search for custom geometries in the current working directory. The custom geometries have the same name as the atom they represent (as printed in the xyz files) and have the extension .vrml, .wrl, or .iv depending on the type of geometry they contain. If a custom geometry cannot be found, then it will fall back on the default (internal) geometries.

-refinement: This sets the number of faces used to create a sphere when the internal (default) geometries are used. Fewer faces means faster drawing since the objects are less complicated. However, it also means the spheres are less smooth looking. The default is 32.

e.g. atomview -simulator -file fort -range 31:45 -default

2. The atom file will be loaded into the CAVE/IDesk or X-Window on the CAVE-Simulator, depending how you have configured your .caverc file.

3. The "Mode:" of operation will appear in the upper left corner of the CAVE front wall. The Mode is incremented if the right or middle (wand or mouse) button is pressed and the Mode is decremented if the left (wand or mouse) button is pressed. When AtomView first comes up "Mode: (press any wand button to change modes) appears first. If you press the right button "Scale Atoms" appears . There are four modes:
4. Kill all of the CAVE subprocesses and Stop CAVE when Esc is pressed.

3. Desktop CAVE-Simulator Functionality


This page describes all the commands that can be used when using AtomView at your desktop.

1. Simulated tracking
Simulated tracking is selected by the configuration option "TrackerType simulator". The controls for moving the simulated head and wand are given below.

1.1 Head Controls
The simulated user's head can be moved and rotated within the CAVE using the arrow keys.  Note that the head is restricted to remain within the confines of physical CAVE. The commands to control the head are:

 
     LEFT_ARROW ............ Move left
     RIGHT_ARROW ........... Move right
     UP_ARROW .............. Move forward
     DOWN_ARROW ............ Move backward
     SHIFT + UP_ARROW ...... Move up
     SHIFT + DOWN_ARROW .... Move down
     ALT + LEFT_ARROW ...... Rotate left
     ALT + RIGHT_ARROW ..... Rotate right
     ALT + UP_ARROW ........ Rotate up
     ALT + DOWN_ARROW ...... Rotate down
     P .......... Reset head and wand to initial positions
1.2 Wand Controls

The wand is controlled using the mouse. Moving the mouse while holding down the appropriate key will move or rotate the wand. As with the head, the wand is restricted to stay inside the CAVE. When the user's head is moved, the wand is moved with it. If more than one wand is being simulated (using the SimulatorNumWands configuration option), only one wand at a time may be controlled; the wand to control is selected using the F keys (i.e. F1, F2, etc.).

 
The wand movement controls are as follows:

     CTRL + mouse movement ....... Move wand left/right/forward/back
     SHIFT + mouse movement ...... Move wand left/right/up/down
     ALT + mouse movement ........ Rotate wand left/right/up/down
     < and > .......... Roll wand (rotate about Z)
     HOME ....... Reset wand to be in front of user
     F1/F2/F3/... ................ Select wand 1/2/3/... as the current wand being controlled.
 

1.3. Simulated wand controls

The simulated wand controls (buttons & joystick) are selected by the configuration option "Wand simulator".

Pressing the mouse buttons corresponds to pressing the wand buttons. Holding down the spacebar while moving the mouse controls the joystick values. Note that the joystick controls set the X and Y values based on the current position of the mouse on the screen, rather than the mouse's relative movement (i.e. the top of the screen is Y=1.0, etc.). The joystick is reset to (0,0) when the spacebar is released.

 
1.4 Simulated display

The simulated display is selected by using the "simulator" wall (or "simulator1" or "simulator2") in the Walls configuration option.

There are three display modes for the simulator wall. In mode 0, it displays what would be rendered on one of the CAVE walls; in mode 1, it displays a normal perspective view of the application's environment from the position of the user's head; and in mode 2, it displays a third-person view showing the user inside the CAVE.  The simulator views can also show the position of the user's head and of the wand, the current frame rate, and the outline of the physical CAVE, and can black-out the parts of the scene which would not be visible due the lack of right, back, and ceiling walls.

The keyboard controls for these options are:

     0 ...... Switch to "wall-view" mode
     1 ...... Switch to user centered Perspective mode
     2 ...... Switch to Outside the CAVE mode
     D .......... Switch to "Desk mode" (for outline & blackout)
     C .......... Switch to "CAVE mode" (for outline & blackout)
     T .......... Toggle timing (frame rate) display
     W .......... Toggle display of wand
     U .......... Toggle display of user (head)
     INSERT ..... Toggle display of CAVE/Immersadesk outline
     DEL ........ Toggle blackout of right, rear, and ceiling walls
     H .......... Print help text
When in wall-view mode (mode 0), the following keys select which wall's display is rendered:
 
     F ........ front wall
     L ........ left wall
     B ........ floor ("bottom")
     R ........ right wall
     D ........ Immersadesk (screen7)


When using the outside-the-CAVE view, you can move the viewpoint around with the following controls:

 
     KEYPAD ARROWS (2,4,6,8) .... Rotate the viewpoint
     KEYPAD -/+ ................. Zoom in/out
     KEYPAD 5 ................... Reset the viewpoint


Ron Kriz Virginia Tech
VT-CAVE
Revised 3/16/01

http://www.sv.vt.edu/future/cave/software/atomview/_install_atomview.html