m.transform(1grass)

1m.transform(1)                Grass User's Manual               m.transform(1)
2
3
4

NAME

6       m.transform   -  Computes a coordinate transformation based on the con‐
7       trol points.
8

KEYWORDS

10       miscellaneous, transformation, GCP
11

SYNOPSIS

13       m.transform
14       m.transform --help
15       m.transform      [-srx]      group=name      order=integer        [for‐
16       mat=string[,string,...]]      [input=name]      [--help]    [--verbose]
17       [--quiet]  [--ui]
18
19   Flags:
20       -s
21           Display summary information
22
23       -r
24           Reverse transform of coords file or coeff. dump
25           Target east,north coordinates to local x,y
26
27       -x
28           Display transform matrix coefficients
29
30       --help
31           Print usage summary
32
33       --verbose
34           Verbose module output
35
36       --quiet
37           Quiet module output
38
39       --ui
40           Force launching GUI dialog
41
42   Parameters:
43       group=name [required]
44           Name of input imagery group
45
46       order=integer [required]
47           Rectification polynomial order
48           Options: 1-3
49           Default: 1
50
51       format=string[,string,...]
52           Output format
53           Options: idx, src, dst, fwd, rev, fxy, rxy, fd, rd
54           Default: fd,rd
55           idx: point index
56           src: source coordinates
57           dst: destination coordinates
58           fwd: forward coordinates (destination)
59           rev: reverse coordinates (source)
60           fxy: forward coordinates difference (destination)
61           rxy: reverse coordinates difference (source)
62           fd: forward error (destination)
63           rd: reverse error (source)
64
65       input=name
66           File containing coordinates to transform ("-" to read from stdin)
67           Local x,y coordinates to target east,north
68

DESCRIPTION

70       m.transform is an utility to compute transformation based upon GCPs and
71       output error measurements.
72

NOTES

74       For coordinates given with the input file option or fed from stdin, the
75       input format is "x y" with one coordinate pair per line.
76
77       The transformations are:
78
79       order=1:
80           e = [E0 E1][1].[1]
81               [E2  0][e] [n]
82           n = [N0 N1][1].[1]
83               [N2  0][e] [n]
84       order=2:
85           e = [E0 E1 E3][1 ] [1 ]
86               [E2 E4  0][e ].[n ]
87               [E5  0  0][e²] [n²]
88           n = [N0 N1 N3][1 ] [1 ]
89               [N2 N4  0][e ].[n ]
90               [N5  0  0][e²] [n²]
91       order=3:
92           e = [E0 E1 E3 E6][1 ] [1 ]
93               [E2 E4 E7  0][e ].[n ]
94               [E5 E8  0  0][e²] [n²]
95               [E9  0  0  0][e³] [n³]
96           n = [N0 N1 N3 N6][1 ] [1 ]
97               [N2 N4 N7  0][e ].[n ]
98               [N5 N8  0  0][e²] [n²]
99               [N9  0  0  0][e³] [n³]
100       ["." = dot-product, (AE).N = N’EA.]
101
102       In other words, order=1 and order=2 are equivalent to order=3 with  the
103       higher coefficients equal to zero.
104

AUTHORS

109       Brian J. Buckley
110       Glynn Clements
111       Hamish Bowman
112
113       Last changed: $Date: 2014-11-28 16:43:22 +0100 (Fri, 28 Nov 2014) $
114

SOURCE CODE

116       Available at: m.transform source code (history)
117
118       Main  index  |  Miscellaneous  index  | Topics index | Keywords index |
119       Graphical index | Full index
120
121       © 2003-2019 GRASS Development Team, GRASS GIS 7.4.4 Reference Manual
122
123
124
125GRASS 7.4.4                                                     m.transform(1)