BioThermR (version 0.1.0)

plot_thermal_3d: Interactive 3D Thermal Surface Plot

Description

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)

Value

A plotly object (HTML widget).

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.

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)

# 3d plot
plot_thermal_3d(img)
# }