.\" Man page generated from reStructuredText. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "GDAL-RASTER-UPDATE" "1" "Feb 09, 2026" "" "GDAL" .SH NAME gdal-raster-update \- Update the destination raster with the content of the input one. .sp Added in version 3.12. .SH SYNOPSIS .INDENT 0.0 .INDENT 3.5 .sp .EX Usage: gdal raster update [OPTIONS] Update the destination raster with the content of the input one. Positional arguments: \-i, \-\-input Input raster dataset [required] \-o, \-\-output Output raster dataset [required] Common Options: \-h, \-\-help Display help message and exit \-\-json\-usage Display usage as JSON document and exit \-\-config = Configuration option [may be repeated] \-q, \-\-quiet Quiet mode (no progress bar) Options: \-\-geometry Clipping geometry (WKT or GeoJSON) \-\-geometry\-crs CRS of clipping geometry \-r, \-\-resampling Resampling method. RESAMPLING=nearest|bilinear|cubic|cubicspline|lanczos|average|rms|mode|min|max|med|q1|q3|sum (default: nearest) \-\-no\-update\-overviews Do not update existing overviews Advanced Options: \-\-oo, \-\-open\-option = Open options [may be repeated] \-\-if, \-\-input\-format Input formats [may be repeated] \-\-wo, \-\-warp\-option = Warping option(s) [may be repeated] \-\-to, \-\-transform\-option = Transform option(s) [may be repeated] \-\-et, \-\-error\-threshold Error threshold .EE .UNINDENT .UNINDENT .SH DESCRIPTION .sp \fBgdal raster update\fP can be used to update an existing target raster dataset with the pixel values of the source raster, doing reprojection if the source and target datasets do not have the same coordinate reference systems. The extent, size, resolution or coordinate reference system of the target dataset are not modified by this operation. .sp Overviews are updated by this command (using \fI\%gdal raster overview refresh\fP), unless \fI\%\-\-no\-update\-overviews\fP is specified. .SS Standard options .INDENT 0.0 .TP .B \-r, \-\-resampling Resampling method to use. Available methods are: .sp \fBnearest\fP: nearest neighbour resampling (default, fastest algorithm, worst interpolation quality). .sp \fBbilinear\fP: bilinear resampling. .sp \fBcubic\fP: cubic resampling. .sp \fBcubicspline\fP: cubic spline resampling. .sp \fBlanczos\fP: Lanczos windowed sinc resampling. .sp \fBaverage\fP: average resampling, computes the weighted average of all non\-NODATA contributing pixels. .sp \fBrms\fP root mean square / quadratic mean of all non\-NODATA contributing pixels .sp \fBmode\fP: mode resampling, selects the value which appears most often of all the sampled points. In the case of ties, the first value identified as the mode will be selected. .sp \fBmax\fP: maximum resampling, selects the maximum value from all non\-NODATA contributing pixels. .sp \fBmin\fP: minimum resampling, selects the minimum value from all non\-NODATA contributing pixels. .sp \fBmed\fP: median resampling, selects the median value of all non\-NODATA contributing pixels. .sp \fBq1\fP: first quartile resampling, selects the first quartile value of all non\-NODATA contributing pixels. .sp \fBq3\fP: third quartile resampling, selects the third quartile value of all non\-NODATA contributing pixels. .sp \fBsum\fP: compute the weighted sum of all non\-NODATA contributing pixels .sp \fBNOTE:\fP .INDENT 7.0 .INDENT 3.5 When downsampling is performed (use of \fI\%\-\-resolution\fP or \fI\%\-\-size\fP), existing overviews (either internal/implicit or external ones) on the source image will be used by default by selecting the closest overview to the desired output resolution. The resampling method used to create those overviews is generally not the one you specify through the \fI\%\-r\fP option. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-geometry Geometry as a WKT or GeoJSON string of a polygon (or multipolygon) to which to restrict the update. If the input geometry is GeoJSON, its CRS is assumed to be WGS84, unless there is a CRS defined in the GeoJSON geometry or \fI\%\-\-geometry\-crs\fP is specified. If the input geometry is WKT, its CRS is assumed to be the one of the input dataset, unless \fI\%\-\-geometry\-crs\fP is specified. The X and Y axis are the \(dqGIS friendly ones\(dq, that is X is longitude or easting, and Y is latitude or northing. .UNINDENT .INDENT 0.0 .TP .B \-\-geometry\-crs CRS in which the coordinate values of \fI\%\-\-geometry\fP are expressed. If not specified, it is assumed to be the CRS of the input dataset. The geometry will be reprojected from the geometry\-crs to the CRS of the dataset being updated. .UNINDENT .INDENT 0.0 .TP .B \-\-no\-update\-overviews Do not update existing overviews. .UNINDENT .SS Advanced options .INDENT 0.0 .TP .B \-\-wo, \-\-warp\-option = Set a warp option. The \fI\%GDALWarpOptions::papszWarpOptions\fP docs show all options. Multiple options may be listed. .UNINDENT .INDENT 0.0 .TP .B \-\-to = Set a transformer option suitable to pass to \fI\%GDALCreateGenImgProjTransformer2()\fP\&. See \fI\%GDALCreateRPCTransformerV2()\fP for RPC specific options. .UNINDENT .INDENT 0.0 .TP .B \-\-et, \-\-error\-threshold Error threshold for transformation approximation, expressed as a number of source pixels. Defaults to 0.125 pixels unless the \fBRPC_DEM\fP transformer option is specified, in which case an exact transformer, i.e. \fB\-\-error\-threshold=0\fP, will be used. .UNINDENT .SH EXAMPLES .SS Example 1: Update existing out.tif with content of in.tif using cubic interpolation .INDENT 0.0 .INDENT 3.5 .sp .EX $ gdal raster update \-r cubic in.tif out.tif .EE .UNINDENT .UNINDENT .SH AUTHOR Even Rouault .SH COPYRIGHT 1998-2026 .\" Generated by docutils manpage writer. .