User Tools

Site Tools


wiki:pkinfo

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

wiki:pkinfo [2017/12/05 22:53] (current)
Line 1: Line 1:
 +====== pkinfo ======
 +NAME
 +   ​pkinfo - get information from raster file
  
 +SYNOPSIS
 +<code bash>
 +   ​pkinfo -i imagefile [OPTION]
 +</​code>​
 +       
 +DESCRIPTION
 +   Get specific information from raster file similar to gdalinfo, option driven
 +
 +OPTIONS
 +<code bash> ​      
 +   ​-i ​    ​--input ​               input image file (default: <empty string>)
 +   ​-bb ​   --bbox ​                show bounding box  (default: false)
 +   ​-te ​   --te                   show bounding box in GDAL format: xmin ymin xmax ymax  (default: false)
 +   ​-c ​    ​--centre ​              Image centre in projected X,Y coordinates ​ (default: false)
 +   ​-ct ​   --colourtable ​         show colour table  (default: false)
 +   ​-s ​    ​--samples ​             Number of samples in image  (default: false)
 +   ​-l ​    ​--lines ​               Number of lines in image  (default: false)
 +   ​-nb ​   --nband ​               Show number of bands in image (default: false)
 +   ​-b ​    ​--band ​                Band specific information (default: 0)
 +   ​-dx ​   --dx                   get resolution in x (in m) (default: false)
 +   ​-dy ​   --dy                   get resolution in y (in m) (default: false)
 +   ​-mm ​   --minmax ​              Show min and max value of the image  (default: false)
 +   ​-stat ​  ​--stat ​                Show statistics (min,max, mean and stdDev of the image  (default: false)
 +   ​-m ​    ​--min ​                 Show min value of the image (or set minimum for histogram) (default: 0)
 +   ​-M ​    ​--max ​                 Show max value of the image (or set maximum for histogram) (default: 0)
 +   ​-rel ​  ​--rel ​                 Calculate relative histogram in percentage (default: false)
 +   ​-p ​    ​--projection ​          Show projection of the image  (default: false)
 +   ​-geo ​  ​--geo ​                 get geotransform: ​  ​(default:​ false)
 +   ​-il ​   --interleave ​          Show interleave ​ (default: false)
 +   ​-f ​    ​--filename ​            Image filename ​ (default: false)
 +   ​-cov ​  ​--cover ​               Image covers bounding box (or x and y pos) if printed to std out  (default: false)
 +   ​-x ​    ​--xpos ​                x pos (default: -1)
 +   ​-y ​    ​--ypos ​                y pos (default: -1)
 +   ​-r ​    ​--read ​                read row y (in projected coordinates if geo option is set, otherwise in image coordinates,​ 0 based) (default: false)
 +   ​-ref ​  ​--ref ​                 get reference pixel (lower left corner of centre of gravity pixel) (default: false)
 +   ​-of ​   --oformat ​             get driver description ​ (default: false)
 +   ​-e ​    ​--extent ​              get boundary from extent from polygons in vector file (default: <empty string>)
 +   ​-ulx ​  ​--ulx ​                 Upper left x value bounding box (0) (default: 0)
 +   ​-uly ​  ​--uly ​                 Upper left y value bounding box (0) (default: 0)
 +   ​-lrx ​  ​--lrx ​                 Lower right x value bounding box (0) (default: 0)
 +   ​-lry ​  ​--lry ​                 Lower right y value bounding box (0) (default: 0)
 +   ​-hist ​  ​--hist ​                ​Calculate histogram. Use --rel for a relative histogram output. ​ (default: false)
 +   ​-nbin ​  ​--nbin ​                ​Number of bins used in histogram. Use 0 for all input values as integers (default: 0)
 +   ​-ot ​   --otype ​               Return data type (default: false)
 +   ​-d ​    ​--description ​         Return image description (default: false)
 +   ​-meta ​  ​--meta ​                Show meta data  (default: false)
 +   ​-mask ​  ​--mask ​                mask value(s) for no data to calculate reference pixel in image (default: 0)
 +</​code>​
 +====== Examples ======
 +
 +<code bash>
 +pkinfo -i image.tif -nb                          #show number of bands in raster image.tif
 +
 +pkinfo -i image.tif -max -b 1                    #show maximum value of band 1 (starting from 0) of raster image.tif
 +
 +pkinfo -i image.tif -x 0 -y 0 -r -b 3 -b 2 -b 1  #read (dump) upper left pixel value for bands 3,2,1
 +
 +pkinfo -i image.tif -x 3528120 -y 4329681 -geo -r -b 3 -b 2 -b 1  #read (dump) pixel value at this geographic location (x,y) for bands 3,2,1
 +
 +pkinfo -i image1.tif -bb  #show bounding box (-ulx -uly -lrx -lry) in geo coordinates for image1.tif
 +
 +pkinfo -i image1.tif -i image2.tif -i image3.tif -bb  #show bounding box (-ulx -uly -lrx -lry) in geo coordinates for each image (and union and intersect)
 +
 +pkinfo -i image1.tif --mask 0 --mask 255 -ref  #show the refence pixel (centre of gravity) for image1.tif, treating 0 and 255 as NO VALUE
 +</​code>​
 +===== Advanced examples =====
 +
 +<code bash>
 +pkinfo -i image.tif $(pkinfo -i image.tif -c)  #read (dump) pixel value at image centre for band 0
 +
 +pkinfo $(for IMAGE in *.tif; do pkinfo -i $IMAGE --cover -x 3528120 -y 4329681;​done) -x 3528120 -y 4329681 -geo -r  #read (dump) pixel value in band 0 (default) for all images in current directory that cover this geographic location  ​
 +</​code>​
wiki/pkinfo.txt ยท Last modified: 2017/12/05 22:53 (external edit)