fmeobjects.FMEArea.isPlanar¶
-
FMEArea.
isPlanar
(tolerance)¶ Returns
True
if this is planar within the given tolerance, andFalse
otherwise.The planarity condition is computed by the following algorithm. The normal vector <A, B, C> is determined by the vertices of this area using Newell’s method. For the first point (x’, y’, z’) of this area, we compute D’ = Ax’ + By’ + Cz’. Then, this area is planar if and only if every subsequent point (x, y, z) of this area gives a D = Ax + By + Cz, that is within the tolerance amount of D’. That is, | D - D’ | <= tolerance.
If the specified tolerance is negative, then this method always returns
True
.Parameters: tolerance (float) – The tolerance to check against. Return type: bool Returns: Whether the area is planar within the tolerance supplied.