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

package/lib/esm/geometry3d/Point3dArrayCarrier.d.ts

@@ -0,0 +1,142 @@
+/** @packageDocumentation
+ * @module ArraysAndInterfaces
+ */
+import { IndexedReadWriteXYZCollection } from "./IndexedXYZCollection";
+import { Point3d, Vector3d } from "./Point3dVector3d";
+import { XYAndZ } from "./XYZProps";
+/**
+ * Helper object to access members of a Point3d[] in geometric calculations.
+ * * The collection holds only a reference to the actual array.
+ * * The actual array may be replaced by the user as needed.
+ * * When replaced, there is no cached data to be updated.
+ * @public
+ */
+export declare class Point3dArrayCarrier extends IndexedReadWriteXYZCollection {
+    /** reference to array being queried. */
+    data: Point3d[];
+    /** CAPTURE caller supplied array ... */
+    constructor(data: Point3d[]);
+    /** test if `index` is a valid index into the array. */
+    isValidIndex(index: number): boolean;
+    /**
+     * Access by index, returning strongly typed Point3d
+     * @param index index of point within the array
+     * @param result caller-allocated destination
+     * @returns undefined if the index is out of bounds
+     */
+    getPoint3dAtCheckedPointIndex(index: number, result?: Point3d): Point3d | undefined;
+    /**
+     * Access by index, returning strongly typed Point3d
+     * * This returns the xyz value but NOT reference to the point in the "carried" array.
+     * @param index index of point within the array
+     * @param result caller-allocated destination
+     * @returns undefined if the index is out of bounds
+     */
+    getPoint3dAtUncheckedPointIndex(index: number, result?: Point3d): Point3d;
+    /**
+     * Access by index, returning strongly typed Vector3d
+     * @param index index of point within the array
+     * @param result caller-allocated destination
+     * @returns undefined if the index is out of bounds
+     */
+    getVector3dAtCheckedVectorIndex(index: number, result?: Vector3d): Vector3d | undefined;
+    /** access x of indexed point */
+    getXAtUncheckedPointIndex(pointIndex: number): number;
+    /** access y of indexed point */
+    getYAtUncheckedPointIndex(pointIndex: number): number;
+    /** access z of indexed point */
+    getZAtUncheckedPointIndex(pointIndex: number): number;
+    /**
+     * Return a vector from the point at indexA to the point at indexB
+     * @param indexA index of point within the array
+     * @param indexB index of point within the array
+     * @param result caller-allocated vector.
+     * @returns undefined if either index is out of bounds
+     */
+    vectorIndexIndex(indexA: number, indexB: number, result?: Vector3d): Vector3d | undefined;
+    /**
+     * Return a vector from given origin to point at indexB
+     * @param origin origin for vector
+     * @param indexB index of point within the array
+     * @param result caller-allocated vector.
+     * @returns undefined if index is out of bounds
+     */
+    vectorXYAndZIndex(origin: XYAndZ, indexB: number, result?: Vector3d): Vector3d | undefined;
+    /**
+     * Return the cross product of vectors from origin to points at indexA and indexB
+     * @param origin origin for vector
+     * @param indexA index of first target within the array
+     * @param indexB index of second target within the array
+     * @param result caller-allocated vector.
+     * @returns undefined if either index is out of bounds
+     */
+    crossProductXYAndZIndexIndex(origin: XYAndZ, indexA: number, indexB: number, result?: Vector3d): Vector3d | undefined;
+    /**
+     * Return the cross product of vectors from point at originIndex to points at indexA and indexB
+     * @param originIndex index of origin
+     * @param indexA index of first target within the array
+     * @param indexB index of second target within the array
+     * @param result caller-allocated vector.
+     * @returns return true if indexA, indexB both valid
+     */
+    crossProductIndexIndexIndex(originIndex: number, indexA: number, indexB: number, result?: Vector3d): Vector3d | undefined;
+    /**
+     * Compute the cross product of vectors from point at originIndex to points at indexA and indexB, and accumulate it to the result.
+     * @param origin index of origin
+     * @param indexA index of first target within the array
+     * @param indexB index of second target within the array
+     * @param result caller-allocated vector.
+     * @returns return true if indexA, indexB both valid
+     */
+    accumulateCrossProductIndexIndexIndex(originIndex: number, indexA: number, indexB: number, result: Vector3d): void;
+    /**
+     * * compute the cross product from indexed origin t indexed targets targetAIndex and targetB index.
+     * * accumulate it to the result.
+     */
+    accumulateScaledXYZ(index: number, scale: number, sum: Point3d): void;
+    /**
+     * read-only property for number of XYZ in the collection.
+     */
+    get length(): number;
+    /** push a (clone of) point onto the collection
+     * * point itself is not pushed -- xyz data is extracted into the native form of the collection.
+     */
+    push(data: Point3d): void;
+    /**
+     * push a new point (given by coordinates) onto the collection
+     * @param x x coordinate
+     * @param y y coordinate
+     * @param z z coordinate
+     */
+    pushXYZ(x?: number, y?: number, z?: number): void;
+    /** extract (copy) the final point */
+    back(result?: Point3d): Point3d | undefined;
+    /** extract (copy) the first point */
+    front(result?: Point3d): Point3d | undefined;
+    /** remove the final point. */
+    pop(): void;
+    /** remove all points. */
+    clear(): void;
+    /** Reverse the points in place */
+    reverseInPlace(): void;
+    /**
+     * Return distance squared between indicated points.
+     * * Concrete classes may be able to implement this without creating a temporary.
+     * @param index0 first point index
+     * @param index1 second point index
+     * @param defaultDistanceSquared distance squared to return if either point index is invalid.
+     *
+     */
+    distanceSquaredIndexIndex(index0: number, index1: number): number | undefined;
+    /**
+     * Return distance between indicated points.
+     * * Concrete classes may be able to implement this without creating a temporary.
+     * @param index0 first point index
+     * @param index1 second point index
+     * @param defaultDistanceSquared distance squared to return if either point index is invalid.
+     */
+    distanceIndexIndex(index0: number, index1: number): number | undefined;
+    /** Adjust index into range by modulo with the length. */
+    cyclicIndex(i: number): number;
+}
+//# sourceMappingURL=Point3dArrayCarrier.d.ts.map

package/lib/esm/geometry3d/Point3dArrayCarrier.d.ts.map

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

package/lib/esm/geometry3d/Point3dArrayCarrier.js

@@ -0,0 +1,233 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module ArraysAndInterfaces
+ */
+import { IndexedReadWriteXYZCollection } from "./IndexedXYZCollection";
+import { Point3d, Vector3d } from "./Point3dVector3d";
+/**
+ * Helper object to access members of a Point3d[] in geometric calculations.
+ * * The collection holds only a reference to the actual array.
+ * * The actual array may be replaced by the user as needed.
+ * * When replaced, there is no cached data to be updated.
+ * @public
+ */
+export class Point3dArrayCarrier extends IndexedReadWriteXYZCollection {
+    /** CAPTURE caller supplied array ... */
+    constructor(data) {
+        super();
+        this.data = data;
+    }
+    /** test if `index` is a valid index into the array. */
+    isValidIndex(index) {
+        return index >= 0 && index < this.data.length;
+    }
+    /**
+     * Access by index, returning strongly typed Point3d
+     * @param index index of point within the array
+     * @param result caller-allocated destination
+     * @returns undefined if the index is out of bounds
+     */
+    getPoint3dAtCheckedPointIndex(index, result) {
+        if (this.isValidIndex(index)) {
+            const source = this.data[index];
+            return Point3d.create(source.x, source.y, source.z, result);
+        }
+        return undefined;
+    }
+    /**
+     * Access by index, returning strongly typed Point3d
+     * * This returns the xyz value but NOT reference to the point in the "carried" array.
+     * @param index index of point within the array
+     * @param result caller-allocated destination
+     * @returns undefined if the index is out of bounds
+     */
+    getPoint3dAtUncheckedPointIndex(index, result) {
+        const source = this.data[index];
+        return Point3d.create(source.x, source.y, source.z, result);
+    }
+    /**
+     * Access by index, returning strongly typed Vector3d
+     * @param index index of point within the array
+     * @param result caller-allocated destination
+     * @returns undefined if the index is out of bounds
+     */
+    getVector3dAtCheckedVectorIndex(index, result) {
+        if (this.isValidIndex(index)) {
+            const source = this.data[index];
+            return Vector3d.create(source.x, source.y, source.z, result);
+        }
+        return undefined;
+    }
+    /** access x of indexed point */
+    getXAtUncheckedPointIndex(pointIndex) {
+        return this.data[pointIndex].x;
+    }
+    /** access y of indexed point */
+    getYAtUncheckedPointIndex(pointIndex) {
+        return this.data[pointIndex].y;
+    }
+    /** access z of indexed point */
+    getZAtUncheckedPointIndex(pointIndex) {
+        return this.data[pointIndex].z;
+    }
+    /**
+     * Return a vector from the point at indexA to the point at indexB
+     * @param indexA index of point within the array
+     * @param indexB index of point within the array
+     * @param result caller-allocated vector.
+     * @returns undefined if either index is out of bounds
+     */
+    vectorIndexIndex(indexA, indexB, result) {
+        if (this.isValidIndex(indexA) && this.isValidIndex(indexB))
+            return Vector3d.createStartEnd(this.data[indexA], this.data[indexB], result);
+        return undefined;
+    }
+    /**
+     * Return a vector from given origin to point at indexB
+     * @param origin origin for vector
+     * @param indexB index of point within the array
+     * @param result caller-allocated vector.
+     * @returns undefined if index is out of bounds
+     */
+    vectorXYAndZIndex(origin, indexB, result) {
+        if (this.isValidIndex(indexB))
+            return Vector3d.createStartEnd(origin, this.data[indexB], result);
+        return undefined;
+    }
+    /**
+     * Return the cross product of vectors from origin to points at indexA and indexB
+     * @param origin origin for vector
+     * @param indexA index of first target within the array
+     * @param indexB index of second target within the array
+     * @param result caller-allocated vector.
+     * @returns undefined if either index is out of bounds
+     */
+    crossProductXYAndZIndexIndex(origin, indexA, indexB, result) {
+        if (this.isValidIndex(indexA) && this.isValidIndex(indexB))
+            return Vector3d.createCrossProductToPoints(origin, this.data[indexA], this.data[indexB], result);
+        return undefined;
+    }
+    /**
+     * Return the cross product of vectors from point at originIndex to points at indexA and indexB
+     * @param originIndex index of origin
+     * @param indexA index of first target within the array
+     * @param indexB index of second target within the array
+     * @param result caller-allocated vector.
+     * @returns return true if indexA, indexB both valid
+     */
+    crossProductIndexIndexIndex(originIndex, indexA, indexB, result) {
+        if (this.isValidIndex(originIndex) && this.isValidIndex(indexA) && this.isValidIndex(indexB))
+            return Vector3d.createCrossProductToPoints(this.data[originIndex], this.data[indexA], this.data[indexB], result);
+        return undefined;
+    }
+    /**
+     * Compute the cross product of vectors from point at originIndex to points at indexA and indexB, and accumulate it to the result.
+     * @param origin index of origin
+     * @param indexA index of first target within the array
+     * @param indexB index of second target within the array
+     * @param result caller-allocated vector.
+     * @returns return true if indexA, indexB both valid
+     */
+    accumulateCrossProductIndexIndexIndex(originIndex, indexA, indexB, result) {
+        const data = this.data;
+        if (this.isValidIndex(originIndex) && this.isValidIndex(indexA) && this.isValidIndex(indexB))
+            result.addCrossProductToTargetsInPlace(data[originIndex].x, data[originIndex].y, data[originIndex].z, data[indexA].x, data[indexA].y, data[indexA].z, data[indexB].x, data[indexB].y, data[indexB].z);
+    }
+    /**
+     * * compute the cross product from indexed origin t indexed targets targetAIndex and targetB index.
+     * * accumulate it to the result.
+     */
+    accumulateScaledXYZ(index, scale, sum) {
+        if (this.isValidIndex(index)) {
+            const point = this.data[index];
+            sum.x += scale * point.x;
+            sum.y += scale * point.y;
+            sum.z += scale * point.z;
+        }
+    }
+    /**
+     * read-only property for number of XYZ in the collection.
+     */
+    get length() {
+        return this.data.length;
+    }
+    /** push a (clone of) point onto the collection
+     * * point itself is not pushed -- xyz data is extracted into the native form of the collection.
+     */
+    push(data) {
+        this.data.push(data.clone());
+    }
+    /**
+     * push a new point (given by coordinates) onto the collection
+     * @param x x coordinate
+     * @param y y coordinate
+     * @param z z coordinate
+     */
+    pushXYZ(x, y, z) {
+        this.data.push(Point3d.create(x === undefined ? 0.0 : x, y === undefined ? 0.0 : y, z === undefined ? 0.0 : z));
+    }
+    /** extract (copy) the final point */
+    back(result) {
+        if (this.data.length > 0) {
+            return this.data[this.data.length - 1].clone(result);
+        }
+        return undefined;
+    }
+    /** extract (copy) the first point */
+    front(result) {
+        if (this.data.length > 0) {
+            return this.data[0].clone(result);
+        }
+        return undefined;
+    }
+    /** remove the final point. */
+    pop() {
+        if (this.data.length > 0)
+            this.data.pop();
+    }
+    /** remove all points. */
+    clear() {
+        this.data.length = 0;
+    }
+    /** Reverse the points in place */
+    reverseInPlace() {
+        this.data.reverse();
+    }
+    /**
+     * Return distance squared between indicated points.
+     * * Concrete classes may be able to implement this without creating a temporary.
+     * @param index0 first point index
+     * @param index1 second point index
+     * @param defaultDistanceSquared distance squared to return if either point index is invalid.
+     *
+     */
+    distanceSquaredIndexIndex(index0, index1) {
+        const n = this.data.length;
+        if (index0 >= 0 && index0 < n && index1 >= 0 && index1 < n) {
+            return this.data[index0].distanceSquared(this.data[index1]);
+        }
+        return undefined;
+    }
+    /**
+     * Return distance between indicated points.
+     * * Concrete classes may be able to implement this without creating a temporary.
+     * @param index0 first point index
+     * @param index1 second point index
+     * @param defaultDistanceSquared distance squared to return if either point index is invalid.
+     */
+    distanceIndexIndex(index0, index1) {
+        const n = this.data.length;
+        if (index0 >= 0 && index0 < n && index1 >= 0 && index1 < n) {
+            return this.data[index0].distance(this.data[index1]);
+        }
+        return undefined;
+    }
+    /** Adjust index into range by modulo with the length. */
+    cyclicIndex(i) {
+        return (i % this.length);
+    }
+}
+//# sourceMappingURL=Point3dArrayCarrier.js.map

package/lib/esm/geometry3d/Point3dArrayCarrier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Point3dArrayCarrier.js","sourceRoot":"","sources":["../../../src/geometry3d/Point3dArrayCarrier.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/** @packageDocumentation\r\n * @module ArraysAndInterfaces\r\n */\r\n\r\nimport { IndexedReadWriteXYZCollection } from \"./IndexedXYZCollection\";\r\nimport { Point3d, Vector3d } from \"./Point3dVector3d\";\r\nimport { XYAndZ } from \"./XYZProps\";\r\n\r\n/**\r\n * Helper object to access members of a Point3d[] in geometric calculations.\r\n * * The collection holds only a reference to the actual array.\r\n * * The actual array may be replaced by the user as needed.\r\n * * When replaced, there is no cached data to be updated.\r\n * @public\r\n */\r\nexport class Point3dArrayCarrier extends IndexedReadWriteXYZCollection {\r\n  /** reference to array being queried. */\r\n  public data: Point3d[];\r\n  /** CAPTURE caller supplied array ... */\r\n  public constructor(data: Point3d[]) {\r\n    super();\r\n    this.data = data;\r\n  }\r\n  /** test if `index` is a valid index into the array. */\r\n  public isValidIndex(index: number): boolean {\r\n    return index >= 0 && index < this.data.length;\r\n  }\r\n  /**\r\n   * Access by index, returning strongly typed Point3d\r\n   * @param index index of point within the array\r\n   * @param result caller-allocated destination\r\n   * @returns undefined if the index is out of bounds\r\n   */\r\n  public getPoint3dAtCheckedPointIndex(index: number, result?: Point3d): Point3d | undefined {\r\n    if (this.isValidIndex(index)) {\r\n      const source = this.data[index];\r\n      return Point3d.create(source.x, source.y, source.z, result);\r\n    }\r\n    return undefined;\r\n  }\r\n  /**\r\n   * Access by index, returning strongly typed Point3d\r\n   * * This returns the xyz value but NOT reference to the point in the \"carried\" array.\r\n   * @param index index of point within the array\r\n   * @param result caller-allocated destination\r\n   * @returns undefined if the index is out of bounds\r\n   */\r\n  public getPoint3dAtUncheckedPointIndex(index: number, result?: Point3d): Point3d {\r\n    const source = this.data[index];\r\n    return Point3d.create(source.x, source.y, source.z, result);\r\n  }\r\n  /**\r\n   * Access by index, returning strongly typed Vector3d\r\n   * @param index index of point within the array\r\n   * @param result caller-allocated destination\r\n   * @returns undefined if the index is out of bounds\r\n   */\r\n  public getVector3dAtCheckedVectorIndex(index: number, result?: Vector3d): Vector3d | undefined {\r\n    if (this.isValidIndex(index)) {\r\n      const source = this.data[index];\r\n      return Vector3d.create(source.x, source.y, source.z, result);\r\n    }\r\n    return undefined;\r\n  }\r\n  /** access x of indexed point */\r\n  public getXAtUncheckedPointIndex(pointIndex: number): number {\r\n    return this.data[pointIndex].x;\r\n  }\r\n\r\n  /** access y of indexed point */\r\n  public getYAtUncheckedPointIndex(pointIndex: number): number {\r\n    return this.data[pointIndex].y;\r\n  }\r\n\r\n  /** access z of indexed point */\r\n  public getZAtUncheckedPointIndex(pointIndex: number): number {\r\n    return this.data[pointIndex].z;\r\n  }\r\n  /**\r\n   * Return a vector from the point at indexA to the point at indexB\r\n   * @param indexA index of point within the array\r\n   * @param indexB index of point within the array\r\n   * @param result caller-allocated vector.\r\n   * @returns undefined if either index is out of bounds\r\n   */\r\n  public vectorIndexIndex(indexA: number, indexB: number, result?: Vector3d): Vector3d | undefined {\r\n    if (this.isValidIndex(indexA) && this.isValidIndex(indexB))\r\n      return Vector3d.createStartEnd(this.data[indexA], this.data[indexB], result);\r\n    return undefined;\r\n  }\r\n  /**\r\n   * Return a vector from given origin to point at indexB\r\n   * @param origin origin for vector\r\n   * @param indexB index of point within the array\r\n   * @param result caller-allocated vector.\r\n   * @returns undefined if index is out of bounds\r\n   */\r\n  public vectorXYAndZIndex(origin: XYAndZ, indexB: number, result?: Vector3d): Vector3d | undefined {\r\n    if (this.isValidIndex(indexB))\r\n      return Vector3d.createStartEnd(origin, this.data[indexB], result);\r\n    return undefined;\r\n  }\r\n  /**\r\n   * Return the cross product of vectors from origin to points at indexA and indexB\r\n   * @param origin origin for vector\r\n   * @param indexA index of first target within the array\r\n   * @param indexB index of second target within the array\r\n   * @param result caller-allocated vector.\r\n   * @returns undefined if either index is out of bounds\r\n   */\r\n  public crossProductXYAndZIndexIndex(origin: XYAndZ, indexA: number, indexB: number, result?: Vector3d): Vector3d | undefined {\r\n    if (this.isValidIndex(indexA) && this.isValidIndex(indexB))\r\n      return Vector3d.createCrossProductToPoints(origin, this.data[indexA], this.data[indexB], result);\r\n    return undefined;\r\n  }\r\n  /**\r\n   * Return the cross product of vectors from point at originIndex to points at indexA and indexB\r\n   * @param originIndex index of origin\r\n   * @param indexA index of first target within the array\r\n   * @param indexB index of second target within the array\r\n   * @param result caller-allocated vector.\r\n   * @returns return true if indexA, indexB both valid\r\n   */\r\n  public crossProductIndexIndexIndex(originIndex: number, indexA: number, indexB: number, result?: Vector3d): Vector3d | undefined {\r\n    if (this.isValidIndex(originIndex) && this.isValidIndex(indexA) && this.isValidIndex(indexB))\r\n      return Vector3d.createCrossProductToPoints(this.data[originIndex], this.data[indexA], this.data[indexB], result);\r\n    return undefined;\r\n  }\r\n  /**\r\n   * Compute the cross product of vectors from point at originIndex to points at indexA and indexB, and accumulate it to the result.\r\n   * @param origin index of origin\r\n   * @param indexA index of first target within the array\r\n   * @param indexB index of second target within the array\r\n   * @param result caller-allocated vector.\r\n   * @returns return true if indexA, indexB both valid\r\n   */\r\n  public accumulateCrossProductIndexIndexIndex(originIndex: number, indexA: number, indexB: number, result: Vector3d): void {\r\n    const data = this.data;\r\n    if (this.isValidIndex(originIndex) && this.isValidIndex(indexA) && this.isValidIndex(indexB))\r\n      result.addCrossProductToTargetsInPlace(data[originIndex].x, data[originIndex].y, data[originIndex].z, data[indexA].x, data[indexA].y, data[indexA].z, data[indexB].x, data[indexB].y, data[indexB].z);\r\n  }\r\n  /**\r\n   * * compute the cross product from indexed origin t indexed targets targetAIndex and targetB index.\r\n   * * accumulate it to the result.\r\n   */\r\n  public accumulateScaledXYZ(index: number, scale: number, sum: Point3d): void {\r\n    if (this.isValidIndex(index)) {\r\n      const point = this.data[index];\r\n      sum.x += scale * point.x;\r\n      sum.y += scale * point.y;\r\n      sum.z += scale * point.z;\r\n    }\r\n  }\r\n  /**\r\n   * read-only property for number of XYZ in the collection.\r\n   */\r\n  public get length(): number {\r\n    return this.data.length;\r\n  }\r\n  /** push a (clone of) point onto the collection\r\n   * * point itself is not pushed -- xyz data is extracted into the native form of the collection.\r\n   */\r\n  public push(data: Point3d): void {\r\n    this.data.push(data.clone());\r\n  }\r\n  /**\r\n   * push a new point (given by coordinates) onto the collection\r\n   * @param x x coordinate\r\n   * @param y y coordinate\r\n   * @param z z coordinate\r\n   */\r\n  public pushXYZ(x?: number, y?: number, z?: number): void {\r\n    this.data.push(Point3d.create(x === undefined ? 0.0 : x, y === undefined ? 0.0 : y, z === undefined ? 0.0 : z));\r\n  }\r\n  /** extract (copy) the final point */\r\n  public back(result?: Point3d): Point3d | undefined {\r\n    if (this.data.length > 0) {\r\n      return this.data[this.data.length - 1].clone(result);\r\n    }\r\n    return undefined;\r\n  }\r\n  /** extract (copy) the first point */\r\n  public front(result?: Point3d): Point3d | undefined {\r\n    if (this.data.length > 0) {\r\n      return this.data[0].clone(result);\r\n    }\r\n    return undefined;\r\n  }\r\n\r\n  /** remove the final point. */\r\n  public pop(): void {\r\n    if (this.data.length > 0)\r\n      this.data.pop();\r\n  }\r\n  /** remove all points. */\r\n  public clear(): void {\r\n    this.data.length = 0;\r\n  }\r\n  /** Reverse the points in place */\r\n  public reverseInPlace(): void {\r\n    this.data.reverse();\r\n  }\r\n  /**\r\n   * Return distance squared between indicated points.\r\n   * * Concrete classes may be able to implement this without creating a temporary.\r\n   * @param index0 first point index\r\n   * @param index1 second point index\r\n   * @param defaultDistanceSquared distance squared to return if either point index is invalid.\r\n   *\r\n   */\r\n  public distanceSquaredIndexIndex(index0: number, index1: number): number | undefined {\r\n    const n = this.data.length;\r\n    if (index0 >= 0 && index0 < n && index1 >= 0 && index1 < n) {\r\n      return this.data[index0].distanceSquared(this.data[index1]);\r\n    }\r\n    return undefined;\r\n  }\r\n  /**\r\n   * Return distance between indicated points.\r\n   * * Concrete classes may be able to implement this without creating a temporary.\r\n   * @param index0 first point index\r\n   * @param index1 second point index\r\n   * @param defaultDistanceSquared distance squared to return if either point index is invalid.\r\n   */\r\n  public distanceIndexIndex(index0: number, index1: number): number | undefined {\r\n    const n = this.data.length;\r\n    if (index0 >= 0 && index0 < n && index1 >= 0 && index1 < n) {\r\n      return this.data[index0].distance(this.data[index1]);\r\n    }\r\n    return undefined;\r\n  }\r\n  /** Adjust index into range by modulo with the length. */\r\n  public override cyclicIndex(i: number): number {\r\n    return (i % this.length);\r\n  }\r\n\r\n}\r\n"]}