SAGA-GIS Tool Library Documentation (v7.7.0)

Tool Direct Georeferencing of Airborne Photographs

Direct georeferencing of aerial photographs uses extrinsic (position, attitude) and intrinsic (focal length, physical pixel size) camera parameters. Orthorectification routine supports additional data from a Digital Elevation Model (DEM).


References


Parameters

 NameTypeIdentifierDescriptionConstraints
InputUnreferenced GridsGrid list, inputINPUT--
Elevation (*)Grid, input, optionalDEM--
Target System (*)Grid, input, optional, CMDTARGET_TEMPLATEuse this grid's system for output grids-
OutputReferenced GridsGrid list, outputOUTPUT--
Extent (*)Shapes, output, optionalEXTENT--
OptionsGrid SystemGrid systemPARAMETERS_GRID_SYSTEM--
Grid systemGrid systemDEM_GRIDSYSTEM--
DefaultFloating pointDEM.Defaultdefault value if no grid has been selectedDefault: 0.000000
Focal Length [mm]Floating pointCFL-Minimum: 0.000000
Default: 80.000000
CCD Physical Pixel Size [micron]Floating pointPXSIZE-Minimum: 0.000000
Default: 5.200000
XFloating pointX-Default: 0.000000
YFloating pointY-Default: 0.000000
ZFloating pointZ-Default: 1000.000000
OmegaFloating pointOMEGAX axis rotation angle [degree] (roll)Default: 0.000000
PhiFloating pointPHIY axis rotation angle [degree] (pitch)Default: 0.000000
KappaFloating pointKAPPAZ axis rotation angle [degree] (heading)Default: 0.000000
OffsetFloating pointKAPPA_OFForigin adjustment angle [degree] for kappa (Z axis, heading)Default: 90.000000
OrientationChoiceORIENTATION-Available Choices:
[0] BLUH
[1] PATB
Default: 0
Row OrderChoiceROW_ORDER-Available Choices:
[0] top down
[1] bottom up
Default: 0
ResamplingChoiceRESAMPLING-Available Choices:
[0] Nearest Neighbour
[1] Bilinear Interpolation
[2] Bicubic Spline Interpolation
[3] B-Spline Interpolation
Default: 3
Data Storage TypeChoiceDATA_TYPE-Available Choices:
[0] 1 byte unsigned integer
[1] 1 byte signed integer
[2] 2 byte unsigned integer
[3] 2 byte signed integer
[4] 4 byte unsigned integer
[5] 4 byte signed integer
[6] 4 byte floating point
[7] 8 byte floating point
[8] same as original
Default: 8
Target Grid SystemChoiceTARGET_DEFINITION-Available Choices:
[0] user defined
[1] grid or grid system
Default: 0
CellsizeFloating pointTARGET_USER_SIZE-Minimum: 0.000000
Default: 1.000000
WestFloating pointTARGET_USER_XMIN-Default: 0.000000
EastFloating pointTARGET_USER_XMAX-Default: 100.000000
SouthFloating pointTARGET_USER_YMIN-Default: 0.000000
NorthFloating pointTARGET_USER_YMAX-Default: 100.000000
ColumnsIntegerTARGET_USER_COLSNumber of cells in East-West direction.Minimum: 1
Default: 100
RowsIntegerTARGET_USER_ROWSNumber of cells in North-South direction.Minimum: 1
Default: 100
FitChoiceTARGET_USER_FITS-Available Choices:
[0] nodes
[1] cells
Default: 0
Grid SystemGrid systemTARGET_SYSTEM--
(*) optional

Command-line

Usage: saga_cmd pj_georeference 4 [-INPUT <str>] [-OUTPUT <str>] [-EXTENT <str>] [-DEM <str>] [-DEM.Default <double>] [-CFL <double>] [-PXSIZE <double>] [-X <double>] [-Y <double>] [-Z <double>] [-OMEGA <double>] [-PHI <double>] [-KAPPA <double>] [-KAPPA_OFF <double>] [-ORIENTATION <str>] [-ROW_ORDER <str>] [-RESAMPLING <str>] [-DATA_TYPE <str>] [-TARGET_DEFINITION <str>] [-TARGET_USER_SIZE <double>] [-TARGET_USER_XMIN <double>] [-TARGET_USER_XMAX <double>] [-TARGET_USER_YMIN <double>] [-TARGET_USER_YMAX <double>] [-TARGET_USER_COLS <num>] [-TARGET_USER_ROWS <num>] [-TARGET_USER_FITS <str>] [-TARGET_TEMPLATE <str>]
  -INPUT:<str>              	Unreferenced Grids
	Grid list, input
  -OUTPUT:<str>             	Referenced Grids
	Grid list, output
  -EXTENT:<str>             	Extent
	Shapes, output, optional
  -DEM:<str>                	Elevation
	Grid, input, optional
  -DEM.Default:<double>     	Default
	Floating point
	Default: 0.000000
  -CFL:<double>             	Focal Length [mm]
	Floating point
	Minimum: 0.000000
	Default: 80.000000
  -PXSIZE:<double>          	CCD Physical Pixel Size [micron]
	Floating point
	Minimum: 0.000000
	Default: 5.200000
  -X:<double>               	X
	Floating point
	Default: 0.000000
  -Y:<double>               	Y
	Floating point
	Default: 0.000000
  -Z:<double>               	Z
	Floating point
	Default: 1000.000000
  -OMEGA:<double>           	Omega
	Floating point
	Default: 0.000000
  -PHI:<double>             	Phi
	Floating point
	Default: 0.000000
  -KAPPA:<double>           	Kappa
	Floating point
	Default: 0.000000
  -KAPPA_OFF:<double>       	Offset
	Floating point
	Default: 90.000000
  -ORIENTATION:<str>        	Orientation
	Choice
	Available Choices:
	[0] BLUH
	[1] PATB
	Default: 0
  -ROW_ORDER:<str>          	Row Order
	Choice
	Available Choices:
	[0] top down
	[1] bottom up
	Default: 0
  -RESAMPLING:<str>         	Resampling
	Choice
	Available Choices:
	[0] Nearest Neighbour
	[1] Bilinear Interpolation
	[2] Bicubic Spline Interpolation
	[3] B-Spline Interpolation
	Default: 3
  -DATA_TYPE:<str>          	Data Storage Type
	Choice
	Available Choices:
	[0] 1 byte unsigned integer
	[1] 1 byte signed integer
	[2] 2 byte unsigned integer
	[3] 2 byte signed integer
	[4] 4 byte unsigned integer
	[5] 4 byte signed integer
	[6] 4 byte floating point
	[7] 8 byte floating point
	[8] same as original
	Default: 8
  -TARGET_DEFINITION:<str>  	Target Grid System
	Choice
	Available Choices:
	[0] user defined
	[1] grid or grid system
	Default: 0
  -TARGET_USER_SIZE:<double>	Cellsize
	Floating point
	Minimum: 0.000000
	Default: 1.000000
  -TARGET_USER_XMIN:<double>	West
	Floating point
	Default: 0.000000
  -TARGET_USER_XMAX:<double>	East
	Floating point
	Default: 100.000000
  -TARGET_USER_YMIN:<double>	South
	Floating point
	Default: 0.000000
  -TARGET_USER_YMAX:<double>	North
	Floating point
	Default: 100.000000
  -TARGET_USER_COLS:<num>   	Columns
	Integer
	Minimum: 1
	Default: 100
  -TARGET_USER_ROWS:<num>   	Rows
	Integer
	Minimum: 1
	Default: 100
  -TARGET_USER_FITS:<str>   	Fit
	Choice
	Available Choices:
	[0] nodes
	[1] cells
	Default: 0
  -TARGET_TEMPLATE:<str>    	Target System
	Grid, input, optional, CMD