NAME

pkgetmask - program to create mask image based on values in input raster image

SYNOPSIS

pkgetmask
-i input -o output [options] [advanced options]

DESCRIPTION

pkgetmask creates a mask raster dataset from an input raster dataset. Values smaller than the minimum value (-min) or larger than the maximum value (-max) will result in a -nodata value in the mask.

OPTIONS

-i filename, --input filename

input image file

-o filename, --output filename

Output mask file

-min value, --min value

Values smaller than min threshold(s) are masked as invalid. Use one threshold for each band

-max value, --max value

Values greater than max threshold(s) are masked as invalid. Use one threshold for each band

-data value, --data value

value(s) for valid pixels: between min and max

-nodata value, --nodata value

value(s) for invalid pixels: not between min and max

-v level, --verbose level

verbose

Advanced options

-b band, --band band

band(s) used for mask

-p AND|OR, --operator AND|OR

Operator: [AND,OR].

-ot type, --otype type

Data type for output image ({Byte / Int16 / UInt16 / UInt32 / Int32 / Float32 / Float64 / CInt16 / CInt32 / CFloat32 / CFloat64}). Empty string: inherit type from input image

-of format, --oformat format

Output image format (see also gdal_translate(1)).

-co option, --co option

Creation option for output file. Multiple options can be specified.

-ct colortable, --ct colortable

color table (file with 5 columns: id R G B ALFA (0: transparent, 255: solid)).

EXAMPLE

create mask, setting all negative values to 0 (rest to 1)

pkgetmask -i input.tif -o output.tif -min 0 -nodata 0 -data 1


      

create mask. Mask is set to 0 (default value for -nodata) if either band 0 is not between 0 and 10 OR (default operator) band 1 is not between 0 and 250. Else mask is set to 1 (default value for -data)

pkgetmask -i input.tif -o output.tif -min 0 -max 10 -max 0 -max 250 -b 0 -b 1