readers.i3s

Indexed 3d Scene Layer (I3S) is a specification created by Esri as a format for their 3D Scene Layer and scene services. The I3S reader handles RESTful webservices in an I3S file structure/format.

Example

This example will download the Autzen dataset from the ArcGIS scene server and output it to a las file. This is done through PDAL’s command line interface or through the pipeline.

[
    {
        "type": "readers.i3s",
        "filename": "https://tiles.arcgis.com/tiles/8cv2FuXuWSfF0nbL/arcgis/rest/services/AUTZEN_LiDAR/SceneServer",
        "obb": {
            "center": [
                636590,
                849216,
                460
            ],
            "halfSize": [
                590,
                281,
                60
            ],
            "quaternion":
            [
                0,
                0,
                0,
                1
            ]
        }
    }
]
pdal translate i3s://https://tiles.arcgis.com/tiles/8cv2FuXuWSfF0nbL/arcgis/rest/services/AUTZEN_LiDAR/SceneServer \
    autzen.las \
    --readers.i3s.threads=64

Options

count

Maximum number of points to read. [Default: unlimited]

override_srs

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. Can’t use with ‘default_srs’ [Default: none]

default_srs

Spatial reference to apply to the data if the input does not specify one. Can be specified as a WKT, proj.4 or EPSG string. Can’t use with ‘override_srs’ [Default: none]

filename

I3S file stored remotely. These must be prefaced with an “i3s://”.

Example remote file: pdal translate i3s://https://tiles.arcgis.com/tiles/arcgis/rest/services/AUTZEN_LiDAR/SceneServer autzen.las

threads

This specifies the number of threads that you would like to use while reading. The default number of threads to be used is 8. This affects the speed at which files are fetched and added to the PDAL view.

Example: --readers.i3s.threads=64

obb

An oriented bounding box used to filter the data being retrieved. The obb is specified as JSON exactly as described by the I3S specification.

dimensions

Comma-separated list of dimensions that should be read. Specify the Esri name, rather than the PDAL dimension name.

Esri

PDAL

INTENSITY

Intensity

CLASS_CODE

ClassFlags

FLAGS

Flag

RETURNS

NumberOfReturns

USER_DATA

UserData

POINT_SRC_ID

PointSourceId

GPS_TIME

GpsTime

SCAN_ANGLE

ScanAngleRank

RGB

Red

Example: --readers.i3s.dimensions="returns, rgb"

min_density and max_density

This is the range of density of the points in the nodes that will be selected during the read. The density of a node is calculated by the vertex count divided by the effective area of the node. Nodes do not have a uniform density across depths in the tree, so some sections may be more or less dense than others. The default values for these parameters will pull all the leaf nodes (the highest resolution).

Example: --readers.i3s.min_density=2 --readers.i3s.max_density=2.5