SAGA 9.6.1 | Tool Library Documentation

Gradient Vector from Cartesian to Polar Coordinates


Description

Converts gradient vector from directional components (Cartesian) to polar coordinates (direction or aspect angle and length or tangens of slope). The tool supports three conventions on how to measure and output the angle of direction: (a) mathematical: direction angle is zero in East direction and the angle increases counterclockwise (b) geographical: direction angle is zero in North direction and the angle increases clockwise (c) zero direction and orientation are user defined


Parameters

 NameTypeIdentifierDescriptionConstraints
InputX Componentgrid, inputDX--
Y Componentgrid, inputDY--
OutputDirectiongrid, outputDIR--
Lengthgrid, outputLEN--
OptionsGrid Systemgrid systemPARAMETERS_GRID_SYSTEM--
Polar Angle UnitschoiceUNITS-Available Choices: [0] radians [1] degree Default: 0
Polar Coordinate SystemchoiceSYSTEM-Available Choices: [0] mathematical [1] geographical [2] user defined Default: 1
User defined Zero Directionfloating point numberSYSTEM_ZEROgiven in degree clockwise from North directionMinimum: 0.000000 Maximum: 360.000000 Default: 0.000000
User defined OrientationchoiceSYSTEM_ORIENT-Available Choices: [0] clockwise [1] counterclockwise Default: 0

Command Line


Usage: saga_cmd grid_calculus 15 [-DX ] [-DY ] [-DIR ] [-LEN ] [-UNITS ] [-SYSTEM ] [-SYSTEM_ZERO ] [-SYSTEM_ORIENT ]
  -DX:            	X Component
	grid, input
  -DY:            	Y Component
	grid, input
  -DIR:           	Direction
	grid, output
  -LEN:           	Length
	grid, output
  -UNITS:         	Polar Angle Units
	choice
	Available Choices:
	[0] radians
	[1] degree
	Default: 0
  -SYSTEM:        	Polar Coordinate System
	choice
	Available Choices:
	[0] mathematical
	[1] geographical
	[2] user defined
	Default: 1
  -SYSTEM_ZERO:	User defined Zero Direction
	floating point number
	Minimum: 0.000000
	Maximum: 360.000000
	Default: 0.000000
  -SYSTEM_ORIENT: 	User defined Orientation
	choice
	Available Choices:
	[0] clockwise
	[1] counterclockwise
	Default: 0