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. Calling one of these functions does not by itself open a browser. Use htmlwidgets::saveWidget() to export HTML for later viewing or sharing.

prepare.graph() checks a graph and returns its vertex IDs, edges in a fixed order, and attributes, so that you can inspect them before plotting. plot3D.graph() draws the prepared graph at coordinates that you supply or that a layout computes. Edge weights do not determine edge width or color unless you set these yourself.

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.
}