pkextractimg(1)

NAME
pkextractimg - extract pixel values from raster image using a raster sample

SYNOPSIS
\FCpkextractimg\F[]
\FC-i\F[] input [\FC-s\F[] sample] \FC-o\F[] output [options]

DESCRIPTION
pkextractimg extracts pixel values from an input raster dataset, based on the locations you provide via a sample file. The sample should be a raster dataset with categorical (integer) values. The typical use case is a land cover map that overlaps the input raster dataset. The utility then extracts pixels from the input raster for the respective land cover classes. To select a random subset of the sample raster dataset you can set the threshold option \FC-t\F[] with a percentage value. You can provide a threshold value for each class (e.g. \FC-t\F[] 80 \FC-t\F[] 60). Use value 100 to select all pixels for selected class(es). As output, a new copy of the vector file is created with an extra attribute for the extracted pixel value. For each raster band in the input image, a separate attribute is created. For instance, if the raster dataset contains three bands, three attributes are created (b0, b1 and b2).

OPTIONS

\FC-i\F[] filename, \FC--input\F[] filename
    Raster input dataset containing band information

\FC-s\F[] sample, \FC--sample\F[] sample
    Raster dataset with categorical values to sample the input raster dataset. Output will contain features with input band information included.

\FC-ln\F[] layer, \FC--ln\F[] layer
    Layer name(s) in sample (leave empty to select all)

\FC-rand\F[] number, \FC--random\F[] number
    Create simple random sample of points. Provide number of points to generate

\FC-grid\F[] size, \FC--grid\F[] size
    Create systematic grid of points. Provide cell grid size (in projected units, e.g,. m)

\FC-o\F[] filename, \FC--output\F[] filename
    Output sample dataset

\FC-c\F[] class, \FC--class\F[] class
    Class(es) to extract from input sample image. Leave empty to extract all valid data pixels from sample dataset. Make sure to set classes if rule is set to mode, proportion or count.

\FC-t\F[] threshold, \FC--threshold\F[] threshold
    Probability threshold for selecting samples (randomly). Provide probability in percentage (>0) or absolute (<0). Use a single threshold per vector sample layer. If using raster land cover maps as a sample dataset, you can provide a threshold value for each class (e.g. \FC-t\F[] 80 \FC-t\F[] 60). Use value 100 to select all pixels for selected class(es)

\FC-f\F[] format, \FC--f\F[] format
    Output sample dataset format

\FC-ft\F[] fieldType, \FC--ftype\F[] fieldType
    Field type (only Real or Integer)

\FC-lt\F[] labelType, \FC--ltype\F[] labelType
    Label type: In16 or String

\FC-b\F[] band, \FC--band\F[] band
    Band index(es) to extract. Leave empty to use all bands

\FC-sband\F[] band, \FC--startband\F[] band
    Start band sequence number

\FC-eband\F[] band, \FC--endband\F[] band
    End band sequence number

\FC-bndnodata\F[] band, \FC--bndnodata\F[] band
    Band(s) in input image to check if pixel is valid (used for srcnodata)

\FC-srcnodata\F[] value, \FC--srcnodata\F[] value
    Invalid value(s) for input image

\FC-bn\F[] attribute, \FC--bname\F[] attribute
    For single band input data, this extra attribute name will correspond to the raster values. For multi-band input data, multiple attributes with this prefix will be added (e.g. b0, b1, b2, etc.)

\FC-cn\F[] attribute, \FC--cname\F[] attribute
    Name of the class label in the output vector dataset

\FC-down\F[] value, \FC--down\F[] value
    Down sampling factor

\FC-v\F[] level, \FC--verbose\F[] level
    Verbose mode if > 0