The 3D Scene

This topic describes how to interact with the 3D scene. It is divided into:

• Navigating in the Scene
• Viewing Object Details
• Locating an Object from the Scene
• Measuring in the Scene
• Working With Split Views

How to change the way objects are displayed in the scene is described in a separate topic, Visualising Data.

The slicer is a powerful tool for revealing data that is concealed behind other objects and for emphasising data; it is described in a separate topic, Slicing Through Data in the Scene.

Navigating in the Scene

The best way to navigate the 3D scene in Leapfrog Energy is using the mouse. If you are running Leapfrog Energy on a laptop, it is recommended that you plug in a mouse rather than using the laptop’s touchpad for navigation. However, you can also navigate in the scene using the keyboard.

Action	Mouse	Keyboard
Changing the viewing angle	Click and drag to rotate the scene	Press the arrow keys to rotate the scene For smaller steps, hold down the Shift key while pressing the arrow keys
Zooming in and out of the scene	Use the scroll wheel Hold the right mouse button while moving the mouse	Press the Page Up or Page Down keys For smaller steps, hold down the Shift key while pressing the Page Up or Page Down keys
Panning the scene	Click and hold both mouse buttons, then drag Hold the scroll wheel and drag	Hold down the Alt key while pressing the arrow keys
Centre an object in the scene	Click the scroll wheel Click both mouse buttons together

Use the Look menu above the scene window to switch to different viewing angles:

If you prefer to navigate using the keyboard, use the following keyboard shortcuts:

Key(s)	Action
Arrow keys	Rotate the scene in 10 degree steps
Shift+Arrow keys	Rotate the scene in 2 degree steps
Home	Reset the view, showing all visible objects in scene
U, D, E, W, N, S	Look Up, Down, East, West, North and South
L	Look at the slicing plane
Shift+L	Look at the back of the slicing plane
M	Look at the moving plane
Shift+M	Look at the back of the moving plane
Ctrl+M	Look down the moving plane pitch
Shift+Ctrl+M	Look up the moving plane pitch
P	Select Perspective view
O	Select Orthographic view
Ctrl+Delete	Clear the scene
Ctrl+B	Bookmark the viewing angle and zoom
B	Display the bookmarked viewing angle and zoom
Ctrl+’	Save the scene
Ctrl+C	Copies the scene to the clipboard. The image can then be pasted into another application, such as an image editor.
Ctrl+/	Add the slicer to the scene. Press Ctrl+/ to remove the slicer from the scene.
Ctrl+;	Add the moving plane to the scene. Press Ctrl+; to remove the moving plane from the scene.

The current viewing angle and scale are displayed in the lower right-hand corner of the scene window:

You can change how the viewing angle and scale are displayed in the Overlays tab of the Settings window.

You can save the current viewing angle as a bookmark by selecting Bookmark Viewing Angle from the Look menu or by pressing Ctrl+B. Restore the bookmark by selecting Look > Restore Bookmark or by pressing B.

The scene window displays a 3D representation of selected data from the project tree. You can add objects from the project tree to the scene in two ways:

• Click on the object and drag it into the scene. Hold down the Shift key or the Ctrl key while clicking to select multiple items, then add them to the scene.
• Right-click on the object and tick the View Object box.

Once you have added objects to the scene window, you can change the appearance of those objects using the controls in the shape list and the shape properties panel.

This is described further in Visualising Data.

All objects in the shape list have a button () that will remove the object from the scene. Most objects also have a visibility button () that can temporarily hide that object in the scene. It is often easier to make an object temporarily invisible than to remove it from the list. Some objects have an edit button () that you can click to begin editing the object.

Viewing Object Details

Clicking on an object in the scene displays a Scene Details panel that contains a summary of the data. For example, here drilling data is displayed in the scene and clicking on a segment displays information about the selected segment. For drilling data, this information includes the hole ID for the selected segment, location information for the interval, the downhole depth and the values for the different data columns in the table:

The column used to display the data is shown in the list in bold text, as is the case for the RockType column above.

You can change which columns and evaluations are displayed in the list by clicking on the Edit Details button () and selecting which items you want displayed:

You can keep the Edit Details Filter window open while adding and removing items.

Once you have selected a subset of details, toggle between them using the filter button ():

The width of the scene details panel can be resized, revealing long labels or values.

• By default, the relative column size ratio is preserved when adjusting the scene details panel width.
• You can adjust the label column width independently, and once you have selected a label column width, that preference is preserved.
• To return to the default column width ratio that adjusts both columns when the scene details panel is adjusted, right-click on the panel and select Reset Column Widths.
• When column width adjustments are insufficient to reveal an entire label or value, click on the expand/collapse chevron to reveal the entire label or value, wrapped to multiple lines within the current column width. If the row is for an object with child rows, these will also expand.

If all rows are collapsed, you can double-click on the column separator to get a minimum-width label column.

You can copy information from the scene details panel by right-clicking on a row and selecting Copy. The scene details header, containing the name of the object selected in the scene, along with the row label and value, will be copied to the clipboard ready for pasting elsewhere. Alternatively, you can select Copy Header from the menu, and only the selected object name will be copied to the clipboard. If you wish to only copy the row label or value, double-click on the information you want to copy to the clipboard, then right-click on the selection and select Copy.

Different objects will display different information in the scene details panel. Here information about a surface is displayed, including the volume, area, number of parts and whether or not the mesh is open or closed:

Many objects will have an Open option you can click on to work on the object. For drilling data tables, doing this will open the table. For contact surfaces, as shown here, doing this will open the surface’s Edit dialog:

From the panel, you can also add comments to the object.

You can display the Scene Details panel docked to the scene or floating. In the examples above, the panel is docked. To float the window, click and hold on its upper edge and drag it. The window will pop out and you can position it where you wish.

To dock the panel, drag it into the lower lefthand corner of the scene until the panel turns transparent. When you release the mouse button, the panel will dock.

You can use keyboard shortcuts to navigate the scene details panel, like you would navigate the project tree.

Key(s)	Action
Up and down arrows	Navigate up and down the object details list
Right arrow or Shift + Right arrow	Expand collapsed row
Left arrow or Shift + Left arrow	Collapse expanded row
Ctrl+shift+right arrow	Expand all collapsed rows
Ctrl+shift+left arrow	Close all expanded rows

Locating an Object from the Scene

When you have a number of objects displayed in the scene, it may not be readily apparent where you can find more information about those objects. The fastest way to locate the object in the project tree is to:

1.   Click on the object in the scene.

This selects the object in the shape list.

2.  Right-click on the object in the shape list.

3.  Select the Go to Project Tree option.

Measuring in the Scene

Leapfrog Energy has a number of tools for making quantitative measurements in the scene. These include:

• Clicking on an object in the scene. This will open a window containing more information about the object.
• Viewing an object’s properties to determine its size. Right-click on the object in the project tree and select Properties. Information on the size of the object will be displayed in the General tab.
• Using the cursor to determine an approximate location in the scene. See Determining a Location.
• Using the moving plane to measure trends. See The Moving Plane.
• Using the ruler to measure in the scene. See The Ruler.

Determining a Location

The simplest way of measuring an approximate location in the scene is to first display an object in the scene window, then position the cursor over the location. The position of the cursor is displayed at the bottom of the Leapfrog Energy window:

The position of the cursor in the scene is calculated using the depth buffer on the graphics card and so is not an exact method of measuring in the scene.

If you require an exact position, click on the object. Leapfrog Energy will compute the exact position of the point highlighted in the scene and display it in a pop-up window:

The Moving Plane

In Leapfrog Energy, the moving plane is used for measuring planar structures and defining coordinate system orientations. There are two tools in the toolbar that relate to the moving plane:

To use the moving plane, click the Show plane button () and position the plane in the scene. The main axis of the moving plane is defined by the green line. The second axis is defined to be in the plane at right angles (orthogonal) to the main axis. Third axis is perpendicular to the plane.

There are three ways to position the plane. You can:

• Use the handles in the scene window to move the plane. If you cannot see the handles, click on the moving plane.
• Use the Plane controls in the shape properties panel to change the Dip, Dip Azimuth, Pitch and Centre Point.
• Orient the scene to look parallel to the required plane position, then click on the Draw plane line button (). Draw the required line in the scene.

Plane movement can be aligned to the Axes or to the Camera:

• With the Axes option, the handles move in cartesian coordinates. .
• With the Camera option, the handles move relative to the camera angle.

Drawing the plane line is usually the most convenient method of defining a planar structure.

To remove the moving plane from the scene:

• Click the Show plane button ().
• In the shape list, click the delete button () for the moving plane.

Use the following keyboard shortcuts to control the moving plane:

Key(s)	Action
Ctrl+;	Add the moving plane to the scene. Press Ctrl+; to remove the moving plane from the scene.
M	Look at the moving plane
Shift+M	Look at the back of the moving plane
Ctrl+M	Look down the moving plane pitch
Shift+Ctrl+M	Look up the moving plane pitch

The Ruler

You can use the ruler to measure distances in three dimensional space and between wells and planned wells.

The easiest way to use the ruler is to click on the Ruler button () and click and drag between points in the scene to start making measurements. A ruler line will appear in the scene to indicate the measurement. Information about the distance measured will appear in the scene and in the shape properties panel:

The ruler tool stays active in the scene so you can make as many measurements as required.

You can also measure the distance between wells or between wells and a point. To do this, add the ruler to the scene, then click on the Calculate Distance button in the shape properties panel. The Distance Calculator window will appear:

You can select both wells and planned wells. Click Calculate to calculate the distance and update the ruler in the scene. The distance value will appear in the Distance Calculator window.

You can also select a point in the scene by clicking the Select button () in the Distance Calculator window, then clicking in the scene. The location of the point in the scene will appear in the Distance Calculator window.

There are two ways to remove the ruler from the scene:

• Click the Select button ().
• Click the delete button () for the ruler object in the shape list.

Working With Split Views

The Split View button () in the toolbar allows you to view up to two alternative views of the objects displayed in the scene:

The alternative views available are a Plan View or a Zoomed Out view:

You can also open an alternative view in a new tab by choosing the New Split View Tab option:

You can resize the scene and the alternative views and Leapfrog Energy will remember the position of each view when you switch to that split view again.

To return to displaying only the scene view, click the Split View button ().

Each alternative view has a toolbar that gives you different options for displaying the view. Use the Enclose Object list to zoom into or out of the alternative view:

The list displayed includes all objects available in the project, plus the clipping boundary and the current scene view.

Click the Visibility button to change what objects from the scene view are visible in the alternative view:

An object must be visible in the scene view’s shape list for its visibility to be controllable from the alternative view’s Edit Visibility list. What this means is that objects hidden in the scene view cannot be made visible in an alternative view.

When the slicer is in the main scene view, you can display the contents of the alternative view sliced or unsliced. Click the View Unsliced button (). The slicer, shown in blue in this image, remains displayed in the alternative views, but the view’s contents are displayed unsliced:

In alternative views, you can display a view window that shows what part of the alternative view is displayed in the scene view. Click the Enable View Window button ():

Each alternative view has a Settings button () that lets you change what overlays are displayed for that view. The alternative view can use the scene view settings, or you can customise the display of the screen grid, axis lines and scale bar: