readers.ept¶
Entwine Point Tile (EPT) is a hierarchical octree-based point cloud format suitable for real-time rendering and lossless archival. Entwine is a producer of this format. The EPT Reader supports reading data from the EPT format, including spatially accelerated queries and file reconstruction queries.
Sample EPT datasets of hundreds of billions of points in size may be viewed at http://potree.entwine.io and http://speck.ly.
Example¶
This example downloads a small area around the the Statue of Liberty from the New York City data set (4.7 billion points) which can be viewed in its entirety in Potree or Plasio.
{
"pipeline": [
{
"type": "readers.ept",
"filename": "http://na.entwine.io/nyc",
"bounds": "([-8242669, -8242529], [4966549, 4966674])"
},
"statue-of-liberty.las"
]
}
Options¶
- filename
- EPT resource from which to read. Because EPT resources do not have a file extension, to specify an EPT resource as a string, it must be prefixed with
ept://
. For example,pdal translate ept://http://na.entwine.io/autzen autzen.laz
. [Required] - bounds
- The extents of the resource to select in 2 or 3 dimensions, expressed as a string, e.g.:
([xmin, xmax], [ymin, ymax], [zmin, zmax])
. If omitted, the entire dataset will be selected. - origin
EPT datasets are lossless aggregations of potentially multiple source files. The origin options can be used to select all points from a single source file. This option may be specified as a string or an integral ID.
The string form of this option selects a source file by its original file path. This may be a substring instead of the entire path, but the string must uniquely select only one source file (via substring search). For example, for an EPT dataset created from source files one.las, two.las, and two.bpf, “one” is a sufficient selector, but “two” is not.
The integral form of this option selects a source file by its
OriginId
dimension, which can be found via the files position in EPT metadata fileentwine-files.json
.- threads
- Number of worker threads used to download and process EPT data. A minimum of 4 will be used no matter what value is specified.