3D Cuboid
Updated at September 28th, 2023
Cuboid points
The (x,y,z) vertices of each cuboid always follow a pattern: one full face and then the other full face.
These faces may be “front” and “back,” “left” and “right,” or “top” and “bottom,” depending on the cuboid’s rotation.
Cuboid
Face One
Face Two
|
Face of interest
The face of interest is defined by the first four vertices of the cuboid listed in the export file. A face of interest, or side of the cuboid, can be used to designate the front of a car or the direction of movement of an object bounded by a cuboid. Therefore, there is always a default face of interest.
Sama associates may change the default face to a new face of interest in the workspace if they are instructed to define a face of interest on a project. The data will always contain this information, but it will only be meaningful as a face of interest if workers are instructed to actively select a face of interest according to project instructions. In the diagram above, the side bounded by the labeled points 0,1,2,3 is the face of interest.
📘Note
The cuboid vertex export order can be used to define a face of interest.
Cuboid dimensions
Center
The position_center (x,y,z) is the center point of the cuboid
Length
The cuboid length goes along the x-axis
Width
The cuboid width goes along the y-axis
Height
The cuboid height goes along the z-axis
Cuboid Direction
Direction is the roll, pitch, and yaw of the cuboid. Using direction, it is easy to determine any faces of interest (such as the front of a cuboid that may represent the front of a vehicle).
Roll
Pitch
Yaw