Skip to content

r.out.ntv2

Exports NTv2 datum transformation grid

r.out.ntv2 latshift=string lonshift=string output=string [systemt=string] [majort=string] [minort=string] [systemf=string] [majorf=string] [minorf=string] [--verbose] [--quiet] [--qq] [--ui]

Example:

r.out.ntv2 latshift=string lonshift=string output=string

grass.script.run_command("r.out.ntv2", latshift, lonshift, output, systemt="WGS84", majort="6378137", minort="6356752.314245", systemf="UNKNOWN", majorf="UNKNOWN", minorf="UNKNOWN", verbose=None, quiet=None, superquiet=None)

Example:

gs.run_command("r.out.ntv2", latshift="string", lonshift="string", output="string")

grass.tools.Tools.r_out_ntv2(latshift, lonshift, output, systemt="WGS84", majort="6378137", minort="6356752.314245", systemf="UNKNOWN", majorf="UNKNOWN", minorf="UNKNOWN", verbose=None, quiet=None, superquiet=None)

Example:

tools = Tools()
tools.r_out_ntv2(latshift="string", lonshift="string", output="string")

This grass.tools API is experimental in version 8.5 and expected to be stable in version 8.6.

Parameters

latshift=string [required]
    Input raster map of lattitude datum shift values
lonshift=string [required]
    Input raster map of longitude datum shift values
output=string [required]
    Output NTv2 datum transformation grid file
systemt=string
    Transformation grid's destination coordinate system name
    Default: WGS84
majort=string
    Major ellipsoid axis of the transformation grid's destination coordinate system
    Default: 6378137
minort=string
    Minor ellipsoid axis of the transformation grid's destination coordinate system
    Default: 6356752.314245
systemf=string
    Transformation grid's input coordinate system name
    Default: UNKNOWN
majorf=string
    Major ellipsoid axis of the transformation grid's input coordinate system
    Default: UNKNOWN
minorf=string
    Minor ellipsoid axis of the transformation grid's input coordinate system
    Default: UNKNOWN
--help
    Print usage summary
--verbose
    Verbose module output
--quiet
    Quiet module output
--qq
    Very quiet module output
--ui
    Force launching GUI dialog

latshift : str, required
    Input raster map of lattitude datum shift values
    Used as: input, raster
lonshift : str, required
    Input raster map of longitude datum shift values
    Used as: input, raster
output : str, required
    Output NTv2 datum transformation grid file
    Used as: output
systemt : str, optional
    Transformation grid's destination coordinate system name
    Default: WGS84
majort : str, optional
    Major ellipsoid axis of the transformation grid's destination coordinate system
    Default: 6378137
minort : str, optional
    Minor ellipsoid axis of the transformation grid's destination coordinate system
    Default: 6356752.314245
systemf : str, optional
    Transformation grid's input coordinate system name
    Default: UNKNOWN
majorf : str, optional
    Major ellipsoid axis of the transformation grid's input coordinate system
    Default: UNKNOWN
minorf : str, optional
    Minor ellipsoid axis of the transformation grid's input coordinate system
    Default: UNKNOWN
verbose : bool, optional
    Verbose module output
    Default: None
quiet : bool, optional
    Quiet module output
    Default: None
superquiet : bool, optional
    Very quiet module output
    Default: None

latshift : str | np.ndarray, required
    Input raster map of lattitude datum shift values
    Used as: input, raster
lonshift : str | np.ndarray, required
    Input raster map of longitude datum shift values
    Used as: input, raster
output : str, required
    Output NTv2 datum transformation grid file
    Used as: output
systemt : str, optional
    Transformation grid's destination coordinate system name
    Default: WGS84
majort : str, optional
    Major ellipsoid axis of the transformation grid's destination coordinate system
    Default: 6378137
minort : str, optional
    Minor ellipsoid axis of the transformation grid's destination coordinate system
    Default: 6356752.314245
systemf : str, optional
    Transformation grid's input coordinate system name
    Default: UNKNOWN
majorf : str, optional
    Major ellipsoid axis of the transformation grid's input coordinate system
    Default: UNKNOWN
minorf : str, optional
    Minor ellipsoid axis of the transformation grid's input coordinate system
    Default: UNKNOWN
verbose : bool, optional
    Verbose module output
    Default: None
quiet : bool, optional
    Quiet module output
    Default: None
superquiet : bool, optional
    Very quiet module output
    Default: None

Returns:

result : grass.tools.support.ToolResult | None
If the tool produces text as standard output, a ToolResult object will be returned. Otherwise, None will be returned.

DESCRIPTION

r.out.ntv2 converts a pair of GRASS raster maps containing longitude and lattitude coordinate offsets into an NTv2 grid datum shift file.

NOTES

NTv2 format supports only single-precission floating point data. GRASS GIS double-precision DCELL data need to be reduced to FCELL before export, eg. using r.mapcalc float() function.

The user should adjust the region and resolution to match the input raster maps before export, using g.region.

PROJ.4 and the software that depend on it, including GDAL, GRASS, QGIS, assume the NTv2 grid's destination coordinate system to be WGS84. The metadata values in the grid's header set with majort, minort, systemt parameters are ignored, same as the input coordinate system parameters (majorf, minorf, systemf). They are for documentation purposes only.

The CREATED and UPDATED output grid's metadata fields are set to, respectively, current date and time, in YYYYMMDD and HHMMSS format.

SEE ALSO

NTv2 format description by ESRI

AUTHOR

Maciej Sieczka

SOURCE CODE

Available at: r.out.ntv2 source code (history)
Latest change: Thursday Feb 20 13:02:26 2025 in commit 53de819