xenial (1) pkdumpimg.1.gz

Provided by: pktools_2.6.6-1_amd64 bug

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)

                                                 24 January 2016                                    pkdumpimg(1)