Display Three-Dimensional (D3D) User's Guide


2. Getting to Know D3D

The three-dimensional (3D) workstation application, D3D, allows you to display and manipulate graphic and image products, and work with gridded model data. Subsection 2.1, "First Things to Know About D3D," provides the information needed to start, set up, and exit the D3D workspace and gives a brief introduction to D3D. It also includes a practice module that covers this information. Some topics covered in Subsection 2.1 are addressed in more detail in later subsections. Subsection 2.2, "Working with Graphic and Image Products," contains several practice modules that illustrate basic display capabilities.

The Volume Browser, which provides access to numerical models and other gridded data sources, is covered in Subsection 2.3. This subsection is very detailed in describing the many rendering techniques available, as well as describing the general features of the Volume Browser.

2.1 First Things to Know About D3D

Figure 1 shows the hardware components of the AWIPS Workstation.

Figure 1. The AWIPS Workstation.

The input devices for the graphics monitors are a keyboard and a single three-button mouse. Mouse Buttons are designated by number, as shown in Figure 2, which also gives the functions and user interface locations of each Mouse Button action.

Figure 2. Right-Handed Mouse Button and Button Functions

Most mouse actions are invoked with Mouse Button 1. For a right-handed mouse, Button 1 is on the left. All references in this Guide to the use of a Mouse Button (e.g. click on the selector...) refer to Mouse Button 1 unless otherwise noted.

The actions associated with each Mouse Button are described in more detail in "Viewing Modes," found in Subsection 2.3, "The Volume Browser."

2.1.1 Input Devices

There are two devices that enable you to input information into the D3D graphical interface regarding actions you want to invoke: a Three-Button Mouse and a Keyboard. Currently, there are no Accelerator Keys.

2.1.2 Start Up and Exit

Figure 3. Start D3D.

2.1.3 Layout of the D3D Graphics Display

From the system's point of view, the entire D3D interface is a window. As such, it can be moved, minimized (iconified), restored, etc., in the same way as any other window displayed by the system.

The D3D application is partitioned into three separate windows: a set of Menu Bars at the top of the screen, a Large Display Pane, and the D3D Volume Browser (Figure 4). The Graphics Display Window is a standard X-window and has the basic X-window controls in its title bar, as do all windows in the application.

Figure 4. D3D - Vis5D Application Windows.

2.1.4 Windows, Tooltips, Menus, and Dialog Boxes in D3D

The behavior of windows, tooltips, menus, and dialog boxes in D3D are identical to the behavior found in D2D. Refer to the AWIPS D2D User's Guide Subsection 2.1.4, "Windows, Tooltips, Menus, and Dialog Boxes in D2D," for detailed information.

2.1.5 Other D3D Operational Information

This subsection contains additional information on the operational behavior of D3D.
Figure 5. The D3D Status Dialog Box.
Figure 6. The D3D Announcement Dialog Box.

2.1.6 The Menu Bar

The following subsections contain descriptions of each menu button displayed along the Menu Bar, moving from left to right. The Menu Bar consists of menu buttons which open pull-down menus. Keep in mind that some menu options require more detailed explanation, which are provided in subsequent subsections of this User's Guide. Figure 7 shows the D3D Menu Bar.

Figure 7. D3D Menu Bar.

NOTE
Bundles and scripts accessed through some of the Menu Bar
pull-down menus can automatically load products, but only after
a model is first selected via the Volume Browser. Refer to
Subsection 2.3, "The Volume Browser," for more information.
Figure 8. The File Menu.
Figure 9. The Bundles Cascading Menu.
Figure 10. The Bundle Dialog Box.
Figure 11. The Print Dialog Box.
Figure 12. The Movie Dialog Box.
Figure 13. The View Menu.
Figure 14. The Options Menu.
Figure 15. The Tools Menu.
Figure 16. The Put Home Cursor Dialog Box.

NOTE
The cursor must be in Probe, Sounding, or Trajectory Viewing modes for
the Put Home Cursor Dialog Box to be active, otherwise no action is taken.
Figure 17. The Volume Menu.
Figure 18. The Surface Menu.
Figure 19. The Upper Air Menu.
Figure 20. The Map Menu.

Figure 21. Slider for Movable Map Option.
Figure 22. The Help Menu.

2.1.7 The Toolbar

The following subsections contain brief descriptions of each menu and icon button displayed along the second row of the menu options, called the Toolbar, from left to right on your workstation screen. Refer to Figure 24.

Figure 24. D3D Toolbar.

Certain icon buttons in the Toolbar are check buttons. These icon buttons turn a light gray color when they are in the "on" position. Helpful labels, or Tooltips, appear as you slowly move the pointer over these icons.
Figure 25. The Loop Properties Dialog Box.


Figure 26. The Viewing Modes and corresponding
Mouse Button functions with Normal Mode selected.

Each mode is represented with a different cursor icon (shown at left).
Figure 27. Rotating an Object with the Virtual Trackball.
NOTE
A cross section may be moved while looping is on, however some jumpiness
may occur because new cross sections are computed asynchronously.


2.2 Working with Graphic and Image Products

The application is almost completely controlled using the mouse with a graphical user interface. The best way to learn to use the system is to experiment. There is no way to harm your data from within the application. The Volume Browser is used for data and display preparation. The Large Display Pane is used to view, maneuver, and interact with the data.

2.3 The Volume Browser

The Volume Browser provides access to numerical models and other gridded data sources. Through the Browser interface, you can choose the data source(s), field(s), and rendering technique(s), which generates a customized list of model graphics or images for display.

2.3.1 The Volume Browser Dialog Box

From the Volume Pull-Down Menu on the main Menu Bar, the Volume Browser Dialog Box can be selected. The Menu Bar along the top of the Volume Browser Dialog Box has pull-down menus that contain options for controlling all the various menu choices of the Volume Browser. Figure 28 shows the Volume Browser Dialog Box when opened.

Figure 28. The Volume Browser When Initially Opened.

The Volume Browser is divided into four sections: Each of these areas are discussed in the following subsections.
Figure 29. The Volume Browser Menu Bar - Edit Pull-Down Menu Options.
Figure 30. The Volume Browser Menu Bar - Mode Pull-Down Menu Options.
Figure 31. The Volume Browser Menu Bar - Probe Pull-Down Menu Options.
Figure 32. The Volume Browser Menu Bar - Help Pull-Down Menu Options.
NOTE
Currently, D3D only allows you to display products from one source at a time.


Figure 33. The Volume Browser - Source Pull-Down Menu.
Note - Rendering Techniques Pull-Down Menus
are disabled until a source in selected.
NOTE
Available menu items appear in black, unavailable menu items appear in gray.


Figure 34. The Volume Browser - Plan-View Pull-Down Menu
Showing Choice of Fields to Display.
NOTE
The products are generated asynchronously with the looping, so you may
not see new products for all the time steps as the clock hand makes its
first revolution. These products appear on successive clock revolutions.

NOTE
Only one product at a time can be edited.


Figure 35. The Volume Browser - Plan-View Property Editor Opened.
Figure 36. Colors Editor.
Figure 37. Image Colors Editor.

2.3.2 The Volume Browser - Rendering Techniques

Figure 38. ETA 95 kts Wind Speed Isosurface;
ETA 14.0 g/kg Specific Humidity Isosurface;
ETA 285 K Potential Temperature Isosurface Colored by Pressure.
Figure 39. The Volume Browser - Isosurface Property Editor.
Figure 40. ETA 500MB Wind Speed (kts) Plan-View Displayed as an Image with Contours.
Figure 41. The Volume Browser - Plan-View Property Editor.
NOTE
A cross section may be moved while looping is on, however, some jumpiness
may occur because new cross sections are computed asynchronously.
Figure 42. ETA Grid 32 Wind Speed (kts) Slice Displayed as an Image with Contours.
Figure 43. The Volume Browser - Slice Property Editor.
Figure 44. ETA Wind Speed Volume Visualization.
Figure 45. The Volume Browser - Volume Property Editor.
Figure 46. ETA Surface Temperature (F) Displayed as an Image with Contours.
Figure 47. The Volume Browser - Surface Property Editor.
Figure 48. ETA 500MB Wind with an ETA Vertical
Streamline cross section moved arbitrarily in a sweeping motion.

The new cross section location indicated by numeric labels.
Figure 49. The Volume Browser - Winds Property Editor.

2.4 Other 3D Rendering Techniques

2.4.1 Sampling Techniques

Techniques for sampling data are explained in the following subsections.
Figure 50. ETA Skew-T Plot and Sounding Located over Oklahoma City.

Figure 51. Skew-T Options Pulldown Menu.
Figure 52. Probe Output of ETA Temperature Fields
and Volume Browser - Probe Pull-Down Menu.

2.4.2 Trajectories

Wind trajectories are ribbons that trace the motion of air through the 3D volume, much like smoke trails trace the motion of air in a wind tunnel.

When you select Trajectory from the viewing Mode Menu on the Volume Browser Menu Bar, a pop-up dialog box appears near the bottom of the screen and a 3D Cursor appears inside the 3D View Box. The 3D Cursor is moved using Mouse Button 3 to specify where a new wind trajectory should be made. The selected forecast hour is important because when the trajectory is made, it is traced forward from the current time step to the last time step and is traced backward through time to the first time step. Refer to Figure 53 for an example.

Figure 53. ETA Column of Trajectories Colored by Temperature.

Wind trajectories are dealt with in sets. Currently, eight sets are available. Each set is represented in the Trajectory Dialog Box with a button labeled Set1, Set2,..., Set8, see the inset in Figure 53. Each set can be individually displayed, colored, or deleted. As you create new trajectories you may want to group them in sets corresponding to location, time, etc.

The first step in creating a trajectory is to select a position with the 3D Cursor. Use Mouse Button 3 to drag the 3D Cursor around inside the 3D Box. The 3D Cursor moves in 2-D in a plane parallel to the plane of projection. That is, the cursor stays at a constant distance of depth. By alternately rotating the view box with Mouse Button 1 and placing the cursor with Mouse Button 3, the 3D Cursor can be placed anywhere inside the view box. The North, South, East, and West, and Top Buttons on the Menu Bar, as explained in Subsection 5.2, can also be useful when making trajectories.

Second, you should select a time step to begin the trajectory with the VCR Buttons on the Menu Bar. When the trajectory is made, it is traced forward from the current time step to the last time step and is traced backward through time to the first time step.

Finally, to make a trajectory at the current cursor location and current time step, press Mouse Button 2 when pointing inside the Large Display Pane. The trajectory appears as a line segment. By turning looping on, you can observe how the trajectory travels through time and space. Typically, you repeat the process of positioning the 3D Cursor and clicking Mouse Button 2 to create a set of trajectories.

Interesting results can be seen by making a trajectory when looping is turned on: a trajectory is created for every time step instead of just one. This shows you the path of every air parcel which passes through a single point in space.

Here is a summary of the trajectory functions.

  1. To position the 3D Cursor, use a combination of rotating the view box with Mouse Button 1 and dragging the 3D Cursor with Mouse Button 3.

  2. Use the VCR Buttons or looping option to select a time step.

  3. Press Mouse Button 2 to create a trajectory at the current cursor location and time step.

  4. To toggle the display of a trajectory set on or off, click on the Set Button with Mouse Button 1.

  5. Select the current trajectory set by clicking on the Set Button with Mouse Button 2.

  6. A trajectory set may be deleted with the Delete Set Button in the Trajectories Dialog Box. You are asked to verify your decision.

  7. You can delete the last trajectory made by clicking on the Delete Last Button in the Trajectories Dialog Box.
Wind trajectories can be depicted in two ways: as line segments or as ribbons. You can select ribbons by clicking on the RIBBON Button in the Trajectory Dialog Box. Toggling the RIBBON Button does not effect trajectories you have already made; it only controls how new trajectories are displayed.

The Trajectory Dialog Box also contains two type-in widgets labeled STEP and LENGTH. The STEP value is used to control the step size used in the trajectory tracing algorithm. The LENGTH value is used to control the length of trajectories. 1.0 is the default value for each. Each acts as a multiplier. If you want the trajectory tracer to integrate in steps 1/2 the default size, enter a step value of 0.5. If you want trajectories to be twice as long as the default length, enter a length value of 2.0.

The color of trajectories is controlled in the same way as for isosurfaces. That is, a trajectory set may either be monocolored or colored according to another field. Click on the Trajectory Set Button with Mouse Button 3 to bring up its color window. See the Color Subsection, under Property Editor in Subsection 2.3.1.4, "The Property Editor" for details on using the color window.

When viewing color-mapped trajectories be aware that the color of a trajectory is time dependent. Only the head of the trajectory is colored according to the value of another field for the current time step. The tail of the trajectory is colored according to the color of the other field when the head was at that location.

Return to Table of Contents