1i.ortho.camera(1) GRASS GIS User's Manual i.ortho.camera(1)
2
3
4
6 i.ortho.camera - Select and modify the imagery group camera reference
7 file.
8
10 imagery, orthorectify
11
13 i.ortho.camera
14 i.ortho.camera --help
15 i.ortho.camera [group=name] camera=name [name=string] [id=string]
16 [clf=float] [pp=east,north] [fid=east,north[,east,north,...]]
17 [--help] [--verbose] [--quiet] [--ui]
18
19 Flags:
20 --help
21 Print usage summary
22
23 --verbose
24 Verbose module output
25
26 --quiet
27 Quiet module output
28
29 --ui
30 Force launching GUI dialog
31
32 Parameters:
33 group=name
34 Name of imagery group for ortho-rectification
35
36 camera=name [required]
37 Name of camera reference file
38 Name of input file
39
40 name=string
41 Camera name
42
43 id=string
44 Camera id
45
46 clf=float
47 Calibrated focal length
48
49 pp=east,north
50 Principal point coordinates
51 Coordinates
52
53 fid=east,north[,east,north,...]
54 Fiducial coordinates
55 Coordinates
56
58 i.ortho.camera creates or modifies entries in a camera reference file.
59 For ortho-photo rectification, a camera reference file is required for
60 computation of scanned image to photo-coordinate transformation parame‐
61 ters. There are two coordinate systems: The image coordinate system
62 (in pixels) and the photo coordinate system (in milli-meters). The
63 inner orientation establishes a relation between the pixels and the
64 image coordinates with help of fiducial marks.
65
66 The first prompt in the program will ask you for the name of the camera
67 reference file to be created or modified. You may create a new camera
68 reference file by entering a new name, or modify an existing camera
69 reference file by entering the name of an existing camera file.
70
71 After entering the camera file name, following menu is displayed:
72
73 Please provide the following information
74
75 CAMERA NAME: camera name______
76 CAMERA IDENTIFICATION: identification___
77 CALIBRATED FOCAL LENGTH mm.:_________________
78 POINT OF SYMMETRY (X) mm.:_________________
79 POINT OF SYMMETRY (Y) mm.:_________________
80 MAXIMUM NUMBER OF FIDUCIALS:_________________
81 AFTER COMPLETING ALL ANSWERS, HIT <ESC> TO CONTINUE
82 (OR <Ctrl-C> TO CANCEL)
83 The camera name and identification describe the camera reference file.
84 The calibrated focal length and the point of symmetry are used in com‐
85 puting the photo-to-target transformation parameters. These values
86 should be entered from the camera calibration report (usually available
87 from the photograph supplier).
88
89 This example is the camera Zeiss LMK9 265-002A belonging to the Hel‐
90 lenic Military Geographical Survey (HMGS) and calibrated in December
91 1985
92
93 The photo coordinate system origin is the so-called calibrated princi‐
94 pal point (PP, Principal Point of Symmetry) which is in the center of
95 the image. The origin of the axes is at the intersection of the radii
96 traced from the fiducial marks. In the ideal case of no deviations in
97 the camera (see camera calibration certificate) the center is the ori‐
98 gin and the values are 0 for both X and Y of Point of Symmetry. But
99 usually the principal point does not fall on the intersection of the
100 radii at the center of the picture. This eccentricity is usually of the
101 order of a few micrometers.
102
103 You are then asked to enter the X and Y photo coordinates of each fidu‐
104 cial as follows. These fiducials (or reseau) marks are index marks
105 imaged on film which serve as reference photo coordinate system. The
106 maximum number of fiducials will determine the number of fiducial or
107 reseau coordinate pairs to be entered below. The origin is the center
108 of the image (or the point of symmetry) and X and Y are left-right and
109 up-down. The order is up to the user, but must be kept consistent
110 throughout the rectification process.
111
112 On this screen you should enter the fiducial or reseau photo-coordi‐
113 nates as given in the camera calibration report. The X, and Y coordi‐
114 nates are in milli-meters from the principle point.
115
116 Please provide the following information
117 Fid# FID ID X Y
118 1__ _____ 0.0___ 0.0___
119 2__ _____ 0.0___ 0.0___
120 3__ _____ 0.0___ 0.0___
121 4__ _____ 0.0___ 0.0___
122 5__ _____ 0.0___ 0.0___
123 6__ _____ 0.0___ 0.0___
124 7__ _____ 0.0___ 0.0___
125 8__ _____ 0.0___ 0.0___
126 9__ _____ 0.0___ 0.0___
127 10_ _____ 0.0___ 0.0___
128 next: end__
129 AFTER COMPLETING ALL ANSWERS, HIT <ESC> TO CONTINUE
130 (OR <Ctrl-C> TO CANCEL)
131 The input display is repeated until the number of MAXIMUM FIDUCIALS is
132 reached.
133
135 i.ortho.photo, i.photo.2image, i.photo.2target, i.ortho.init
136
138 Mike Baba, DBA Systems, Inc.
139
141 Available at: i.ortho.camera source code (history)
142
143 Main index | Imagery index | Topics index | Keywords index | Graphical
144 index | Full index
145
146 © 2003-2020 GRASS Development Team, GRASS GIS 7.8.5 Reference Manual
147
148
149
150GRASS 7.8.5 i.ortho.camera(1)