molaR (version 6.0)

ARC3d: Plot Area Relative Curvature (ARC) on a surface (HTML widget; continuous bar legend)

Description

Creates a three-dimensional rendering of Area Relative Curvature (ARC) on a mesh and returns an HTML widget with a continuous, vertical color-bar legend. Curvature is split into four negative and four positive bands (quantiles on each side of zero) for per-face coloring. The legend uses a single blended bar assembled from the same eight colors used on the surface, with negative values at the bottom and positive values at the top.

Usage

ARC3d(
  ARC_object,
  main = "",
  cex = 1,
  colors = c("darkblue", "blue", "powderblue", "gray", "gray", "tan", "orange",
    "darkorange1"),
  fieldofview = 0,
  legend = TRUE,
  widget_size_px = 768,
  scene_zoom = 1.5,
  leftOffset = 0,
  title_font_size_px = 30,
  legend_magnify = 1,
  legendTextCol = "black",
  legendLineCol = "black",
  fileName = NA,
  binary = FALSE
)

Value

An htmltools::browsable object containing the title, 3D widget, and legend.

Arguments

ARC_object

An object that stores the output of ARC(), including $Mean_Face_Curvature and $plyFile (an rgl::mesh3d).

main

Character; plot title (default "")

cex

Numeric; relative size multiplier for legend text (default 1)

colors

Character vector of length >= 8 with the eight display colors for the curvature bands. Defaults match the classic ARC3d: c("darkblue","blue","powderblue","gray","gray","tan","orange","darkorange1"). These eight colors are used both for the surface and for the legend bar.

fieldofview

Numeric; field of view in degrees; 0 = isometric (default 0)

legend

Logical; show legend panel (default TRUE)

widget_size_px

Integer; square size of the 3D widget in pixels (default 768)

scene_zoom

Numeric; initial zoom on the 3D scene (default 1.5)

leftOffset

Numeric (-1..1); small horizontal camera nudge (default 0)

title_font_size_px

Integer; title font size in pixels (default 30)

legend_magnify

Numeric; additional legend scale factor (default 1)

legendTextCol

Legend text color (default "black")

legendLineCol

Legend border color for the bar box (default "black")

fileName

Character or NA; if non-NA, write a colorized *.ply to disk (default NA)

binary

Logical; write PLY as binary (default FALSE, i.e., ascii)

Details

Run ARC() first to compute per-face ARC values.

Binning scheme: The mean face curvature values are split by sign. For negative values, the empirical quartiles (Q1..Q3) define three internal boundaries, creating four bins below zero; the same is done for positive values above zero. The eight bins map to the eight provided colors. The legend bar is a continuous CSS gradient built from those same colors so that the bar visually matches the surface and blends smoothly from one band to the next. Tick labels are shown at LowQs, 0, and HighQs (top to bottom = high to low).

Examples

# ARC_out <- ARC(Tooth)
if(interactive()){ARC3d(ARC_out, main = "Area Relative Curvature")}