How to Setup the Parameters of Script t15

To use Script t15 for your own point cloud

Script t15 has some parameters and you should setup them aproximately when you use t15 for your own point cloud. Also you can adjust them to get a better result. Here are what the parameters mean and how you can adjust them.

The codes to setup the parameters at the line #88 to #99 in t15 [Zoom]

The parameters of Script t15

t15 has the parameters which are named as gb["..."] in the code. You can find the codes to setup the parameters at the line #88 like the right image.

The value gb["MaxAroundDist"]

The value gb["MaxAroundDist"] is a threshold that is used in collecting vertices in the step +2. It means the radius of the sphere region where t15 searches for the vertices in the step.

You should adjust the value depending on your point cloud configuration. It would be nice to set the value to the average or a bit more of the distance between the adjacent vertices in the point cloud. If it's too small, t15 would make few faces and doesn't work well. If it's too large, it will waste a lot of time for skinning.

The value gb["MaxDistForAxis"]

The value gb["MaxDistForAxis"] is a threshold that is used in collecting vertices in the step +3. It means the radius of the sphere region where t15 searches for more vertices to calculate the average normal in the step.

You would get a good result of skinning when you set the value to double gb["MaxAroundDist"] or a bit more. You can set it to a larger number if your point cloud has a lot of noise. However, if it's too large, it will waste time for skinning.

The value gb["MinVertsAngle"]

The value gb["MinVertsAngle"] is a threshold that is used in checking angles in the step +8-+3. It means the minimum angle that allows to leave the vertex. In other words, it means the maximum angle that allows to discard the vertex because the angle is too small to make a triangular face.

It would be better to set the value to 20 [deg] or so. If it's too large, t15 would make few faces and doesn't work well.

The value gb["MaxVertsAngle"]

The value gb["MaxVertsAngle"] is a threshold that is used in checking angles in the step +8-+5. It means the maximum angle that allows to make a face. In other words, it means the minimum angle that allows to make no face because the angle is too large to make a triangular face.

It would be better to set the value to 150 [deg] or so. If it's too small, t15 would make few faces and doesn't work well.

The values gb["GridSize"] and gb["PrecisionLevel"]

The two parameters gb["GridSize"] and gb["PrecisionLevel"] have been added in t15 and they are for the setups of PointsGridManager.

The value gb["GridSize"] is the cell size of the grid that PointsGridManager uses. The skinning would work fast when you set it to two or three times larger number of gb["MaxAroundDist"]. It would provide good performance when each cell has 50 vertices or so.

The value gb["PrecisionLevel"] is how accurately PointsGridManager measures the distance between two vertices in collecting them. You can set it to the number of 0 to 2, which means that 0 is low accuracy and 2 is high. Being high accuracy makes it take more time.