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