VoxR (version 1.0.0)

plot_voxels_full_grid: Voxel cloud visualization when voxel cloud includes the empty voxels.

Description

Voxel cloud visualization when voxel cloud includes the empty voxels. Filled voxels are plotted as plain vertices and only the edges of empty voxels are plotted.

Usage

plot_voxels_full_grid(data, res, ecol, fcol, lwd, alpha, plot, message)

Arguments

data

a data.frame or data.table containing at least the voxel cloud x, y, z coordinates.

res

numeric. The voxel resolution. If not provided, the function will guess it.

ecol

color for the edges of empty voxels.

fcol

color for the facets of filled voxels.

lwd

numeric. The line width for the edges of empty voxels.

alpha

numeric. The transparency of the voxel facets for filled voxels.

plot

logical. Plot the voxels ? See return for mesh capture. Default = TRUE.

message

logical. If FALSE removes the message from the resolution guessing.

Value

At anytime the mesh object that enables to plot the voxels can be captured to plot it using the shade3d function from rgl. The returned object is a list containing the 3D mesh of filled and empty voxels separately.

Examples

# NOT RUN {
#- import tls data
tls=data.table::fread(system.file("extdata", "Tree_t0.asc", package="VoxR"))

#- voxelisation with full.grid option
voxels=VoxR::vox(tls,0.3,full.grid = TRUE)

#- plot the voxels
VoxR::plot_voxels_full_grid(voxels)
# }