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)

                                           27 June 2023                                 pkinfo(1)