dhardestylewis/entwine repository overview

⁠Build Status

Entwine is a data organization library for massive point clouds, designed to conquer datasets of hundreds of billions of points as well as desktop-scale point clouds. Entwine can index anything that is PDAL⁠-readable, and can read/write to a variety of sources like S3 or Dropbox. Builds are completely lossless, so no points will be discarded even for terabyte-scale datasets.

Check out the client demos, showcasing Entwine output with Potree⁠, Plas.io⁠, and Cesium⁠ clients.

⁠Usage

Pull the latest version of Entwine using:

docker pull dhardestylewis/entwine

Getting started with Entwine is easy with Docker⁠. First, we can index some public data:

mkdir ~/entwine
docker run -it -v ~/entwine:/entwine dhardestylewis/entwine build \
    -i https://data.entwine.io/red-rocks.laz \
    -o /entwine/red-rocks

Now we have our output at ~/entwine/red-rocks. We could have also passed a directory like -i ~/county-data/ to index multiple files. Now we can statically serve ~/entwine with a simple HTTP server:

docker run -it -v ~/entwine:/var/www -p 8080:8080 connormanning/http-server

And view the data with Potree⁠ and Plasio⁠.

To view the data in Cesium⁠, see the EPT Tools⁠ project.

⁠Going further

For detailed information about how to configure your builds, check out the configuration documentation⁠. Here, you can find information about reprojecting your data, using configuration files and templates, enabling S3 capabilities, producing Cesium 3D Tiles⁠ output, and all sorts of other settings.

To learn about the Entwine Point Tile file format produced by Entwine, see the file format documentation⁠.