Gradient Vector from Cartesian to Polar Coordinates

Author: Victor Olaya & Volker Wichmann (c) 2004-2010
Menu: Grid | Calculus | Conversions

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

	Name	Type	Identifier	Description	Constraints
Input	X Component	grid, input	`DX`	-	-
Input	Y Component	grid, input	`DY`	-	-
Output	Direction	grid, output	`DIR`	-	-
Output	Length	grid, output	`LEN`	-	-
Options	Grid System	grid system	`PARAMETERS_GRID_SYSTEM`	-	-
	Polar Angle Units	choice	`UNITS`	-	Available Choices: [0] radians [1] degree Default: 0
	Polar Coordinate System	choice	`SYSTEM`	-	Available Choices: [0] mathematical [1] geographical [2] user defined Default: 1
	User defined Zero Direction	floating point number	`SYSTEM_ZERO`	given in degree clockwise from North direction	Minimum: 0.000000 Maximum: 360.000000 Default: 0.000000
	User defined Orientation	choice	`SYSTEM_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