@loaders.gl/potree 4.3.0-alpha.4 → 4.3.0-alpha.6

package/dist/parsers/parse-potree-hierarchy-chunk.js

@@ -1,12 +1,20 @@
 // This file is derived from the Cesium code base under BSD 2-clause license
 // See LICENSE.md and https://github.com/potree/potree/blob/develop/LICENSE
-// type POTreeTileNode = POTreeNode;
-// load hierarchy
+/**
+ * load hierarchy
+ * @param arrayBuffer - binary index data
+ * @returns root node
+ **/
 export function parsePotreeHierarchyChunk(arrayBuffer) {
     const tileHeaders = parseBinaryChunk(arrayBuffer);
     return buildHierarchy(tileHeaders);
 }
-// Parses the binary rows
+/**
+ * Parses the binary rows
+ * @param arrayBuffer - binary index data to parse
+ * @param byteOffset - byte offset to start from
+ * @returns flat nodes array
+ * */
 function parseBinaryChunk(arrayBuffer, byteOffset = 0) {
     const dataView = new DataView(arrayBuffer);
     const stack = [];
@@ -15,7 +23,7 @@ function parseBinaryChunk(arrayBuffer, byteOffset = 0) {
     const topTileHeader = {};
     byteOffset = decodeRow(dataView, byteOffset, topTileHeader);
     stack.push(topTileHeader);
-    const tileHeaders = [];
+    const tileHeaders = [topTileHeader];
     while (stack.length > 0) {
         const snode = stack.shift();
         let mask = 1;
@@ -25,7 +33,6 @@ function parseBinaryChunk(arrayBuffer, byteOffset = 0) {
                 const tileHeader = {};
                 byteOffset = decodeRow(dataView, byteOffset, tileHeader);
                 tileHeader.name = snode.name + i;
-                // @ts-expect-error
                 stack.push(tileHeader);
                 tileHeaders.push(tileHeader);
                 snode.header.childCount++;
@@ -38,6 +45,13 @@ function parseBinaryChunk(arrayBuffer, byteOffset = 0) {
     }
     return tileHeaders;
 }
+/**
+ * Reads next row from binary index file
+ * @param dataView - index data
+ * @param byteOffset - current offset in the index data
+ * @param tileHeader - container to read to
+ * @returns new offset
+ */
 function decodeRow(dataView, byteOffset, tileHeader) {
     tileHeader.header = tileHeader.header || {};
     tileHeader.header.childMask = dataView.getUint8(byteOffset);
@@ -47,31 +61,31 @@ function decodeRow(dataView, byteOffset, tileHeader) {
     byteOffset += 5;
     return byteOffset;
 }
-// Resolves the binary rows into a hierarchy (tree structure)
-function buildHierarchy(tileHeaders, options = {}) {
+/** Resolves the binary rows into a hierarchy (tree structure) */
+function buildHierarchy(flatNodes, options = {}) {
     const DEFAULT_OPTIONS = { spacing: 100 }; // TODO assert instead of default?
     options = { ...DEFAULT_OPTIONS, ...options };
-    const topNode = tileHeaders[0];
+    const topNode = flatNodes[0];
     const nodes = {};
-    for (const tileHeader of tileHeaders) {
-        const { name } = tileHeader;
+    for (const node of flatNodes) {
+        const { name } = node;
         const index = parseInt(name.charAt(name.length - 1), 10);
         const parentName = name.substring(0, name.length - 1);
         const parentNode = nodes[parentName];
         const level = name.length - 1;
         // assert(parentNode && level >= 0);
-        tileHeader.level = level;
-        tileHeader.hasChildren = tileHeader.header.childCount;
-        tileHeader.children = [];
-        tileHeader.childrenByIndex = new Array(8).fill(null);
-        tileHeader.spacing = (options?.spacing || 0) / Math.pow(2, level);
+        node.level = level;
+        node.hasChildren = Boolean(node.header.childCount);
+        node.children = [];
+        node.childrenByIndex = new Array(8).fill(null);
+        node.spacing = (options?.spacing || 0) / Math.pow(2, level);
         // tileHeader.boundingVolume = Utils.createChildAABB(parentNode.boundingBox, index);
         if (parentNode) {
-            parentNode.children.push(tileHeader);
-            parentNode.childrenByIndex[index] = tileHeader;
+            parentNode.children.push(node);
+            parentNode.childrenByIndex[index] = node;
         }
         // Add the node to the map
-        nodes[name] = tileHeader;
+        nodes[name] = node;
     }
     // First node is the root
     return topNode;

package/dist/potree-hierarchy-chunk-loader.d.ts

@@ -4,12 +4,17 @@ import type { POTreeNode } from "./parsers/parse-potree-hierarchy-chunk.js";
 export declare const PotreeHierarchyChunkLoader: {
     readonly dataType: POTreeNode;
     readonly batchType: never;
-    readonly id: "potree";
     readonly name: "potree Hierarchy Chunk";
+    readonly id: "potree-hrc";
+    readonly module: "potree";
+    readonly version: any;
     readonly extensions: ["hrc"];
     readonly mimeTypes: ["application/octet-stream"];
     readonly parse: (arrayBuffer: ArrayBuffer, options: POTreeLoaderOptions | undefined) => Promise<POTreeNode>;
     readonly parseSync: (arrayBuffer: ArrayBuffer, options: POTreeLoaderOptions | undefined) => POTreeNode;
+    readonly options: {
+        readonly potree: {};
+    };
     readonly binary: true;
 };
 //# sourceMappingURL=potree-hierarchy-chunk-loader.d.ts.map

package/dist/potree-hierarchy-chunk-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"potree-hierarchy-chunk-loader.d.ts","sourceRoot":"","sources":["../src/potree-hierarchy-chunk-loader.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,mBAAmB,EAAC,2BAAwB;AACzD,OAAO,KAAK,EAAC,UAAU,EAAC,kDAA+C;AAGvE,oCAAoC;AAEpC,eAAO,MAAM,0BAA0B;;;;;;;;;;CAcsC,CAAC"}
+{"version":3,"file":"potree-hierarchy-chunk-loader.d.ts","sourceRoot":"","sources":["../src/potree-hierarchy-chunk-loader.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,mBAAmB,EAAC,2BAAwB;AACzD,OAAO,KAAK,EAAC,UAAU,EAAC,kDAA+C;AAOvE,oCAAoC;AACpC,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;CAkBsC,CAAC"}

package/dist/potree-hierarchy-chunk-loader.js

@@ -2,19 +2,25 @@
 // SPDX-License-Identifier: MIT
 // Copyright vis.gl contributors
 import { parsePotreeHierarchyChunk } from "./parsers/parse-potree-hierarchy-chunk.js";
+// __VERSION__ is injected by babel-plugin-version-inline
+// @ts-ignore TS2304: Cannot find name '__VERSION__'.
+const VERSION = typeof "4.3.0-alpha.5" !== 'undefined' ? "4.3.0-alpha.5" : 'latest';
 /** Potree hierarchy chunk loader */
-// @ts-ignore not a valid loader
 export const PotreeHierarchyChunkLoader = {
     dataType: null,
     batchType: null,
-    id: 'potree',
     name: 'potree Hierarchy Chunk',
+    id: 'potree-hrc',
+    module: 'potree',
+    version: VERSION,
     extensions: ['hrc'],
     mimeTypes: ['application/octet-stream'],
     // binary potree files have no header bytes, no content test function possible
     // test: ['...'],
     parse: async (arrayBuffer, options) => parsePotreeHierarchyChunk(arrayBuffer),
     parseSync: (arrayBuffer, options) => parsePotreeHierarchyChunk(arrayBuffer),
+    options: {
+        potree: {}
+    },
     binary: true
-    // @ts-ignore
 };

package/dist/potree-loader.d.ts

@@ -6,13 +6,14 @@ export type POTreeLoaderOptions = LoaderOptions & {
 export declare const PotreeLoader: {
     readonly dataType: any;
     readonly batchType: never;
-    readonly name: "potree";
+    readonly name: "potree metadata";
     readonly id: "potree";
     readonly module: "potree";
     readonly version: any;
-    readonly extensions: ["json"];
+    readonly extensions: ["js"];
     readonly mimeTypes: ["application/json"];
     readonly testText: (text: string) => boolean;
+    readonly parse: (data: ArrayBuffer) => any;
     readonly parseTextSync: (text: string) => any;
     readonly options: {
         readonly potree: {};

package/dist/potree-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"potree-loader.d.ts","sourceRoot":"","sources":["../src/potree-loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAmB,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAM9E,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG;IAChD,MAAM,CAAC,EAAE,EAAE,CAAC;CACb,CAAC;AAEF,oBAAoB;AAEpB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;CAgB6C,CAAC"}
+{"version":3,"file":"potree-loader.d.ts","sourceRoot":"","sources":["../src/potree-loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAmB,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAM9E,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG;IAChD,MAAM,CAAC,EAAE,EAAE,CAAC;CACb,CAAC;AAEF,oBAAoB;AACpB,eAAO,MAAM,YAAY;;;;;;;;;;2BAWT,WAAW;;;;;CAK2C,CAAC"}

package/dist/potree-loader.js

@@ -3,22 +3,21 @@
 // Copyright vis.gl contributors
 // __VERSION__ is injected by babel-plugin-version-inline
 // @ts-ignore TS2304: Cannot find name '__VERSION__'.
-const VERSION = typeof "4.3.0-alpha.3" !== 'undefined' ? "4.3.0-alpha.3" : 'latest';
+const VERSION = typeof "4.3.0-alpha.5" !== 'undefined' ? "4.3.0-alpha.5" : 'latest';
 /** Potree loader */
-// @ts-ignore
 export const PotreeLoader = {
     dataType: null,
     batchType: null,
-    name: 'potree',
+    name: 'potree metadata',
     id: 'potree',
     module: 'potree',
     version: VERSION,
-    extensions: ['json'],
+    extensions: ['js'],
     mimeTypes: ['application/json'],
     testText: (text) => text.indexOf('octreeDir') >= 0,
+    parse: (data) => JSON.parse(new TextDecoder().decode(data)),
     parseTextSync: (text) => JSON.parse(text),
     options: {
         potree: {}
     }
-    // @ts-ignore
 };

package/dist/potree-source.d.ts

@@ -0,0 +1,22 @@
+import { PotreeNodesSource, PotreeNodesSourceProps } from "./lib/potree-node-source.js";
+/**
+ * Creates point cloud data sources for Potree urls
+ */
+export declare const PotreeSource: {
+    readonly name: "Potree";
+    readonly id: "potree";
+    readonly module: "potree";
+    readonly version: "1.7";
+    readonly extensions: ["bin", "las", "laz"];
+    readonly mimeTypes: ["application/octet-stream"];
+    readonly options: {
+        readonly url: never;
+        readonly potree: {};
+    };
+    readonly type: "potree";
+    readonly fromUrl: true;
+    readonly fromBlob: true;
+    readonly testURL: (url: string) => boolean;
+    readonly createDataSource: (url: string | Blob, props: PotreeNodesSourceProps) => PotreeNodesSource;
+};
+//# sourceMappingURL=potree-source.d.ts.map

package/dist/potree-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"potree-source.d.ts","sourceRoot":"","sources":["../src/potree-source.ts"],"names":[],"mappings":"AAKA,OAAO,EAAC,iBAAiB,EAAE,sBAAsB,EAAC,oCAAiC;AAInF;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;4BAYR,MAAM;qCACG,MAAM,GAAG,IAAI,SAAS,sBAAsB;CAEA,CAAC"}

package/dist/potree-source.js

@@ -0,0 +1,22 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { PotreeNodesSource } from "./lib/potree-node-source.js";
+const VERSION = '1.7';
+/**
+ * Creates point cloud data sources for Potree urls
+ */
+export const PotreeSource = {
+    name: 'Potree',
+    id: 'potree',
+    module: 'potree',
+    version: VERSION,
+    extensions: ['bin', 'las', 'laz'],
+    mimeTypes: ['application/octet-stream'],
+    options: { url: undefined, potree: {} },
+    type: 'potree',
+    fromUrl: true,
+    fromBlob: true,
+    testURL: (url) => url.endsWith('.js'),
+    createDataSource: (url, props) => new PotreeNodesSource(url, props)
+};

package/dist/types/potree-metadata.d.ts

@@ -0,0 +1,88 @@
+/** Bounding box */
+export interface PotreeBoundingBox {
+    /** Min X */
+    lx: number;
+    /** Min Y */
+    ly: number;
+    /** Min Z */
+    lz: number;
+    /** Max X */
+    ux: number;
+    /** Max Y */
+    uy: number;
+    /** Max Z */
+    uz: number;
+}
+/** Attribute types for *.bin content */
+export type PotreeAttribute = 
+/** 3 (uint32) numbers: x, y, z */
+'POSITION_CARTESIAN'
+/** 4 x (uint8) numbers for the color: r, g, b, a */
+ | 'RGBA_PACKED'
+/** 4 x (uint8) numbers for the color: r, g, b, a */
+ | 'COLOR_PACKED'
+/** 3 x (uint8) numbers for the color: r, g, b */
+ | 'RGB_PACKED'
+/** 3 x (float) numbers: x', y', z'  */
+ | 'NORMAL_FLOATS'
+/** (uint8) number */
+ | 'FILLER_1B'
+/** (uint16) number specifying the point's intensity */
+ | 'INTENSITY'
+/** (uint8) id for the class used */
+ | 'CLASSIFICATION'
+/** Note: might need to be revisited, best don't use */
+ | 'NORMAL_SPHEREMAPPED'
+/** Note: might need to be revisited, best don't use */
+ | 'NORMAL_OCT16'
+/** 3 x (float) numbers: x', y', z' */
+ | 'NORMAL';
+/** Hierarchy item: [node name leading with 'r', points count
+ * @example [r043, 145]
+] */
+export type HierarchyItem = [string, number];
+/**
+ * Potree data set format metadata (cloud.js)
+ * @version 1.7
+ * @link https://github.com/potree/potree/blob/1.7/docs/potree-file-format.md
+ * */
+export interface PotreeMetadata {
+    /** Version number in which this file is written */
+    version: string;
+    /** Folder that is used to load additional data */
+    octreeDir: string;
+    /** Amount of points contained in the whole pointcloud data */
+    points: number;
+    /**
+     * This parameter is used to transform the point data
+     * to the projection system used while visualizing the points. It has to be
+     * in a format that is parsable by [proj.4][proj4].
+     * */
+    projection: string;
+    /** Bounding box of the world used to limit the initial POV. */
+    boundingBox: PotreeBoundingBox;
+    /** Bounding box of the actual points in the data */
+    tightBoundingBox: PotreeBoundingBox;
+    /** Description of point attributes in data files */
+    pointAttributes: 'LAS' | 'LAZ' | PotreeAttribute[];
+    /**
+     * Space between points at the root node.
+     * This value is halved at each octree level.
+     * */
+    spacing: number;
+    /**
+     * Scale applied to convert POSITION_CARTESIAN components
+     * from uint32 values to floating point values. The full transformation
+     * to world coordinates is
+     * position = (POSITION_CARTESIAN * scale) + boundingBox.min
+     * */
+    scale: number;
+    /** Amount of Octree levels before a new folder hierarchy is expected. */
+    hierarchyStepSize: number;
+    /**
+     * The hierarchy of files, now loaded through index files.
+     * @deprecated
+     * */
+    hierarchy: HierarchyItem[];
+}
+//# sourceMappingURL=potree-metadata.d.ts.map

package/dist/types/potree-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"potree-metadata.d.ts","sourceRoot":"","sources":["../../src/types/potree-metadata.ts"],"names":[],"mappings":"AAIA,mBAAmB;AACnB,MAAM,WAAW,iBAAiB;IAChC,YAAY;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,YAAY;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,YAAY;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,YAAY;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,YAAY;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,YAAY;IACZ,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,wCAAwC;AACxC,MAAM,MAAM,eAAe;AACzB,kCAAkC;AAChC,oBAAoB;AACtB,oDAAoD;GAClD,aAAa;AACf,oDAAoD;GAClD,cAAc;AAChB,iDAAiD;GAC/C,YAAY;AACd,uCAAuC;GACrC,eAAe;AACjB,qBAAqB;GACnB,WAAW;AACb,uDAAuD;GACrD,WAAW;AACb,oCAAoC;GAClC,gBAAgB;AAClB,uDAAuD;GACrD,qBAAqB;AACvB,uDAAuD;GACrD,cAAc;AAChB,sCAAsC;GACpC,QAAQ,CAAC;AAEb;;IAEI;AACJ,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE7C;;;;KAIK;AACL,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC;IACf;;;;SAIK;IACL,UAAU,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,WAAW,EAAE,iBAAiB,CAAC;IAC/B,oDAAoD;IACpD,gBAAgB,EAAE,iBAAiB,CAAC;IACpC,oDAAoD;IACpD,eAAe,EAAE,KAAK,GAAG,KAAK,GAAG,eAAe,EAAE,CAAC;IACnD;;;SAGK;IACL,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;SAKK;IACL,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,iBAAiB,EAAE,MAAM,CAAC;IAC1B;;;SAGK;IACL,SAAS,EAAE,aAAa,EAAE,CAAC;CAC5B"}

package/dist/types/potree-metadata.js

@@ -0,0 +1,4 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+export {};

package/dist/utils/parse-version.d.ts

@@ -0,0 +1,5 @@
+export declare function parseVersion(version: string): {
+    major: number;
+    minor: number;
+};
+//# sourceMappingURL=parse-version.d.ts.map

package/dist/utils/parse-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-version.d.ts","sourceRoot":"","sources":["../../src/utils/parse-version.ts"],"names":[],"mappings":"AAIA,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAC,CAG5E"}

package/dist/utils/parse-version.js

@@ -0,0 +1,7 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+export function parseVersion(version) {
+    const parts = version.split('.').map(Number);
+    return { major: parts[0], minor: parts[1] };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loaders.gl/potree",
-  "version": "4.3.0-alpha.4",
+  "version": "4.3.0-alpha.6",
   "description": "potree loaders for large point clouds.",
   "license": "MIT",
   "type": "module",
@@ -44,11 +44,13 @@
     "build-bundle-dev": "ocular-bundle ./bundle.ts --env=dev --output=dist/dist.dev.js"
   },
   "dependencies": {
-    "@loaders.gl/math": "4.3.0-alpha.4",
+    "@loaders.gl/las": "4.3.0-alpha.6",
+    "@loaders.gl/math": "4.3.0-alpha.6",
+    "@loaders.gl/schema": "4.3.0-alpha.6",
     "@math.gl/core": "^4.0.0"
   },
   "peerDependencies": {
     "@loaders.gl/core": "^4.0.0"
   },
-  "gitHead": "4900ac4c4de20366c050b80cef04dc5b52d167af"
+  "gitHead": "315f2e232fc4e6a477c41de800a54d3e3d957e8c"
 }

package/src/index.ts

@@ -1,3 +1,4 @@
 export {PotreeLoader} from './potree-loader';
 export {PotreeHierarchyChunkLoader} from './potree-hierarchy-chunk-loader';
 export {PotreeBinLoader} from './potree-bin-loader';
+export {PotreeSource} from './potree-source';

package/src/lib/potree-node-source.ts

@@ -0,0 +1,174 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+import {load} from '@loaders.gl/core';
+import {MeshGeometry} from '@loaders.gl/schema';
+import {DataSource, DataSourceProps, LoaderOptions, resolvePath} from '@loaders.gl/loader-utils';
+import {LASLoader} from '@loaders.gl/las';
+import {PotreeMetadata} from '../types/potree-metadata';
+import {POTreeNode} from '../parsers/parse-potree-hierarchy-chunk';
+import {PotreeHierarchyChunkLoader} from '../potree-hierarchy-chunk-loader';
+import {PotreeLoader} from '../potree-loader';
+import {parseVersion} from '../utils/parse-version';
+
+export type PotreeNodesSourceProps = DataSourceProps & {
+  attributions?: string[];
+  potree?: {
+    loadOptions?: LoaderOptions; // PotreeLoaderOptions;
+    // TODO - add options here
+  };
+};
+
+/**
+ * A Potree data source
+ * @version 1.0 - https://github.com/potree/potree/blob/1.0RC/docs/file_format.md
+ * @version 1.7 - https://github.com/potree/potree/blob/1.7/docs/potree-file-format.md
+ * @note Point cloud nodes tile source
+ */
+export class PotreeNodesSource extends DataSource {
+  /** Dataset base URL */
+  baseUrl: string = '';
+  /** Input data: string - dataset url, blob - single file data */
+  data: string | Blob;
+  /** Input props */
+  props: PotreeNodesSourceProps;
+  /** Meta information from `cloud.js` */
+  metadata: PotreeMetadata | null = null;
+  /** Root node */
+  root: POTreeNode | null = null;
+  /** Is data source ready to use after initial loading */
+  isReady = false;
+
+  private initPromise: Promise<void> | null = null;
+
+  /**
+   * @constructor
+   * @param data  - if string - data set path url or path to `cloud.js` metadata file
+   *              - if Blob - single file data
+   * @param props - data source properties
+   */
+  constructor(data: string | Blob, props: PotreeNodesSourceProps) {
+    super(props);
+    this.props = props;
+    this.data = data;
+    this.makeBaseUrl(this.data);
+
+    this.initPromise = this.init();
+  }
+
+  /** Initial data source loading */
+  async init() {
+    if (this.initPromise) {
+      await this.initPromise;
+      return;
+    }
+    this.metadata = await load(`${this.baseUrl}/cloud.js`, PotreeLoader);
+    await this.loadHierarchy();
+    this.isReady = true;
+  }
+
+  /** Is data set supported */
+  isSupported(): boolean {
+    const {minor, major} = parseVersion(this.metadata?.version ?? '');
+    return (
+      this.isReady &&
+      major === 1 &&
+      minor < 2 &&
+      typeof this.metadata?.pointAttributes === 'string' &&
+      ['LAS', 'LAZ'].includes(this.metadata?.pointAttributes)
+    );
+  }
+
+  /** Get content files extension */
+  getContentExtension(): string | null {
+    if (!this.isReady) {
+      return null;
+    }
+    switch (this.metadata?.pointAttributes) {
+      case 'LAS':
+        return 'las';
+      case 'LAZ':
+        return 'laz';
+      default:
+        return 'bin';
+    }
+  }
+
+  /**
+   * Load octree node content
+   * @param path array of numbers between 0-7 specifying successive octree divisions.
+   * @return node content geometry or null if the node doesn't exist
+   */
+  async loadNodeContent(path: number[]): Promise<MeshGeometry | null> {
+    await this.initPromise;
+
+    if (!this.isSupported()) {
+      return null;
+    }
+
+    const isAvailable = await this.isNodeAvailable(path);
+    if (isAvailable) {
+      return load(
+        `${this.baseUrl}/${this.metadata
+          ?.octreeDir}/r/r${path.join()}.${this.getContentExtension()}`,
+        LASLoader
+      );
+    }
+    return null;
+  }
+
+  /**
+   * Check if a node exists in the octree
+   * @param path array of numbers between 0-7 specifying successive octree divisions
+   * @returns true - the node does exist, false - the nodes doesn't exist
+   */
+  async isNodeAvailable(path: number[]): Promise<boolean> {
+    if (this.metadata?.hierarchy) {
+      return this.metadata.hierarchy.findIndex((item) => item[0] === `r${path.join()}`) !== -1;
+    }
+
+    if (!this.root) {
+      return false;
+    }
+    let currentParent = this.root;
+    let name = '';
+    let result = true;
+    for (const nodeLevel of path) {
+      const newName = `${name}${nodeLevel}`;
+      const node = currentParent.children.find((child) => child.name === newName);
+      if (node) {
+        currentParent = node;
+        name = newName;
+      } else {
+        result = false;
+        break;
+      }
+    }
+    return result;
+  }
+
+  /**
+   * Load data source hierarchy into tree of available nodes
+   */
+  private async loadHierarchy(): Promise<void> {
+    this.root = await load(
+      `${this.baseUrl}/${this.metadata?.octreeDir}/r/r.hrc`,
+      PotreeHierarchyChunkLoader
+    );
+  }
+
+  /**
+   * Deduce base url from the input url sring
+   * @param data - data source input data
+   */
+  private makeBaseUrl(data: string | Blob): void {
+    this.baseUrl = typeof data === 'string' ? resolvePath(data) : '';
+    if (this.baseUrl.endsWith('cloud.js')) {
+      this.baseUrl = this.baseUrl.substring(0, -8);
+    }
+    if (this.baseUrl.endsWith('/')) {
+      this.baseUrl = this.baseUrl.substring(0, -1);
+    }
+  }
+}