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

NAME

6       i.ortho.camera   - Select and modify the imagery group camera reference
7       file.
8

KEYWORDS

10       imagery, orthorectify
11

SYNOPSIS

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

DESCRIPTION

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  in‐
63       ner orientation establishes a relation between the pixels and the image
64       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 im‐
105       aged on film which serve as reference photo coordinate system. The max‐
106       imum number of fiducials will determine the number of fiducial  or  re‐
107       seau  coordinate pairs to be entered below. The origin is the center of
108       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

SEE ALSO

135        i.ortho.photo, i.photo.2image, i.photo.2target, i.ortho.init
136

AUTHOR

138       Mike Baba, DBA Systems, Inc.
139

SOURCE CODE

141       Available at: i.ortho.camera source code (history)
142
143       Accessed: Saturday Jan 21 21:16:45 2023
144
145       Main  index | Imagery index | Topics index | Keywords index | Graphical
146       index | Full index
147
148       © 2003-2023 GRASS Development Team, GRASS GIS 8.2.1 Reference Manual
149
150
151
152GRASS 8.2.1                                                  i.ortho.camera(1)
Impressum