jvs:cigal:manual:chapter1:functions

**CIGAL Reference Manual, Chapter 1 (Topics): functions**

In CIGAL, a function is any command that returns a value. The value can be a number or any of the other CIGAL data types: character string, vector, array, matrix, image, or solid (see

VARIABLES(1)). The nature of the returned value depends on the function and the arguments you give it. Returned values can either be displayed on the screen, stored in a data variable or used as arguments to other CIGAL commands (but not to other functions – see below).

The following is a summary list of CIGAL's intrinsic functions:

= | -assign values to variables |

Accept | -get data from keyboard, cursor, screen, or current input |

Accum | -compute a running sum of elements within a variable |

Acos | -calculate arc-cosine of a variable |

Address | -get the physical memory address of a variable |

Alert | -display message window and wait for response |

Alog | -calculate anti-logarithm of a variable |

Analyze | -calculate frequency distribution of values within a variable |

Angle | -calculate the angle formed by three points |

Area | -calculate the area within a polygon |

Array | -allocate memory for an array variable |

Asin | -calculate arc-sine of a variable |

Atan | -calculate the arc tangent of a variable or a ratio |

Column | -perform arithmetic column by column within a variable |

Compress | -compress a data variable by removing empty values |

Comread | -read from serial communication port |

Convolve | -convolve a variable using a kernel matrix |

Cos | -calculate the cosine of a variable |

Dialog | -get or set menu items in dialog boxes |

File | -assign a data file to a pointer variable |

Filter | -perform a non-convolution neighborhood transform of an image |

Findvec | -find the vector nearest a specified position |

Fit | -fit a straight line to a curve |

Flip | -flip a 2-D variable around the X or Y axis |

Format | -convert data values to character string, specifying format |

Getbox | -get the upper left and lower right coordinates of a box |

Getchar | -read one character from the keyboard |

Getfile | -get a filename from directory lists interactively |

Gettxt | -read text information from the screen display |

Getxyz | -read the cursor position |

Getz | -read the current Z value (from ZDEV or ZVAL) |

Index | -find the position of a value in a variable |

Integer | -convert floating point number to integer value |

Interpolate | -calculate Y values from X values, using a standard curve |

Lcase | -convert a character string to lower case text |

Length | -calculate distance between 2 points or along a vector path |

Log | -calculate the logarithm of a variable |

Maklut | -create a ramped lookup table |

Map | -copy a variable to another through a lookup table |

Mask | -use a mask to select part of a variable |

Matrix | -allocate memory for a matrix or image variable |

Max | -find the maximum value in a variable, or between 2 variables |

Mean | -calculate the mean value of a variable |

Measure | -calculate the length and area of a vector list |

Menuitem | -get information about menu commands |

Min | -find the minimum value in a variable, or between 2 variables |

Mode | -get information about a variable's data and storage type |

Pdstr | -expand a repeated character string sequence |

Perp | -calculate the perpendicular intercept from a point to a line |

Pointer | -create a pointer to a variable |

Projection | -get a variable's scale, offset, rotation, and pin parameters |

Ramp | -generate a ramped sequence of numbers |

Random | -generate a random sequence of numbers |

Rank | -determine the sorted order of elements of a variable |

Rem | -calculate the remainder after performing integer division |

RGB | -convert color data formats |

Round | -convert floating point value to the nearest integer |

Row | -perform arithmetic row by row within a variable |

Sample | -sample data values along a vector path |

Search | -find 1st image value within given intensity range |

Shift | -do bitwise shift of integer data values |

Sin | -calculate the sine of a variable |

Size | -return the number of elements in a variable |

Smooth | -remove kinks by averaging values along a path |

Solid | -allocate memory for a solid variable |

Sqrt | -calculate square root of a variable |

Stats | -return 12 statistics describing a variable |

Stdev | -calculate the standard deviation within a variable |

Sum | -calculate the sum of the values within a variable |

Sweep | -record a number variable and display as on an oscilloscope |

Time | -get current date and time, or elapsed time |

Trace | -generate vector list by tracing an image intensity contour |

Transform | -copy a variable with rotation, scaling, and offset |

Ucase | -convert a character string to upper case text |

Vector | -assign values to a vector variable |

Vrbxy | -get XY position within a WATCHed variable |

Warp | -distort an image by interpolating between fixed points |

Xor | -calculate an “exclusive or” operation on 2 variables |

Zoom | -transform a variable by pixel replication or ommision |

Zproj | -Perform arithmetic by z-column within a solid variable |

( ) | -group operations within an arithmetic expression |

== | -logical “is equal to” operator |

++ | -auto-increment suffix operator |

– | -auto-decrement suffix operator |

** | -“raise to the power” operator |

jvs/cigal/manual/chapter1/functions.txt · Last modified: 2022/11/18 16:08 (external edit)