Interactive 3D Thermal Surface Plot — plot_thermal

Generates a rotatable, interactive 3D surface plot using the 'plotly' engine. This visualization maps temperature to the Z-axis, allowing users to intuitively explore the thermal topology, gradients, and intensity of hotspots.

Usage

plot_thermal_3d(img_obj, use_processed = TRUE)

Arguments

img_obj: A 'BioThermR' object.
use_processed: Logical. If TRUE (default), uses the 'processed' matrix (where background is likely NA). If FALSE, uses the 'raw' sensor data.

Value

A plotly object (HTML widget).

Details

3D visualization is particularly powerful for:

Quality Control: Quickly identifying noise spikes or "cold" artifacts that flat heatmaps might hide.
Gradient Analysis: Visualizing how heat dissipates from a central source (e.g., a tumor or inflammation site).
Presentation: Creating engaging, interactive figures for HTML reports or Shiny dashboards.

The output is an HTML widget that allows zooming, panning, and hovering to see specific pixel values.

Examples

# \donttest{
# Load raw data
img_obj <- system.file("extdata", "C05.raw", package = "BioThermR")
img <- read_thermal_raw(img_obj)

# Apply automated segmentation
img <- roi_segment_ebimage(img, keep_largest = TRUE)
#> Auto-Segmentation: Kept largest object ( 401 pixels )

# 3d plot
plot_thermal_3d(img)

# }