pkinfo - Report basic information from raster datasets

Description

pkinfo  retrieves  basic information about a raster data set (similar to gdalinfo(1)).  An important dif‐
       ference 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.

Example

       show number of bands in raster image.tifpkinfo-iimage.tif-nb

       show maximum value of band 1 (starting from 0) of raster image.tifpkinfo-iimage.tif-max-b1

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

       pkinfo-iimage.tif-x0-y0-r-b3-b2-b1

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

       pkinfo-iimage.tif-x3528120-y4329681-geo-r-b3-b2-b1

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

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

       pkinfo-iimage1.tif-iimage2.tif-iimage3.tif-b

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

       pkinfo-iimage1.tif--mask0--mask255-ref

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

       pkinfo-iimage.tif $(pkinfo-iimage.tif-c) -geo-r

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

       pkinfo $(for IMAGE in modis_2010*.tif; do pkinfo-i$IMAGE--cover-x4215500-y2534000; done) -x4215500-y253400

Name

       pkinfo - Report basic information from raster datasets

Options

-ifilename, --inputfilename
              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

       -bband, --bandband
              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

       -xvalue, --xposvalue
              x pos

       -yvalue, --yposvalue
              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

       -efilename, --extentfilename
              Gets boundary from vector file

       -ulxULX, --ulxULX
              Upper left x value bounding box

       -ulyULY, --ulyULY
              Upper left y value bounding box

       -lrxLRX, --lrxLRX
              Lower right x value bounding box

       -lryLRY, --lryLRY
              Lower right y value bounding box

       -ot, --otype-d, --description
              Returns image description

       -meta, --meta
              Shows meta data

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