NAME¶

pkdumpimg - program to dump image content to ASCII or STDOUT

SYNOPSIS¶

pkdumpimg
-i input [-o output] [options] [advanced options]

DESCRIPTION¶

pkdumpimg dumps the content of a raster dataset to (standard) output (screen or filename). The default is to dump the output in matrix format. Use -of line to dump each pixel value on a separate line, preceded by its position (x and y value). You can specify a bounding box to dump with either the extent of an OGR vector dataset or via the options -ulx -uly -lrx and -lry.

OPTIONS¶

-i filename, --input filename

input image file

-o filename, --output filename

Output ASCII file (Default is empty: use STDOUT)

-of matrix|line, --oformat matrix|line

Output format (matrix form or list (x,y,z) form). Default is matrix form

-b band, --band band

band index to crop

-e vector, --extent vector

get boundary from extent from polygons in vector file

-ulx value, --ulx value

Upper left x value bounding box (in geocoordinates if georef is true)

-uly value, --uly value

Upper left y value bounding box (in geocoordinates if georef is true)

-lrx value, --lrx value

Lower left x value bounding box (in geocoordinates if georef is true)

-lry value, --lry value

Lower left y value bounding box (in geocoordinates if georef is true)

-v level, --verbose level

verbose (Default: 0)

Advanced options

-dx value, --dx value

Output resolution in x (in meter) (0.0: keep original resolution)

-dy value, --dy value

Output resolution in y (in meter) (0.0: keep original resolution)

-r resampling, --resampling-method resampling

Resampling method (near: nearest neighbour, bilinear: bi-linear interpolation).

-srcnodata value, --srcnodata value

set no data value(s) for input image

-dstnodata value, --dstnodata value

nodata value for output if out of bounds.

EXAMPLE¶

We create a 5x5 raster dataset containing all 0 values except for its center (value=1)

cat input.txt

0 0 0 0 0
0 0 0 0 0
0 0 1 0 0
0 0 0 0 0
0 0 0 0 0
      

Use pkascii2img(1) to create an raster dataset from input.txt

pkascii2img -i input.txt -o output.tif -of GTiff -a_srs epsg:3035 -dx 25 -dy 25 -ulx 1000000 -uly 1000000
      

Dump the image content of output.tif to screen

pkdumpimg -i output.tif
      

SEE ALSO¶

pkascii2img(1)