ivue: Interactive 3D Visualization of Data and Graphs

Description

Explore three-dimensional point clouds and embedded graphs with numerical or categorical annotations, reusable color scales, and geometric layers.

Start here

Open Finding your way around ivue to choose a task, or Example data and recipes for reproducible inputs. The small example below constructs a point cloud with a named numerical annotation; print view interactively to display it. Plotting requires the optional rgl package: install.packages("rgl"). Color mapping and prepare.graph() work without it. No XQuartz setup is required.

plot3D.plain() shows a point cloud, plot3D.cont() maps numerical values, and plot3D.groups() maps categorical annotations. Each returns a browser widget. Printing it in RStudio opens the Viewer; in an interactive R console it opens the browser. Function execution itself does not launch a browser. Use htmlwidgets::saveWidget() to export HTML for later viewing or sharing.

prepare.graph() exposes IDs, edge order, and attributes before rendering. plot3D.graph() accepts that object with supplied coordinates or an explicit layout. Weights do not automatically control edge width or color.

Guides

Five installed vignettes provide complementary starting points:

• Finding your way around ivue: task-oriented function catalog.

• Example data and recipes: reproducible inputs and reusable recipes.

• Point clouds and weighted graphs: detailed plotting controls.

• Retinal development: data provenance and case study.

• Coordinate animations: recorded frames and export.

From the console, use vignette("function-guide", package = "ivue"), vignette("example-data", package = "ivue"), or vignette(package = "ivue") to list all five. Built package distributions include these guides for offline reading.

Rendering

Widgets use private rgl null-device scenes. The rgl namespace is loaded only when rendering; caller options and the previous device are restored. See vignette("ivue-introduction", package = "ivue") for worked examples.

Author(s)

Maintainer: Pawel Gajer pgajer@gmail.com

Authors:

• Pawel Gajer pgajer@gmail.com

See Also

Useful links:

• https://pgajer.github.io/ivue/

• https://github.com/pgajer/ivue

• Report bugs at https://github.com/pgajer/ivue/issues

Examples

library(ivue)
X <- rbind(a = c(0, 0, 0), b = c(1, 1, 1), c = c(2, 0, 0))
height <- c(c = 0, a = 0, b = 1)
if (nzchar(system.file(package = "rgl"))) {
  view <- plot3D.cont(X, height, legend.title = "Height")
  # Print view interactively to display it; construction opens no window.
}