Tool Gradient Vector from Cartesian to Polar Coordinates
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
- Author: Victor Olaya & Volker Wichmann (c) 2004-2010
- Menu: Grid|Calculus|Conversions
Parameters
Name | Type | Identifier | Description | Constraints | |
---|---|---|---|---|---|
Input | X Component | Grid, input | DX | - | - |
Y Component | Grid, input | DY | - | - | |
Output | Direction | Grid, output | DIR | - | - |
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 | 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 <str>] [-DY <str>] [-DIR <str>] [-LEN <str>] [-UNITS <str>] [-SYSTEM <str>] [-SYSTEM_ZERO <double>] [-SYSTEM_ORIENT <str>] -DX:<str> X Component Grid, input -DY:<str> Y Component Grid, input -DIR:<str> Direction Grid, output -LEN:<str> Length Grid, output -UNITS:<str> Polar Angle Units Choice Available Choices: [0] radians [1] degree Default: 0 -SYSTEM:<str> Polar Coordinate System Choice Available Choices: [0] mathematical [1] geographical [2] user defined Default: 1 -SYSTEM_ZERO:<double> User defined Zero Direction Floating point Minimum: 0.000000 Maximum: 360.000000 Default: 0.000000 -SYSTEM_ORIENT:<str> User defined Orientation Choice Available Choices: [0] clockwise [1] counterclockwise Default: 0