pkcomposite

pkcomposite

program to mosaic and composite geo-referenced images

SYNOPSIS

Usage: pkcomposite -i input [-i input]* -o output

Options: [-b band]* [-dx xres] [-dy yres] [-e vector] [-ulx ULX -uly ULY -lrx LRX -lry LRY] [-cr rule] [-cb band] [-srcnodata value] [-bndnodata band] [-min value] [-max value] [-dstnodata value] [-r resampling_method] [-ot {Byte / Int16 / UInt16 / UInt32 / Int32 / Float32 / Float64 / CInt16 / CInt32 / CFloat32 / CFloat64}] [-of format] [-co NAME=VALUE]* [-a_srs epsg:number]

Advanced options: [-file] [-w weight]* [-c class]* [-ct colortable] [-d description]

Description

The utility pkcomposite can be used to {mosaic} and {composite} multiple (georeferenced) raster datasets. A mosaic can merge images with different geographical extents into a single larger image. Compositing resolves the overlapping pixels according to some rule (e.g, the median of all overlapping pixels). This utility is complementary to GDAL, which currently does not support a composite step. Input datasets can have different bounding boxes and spatial resolutionsresolution.

Options

• use either -short or --long options (both --long=value and --long value are supported)
• short option -h shows basic options only, long option --help shows all options

  short	long	type	default	description
  i	input	std::string		Input image file(s). If input contains multiple images, a multi-band output is created
  o	output	std::string		Output image file
  b	band	int		band index(es) to crop (leave empty if all bands must be retained)
  dx	dx	double		Output resolution in x (in meter) (empty: keep original resolution)
  dy	dy	double		Output resolution in y (in meter) (empty: keep original resolution)
  e	extent	std::string		get boundary from extent from polygons in vector file
  ulx	ulx	double	0	Upper left x value bounding box
  uly	uly	double	0	Upper left y value bounding box
  lrx	lrx	double	0	Lower right x value bounding box
  lry	lry	double	0	Lower right y value bounding box
  cr	crule	std::string	overwrite	Composite rule (overwrite, maxndvi, maxband, minband, mean, mode (only for byte images), median, sum, maxallbands, minallbands
  cb	cband	int	0	band index used for the composite rule (e.g., for ndvi, use –cband=0 –cband=1 with 0 and 1 indices for red and nir band respectively
  srcnodata	srcnodata	double	0	invalid value for input image
  bndnodata	bndnodata	int	0	Bands in input image to check if pixel is valid (used for srcnodata, min and max options)
  min	min	double		flag values smaller or equal to this value as invalid.
  max	max	double		flag values larger or equal to this value as invalid.
  dstnodata	dstnodata	double	0	nodata value to put in output image if not valid or out of bounds.
  r	resampling-method	std::string	near	Resampling method (near: nearest neighbor, bilinear: bi-linear interpolation).
  ot	otype	std::string		Data type for output image ({Byte/Int16/UInt16/UInt32/Int32/Float32/Float64/CInt16/CInt32/CFloat32/CFloat64}). Empty string: inherit type from input image
  of	oformat	std::string		Output image format (see also gdal_translate). Empty string: inherit from input image
  co	co	std::string		Creation option for output file. Multiple options can be specified.
  a_srs	a_srs	std::string		Override the spatial reference for the output file (leave blank to copy from input file, use epsg:3035 to use European projection and force to European grid
  file	file	bool	false	write number of observations for each pixels as additional layer in composite
  w	weight	short	1	Weights (type: short) for the composite, use one weight for each input file in same order as input files are provided). Use value 1 for equal weights.
  c	class	short	0	classes for multi-band output image: each band represents the number of observations for one specific class. Use value 0 for no multi-band output image.
  ct	ct	std::string		color table file with 5 columns: id R G B ALFA (0: transparent, 255: solid)
  d	description	std::string		Set image description
  v	verbose	bool	false	verbose

  Usage: pkcomposite -i input [-i input]* -o output

Examples

Some examples how to use pkcomposite can be found here

FAQ

Frequently asked questions on pkcomposite can be found here