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 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 <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 number
Minimum: 0.000000
Maximum: 360.000000
Default: 0.000000
-SYSTEM_ORIENT:<str> User defined Orientation
choice
Available Choices:
[0] clockwise
[1] counterclockwise
Default: 0