# ExtractSphere3D

The ExtractSphere3D function Functions are tools that are available in Spreadsheet for processing and analyzing acquisitions or other results. You can add functions to your Spreadsheet job to create tool chains and produce results for specific applications. is used to extract one or more spheres from a point cloud A point cloud is a 3D structure that consists of the data points collected by a 3D vision system during acquisition. in a user defined region of interest (ROI). The tool has two modes for sphere extraction:

- Fast mode, using all points to do a least squares fit. This mode extracts a single sphere by fitting the coefficients of a quadratic equation..
- Robust mode, using random sample consensus (RANSAC).

If no sphere is found by the function with the provided configuration, it returns a result with zero length shape, inliers, and residuals. Typically, radius range, math singularity or shape degeneracy can lead to not finding spheres. For example, if all input points are coincident, then the function cannot extract spheres.

The function returns an Spheres3D structure.