Untwine is software from Hobu, Inc. for creating Entwine Point Tile (EPT) or Cloud Optimized Point Cloud (COPC) web services from PDAL-readable point cloud data sources. It provides an alternative processing approach than the Entwine software, but the output is expected to be compatible EPT/COPC.
Untwine is licensed under the GPLv3. Commercial licensing is possible by contacting Hobu, Inc. for pricing.
The following steps will build the untwine
executable:
mkdir build
cd build
cmake ..
make
docker build -t untwine:latest .
untwine [options]
untwine --files=some_directory --output_dir=output_directory
Or with your previously built local docker image:
docker run -it -v "$PWD":/untwine untwine:latest --files=/untwine/test.laz --output_dir=/untwine/test.ept.copc --single_file --stats
-
files
Input files or directories containing input files. [Required]
-
output_dir
Output directory. [Required]
-
dims
List of dimensions to load. X, Y and Z are always loaded. Limiting the dimensions can speed runtime and reduce temporary disk use.
-
temp_dir
Directory in which to place tiled output. If not provided, temporary files are placed in 'output_dir'/temp.
-
cube
Create a voxel structure where each voxel is a cube. If false, the voxel structure is a rectangular solid that encloses the points. [Default: true]
-
level
Level to use when initially tiling points. If not provided, an initial level is determined from the data. [Default: none].
-
file_limit
Only read 'file_limit' input files even if more exist in the 'files' list. Used primarily for debugging. [Default: no limit]
-
stats
Generate summary statistics in 'ept.json' similar to those produced by Entwine for EPT output Min/max stats are always generated when generating single-file output. [Default: false]
-
single_file
Generate a LAZ file with spatially arranged data and hierarchy information (COPC). [Default: false]