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 to map GDAL output to typical Dimensions names. For output to formats such as LAS, this mapping is required.

## Basic Example¶

Simply writing every pixel of a JPEG to a text file is not very useful.

  1 2 3 4 5 6 7 8 9 10 11 12 { "pipeline":[ { "type":"readers.gdal", "filename":"./pdal/test/data/autzen/autzen.jpg" }, { "type":"writers.text", "filename":"outputfile.txt" } ] } 

## LAS Example¶

The following example assigns the bands from a JPG to the RGB values of an ASPRS LAS file using writers.las.

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 { "pipeline":[ { "type":"readers.gdal", "filename":"./pdal/test/data/autzen/autzen.jpg" }, { "type":"filters.ferry" "dimensions":"band-1=Red, band-2=Green, band-3=Blue", }, { "type":"writers.text", "filename":"outputfile.txt" } ] } 

## Options¶

filename
GDALOpen ‘able raster file to read [Required]