readers.gdal¶

The GDAL reader reads GDAL readable raster data sources as point clouds.

Each pixel is given an X and Y coordinate (and corresponding PDAL dimensions) that are center pixel, and each band is represented by “band-1”, “band-2”, or “band-n”. The user must know what the bands correspond to, and use filters.ferry to copy data into known dimensions as needed.

Note

filters.ferry is needed because raster data do not map to typical dimension names. For output to formats such as LAS, this mapping is required.

Basic Example¶

<?xml version="1.0"?>
<Pipeline version="1.0">
    <Writer type="writers.text">
        <Option name="filename">
            out.asc
        </Option>
        <Reader type="readers.gdal">
            <Option name="filename">
                /Users/hobu/dev/git/pdal/test/data/autzen/autzen.jpg
            </Option>
        </Reader>
    </Writer>
</Pipeline>

LAS Example¶

The following example writes a JPG as an ASPRS LAS file.

<?xml version="1.0"?>
<Pipeline version="1.0">
    <Writer type="writers.las">
        <Option name="filename">
            out.las
        </Option>
        <Filter type="filters.ferry">
           <Option name="dimensions">
                Red=band-1, Green=band-2, Blue=band-3
            </Option>
        <Reader type="readers.gdal">
            <Option name="filename">
                /Users/hobu/dev/git/pdal/test/data/autzen/autzen.jpg
            </Option>
        </Reader>
    </Filter>
    </Writer>
</Pipeline>

Options¶

filename: GDALOpen’able raster file to read [Required]