NAME

pkinfo - Report basic information from raster datasets

SYNOPSIS

pkinfo
-i input [options]

DESCRIPTION

pkinfo retrieves basic information about a raster data set (similar to gdalinfo(1)). An important difference with gdalinfo is that pkinfo only reports the information that is requested via the corresponding command line option, whereas gdalinfo provides all basic information at once. The reported information is in a format that can be used as input for other pktools utilities. This mechanism facilitates command substitution in the bash scripting language.

OPTIONS

-i filename, --input filename

Input image file

-bb, --bbox

Shows bounding box

-te, --te

Shows bounding box in GDAL format: xmin ymin xmax ymax

-c, --center

Image center in projected X,Y coordinates

-ct, --colortable

Shows colour table

-ns, --nsample

Number of samples in image

-nl, --nline

Number of lines in image

-nb, --nband

Show number of bands in image

-b band, --band band

Band specific information

-dx, --dx

Gets resolution in x (in m)

-dy, --dy

Gets resolution in y (in m)

-mm, --minmax

Shows min and max value of the image

-min, --minimum

Shows min value of the image

-max, --maximum

Shows max value of the image

-stats, --statistics

Shows statistics (min,max, mean and stdDev of the image)

-a_srs, --a_srs

Shows projection of the image

-geo, --geo

Gets geotransform

-il, --interleave

-f, --filename

Shows image filename

-cover, --cover

Print filename to STDOUT if current image covers the provided coordinates via bounding box, (x y) coordinates or extent of vector file

-x value, --xpos value

x pos

-y value, --ypos value

y pos

-r, --read

Reads row y (in projected coordinates if geo option is set, otherwise in image coordinates, 0 based)

-ref, --reference

Gets reference pixel (lower left corner of center of gravity pixel)

-of, --oformat

Gets driver description

-e filename, --extent filename

Gets boundary from vector file

-ulx ULX, --ulx ULX

Upper left x value bounding box

-uly ULY, --uly ULY

Upper left y value bounding box

-lrx LRX, --lrx LRX

Lower right x value bounding box

-lry LRY, --lry LRY

Lower right y value bounding box

-ot, --otype

-d, --description

Returns image description

-meta, --meta

Shows meta data

-nodata value, --nodata value

Sets no data value(s) for calculations (nodata values in input image)

EXAMPLE

show number of bands in raster image.tif

pkinfo -i image.tif -nb


      

show maximum value of band 1 (starting from 0) of raster image.tif

pkinfo -i image.tif -max -b 1


      

read (dump) upper left pixel value for bands 3,2,1

pkinfo -i image.tif -x 0 -y 0 -r -b 3 -b 2 -b 1


      

read (dump) pixel value at this geographic location (x,y) for bands 3,2,1

pkinfo -i image.tif -x 3528120 -y 4329681 -geo -r -b 3 -b 2 -b 1


      

show bounding box (-ulx -uly -lrx -lry) in geo coordinates for image1.tif

pkinfo -i image1.tif -b


      

show bounding box (-ulx -uly -lrx -lry) in geo coordinates for each image (and union and intersect)

pkinfo -i image1.tif -i image2.tif -i image3.tif -b


      

show the reference pixel (centre of gravity) for image1.tif, treating 0 and 255 as NO VALUE

pkinfo -i image1.tif --mask 0 --mask 255 -ref


      

read (dump) pixel value at image centre for band 0

pkinfo -i image.tif $(pkinfo -i image.tif -c) -geo -r


      

read (dump) pixel value in band 0 (default) for all images in current directory that cover this geographic location

pkinfo $(for IMAGE in modis_2010*.tif; do pkinfo -i $IMAGE --cover -x 4215500 -y 2534000; done) -x 4215500 -y 253400


      

SEE ALSO

gdalinfo(1)