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

package/lib/esm/curve/spiral/MXCubicAlongArcSpiralEvaluator.d.ts

@@ -0,0 +1,38 @@
+import { CubicEvaluator } from "./CubicEvaluator";
+/**
+ * MX Cubic along arc.
+ * This is y= m*x^3 with
+ * * x any point on the x axis
+ * * `fraction` along the spiral goes to `x = fraction * Lx`
+ * * m is (1/6RL)
+ * * construction length L is nominal along the curve.
+ * * x length Lx is along the axis, determined by two terms of the clothoid x series.
+ * *
+ * @param localToWorld
+ * @param nominalL1
+ * @param nominalR1
+ * @param activeInterval
+ * @internal
+ */
+export declare class MXCubicAlongArcEvaluator extends CubicEvaluator {
+    nominalLength1: number;
+    nominalRadius1: number;
+    /** Constructor is private.  Caller responsible for cubicM validity. */
+    private constructor();
+    /** Compute the cubic constant. */
+    static computeCubicM(length1: number, radius1: number): number | undefined;
+    static create(length1: number, radius1: number): MXCubicAlongArcEvaluator | undefined;
+    scaleInPlace(scaleFactor: number): void;
+    /** return a deep copy of the evaluator */
+    clone(): MXCubicAlongArcEvaluator;
+    /** Member by member matchup ... */
+    isAlmostEqual(other: any): boolean;
+    /**
+     * Return a (fast but mediocre) approximation of spiral x position as function of approximate distance along the curve.
+     * * This x-to-distance relation is not as precise as the CurvePrimitive method moveSignedDistanceFromFraction.
+     * * It is supported here for users interested in replicating the Czech distance mapping rather than the more accurate CurvePrimitive measurements.
+     * @param x distance along the x axis.
+     */
+    static approximateDistanceAlongToX(nominalLength1: number, nominalRadius1: number, nominalDistanceAlong: number): number;
+}
+//# sourceMappingURL=MXCubicAlongArcSpiralEvaluator.d.ts.map

package/lib/esm/curve/spiral/MXCubicAlongArcSpiralEvaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MXCubicAlongArcSpiralEvaluator.d.ts","sourceRoot":"","sources":["../../../../src/curve/spiral/MXCubicAlongArcSpiralEvaluator.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,wBAAyB,SAAQ,cAAc;IACnD,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IAE9B,uEAAuE;IACvE,OAAO;IAMP,kCAAkC;WACpB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;WAKnE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,wBAAwB,GAAG,SAAS;IAQ5E,YAAY,CAAC,WAAW,EAAE,MAAM;IAKhD,0CAA0C;IACnC,KAAK,IAAI,wBAAwB;IACxC,mCAAmC;IAC5B,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO;IAOzC;;;;;OAKG;WACW,2BAA2B,CAAC,cAAc,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,GAAG,MAAM;CAMhI"}

package/lib/esm/curve/spiral/MXCubicAlongArcSpiralEvaluator.js

@@ -0,0 +1,72 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Curve
+ */
+import { Geometry } from "../../Geometry";
+import { CubicEvaluator } from "./CubicEvaluator";
+/**
+ * MX Cubic along arc.
+ * This is y= m*x^3 with
+ * * x any point on the x axis
+ * * `fraction` along the spiral goes to `x = fraction * Lx`
+ * * m is (1/6RL)
+ * * construction length L is nominal along the curve.
+ * * x length Lx is along the axis, determined by two terms of the clothoid x series.
+ * *
+ * @param localToWorld
+ * @param nominalL1
+ * @param nominalR1
+ * @param activeInterval
+ * @internal
+ */
+export class MXCubicAlongArcEvaluator extends CubicEvaluator {
+    /** Constructor is private.  Caller responsible for cubicM validity. */
+    constructor(length1, radius1, axisLength, cubicM) {
+        super(axisLength, cubicM);
+        this.nominalLength1 = length1;
+        this.nominalRadius1 = radius1;
+    }
+    /** Compute the cubic constant. */
+    static computeCubicM(length1, radius1) {
+        const axisLength = MXCubicAlongArcEvaluator.approximateDistanceAlongToX(length1, radius1, length1);
+        return 1.0 / (6.0 * radius1 * axisLength);
+    }
+    static create(length1, radius1) {
+        const m = this.computeCubicM(length1, radius1);
+        if (m === undefined)
+            return undefined;
+        const xMax = MXCubicAlongArcEvaluator.approximateDistanceAlongToX(length1, radius1, length1);
+        return new MXCubicAlongArcEvaluator(length1, radius1, xMax, m);
+    }
+    scaleInPlace(scaleFactor) {
+        this.nominalLength1 *= scaleFactor;
+        this.nominalRadius1 *= scaleFactor;
+        super.scaleInPlace(scaleFactor);
+    }
+    /** return a deep copy of the evaluator */
+    clone() { return new MXCubicAlongArcEvaluator(this.nominalLength1, this.nominalRadius1, super._axisLength, this.cubicM); }
+    /** Member by member matchup ... */
+    isAlmostEqual(other) {
+        if (other instanceof MXCubicAlongArcEvaluator) {
+            return Geometry.isSameCoordinate(this.nominalLength1, other.nominalLength1)
+                && Geometry.isSameCoordinate(this.nominalRadius1, other.nominalRadius1);
+        }
+        return false;
+    }
+    /**
+     * Return a (fast but mediocre) approximation of spiral x position as function of approximate distance along the curve.
+     * * This x-to-distance relation is not as precise as the CurvePrimitive method moveSignedDistanceFromFraction.
+     * * It is supported here for users interested in replicating the Czech distance mapping rather than the more accurate CurvePrimitive measurements.
+     * @param x distance along the x axis.
+     */
+    static approximateDistanceAlongToX(nominalLength1, nominalRadius1, nominalDistanceAlong) {
+        const l2 = nominalLength1 * nominalLength1;
+        const r2 = nominalRadius1 * nominalRadius1;
+        const xx = nominalDistanceAlong * nominalDistanceAlong;
+        return nominalDistanceAlong * (1.0 - xx * xx / (40.0 * r2 * l2));
+    }
+}
+//# sourceMappingURL=MXCubicAlongArcSpiralEvaluator.js.map

package/lib/esm/curve/spiral/MXCubicAlongArcSpiralEvaluator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MXCubicAlongArcSpiralEvaluator.js","sourceRoot":"","sources":["../../../../src/curve/spiral/MXCubicAlongArcSpiralEvaluator.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAE/F;;GAEG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,wBAAyB,SAAQ,cAAc;IAI1D,uEAAuE;IACvE,YAAoB,OAAe,EAAE,OAAe,EAAE,UAAkB,EAAE,MAAc;QACtF,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC1B,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC;QAC9B,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC;IAChC,CAAC;IAED,kCAAkC;IAC3B,MAAM,CAAC,aAAa,CAAC,OAAe,EAAE,OAAe;QAC1D,MAAM,UAAU,GAAG,wBAAwB,CAAC,2BAA2B,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACnG,OAAO,GAAG,GAAG,CAAC,GAAG,GAAG,OAAO,GAAG,UAAU,CAAC,CAAC;IAC5C,CAAC;IAEM,MAAM,CAAC,MAAM,CAAC,OAAe,EAAE,OAAe;QACnD,MAAM,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK,SAAS;YACjB,OAAO,SAAS,CAAC;QACnB,MAAM,IAAI,GAAG,wBAAwB,CAAC,2BAA2B,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC7F,OAAO,IAAI,wBAAwB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACjE,CAAC;IAEe,YAAY,CAAC,WAAmB;QAC9C,IAAI,CAAC,cAAc,IAAI,WAAW,CAAC;QACnC,IAAI,CAAC,cAAc,IAAI,WAAW,CAAC;QACnC,KAAK,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;IAClC,CAAC;IACD,0CAA0C;IACnC,KAAK,KAA+B,OAAO,IAAI,wBAAwB,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC3J,mCAAmC;IAC5B,aAAa,CAAC,KAAU;QAC7B,IAAI,KAAK,YAAY,wBAAwB,EAAE;YAC7C,OAAO,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,cAAc,CAAC;mBACtE,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;SAC3E;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD;;;;;OAKG;IACI,MAAM,CAAC,2BAA2B,CAAC,cAAsB,EAAE,cAAsB,EAAE,oBAA4B;QACpH,MAAM,EAAE,GAAG,cAAc,GAAG,cAAc,CAAC;QAC3C,MAAM,EAAE,GAAG,cAAc,GAAG,cAAc,CAAC;QAC3C,MAAM,EAAE,GAAG,oBAAoB,GAAG,oBAAoB,CAAC;QACvD,OAAO,oBAAoB,GAAG,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IACnE,CAAC;CACF","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 Curve\r\n */\r\nimport { Geometry } from \"../../Geometry\";\r\nimport { CubicEvaluator } from \"./CubicEvaluator\";\r\n/**\r\n * MX Cubic along arc.\r\n * This is y= m*x^3 with\r\n * * x any point on the x axis\r\n * * `fraction` along the spiral goes to `x = fraction * Lx`\r\n * * m is (1/6RL)\r\n * * construction length L is nominal along the curve.\r\n * * x length Lx is along the axis, determined by two terms of the clothoid x series.\r\n * *\r\n * @param localToWorld\r\n * @param nominalL1\r\n * @param nominalR1\r\n * @param activeInterval\r\n * @internal\r\n */\r\nexport class MXCubicAlongArcEvaluator extends CubicEvaluator {\r\n  public nominalLength1: number;\r\n  public nominalRadius1: number;\r\n\r\n  /** Constructor is private.  Caller responsible for cubicM validity. */\r\n  private constructor(length1: number, radius1: number, axisLength: number, cubicM: number) {\r\n    super(axisLength, cubicM);\r\n    this.nominalLength1 = length1;\r\n    this.nominalRadius1 = radius1;\r\n  }\r\n\r\n  /** Compute the cubic constant. */\r\n  public static computeCubicM(length1: number, radius1: number): number | undefined {\r\n    const axisLength = MXCubicAlongArcEvaluator.approximateDistanceAlongToX(length1, radius1, length1);\r\n    return 1.0 / (6.0 * radius1 * axisLength);\r\n  }\r\n\r\n  public static create(length1: number, radius1: number): MXCubicAlongArcEvaluator | undefined {\r\n    const m = this.computeCubicM(length1, radius1);\r\n    if (m === undefined)\r\n      return undefined;\r\n    const xMax = MXCubicAlongArcEvaluator.approximateDistanceAlongToX(length1, radius1, length1);\r\n    return new MXCubicAlongArcEvaluator(length1, radius1, xMax, m);\r\n  }\r\n\r\n  public override scaleInPlace(scaleFactor: number) {\r\n    this.nominalLength1 *= scaleFactor;\r\n    this.nominalRadius1 *= scaleFactor;\r\n    super.scaleInPlace(scaleFactor);\r\n  }\r\n  /** return a deep copy of the evaluator */\r\n  public clone(): MXCubicAlongArcEvaluator { return new MXCubicAlongArcEvaluator(this.nominalLength1, this.nominalRadius1, super._axisLength, this.cubicM); }\r\n  /** Member by member matchup ... */\r\n  public isAlmostEqual(other: any): boolean {\r\n    if (other instanceof MXCubicAlongArcEvaluator) {\r\n      return Geometry.isSameCoordinate(this.nominalLength1, other.nominalLength1)\r\n        && Geometry.isSameCoordinate(this.nominalRadius1, other.nominalRadius1);\r\n    }\r\n    return false;\r\n  }\r\n  /**\r\n   * Return a (fast but mediocre) approximation of spiral x position as function of approximate distance along the curve.\r\n   * * This x-to-distance relation is not as precise as the CurvePrimitive method moveSignedDistanceFromFraction.\r\n   * * It is supported here for users interested in replicating the Czech distance mapping rather than the more accurate CurvePrimitive measurements.\r\n   * @param x distance along the x axis.\r\n   */\r\n  public static approximateDistanceAlongToX(nominalLength1: number, nominalRadius1: number, nominalDistanceAlong: number): number {\r\n    const l2 = nominalLength1 * nominalLength1;\r\n    const r2 = nominalRadius1 * nominalRadius1;\r\n    const xx = nominalDistanceAlong * nominalDistanceAlong;\r\n    return nominalDistanceAlong * (1.0 - xx * xx / (40.0 * r2 * l2));\r\n  }\r\n}\r\n"]}

package/lib/esm/curve/spiral/NormalizedTransition.d.ts

@@ -0,0 +1,140 @@
+/** @packageDocumentation
+ * @module Curve
+ */
+/**
+ * NormalizedTransition is the (abstract) base class for clothoid, bloss, biquadratic, sine, and cosine transition functions.
+ * * Each function maps fractional progress to a curvature value.
+ *   * f(0) === 0
+ *   * f(1) === 1
+ *   * f(u) === 1 - f (1-u)
+ * * Each implementation provides:
+ *   * fractionToCurvature -- the f(u) function described above
+ *   * fractionToCurvatureDerivative -- df(u)/du
+ *   * fractionToArea -- integral of the area under f(u) from 0 to u.
+ * * the symmetry condition ensures that the integral from 0 to 1 is 1/2
+ * @internal
+ */
+export declare abstract class NormalizedTransition {
+    /** Constructor initializes with 0..1 values .. call "setBearingCurvatureLengthCurvature" to apply real values */
+    constructor();
+    /** At fractional position on the x axis, return the (normalized) curvature fraction. */
+    abstract fractionToCurvatureFraction(fractionX: number): number;
+    /** Return the derivative of the (normalized) curvature fraction */
+    abstract fractionToCurvatureFractionDerivative(fractionX: number): number;
+    /** Return the integrated area under the curve
+     * * This is equal to the accumulated angle change.
+     */
+    abstract fractionToArea(fractionX: number): number;
+    private static _clothoidEvaluator?;
+    private static _biquadraticEvaluator?;
+    private static _blossEvaluator?;
+    private static _sineEvaluator?;
+    private static _cosineEvaluator?;
+    /**
+     * Return a standard evaluator identified by string as:
+     * * clothoid
+     * * bloss
+     * * biquadratic
+     * * sine
+     * * cosine
+     * Each of these types
+     * * is instantiated (only once) as a single static object within the NormalizedTransition class.
+     * * has no instance data or mutator methods.
+     * @param name string name of the transition.
+     */
+    static findEvaluator(name: string): NormalizedTransition | undefined;
+}
+/**
+ * Transition functions for clothoid spiral.
+ * * curvature variation is linear from (0,0) to (1,1)
+ * @internal
+ */
+export declare class NormalizedClothoidTransition extends NormalizedTransition {
+    constructor();
+    /** At fractional position on the x axis, return the (normalized) curvature fraction. */
+    fractionToCurvatureFraction(fractionX: number): number;
+    /** Return the derivative of the (normalized) curvature fraction */
+    fractionToCurvatureFractionDerivative(_u: number): number;
+    /** Return the integrated area under the curve.
+     * * This fraction is the angular change fraction.
+     */
+    fractionToArea(fractionX: number): number;
+}
+/**
+ * Transition functions for bloss spiral.
+ * * curvature variation is cubic from (0,0) with slope 0 to (1,1) with slope 1
+ * @internal
+ */
+export declare class NormalizedBlossTransition extends NormalizedTransition {
+    constructor();
+    /** At fractional position on the x axis, return the (normalized) curvature fraction. */
+    fractionToCurvatureFraction(u: number): number;
+    /** Return the derivative of the (normalized) curvature fraction */
+    fractionToCurvatureFractionDerivative(u: number): number;
+    /** Return the integrated area under the curve.
+     * * This fraction is the angular change fraction.
+     */
+    fractionToArea(u: number): number;
+}
+/**
+/**
+ * Transition functions for biquadratic transition
+ * * Curvature is a pair of joining quadratics.
+ * * In lower half of the interval, the quadratic is from (0,0) to (0.5, 0.5) with zero slope at origin
+ * * In upper half of the interval, the quadratic is from (0.5,0.5) to (1,1) with zero slope at 1
+ * @internal
+ */
+export declare class NormalizedBiQuadraticTransition extends NormalizedTransition {
+    constructor();
+    private integratedBasis;
+    private basis;
+    private basisDerivative;
+    /** At fractional position on the x axis, return the (normalized) curvature fraction.
+     *  * * For [u <= 0.5, u >= 0.5]
+     *   * f(u) = [2 u^2, 1 - 2 (1-u)^2]
+     *   * f'(u) = [4 u, 4 (1-u)]
+     *   * If(u) = [2 u^3 / 3, 0.5 (1 -u )^3/3]
+     */
+    fractionToCurvatureFraction(u: number): number;
+    /** Return the derivative of the (normalized) curvature fraction */
+    fractionToCurvatureFractionDerivative(u: number): number;
+    /** Return the integrated area under the curve.
+     * * This fraction is the angular change fraction.
+     */
+    fractionToArea(u: number): number;
+}
+/**
+ * Transition functions for sine transition
+ * * curvature variation is the sum of
+ *   * straight line from (0,0) to (1,1), like clothoid
+ *   * additional full period of a sine wave, producing 0 slope at both ends
+ * @internal
+ */
+export declare class NormalizedSineTransition extends NormalizedTransition {
+    constructor();
+    /** At fractional position on the x axis, return the (normalized) curvature fraction. */
+    fractionToCurvatureFraction(u: number): number;
+    /** Return the derivative of the (normalized) curvature fraction */
+    fractionToCurvatureFractionDerivative(u: number): number;
+    /** Return the integrated area under the curve.
+     * * This fraction is the angular change fraction.
+     */
+    fractionToArea(u: number): number;
+}
+/**
+ * Transition functions for cosine
+ * * curvature variation is a half period of a cosine
+ * @internal
+ */
+export declare class NormalizedCosineTransition extends NormalizedTransition {
+    constructor();
+    /** At fractional position on the x axis, return the (normalized) curvature fraction. */
+    fractionToCurvatureFraction(u: number): number;
+    /** Return the derivative of the (normalized) curvature fraction */
+    fractionToCurvatureFractionDerivative(u: number): number;
+    /** Return the integrated area under the curve.
+     * * This fraction is the angular change fraction.
+     */
+    fractionToArea(u: number): number;
+}
+//# sourceMappingURL=NormalizedTransition.d.ts.map

package/lib/esm/curve/spiral/NormalizedTransition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NormalizedTransition.d.ts","sourceRoot":"","sources":["../../../../src/curve/spiral/NormalizedTransition.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH;;;;;;;;;;;;GAYG;AACH,8BAAsB,oBAAoB;IACxC,iHAAiH;;IAEjH,wFAAwF;aACxE,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IACtE,mEAAmE;aACnD,qCAAqC,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAChF;;OAEG;aACa,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IACzD,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAA+B;IACjE,OAAO,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAkC;IACvE,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,CAA4B;IAC3D,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAA2B;IACzD,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAA6B;IAE7D;;;;;;;;;;;OAWG;WACW,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;CAa5E;AACD;;;;GAIG;AACH,qBAAa,4BAA6B,SAAQ,oBAAoB;;IAEpE,wFAAwF;IACjF,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAC7D,mEAAmE;IAC5D,qCAAqC,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAChE;;OAEG;IACI,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;CAGjD;AAED;;;;GAIG;AACH,qBAAa,yBAA0B,SAAQ,oBAAoB;;IAQjE,wFAAwF;IACjF,2BAA2B,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IACrD,mEAAmE;IAC5D,qCAAqC,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAG/D;;OAEG;IACI,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;CAGzC;AACD;;;;;;;GAOG;AACH,qBAAa,+BAAgC,SAAQ,oBAAoB;;IAEvE,OAAO,CAAC,eAAe;IACvB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,eAAe;IACvB;;;;;OAKG;IACI,2BAA2B,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAGrD,mEAAmE;IAC5D,qCAAqC,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAG/D;;OAEG;IACI,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;CAMzC;AAED;;;;;;GAMG;AACH,qBAAa,wBAAyB,SAAQ,oBAAoB;;IAEhE,wFAAwF;IACjF,2BAA2B,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAIrD,mEAAmE;IAC5D,qCAAqC,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAI/D;;OAEG;IACI,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;CAIzC;AACD;;;;GAIG;AACH,qBAAa,0BAA2B,SAAQ,oBAAoB;;IAElE,wFAAwF;IACjF,2BAA2B,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAIrD,mEAAmE;IAC5D,qCAAqC,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAI/D;;OAEG;IACI,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;CAIzC"}

package/lib/esm/curve/spiral/NormalizedTransition.js

@@ -0,0 +1,182 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Curve
+ */
+/**
+ * NormalizedTransition is the (abstract) base class for clothoid, bloss, biquadratic, sine, and cosine transition functions.
+ * * Each function maps fractional progress to a curvature value.
+ *   * f(0) === 0
+ *   * f(1) === 1
+ *   * f(u) === 1 - f (1-u)
+ * * Each implementation provides:
+ *   * fractionToCurvature -- the f(u) function described above
+ *   * fractionToCurvatureDerivative -- df(u)/du
+ *   * fractionToArea -- integral of the area under f(u) from 0 to u.
+ * * the symmetry condition ensures that the integral from 0 to 1 is 1/2
+ * @internal
+ */
+export class NormalizedTransition {
+    /** Constructor initializes with 0..1 values .. call "setBearingCurvatureLengthCurvature" to apply real values */
+    constructor() { }
+    /**
+     * Return a standard evaluator identified by string as:
+     * * clothoid
+     * * bloss
+     * * biquadratic
+     * * sine
+     * * cosine
+     * Each of these types
+     * * is instantiated (only once) as a single static object within the NormalizedTransition class.
+     * * has no instance data or mutator methods.
+     * @param name string name of the transition.
+     */
+    static findEvaluator(name) {
+        if (name === "clothoid")
+            return this._clothoidEvaluator ? this._clothoidEvaluator : (this._clothoidEvaluator = new NormalizedClothoidTransition());
+        if (name === "bloss")
+            return this._blossEvaluator ? this._blossEvaluator : (this._blossEvaluator = new NormalizedBlossTransition());
+        if (name === "biquadratic")
+            return this._biquadraticEvaluator ? this._biquadraticEvaluator : (this._biquadraticEvaluator = new NormalizedBiQuadraticTransition());
+        if (name === "sine")
+            return this._sineEvaluator ? this._sineEvaluator : (this._sineEvaluator = new NormalizedSineTransition());
+        if (name === "cosine")
+            return this._cosineEvaluator ? this._cosineEvaluator : (this._cosineEvaluator = new NormalizedCosineTransition());
+        return undefined;
+    }
+}
+/**
+ * Transition functions for clothoid spiral.
+ * * curvature variation is linear from (0,0) to (1,1)
+ * @internal
+ */
+export class NormalizedClothoidTransition extends NormalizedTransition {
+    constructor() { super(); }
+    /** At fractional position on the x axis, return the (normalized) curvature fraction. */
+    fractionToCurvatureFraction(fractionX) { return fractionX; }
+    /** Return the derivative of the (normalized) curvature fraction */
+    fractionToCurvatureFractionDerivative(_u) { return 1.0; }
+    /** Return the integrated area under the curve.
+     * * This fraction is the angular change fraction.
+     */
+    fractionToArea(fractionX) {
+        return fractionX * fractionX * 0.5;
+    }
+}
+/**
+ * Transition functions for bloss spiral.
+ * * curvature variation is cubic from (0,0) with slope 0 to (1,1) with slope 1
+ * @internal
+ */
+export class NormalizedBlossTransition extends NormalizedTransition {
+    // bloss curve is (3 - 2x) x ^2 = 3 x^2 - 2 x^3
+    //    derivative    6x (1-x)
+    //   2nd derivative 6 - 12 x
+    //     derivatives zero at 0,1
+    //     inflection zero at 0.5
+    //   integral is   x^3 - x^4 / 2 = x^3 ( 1-x/2)
+    constructor() { super(); }
+    /** At fractional position on the x axis, return the (normalized) curvature fraction. */
+    fractionToCurvatureFraction(u) { return u * u * (3 - 2 * u); }
+    /** Return the derivative of the (normalized) curvature fraction */
+    fractionToCurvatureFractionDerivative(u) {
+        return 6.0 * u * (1.0 - u);
+    }
+    /** Return the integrated area under the curve.
+     * * This fraction is the angular change fraction.
+     */
+    fractionToArea(u) {
+        return u * u * u * (1 - 0.5 * u);
+    }
+}
+/**
+/**
+ * Transition functions for biquadratic transition
+ * * Curvature is a pair of joining quadratics.
+ * * In lower half of the interval, the quadratic is from (0,0) to (0.5, 0.5) with zero slope at origin
+ * * In upper half of the interval, the quadratic is from (0.5,0.5) to (1,1) with zero slope at 1
+ * @internal
+ */
+export class NormalizedBiQuadraticTransition extends NormalizedTransition {
+    constructor() { super(); }
+    integratedBasis(u) { return u * u * u * (2.0 / 3.0); }
+    basis(u) { return 2 * u * u; }
+    basisDerivative(u) { return 4 * u; }
+    /** At fractional position on the x axis, return the (normalized) curvature fraction.
+     *  * * For [u <= 0.5, u >= 0.5]
+     *   * f(u) = [2 u^2, 1 - 2 (1-u)^2]
+     *   * f'(u) = [4 u, 4 (1-u)]
+     *   * If(u) = [2 u^3 / 3, 0.5 (1 -u )^3/3]
+     */
+    fractionToCurvatureFraction(u) {
+        return u <= 0.5 ? this.basis(u) : 1.0 - this.basis(1.0 - u);
+    }
+    /** Return the derivative of the (normalized) curvature fraction */
+    fractionToCurvatureFractionDerivative(u) {
+        return u < 0.5 ? this.basisDerivative(u) : this.basisDerivative(1 - u);
+    }
+    /** Return the integrated area under the curve.
+     * * This fraction is the angular change fraction.
+     */
+    fractionToArea(u) {
+        if (u <= 0.5)
+            return this.integratedBasis(u);
+        const v = 1 - u;
+        return 0.5 - v + this.integratedBasis(v);
+    }
+}
+/**
+ * Transition functions for sine transition
+ * * curvature variation is the sum of
+ *   * straight line from (0,0) to (1,1), like clothoid
+ *   * additional full period of a sine wave, producing 0 slope at both ends
+ * @internal
+ */
+export class NormalizedSineTransition extends NormalizedTransition {
+    constructor() { super(); }
+    /** At fractional position on the x axis, return the (normalized) curvature fraction. */
+    fractionToCurvatureFraction(u) {
+        const a = 2.0 * Math.PI;
+        return u - Math.sin(u * a) / a;
+    }
+    /** Return the derivative of the (normalized) curvature fraction */
+    fractionToCurvatureFractionDerivative(u) {
+        const a = 2.0 * Math.PI;
+        return 1 - Math.cos(u * a);
+    }
+    /** Return the integrated area under the curve.
+     * * This fraction is the angular change fraction.
+     */
+    fractionToArea(u) {
+        const a = 2.0 * Math.PI;
+        return 0.5 * u * u + (Math.cos(u * a) - 1.0) / (a * a);
+    }
+}
+/**
+ * Transition functions for cosine
+ * * curvature variation is a half period of a cosine
+ * @internal
+ */
+export class NormalizedCosineTransition extends NormalizedTransition {
+    constructor() { super(); }
+    /** At fractional position on the x axis, return the (normalized) curvature fraction. */
+    fractionToCurvatureFraction(u) {
+        const a = Math.PI;
+        return 0.5 * (1 - Math.cos(u * a));
+    }
+    /** Return the derivative of the (normalized) curvature fraction */
+    fractionToCurvatureFractionDerivative(u) {
+        const a = Math.PI;
+        return 0.5 * a * Math.sin(u * a);
+    }
+    /** Return the integrated area under the curve.
+     * * This fraction is the angular change fraction.
+     */
+    fractionToArea(u) {
+        const a = Math.PI;
+        return 0.5 * u - 0.5 * Math.sin(u * a) / a;
+    }
+}
+//# sourceMappingURL=NormalizedTransition.js.map

package/lib/esm/curve/spiral/NormalizedTransition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NormalizedTransition.js","sourceRoot":"","sources":["../../../../src/curve/spiral/NormalizedTransition.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\n/** @packageDocumentation\r\n * @module Curve\r\n */\r\n/**\r\n * NormalizedTransition is the (abstract) base class for clothoid, bloss, biquadratic, sine, and cosine transition functions.\r\n * * Each function maps fractional progress to a curvature value.\r\n *   * f(0) === 0\r\n *   * f(1) === 1\r\n *   * f(u) === 1 - f (1-u)\r\n * * Each implementation provides:\r\n *   * fractionToCurvature -- the f(u) function described above\r\n *   * fractionToCurvatureDerivative -- df(u)/du\r\n *   * fractionToArea -- integral of the area under f(u) from 0 to u.\r\n * * the symmetry condition ensures that the integral from 0 to 1 is 1/2\r\n * @internal\r\n */\r\nexport abstract class NormalizedTransition {\r\n  /** Constructor initializes with 0..1 values .. call \"setBearingCurvatureLengthCurvature\" to apply real values */\r\n  constructor() { }\r\n  /** At fractional position on the x axis, return the (normalized) curvature fraction. */\r\n  public abstract fractionToCurvatureFraction(fractionX: number): number;\r\n  /** Return the derivative of the (normalized) curvature fraction */\r\n  public abstract fractionToCurvatureFractionDerivative(fractionX: number): number;\r\n  /** Return the integrated area under the curve\r\n   * * This is equal to the accumulated angle change.\r\n   */\r\n  public abstract fractionToArea(fractionX: number): number;\r\n  private static _clothoidEvaluator?: NormalizedClothoidTransition;\r\n  private static _biquadraticEvaluator?: NormalizedBiQuadraticTransition;\r\n  private static _blossEvaluator?: NormalizedBlossTransition;\r\n  private static _sineEvaluator?: NormalizedSineTransition;\r\n  private static _cosineEvaluator?: NormalizedCosineTransition;\r\n\r\n  /**\r\n   * Return a standard evaluator identified by string as:\r\n   * * clothoid\r\n   * * bloss\r\n   * * biquadratic\r\n   * * sine\r\n   * * cosine\r\n   * Each of these types\r\n   * * is instantiated (only once) as a single static object within the NormalizedTransition class.\r\n   * * has no instance data or mutator methods.\r\n   * @param name string name of the transition.\r\n   */\r\n  public static findEvaluator(name: string): NormalizedTransition | undefined {\r\n    if (name === \"clothoid\")\r\n      return this._clothoidEvaluator ? this._clothoidEvaluator : (this._clothoidEvaluator = new NormalizedClothoidTransition());\r\n    if (name === \"bloss\")\r\n      return this._blossEvaluator ? this._blossEvaluator : (this._blossEvaluator = new NormalizedBlossTransition());\r\n    if (name === \"biquadratic\")\r\n      return this._biquadraticEvaluator ? this._biquadraticEvaluator : (this._biquadraticEvaluator = new NormalizedBiQuadraticTransition());\r\n    if (name === \"sine\")\r\n      return this._sineEvaluator ? this._sineEvaluator : (this._sineEvaluator = new NormalizedSineTransition());\r\n    if (name === \"cosine\")\r\n      return this._cosineEvaluator ? this._cosineEvaluator : (this._cosineEvaluator = new NormalizedCosineTransition());\r\n    return undefined;\r\n  }\r\n}\r\n/**\r\n * Transition functions for clothoid spiral.\r\n * * curvature variation is linear from (0,0) to (1,1)\r\n * @internal\r\n */\r\nexport class NormalizedClothoidTransition extends NormalizedTransition {\r\n  constructor() { super(); }\r\n  /** At fractional position on the x axis, return the (normalized) curvature fraction. */\r\n  public fractionToCurvatureFraction(fractionX: number): number { return fractionX; }\r\n  /** Return the derivative of the (normalized) curvature fraction */\r\n  public fractionToCurvatureFractionDerivative(_u: number): number { return 1.0; }\r\n  /** Return the integrated area under the curve.\r\n   * * This fraction is the angular change fraction.\r\n   */\r\n  public fractionToArea(fractionX: number): number {\r\n    return fractionX * fractionX * 0.5;\r\n  }\r\n}\r\n\r\n/**\r\n * Transition functions for bloss spiral.\r\n * * curvature variation is cubic from (0,0) with slope 0 to (1,1) with slope 1\r\n * @internal\r\n */\r\nexport class NormalizedBlossTransition extends NormalizedTransition {\r\n  // bloss curve is (3 - 2x) x ^2 = 3 x^2 - 2 x^3\r\n  //    derivative    6x (1-x)\r\n  //   2nd derivative 6 - 12 x\r\n  //     derivatives zero at 0,1\r\n  //     inflection zero at 0.5\r\n  //   integral is   x^3 - x^4 / 2 = x^3 ( 1-x/2)\r\n  constructor() { super(); }\r\n  /** At fractional position on the x axis, return the (normalized) curvature fraction. */\r\n  public fractionToCurvatureFraction(u: number): number { return u * u * (3 - 2 * u); }\r\n  /** Return the derivative of the (normalized) curvature fraction */\r\n  public fractionToCurvatureFractionDerivative(u: number): number {\r\n    return 6.0 * u * (1.0 - u);\r\n  }\r\n  /** Return the integrated area under the curve.\r\n   * * This fraction is the angular change fraction.\r\n   */\r\n  public fractionToArea(u: number): number {\r\n    return u * u * u * (1 - 0.5 * u);\r\n  }\r\n}\r\n/**\r\n/**\r\n * Transition functions for biquadratic transition\r\n * * Curvature is a pair of joining quadratics.\r\n * * In lower half of the interval, the quadratic is from (0,0) to (0.5, 0.5) with zero slope at origin\r\n * * In upper half of the interval, the quadratic is from (0.5,0.5) to (1,1) with zero slope at 1\r\n * @internal\r\n */\r\nexport class NormalizedBiQuadraticTransition extends NormalizedTransition {\r\n  constructor() { super(); }\r\n  private integratedBasis(u: number): number { return u * u * u * (2.0 / 3.0); }\r\n  private basis(u: number): number { return 2 * u * u; }\r\n  private basisDerivative(u: number): number { return 4 * u; }\r\n  /** At fractional position on the x axis, return the (normalized) curvature fraction.\r\n   *  * * For [u <= 0.5, u >= 0.5]\r\n   *   * f(u) = [2 u^2, 1 - 2 (1-u)^2]\r\n   *   * f'(u) = [4 u, 4 (1-u)]\r\n   *   * If(u) = [2 u^3 / 3, 0.5 (1 -u )^3/3]\r\n   */\r\n  public fractionToCurvatureFraction(u: number): number {\r\n    return u <= 0.5 ? this.basis(u) : 1.0 - this.basis(1.0 - u);\r\n  }\r\n  /** Return the derivative of the (normalized) curvature fraction */\r\n  public fractionToCurvatureFractionDerivative(u: number): number {\r\n    return u < 0.5 ? this.basisDerivative(u) : this.basisDerivative(1 - u);\r\n  }\r\n  /** Return the integrated area under the curve.\r\n   * * This fraction is the angular change fraction.\r\n   */\r\n  public fractionToArea(u: number): number {\r\n    if (u <= 0.5)\r\n      return this.integratedBasis(u);\r\n    const v = 1 - u;\r\n    return 0.5 - v + this.integratedBasis(v);\r\n  }\r\n}\r\n\r\n/**\r\n * Transition functions for sine transition\r\n * * curvature variation is the sum of\r\n *   * straight line from (0,0) to (1,1), like clothoid\r\n *   * additional full period of a sine wave, producing 0 slope at both ends\r\n * @internal\r\n */\r\nexport class NormalizedSineTransition extends NormalizedTransition {\r\n  constructor() { super(); }\r\n  /** At fractional position on the x axis, return the (normalized) curvature fraction. */\r\n  public fractionToCurvatureFraction(u: number): number {\r\n    const a = 2.0 * Math.PI;\r\n    return u - Math.sin(u * a) / a;\r\n  }\r\n  /** Return the derivative of the (normalized) curvature fraction */\r\n  public fractionToCurvatureFractionDerivative(u: number): number {\r\n    const a = 2.0 * Math.PI;\r\n    return 1 - Math.cos(u * a);\r\n  }\r\n  /** Return the integrated area under the curve.\r\n   * * This fraction is the angular change fraction.\r\n   */\r\n  public fractionToArea(u: number): number {\r\n    const a = 2.0 * Math.PI;\r\n    return 0.5 * u * u + (Math.cos(u * a) - 1.0) / (a * a);\r\n  }\r\n}\r\n/**\r\n * Transition functions for cosine\r\n * * curvature variation is a half period of a cosine\r\n * @internal\r\n */\r\nexport class NormalizedCosineTransition extends NormalizedTransition {\r\n  constructor() { super(); }\r\n  /** At fractional position on the x axis, return the (normalized) curvature fraction. */\r\n  public fractionToCurvatureFraction(u: number): number {\r\n    const a = Math.PI;\r\n    return 0.5 * (1 - Math.cos(u * a));\r\n  }\r\n  /** Return the derivative of the (normalized) curvature fraction */\r\n  public fractionToCurvatureFractionDerivative(u: number): number {\r\n    const a = Math.PI;\r\n    return 0.5 * a * Math.sin(u * a);\r\n  }\r\n  /** Return the integrated area under the curve.\r\n   * * This fraction is the angular change fraction.\r\n   */\r\n  public fractionToArea(u: number): number {\r\n    const a = Math.PI;\r\n    return 0.5 * u - 0.5 * Math.sin(u * a) / a;\r\n  }\r\n}\r\n"]}

package/lib/esm/curve/spiral/PolishCubicSpiralEvaluator.d.ts

@@ -0,0 +1,50 @@
+import { CubicEvaluator } from "./CubicEvaluator";
+/**
+ * Polish Cubic.
+ * * Construction takes nominal length and end radius.
+ * curve is  is y= m*x^3 with
+ * * x any point on the x axis
+ * * m is (1/6RL)
+ * * Lx = x length is along the axis, determined by inversion of a distance series at nominal length
+ * *
+ * @param localToWorld
+ * @param nominalL1
+ * @param nominalR1
+ * @param activeInterval
+ * @internal
+ */
+export declare class PolishCubicEvaluator extends CubicEvaluator {
+    nominalLength1: number;
+    nominalRadius1: number;
+    /** Constructor is private.  Caller responsible for cubicM validity. */
+    private constructor();
+    /** Compute the czech cubic constant. */
+    static computeCubicM(length1: number, radius1: number): number;
+    static create(length1: number, radius1: number): PolishCubicEvaluator | undefined;
+    scaleInPlace(scaleFactor: number): void;
+    /** return a deep copy of the evaluator */
+    clone(): PolishCubicEvaluator;
+    /** Member by member matchup ... */
+    isAlmostEqual(other: any): boolean;
+    /** Compute the coefficient of x^4 in the x-to-distance series expansion */
+    static computeX4SeriesCoefficient(length1: number, radius1: number): number;
+    /**
+     * Evaluate a series approximation of distance along the true curve.
+     * @param x distance along x axis
+     * @param radius1 nominal end radius
+     * @param length1 nominal length along curve
+     * @returns
+     */
+    static xToApproximateDistance(x: number, radius1: number, length1: number): number;
+    /**
+     * Evaluate the derivative of the x-to-distance series.
+     * @param x distance along x axis
+     * @param radius1 nominal end radius
+     * @param length1 nominal length along curve
+     * @returns
+     */
+    static xToApproximateDistanceDerivative(x: number, radius1: number, length1: number): number;
+    /** Invert the xToApproximateDistance function. */
+    static approximateDistanceAlongToX(s: number, radius1: number, length1: number): number | undefined;
+}
+//# sourceMappingURL=PolishCubicSpiralEvaluator.d.ts.map

package/lib/esm/curve/spiral/PolishCubicSpiralEvaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PolishCubicSpiralEvaluator.d.ts","sourceRoot":"","sources":["../../../../src/curve/spiral/PolishCubicSpiralEvaluator.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD;;;;;;;;;;;;;GAaG;AACH,qBAAa,oBAAqB,SAAQ,cAAc;IAC/C,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IAE9B,uEAAuE;IACvE,OAAO;IAMP,wCAAwC;WAC1B,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;WAIvD,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAUxE,YAAY,CAAC,WAAW,EAAE,MAAM;IAKhD,0CAA0C;IACnC,KAAK,IAAI,oBAAoB;IACpC,mCAAmC;IAC5B,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO;IAQzC,2EAA2E;WAC7D,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAGlF;;;;;;OAMG;WACW,sBAAsB,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAUzF;;;;;;OAMG;WACW,gCAAgC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAiBnG,kDAAkD;WACpC,2BAA2B,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAM3G"}

package/lib/esm/curve/spiral/PolishCubicSpiralEvaluator.js

@@ -0,0 +1,109 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Curve
+ */
+import { Geometry } from "../../Geometry";
+import { SimpleNewton } from "../../numerics/Newton";
+import { CubicEvaluator } from "./CubicEvaluator";
+/**
+ * Polish Cubic.
+ * * Construction takes nominal length and end radius.
+ * curve is  is y= m*x^3 with
+ * * x any point on the x axis
+ * * m is (1/6RL)
+ * * Lx = x length is along the axis, determined by inversion of a distance series at nominal length
+ * *
+ * @param localToWorld
+ * @param nominalL1
+ * @param nominalR1
+ * @param activeInterval
+ * @internal
+ */
+export class PolishCubicEvaluator extends CubicEvaluator {
+    /** Constructor is private.  Caller responsible for cubicM validity. */
+    constructor(length1, radius1, axisLength, cubicM) {
+        super(axisLength, cubicM);
+        this.nominalLength1 = length1;
+        this.nominalRadius1 = radius1;
+    }
+    /** Compute the czech cubic constant. */
+    static computeCubicM(length1, radius1) {
+        return 1.0 / (6.0 * length1 * radius1);
+    }
+    static create(length1, radius1) {
+        const m = this.computeCubicM(length1, radius1);
+        if (m === undefined)
+            return undefined;
+        const xMax = PolishCubicEvaluator.approximateDistanceAlongToX(length1, radius1, length1);
+        if (xMax === undefined)
+            return undefined;
+        return new PolishCubicEvaluator(length1, radius1, xMax, m);
+    }
+    scaleInPlace(scaleFactor) {
+        this.nominalLength1 *= scaleFactor;
+        this.nominalRadius1 *= scaleFactor;
+        super.scaleInPlace(scaleFactor);
+    }
+    /** return a deep copy of the evaluator */
+    clone() { return new PolishCubicEvaluator(this.nominalLength1, this.nominalRadius1, super._axisLength, this.cubicM); }
+    /** Member by member matchup ... */
+    isAlmostEqual(other) {
+        if (other instanceof PolishCubicEvaluator) {
+            return Geometry.isSameCoordinate(this.nominalLength1, other.nominalLength1)
+                && Geometry.isSameCoordinate(this.nominalRadius1, other.nominalRadius1);
+        }
+        return false;
+    }
+    /** Compute the coefficient of x^4 in the x-to-distance series expansion */
+    static computeX4SeriesCoefficient(length1, radius1) {
+        return 1.0 / (4.0 * length1 * length1 * radius1 * radius1);
+    }
+    /**
+     * Evaluate a series approximation of distance along the true curve.
+     * @param x distance along x axis
+     * @param radius1 nominal end radius
+     * @param length1 nominal length along curve
+     * @returns
+     */
+    static xToApproximateDistance(x, radius1, length1) {
+        // C31 * ( 1 + 1 / 10 * E31 - 1 / 72 * E31^2 + 1 / 208 * E31^3 - 5 / 2176 * E31^4 )
+        const a4 = this.computeX4SeriesCoefficient(length1, radius1);
+        const ax2 = a4 * x * x;
+        const ax3 = ax2 * x;
+        const ax4 = ax3 * x;
+        const s0 = x * (1.0 + ax4 * (0.1 + ax4 * (-1.0 / 72.0 + ax4 * (1.0 / 208.0 - 5.0 * ax4 / 2176.0))));
+        return s0;
+    }
+    /**
+     * Evaluate the derivative of the x-to-distance series.
+     * @param x distance along x axis
+     * @param radius1 nominal end radius
+     * @param length1 nominal length along curve
+     * @returns
+     */
+    static xToApproximateDistanceDerivative(x, radius1, length1) {
+        // C31 * ( 1 + 1 / 10 * E31 - 1 / 72 * E31^2 + 1 / 208 * E31^3 - 5 / 2176 * E31^4 )
+        const a4 = this.computeX4SeriesCoefficient(length1, radius1);
+        const ax2 = a4 * x * x;
+        const ax3 = ax2 * x;
+        const ax4 = ax3 * x;
+        // derivative notes ..
+        // take away leading x -- this reduces each power by 1
+        // multiply each coefficient by its original power:
+        //  0.1==>0.5
+        // 1/72==> 9/72 = 1/8
+        // 1/208==>13/208=1/16
+        // 1/2176==>17/2176= 1/128
+        const ds = (1.0 + ax4 * (0.5 + ax4 * (-1.0 / 8.0 + ax4 * (1.0 / 16.0 - 5.0 * ax4 / 128.0))));
+        return ds;
+    }
+    /** Invert the xToApproximateDistance function. */
+    static approximateDistanceAlongToX(s, radius1, length1) {
+        const root = SimpleNewton.runNewton1D(s, (x) => (this.xToApproximateDistance(x, radius1, length1) - s), (x) => this.xToApproximateDistanceDerivative(x, radius1, length1));
+        return root;
+    }
+}
+//# sourceMappingURL=PolishCubicSpiralEvaluator.js.map