GDALMOVE(1)

NAME
gdalmove - Transform georeferencing of raster file in place.

SYNOPSIS

    gdalmove [--help] [--help-general]
                [-s_srs <srs_defn>] -t_srs <srs_defn>
                [-et <max_pixel_err>] <target_file>

DESCRIPTION

The gdalmove script transforms the bounds of a raster file from one coordinate system to another, and then updates the coordinate system and geotransform of the file. This is done without altering pixel values at all. It is loosely similar to using gdalwarp to transform an image but avoiding the resampling step in order to avoid image damage. It is generally only suitable for transformations that are effectively linear in the area of the file.

If no error threshold value (-et) is provided then the file is not actually updated, but the errors that would be incurred are reported. If -et is provided then the file is only modify if the apparent error being introduced is less than the indicate threshold (in pixels).

Currently the transformed geotransform is computed based on the transformation of the top left, top right, and bottom left corners. A reduced overall error could be produced using a least squares fit of at least all four corner points.

NOTE: gdalmove is a Python utility, and is only available if GDAL Python bindings are available.

--help
    Show this help message and exit

--help-general
    Gives a brief usage message for the generic GDAL commandline options and exit.

-s_srs <srs_defn>
    Override the coordinate system of the file with the indicated coordinate system definition. Optional. If not provided the source coordinate system is read from the source file.

-t_srs <srs_defn>
    Defines the target coordinate system. This coordinate system will be written to the file after an update.

-et <max_pixel_err>
    The error threshold (in pixels) beyond which the file will not be updated. If not provided no update will be applied to the file, but errors will be reported.

    <target_file> The file to be operated on. To update this must be a file format that supports in place updates of the geotransform and SRS.

RETURN STATUS CODE

The program returns status code 0 in case of success, and non-zero in case of error (non-blocking errors emitted as warnings are considered as a successful execution).

AUTHOR
Frank Warmerdam <warmerdam@pobox.com>

COPYRIGHT
1998-2026