lazts/README.md

TypeScript package for loading LAS/LAZ, primary developed for for WebGL applications, intended for lazy people who just want to load their point clouds and don't care about the details.

# LAZ.ts ⠇⠁⠵

TypeScript package for loading LAS/LAZ, primary developed for for WebGL applications, intended for lazy people who just want to load their point clouds and don't care about the details.

-   ✅ returns a dev-friendly format
-   ✅ internally based on [laz-perf](https://github.com/hobuinc/laz-perf)
-   ✅ supports funky coordinate systems
-   ✅ uses vitest 🧪 for testing

## Install from [npm](https://www.npmjs.com/package/lazts)

```
npm install lazts
```

## Usage

```ts
import { parse } from 'lazts/lazts';

//1) obtain ArrayBuffer somehow
const arrayBuffer = openFileAsArray('testdata/test.las');
//2) parse it
const data: LazData = await parse(arrayBuffer);
```

where `LazData` is defined as

```ts
interface LazData {
    header: {
        pointsOffset: number;
        pointsFormatId: number;
        pointsStructSize: number;
        pointsCount: number;
        scale: [number, number, number];
        offset: [number, number, number];
        maxs: [number, number, number];
        mins: [number, number, number];
        totalToRead: number;
        totalRead: number;
    };
    attributes: {
        position: { value: Int32Array; size: 3 };
        intensity: { value: Float32Array; size: 1 };
        classification: { value: Uint8Array; size: 1 };
        color0?: { value: Uint8Array; size: 4 };
    };
}
```

When working with funky coordinates (e.g. the coordinates are too big and there is no offset), you can use the `adjustOffset` option:

```ts
const dataWithNonZeroOffset = await parse(buffer, {
    adjustOffset: true,
});
```