← Back to branch summary

~ubuntu-branches/ubuntu/vivid/grass/vivid-proposed

« back to all changes in this revision

Viewing changes to imagery/i.ortho.photo/i.photo.2image/description.html

  • Committer: Package Import Robot
  • Author(s): Bas Couwenberg
  • Date: 2015-02-20 23:12:08 UTC
  • mfrom: (8.2.6 experimental)
  • Revision ID: package-import@ubuntu.com-20150220231208-1u6qvqm84v430b10
Tags: 7.0.0-1~exp1
* New upstream release.
* Update python-ctypes-ternary.patch to use if/else instead of and/or.
* Drop check4dev patch, rely on upstream check.
* Add build dependency on libpq-dev to grass-dev for libpq-fe.h.
* Drop patches applied upstream, refresh remaining patches.
* Update symlinks for images switched from jpg to png.

Show diffs side-by-side

added added

removed removed

Lines of Context:
imagery/i.ortho.photo/i.photo.2image/description.html
1
 
<H2>DESCRIPTION</H2>
2
 
 
3
 
<EM>i.photo.2image</EM> is an imagery function that enables
4
 
you to mark fiducial or reseau points on an image to be
5
 
ortho-rectified and then computes the image-to-photo
6
 
coordinate transformation parameters.  The coordinates of
7
 
the fiducials or reseau marks can be chosen for a camera
8
 
reference file.
9
 
<P>
10
 
 
11
 
During the process of marking reference points with known
12
 
photo coordinates, you may compute the RMS (root mean
13
 
square) error for each reference point entered.
14
 
<EM>i.photo.2image</EM> does this by calculating the
15
 
transformation equation (the same one that is calculated by
16
 
<EM><A HREF="i.points.html">i.points</A> </EM>),
17
 
and then plugging these results into an equation for RMS
18
 
error.
19
 
<P>
20
 
 
21
 
<EM>i.photo.2image</EM> offers a zoom option to locate
22
 
precisely the fiducial or reseau point to be marked on an
23
 
image.
24
 
<P>
25
 
 
26
 
To run <EM>i.photo.2image</EM>, a graphics monitor is
27
 
required.
28
 
<P>
29
 
 
30
 
The procedure for marking fiducial or reseau  points,
31
 
entering known photo-coordinates, and analyzing the RMS
32
 
error is described below.
33
 
<P>
34
 
 
35
 
The terminal screen displays this message: 
36
 
<P>
37
 
 
38
 
<B>use mouse now...</B>
39
 
<P>
40
 
 
41
 
The graphics monitor displays the following screen:
42
 
 
43
 
<PRE>
44
 
    +---------------------------+---------------------------------+
45
 
    |imagery                    |                                 |
46
 
    +---------------------------+---------------------------------+
47
 
    |                           |                                 |
48
 
    |                           |                                 |
49
 
    |                           |                                 |
50
 
    |                           |                                 |
51
 
    |                           |                                 |
52
 
    |                           |                                 |
53
 
    |                           |                                 |
54
 
    +---------------------------+---------------------------------+
55
 
    |                           |                                 |
56
 
    |                           |                                 |
57
 
    |                           |                                 |
58
 
    |                           |                                 |
59
 
    |                           |                                 |
60
 
    |                           |                                 |
61
 
    |                           |                                 |
62
 
    +---------------------------+---------------------------------+
63
 
    |                           |                                 |
64
 
    +---------------------------+---------------------------------+
65
 
</PRE>
66
 
 
67
 
<P>
68
 
 
69
 
A pop-down menu like that shown below will be superimposed on the
70
 
left half of the screen:
71
 
 
72
 
<P>
73
 
<PRE>
74
 
              +------------------------------------------+
75
 
              | Double click on raster map to be plotted |
76
 
              | Double click here to cancel              |
77
 
              +------------------------------------------+
78
 
                          +----------------+
79
 
                          |Mapset imagery  |
80
 
                          +-------+--------+
81
 
                          |gs13.1 | gs21.1 |
82
 
                          +-------+--------+
83
 
                          |gs14.1 | gs22.2 |
84
 
                          +-------+--------+
85
 
</PRE>
86
 
 
87
 
Any single file in the imagery group may be used on which to mark 
88
 
points, and you may mark points on more than one file
89
 
in the imagery group to accumulate the suggested minimum number of
90
 
4-8 fiducial or ressue points.
91
 
The imagery file selected is displayed in the upper 
92
 
left quadrant of the screen. 
93
 
<P>
94
 
 
95
 
<H2>CAMERA FILE</H2>
96
 
 
97
 
The camera reference file may be viewed by placing the mouse
98
 
cross hairs on the words CAMERA.  The camera reference file 
99
 
will be displayed in the lower left quadrant of the display:
100
 
 
101
 
 
102
 
<P>
103
 
<PRE>
104
 
 
105
 
|---------------------------------------------------------------|
106
 
|Camera Reference File                                          |
107
 
|---------------------------------------------------------------|
108
 
|  CAMERA NAME :        camera name                             |
109
 
|  CAMERA ID   :        L1234                                   |
110
 
|  CAMERA CFL  :        153.021 mm.                             |
111
 
|  CAMERA XP   :        0.050 mm.                               |
112
 
|  CAMERA XP   :        0.056 mm.                               |
113
 
|  number of fid.       4                                       |
114
 
|---------------------------------------------------------------|
115
 
|                                                               |
116
 
|ID        (X PHOTO) mm.                 (Y PHOTO) mm.          |
117
 
|_______________________________________________________________|
118
 
|1         -105.023                        110.123              |
119
 
|2          107.987                        109.834              |
120
 
|3          110.965                       -104.329              |
121
 
|4         -103.932                       -110.352              |
122
 
|_______________________________________________________________|
123
 
</PRE>
124
 
<P>
125
 
The following menu is displayed at the bottom 
126
 
of the graphics display:
127
 
<P>
128
 
 
129
 
<PRE>
130
 
+-----+------+-----------+--------+---------+-------------------+-------------+
131
 
|Quit | Zoom | Plot Cell | Camera | Analyze |   Input-&gt;KEYBOARD | CAMERA FILE |
132
 
+-----+------+-----------+--------+---------+-------------------+-------------+
133
 
</PRE>
134
 
 
135
 
<P>
136
 
<H2>ZOOM</H2>
137
 
 
138
 
To magnify the displayed file, you must 
139
 
place the mouse cross hairs on the word ZOOM. The following menu
140
 
will then be displayed at the bottom of the screen:
141
 
<P>
142
 
 
143
 
<PRE>
144
 
+-------+-----+-------++--------------------+
145
 
|Cancel | Box | Point ||Select type of ZOOM |
146
 
+-------+-----+-------++--------------------+
147
 
</PRE>
148
 
 
149
 
<P>
150
 
You have the option of identifying the zoom window either by using
151
 
the mouse to make a box, or by using the mouse to mark the center 
152
 
of the desired window, and adjusting the magnification factor.
153
 
The terminal screen will display a mouse button menu to guide you in
154
 
identifying the window.  The section of the image within the zoom window 
155
 
will be displayed in the upper right hand quadrant.
156
 
<P>
157
 
 
158
 
 
159
 
<H2>MARKING REFERENCE POINTS</H2>
160
 
 
161
 
To mark the known reference points (fiducial marks, reseau marks, etc.)
162
 
on the image, you must place the mouse cross hairs
163
 
on the corresponding location on the image to be marked and press
164
 
the left hand button on the mouse.  A diamond shaped symbol will be marked
165
 
on the image. 
166
 
<P>
167
 
If you wish to use the  camera reference file only as a
168
 
comparative reference,  then the keyboard can be chosen as
169
 
the means to input photo coordinates corresponding to the marked
170
 
reference points on the image.  This is done by placing the mouse
171
 
cross hairs on the word KEYBOARD and pressing the left
172
 
button on the mouse.
173
 
<P>
174
 
The following menu is displayed on the graphics terminal:
175
 
<P>
176
 
<PRE>
177
 
+------------------------------------+--------------------------+
178
 
|Point 1 marked at IMAGE COORDINATES |                          |
179
 
|east:  1023.77                      |                          |
180
 
|north:  506.56                      |                          |
181
 
|                                    |                          |
182
 
|                                    |                          |
183
 
|                                    |                          |
184
 
|                                    |                          |
185
 
|                                    |                          |
186
 
+------------------------------------+--------------------------+
187
 
|Enter PHOTO COORDINATES as x and y:                            |
188
 
+---------------------------------------------------------------+
189
 
</PRE>
190
 
<P>
191
 
You then enter the known (x,y) photo coordinates, relative
192
 
to the perspective center, for the  reference
193
 
point marked on the image.  If you
194
 
do not wish to enter a coordinate, simply hit RETURN to continue;
195
 
the marked reference point will disappear.
196
 
<P>
197
 
If you select the CAMERA FILE option, then reference points
198
 
marked on the image will be associated with selected photo
199
 
coordinates from the displayed camera reference file.  In this option,
200
 
when you mark a point on the image, the following menu is
201
 
displayed on the graphics terminal:
202
 
<P>
203
 
<PRE>
204
 
-------------------------------------------------------------
205
 
CANCEL   Double click on the fiducial mark to be referenced
206
 
------------------------------------------------------------- 
207
 
</PRE>
208
 
<P>
209
 
 
210
 
If you would like to select the photo coordinates of a displayed
211
 
reference mark, this can be accomplished by placing the mouse
212
 
cross hairs on the reference point to be selected and pressing
213
 
the left button on the mouse twice.  After a reference point is selected
214
 
from the display, you are prompted with "Look ok? (Y/N)".
215
 
If you respond with no, the reference point is ignored.
216
 
If you respond with yes, the following is displayed on the terminal:
217
 
<P>
218
 
<P>
219
 
<PRE>
220
 
+----------------------------------------+--------------------------+
221
 
|Point 1 marked at IMAGE COORDINATES     |                          |
222
 
|east: 1023.77                           |                          |
223
 
|north: 1065.41                          |                          |
224
 
|                                        |                          |
225
 
|                                        |                          |
226
 
|Point 1 referenced at PHOTO COORDINATES |                          |
227
 
|X: -105.023                             |                          |
228
 
|Y:  110.122                             |                          |
229
 
|                                        |                          |
230
 
|                                        |                          |
231
 
|                                        |                          |
232
 
|                                        |                          |
233
 
|                                        |                          |
234
 
+----------------------------------------+--------------------------+
235
 
| use mouse now...                                                  |
236
 
+----------------------------------------+--------------------------+
237
 
</PRE>
238
 
<P>
239
 
The photo coordinates and the corresponding image coordinates are 
240
 
automatically saved in the photo_points file associated with the imagery
241
 
group. 
242
 
<P>
243
 
<P>
244
 
<H2>ANALYZE</H2>
245
 
 
246
 
After a number of points have been marked (4 to 8), you can
247
 
check the RMS error of the points marked on the image.  This is done
248
 
by placing the mouse cross hairs on the word ANALYZE at the bottom
249
 
of the monitor.  An error report resembling the one shown below
250
 
is superimposed on the monitor:
251
 
<P>
252
 
<PRE>
253
 
+--------------------------------------------------------------------+
254
 
|       error           image           photo                        |
255
 
|                                                                    |
256
 
|#     row      col   photo    east    north   x               y     |
257
 
|1     0.0     -0.9    1.0     1048.5  -144.8  -105.023    110.122   |
258
 
|2     0.4      1.0    1.3     2153.1  -567.2   107.987    109.834   |
259
 
|3    -1.2     -0.5    0.6     1452.8  -476.5   110.965   -104.329   |
260
 
|4     1.1      0.5    1.3     1034.0  -109.2  -103.932   -110.352   |
261
 
|                                                                    |
262
 
+--------------------------------------------------------------------+
263
 
|    overall   rms    error:   4.46                                  |
264
 
+--------------------------------------------------------------------+
265
 
</PRE>
266
 
<P>
267
 
 The following menu then appears at the bottom of the monitor:
268
 
<P>
269
 
<PRE>
270
 
+-----+-------+------+-----------------------------------------------+
271
 
|DONE | PRINT | FILE | Double click on point to be included/excluded |
272
 
+-----+-------+------+-----------------------------------------------+
273
 
</PRE>
274
 
<P>
275
 
 
276
 
The RMS error for the image is given under the column
277
 
TITLEd "error" and subTITLEd "row" and "col".  In the above
278
 
report, point number 1 is 0.0 rows and -0.9 columns from
279
 
the predicted location calculated from the transformation
280
 
equation.  The RMS error for the photo coordinates is
281
 
listed under the heading "photo".  This is the RMS error
282
 
for the x and y coordinates of the photo coordinates but it
283
 
is presented in the table using one general value.  The
284
 
overall RMS error is displayed at the bottom of the screen
285
 
in milimeters.  Points that create high RMS error are
286
 
displayed in red on the monitor (represented here in
287
 
italics).
288
 
<P>
289
 
 
290
 
The location of the point marked on the imagery group file
291
 
is given under the heading "image" and the subheadings
292
 
"east" and "north".  The location of the point in the photo
293
 
coordinates is given under the heading "photo" and the
294
 
subheadings "x" and "y".  If you would like to exclude or
295
 
include a point, this can be accomplished by placing the
296
 
mouse cross hairs on the point number to be included (if
297
 
the point is absent) or excluded (if the point is
298
 
displayed) and pressing the left button on the mouse
299
 
twice.  When a point is excluded, it is not afterwards
300
 
included in the calculation of the RMS error, or included
301
 
in the final transformation matrix.  However, it can be
302
 
retrieved within <EM>i.photo.2image</EM> at any time by
303
 
double clicking with the mouse as described above.
304
 
<P>
305
 
 
306
 
 
307
 
<H2>QUIT</H2>
308
 
 
309
 
To end the <EM>i.photo.2image</EM> program place the mouse cross hairs
310
 
on the word QUIT;  the marked reference points (including coordinates)
311
 
will be saved.
312
 
<P>
313
 
 
314
 
 
315
 
<H2>NOTES</H2>
316
 
 
317
 
A good rule of thumb is to mark at least 4 to 8 points which are
318
 
evenly distributed over the perimeter of the imagery 
319
 
group file in order to obtain 
320
 
an accurate transformation equation for the rectification process.
321
 
The RMS error may increase with more points added, but the 
322
 
transformation equation will be more accurate.  
323
 
<P>
324
 
 
325
 
An RMS error of less than or equal to approximately one resolution
326
 
unit (pixel) for the image being rectified is generally considered 
327
 
acceptable.
328
 
 
329
 
<H2>SEE ALSO</H2>
330
 
 
331
 
<EM>
332
 
<A HREF="i.ortho.photo.html">i.ortho.photo</A>,
333
 
<A HREF="i.photo.camera.html">i.photo.camera</A>,
334
 
<A HREF="i.photo.2target.html">i.photo.2target</A>,
335
 
<A HREF="i.photo.init.html">i.photo.init</A>,
336
 
<A HREF="i.photo.rectify.html">i.photo.rectify</A>
337
 
</EM>
338
 
 
339
 
<H2>AUTHOR</H2>
340
 
 
341
 
Mike Baba,  DBA Systems, Inc.
342
 
 
343
 
<p>
344
 
<i>Last changed: $Date: 2012-02-25 14:38:11 +0100 (Sat, 25 Feb 2012) $</i>
345