Cylinder

A cylinder primitive describes a cylinder surface in 3d space. Its parameters consists of center, axis and radius, where the axis length is given as a rough guide for visualization.

Formats

Object/Cylinder - This is the node of the parameter or return value representing a 3d plane. Its sub nodes contain the plane parameters and additional information as follows:

• Axis (Array/Vector) - A Vector specifying the axis of the cylinder. The length of the axis is computed from the variance of the cylinder points along the axis and matches the half cylinder length when the point distribution is uniform along the axis (see note below).

  • 0 (Number) - The x direction of the axis.

  • 1 (Number) - The y direction of the axis.

  • 2 (Number) - The z direction of the axis.

• Center (Array/Vector) - A Vector specifying the center of the cylinder. The center point is the center of gravity in axis direction of the cylinder’s points.

  • 0 (Number) - The x position of the center.

  • 1 (Number) - The y position of the center.

  • 2 (Number) - The z position of the center.

• Radius (Number) - The radius of the cylinder.

Note

The axis length is derived from the point position variances along the computed cylinder axis and assumes uniform point distribution along the axis. In general the fitted cylinders will not satisfy this assumption because the cylinder might have holes or asymmetrical occlusions. In these cases the axis length will only roughly approximate the true half cylinder length and should only be used for visualization!