@itwin/core-geometry 5.0.0-dev.8 → 5.0.0-dev.83

package/lib/esm/geometry4d/MomentData.d.ts

@@ -10,135 +10,137 @@ import { Matrix4d } from "./Matrix4d";
  *   * origin = local origin used as moments are summed.
  *   * sums = array of summed moments.
  *     * The [i,j] entry of the sums is a summed or integrated moment for product of axis i and j.
- *       * axes 0,1,2 are x,y,z
+ *       * axes 0,1,2 are x,y,z.
  *         * e.g. entry [0,1] is summed product xy
  *       * axis 3 is "w", which is 1 in sums.
- *         * e.g. entry 03 is summed x
- *    * In this level,
+ *         * e.g. entry 03 is summed x.
+ *    * In this level:
  *        * the `absoluteQuantity` member is undefined.
  *        * the `localToWorldMap` and `radiiOfGyration` are created by have undefined contents.
- *  * Second level: after a call to inertiaProductsToPrincipalAxes, the `localToWorldMap`, `absoluteQuantity` and `radiiOfGyration` are filled in.
+ *  * Second level: after a call to inertiaProductsToPrincipalAxes, the `localToWorldMap`, `absoluteQuantity` and
+ *    `radiiOfGyration` are filled in.
  * @public
  */
 export declare class MomentData {
     /** Origin used for sums. */
     origin: Point3d;
-    /** flag to request deferred origin setup. */
+    /** Flag to request deferred origin setup. */
     needOrigin: boolean;
-    /** Moment sums.
+    /**
+     * Moment sums.
      * * Set to zero at initialization and if requested later.
      * * Accumulated during data entry phase.
      */
     sums: Matrix4d;
-    /** the mapping between principal and world system.
+    /**
+     * The mapping between principal and world system.
      * * This set up with its inverse already constructed.
      */
     localToWorldMap: Transform;
-    /** Return the lower-right (3,3) entry in the sums.
-     * * This is the quantity (i.e. length, area, or volume) summed
+    private static _vectorA?;
+    private static _vectorB?;
+    private static _vectorC?;
+    private _point0;
+    private _point1;
+    /**
+     * Return the lower-right (3,3) entry in the sums.
+     * * This is the quantity (i.e. length, area, or volume) summed.
      */
     get quantitySum(): number;
-    /** Return a scale factor to make these sums match the target orientation sign.
+    /**
+     * Return a scale factor to make these sums match the target orientation sign.
      * * 1.0 if `this.quantitySum` has the same sign as `targetSign`.
      * * -1.0 if `this.quantitySum` has the opposite sign from `targetSign`
      */
     signFactor(targetSign: number): number;
-    /**
-     *  If `this.needOrigin` flag is set, copy `origin` to `this.origin` and clear the flag.
-     *
-     */
+    /** If `this.needOrigin` flag is set, copy `origin` to `this.origin` and clear the flag. */
     setOriginIfNeeded(origin: Point3d): void;
-    /**
-     *  If `this.needOrigin` flag is set, copy `origin` to `this.origin` and clear the flag.
-     *
-     */
+    /** If `this.needOrigin` flag is set, copy `origin` to `this.origin` and clear the flag. */
     setOriginFromGrowableXYZArrayIfNeeded(points: GrowableXYZArray): void;
-    /**
-     *  If `this.needOrigin` flag is set, copy `origin` to `this.origin` and clear the flag.
-     *
-     */
+    /** If `this.needOrigin` flag is set, copy `origin` to `this.origin` and clear the flag. */
     setOriginXYZIfNeeded(x: number, y: number, z: number): void;
-    /** radii of gyration (square roots of principal second moments)
-     */
+    /** Radii of gyration (square roots of principal second moments). */
     radiusOfGyration: Vector3d;
-    /** principal quantity (e.g. length, area, or volume).  This is undefined in raw moments, and becomes defined by
-     *
+    /**
+     * Principal quantity (e.g. length, area, or volume). This is undefined in raw moments, and becomes defined by
+     * inertiaProductsToPrincipalAxes.
      */
     absoluteQuantity?: number;
+    /** Constructor. */
     private constructor();
-    /** Create moments with optional origin.
-     * * origin and needOrigin are quirky.
+    /**
+     * Create moments with optional origin.
+     * * Origin and needOrigin are quirky.
      *   * (undefined, true) sets up to use first incoming point as origin.
-     *   * (origin) sets up to use that durable origin, set needsOrigin flag false
-     *   * (origin, true) the "true" is meaningless
-     *   * (undefined, false) makes 000 the durable origin
+     *   * (origin) sets up to use that durable origin, set needsOrigin flag false.
+     *   * (origin, true) the "true" is meaningless.
+     *   * (undefined, false) makes 000 the durable origin.
     */
     static create(origin?: Point3d | undefined, needOrigin?: boolean): MomentData;
     /**
-     * Return the formal tensor of integrated values `[yy+zz,xy,xz][yx,xx+zz,yz][zx,xy,xx+yy]`
-     * @param products matrix of (integrated) `[xx,xy,xz][yx,yy,yz][zx,xy,zz]`
+     * Return the formal tensor of integrated values `[yy+zz,xy,xz][yx,xx+zz,yz][zx,xy,xx+yy]`.
+     * @param products matrix of (integrated) `[xx,xy,xz][yx,yy,yz][zx,xy,zz]`.
      */
     static momentTensorFromInertiaProducts(products: Matrix3d): Matrix3d;
     /** Sort the columns of the matrix for increasing moments. */
     static sortColumnsForIncreasingMoments(axes: Matrix3d, moments: Vector3d): void;
     /**
      * Return the principal moment data for an array of points.
-     * @param points array of points
+     * @param points array of points.
      */
     static pointsToPrincipalAxes(points: Point3d[]): MomentData | undefined;
     /**
-     * Compute principal axes from inertial products
-     * * The radii of gyration are sorted smallest to largest
-     * * Hence x axis is long direction
-     * * Hence planar data generates large moment as Z
+     * Compute principal axes from inertial products.
+     * * The radii of gyration are sorted smallest to largest.
+     * * Hence x axis is long direction.
+     * * Hence planar data generates large moment as Z.
      * @param origin The origin used for the inertia products.
-     * @param inertiaProducts The inertia products -- sums or integrals of [xx,xy,xz,xw; yx,yy, yz,yw; zx,zy,zz,zw; wx,wy,wz,w]
+     * @param inertiaProducts The inertia products: sums or integrals of [xx,xy,xz,xw; yx,yy, yz,yw; zx,zy,zz,zw; wx,wy,wz,w].
      */
     static inertiaProductsToPrincipalAxes(origin: XYZ, inertiaProducts: Matrix4d): MomentData | undefined;
     /**
-     * Test for match among selected members as they exist after `inertiaProductsToPrincipalAxes`
-     * * The members considered are
-     *   * origin of local to world map (i.e. centroid)
-     *   * radius of gyration
+     * Test for match among selected members as they exist after `inertiaProductsToPrincipalAxes`.
+     * * The members considered are:
+     *   * origin of local to world map (i.e. centroid),
+     *   * radius of gyration,
      *   * axes of localToWorldMap.
      * * Axis direction tests allow these quirks:
      *   * opposite orientation is considered matched.
      * * Full xyz symmetry: If x,y,z radii are matched, axes are not tested.
-     * * Symmetry in xy plane: If x and y radii are matched, the x and y axes area allowed to spin freely.  Only Z direction is tested.
+     * * Symmetry in xy plane: If x and y radii are matched, the x and y axes area allowed to spin freely. Only Z direction
+     *   is tested.
      * * If either or both are undefined, returns false.
-     * @param dataA first set of moments
-     * @param dataB second set of moments
+     * @param dataA first set of moments.
+     * @param dataB second set of moments.
      */
     static areEquivalentPrincipalAxes(dataA: MomentData | undefined, dataB: MomentData | undefined): boolean;
     /** Clear the MomentData sums to zero, and establish a new origin. */
     clearSums(origin?: Point3d): void;
     /** Accumulate products-of-components for given points. */
     accumulatePointMomentsFromOrigin(points: Point3d[]): void;
-    /** revise the accumulated sums to be "around the centroid" */
+    /** Revise the accumulated sums to be "around the centroid". */
     shiftOriginAndSumsToCentroidOfSums(): boolean;
-    /** revise the accumulated sums
+    /**
+     * Revise the accumulated sums.
      * * add ax,ay,ax to the origin coordinates.
      * * apply the negative translation to the sums.
     */
     shiftOriginAndSumsByXYZ(ax: number, ay: number, az: number): void;
-    /** revise the accumulated sums so they are based at a specified origin. */
+    /** Revise the accumulated sums so they are based at a specified origin. */
     shiftOriginAndSumsToNewOrigin(newOrigin: XYAndZ): void;
-    private static _vectorA?;
-    private static _vectorB?;
-    private static _vectorC?;
-    /** compute moments of a triangle from the origin to the given line.
+    /**
+     * Compute moments of a triangle from the origin to the given line.
      * Accumulate them to this.sums.
      * * If `pointA` is undefined, use `this.origin` as pointA.
      * * If `this.needOrigin` is set, pointB is used
     */
     accumulateTriangleMomentsXY(pointA: XAndY | undefined, pointB: XAndY, pointC: XAndY): void;
-    /** add scaled outer product of (4d, unit weight) point to this.sums */
+    /** Add scaled outer product of (4d, unit weight) point to this.sums. */
     accumulateScaledOuterProduct(point: XYAndZ, scaleFactor: number): void;
     /** Accumulate wire moment integral from pointA to pointB */
     accumulateLineMomentsXYZ(pointA: Point3d, pointB: Point3d): void;
-    private _point0;
-    private _point1;
-    /** compute moments of triangles from a base point to the given linestring.
+    /**
+     * Compute moments of triangles from a base point to the given linestring.
      * Accumulate them to this.sums.
      * * If `pointA` is undefined, use `this.origin` as pointA.
      * * If `this.needOrigin` is set, the first point of the array is captured as local origin for subsequent sums.
@@ -147,34 +149,31 @@ export declare class MomentData {
     accumulateTriangleToLineStringMomentsXY(sweepBase: XAndY | undefined, points: GrowableXYZArray): void;
     /**
      * * Assemble XX, YY, XY products into a full matrix form [xx,xy,0,0; xy,yy,0,0;0,0,0,0;0,0,0,1].
-     * * Sandwich this between transforms with columns [vectorU, vectorV, 0000, origin].  (Column weights 0001) (only xy parts of vectors)
+     * * Sandwich this between transforms with columns [vectorU, vectorV, 0000, origin].  (Column weights 0001) (only xy
+     *   parts of vectors).
      * * scale by detJ for the xy-only determinant of the vectors.
      * @param productXX
      * @param productXY
      * @param productYY
-     * @param area Area in caller's system
-     * @param origin Caller's origin
-     * @param vectorU Caller's U axis (not necessarily unit)
-     * @param vectorV Caller's V axis (not necessarily unit)
+     * @param area Area in caller's system.
+     * @param origin Caller's origin.
+     * @param vectorU Caller's U axis (not necessarily unit).
+     * @param vectorV Caller's V axis (not necessarily unit).
      */
     accumulateXYProductsInCentroidalFrame(productXX: number, productXY: number, productYY: number, area: number, origin: XAndY, vectorU: XAndY, vectorV: XAndY): void;
     /**
      * Accumulate sums from other moments.
-     * * scale by given scaleFactor (e.g. sign to correct orientation)
-     * * pull the origin from `other` if `this` needs an origin.
-     * *
+     * * Scale by given scaleFactor (e.g. sign to correct orientation).
+     * * Pull the origin from `other` if `this` needs an origin.
      */
     accumulateProducts(other: MomentData, scale: number): void;
     /**
-   * Accumulate sums from Matrix4d and origin.
-   * * scale by given scaleFactor (e.g. sign to correct orientation)
-   * * trap the origin if `this` needs an origin.
-   * *
-   */
-    accumulateProductsFromOrigin(origin: Point3d, products: Matrix4d, scale: number): void;
-    /**
-     * Convert to a json data object with:
+     * Accumulate sums from Matrix4d and origin.
+     * * Scale by given scaleFactor (e.g. sign to correct orientation).
+     * * Trap the origin if `this` needs an origin.
      */
+    accumulateProductsFromOrigin(origin: Point3d, products: Matrix4d, scale: number): void;
+    /** Convert to a json data object. */
     toJSON(): any;
 }
 //# sourceMappingURL=MomentData.d.ts.map

package/lib/esm/geometry4d/MomentData.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MomentData.d.ts","sourceRoot":"","sources":["../../../src/geometry4d/MomentData.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"MomentData.d.ts","sourceRoot":"","sources":["../../../src/geometry4d/MomentData.ts"],"names":[],"mappings":"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"}

package/lib/esm/geometry4d/MomentData.js

@@ -5,8 +5,8 @@
 /** @packageDocumentation
  * @module Numerics
  */
-// import { Point2d } from "./Geometry2d";
 /* eslint-disable @typescript-eslint/naming-convention */
+// cspell:word ABAT
 import { Geometry } from "../Geometry";
 import { Matrix3d } from "../geometry3d/Matrix3d";
 import { Point3d, Vector3d } from "../geometry3d/Point3dVector3d";
@@ -19,61 +19,84 @@ import { Point4d } from "./Point4d";
  *   * origin = local origin used as moments are summed.
  *   * sums = array of summed moments.
  *     * The [i,j] entry of the sums is a summed or integrated moment for product of axis i and j.
- *       * axes 0,1,2 are x,y,z
+ *       * axes 0,1,2 are x,y,z.
  *         * e.g. entry [0,1] is summed product xy
  *       * axis 3 is "w", which is 1 in sums.
- *         * e.g. entry 03 is summed x
- *    * In this level,
+ *         * e.g. entry 03 is summed x.
+ *    * In this level:
  *        * the `absoluteQuantity` member is undefined.
  *        * the `localToWorldMap` and `radiiOfGyration` are created by have undefined contents.
- *  * Second level: after a call to inertiaProductsToPrincipalAxes, the `localToWorldMap`, `absoluteQuantity` and `radiiOfGyration` are filled in.
+ *  * Second level: after a call to inertiaProductsToPrincipalAxes, the `localToWorldMap`, `absoluteQuantity` and
+ *    `radiiOfGyration` are filled in.
  * @public
  */
 export class MomentData {
-    /** Return the lower-right (3,3) entry in the sums.
-     * * This is the quantity (i.e. length, area, or volume) summed
+    /** Origin used for sums. */
+    origin;
+    /** Flag to request deferred origin setup. */
+    needOrigin;
+    /**
+     * Moment sums.
+     * * Set to zero at initialization and if requested later.
+     * * Accumulated during data entry phase.
+     */
+    sums;
+    /**
+     * The mapping between principal and world system.
+     * * This set up with its inverse already constructed.
      */
-    get quantitySum() { return this.sums.atIJ(3, 3); }
-    /** Return a scale factor to make these sums match the target orientation sign.
+    localToWorldMap;
+    // private variables
+    static _vectorA;
+    static _vectorB;
+    static _vectorC;
+    _point0 = Point3d.create();
+    _point1 = Point3d.create();
+    /**
+     * Return the lower-right (3,3) entry in the sums.
+     * * This is the quantity (i.e. length, area, or volume) summed.
+     */
+    get quantitySum() {
+        return this.sums.atIJ(3, 3);
+    }
+    /**
+     * Return a scale factor to make these sums match the target orientation sign.
      * * 1.0 if `this.quantitySum` has the same sign as `targetSign`.
      * * -1.0 if `this.quantitySum` has the opposite sign from `targetSign`
      */
     signFactor(targetSign) {
         return targetSign * this.quantitySum > 0 ? 1.0 : -1.0;
     }
-    /**
-     *  If `this.needOrigin` flag is set, copy `origin` to `this.origin` and clear the flag.
-     *
-     */
+    /** If `this.needOrigin` flag is set, copy `origin` to `this.origin` and clear the flag. */
     setOriginIfNeeded(origin) {
         if (this.needOrigin) {
             this.origin.setFromPoint3d(origin);
             this.needOrigin = false;
         }
     }
-    /**
-     *  If `this.needOrigin` flag is set, copy `origin` to `this.origin` and clear the flag.
-     *
-     */
+    /** If `this.needOrigin` flag is set, copy `origin` to `this.origin` and clear the flag. */
     setOriginFromGrowableXYZArrayIfNeeded(points) {
         if (this.needOrigin && points.length > 0) {
             points.getPoint3dAtCheckedPointIndex(0, this.origin);
             this.needOrigin = false;
         }
     }
-    /**
-     *  If `this.needOrigin` flag is set, copy `origin` to `this.origin` and clear the flag.
-     *
-     */
+    /** If `this.needOrigin` flag is set, copy `origin` to `this.origin` and clear the flag. */
     setOriginXYZIfNeeded(x, y, z) {
         if (this.needOrigin) {
             this.origin.set(x, y, z);
             this.needOrigin = false;
         }
     }
+    /** Radii of gyration (square roots of principal second moments). */
+    radiusOfGyration;
+    /**
+     * Principal quantity (e.g. length, area, or volume). This is undefined in raw moments, and becomes defined by
+     * inertiaProductsToPrincipalAxes.
+     */
+    absoluteQuantity;
+    /** Constructor. */
     constructor() {
-        this._point0 = Point3d.create();
-        this._point1 = Point3d.create();
         this.origin = Point3d.createZero();
         this.sums = Matrix4d.createZero();
         this.localToWorldMap = Transform.createIdentity();
@@ -82,12 +105,13 @@ export class MomentData {
         this.absoluteQuantity = 0.1; // so optimizer sees its type
         this.absoluteQuantity = undefined;
     }
-    /** Create moments with optional origin.
-     * * origin and needOrigin are quirky.
+    /**
+     * Create moments with optional origin.
+     * * Origin and needOrigin are quirky.
      *   * (undefined, true) sets up to use first incoming point as origin.
-     *   * (origin) sets up to use that durable origin, set needsOrigin flag false
-     *   * (origin, true) the "true" is meaningless
-     *   * (undefined, false) makes 000 the durable origin
+     *   * (origin) sets up to use that durable origin, set needsOrigin flag false.
+     *   * (origin, true) the "true" is meaningless.
+     *   * (undefined, false) makes 000 the durable origin.
     */
     static create(origin, needOrigin = false) {
         const data = new MomentData();
@@ -99,8 +123,8 @@ export class MomentData {
         return data;
     }
     /**
-     * Return the formal tensor of integrated values `[yy+zz,xy,xz][yx,xx+zz,yz][zx,xy,xx+yy]`
-     * @param products matrix of (integrated) `[xx,xy,xz][yx,yy,yz][zx,xy,zz]`
+     * Return the formal tensor of integrated values `[yy+zz,xy,xz][yx,xx+zz,yz][zx,xy,xx+yy]`.
+     * @param products matrix of (integrated) `[xx,xy,xz][yx,yy,yz][zx,xy,zz]`.
      */
     static momentTensorFromInertiaProducts(products) {
         const rr = products.sumDiagonal();
@@ -133,7 +157,7 @@ export class MomentData {
     }
     /**
      * Return the principal moment data for an array of points.
-     * @param points array of points
+     * @param points array of points.
      */
     static pointsToPrincipalAxes(points) {
         const moments = new MomentData();
@@ -144,12 +168,12 @@ export class MomentData {
         return this.inertiaProductsToPrincipalAxes(moments.origin, moments.sums);
     }
     /**
-     * Compute principal axes from inertial products
-     * * The radii of gyration are sorted smallest to largest
-     * * Hence x axis is long direction
-     * * Hence planar data generates large moment as Z
+     * Compute principal axes from inertial products.
+     * * The radii of gyration are sorted smallest to largest.
+     * * Hence x axis is long direction.
+     * * Hence planar data generates large moment as Z.
      * @param origin The origin used for the inertia products.
-     * @param inertiaProducts The inertia products -- sums or integrals of [xx,xy,xz,xw; yx,yy, yz,yw; zx,zy,zz,zw; wx,wy,wz,w]
+     * @param inertiaProducts The inertia products: sums or integrals of [xx,xy,xz,xw; yx,yy, yz,yw; zx,zy,zz,zw; wx,wy,wz,w].
      */
     static inertiaProductsToPrincipalAxes(origin, inertiaProducts) {
         const moments = new MomentData();
@@ -177,18 +201,19 @@ export class MomentData {
         return moments;
     }
     /**
-     * Test for match among selected members as they exist after `inertiaProductsToPrincipalAxes`
-     * * The members considered are
-     *   * origin of local to world map (i.e. centroid)
-     *   * radius of gyration
+     * Test for match among selected members as they exist after `inertiaProductsToPrincipalAxes`.
+     * * The members considered are:
+     *   * origin of local to world map (i.e. centroid),
+     *   * radius of gyration,
      *   * axes of localToWorldMap.
      * * Axis direction tests allow these quirks:
      *   * opposite orientation is considered matched.
      * * Full xyz symmetry: If x,y,z radii are matched, axes are not tested.
-     * * Symmetry in xy plane: If x and y radii are matched, the x and y axes area allowed to spin freely.  Only Z direction is tested.
+     * * Symmetry in xy plane: If x and y radii are matched, the x and y axes area allowed to spin freely. Only Z direction
+     *   is tested.
      * * If either or both are undefined, returns false.
-     * @param dataA first set of moments
-     * @param dataB second set of moments
+     * @param dataA first set of moments.
+     * @param dataB second set of moments.
      */
     static areEquivalentPrincipalAxes(dataA, dataB) {
         if (dataA && dataB
@@ -236,7 +261,7 @@ export class MomentData {
             this.sums.addMomentsInPlace(p.x - this.origin.x, p.y - this.origin.y, p.z - this.origin.z, 1.0);
         }
     }
-    /** revise the accumulated sums to be "around the centroid" */
+    /** Revise the accumulated sums to be "around the centroid". */
     shiftOriginAndSumsToCentroidOfSums() {
         const xyz = this.sums.columnW().realPoint();
         if (xyz) {
@@ -245,7 +270,8 @@ export class MomentData {
         }
         return false;
     }
-    /** revise the accumulated sums
+    /**
+     * Revise the accumulated sums.
      * * add ax,ay,ax to the origin coordinates.
      * * apply the negative translation to the sums.
     */
@@ -253,11 +279,12 @@ export class MomentData {
         this.origin.addXYZInPlace(ax, ay, az);
         this.sums.multiplyTranslationSandwichInPlace(-ax, -ay, -az);
     }
-    /** revise the accumulated sums so they are based at a specified origin. */
+    /** Revise the accumulated sums so they are based at a specified origin. */
     shiftOriginAndSumsToNewOrigin(newOrigin) {
         this.shiftOriginAndSumsByXYZ(newOrigin.x - this.origin.x, newOrigin.y - this.origin.y, newOrigin.z - this.origin.z);
     }
-    /** compute moments of a triangle from the origin to the given line.
+    /**
+     * Compute moments of a triangle from the origin to the given line.
      * Accumulate them to this.sums.
      * * If `pointA` is undefined, use `this.origin` as pointA.
      * * If `this.needOrigin` is set, pointB is used
@@ -289,7 +316,7 @@ export class MomentData {
             this.sums.addScaledOuterProductInPlace(vectorC, vectorC, r1_12);
         }
     }
-    /** add scaled outer product of (4d, unit weight) point to this.sums */
+    /** Add scaled outer product of (4d, unit weight) point to this.sums. */
     accumulateScaledOuterProduct(point, scaleFactor) {
         this.setOriginXYZIfNeeded(point.x, point.y, 0.0);
         const vectorA = MomentData._vectorA = Point4d.create(point.x - this.origin.x, point.y - this.origin.y, point.z - this.origin.z, 1.0, MomentData._vectorA);
@@ -311,7 +338,8 @@ export class MomentData {
         this.sums.addScaledOuterProductInPlace(vectorB, vectorA, r1_6);
         this.sums.addScaledOuterProductInPlace(vectorB, vectorB, r1_3);
     }
-    /** compute moments of triangles from a base point to the given linestring.
+    /**
+     * Compute moments of triangles from a base point to the given linestring.
      * Accumulate them to this.sums.
      * * If `pointA` is undefined, use `this.origin` as pointA.
      * * If `this.needOrigin` is set, the first point of the array is captured as local origin for subsequent sums.
@@ -328,18 +356,18 @@ export class MomentData {
             }
         }
     }
-    // cspell:word ABAT
     /**
      * * Assemble XX, YY, XY products into a full matrix form [xx,xy,0,0; xy,yy,0,0;0,0,0,0;0,0,0,1].
-     * * Sandwich this between transforms with columns [vectorU, vectorV, 0000, origin].  (Column weights 0001) (only xy parts of vectors)
+     * * Sandwich this between transforms with columns [vectorU, vectorV, 0000, origin].  (Column weights 0001) (only xy
+     *   parts of vectors).
      * * scale by detJ for the xy-only determinant of the vectors.
      * @param productXX
      * @param productXY
      * @param productYY
-     * @param area Area in caller's system
-     * @param origin Caller's origin
-     * @param vectorU Caller's U axis (not necessarily unit)
-     * @param vectorV Caller's V axis (not necessarily unit)
+     * @param area Area in caller's system.
+     * @param origin Caller's origin.
+     * @param vectorU Caller's U axis (not necessarily unit).
+     * @param vectorV Caller's V axis (not necessarily unit).
      */
     accumulateXYProductsInCentroidalFrame(productXX, productXY, productYY, area, origin, vectorU, vectorV) {
         const centroidalProducts = Matrix4d.createRowValues(productXX, productXY, 0, 0, productXY, productYY, 0, 0, 0, 0, 0, 0, 0, 0, 0, area);
@@ -351,27 +379,23 @@ export class MomentData {
     }
     /**
      * Accumulate sums from other moments.
-     * * scale by given scaleFactor (e.g. sign to correct orientation)
-     * * pull the origin from `other` if `this` needs an origin.
-     * *
+     * * Scale by given scaleFactor (e.g. sign to correct orientation).
+     * * Pull the origin from `other` if `this` needs an origin.
      */
     accumulateProducts(other, scale) {
         this.setOriginIfNeeded(other.origin);
         this.sums.addTranslationSandwichInPlace(other.sums, this.origin.x - other.origin.x, this.origin.y - other.origin.y, this.origin.z - other.origin.z, scale);
     }
     /**
-   * Accumulate sums from Matrix4d and origin.
-   * * scale by given scaleFactor (e.g. sign to correct orientation)
-   * * trap the origin if `this` needs an origin.
-   * *
-   */
+     * Accumulate sums from Matrix4d and origin.
+     * * Scale by given scaleFactor (e.g. sign to correct orientation).
+     * * Trap the origin if `this` needs an origin.
+     */
     accumulateProductsFromOrigin(origin, products, scale) {
         this.setOriginIfNeeded(origin);
         this.sums.addTranslationSandwichInPlace(products, this.origin.x - origin.x, this.origin.y - origin.y, this.origin.z - origin.z, scale);
     }
-    /**
-     * Convert to a json data object with:
-     */
+    /** Convert to a json data object. */
     toJSON() {
         return {
             origin: this.origin,