trisize

NAME

trisize - returns various information about a triangle cloud

SYNOPSIS

trisize [-s|--surface] [-q|--quality] [-m|--min_edge] [-M|--max_edge] [-p INT|--precision INT] [-?|-h|--help]

DESCRIPTION

trisize computes data about a triangle cloud (and point clouds to some extend). If one or more option -s, -q, -m or is set, the programs returns information for each triangle. The first line is the number of triangles, and the next lines (one for each triangle) contain one or more of these values, always in the same order (s, q, m, M). This information may be used (for instance) to eliminate some some 'bad' triangles (with select_tri(1)) or to color them (with view_tri(1)). When none of these options is set, the program returns some statistical data: the number of points, the number of triangles, the total surface of the mesh, the centre of gravity (weighted average by the surface of the triangles), the bounding box of a triangle cloud. It also returns the minimum, maximum, average and standard deviation of the areas of the triangles and of their quality factor. For the surface data, the side of an equilateral triangle of the same surface is output in between brackets. The input cloud is read from the standard input and the result is returned to the standard output.

OPTIONS

-s,--surface

for each triangle of the cloud, returns its area. The first line returned is the number of triangles in the cloud.

-q,--quality

for each triangle of the cloud, returns its quality (ratio between the dimensions of smallest and the largest edge). The first line returned is the number of triangles in the cloud.

-m,--min_edge

for each triangle of the cloud, returns the length of its shortest edge. The first line returned is the number of triangles in the cloud.

-M,--max_edge

for each triangle of the cloud, returns the length of its longest edge. The first line returned is the number of triangles in the cloud.

-p INTEGER, --precision INTEGER

number of decimals (default: 6)

-h,--help,-?

Returns the manual page

AUTHORS

Written by Pierre Smars (first version: 2007)

BUGS

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

COPYRIGHT

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

average(1), select_tri(1), view_tri(1)

Pierre SMARS (tools, home page)