ptdist

NAME

ptdist - find, for each point of a point cloud, the distance to a given shape

SYNOPSIS

ptdist [-?|-h|--help]

DESCRIPTION

ptdist find, for each point of a point cloud, the distance to a given shape: a point, a line or a plane. It takes its input from the standard input and returns the result to the standard output.

OPTIONS

-h,--help,-?: Returns the manual page

-p X Y Z, --point X Y Z: compute distance to point X Y Z

-l X Y Z NX NY NZ, --line X Y Z DX DY DZ: compute distance to line passing by X Y Z with direction DX DY DZ

-f X Y Z NX NY NZ, --plane X Y Z NX NY NZ: compute distance to plane passing by X Y Z with normal NX NY NZ

-o,--old: Returns the coordinates of the original point. If both option --old and --new are set, the old point is always output first. The distance is always returned last.

-n,--new: Returns the coordinates of the projection of the point on the centre, ray, line or plane.

-r,--ray: Only used when option --line is set. A ray is used instead of a line. If the ray points away from the point, the distance is the distance between the centre and the point.

-tm DOUBLE, --threshold-min DOUBLE: points at a distance smaller than DOUBLE will be assigned DOUBLE

-tM DOUBLE, --threshold-max DOUBLE: points at a distance larger than DOUBLE will be assigned DOUBLE

AUTHORS

Written by Pierre Smars (first version: 2011)

BUGS

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

COPYRIGHT

Copyright (C) 2016 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.