fit_plane

NAME

fit_plane - fit a plane to a point cloud.

SYNOPSIS

fit_plane [-?|-h|--help] [-e INTEGER|--export INTEGER] [-t DOUBLE|--threshold DOUBLE]

DESCRIPTION

fit_plane finds the plane which better fits a given point cloud. If the option --threshold is used, outlier points are not included. In a first phase, an estimate of the shape is computed using the RANSAC algorithm. The minimum number of points necessary to define a plane is 3. A sample of 3 point sets is randomly chosen from the point cloud. For each of them, a plane shape is chosen. The best one is then kept (the one closest to a maximum of point). In a second phase, this estimate is refined, computing a least square estimate using the Levenberg-Marquardt algorithm. The input point cloud is read from the standard input and the result is returned to the standard output.

OPTIONS

-h,--help,-?

Returns the manual page.

-e INTEGER, --export INTEGER

INTEGER is the type of data which is returned to the standard output: [0: general shape description: name, tolerance, normal, distance to origin (default), 1: triangle cloud, 3: three points defining the plane, 4: inliers, 5: outliers]

-t DOUBLE, --threshold DOUBLE

Only points closer than DOUBLE are considered (default: no threshold).

-v,--verbose

Be verbose.

AUTHORS

Written by Pierre Smars (first version: 2008)

BUGS

Reports of bugs or problems should be submitted via electronic mail to <smars@yuntech.edu.tw>.

COPYRIGHT

Copyright (C) 2012 Pierre Smars. License GPLv2 <http://www.gnu.org/licenses/gpl-2.0.html>. This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

SEE ALSO

fit_line(1), fit_circle(1), fit_sphere(1), fit_quadric(1)

Pierre SMARS (tools, home page)