Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
i.ortho.camera(1)	    GRASS GIS User's Manual	     i.ortho.camera(1)

NAME
       i.ortho.camera	- Select and modify the	imagery	group camera reference
       file.

KEYWORDS
       imagery,	orthorectify

SYNOPSIS
       i.ortho.camera
       i.ortho.camera --help
       i.ortho.camera  [group=name]  camera=name  [name=string]	   [id=string]
       [clf=float]	[pp=east,north]	     [fid=east,north[,east,north,...]]
       [--help]	 [--verbose]  [--quiet]	 [--ui]

   Flags:
       --help
	   Print usage summary

       --verbose
	   Verbose module output

       --quiet
	   Quiet module	output

       --ui
	   Force launching GUI dialog

   Parameters:
       group=name
	   Name	of imagery group for ortho-rectification

       camera=nameA [required]
	   Name	of camera reference file
	   Name	of input file

       name=string
	   Camera name

       id=string
	   Camera id

       clf=float
	   Calibrated focal length

       pp=east,north
	   Principal point coordinates
	   Coordinates

       fid=east,north[,east,north,...]
	   Fiducial coordinates
	   Coordinates

DESCRIPTION
       i.ortho.camera 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 parame-
       ters.   There  are  two coordinate systems: The image coordinate	system
       (in pixels) and the photo coordinate system (in milli-meters). The  in-
       ner orientation establishes a relation between the pixels and the image
       coordinates with	help of	fiducial marks.

       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.

       After entering the camera file name, following menu is displayed:

       Please provide the following information

	    CAMERA NAME:	       camera name______
	    CAMERA IDENTIFICATION:     identification___
	    CALIBRATED FOCAL LENGTH mm.:_________________
	    POINT OF SYMMETRY (X)   mm.:_________________
	    POINT OF SYMMETRY (Y)   mm.:_________________
	    MAXIMUM NUMBER OF FIDUCIALS:_________________
	  AFTER	COMPLETING ALL ANSWERS,	HIT <ESC> TO CONTINUE
		      (OR <Ctrl-C> TO CANCEL)
       The  camera name	and identification describe the	camera reference file.
       The calibrated focal length and the point of symmetry are used in  com-
       puting  the  photo-to-target  transformation  parameters.  These	values
       should be entered from the camera calibration report (usually available
       from the	photograph supplier).

       This  example  is  the camera Zeiss LMK9	265-002A belonging to the Hel-
       lenic Military Geographical Survey (HMGS) and  calibrated  in  December
       1985

       The  photo coordinate system origin is the so-called calibrated princi-
       pal 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 ori-
       gin 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.

       You are then asked to enter the X and Y photo coordinates of each fidu-
       cial as follows.	 These fiducials (or reseau) marks are index marks im-
       aged on film which serve	as reference photo coordinate system. The max-
       imum number of fiducials	will determine the number of fiducial  or  re-
       seau  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.

       On this screen you should enter the fiducial  or	 reseau	 photo-coordi-
       nates  as  given	in the camera calibration report. The X, and Y coordi-
       nates are in milli-meters from the principle point.

       Please provide the following information
	    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 <ESC> TO CONTINUE
			   (OR <Ctrl-C>	TO CANCEL)
       The input display is repeated until the number of MAXIMUM FIDUCIALS  is
       reached.

SEE ALSO
	i.ortho.photo, i.photo.2image, i.photo.2target,	i.ortho.init

AUTHOR
       Mike Baba, DBA Systems, Inc.

SOURCE CODE
       Available at: i.ortho.camera source code	(history)

       Main  index | Imagery index | Topics index | Keywords index | Graphical
       index | Full index

       A(C) 2003-2020 GRASS Development	Team, GRASS GIS	7.8.3 Reference	Manual

GRASS 7.8.3						     i.ortho.camera(1)

NAME | KEYWORDS | SYNOPSIS | DESCRIPTION | SEE ALSO | AUTHOR | SOURCE CODE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=i.ortho.camera&sektion=1&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help