longbone_Analysis reads the available 3D models stored in Wavefront OBJ file format present in some folder and calls the longbone_Geometry function to analyze their geometric properties in a serial manner. The user is prompted for the directory to read from and subsequently the type of bones that should be analyzed. All available 3D bone models are evaluated but only those that explicitly match the user selection are fully processed and their corresponding geometric properties stored in the corresponding CSV files in the current working directory. The generated CSV files follow the naming conventions used by the longbone_Geometry function.

longbone_Analysis ("custom") will accordingly utilize the longbone_CustomGeometry function and, besides the folder containing the 3D models and the user selected types of bones for processing, it will also pass the respective Meshlab PickedPoints filename with the custom sectioning points. These files must reside in the same folder with the 3D models and their base filename must be appended with "-custom" with respect to the OBJ filename. For example, assuming a 3D model named "bone_ID.obj", the corresponding custom sectioning points file must be named "bone_ID-custom.pp".

longbone_Analysis (points) will optionally utilize the longbone_CustomGeometry by parsing a preset numerical vector for custom sectioning points as ratios along the long bone’s maximum distance. Similarly to using the "custom" optional argument, the generated CSV files will follow the naming conventions used by the longbone_CustomGeometry function.

longbone_Analysis ("fragment") will utilize the longbone_FragmentGeometry function, which only requires the folder containing the 3D models, but ignores their bone type since it is not required for the relevant CSG computations. The user is only prompted for this folder, which must also contain the corresponding Meshlab PickedPoints files whose base filename must be appended with "-fragment" with respect to the OBJ filename. For example, assuming a 3D model named "bone_ID.obj", the corresponding custom sectioning points file must be named "bone_ID-fragment.pp".

Under all batch processing schemes except for the "fragment" option, the initial alignment points for each 3D model are either read from the corresponding Meshlab PickedPoints file (e.g. "bone_ID.pp"), if present in the same folder with the OBJ file, or they are automatically registered with the longbone_Registration function. In either case, the opitimized alignment points are saved in the corresponding Meshlab PickedPoints file with the same base filename. For example, assuming a 3D model named "bone_ID.obj", the corresponding initial alignment points file must be named "bone_ID.pp". Note that existing files will be overwritten, hence apart from the required initial alignment points, other points will be lost. Type help longbone_Geometry for more information about initial alignment points.

See also: inspect_CSG, longbone_CustomGeometry, longbone_FragmentGeometry, longbone_Geometry

Source Code: longbone_Analysis