OPC3d: Plot results of OPC analysis of a surface

Description

A function that produces a three-dimensional rendering of face orientation on a surface. The OPC function will identify the orientations of mesh faces and assign them to patches. It must be performed prior to using the OPC3d function.

Usage

OPC3d(OPC_Output_Object, fieldofview = 0, legend = TRUE, binColors = hsv(h
  = (seq(10, 290, 40)/360), s = 0.9, v = 0.85), patchOutline = FALSE,
  outlineColor = "black", maskDiscard = FALSE, minimum_faces = 3)

Arguments

OPC_Output_Object

An object that stores the output of the OPC function

fieldofview

Passes an argument to par3d changing the field of view in dregrees of the resulting rgl window

legend

Logical indicating whether or not a legend should be displayed

binColors

Allows the user to change the colors filled in for each directional bin

patchOutline

logical whether or not to outline the patches

outlineColor

parameter designating which color to outline the patches in

maskDiscard

logical indicating whether to discard the unused patches

minimum_faces

value for the minimum number of faces a patch must contain to avoid being discarded

Details

This function will assign a uniform color to all faces on the mesh surface that share one of the 8 orientations identified by the OPC function. The function returns a colored shade3d of the mesh so that patches can be visually inspected. Future versions will include the option to black out patches not included in the orientation patch count.

fieldofview is set to a default of 0, which is an isometric projection. Increasing it alters the degree of parallax in the perspective view, up to a maximum of 179 degrees. colors will support any vector of 8 colors, in any coloration scheme. Default draws from the hsv color space to evenly space color information, however user can supply a list of RGB values, character strings, or integers in place.