plotBarrierTree3D: Plot Barrier Tree in 3D

Description Usage Arguments Details Value Examples


Creates a 3D surface plot containing the barrier tree of this cell mapping.


plotBarrierTree3D(feat.object, control)



A feature object as created by createFeatureObject.


A list, which stores additional control arguments. For further information, see details.


Possible control arguments are:

  • Computation of Cell Mapping:

    • gcm.approach: Which approach should be used when computing the representatives of a cell. The default is "min", i.e. the observation with the best (minimum) value within per cell.

    • gcm.cf_power: Theoretically, we need to compute the canonical form to the power of infinity. However, we use this value as approximation of infinity. The default is 256.

  • Plot Control:

    • bt.margin: Margins of the plot as used by par("mar"). The default is c(0.5, 1, 0, 0).

    • bt.color_surface: Color of the surface of the perspective plot. The default is "lightgrey".

    • bt.color_branches: Color used for the branches of the barrier tree. Per default there will be one color per level.

    • bt.persp_border: Color of the lines / borders around each facet of the perspective plot. The default is "grey".

    • bt.persp_shade: A ratio defining the shade of the surface. The default is 0.35.

    • bt.persp_{theta, phi}: Angles (in degree) defining the viewing direction of the perspective plot. theta corresponds to the azimuthal direction (default: 330) and phi to the colatitude (default: 15).

    • bt.persp_{xlab, ylab, zlab}: Labels of the x-, y- and z- axis. The defaults are expression(x[1]), expression(x[2]) and expression(f(x[1], x[2]))

    • bt.persp_ticktype: Should the values of each dimension be shown in detail ("detailed") or just via "simple" arrows in direction of increasement along the axes? The default is "detailed".

    • bt.col_root: Color of the root symbol. The default is "red".

    • bt.pch_root: Symbol used for plotting the root. The default is 17 (filled triangle).

    • bt.pch_breakpoint: Symbol used for plotting a breakpoint. The default is 5 (non-filled diamond).

    • bt.pch_basin: Symbol used for plotting the leaf (i.e. a basin) of the barrier tree. The default is 19 (filled circle).

    • bt.lwd: Width of the lines used for plotting the branches of a barrier tree. The default is 2.


A 3D-surface plot, visualizing the barrier tree of this cell mapping.


# create a feature object
X = createInitialSample(n.obs = 900, dim = 2)
f = smoof::makeAckleyFunction(dimensions = 2)
y = apply(X, 1, f)
feat.object = createFeatureObject(X = X, y = y, fun = f, blocks = c(4, 6))

# plot the corresponing barrier tree

Search within the flacco package
Search all R packages, documentation and source code

Questions? Problems? Suggestions? or email at

Please suggest features or report bugs with the GitHub issue tracker.

All documentation is copyright its authors; we didn't write any of that.