3D visualization

The 3D volume view displays existing named signals through the acquisition, either together as an overlay or separately in tiles. Use it to explore spatial and depth patterns; the displayed volume is a downsampled preview.

Choose signals and a layout

The 3D signals list contains all the named signals in your data. The current image signal is initially shown. Select the signals to display, then open a signal’s settings to adjust its colormap, opacity, and intensity threshold. For example, a 70% threshold hides the weakest 70% of positive preview values, making stronger features easier to see while potentially hiding weaker intensities within the signal.

By default, all signals are stacked on top of each other in the Overlay view. You can select Overlay or Tiles under View to change this setting. Tiles will show up to four signals per page side by side for comparison. Transparent overlays are qualitative and can hide one signal behind another; inspect a single signal or use tiles to investigate occlusion.

You can choose Fast or Detailed under View to control the level of detail in the 3D view.

Two signals are shown as an overlay in the 3D volume view.

Each signal has its own display settings.

Adjust the display

Open Display settings to choose the intensity scale, log colors, and depth exaggeration or frame stretch.

• Independent and Shared control the intensity scale. Independent scales are the default; Shared uses one numerical range across visible signals, which can potentially cause strong signals to overwhelm weak ones.
• The upper display limit uses the 99.7th percentile of positive preview intensities. Log colors displays log(1 + intensity) to improve interpretability; depth profiles and exports retain their original numerical intensities.
• Frame stretch changes the displayed depth scale linearly. When depth is shown in frames, you can adjust the ratio of depth to X/Y to approximate a known feature’s proportions.

Display settings apply across the 3D view; frame stretch is shown when depth uses frames.

The current ROI and Viewing depths apply to every layer. The 3D view offers All frames and Frame range to limit what frames are shown in the 3D preview.

Moving the camera

Click and drag or use the arrow keys to orbit the volume, scroll to zoom, and Shift-drag to pan. The Camera controls offer axis-aligned preset views, rotations in 15° steps, a Reset camera feature, and a toggle between perspective or orthographic projection. Camera controls apply to all tile cameras. The viewer also has a maximize button to increase the screen area of the 3D view.

Technical details of the 3D preview

Fast previews are capped at 96 × 32 × 32; Detailed previews at 160 × 48 × 48. All visible layers share a 500,000-voxel budget, including layers on other tile pages (a voxel is a single cell in the 3D preview — a three-dimensional pixel). These limitations are aimed at keeping the application responsive with large datasets.

The preview usually shows each signal as a continuous 3D volume. Some selections, such as a single thin layer or a signal with missing data, are shown as individual points instead. When the preview combines nearby measurements, it averages only the data that are available; missing data are not filled in.

If measurements are unevenly spaced, ToFScope may estimate values between them to draw the 3D preview and will show a warning. Very wide, narrow, or deep views can also lose fine detail; a warning appears when detail may be missed.

When viewing data with calibrated depth, frames with unknown depths are left out of the preview. The preview combines nearby frames and averages their known depths, including across calibration anchors. Profiles, measurements, and exports still use the original-resolution data.

After customizing a 3D view, using the Save as button to save a ToFScope analysis will preserve layer styles, layout, page, scale, cameras, and display settings.