Untwine is software from Hobu, Inc. for creating Cloud Optimized Point Cloud (COPC) web services from PDAL-readable point cloud data sources.
Untwine is licensed under the GPLv3. Commercial licensing is possible by contacting Hobu, Inc. for pricing.
Untwine is available on conda-forge
(here) and can be installed using conda
conda install -c conda-forge untwine
The following steps will build the untwine
executable:
mkdir build
cd build
cmake ..
make
untwine [options]
untwine -i some_directory_of_input_files -o output_filename
or
untwine --files=some_directory_of_input_files --output_file=output_filename
-
-i
or--files
Input files or directories containing input files. [Required]
-
-o
or--output_dir
Output file. [Required]
-
--help
Usage help
-
--a_srs
Assign an output SRS. Example
--a_srs EPSG:2056
-
--no_srs
Don't read the SLR VLRs. This is only applicable to las files. [Default: false]
-
--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]
-
--progress_fd
File descriptor number of a pipe using the Untwine API to send progress and error messages. [Default: -1]
-
--progress_debug
Set to true to have progress messages written to standard output. Disabled if 'progress_fd' is set to '1'. [Default: false]
-
-s
or-- single_file
Deprecated and ingored. Generate a LAZ file with spatially arranged data and hierarchy information (COPC). [Default: false]