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.

Default Embedded Stage

This stage is enabled by default

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]
count
Maximum number of points to read. [Default: unlimited]
spatialreference
Spatial reference to apply to the data. Overrides any SRS in the input itself. Can be specified as a WKT, proj.4 or EPSG string. [Default: none]
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 file entwine-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.