pre_process_mesh: Process a 3D soil mesh for analysis

In evanmascitti/soilmesh: Processes 3D Meshes Without Headaches

Description

Pipe together several other internal processing functions to allow a single call to adjust the mesh coordinates to real-world values.

Usage

pre_process_mesh(mesh, rot_tr_matr, ...)

Arguments

mesh	a mesh3d object
rot_tr_matr	a 4x4 roto-translation matrix. User can select a matrix from the date of calibration (these matrices will eventually be stored in the rot_tr_matrices data object inside soilmesh; the method development matrix already exists as an object ([method_development_rtmatrix()']). Alternatively, the matrix can be manually specified.
...	other arguments passed to remove_cyl(), should user wish to adjust the radius of retained mesh vertices

Details

Order of operations is important. The steps are as follows:

1. Sample is rigidly (i.e. no deformation or scaling) re-oriented using a user-specified roto-translation matrix.

2. Sample is trimmed of any points more than 50 mm beneath x-y plane. This removes points registered from the scanner turntable or the cylinder base to ensure step (3) is performed accurately.

3. Sample is adjusted in the x and y directions based on its largest values in these dimensions; this returns the true center of the specimen to the horizontal origin (i.e. x=0 and y=0)

4. Remove the specimen holder and the outermost ring of soil (default radius is 70 mm per remove_cyl())

5. Sample the z-elevations and adjust sample accordingly; see adjust_z()

Value

processed mesh3d object

evanmascitti/soilmesh documentation built on Sept. 30, 2021, 7:57 a.m.