Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
GDAL-RASTER-RESIZE(1)		     GDAL		 GDAL-RASTER-RESIZE(1)

NAME
       gdal-raster-resize - Resize a raster dataset

       Added in	version	3.11.

SYNOPSIS
	  Usage: gdal raster resize [OPTIONS] <INPUT> <OUTPUT>

	  Resize a raster dataset without changing the georeferenced extents.

	  Positional arguments:
	    -i,	--input	<INPUT>					 Input raster dataset [required]
	    -o,	--output <OUTPUT>				 Output	raster dataset [required]

	  Common Options:
	    -h,	--help						 Display help message and exit
	    --json-usage					 Display usage as JSON document	and exit
	    --config <KEY>=<VALUE>				 Configuration option [may be repeated]
	    --progress						 Display progress bar

	  Options:
	    -f,	--of, --format,	--output-format	<OUTPUT-FORMAT>	 Output	format ("GDALG"	allowed)
	    --co, --creation-option <KEY>=<VALUE>		 Creation option [may be repeated]
	    --overwrite						 Whether overwriting existing output is	allowed
	    --size <width[%]>,<height[%]>			 Target	size in	pixels (or percentage if using '%' suffix) [required]
	    -r,	--resampling <RESAMPLING>			 Resampling method. RESAMPLING=nearest|bilinear|cubic|cubicspline|lanczos|average|mode (default: nearest)

	  Advanced Options:
	    --if, --input-format <INPUT-FORMAT>			 Input formats [may be repeated]
	    --oo, --open-option	<KEY>=<VALUE>			 Open options [may be repeated]

DESCRIPTION
       gdal  raster  resize  can  be  used  to resize a	raster dataset without
       changing	the georeferenced extents.

       This subcommand is also available as a potential	step  of  gdal	raster
       pipeline

   Standard options
       -f, --of, --format, --output-format <OUTPUT-FORMAT>
	      Which  output  raster format to use. Allowed values may be given
	      by gdal --formats	| grep raster |	grep rw	| sort

       --co <NAME>=<VALUE>
	      Many formats have	one or more optional creation options that can
	      be used to control particulars about the file created.  For  in-
	      stance,  the GeoTIFF driver supports creation options to control
	      compression, and whether the file	should be tiled.

	      May be repeated.

	      The creation options available vary by format driver,  and  some
	      simple  formats  have  no	creation options at all. A list	of op-
	      tions supported for a format can be listed  with	the  --formats
	      command  line option but the documentation for the format	is the
	      definitive source	of information	on  driver  creation  options.
	      See  Raster drivers format specific documentation	for legal cre-
	      ation options for	each format.

       --overwrite
	      Allow program to overwrite  existing  target  file  or  dataset.
	      Otherwise,  by  default,	gdal  errors out if the	target file or
	      dataset already exists.

       --size <width[%]>,<height[%]>
	      Set output raster	width and height, expressed in pixels, or per-
	      centage if using the % suffix.  If the width or  the  height  is
	      set  to 0, the other dimension will be guessed from the computed
	      resolution.

       -r, --resampling	<RESAMPLING>
	      Resampling method	to use.	Available methods are:

	      near: nearest neighbour resampling (default, fastest  algorithm,
	      worst interpolation quality).

	      bilinear:	bilinear resampling.

	      cubic: cubic resampling.

	      cubicspline: cubic spline	resampling.

	      lanczos: Lanczos windowed	sinc resampling.

	      average:	average	 resampling,  computes the weighted average of
	      all non-NODATA contributing pixels.

GDALG OUTPUT (ON-THE-FLY / STREAMED DATASET)
       This program supports serializing the command line as a JSON file using
       the GDALG output	format.	 The resulting file can	then be	 opened	 as  a
       raster dataset using the	GDALG: GDAL Streamed Algorithm driver, and ap-
       ply the specified pipeline in a on-the-fly / streamed way.

EXAMPLES
   Example  1:	Resize a dataset to 1000 columns and 500 lines using cubic re-
       sampling
	  $ gdal raster	resize --size=1000,500 -r cubic	in.tif out.tif --overwrite

   Example 2: Resize a dataset to half size using cubic	resampling
	  $ gdal raster	resize --size=50%,50% -r cubic in.tif out.tif --overwrite

AUTHOR
       Even Rouault <even.rouault@spatialys.com>

COPYRIGHT
       1998-2025

				 Jul 12, 2025		 GDAL-RASTER-RESIZE(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gdal-raster-resize&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help