@itwin/core-geometry 5.2.0-dev.7 → 5.3.0-dev.1

package/lib/cjs/geometry3d/FrameBuilder.d.ts

@@ -2,6 +2,7 @@ import { AxisScaleSelect } from "../Geometry";
 import { Point3d, Vector3d } from "./Point3dVector3d";
 import { Range3d } from "./Range";
 import { Transform } from "./Transform";
+import { XYAndZ } from "./XYZProps";
 /**
  * Helper class to accumulate points and vectors until there is enough data to define a coordinate system.
  *
@@ -48,7 +49,7 @@ export declare class FrameBuilder {
     /**
      * Announce a new point. If this point is different from the origin, also compute and announce the vector from the origin.
      */
-    announcePoint(point: Point3d): number;
+    announcePoint(point: XYAndZ): number;
     /** Announce a new vector. */
     announceVector(vector: Vector3d): number;
     /**

package/lib/cjs/geometry3d/FrameBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FrameBuilder.d.ts","sourceRoot":"","sources":["../../../src/geometry3d/FrameBuilder.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAa,eAAe,EAAY,MAAM,aAAa,CAAC;AAGnE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGtD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAW;IACtC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAW;IACvC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAW;IACvC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAU;IAEpC,OAAO,CAAC,6BAA6B;IASrC,kDAAkD;IAC3C,KAAK;;IASZ;;;;OAIG;IACI,iBAAiB,CAAC,eAAe,GAAE,OAAe,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS;IA0BrG,kGAAkG;IAC3F,oBAAoB,CAAC,MAAM,CAAC,EAAE,QAAQ;IAK7C,8DAA8D;IAC9D,IAAW,SAAS,IAAI,OAAO,CAE9B;IACD;;OAEG;IACI,gBAAgB,IAAI,MAAM;IASjC;;OAEG;IACI,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;IAU5C,6BAA6B;IACtB,cAAc,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM;IA0B/C;;;OAGG;IACI,QAAQ,CAAC,IAAI,EAAE,GAAG;IAuEzB;;;;;;;;;;;OAWG;WACW,sBAAsB,CAAC,eAAe,EAAE,QAAQ,GAAG,SAAS,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,SAAS,GAAG,SAAS;IAiCpH;;;;;;;;OAQG;WACW,6BAA6B,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,SAAS,GAAG,SAAS;IAIpF;;;;;;;OAOG;WACW,0BAA0B,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS;IAatG;;;;;;;OAOG;WACW,yBAAyB,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS;IAQrG;;;;;;;;;;OAUG;WACW,kCAAkC,CAC9C,KAAK,EAAE,OAAO,EACd,WAAW,GAAE,eAA4D,EACzE,SAAS,GAAE,MAAU,EACrB,SAAS,GAAE,MAAU,EACrB,SAAS,GAAE,MAAU,EACrB,iBAAiB,GAAE,MAAY,EAC/B,MAAM,CAAC,EAAE,SAAS,GACjB,SAAS;CAiBb"}
+{"version":3,"file":"FrameBuilder.d.ts","sourceRoot":"","sources":["../../../src/geometry3d/FrameBuilder.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAa,eAAe,EAAY,MAAM,aAAa,CAAC;AAGnE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGtD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEpC;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAW;IACtC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAW;IACvC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAW;IACvC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAU;IAEpC,OAAO,CAAC,6BAA6B;IASrC,kDAAkD;IAC3C,KAAK;;IASZ;;;;OAIG;IACI,iBAAiB,CAAC,eAAe,GAAE,OAAe,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS;IA0BrG,kGAAkG;IAC3F,oBAAoB,CAAC,MAAM,CAAC,EAAE,QAAQ;IAK7C,8DAA8D;IAC9D,IAAW,SAAS,IAAI,OAAO,CAE9B;IACD;;OAEG;IACI,gBAAgB,IAAI,MAAM;IASjC;;OAEG;IACI,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAU3C,6BAA6B;IACtB,cAAc,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM;IA0B/C;;;OAGG;IACI,QAAQ,CAAC,IAAI,EAAE,GAAG;IAqEzB;;;;;;;;;;;OAWG;WACW,sBAAsB,CAAC,eAAe,EAAE,QAAQ,GAAG,SAAS,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,SAAS,GAAG,SAAS;IAiCpH;;;;;;;;OAQG;WACW,6BAA6B,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,SAAS,GAAG,SAAS;IAIpF;;;;;;;OAOG;WACW,0BAA0B,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS;IAatG;;;;;;;OAOG;WACW,yBAAyB,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS;IAQrG;;;;;;;;;;OAUG;WACW,kCAAkC,CAC9C,KAAK,EAAE,OAAO,EACd,WAAW,GAAE,eAA4D,EACzE,SAAS,GAAE,MAAU,EACrB,SAAS,GAAE,MAAU,EACrB,SAAS,GAAE,MAAU,EACrB,iBAAiB,GAAE,MAAY,EAC/B,MAAM,CAAC,EAAE,SAAS,GACjB,SAAS;CAiBb"}

package/lib/cjs/geometry3d/FrameBuilder.js

@@ -10,14 +10,13 @@ exports.FrameBuilder = void 0;
  */
 // import { Point2d } from "./Geometry2d";
 const BSplineCurve_1 = require("../bspline/BSplineCurve");
-const InterpolationCurve3d_1 = require("../bspline/InterpolationCurve3d");
 const Arc3d_1 = require("../curve/Arc3d");
 const CurveCollection_1 = require("../curve/CurveCollection");
 const CurvePrimitive_1 = require("../curve/CurvePrimitive");
 const LineSegment3d_1 = require("../curve/LineSegment3d");
 const LineString3d_1 = require("../curve/LineString3d");
 const Geometry_1 = require("../Geometry");
-const GrowableXYZArray_1 = require("./GrowableXYZArray");
+const IndexedXYZCollection_1 = require("./IndexedXYZCollection");
 const Matrix3d_1 = require("./Matrix3d");
 const Point3dVector3d_1 = require("./Point3dVector3d");
 const PointHelpers_1 = require("./PointHelpers");
@@ -125,7 +124,7 @@ class FrameBuilder {
      */
     announcePoint(point) {
         if (!this._origin) {
-            this._origin = point.clone();
+            this._origin = Point3dVector3d_1.Point3d.createFrom(point);
             return this.savedVectorCount();
         }
         // the new point may provide an additional vector
@@ -173,6 +172,14 @@ class FrameBuilder {
             this.announcePoint(data);
         else if (data instanceof Point3dVector3d_1.Vector3d)
             this.announceVector(data);
+        else if (Geometry_1.Geometry.isArrayOfNumberArray(data, 1, 3)) { // number[][] treated as xyz points
+            for (const pt of data)
+                this.announcePoint({ x: pt[0], y: pt[1], z: pt[2] });
+        }
+        else if (Geometry_1.Geometry.isArrayOfNumberArray(data, 1, 2)) { // number[][] treated as xy points
+            for (const pt of data)
+                this.announcePoint({ x: pt[0], y: pt[1], z: 0 });
+        }
         else if (Array.isArray(data)) {
             for (const child of data) {
                 if (this.savedVectorCount() > 1)
@@ -180,7 +187,7 @@ class FrameBuilder {
                 this.announce(child);
             }
         }
-        else if (data instanceof CurvePrimitive_1.CurvePrimitive) {
+        else if (data instanceof CurvePrimitive_1.CurvePrimitive) { // local x-axis aligns to first tangent vector
             if (data instanceof LineSegment3d_1.LineSegment3d) {
                 this.announcePoint(data.startPoint());
                 this.announcePoint(data.endPoint());
@@ -207,18 +214,7 @@ class FrameBuilder {
                         break;
                 }
             }
-            else if (data instanceof InterpolationCurve3d_1.InterpolationCurve3d) {
-                const point = Point3dVector3d_1.Point3d.create();
-                for (let i = 0; this.savedVectorCount() < 2; i++) {
-                    if (i < data.options.fitPoints.length) {
-                        point.setFrom(data.options.fitPoints[i]);
-                        this.announcePoint(point);
-                    }
-                    else
-                        break;
-                }
-            }
-            else { // unimplemented CurvePrimitive type
+            else { // generic CurvePrimitive
                 const frame = data.fractionToFrenetFrame(0.0);
                 if (undefined !== frame) {
                     this.announcePoint(frame.getOrigin());
@@ -235,7 +231,7 @@ class FrameBuilder {
                         break;
                 }
         }
-        else if (data instanceof GrowableXYZArray_1.GrowableXYZArray) {
+        else if (data instanceof IndexedXYZCollection_1.IndexedXYZCollection) {
             const point = Point3dVector3d_1.Point3d.create();
             for (let i = 0; this.savedVectorCount() < 2; i++) {
                 if (data.getPoint3dAtCheckedPointIndex(i, point) instanceof Point3dVector3d_1.Point3d)
@@ -245,7 +241,7 @@ class FrameBuilder {
             }
         }
         else if (data.hasOwnProperty("x") && data.hasOwnProperty("y") && data.hasOwnProperty("z")) {
-            this.announcePoint(Point3dVector3d_1.Point3d.create(data.x, data.y, data.z));
+            this.announcePoint(data);
         }
     }
     /**

package/lib/cjs/geometry3d/FrameBuilder.js.map

@@ -1 +1 @@
-{"version":3,"file":"FrameBuilder.js","sourceRoot":"","sources":["../../../src/geometry3d/FrameBuilder.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n\n/** @packageDocumentation\n * @module CartesianGeometry\n */\n\n// import { Point2d } from \"./Geometry2d\";\nimport { BSplineCurve3d } from \"../bspline/BSplineCurve\";\nimport { InterpolationCurve3d } from \"../bspline/InterpolationCurve3d\";\nimport { Arc3d } from \"../curve/Arc3d\";\nimport { CurveCollection } from \"../curve/CurveCollection\";\nimport { CurvePrimitive } from \"../curve/CurvePrimitive\";\nimport { LineSegment3d } from \"../curve/LineSegment3d\";\nimport { LineString3d } from \"../curve/LineString3d\";\nimport { AxisOrder, AxisScaleSelect, Geometry } from \"../Geometry\";\nimport { GrowableXYZArray } from \"./GrowableXYZArray\";\nimport { Matrix3d } from \"./Matrix3d\";\nimport { Point3d, Vector3d } from \"./Point3dVector3d\";\nimport { Point3dArray } from \"./PointHelpers\";\nimport { PolygonOps } from \"./PolygonOps\";\nimport { Range3d } from \"./Range\";\nimport { Transform } from \"./Transform\";\n\n/**\n * Helper class to accumulate points and vectors until there is enough data to define a coordinate system.\n *\n * * For the common case of building a right handed frame:\n *   * create the FrameBuilder and make calls to announcePoint and announceVector.\n *   * the frame will be fully determined by an origin and two vectors.\n *   * the first call to announcePoint will set the origin.\n *   * additional calls to announcePoint will produce announceVector call with the vector from the origin.\n *   * after each announcement, call getValidatedFrame(false)\n *   * getValidatedFrame will succeed when it has two independent vectors.\n * *  To build a left handed frame,\n *   *  an origin and 3 independent vectors are required.\n *   *  announce as above, but query with getValidatedFrame (true).\n *   *  this will use the third vector to select right or left handed frame.\n * @public\n */\nexport class FrameBuilder {\n  private _origin: undefined | Point3d;\n  private _vector0: undefined | Vector3d;\n  private _vector1: undefined | Vector3d;\n  private _vector2: undefined | Vector3d;\n  private static _workMatrix?: Matrix3d;\n  private static _workVector0?: Vector3d;\n  private static _workVector1?: Vector3d;\n  private static _workPoint?: Point3d;\n  // test if both vectors are defined and have significant angle between.\n  private areStronglyIndependentVectors(\n    vector0: Vector3d, vector1: Vector3d, radiansTolerance: number = Geometry.smallAngleRadians,\n  ): boolean {\n    if (vector0 !== undefined && vector1 !== undefined) {\n      const q = vector0.smallerUnorientedRadiansTo(vector1);\n      return q > radiansTolerance;\n    }\n    return false;\n  }\n  /** Clear all accumulated point and vector data */\n  public clear() {\n    this._origin = undefined;\n    this._vector0 = undefined;\n    this._vector1 = undefined;\n    this._vector2 = undefined;\n  }\n  constructor() {\n    this.clear();\n  }\n  /**\n   * Try to assemble the data into a non-singular transform.\n   * * If allowLeftHanded is false, vector0 and vector1 determine a right handed coordinate system.\n   * * if allowLeftHanded is true, the z vector of the right handed system can be flipped to agree with vector2 direction.\n   */\n  public getValidatedFrame(allowLeftHanded: boolean = false, result?: Transform): Transform | undefined {\n    if (this._origin && this._vector0 && this._vector1) {\n      const createRigidMatrix = (v0: Vector3d, v1: Vector3d): Matrix3d | undefined => {\n        return FrameBuilder._workMatrix = Matrix3d.createRigidFromColumns(v0, v1, AxisOrder.XYZ, FrameBuilder._workMatrix);\n      };\n      if (!allowLeftHanded) {\n        const matrix = createRigidMatrix(this._vector0, this._vector1);\n        if (matrix)\n          return Transform.createOriginAndMatrix(this._origin, matrix, result);\n        // uh oh -- vector1 was not really independent.  clear everything after vector0.\n        this._vector1 = this._vector2 = undefined;\n      } else if (this._vector2) {\n        const matrix = createRigidMatrix(this._vector0, this._vector1);\n        if (matrix) {\n          if (this._vector0.tripleProduct(this._vector1, this._vector2) < 0)\n            matrix.scaleColumns(1.0, 1.0, -1.0);\n          return Transform.createOriginAndMatrix(this._origin, matrix, result);\n        }\n        // uh oh again -- clear vector1 and vector2, re-announce vector2 as possible vector1??\n        const vector2 = this._vector2;\n        this._vector1 = this._vector2 = undefined;\n        this.announceVector(vector2);\n      }\n    }\n    return undefined;\n  }\n  /** If vector0 is known but vector1 is not, make vector1 the cross of the up-vector and vector0 */\n  public applyDefaultUpVector(vector?: Vector3d) {\n    if (vector && this._vector0 && !this._vector1 && !vector.isParallelTo(this._vector0)) {\n      this._vector1 = vector.crossProduct(this._vector0);\n    }\n  }\n  /** Ask if there is a defined origin for the evolving frame */\n  public get hasOrigin(): boolean {\n    return this._origin !== undefined;\n  }\n  /**\n   * Return the number of vectors saved. Because the save process checks numerics, this should be the rank of the system.\n   */\n  public savedVectorCount(): number {\n    if (!this._vector0)\n      return 0;\n    if (!this._vector1)\n      return 1;\n    if (!this._vector2)\n      return 2;\n    return 3;\n  }\n  /**\n   * Announce a new point. If this point is different from the origin, also compute and announce the vector from the origin.\n   */\n  public announcePoint(point: Point3d): number {\n    if (!this._origin) {\n      this._origin = point.clone();\n      return this.savedVectorCount();\n    }\n    // the new point may provide an additional vector\n    if (this._origin.isAlmostEqual(point))\n      return this.savedVectorCount();\n    return this.announceVector(this._origin.vectorTo(point));\n  }\n  /** Announce a new vector. */\n  public announceVector(vector: Vector3d): number {\n    if (vector.isAlmostZero)\n      return this.savedVectorCount();\n    if (!this._vector0) {\n      this._vector0 = vector.clone(this._vector0);\n      return 1;\n    }\n    if (!this._vector1) {\n      if (this.areStronglyIndependentVectors(vector, this._vector0, 1.0e-5)) {\n        this._vector1 = vector.clone(this._vector1);\n        return 2;\n      }\n      return 1;\n    }\n    // vector0 and vector1 are independent.\n    if (!this._vector2) {\n      const unitPerpendicular = this._vector0.unitCrossProduct(this._vector1);\n      if (unitPerpendicular && !Geometry.isSameCoordinate(0, unitPerpendicular.dotProduct(vector))) {\n        this._vector2 = vector.clone(this._vector2);\n        return 3;\n      }\n      return 2;\n    }\n    // fall through if prior vectors are all there -- no need for the new one.\n    return 3;\n  }\n  /**\n   * Inspect the content of the data.  Announce points and vectors. Return when savedVectorCount becomes sufficient\n   * for a coordinate system.\n   */\n  public announce(data: any) {\n    if (this.savedVectorCount() > 1)\n      return;\n    if (data === undefined)\n      return;\n    if (data instanceof Point3d)\n      this.announcePoint(data);\n    else if (data instanceof Vector3d)\n      this.announceVector(data);\n    else if (Array.isArray(data)) {\n      for (const child of data) {\n        if (this.savedVectorCount() > 1)\n          break;\n        this.announce(child);\n      }\n    } else if (data instanceof CurvePrimitive) {\n      if (data instanceof LineSegment3d) {\n        this.announcePoint(data.startPoint());\n        this.announcePoint(data.endPoint());\n      } else if (data instanceof Arc3d) {\n        const plane = data.fractionToPointAnd2Derivatives(0.0);\n        this.announcePoint(plane.origin);\n        this.announceVector(plane.vectorU);\n        this.announceVector(plane.vectorV);\n      } else if (data instanceof LineString3d) {\n        for (const point of data.points) {\n          this.announcePoint(point);\n          if (this.savedVectorCount() > 1)\n            break;\n        }\n      } else if (data instanceof BSplineCurve3d) {\n        const point = Point3d.create();\n        for (let i = 0; this.savedVectorCount() < 2; i++) {\n          if (data.getPolePoint3d(i, point) instanceof Point3d)\n            this.announcePoint(point);\n          else break;\n        }\n      } else if (data instanceof InterpolationCurve3d) {\n        const point = Point3d.create();\n        for (let i = 0; this.savedVectorCount() < 2; i++) {\n          if (i < data.options.fitPoints.length) {\n            point.setFrom(data.options.fitPoints[i]);\n            this.announcePoint(point);\n          } else break;\n        }\n      } else { // unimplemented CurvePrimitive type\n        const frame = data.fractionToFrenetFrame(0.0);\n        if (undefined !== frame) {\n          this.announcePoint(frame.getOrigin());\n          this.announceVector(frame.matrix.getColumn(0));\n          this.announceVector(frame.matrix.getColumn(1));\n        }\n      }\n    } else if (data instanceof CurveCollection) {\n      if (data.children)\n        for (const child of data.children) {\n          this.announce(child);\n          if (this.savedVectorCount() > 1)\n            break;\n        }\n    } else if (data instanceof GrowableXYZArray) {\n      const point = Point3d.create();\n      for (let i = 0; this.savedVectorCount() < 2; i++) {\n        if (data.getPoint3dAtCheckedPointIndex(i, point) instanceof Point3d)\n          this.announcePoint(point);\n        else break;\n      }\n    } else if (data.hasOwnProperty(\"x\") && data.hasOwnProperty(\"y\") && data.hasOwnProperty(\"z\")) {\n      this.announcePoint(Point3d.create(data.x, data.y, data.z));\n    }\n  }\n  /**\n   * Create a localToWorld frame for the given data.\n   * * origin is at first point.\n   * * x axis in direction of first nonzero vector present or implied by the input.\n   * * y axis is perpendicular to x and contains (in positive side) the next vector present or implied by the input.\n   * * The calculation favors the first points found. It does not try to get a \"best\" plane.\n   * @param defaultUpVector optional vector to cross with vector0 to create vector1 when it is unknown.\n   * The z-column of the returned frame points into the same halfspace as this vector.\n   * @param params any number of geometric objects to examine in [[announce]] for point/vector data sufficient to construct a frame.\n   * If the last argument is a `Transform`, it is populated with the computed frame and returned.\n   * @returns computed localToWorld frame, or undefined if insufficient data.\n   */\n  public static createRightHandedFrame(defaultUpVector: Vector3d | undefined, ...params: any[]): Transform | undefined {\n    // if last arg is a Transform, remove it from the array and use for the return value\n    let frame = (params.length > 0 && params[params.length - 1] instanceof Transform) ? params.pop() as Transform : undefined;\n    const flipFrame = (f: Transform): Transform => {\n      if (defaultUpVector && f.matrix.dotColumnZ(defaultUpVector) < 0.0)\n        f.matrix.scaleColumnsInPlace(1, -1, -1);\n      return f;\n    };\n    const builder = new FrameBuilder();\n    for (const data of params) {\n      builder.announce(data);\n      builder.applyDefaultUpVector(defaultUpVector);\n      if (frame = builder.getValidatedFrame(false, frame))\n        return flipFrame(frame);\n    }\n    const evaluatePrimitiveFrame = (curve: CurvePrimitive, result?: Transform): Transform | undefined => {\n      return curve.fractionToFrenetFrame(0.0, result);\n    };\n    // try direct evaluation of curve primitives using the above lambda\n    for (const data of params) {\n      if (data instanceof CurvePrimitive) {\n        if (frame = evaluatePrimitiveFrame(data, frame))\n          return flipFrame(frame);\n      } else if (data instanceof CurveCollection) {\n        const children = data.collectCurvePrimitives();\n        for (const curve of children) {\n          if (frame = evaluatePrimitiveFrame(curve, frame))\n            return flipFrame(frame);\n        }\n      }\n    }\n    return undefined;\n  }\n  /**\n   * Create a transform containing points or vectors in the given data.\n   * * The xy columns of the transform contain the first points or vectors of the data.\n   * * The z column is perpendicular to that xy plane.\n   * * The calculation favors the first points found. It does not try to get a \"best\" plane.\n   * @param params any number of geometric objects to examine in [[announce]] for point/vector data sufficient to construct a frame.\n   * If the last argument is a `Transform`, it is populated with the computed frame and returned.\n   * @returns computed localToWorld frame, or undefined if insufficient data.\n   */\n  public static createRightHandedLocalToWorld(...params: any[]): Transform | undefined {\n    return this.createRightHandedFrame(undefined, params);\n  }\n\n  /**\n   * Try to create a frame whose xy plane is through points.\n   * * If 3 or more distinct points are present, the x axis is from the first point to the most distant, and y\n   * direction is toward the point most distant from that line.\n   * @param points array of points\n   * @param result optional pre-allocated Transform to populate and return\n   * @returns localToWorld frame for the points, or undefined if insufficient data\n   */\n  public static createFrameToDistantPoints(points: Point3d[], result?: Transform): Transform | undefined {\n    if (points.length > 2) {\n      const origin = points[0];\n      const vector01 = FrameBuilder._workVector0 ?? Vector3d.create();\n      Point3dArray.indexOfMostDistantPoint(points, points[0], vector01);\n      const vector02 = FrameBuilder._workVector1 ?? Vector3d.create();\n      Point3dArray.indexOfPointWithMaxCrossProductMagnitude(points, origin, vector01, vector02);\n      const matrix = FrameBuilder._workMatrix = Matrix3d.createRigidFromColumns(vector01, vector02, AxisOrder.XYZ, FrameBuilder._workMatrix);\n      if (matrix)\n        return Transform.createOriginAndMatrix(origin, matrix, result);\n    }\n    return undefined;\n  }\n  /**\n   * Try to create a frame whose xy plane is through points, with the points appearing CCW in the local frame.\n   * * If 3 or more distinct points are present, the x axis is from the first point to the most distant, and y\n   * direction is toward the point most distant from that line.\n   * @param points array of points\n   * @param result optional pre-allocated Transform to populate and return\n   * @returns localToWorld frame for the points, or undefined if insufficient data\n   */\n  public static createFrameWithCCWPolygon(points: Point3d[], result?: Transform): Transform | undefined {\n    if (points.length > 2) {\n      const ray = PolygonOps.centroidAreaNormal(points);  // can't pass pre-allocated ray...\n      if (ray)\n        return ray.toRigidZFrame(result);\n    }\n    return undefined;\n  }\n  /**\n   * Create the localToWorld transform from a range to axes of its parent coordinate system.\n   * @param range range to inspect\n   * @param scaleSelect selects size of localToWorld axes.\n   * @param fractionX fractional coordinate of frame origin x\n   * @param fractionY fractional coordinate of frame origin y\n   * @param fractionZ fractional coordinate of frame origin z\n   * @param defaultAxisLength if true and any axis length is 0, that axis vector takes this physical length.\n   * @param result optional pre-allocated Transform to populate and return\n   * @returns localToWorld frame for the range\n   */\n  public static createLocalToWorldTransformInRange(\n    range: Range3d,\n    scaleSelect: AxisScaleSelect = AxisScaleSelect.NonUniformRangeContainment,\n    fractionX: number = 0,\n    fractionY: number = 0,\n    fractionZ: number = 0,\n    defaultAxisLength: number = 1.0,\n    result?: Transform,\n  ): Transform {\n    if (range.isNull)\n      return Transform.createIdentity(result);\n    let a = 1.0;\n    let b = 1.0;\n    let c = 1.0;\n    if (scaleSelect === AxisScaleSelect.LongestRangeDirection) {\n      a = b = c = Geometry.correctSmallMetricDistance(range.maxLength(), defaultAxisLength);\n    } else if (scaleSelect === AxisScaleSelect.NonUniformRangeContainment) {\n      a = Geometry.correctSmallMetricDistance(range.xLength(), defaultAxisLength) * Geometry.maxAbsDiff(fractionX, 0, 1);\n      b = Geometry.correctSmallMetricDistance(range.yLength(), defaultAxisLength) * Geometry.maxAbsDiff(fractionY, 0, 1);\n      c = Geometry.correctSmallMetricDistance(range.zLength(), defaultAxisLength) * Geometry.maxAbsDiff(fractionZ, 0, 1);\n    }\n    const origin = FrameBuilder._workPoint = range.fractionToPoint(fractionX, fractionY, fractionZ, FrameBuilder._workPoint);\n    const matrix = FrameBuilder._workMatrix = Matrix3d.createScale(a, b, c, FrameBuilder._workMatrix);\n    return Transform.createOriginAndMatrix(origin, matrix, result);\n  }\n}\n"]}
+{"version":3,"file":"FrameBuilder.js","sourceRoot":"","sources":["../../../src/geometry3d/FrameBuilder.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n\n/** @packageDocumentation\n * @module CartesianGeometry\n */\n\n// import { Point2d } from \"./Geometry2d\";\nimport { BSplineCurve3d } from \"../bspline/BSplineCurve\";\nimport { Arc3d } from \"../curve/Arc3d\";\nimport { CurveCollection } from \"../curve/CurveCollection\";\nimport { CurvePrimitive } from \"../curve/CurvePrimitive\";\nimport { LineSegment3d } from \"../curve/LineSegment3d\";\nimport { LineString3d } from \"../curve/LineString3d\";\nimport { AxisOrder, AxisScaleSelect, Geometry } from \"../Geometry\";\nimport { IndexedXYZCollection } from \"./IndexedXYZCollection\";\nimport { Matrix3d } from \"./Matrix3d\";\nimport { Point3d, Vector3d } from \"./Point3dVector3d\";\nimport { Point3dArray } from \"./PointHelpers\";\nimport { PolygonOps } from \"./PolygonOps\";\nimport { Range3d } from \"./Range\";\nimport { Transform } from \"./Transform\";\nimport { XYAndZ } from \"./XYZProps\";\n\n/**\n * Helper class to accumulate points and vectors until there is enough data to define a coordinate system.\n *\n * * For the common case of building a right handed frame:\n *   * create the FrameBuilder and make calls to announcePoint and announceVector.\n *   * the frame will be fully determined by an origin and two vectors.\n *   * the first call to announcePoint will set the origin.\n *   * additional calls to announcePoint will produce announceVector call with the vector from the origin.\n *   * after each announcement, call getValidatedFrame(false)\n *   * getValidatedFrame will succeed when it has two independent vectors.\n * *  To build a left handed frame,\n *   *  an origin and 3 independent vectors are required.\n *   *  announce as above, but query with getValidatedFrame (true).\n *   *  this will use the third vector to select right or left handed frame.\n * @public\n */\nexport class FrameBuilder {\n  private _origin: undefined | Point3d;\n  private _vector0: undefined | Vector3d;\n  private _vector1: undefined | Vector3d;\n  private _vector2: undefined | Vector3d;\n  private static _workMatrix?: Matrix3d;\n  private static _workVector0?: Vector3d;\n  private static _workVector1?: Vector3d;\n  private static _workPoint?: Point3d;\n  // test if both vectors are defined and have significant angle between.\n  private areStronglyIndependentVectors(\n    vector0: Vector3d, vector1: Vector3d, radiansTolerance: number = Geometry.smallAngleRadians,\n  ): boolean {\n    if (vector0 !== undefined && vector1 !== undefined) {\n      const q = vector0.smallerUnorientedRadiansTo(vector1);\n      return q > radiansTolerance;\n    }\n    return false;\n  }\n  /** Clear all accumulated point and vector data */\n  public clear() {\n    this._origin = undefined;\n    this._vector0 = undefined;\n    this._vector1 = undefined;\n    this._vector2 = undefined;\n  }\n  constructor() {\n    this.clear();\n  }\n  /**\n   * Try to assemble the data into a non-singular transform.\n   * * If allowLeftHanded is false, vector0 and vector1 determine a right handed coordinate system.\n   * * if allowLeftHanded is true, the z vector of the right handed system can be flipped to agree with vector2 direction.\n   */\n  public getValidatedFrame(allowLeftHanded: boolean = false, result?: Transform): Transform | undefined {\n    if (this._origin && this._vector0 && this._vector1) {\n      const createRigidMatrix = (v0: Vector3d, v1: Vector3d): Matrix3d | undefined => {\n        return FrameBuilder._workMatrix = Matrix3d.createRigidFromColumns(v0, v1, AxisOrder.XYZ, FrameBuilder._workMatrix);\n      };\n      if (!allowLeftHanded) {\n        const matrix = createRigidMatrix(this._vector0, this._vector1);\n        if (matrix)\n          return Transform.createOriginAndMatrix(this._origin, matrix, result);\n        // uh oh -- vector1 was not really independent.  clear everything after vector0.\n        this._vector1 = this._vector2 = undefined;\n      } else if (this._vector2) {\n        const matrix = createRigidMatrix(this._vector0, this._vector1);\n        if (matrix) {\n          if (this._vector0.tripleProduct(this._vector1, this._vector2) < 0)\n            matrix.scaleColumns(1.0, 1.0, -1.0);\n          return Transform.createOriginAndMatrix(this._origin, matrix, result);\n        }\n        // uh oh again -- clear vector1 and vector2, re-announce vector2 as possible vector1??\n        const vector2 = this._vector2;\n        this._vector1 = this._vector2 = undefined;\n        this.announceVector(vector2);\n      }\n    }\n    return undefined;\n  }\n  /** If vector0 is known but vector1 is not, make vector1 the cross of the up-vector and vector0 */\n  public applyDefaultUpVector(vector?: Vector3d) {\n    if (vector && this._vector0 && !this._vector1 && !vector.isParallelTo(this._vector0)) {\n      this._vector1 = vector.crossProduct(this._vector0);\n    }\n  }\n  /** Ask if there is a defined origin for the evolving frame */\n  public get hasOrigin(): boolean {\n    return this._origin !== undefined;\n  }\n  /**\n   * Return the number of vectors saved. Because the save process checks numerics, this should be the rank of the system.\n   */\n  public savedVectorCount(): number {\n    if (!this._vector0)\n      return 0;\n    if (!this._vector1)\n      return 1;\n    if (!this._vector2)\n      return 2;\n    return 3;\n  }\n  /**\n   * Announce a new point. If this point is different from the origin, also compute and announce the vector from the origin.\n   */\n  public announcePoint(point: XYAndZ): number {\n    if (!this._origin) {\n      this._origin = Point3d.createFrom(point);\n      return this.savedVectorCount();\n    }\n    // the new point may provide an additional vector\n    if (this._origin.isAlmostEqual(point))\n      return this.savedVectorCount();\n    return this.announceVector(this._origin.vectorTo(point));\n  }\n  /** Announce a new vector. */\n  public announceVector(vector: Vector3d): number {\n    if (vector.isAlmostZero)\n      return this.savedVectorCount();\n    if (!this._vector0) {\n      this._vector0 = vector.clone(this._vector0);\n      return 1;\n    }\n    if (!this._vector1) {\n      if (this.areStronglyIndependentVectors(vector, this._vector0, 1.0e-5)) {\n        this._vector1 = vector.clone(this._vector1);\n        return 2;\n      }\n      return 1;\n    }\n    // vector0 and vector1 are independent.\n    if (!this._vector2) {\n      const unitPerpendicular = this._vector0.unitCrossProduct(this._vector1);\n      if (unitPerpendicular && !Geometry.isSameCoordinate(0, unitPerpendicular.dotProduct(vector))) {\n        this._vector2 = vector.clone(this._vector2);\n        return 3;\n      }\n      return 2;\n    }\n    // fall through if prior vectors are all there -- no need for the new one.\n    return 3;\n  }\n  /**\n   * Inspect the content of the data.  Announce points and vectors. Return when savedVectorCount becomes sufficient\n   * for a coordinate system.\n   */\n  public announce(data: any) {\n    if (this.savedVectorCount() > 1)\n      return;\n    if (data === undefined)\n      return;\n    if (data instanceof Point3d)\n      this.announcePoint(data);\n    else if (data instanceof Vector3d)\n      this.announceVector(data);\n    else if (Geometry.isArrayOfNumberArray(data, 1, 3)) { // number[][] treated as xyz points\n      for (const pt of data)\n        this.announcePoint({ x: pt[0], y: pt[1], z: pt[2] });\n    } else if (Geometry.isArrayOfNumberArray(data, 1, 2)) { // number[][] treated as xy points\n      for (const pt of data)\n        this.announcePoint({ x: pt[0], y: pt[1], z: 0 });\n    } else if (Array.isArray(data)) {\n      for (const child of data) {\n        if (this.savedVectorCount() > 1)\n          break;\n        this.announce(child);\n      }\n    } else if (data instanceof CurvePrimitive) { // local x-axis aligns to first tangent vector\n      if (data instanceof LineSegment3d) {\n        this.announcePoint(data.startPoint());\n        this.announcePoint(data.endPoint());\n      } else if (data instanceof Arc3d) {\n        const plane = data.fractionToPointAnd2Derivatives(0.0);\n        this.announcePoint(plane.origin);\n        this.announceVector(plane.vectorU);\n        this.announceVector(plane.vectorV);\n      } else if (data instanceof LineString3d) {\n        for (const point of data.points) {\n          this.announcePoint(point);\n          if (this.savedVectorCount() > 1)\n            break;\n        }\n      } else if (data instanceof BSplineCurve3d) {\n        const point = Point3d.create();\n        for (let i = 0; this.savedVectorCount() < 2; i++) {\n          if (data.getPolePoint3d(i, point) instanceof Point3d)\n            this.announcePoint(point);\n          else break;\n        }\n      } else { // generic CurvePrimitive\n        const frame = data.fractionToFrenetFrame(0.0);\n        if (undefined !== frame) {\n          this.announcePoint(frame.getOrigin());\n          this.announceVector(frame.matrix.getColumn(0));\n          this.announceVector(frame.matrix.getColumn(1));\n        }\n      }\n    } else if (data instanceof CurveCollection) {\n      if (data.children)\n        for (const child of data.children) {\n          this.announce(child);\n          if (this.savedVectorCount() > 1)\n            break;\n        }\n    } else if (data instanceof IndexedXYZCollection) {\n      const point = Point3d.create();\n      for (let i = 0; this.savedVectorCount() < 2; i++) {\n        if (data.getPoint3dAtCheckedPointIndex(i, point) instanceof Point3d)\n          this.announcePoint(point);\n        else break;\n      }\n    } else if (data.hasOwnProperty(\"x\") && data.hasOwnProperty(\"y\") && data.hasOwnProperty(\"z\")) {\n      this.announcePoint(data);\n    }\n  }\n  /**\n   * Create a localToWorld frame for the given data.\n   * * origin is at first point.\n   * * x axis in direction of first nonzero vector present or implied by the input.\n   * * y axis is perpendicular to x and contains (in positive side) the next vector present or implied by the input.\n   * * The calculation favors the first points found. It does not try to get a \"best\" plane.\n   * @param defaultUpVector optional vector to cross with vector0 to create vector1 when it is unknown.\n   * The z-column of the returned frame points into the same halfspace as this vector.\n   * @param params any number of geometric objects to examine in [[announce]] for point/vector data sufficient to construct a frame.\n   * If the last argument is a `Transform`, it is populated with the computed frame and returned.\n   * @returns computed localToWorld frame, or undefined if insufficient data.\n   */\n  public static createRightHandedFrame(defaultUpVector: Vector3d | undefined, ...params: any[]): Transform | undefined {\n    // if last arg is a Transform, remove it from the array and use for the return value\n    let frame = (params.length > 0 && params[params.length - 1] instanceof Transform) ? params.pop() as Transform : undefined;\n    const flipFrame = (f: Transform): Transform => {\n      if (defaultUpVector && f.matrix.dotColumnZ(defaultUpVector) < 0.0)\n        f.matrix.scaleColumnsInPlace(1, -1, -1);\n      return f;\n    };\n    const builder = new FrameBuilder();\n    for (const data of params) {\n      builder.announce(data);\n      builder.applyDefaultUpVector(defaultUpVector);\n      if (frame = builder.getValidatedFrame(false, frame))\n        return flipFrame(frame);\n    }\n    const evaluatePrimitiveFrame = (curve: CurvePrimitive, result?: Transform): Transform | undefined => {\n      return curve.fractionToFrenetFrame(0.0, result);\n    };\n    // try direct evaluation of curve primitives using the above lambda\n    for (const data of params) {\n      if (data instanceof CurvePrimitive) {\n        if (frame = evaluatePrimitiveFrame(data, frame))\n          return flipFrame(frame);\n      } else if (data instanceof CurveCollection) {\n        const children = data.collectCurvePrimitives();\n        for (const curve of children) {\n          if (frame = evaluatePrimitiveFrame(curve, frame))\n            return flipFrame(frame);\n        }\n      }\n    }\n    return undefined;\n  }\n  /**\n   * Create a transform containing points or vectors in the given data.\n   * * The xy columns of the transform contain the first points or vectors of the data.\n   * * The z column is perpendicular to that xy plane.\n   * * The calculation favors the first points found. It does not try to get a \"best\" plane.\n   * @param params any number of geometric objects to examine in [[announce]] for point/vector data sufficient to construct a frame.\n   * If the last argument is a `Transform`, it is populated with the computed frame and returned.\n   * @returns computed localToWorld frame, or undefined if insufficient data.\n   */\n  public static createRightHandedLocalToWorld(...params: any[]): Transform | undefined {\n    return this.createRightHandedFrame(undefined, params);\n  }\n\n  /**\n   * Try to create a frame whose xy plane is through points.\n   * * If 3 or more distinct points are present, the x axis is from the first point to the most distant, and y\n   * direction is toward the point most distant from that line.\n   * @param points array of points\n   * @param result optional pre-allocated Transform to populate and return\n   * @returns localToWorld frame for the points, or undefined if insufficient data\n   */\n  public static createFrameToDistantPoints(points: Point3d[], result?: Transform): Transform | undefined {\n    if (points.length > 2) {\n      const origin = points[0];\n      const vector01 = FrameBuilder._workVector0 ?? Vector3d.create();\n      Point3dArray.indexOfMostDistantPoint(points, points[0], vector01);\n      const vector02 = FrameBuilder._workVector1 ?? Vector3d.create();\n      Point3dArray.indexOfPointWithMaxCrossProductMagnitude(points, origin, vector01, vector02);\n      const matrix = FrameBuilder._workMatrix = Matrix3d.createRigidFromColumns(vector01, vector02, AxisOrder.XYZ, FrameBuilder._workMatrix);\n      if (matrix)\n        return Transform.createOriginAndMatrix(origin, matrix, result);\n    }\n    return undefined;\n  }\n  /**\n   * Try to create a frame whose xy plane is through points, with the points appearing CCW in the local frame.\n   * * If 3 or more distinct points are present, the x axis is from the first point to the most distant, and y\n   * direction is toward the point most distant from that line.\n   * @param points array of points\n   * @param result optional pre-allocated Transform to populate and return\n   * @returns localToWorld frame for the points, or undefined if insufficient data\n   */\n  public static createFrameWithCCWPolygon(points: Point3d[], result?: Transform): Transform | undefined {\n    if (points.length > 2) {\n      const ray = PolygonOps.centroidAreaNormal(points);  // can't pass pre-allocated ray...\n      if (ray)\n        return ray.toRigidZFrame(result);\n    }\n    return undefined;\n  }\n  /**\n   * Create the localToWorld transform from a range to axes of its parent coordinate system.\n   * @param range range to inspect\n   * @param scaleSelect selects size of localToWorld axes.\n   * @param fractionX fractional coordinate of frame origin x\n   * @param fractionY fractional coordinate of frame origin y\n   * @param fractionZ fractional coordinate of frame origin z\n   * @param defaultAxisLength if true and any axis length is 0, that axis vector takes this physical length.\n   * @param result optional pre-allocated Transform to populate and return\n   * @returns localToWorld frame for the range\n   */\n  public static createLocalToWorldTransformInRange(\n    range: Range3d,\n    scaleSelect: AxisScaleSelect = AxisScaleSelect.NonUniformRangeContainment,\n    fractionX: number = 0,\n    fractionY: number = 0,\n    fractionZ: number = 0,\n    defaultAxisLength: number = 1.0,\n    result?: Transform,\n  ): Transform {\n    if (range.isNull)\n      return Transform.createIdentity(result);\n    let a = 1.0;\n    let b = 1.0;\n    let c = 1.0;\n    if (scaleSelect === AxisScaleSelect.LongestRangeDirection) {\n      a = b = c = Geometry.correctSmallMetricDistance(range.maxLength(), defaultAxisLength);\n    } else if (scaleSelect === AxisScaleSelect.NonUniformRangeContainment) {\n      a = Geometry.correctSmallMetricDistance(range.xLength(), defaultAxisLength) * Geometry.maxAbsDiff(fractionX, 0, 1);\n      b = Geometry.correctSmallMetricDistance(range.yLength(), defaultAxisLength) * Geometry.maxAbsDiff(fractionY, 0, 1);\n      c = Geometry.correctSmallMetricDistance(range.zLength(), defaultAxisLength) * Geometry.maxAbsDiff(fractionZ, 0, 1);\n    }\n    const origin = FrameBuilder._workPoint = range.fractionToPoint(fractionX, fractionY, fractionZ, FrameBuilder._workPoint);\n    const matrix = FrameBuilder._workMatrix = Matrix3d.createScale(a, b, c, FrameBuilder._workMatrix);\n    return Transform.createOriginAndMatrix(origin, matrix, result);\n  }\n}\n"]}

package/lib/cjs/geometry3d/Matrix3d.d.ts

@@ -708,7 +708,7 @@ export declare class Matrix3d implements BeJSONFunctions {
      * Specifically, `Mu = u + sw` is perpendicular to `n` for some scalar `s`, where `w` is the sweep direction, and
      * `n` is the plane normal.
      * * Symbolically, `M = I - w⊗n / w.n`, where `I` is the identity, and ⊗ is the vector outer product.
-     * @param sweepVector sweep direction. If same as `planeNormal`, the resulting matrix flattens to the plane.
+     * @param sweepVector sweep direction. If same as `planeNormal`, the resulting matrix is a projection onto the plane.
      * @param planeNormal normal to the target plane
      */
     static createFlattenAlongVectorToPlane(sweepVector: Vector3d, planeNormal: Vector3d): Matrix3d | undefined;

package/lib/cjs/geometry3d/Matrix3d.js

@@ -1535,7 +1535,7 @@ class Matrix3d {
      * Specifically, `Mu = u + sw` is perpendicular to `n` for some scalar `s`, where `w` is the sweep direction, and
      * `n` is the plane normal.
      * * Symbolically, `M = I - w⊗n / w.n`, where `I` is the identity, and ⊗ is the vector outer product.
-     * @param sweepVector sweep direction. If same as `planeNormal`, the resulting matrix flattens to the plane.
+     * @param sweepVector sweep direction. If same as `planeNormal`, the resulting matrix is a projection onto the plane.
      * @param planeNormal normal to the target plane
      */
     static createFlattenAlongVectorToPlane(sweepVector, planeNormal) {