.TH i.ortho.camera 1grass "" "GRASS 7.8.5" "GRASS GIS User's Manual" .SH NAME \fI\fBi.ortho.camera\fR\fR \- Select and modify the imagery group camera reference file. .SH KEYWORDS imagery, orthorectify .SH SYNOPSIS \fBi.ortho.camera\fR .br \fBi.ortho.camera \-\-help\fR .br \fBi.ortho.camera\fR [\fBgroup\fR=\fIname\fR] \fBcamera\fR=\fIname\fR [\fBname\fR=\fIstring\fR] [\fBid\fR=\fIstring\fR] [\fBclf\fR=\fIfloat\fR] [\fBpp\fR=\fIeast,north\fR] [\fBfid\fR=\fIeast,north\fR[,\fIeast,north\fR,...]] [\-\-\fBhelp\fR] [\-\-\fBverbose\fR] [\-\-\fBquiet\fR] [\-\-\fBui\fR] .SS Flags: .IP "\fB\-\-help\fR" 4m .br Print usage summary .IP "\fB\-\-verbose\fR" 4m .br Verbose module output .IP "\fB\-\-quiet\fR" 4m .br Quiet module output .IP "\fB\-\-ui\fR" 4m .br Force launching GUI dialog .SS Parameters: .IP "\fBgroup\fR=\fIname\fR" 4m .br Name of imagery group for ortho\-rectification .IP "\fBcamera\fR=\fIname\fR \fB[required]\fR" 4m .br Name of camera reference file .br Name of input file .IP "\fBname\fR=\fIstring\fR" 4m .br Camera name .IP "\fBid\fR=\fIstring\fR" 4m .br Camera id .IP "\fBclf\fR=\fIfloat\fR" 4m .br Calibrated focal length .IP "\fBpp\fR=\fIeast,north\fR" 4m .br Principal point coordinates .br Coordinates .IP "\fBfid\fR=\fIeast,north[,\fIeast,north\fR,...]\fR" 4m .br Fiducial coordinates .br Coordinates .SH DESCRIPTION \fIi.ortho.camera\fR creates or modifies entries in a camera reference file. For ortho\-photo rectification, a camera reference file is required for computation of scanned image to photo\-coordinate transformation parameters. There are two coordinate systems: The image coordinate system (in pixels) and the photo coordinate system (in milli\-meters). The inner orientation establishes a relation between the pixels and the image coordinates with help of fiducial marks. .PP The first prompt in the program will ask you for the name of the camera reference file to be created or modified. You may create a new camera reference file by entering a new name, or modify an existing camera reference file by entering the name of an existing camera file. .PP After entering the camera file name, following menu is displayed: .PP Please provide the following information .PP .br .nf \fC CAMERA NAME: \fIcamera name\fR______ CAMERA IDENTIFICATION: \fIidentification\fR___ CALIBRATED FOCAL LENGTH mm.:_________________ POINT OF SYMMETRY (X) mm.:_________________ POINT OF SYMMETRY (Y) mm.:_________________ MAXIMUM NUMBER OF FIDUCIALS:_________________ AFTER COMPLETING ALL ANSWERS, HIT TO CONTINUE (OR TO CANCEL) \fR .fi The camera name and identification describe the camera reference file. The calibrated focal length and the point of symmetry are used in computing the photo\-to\-target transformation parameters. These values should be entered from the camera calibration report (usually available from the photograph supplier). .PP .br \fIThis example is the camera Zeiss LMK9 265\-002A belonging to the Hellenic Military Geographical Survey (HMGS) and calibrated in December 1985\fR .PP The photo coordinate system origin is the so\-called calibrated principal point (PP, Principal Point of Symmetry) which is in the center of the image. The origin of the axes is at the intersection of the radii traced from the fiducial marks. In the ideal case of no deviations in the camera (see camera calibration certificate) the center is the origin and the values are 0 for both X and Y of Point of Symmetry. But usually the principal point does not fall on the intersection of the radii at the center of the picture. This eccentricity is usually of the order of a few micrometers. .PP You are then asked to enter the X and Y photo coordinates of each fiducial as follows. These fiducials (or reseau) marks are index marks imaged on film which serve as reference photo coordinate system. The maximum number of fiducials will determine the number of fiducial or reseau coordinate pairs to be entered below. The origin is the center of the image (or the point of symmetry) and X and Y are left\-right and up\-down. The order is up to the user, but must be kept consistent throughout the rectification process. .PP On this screen you should enter the fiducial or reseau photo\-coordinates as given in the camera calibration report. The X, and Y coordinates are in milli\-meters from the principle point. .PP Please provide the following information .br .nf \fC Fid# FID ID X Y 1__ _____ 0.0___ 0.0___ 2__ _____ 0.0___ 0.0___ 3__ _____ 0.0___ 0.0___ 4__ _____ 0.0___ 0.0___ 5__ _____ 0.0___ 0.0___ 6__ _____ 0.0___ 0.0___ 7__ _____ 0.0___ 0.0___ 8__ _____ 0.0___ 0.0___ 9__ _____ 0.0___ 0.0___ 10_ _____ 0.0___ 0.0___ next: end__ AFTER COMPLETING ALL ANSWERS, HIT TO CONTINUE (OR TO CANCEL) \fR .fi The input display is repeated until the number of MAXIMUM FIDUCIALS is reached. .SH SEE ALSO \fI i.ortho.photo, i.photo.2image, i.photo.2target, i.ortho.init \fR .SH AUTHOR Mike Baba, DBA Systems, Inc. .SH SOURCE CODE .PP Available at: i.ortho.camera source code (history) .PP Main index | Imagery index | Topics index | Keywords index | Graphical index | Full index .PP © 2003\-2020 GRASS Development Team, GRASS GIS 7.8.5 Reference Manual