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

                                         24 January 2016                             pkgetmask(1)