@itwin/core-geometry 3.0.0-dev.76 → 3.0.0-dev.80

package/lib/esm/numerics/UsageSums.js

@@ -0,0 +1,128 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+import { Geometry } from "../Geometry";
+import { Range1d } from "../geometry3d/Range";
+/**
+ * Accumulator for computing average and standard deviations.
+ * * Usual usage pattern:
+ *   * create with `sums = new UsageSums ()`
+ *   * announce data values with any combination of
+ *      * `sums.accumulate (x: number)`
+ *      * `sums.accumulateArray (data: numberArray)`
+ *   * query properties at any time:
+ *      * `sums.mean`
+ *      * `sums.count`
+ *      * `sums.meanSquare`
+ *      * `sums.standardDeviation`
+ *      * `sums.minMax`
+ * * Optional `origin`
+ *   * if `origin` is nonzero:
+ *      * when a value `x` is announced to the `accumulate(x)` method, the value used for sums is `(x-origin)`
+ *   * All queries (mean, minMax, meanSquare, standardDeviation) return values relative to the origin.
+ *   * The origin can be reset in two different ways:
+ *     * `setOrigin(a)` sets the saved origin value to `a`, but leaves sums unchanged.
+ *       * This affects subsequence how sums are changed by `announce(x)`
+ *     * `shiftOriginAndSums` sets the origin (like `sums.setOrigin (a))` and also corrects all sums and minMax so they appear that the new origin had been in effect during all prior `accumulate(x)` calls.
+ * @internal
+ */
+export class UsageSums {
+    /** Constructor:
+     * * All sums 0
+     * * min and max set to extreme values.
+     * * origin assigned.
+     */
+    constructor(origin = 0) {
+        this._minMax = Range1d.createNull();
+        this._count = this._sumX = this._sumXX = 0;
+        this._origin = origin;
+    }
+    /** Return the number of samples seen */
+    get count() { return this._count; }
+    /** return the mean of all samples.
+     * * Return 0 if no samples
+     */
+    get mean() { return this._count > 0 ? this._sumX / this._count : 0.0; }
+    /** Return the mean of  squared samples.
+     * * Return 0 if no samples.
+     */
+    get meanSquare() { return this._count > 0 ? this._sumXX / this._count : 0.0; }
+    get minMax() { return this._minMax.clone(); }
+    /**
+     * Return the "biased standard deviation" (https://en.wikipedia.org/wiki/Standard_deviation)
+     * * This is zero if count is zero.
+     */
+    get standardDeviation() {
+        if (this._count < 1)
+            return 0.0;
+        const xBar = this.mean;
+        const sumXX = this._sumXX;
+        const sumX = this._sumX;
+        return Math.sqrt((sumXX - 2 * xBar * sumX + this._count * xBar * xBar) / this._count);
+    }
+    /** Reinitialize all sums.
+     * * origin is unchanged
+     */
+    clearSums() {
+        this._count = this._sumX = this._sumXX = 0;
+        this._minMax.setNull();
+    }
+    /**
+     * return the origin being used in the `accumulate(x)` method.
+     */
+    get origin() { return this._origin; }
+    /**
+     * Reset the origin.
+     * * Former sums are unchanged !!
+     * @param origin new origin
+     */
+    setOrigin(origin) {
+        this._origin = origin;
+    }
+    /**
+     * * reset the origin
+     * * adjust all sums to what they would be if the new origin had been in effect.
+     */
+    shiftOriginAndSums(origin) {
+        const delta = origin - this._origin;
+        this._origin = origin;
+        // adjust sumXX first to get old sumX value before it is modified.
+        this._sumXX = this._sumXX - 2 * delta * this._sumX + this._count * delta * delta;
+        this._sumX = this._sumX - this._count * delta;
+        this._minMax.cloneTranslated(-delta, this._minMax);
+    }
+    /** Accumulate a single value */
+    accumulate(x) {
+        x = x - this._origin;
+        this._count += 1;
+        this._sumX += x;
+        this._sumXX += x * x;
+        this._minMax.extendX(x);
+    }
+    /** Accumulate a single value */
+    accumulateArray(xArray) {
+        for (const x of xArray)
+            this.accumulate(x);
+    }
+    /** Clone all content (origin, count, sums, minMax) */
+    clone(result) {
+        if (!result)
+            result = new UsageSums();
+        this._minMax.clone(result._minMax);
+        result._count = this._count;
+        result._origin = this._origin;
+        result._sumX = this._sumX;
+        result._sumXX = this._sumXX;
+        return result;
+    }
+    /** Compare all content. */
+    isAlmostEqual(other) {
+        return Geometry.isAlmostEqualNumber(this._sumX, other._sumX)
+            && Geometry.isAlmostEqualNumber(this._sumXX, other._sumXX)
+            && Geometry.isAlmostEqualNumber(this._origin, other._origin)
+            && this._count === other._count
+            && this._minMax.isAlmostEqual(other._minMax);
+    }
+}
+//# sourceMappingURL=UsageSums.js.map

package/lib/esm/numerics/UsageSums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UsageSums.js","sourceRoot":"","sources":["../../../src/numerics/UsageSums.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\nimport { Geometry } from \"../Geometry\";\r\nimport { Range1d } from \"../geometry3d/Range\";\r\n\r\n/**\r\n * Accumulator for computing average and standard deviations.\r\n * * Usual usage pattern:\r\n *   * create with `sums = new UsageSums ()`\r\n *   * announce data values with any combination of\r\n *      * `sums.accumulate (x: number)`\r\n *      * `sums.accumulateArray (data: numberArray)`\r\n *   * query properties at any time:\r\n *      * `sums.mean`\r\n *      * `sums.count`\r\n *      * `sums.meanSquare`\r\n *      * `sums.standardDeviation`\r\n *      * `sums.minMax`\r\n * * Optional `origin`\r\n *   * if `origin` is nonzero:\r\n *      * when a value `x` is announced to the `accumulate(x)` method, the value used for sums is `(x-origin)`\r\n *   * All queries (mean, minMax, meanSquare, standardDeviation) return values relative to the origin.\r\n *   * The origin can be reset in two different ways:\r\n *     * `setOrigin(a)` sets the saved origin value to `a`, but leaves sums unchanged.\r\n *       * This affects subsequence how sums are changed by `announce(x)`\r\n *     * `shiftOriginAndSums` sets the origin (like `sums.setOrigin (a))` and also corrects all sums and minMax so they appear that the new origin had been in effect during all prior `accumulate(x)` calls.\r\n * @internal\r\n */\r\nexport class UsageSums {\r\n  /** number of values accumulated. */\r\n  private _count: number;\r\n  /** Sum of values sent to `accumulate` (with origin subtracted away) */\r\n  private _sumX: number;\r\n  private _sumXX: number;\r\n  private _minMax: Range1d;\r\n  /** working origin.\r\n   * * All other values -- sum0, sum1, sum2, min,max -- are \"from this origin\"\r\n   */\r\n  private _origin: number;\r\n\r\n  /** Constructor:\r\n   * * All sums 0\r\n   * * min and max set to extreme values.\r\n   * * origin assigned.\r\n   */\r\n  public constructor(origin: number = 0) {\r\n    this._minMax = Range1d.createNull();\r\n    this._count = this._sumX = this._sumXX = 0;\r\n    this._origin = origin;\r\n  }\r\n  /** Return the number of samples seen */\r\n  public get count(): number { return this._count; }\r\n  /** return the mean of all samples.\r\n   * * Return 0 if no samples\r\n   */\r\n  public get mean(): number { return this._count > 0 ? this._sumX / this._count : 0.0; }\r\n  /** Return the mean of  squared samples.\r\n   * * Return 0 if no samples.\r\n   */\r\n  public get meanSquare(): number { return this._count > 0 ? this._sumXX / this._count : 0.0; }\r\n  public get minMax(): Range1d { return this._minMax.clone(); }\r\n\r\n  /**\r\n   * Return the \"biased standard deviation\" (https://en.wikipedia.org/wiki/Standard_deviation)\r\n   * * This is zero if count is zero.\r\n   */\r\n  public get standardDeviation(): number {\r\n    if (this._count < 1)\r\n      return 0.0;\r\n    const xBar = this.mean;\r\n    const sumXX = this._sumXX;\r\n    const sumX = this._sumX;\r\n    return Math.sqrt((sumXX - 2 * xBar * sumX + this._count * xBar * xBar) / this._count);\r\n  }\r\n  /** Reinitialize all sums.\r\n   * * origin is unchanged\r\n   */\r\n  public clearSums() {\r\n    this._count = this._sumX = this._sumXX = 0;\r\n    this._minMax.setNull();\r\n  }\r\n  /**\r\n   * return the origin being used in the `accumulate(x)` method.\r\n   */\r\n  public get origin(): number { return this._origin; }\r\n  /**\r\n   * Reset the origin.\r\n   * * Former sums are unchanged !!\r\n   * @param origin new origin\r\n   */\r\n  public setOrigin(origin: number) {\r\n    this._origin = origin;\r\n  }\r\n  /**\r\n   * * reset the origin\r\n   * * adjust all sums to what they would be if the new origin had been in effect.\r\n   */\r\n  public shiftOriginAndSums(origin: number) {\r\n    const delta = origin - this._origin;\r\n    this._origin = origin;\r\n    // adjust sumXX first to get old sumX value before it is modified.\r\n    this._sumXX = this._sumXX - 2 * delta * this._sumX + this._count * delta * delta;\r\n    this._sumX = this._sumX - this._count * delta;\r\n    this._minMax.cloneTranslated(-delta, this._minMax);\r\n  }\r\n  /** Accumulate a single value */\r\n  public accumulate(x: number) {\r\n    x = x - this._origin;\r\n    this._count += 1;\r\n    this._sumX += x;\r\n    this._sumXX += x * x;\r\n    this._minMax.extendX(x);\r\n  }\r\n  /** Accumulate a single value */\r\n  public accumulateArray(xArray: number[]) {\r\n    for (const x of xArray)\r\n      this.accumulate(x);\r\n  }\r\n  /** Clone all content (origin, count, sums, minMax) */\r\n  public clone(result?: UsageSums): UsageSums {\r\n    if (!result)\r\n      result = new UsageSums();\r\n    this._minMax.clone(result._minMax);\r\n    result._count = this._count;\r\n    result._origin = this._origin;\r\n    result._sumX = this._sumX;\r\n    result._sumXX = this._sumXX;\r\n    return result;\r\n  }\r\n  /** Compare all content. */\r\n  public isAlmostEqual(other: UsageSums): boolean {\r\n    return Geometry.isAlmostEqualNumber(this._sumX, other._sumX)\r\n      && Geometry.isAlmostEqualNumber(this._sumXX, other._sumXX)\r\n      && Geometry.isAlmostEqualNumber(this._origin, other._origin)\r\n      && this._count === other._count\r\n      && this._minMax.isAlmostEqual(other._minMax);\r\n  }\r\n}\r\n"]}

package/lib/esm/polyface/AuxData.d.ts

@@ -0,0 +1,112 @@
+/** @packageDocumentation
+ * @module Polyface
+ */
+import { Transform } from "../geometry3d/Transform";
+import { Range1d, Range3d } from "../geometry3d/Range";
+/** The types of data that can be represented by an [[AuxChannelData]]. Each type of data contributes differently to the
+ * animation applied by an [AnalysisStyle]($common) and responds differently when the host [[PolyfaceAuxData]] is transformed.
+ * @public
+ */
+export declare enum AuxChannelDataType {
+    /** General-purpose scalar values like stress, temperature, etc., used to recolor the [[Polyface]]'s vertices.
+     * When the host Polyface is transformed, scalar values remain unmodified.
+     */
+    Scalar = 0,
+    /** Distances in meters used to recolor the [[Polyface]]'s vertices.
+     * When the host [[Polyface]] is transformed the [[Transform]]'s scale is applied to the distances.
+     */
+    Distance = 1,
+    /** (X, Y, Z) displacement vectors added to the [[Polyface]]'s vertex positions resulting in deformation of the mesh.
+     * When the host Polyface is transformed the displacements are rotated and scaled accordingly.
+     */
+    Vector = 2,
+    /** (X, Y, Z) normal vectors that replace the host [[Polyface]]'s own normals.
+     * When the Polyface is transformed the normals are rotated accordingly.
+     */
+    Normal = 3
+}
+/**  Represents the [[AuxChannel]] data at a single input value.
+ * @public
+*/
+export declare class AuxChannelData {
+    /** The input value for this data. */
+    input: number;
+    /** The vertex values for this data. A single value per vertex for scalar and distance types and 3 values (x,y,z) for normal or vector channels. */
+    values: number[];
+    /** Construct a new [[AuxChannelData]] from input value and vertex values. */
+    constructor(input: number, values: number[] | Float64Array);
+    /** Copy blocks of size `blockSize` from (blocked index) `thisIndex` in this AuxChannelData to (blockIndex) `otherIndex` of `other` */
+    copyValues(other: AuxChannelData, thisIndex: number, otherIndex: number, blockSize: number): void;
+    /** return a deep copy */
+    clone(): AuxChannelData;
+    /** toleranced comparison of the `input` and `value` fields.
+     * * Default tolerance is 1.0e-8
+     */
+    isAlmostEqual(other: AuxChannelData, tol?: number): boolean;
+}
+/**  Represents a single [[PolyfaceAuxData]] channel.
+ * @public
+*/
+export declare class AuxChannel {
+    /** An array of [[AuxChannelData]] that represents the vertex data at one or more input values. */
+    data: AuxChannelData[];
+    /** The type of data stored in this channel. */
+    dataType: AuxChannelDataType;
+    /** The channel name. This is used to present the [[AuxChannel]] to the user and also to select the [[AuxChannel]] for display from AnalysisStyle */
+    name?: string;
+    /** The input name. */
+    inputName?: string;
+    /** Create a [[AuxChannel]] */
+    constructor(data: AuxChannelData[], dataType: AuxChannelDataType, name?: string, inputName?: string);
+    /** Return a deep copy. */
+    clone(): AuxChannel;
+    /** Toleranced comparison of contents. */
+    isAlmostEqual(other: AuxChannel, tol?: number): boolean;
+    /** True if [[entriesPerValue]] is `1`. */
+    get isScalar(): boolean;
+    /** The number of values in `data.values` per entry - 1 for scalar and distance types, 3 for normal and vector types. */
+    get entriesPerValue(): number;
+    /** The number of entries in `data.values`. */
+    get valueCount(): number;
+    /** The minimum and maximum values in `data.values`, or `undefined` if [[isScalar]] is false. */
+    get scalarRange(): Range1d | undefined;
+    /** Compute the range of this channel's displacement values, if [[dataType]] is [[AuxChannelDataType.Vector]].
+     * @param scale Scale by which to multiply each displacement.
+     * @param result Preallocated object in which to store result.
+     * @returns The range encompassing all this channel's displacements scaled by `scale`; or a null range if this channel does not contain displacements.
+     */
+    computeDisplacementRange(scale?: number, result?: Range3d): Range3d;
+}
+/**  The `PolyfaceAuxData` structure contains one or more analytical data channels for each vertex of a [[Polyface]], allowing the polyface to be styled
+ * using an [AnalysisStyle]($common).
+ * Typically a polyface will contain only vertex data required for its basic display: the vertex position, normal
+ * and possibly texture parameter. `PolyfaceAuxData` provides supplemental data that is generally computed
+ * in an analysis program or other external data source. This can be scalar data used to either override the vertex colors through, or
+ * XYZ data used to deform the mesh by adjusting the vertex positions and/or normals.
+ * @see [[PolyfaceData.auxData]] to associate auxiliary data with a polyface.
+ * @public
+ */
+export declare class PolyfaceAuxData {
+    /** Array with one or more channels of auxiliary data for the associated polyface. */
+    channels: AuxChannel[];
+    /** The indices (shared by all data in all channels) mapping the data to the mesh facets. */
+    indices: number[];
+    constructor(channels: AuxChannel[], indices: number[]);
+    /** Return a deep copy. */
+    clone(): PolyfaceAuxData;
+    /** Returns true if `this` is equivalent to `other` within `tolerance`.
+     * The indices are compared for exact equality. The data in the channels are compared using `tolerance`, which defaults to 1.0e-8.
+     */
+    isAlmostEqual(other: PolyfaceAuxData, tolerance?: number): boolean;
+    /** Returns true if both `left` and `right` are undefined, or both are defined and equivalent within `tolerance` (default: 1.0e-8). */
+    static isAlmostEqual(left: PolyfaceAuxData | undefined, right: PolyfaceAuxData | undefined, tol?: number): boolean;
+    /** Create a PolyfaceAuxData for use by a [[PolyfaceVisitor]].  */
+    createForVisitor(): PolyfaceAuxData;
+    /** Apply `transform` to the data in each channel.
+     * @see [[AuxChannelDataType]] for details regarding how each data type is affected by the transform.
+     * @note This method may fail if a channel of [[AuxChannelDataType.Normal]] exists and `transform.matrix` is non-invertible.
+     * @returns true if the channels were all successfully transformed.
+     */
+    tryTransformInPlace(transform: Transform): boolean;
+}
+//# sourceMappingURL=AuxData.d.ts.map

package/lib/esm/polyface/AuxData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuxData.d.ts","sourceRoot":"","sources":["../../../src/polyface/AuxData.ts"],"names":[],"mappings":"AAKA;;GAEG;AAIH,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAKpD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEvD;;;GAGG;AACH,oBAAY,kBAAkB;IAC5B;;OAEG;IACH,MAAM,IAAI;IACV;;OAEG;IACH,QAAQ,IAAI;IACZ;;OAEG;IACH,MAAM,IAAI;IACV;;OAEG;IACH,MAAM,IAAI;CACX;AAED;;EAEE;AACF,qBAAa,cAAc;IACzB,qCAAqC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACrB,mJAAmJ;IAC5I,MAAM,EAAE,MAAM,EAAE,CAAC;IAExB,6EAA6E;gBACjE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,YAAY;IAS1D,sIAAsI;IAC/H,UAAU,CAAC,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAKxG,yBAAyB;IAClB,KAAK,IAAI,cAAc;IAI9B;;OAEG;IACI,aAAa,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO;CAInE;AAED;;EAEE;AACF,qBAAa,UAAU;IACrB,kGAAkG;IAC3F,IAAI,EAAE,cAAc,EAAE,CAAC;IAC9B,+CAA+C;IACxC,QAAQ,EAAE,kBAAkB,CAAC;IACpC,oJAAoJ;IAC7I,IAAI,CAAC,EAAE,MAAM,CAAC;IACrB,sBAAsB;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IAE1B,8BAA8B;gBACX,IAAI,EAAE,cAAc,EAAE,EAAE,QAAQ,EAAE,kBAAkB,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;IAO1G,0BAA0B;IACnB,KAAK,IAAI,UAAU;IAM1B,yCAAyC;IAClC,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO;IAc9D,0CAA0C;IAC1C,IAAW,QAAQ,IAAI,OAAO,CAE7B;IAED,wHAAwH;IACxH,IAAW,eAAe,IAAI,MAAM,CAEnC;IAED,8CAA8C;IAC9C,IAAW,UAAU,IAAI,MAAM,CAE9B;IAED,gGAAgG;IAChG,IAAW,WAAW,IAAI,OAAO,GAAG,SAAS,CAS5C;IAED;;;;OAIG;IACI,wBAAwB,CAAC,KAAK,SAAI,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO;CAatE;AAED;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAC1B,qFAAqF;IAC9E,QAAQ,EAAE,UAAU,EAAE,CAAC;IAC9B,4FAA4F;IACrF,OAAO,EAAE,MAAM,EAAE,CAAC;gBAEN,QAAQ,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE;IAK5D,0BAA0B;IACnB,KAAK,IAAI,eAAe;IAK/B;;OAEG;IACI,aAAa,CAAC,KAAK,EAAE,eAAe,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO;IAWzE,sIAAsI;WACxH,aAAa,CAAC,IAAI,EAAE,eAAe,GAAG,SAAS,EAAE,KAAK,EAAE,eAAe,GAAG,SAAS,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO;IAQzH,kEAAkE;IAC3D,gBAAgB,IAAI,eAAe;IAc1C;;;;OAIG;IACI,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO;CAmC1D"}

package/lib/esm/polyface/AuxData.js

@@ -0,0 +1,228 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+import { Point3d } from "../geometry3d/Point3dVector3d";
+import { NumberArray } from "../geometry3d/PointHelpers";
+// import { Geometry } from "./Geometry";
+import { Range1d, Range3d } from "../geometry3d/Range";
+/** The types of data that can be represented by an [[AuxChannelData]]. Each type of data contributes differently to the
+ * animation applied by an [AnalysisStyle]($common) and responds differently when the host [[PolyfaceAuxData]] is transformed.
+ * @public
+ */
+export var AuxChannelDataType;
+(function (AuxChannelDataType) {
+    /** General-purpose scalar values like stress, temperature, etc., used to recolor the [[Polyface]]'s vertices.
+     * When the host Polyface is transformed, scalar values remain unmodified.
+     */
+    AuxChannelDataType[AuxChannelDataType["Scalar"] = 0] = "Scalar";
+    /** Distances in meters used to recolor the [[Polyface]]'s vertices.
+     * When the host [[Polyface]] is transformed the [[Transform]]'s scale is applied to the distances.
+     */
+    AuxChannelDataType[AuxChannelDataType["Distance"] = 1] = "Distance";
+    /** (X, Y, Z) displacement vectors added to the [[Polyface]]'s vertex positions resulting in deformation of the mesh.
+     * When the host Polyface is transformed the displacements are rotated and scaled accordingly.
+     */
+    AuxChannelDataType[AuxChannelDataType["Vector"] = 2] = "Vector";
+    /** (X, Y, Z) normal vectors that replace the host [[Polyface]]'s own normals.
+     * When the Polyface is transformed the normals are rotated accordingly.
+     */
+    AuxChannelDataType[AuxChannelDataType["Normal"] = 3] = "Normal";
+})(AuxChannelDataType || (AuxChannelDataType = {}));
+/**  Represents the [[AuxChannel]] data at a single input value.
+ * @public
+*/
+export class AuxChannelData {
+    /** Construct a new [[AuxChannelData]] from input value and vertex values. */
+    constructor(input, values) {
+        this.input = input;
+        if (values instanceof Float64Array) {
+            this.values = [];
+            for (const v of values)
+                this.values.push(v);
+        }
+        else
+            this.values = values;
+    }
+    /** Copy blocks of size `blockSize` from (blocked index) `thisIndex` in this AuxChannelData to (blockIndex) `otherIndex` of `other` */
+    copyValues(other, thisIndex, otherIndex, blockSize) {
+        for (let i = 0; i < blockSize; i++)
+            this.values[thisIndex * blockSize + i] = other.values[otherIndex * blockSize + i];
+    }
+    /** return a deep copy */
+    clone() {
+        return new AuxChannelData(this.input, this.values.slice());
+    }
+    /** toleranced comparison of the `input` and `value` fields.
+     * * Default tolerance is 1.0e-8
+     */
+    isAlmostEqual(other, tol) {
+        const tolerance = tol ? tol : 1.0E-8;
+        return Math.abs(this.input - other.input) < tolerance && NumberArray.isAlmostEqual(this.values, other.values, tolerance);
+    }
+}
+/**  Represents a single [[PolyfaceAuxData]] channel.
+ * @public
+*/
+export class AuxChannel {
+    /** Create a [[AuxChannel]] */
+    constructor(data, dataType, name, inputName) {
+        this.data = data;
+        this.dataType = dataType;
+        this.name = name;
+        this.inputName = inputName;
+    }
+    /** Return a deep copy. */
+    clone() {
+        const clonedData = [];
+        for (const data of this.data)
+            clonedData.push(data.clone());
+        return new AuxChannel(clonedData, this.dataType, this.name, this.inputName);
+    }
+    /** Toleranced comparison of contents. */
+    isAlmostEqual(other, tol) {
+        if (this.dataType !== other.dataType ||
+            this.name !== other.name ||
+            this.inputName !== other.inputName ||
+            this.data.length !== other.data.length)
+            return false;
+        for (let i = 0; i < this.data.length; i++)
+            if (!this.data[i].isAlmostEqual(other.data[i], tol))
+                return false;
+        return true;
+    }
+    /** True if [[entriesPerValue]] is `1`. */
+    get isScalar() {
+        return this.dataType === AuxChannelDataType.Distance || this.dataType === AuxChannelDataType.Scalar;
+    }
+    /** The number of values in `data.values` per entry - 1 for scalar and distance types, 3 for normal and vector types. */
+    get entriesPerValue() {
+        return this.isScalar ? 1 : 3;
+    }
+    /** The number of entries in `data.values`. */
+    get valueCount() {
+        return 0 === this.data.length ? 0 : this.data[0].values.length / this.entriesPerValue;
+    }
+    /** The minimum and maximum values in `data.values`, or `undefined` if [[isScalar]] is false. */
+    get scalarRange() {
+        if (!this.isScalar)
+            return undefined;
+        const range = Range1d.createNull();
+        for (const data of this.data)
+            range.extendArray(data.values);
+        return range;
+    }
+    /** Compute the range of this channel's displacement values, if [[dataType]] is [[AuxChannelDataType.Vector]].
+     * @param scale Scale by which to multiply each displacement.
+     * @param result Preallocated object in which to store result.
+     * @returns The range encompassing all this channel's displacements scaled by `scale`; or a null range if this channel does not contain displacements.
+     */
+    computeDisplacementRange(scale = 1, result) {
+        result = Range3d.createNull(result);
+        if (AuxChannelDataType.Vector === this.dataType) {
+            for (const data of this.data) {
+                const v = data.values;
+                for (let i = 0; i < v.length; i += 3)
+                    result.extendXYZ(v[i] * scale, v[i + 1] * scale, v[i + 2] * scale);
+            }
+        }
+        return result;
+    }
+}
+/**  The `PolyfaceAuxData` structure contains one or more analytical data channels for each vertex of a [[Polyface]], allowing the polyface to be styled
+ * using an [AnalysisStyle]($common).
+ * Typically a polyface will contain only vertex data required for its basic display: the vertex position, normal
+ * and possibly texture parameter. `PolyfaceAuxData` provides supplemental data that is generally computed
+ * in an analysis program or other external data source. This can be scalar data used to either override the vertex colors through, or
+ * XYZ data used to deform the mesh by adjusting the vertex positions and/or normals.
+ * @see [[PolyfaceData.auxData]] to associate auxiliary data with a polyface.
+ * @public
+ */
+export class PolyfaceAuxData {
+    constructor(channels, indices) {
+        this.channels = channels;
+        this.indices = indices;
+    }
+    /** Return a deep copy. */
+    clone() {
+        const clonedChannels = this.channels.map((x) => x.clone());
+        return new PolyfaceAuxData(clonedChannels, this.indices.slice());
+    }
+    /** Returns true if `this` is equivalent to `other` within `tolerance`.
+     * The indices are compared for exact equality. The data in the channels are compared using `tolerance`, which defaults to 1.0e-8.
+     */
+    isAlmostEqual(other, tolerance) {
+        if (!NumberArray.isExactEqual(this.indices, other.indices) || this.channels.length !== other.channels.length)
+            return false;
+        for (let i = 0; i < this.channels.length; i++)
+            if (!this.channels[i].isAlmostEqual(other.channels[i], tolerance))
+                return false;
+        return true;
+    }
+    /** Returns true if both `left` and `right` are undefined, or both are defined and equivalent within `tolerance` (default: 1.0e-8). */
+    static isAlmostEqual(left, right, tol) {
+        if (left === right) // This catches double undefined !!!
+            return true;
+        if (left && right)
+            return left.isAlmostEqual(right, tol);
+        return false;
+    }
+    /** Create a PolyfaceAuxData for use by a [[PolyfaceVisitor]].  */
+    createForVisitor() {
+        const visitorChannels = [];
+        for (const parentChannel of this.channels) {
+            const visitorChannelData = [];
+            for (const parentChannelData of parentChannel.data)
+                visitorChannelData.push(new AuxChannelData(parentChannelData.input, []));
+            visitorChannels.push(new AuxChannel(visitorChannelData, parentChannel.dataType, parentChannel.name, parentChannel.inputName));
+        }
+        return new PolyfaceAuxData(visitorChannels, []);
+    }
+    /** Apply `transform` to the data in each channel.
+     * @see [[AuxChannelDataType]] for details regarding how each data type is affected by the transform.
+     * @note This method may fail if a channel of [[AuxChannelDataType.Normal]] exists and `transform.matrix` is non-invertible.
+     * @returns true if the channels were all successfully transformed.
+     */
+    tryTransformInPlace(transform) {
+        let inverseRot;
+        const rot = transform.matrix;
+        const det = rot.determinant();
+        const scale = Math.pow(Math.abs(det), 1 / 3) * (det >= 0 ? 1 : -1);
+        for (const channel of this.channels) {
+            for (const data of channel.data) {
+                switch (channel.dataType) {
+                    case AuxChannelDataType.Scalar:
+                        continue;
+                    case AuxChannelDataType.Distance: {
+                        for (let i = 0; i < data.values.length; i++)
+                            data.values[i] *= scale;
+                        break;
+                    }
+                    case AuxChannelDataType.Normal: {
+                        inverseRot = inverseRot !== null && inverseRot !== void 0 ? inverseRot : rot.inverse();
+                        if (!inverseRot)
+                            return false;
+                        transformPoints(data.values, (point) => inverseRot.multiplyTransposeVectorInPlace(point));
+                        break;
+                    }
+                    case AuxChannelDataType.Vector: {
+                        transformPoints(data.values, (point) => rot.multiplyVectorInPlace(point));
+                        break;
+                    }
+                }
+            }
+        }
+        return true;
+    }
+}
+function transformPoints(coords, transform) {
+    const point = new Point3d();
+    for (let i = 0; i < coords.length; i += 3) {
+        point.set(coords[i], coords[i + 1], coords[i + 2]);
+        transform(point);
+        coords[i] = point.x;
+        coords[i + 1] = point.y;
+        coords[i + 2] = point.z;
+    }
+}
+//# sourceMappingURL=AuxData.js.map

package/lib/esm/polyface/AuxData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuxData.js","sourceRoot":"","sources":["../../../src/polyface/AuxData.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAU/F,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,yCAAyC;AACzC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEvD;;;GAGG;AACH,MAAM,CAAN,IAAY,kBAiBX;AAjBD,WAAY,kBAAkB;IAC5B;;OAEG;IACH,+DAAU,CAAA;IACV;;OAEG;IACH,mEAAY,CAAA;IACZ;;OAEG;IACH,+DAAU,CAAA;IACV;;OAEG;IACH,+DAAU,CAAA;AACZ,CAAC,EAjBW,kBAAkB,KAAlB,kBAAkB,QAiB7B;AAED;;EAEE;AACF,MAAM,OAAO,cAAc;IAMzB,6EAA6E;IAC7E,YAAY,KAAa,EAAE,MAA+B;QACxD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,MAAM,YAAY,YAAY,EAAE;YAClC,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;YACjB,KAAK,MAAM,CAAC,IAAI,MAAM;gBAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;SAC7C;;YACC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED,sIAAsI;IAC/H,UAAU,CAAC,KAAqB,EAAE,SAAiB,EAAE,UAAkB,EAAE,SAAiB;QAC/F,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE;YAChC,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,SAAS,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,UAAU,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC;IACtF,CAAC;IAED,yBAAyB;IAClB,KAAK;QACV,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACI,aAAa,CAAC,KAAqB,EAAE,GAAY;QACtD,MAAM,SAAS,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;QACrC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,SAAS,IAAI,WAAW,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC3H,CAAC;CACF;AAED;;EAEE;AACF,MAAM,OAAO,UAAU;IAUrB,8BAA8B;IAC9B,YAAmB,IAAsB,EAAE,QAA4B,EAAE,IAAa,EAAE,SAAkB;QACxG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,0BAA0B;IACnB,KAAK;QACV,MAAM,UAAU,GAAG,EAAE,CAAC;QACtB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,IAAI;YAAE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAC5D,OAAO,IAAI,UAAU,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC9E,CAAC;IAED,yCAAyC;IAClC,aAAa,CAAC,KAAiB,EAAE,GAAY;QAClD,IAAI,IAAI,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ;YAClC,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI;YACxB,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS;YAClC,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,IAAI,CAAC,MAAM;YACtC,OAAO,KAAK,CAAC;QAEf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE;YACvC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;gBACjD,OAAO,KAAK,CAAC;QAEjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,0CAA0C;IAC1C,IAAW,QAAQ;QACjB,OAAO,IAAI,CAAC,QAAQ,KAAK,kBAAkB,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,KAAK,kBAAkB,CAAC,MAAM,CAAC;IACtG,CAAC;IAED,wHAAwH;IACxH,IAAW,eAAe;QACxB,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC;IAED,8CAA8C;IAC9C,IAAW,UAAU;QACnB,OAAO,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC;IACxF,CAAC;IAED,gGAAgG;IAChG,IAAW,WAAW;QACpB,IAAI,CAAC,IAAI,CAAC,QAAQ;YAChB,OAAO,SAAS,CAAC;QAEnB,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;QACnC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,IAAI;YAC1B,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEjC,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;OAIG;IACI,wBAAwB,CAAC,KAAK,GAAG,CAAC,EAAE,MAAgB;QACzD,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAEpC,IAAI,kBAAkB,CAAC,MAAM,KAAK,IAAI,CAAC,QAAQ,EAAE;YAC/C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE;gBAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;gBACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC;oBAClC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;aACtE;SACF;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,eAAe;IAM1B,YAAmB,QAAsB,EAAE,OAAiB;QAC1D,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,0BAA0B;IACnB,KAAK;QACV,MAAM,cAAc,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAC3D,OAAO,IAAI,eAAe,CAAC,cAAc,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACnE,CAAC;IAED;;OAEG;IACI,aAAa,CAAC,KAAsB,EAAE,SAAkB;QAC7D,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,KAAK,CAAC,QAAQ,CAAC,MAAM;YAC1G,OAAO,KAAK,CAAC;QAEf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE;YAC3C,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC;gBAC/D,OAAO,KAAK,CAAC;QAEjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,sIAAsI;IAC/H,MAAM,CAAC,aAAa,CAAC,IAAiC,EAAE,KAAkC,EAAE,GAAY;QAC7G,IAAI,IAAI,KAAK,KAAK,EAAE,oCAAoC;YACtD,OAAO,IAAI,CAAC;QACd,IAAI,IAAI,IAAI,KAAK;YACf,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,kEAAkE;IAC3D,gBAAgB;QACrB,MAAM,eAAe,GAAiB,EAAE,CAAC;QAEzC,KAAK,MAAM,aAAa,IAAI,IAAI,CAAC,QAAQ,EAAE;YACzC,MAAM,kBAAkB,GAAqB,EAAE,CAAC;YAChD,KAAK,MAAM,iBAAiB,IAAI,aAAa,CAAC,IAAI;gBAChD,kBAAkB,CAAC,IAAI,CAAC,IAAI,cAAc,CAAC,iBAAiB,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;YAE3E,eAAe,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,kBAAkB,EAAE,aAAa,CAAC,QAAQ,EAAE,aAAa,CAAC,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC;SAC/H;QAED,OAAO,IAAI,eAAe,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IAClD,CAAC;IAED;;;;OAIG;IACI,mBAAmB,CAAC,SAAoB;QAC7C,IAAI,UAAgC,CAAC;QACrC,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC;QAC7B,MAAM,GAAG,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAEnE,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE;YACnC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE;gBAC/B,QAAQ,OAAO,CAAC,QAAQ,EAAE;oBACxB,KAAK,kBAAkB,CAAC,MAAM;wBAC5B,SAAS;oBACX,KAAK,kBAAkB,CAAC,QAAQ,CAAC,CAAC;wBAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE;4BACzC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC;wBAE1B,MAAM;qBACP;oBACD,KAAK,kBAAkB,CAAC,MAAM,CAAC,CAAC;wBAC9B,UAAU,GAAG,UAAU,aAAV,UAAU,cAAV,UAAU,GAAI,GAAG,CAAC,OAAO,EAAE,CAAC;wBACzC,IAAI,CAAC,UAAU;4BACX,OAAO,KAAK,CAAC;wBAEjB,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,UAAW,CAAC,8BAA8B,CAAC,KAAK,CAAC,CAAC,CAAC;wBAC3F,MAAM;qBACP;oBACD,KAAK,kBAAkB,CAAC,MAAM,CAAC,CAAC;wBAC9B,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC;wBAC1E,MAAM;qBACP;iBACF;aACF;SACF;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,SAAS,eAAe,CAAC,MAAgB,EAAE,SAAmC;IAC5E,MAAM,KAAK,GAAG,IAAI,OAAO,EAAE,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE;QACzC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACnD,SAAS,CAAC,KAAK,CAAC,CAAC;QACjB,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;QACpB,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;QACxB,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;KACzB;AACH,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n\r\n/** @packageDocumentation\r\n * @module Polyface\r\n */\r\n\r\n// import { Point2d } from \"./Geometry2d\";\r\n/* eslint-disable @typescript-eslint/naming-convention, no-empty */\r\nimport { Transform } from \"../geometry3d/Transform\";\r\nimport { Matrix3d } from \"../geometry3d/Matrix3d\";\r\nimport { Point3d } from \"../geometry3d/Point3dVector3d\";\r\nimport { NumberArray } from \"../geometry3d/PointHelpers\";\r\n// import { Geometry } from \"./Geometry\";\r\nimport { Range1d, Range3d } from \"../geometry3d/Range\";\r\n\r\n/** The types of data that can be represented by an [[AuxChannelData]]. Each type of data contributes differently to the\r\n * animation applied by an [AnalysisStyle]($common) and responds differently when the host [[PolyfaceAuxData]] is transformed.\r\n * @public\r\n */\r\nexport enum AuxChannelDataType {\r\n  /** General-purpose scalar values like stress, temperature, etc., used to recolor the [[Polyface]]'s vertices.\r\n   * When the host Polyface is transformed, scalar values remain unmodified.\r\n   */\r\n  Scalar = 0,\r\n  /** Distances in meters used to recolor the [[Polyface]]'s vertices.\r\n   * When the host [[Polyface]] is transformed the [[Transform]]'s scale is applied to the distances.\r\n   */\r\n  Distance = 1,\r\n  /** (X, Y, Z) displacement vectors added to the [[Polyface]]'s vertex positions resulting in deformation of the mesh.\r\n   * When the host Polyface is transformed the displacements are rotated and scaled accordingly.\r\n   */\r\n  Vector = 2,\r\n  /** (X, Y, Z) normal vectors that replace the host [[Polyface]]'s own normals.\r\n   * When the Polyface is transformed the normals are rotated accordingly.\r\n   */\r\n  Normal = 3,\r\n}\r\n\r\n/**  Represents the [[AuxChannel]] data at a single input value.\r\n * @public\r\n*/\r\nexport class AuxChannelData {\r\n  /** The input value for this data. */\r\n  public input: number;\r\n  /** The vertex values for this data. A single value per vertex for scalar and distance types and 3 values (x,y,z) for normal or vector channels. */\r\n  public values: number[];\r\n\r\n  /** Construct a new [[AuxChannelData]] from input value and vertex values. */\r\n  constructor(input: number, values: number[] | Float64Array) {\r\n    this.input = input;\r\n    if (values instanceof Float64Array) {\r\n      this.values = [];\r\n      for (const v of values) this.values.push(v);\r\n    } else\r\n      this.values = values;\r\n  }\r\n\r\n  /** Copy blocks of size `blockSize` from (blocked index) `thisIndex` in this AuxChannelData to (blockIndex) `otherIndex` of `other` */\r\n  public copyValues(other: AuxChannelData, thisIndex: number, otherIndex: number, blockSize: number): void {\r\n    for (let i = 0; i < blockSize; i++)\r\n      this.values[thisIndex * blockSize + i] = other.values[otherIndex * blockSize + i];\r\n  }\r\n\r\n  /** return a deep copy */\r\n  public clone(): AuxChannelData {\r\n    return new AuxChannelData(this.input, this.values.slice());\r\n  }\r\n\r\n  /** toleranced comparison of the `input` and `value` fields.\r\n   * * Default tolerance is 1.0e-8\r\n   */\r\n  public isAlmostEqual(other: AuxChannelData, tol?: number): boolean {\r\n    const tolerance = tol ? tol : 1.0E-8;\r\n    return Math.abs(this.input - other.input) < tolerance && NumberArray.isAlmostEqual(this.values, other.values, tolerance);\r\n  }\r\n}\r\n\r\n/**  Represents a single [[PolyfaceAuxData]] channel.\r\n * @public\r\n*/\r\nexport class AuxChannel {\r\n  /** An array of [[AuxChannelData]] that represents the vertex data at one or more input values. */\r\n  public data: AuxChannelData[];\r\n  /** The type of data stored in this channel. */\r\n  public dataType: AuxChannelDataType;\r\n  /** The channel name. This is used to present the [[AuxChannel]] to the user and also to select the [[AuxChannel]] for display from AnalysisStyle */\r\n  public name?: string;\r\n  /** The input name. */\r\n  public inputName?: string;\r\n\r\n  /** Create a [[AuxChannel]] */\r\n  public constructor(data: AuxChannelData[], dataType: AuxChannelDataType, name?: string, inputName?: string) {\r\n    this.data = data;\r\n    this.dataType = dataType;\r\n    this.name = name;\r\n    this.inputName = inputName;\r\n  }\r\n\r\n  /** Return a deep copy. */\r\n  public clone(): AuxChannel {\r\n    const clonedData = [];\r\n    for (const data of this.data) clonedData.push(data.clone());\r\n    return new AuxChannel(clonedData, this.dataType, this.name, this.inputName);\r\n  }\r\n\r\n  /** Toleranced comparison of contents. */\r\n  public isAlmostEqual(other: AuxChannel, tol?: number): boolean {\r\n    if (this.dataType !== other.dataType ||\r\n      this.name !== other.name ||\r\n      this.inputName !== other.inputName ||\r\n      this.data.length !== other.data.length)\r\n      return false;\r\n\r\n    for (let i = 0; i < this.data.length; i++)\r\n      if (!this.data[i].isAlmostEqual(other.data[i], tol))\r\n        return false;\r\n\r\n    return true;\r\n  }\r\n\r\n  /** True if [[entriesPerValue]] is `1`. */\r\n  public get isScalar(): boolean {\r\n    return this.dataType === AuxChannelDataType.Distance || this.dataType === AuxChannelDataType.Scalar;\r\n  }\r\n\r\n  /** The number of values in `data.values` per entry - 1 for scalar and distance types, 3 for normal and vector types. */\r\n  public get entriesPerValue(): number {\r\n    return this.isScalar ? 1 : 3;\r\n  }\r\n\r\n  /** The number of entries in `data.values`. */\r\n  public get valueCount(): number {\r\n    return 0 === this.data.length ? 0 : this.data[0].values.length / this.entriesPerValue;\r\n  }\r\n\r\n  /** The minimum and maximum values in `data.values`, or `undefined` if [[isScalar]] is false. */\r\n  public get scalarRange(): Range1d | undefined {\r\n    if (!this.isScalar)\r\n      return undefined;\r\n\r\n    const range = Range1d.createNull();\r\n    for (const data of this.data)\r\n      range.extendArray(data.values);\r\n\r\n    return range;\r\n  }\r\n\r\n  /** Compute the range of this channel's displacement values, if [[dataType]] is [[AuxChannelDataType.Vector]].\r\n   * @param scale Scale by which to multiply each displacement.\r\n   * @param result Preallocated object in which to store result.\r\n   * @returns The range encompassing all this channel's displacements scaled by `scale`; or a null range if this channel does not contain displacements.\r\n   */\r\n  public computeDisplacementRange(scale = 1, result?: Range3d): Range3d {\r\n    result = Range3d.createNull(result);\r\n\r\n    if (AuxChannelDataType.Vector === this.dataType) {\r\n      for (const data of this.data) {\r\n        const v = data.values;\r\n        for (let i = 0; i < v.length; i += 3)\r\n          result.extendXYZ(v[i] * scale, v[i + 1] * scale, v[i + 2] * scale);\r\n      }\r\n    }\r\n\r\n    return result;\r\n  }\r\n}\r\n\r\n/**  The `PolyfaceAuxData` structure contains one or more analytical data channels for each vertex of a [[Polyface]], allowing the polyface to be styled\r\n * using an [AnalysisStyle]($common).\r\n * Typically a polyface will contain only vertex data required for its basic display: the vertex position, normal\r\n * and possibly texture parameter. `PolyfaceAuxData` provides supplemental data that is generally computed\r\n * in an analysis program or other external data source. This can be scalar data used to either override the vertex colors through, or\r\n * XYZ data used to deform the mesh by adjusting the vertex positions and/or normals.\r\n * @see [[PolyfaceData.auxData]] to associate auxiliary data with a polyface.\r\n * @public\r\n */\r\nexport class PolyfaceAuxData {\r\n  /** Array with one or more channels of auxiliary data for the associated polyface. */\r\n  public channels: AuxChannel[];\r\n  /** The indices (shared by all data in all channels) mapping the data to the mesh facets. */\r\n  public indices: number[];\r\n\r\n  public constructor(channels: AuxChannel[], indices: number[]) {\r\n    this.channels = channels;\r\n    this.indices = indices;\r\n  }\r\n\r\n  /** Return a deep copy. */\r\n  public clone(): PolyfaceAuxData {\r\n    const clonedChannels = this.channels.map((x) => x.clone());\r\n    return new PolyfaceAuxData(clonedChannels, this.indices.slice());\r\n  }\r\n\r\n  /** Returns true if `this` is equivalent to `other` within `tolerance`.\r\n   * The indices are compared for exact equality. The data in the channels are compared using `tolerance`, which defaults to 1.0e-8.\r\n   */\r\n  public isAlmostEqual(other: PolyfaceAuxData, tolerance?: number): boolean {\r\n    if (!NumberArray.isExactEqual(this.indices, other.indices) || this.channels.length !== other.channels.length)\r\n      return false;\r\n\r\n    for (let i = 0; i < this.channels.length; i++)\r\n      if (!this.channels[i].isAlmostEqual(other.channels[i], tolerance))\r\n        return false;\r\n\r\n    return true;\r\n  }\r\n\r\n  /** Returns true if both `left` and `right` are undefined, or both are defined and equivalent within `tolerance` (default: 1.0e-8). */\r\n  public static isAlmostEqual(left: PolyfaceAuxData | undefined, right: PolyfaceAuxData | undefined, tol?: number): boolean {\r\n    if (left === right) // This catches double undefined !!!\r\n      return true;\r\n    if (left && right)\r\n      return left.isAlmostEqual(right, tol);\r\n    return false;\r\n  }\r\n\r\n  /** Create a PolyfaceAuxData for use by a [[PolyfaceVisitor]].  */\r\n  public createForVisitor(): PolyfaceAuxData {\r\n    const visitorChannels: AuxChannel[] = [];\r\n\r\n    for (const parentChannel of this.channels) {\r\n      const visitorChannelData: AuxChannelData[] = [];\r\n      for (const parentChannelData of parentChannel.data)\r\n        visitorChannelData.push(new AuxChannelData(parentChannelData.input, []));\r\n\r\n      visitorChannels.push(new AuxChannel(visitorChannelData, parentChannel.dataType, parentChannel.name, parentChannel.inputName));\r\n    }\r\n\r\n    return new PolyfaceAuxData(visitorChannels, []);\r\n  }\r\n\r\n  /** Apply `transform` to the data in each channel.\r\n   * @see [[AuxChannelDataType]] for details regarding how each data type is affected by the transform.\r\n   * @note This method may fail if a channel of [[AuxChannelDataType.Normal]] exists and `transform.matrix` is non-invertible.\r\n   * @returns true if the channels were all successfully transformed.\r\n   */\r\n  public tryTransformInPlace(transform: Transform): boolean {\r\n    let inverseRot: Matrix3d | undefined;\r\n    const rot = transform.matrix;\r\n    const det = rot.determinant();\r\n    const scale = Math.pow(Math.abs(det), 1 / 3) * (det >= 0 ? 1 : -1);\r\n\r\n    for (const channel of this.channels) {\r\n      for (const data of channel.data) {\r\n        switch (channel.dataType) {\r\n          case AuxChannelDataType.Scalar:\r\n            continue;\r\n          case AuxChannelDataType.Distance: {\r\n            for (let i = 0; i < data.values.length; i++)\r\n              data.values[i] *= scale;\r\n\r\n            break;\r\n          }\r\n          case AuxChannelDataType.Normal: {\r\n            inverseRot = inverseRot ?? rot.inverse();\r\n            if (!inverseRot)\r\n                return false;\r\n\r\n            transformPoints(data.values, (point) => inverseRot!.multiplyTransposeVectorInPlace(point));\r\n            break;\r\n          }\r\n          case AuxChannelDataType.Vector: {\r\n            transformPoints(data.values, (point) => rot.multiplyVectorInPlace(point));\r\n            break;\r\n          }\r\n        }\r\n      }\r\n    }\r\n\r\n    return true;\r\n  }\r\n}\r\n\r\nfunction transformPoints(coords: number[], transform: (point: Point3d) => void): void {\r\n  const point = new Point3d();\r\n  for (let i = 0; i < coords.length; i += 3) {\r\n    point.set(coords[i], coords[i + 1], coords[i + 2]);\r\n    transform(point);\r\n    coords[i] = point.x;\r\n    coords[i + 1] = point.y;\r\n    coords[i + 2] = point.z;\r\n  }\r\n}\r\n"]}

package/lib/esm/polyface/BoxTopology.d.ts

@@ -0,0 +1,38 @@
+/** @packageDocumentation
+ * @module Polyface
+ */
+import { Point3d } from "../geometry3d/Point3dVector3d";
+/**
+ * methods for gathering points and indices of a box (8 corners, 6 faces, 12 edges)
+ * @internal
+ */
+export declare class BoxTopology {
+    /**
+     * static readonly array with the coordinates of the 8 unit cube corners in standard order, which is:
+     * x varies fastest
+     * * The point indices for the x edges are (0 to 1), (2 to 3), (4 to 5), (6 to 7)
+     * * The point indices for the y edges are (0 to 2), (1 to 3), (4 to 6), (5 to 7)
+     * * The point indices for the z edges are (0 to 4), (1 to 5), (2 to 6), (3 to 7)
+     * * These indices are tabulated in the `axisEdgeVertex[axis][edge][vertex]` array
+     */
+    static readonly points: Point3d[];
+    static pointsClone(): Point3d[];
+    /** IN faceId pair, the first component for bottom and top caps is `primaryCapId` */
+    static readonly primaryCapId = -1;
+    /** Indices of vertices around faces, in CCW from the outside. */
+    static readonly cornerIndexCCW: number[][];
+    /**  // [partnerFace[faceIndex][k] = index of k'th adjacent face  */
+    static readonly partnerFace: number[][];
+    /** face id as used in SolidPrimitive methods */
+    static readonly faceId: number[][];
+    /**
+     * Table to look up axis indices of edges and normals in box faces.
+     * faceDirections[faceIndex] =[[edge0AxisIndex, edge1AxisIndex, normalAxisIndex],[direction sign for along the axis]
+     */
+    static readonly faceDirections: number[][][];
+    /** There are 4 edges in each axis direction.
+     *  * axisEdgeVertex[axisIndex][edgeIndex 0..3][*] = vertex index at end of edge in axisIndex direction.
+     */
+    static readonly axisEdgeVertex: number[][][];
+}
+//# sourceMappingURL=BoxTopology.d.ts.map

package/lib/esm/polyface/BoxTopology.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoxTopology.d.ts","sourceRoot":"","sources":["../../../src/polyface/BoxTopology.ts"],"names":[],"mappings":"AAKA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAaxD;;;GAGG;AACH,qBAAa,WAAW;IACtB;;;;;;;OAOG;IACH,gBAAuB,MAAM,YAS3B;WACY,WAAW,IAAI,OAAO,EAAE;IAMtC,oFAAoF;IACpF,gBAAuB,YAAY,MAAM;IACzC,iEAAiE;IACjE,gBAAuB,cAAc,aAOrB;IAChB,oEAAoE;IACpE,gBAAuB,WAAW,aAQhC;IACF,gDAAgD;IAChD,gBAAuB,MAAM,aAMnB;IACV;;;OAGG;IACH,gBAAuB,cAAc,eAOT;IAC5B;;OAEG;IACH,gBAAuB,cAAc,eAID;CACrC"}