Function Plotter
- Author: A.Ringeler (c) 2003
- Menu: Grid | Calculus | Grid Generation
Description
Generate a grid based on a functional expression. The function interpreter uses an formula expression parser that offers the following operators:
| + | Addition |
| - | Subtraction |
| * | Multiplication |
| / | Division |
| abs(x) | Absolute Value |
| mod(x, y) | Returns the floating point remainder of x/y |
| int(x) | Returns the integer part of floating point value x |
| sqr(x) | Square |
| sqrt(x) | Square Root |
| exp(x) | Exponential |
| pow(x, y) | Returns x raised to the power of y |
| x ^ y | Returns x raised to the power of y |
| ln(x) | Natural Logarithm |
| log(x) | Base 10 Logarithm |
| pi() | Returns the value of Pi |
| sin(x) | Sine, expects radians |
| cos(x) | Cosine, expects radians |
| tan(x) | Tangent, expects radians |
| asin(x) | Arcsine, returns radians |
| acos(x) | Arccosine, returns radians |
| atan(x) | Arctangent, returns radians |
| atan2(x, y) | Arctangent of x/y, returns radians |
| min(x, y) | Returns the minimum of values x and y |
| max(x, y) | Returns the maximum of values x and y |
| gt(x, y) | Returns true (1), if x is greater than y, else false (0) |
| x > y | Returns true (1), if x is greater than y, else false (0) |
| lt(x, y) | Returns true (1), if x is less than y, else false (0) |
| x < y | Returns true (1), if x is less than y, else false (0) |
| eq(x, y) | Returns true (1), if x equals y, else false (0) |
| x = y | Returns true (1), if x equals y, else false (0) |
| and(x, y) | Returns true (1), if both x and y are true (i.e. not 0) |
| or(x, y) | Returns true (1), if at least one of both x and y is true (i.e. not 0) |
| ifelse(c, x, y) | Returns x, if condition c is true (i.e. not 0), else y |
| rand_u(x, y) | Random number, uniform distribution with minimum x and maximum y |
| rand_g(x, y) | Random number, Gaussian distribution with mean x and standard deviation y |
Parameters
| Name | Type | Identifier | Description | Constraints | |
|---|---|---|---|---|---|
| Input | Target System | grid, input, optional, CMD | TARGET_TEMPLATE | use this grid's system for output grids | - |
| Output | Function | grid, output | FUNCTION | - | - |
| Options | Formula | text | FORMULA | - | Default: sin(x*x + y*y) |
| X Range | value range | X_RANGE | - | - | |
| Y Range | value range | Y_RANGE | - | - | |
| Target Grid System | choice | TARGET_DEFINITION | - | Available Choices: [0] user defined [1] grid or grid system Default: 0 | |
| Cellsize | floating point number | TARGET_USER_SIZE | - | Minimum: 0.000000 Default: 1.000000 | |
| West | floating point number | TARGET_USER_XMIN | - | Default: 0.000000 | |
| East | floating point number | TARGET_USER_XMAX | - | Default: 100.000000 | |
| South | floating point number | TARGET_USER_YMIN | - | Default: 0.000000 | |
| North | floating point number | TARGET_USER_YMAX | - | Default: 100.000000 | |
| Columns | integer number | TARGET_USER_COLS | Number of cells in East-West direction. | Minimum: 1 Default: 101 | |
| Rows | integer number | TARGET_USER_ROWS | Number of cells in North-South direction. | Minimum: 1 Default: 101 | |
| Fit | choice | TARGET_USER_FITS | - | Available Choices: [0] nodes [1] cells Default: 0 | |
| Grid System | grid system | TARGET_SYSTEM | - | - |
Command Line
Usage: saga_cmd grid_calculus 4 [-FORMULA] [-X_RANGE_MIN ] [-X_RANGE_MAX ] [-Y_RANGE_MIN ] [-Y_RANGE_MAX ] [-TARGET_DEFINITION ] [-TARGET_USER_SIZE ] [-TARGET_USER_XMIN ] [-TARGET_USER_XMAX ] [-TARGET_USER_YMIN ] [-TARGET_USER_YMAX ] [-TARGET_USER_COLS ] [-TARGET_USER_ROWS ] [-TARGET_USER_FITS ] [-TARGET_TEMPLATE ] [-FUNCTION ] -FORMULA: Formula text Default: sin(x*x + y*y) -X_RANGE_MIN: X Range value range -X_RANGE_MAX: X Range value range -Y_RANGE_MIN: Y Range value range -Y_RANGE_MAX: Y Range value range -TARGET_DEFINITION: Target Grid System choice Available Choices: [0] user defined [1] grid or grid system Default: 0 -TARGET_USER_SIZE: Cellsize floating point number Minimum: 0.000000 Default: 1.000000 -TARGET_USER_XMIN: West floating point number Default: 0.000000 -TARGET_USER_XMAX: East floating point number Default: 100.000000 -TARGET_USER_YMIN: South floating point number Default: 0.000000 -TARGET_USER_YMAX: North floating point number Default: 100.000000 -TARGET_USER_COLS: Columns integer number Minimum: 1 Default: 101 -TARGET_USER_ROWS: Rows integer number Minimum: 1 Default: 101 -TARGET_USER_FITS: Fit choice Available Choices: [0] nodes [1] cells Default: 0 -TARGET_TEMPLATE: Target System grid, input, optional, CMD -FUNCTION: Function grid, output