1i.ortho.init(1)             GRASS GIS User's Manual            i.ortho.init(1)
2
3
4

NAME

6       i.ortho.init   -  Interactively creates or modifies entries in a camera
7       initial exposure  station  file  for  imagery  group  referenced  by  a
8       sub-block.
9

KEYWORDS

11       imagery, orthorectify
12

SYNOPSIS

14       i.ortho.init
15       i.ortho.init --help
16       i.ortho.init  [-rp]  group=name   [xc=float]    [yc=float]   [zc=float]
17       [xc_sd=float]      [yc_sd=float]      [zc_sd=float]       [omega=float]
18       [phi=float]      [kappa=float]      [omega_sd=float]     [phi_sd=float]
19       [kappa_sd=float]   [--help]  [--verbose]  [--quiet]  [--ui]
20
21   Flags:
22       -r
23           Use initial values at run time
24
25       -p
26           Print initial values
27
28       --help
29           Print usage summary
30
31       --verbose
32           Verbose module output
33
34       --quiet
35           Quiet module output
36
37       --ui
38           Force launching GUI dialog
39
40   Parameters:
41       group=name [required]
42           Name of imagery group for ortho-rectification
43
44       xc=float
45           Initial Camera Exposure X-coordinate
46
47       yc=float
48           Initial Camera Exposure Y-coordinate
49
50       zc=float
51           Initial Camera Exposure Z-coordinate
52
53       xc_sd=float
54           Apriori X-coordinate standard deviation
55
56       yc_sd=float
57           Apriori Y-coordinate standard deviation
58
59       zc_sd=float
60           Apriori Z-coordinate standard deviation
61
62       omega=float
63           Initial Camera Omega (roll) degrees
64
65       phi=float
66           Initial Camera Phi (pitch) degrees
67
68       kappa=float
69           Initial Camera Kappa (yaw) degrees
70
71       omega_sd=float
72           Apriori Omega (roll) standard deviation
73
74       phi_sd=float
75           Apriori Phi (pitch) standard deviation
76
77       kappa_sd=float
78           Apriori Kappa (yaw) standard deviation
79

DESCRIPTION

81       Aerial photographs may be either vertical or oblique.  Vertical  photo‐
82       graphs  can  be truly vertical (nadir), or slightly tilted (less than 3
83       degree from the vertical). Usually aerial photos  are  tilted  to  some
84       degree.  We  refer  to  the  term vertical photograph up to a tilt of 3
85       degree.
86       Oblique aerial photographs are purposely taken with an angle between  3
87       and 90 degree from the nadir direction.
88
89       The  use  of  i.ortho.init  (menu 6) is only required when rectifying a
90       tilted or oblique aerial photo.
91
92       i.ortho.init creates or modifies entries in a camera  initial  exposure
93       station  file  for  imagery  group  referenced  by  a sub-block.  These
94       entries include: the (XC,YC,ZC) standard (e.g. UTM) approximate coordi‐
95       nates  of  the  camera  exposure  station; initial roll, pitch, and yaw
96       angles (in degrees) of the cameras attitude; and the a priori  standard
97       deviations   for   these   parameters.   During  the  imagery  program,
98       i.photo.rectify, the initial camera exposure station file is  used  for
99       computation  of the ortho-rectification parameters.  If no initial cam‐
100       era exposure station file exist, the default values are  computed  from
101       the control points file created in i.photo.2target.
102
103       The following menu is displayed:
104               Please provide the following information
105            INITIAL XC: Meters                __________
106            INITIAL YC: Meters                __________
107            INITIAL ZC: Meters                __________
108            INITIAL omega (roll) degrees:     __________
109            INITIAL phi  (pitch) degrees:     __________
110            INITIAL kappa  (yaw) degrees:     __________
111            Standard Deviation XC: Meters     __________
112            Standard Deviation YC: Meters     __________
113            Standard Deviation ZC: Meters     __________
114            Std. Dev. omega (roll) degrees:   __________
115            Std. Dev. phi  (pitch) degrees:   __________
116            Std. Dev. kappa  (yaw) degrees:   __________
117               Use these values at run time? (1=yes, 0=no)
118            AFTER COMPLETING ALL ANSWERS, HIT <ESC> TO CONTINUE
119                         (OR <Ctrl-C> TO CANCEL)
120
121       The  INITIAL values for (XC,YC,ZC) are expressed in standard (e.g. UTM)
122       coordinates, and represent an approximation for  the  location  of  the
123       camera at the time of exposure.
124
125           ·   X: East aircraft position;
126
127           ·   Y: North aircraft position;
128
129           ·   Z: Flight altitude above sea level
130
131       The  INITIAL values for (omega,phi,kappa) are expressed in degrees, and
132       represent an approximation for the cameras attitude   at  the  time  of
133       exposure.
134
135           ·   Omega  (roll): Raising or lowering of the wings (turning around
136               the aircraft’s axis);
137
138           ·   Phi (pitch): Raising or lowering of the aircraft’s front (turn‐
139               ing around the wings’ axis);
140
141           ·   Kappa  (yaw): Rotation needed to align the aerial photo to true
142               north: needs to be denoted as +90 degree for clockwise turn and
143               -90 degree for a counterclockwise turn.
144
145       The standard deviations for (XC,YC,ZC) are expressed in meters, and are
146       used as a priori values for the standard deviations used in computation
147       of the ortho rectification parameters.
148
149       The standard deviations for (omega,phi,kappa) are expressed in degrees,
150       and are used as a priori values for the  standard  deviations  used  in
151       computation of the ortho rectification parameters.
152
153       If  Use these values at run time? (1=yes, 0=no) is set to 0, the values
154       in this menu are not used.
155

SEE ALSO

157          i.ortho.photo,   i.photo.2image,   i.photo.2target,    i.ortho.elev,
158       i.ortho.camera, i.ortho.transform, i.photo.rectify
159

AUTHOR

161       Mike Baba,  DBA Systems, Inc.
162

SOURCE CODE

164       Available at: i.ortho.init source code (history)
165
166       Main  index | Imagery index | Topics index | Keywords index | Graphical
167       index | Full index
168
169       © 2003-2020 GRASS Development Team, GRASS GIS 7.8.5 Reference Manual
170
171
172
173GRASS 7.8.5                                                    i.ortho.init(1)
Impressum