Mathematical and Trigonometric Functions
You can include mathematical and trigonometric calculations in a CGT file @ section. These functions enable SmartCAM to produce edit-free code in the format you provide and greatly expands SmartCAM's capabilities.
EVAL Function
The CGT function #EVAL() is used to handle math calculations and variable assignments in the CGT file. For example, #EVAL(#V1=2) sets the value of #V1 to 2. It is important to note that #EVAL() does not cause any information to be output in the generated NC code. It performs a calculation and assigns the results to a CGT word. A separate statement is required to output results of the calculation or assignment.
Examples of using #EVAL() include:
| Function | Description |
|---|---|
#EVAL(#V2=0)
|
Assigns the value "0" to the #V2 CGT variable. |
#EVAL(#V3=1)
|
Assigns the value "1" to the #V3 CGT variable. |
THE VALUE OF V3=#V3
|
Outputs the following: THE VALUE OF V3=1 |
#EVAL(#V4=2+3)
|
Assigns the value "5" to the #V4 CGT variable. |
#EVAL(#PUNCH=#ON)
|
Sets the CGT word #PUNCH to "1". This sets the system
to punch active mode. An M75 or other string set with SMF file question
223 will be output when #PUNCH is encountered in the CGT file. |
#EVAL(#PUNCH=#OFF)
|
Sets the CGT word #PUNCH to "0". This sets the system
to punch inhibit mode. An M85 or other string set with SMF file question
222 will be output when #PUNCH is encountered in the CGT file. |
EVMx() Macro Variable Assignment Functions
The CGT functions #EVMD(), #EVMI(), #EVMS() work similar to the #EVAL() function however the word on the left side of the equation is a macro variable that will be assigned the value.
The #EVMD() function assigns a decimal macro variable.
The #EVMI() function assigns an integer macro variable.
The #EVMS() function assigns a string macro variable.
If the macro variable already exists, the #EVMx() function must match the type of the macro variable or an error will be generated. If the macro variable does not exist it will be created based on the type of the function. ** These functions cannot be used to assign macro array variables.
Examples of using the #EVMx() functions include:
| Function | Description |
|---|---|
#EVMD(#AV2=#TLDIA/2)
|
Assigns the CGT value "#TLDIA" divided by 2 to the #AV2 decimal macro variable. |
#EVMI(#AV3=#NTOOL+100)
|
Assigns the CGT value "#NTOOL" plus 100 to the #AV3 integer macro variable. |
#EVMS(#AVS1=my text)
|
Assigns the string "my text" to the #AVS1 macro string variable. |
#EVMS(#AVID=#PROGID)
|
Assigns the string "#PROGID" to the #AVID macro string variable. |
Math Functions
SmartCAM supports a variety of mathematical functions. Notice that the words SQR, ABS, SGN, and INT in the following list are not preceded by the # character. They are operators, not CGT words.
| Operator | Meaning | Example |
|---|---|---|
+
|
add | #EVAL(#V5=#ZPOS+#ZSET) sets #V5 to the sum of #ZPOS
plus #ZSET. |
-
|
subtract | #EVAL(#V5=#ZPOS-#ZSET) sets #V5 to the value of #ZPOS
minus #ZSET. |
*
|
multiply | #EVAL(#V5=#ARAD*2) sets #V5 to two times the arc radius. |
/
|
divide | #EVAL(#V5=#V5/2) sets #V5 to #V5 divided by 2. |
^
|
exponential | #EVAL(#V5=#V5^3) sets #V5 to cube of #V5. |
ABS
|
absolute value | #EVAL(#V5=ABS(#XPOS)) sets #V5 to the absolute value of #XPOS.
If #XPOS is equal to -2.5, the #V5 is set to 2.5. |
CEIL
|
Ceiling integer | #EVAL(#U5=CEIL(2.3)) sets #U5 to 3.
#EVAL(#U5=CEIL(-2.3)) sets #U5 to -2.
|
DMS
|
degrees to decimal | converts DDD.MMSS to decimal. #EVAL(#V5=DMS(90.3000)) sets #V5 to 90.5. |
FLOOR
|
Floor integer | #EVAL(#U5=FLOOR(2.3)) sets #U5 to 2.
#EVAL(#U5=FLOOR(-2.3)) sets #U5 to -3.
|
INT
|
integer value | #EVAL(#V5=INT(#XPOS)) sets #V5 to the integer value of #XPOS.
If #XPOS=2.5, then #V5 is set to 2. |
MAX
|
Maximum value | #EVAL(#V5=MAX(12, #rtrctDist)) sets #V5 to the maximum of 12 or the #rtrctDist.
|
MIN
|
Minimum value | #EVAL(#V5=MIN(12, #rtrctDist)) sets #V5 to the minimum of 12 or the #rtrctDist.
|
MOD
|
integer modulus | #EVAL(#U5=MOD(#TOOL,10)) sets #U5 to the integer modulus of #TOOL with 10.
If #TOOL=25, then #U5 is set to 5. |
PI
|
return PI | #EVAL(#V5 = PI() / 2) sets #V5 to the value of PI / 2. |
RND
|
round decimal | #EVAL(#V5 = RND( PI() * 2, 2 )) sets #V5 to PI * 2 rounded to two places, 6.28. |
SGN
|
return sign (+-) | SGN(#XPOS) returns the sign (+ or -) of #XPOS. If #XPOS=-2.5
this would return a minus (-) sign. |
SQR
|
square root | #EVAL(#V5=SQR(#LNLEN)) sets #V5 to square root of the line length. |
Trigonometric Functions
SmartCAM supports the following list of trigonometric functions. Notice that the # character does not precede these commands, they are functions, not CGT words.
| Operator | Meaning | Range (Min, Max) | Example |
|---|---|---|---|
SIN
|
sine | -1, 1 | #EVAL(#V5=SIN(#LNANG)) sets #V5 to the sine of the line angle. |
COS
|
cosine | -1, 1 | #EVAL(#V5=COS(#LNANG)) sets #V5 to the cosine of the line angle. |
TAN
|
tangent | Any | #EVAL(#V5=TAN(#LNANG)) sets #V5 to the tangent of the line angle. |
ASIN
|
arcsine | -90, 90 | #EVAL(#V5=ASIN(#YOV/#LNANG)) sets #V5 to the arcsine of the
#YOV/#LNANG. |
ACOS
|
arccosine | 0, 180 | #EVAL(#V5=ACOS(#XOV/#LNANG)) sets #V5 to the arccosine of the
#XOV/#LNANG. |
ATAN
|
arctangent | -90, 90 | #EVAL(#V5=ATAN(#YOV/#LNANG)) sets #V5 to the arctangent of the
#YOV/#LNANG. |
ATAN2
|
arctangent2 | -180, 180 | #EVAL(#V5=ATAN2(#YPOS,#XPOS)) sets #V5 to the arctangent2 of the
#YPOS and #XPOS coordinates. |
ATAN2FULL
|
arctangent2 | 0, 360 | #EVAL(#V5=ATAN2FULL(#YPOS,#XPOS)) sets #V5 to the arctangent2 of the
#YPOS and #XPOS coordinates. |
Order of Operations
SmartCAM uses the following standard math convention for the order of operations:
- Calculate exponentials
- Multiplication or division, left to right
- Addition or subtraction, left to right
You can control the order of operations by using parentheses. Innermost calculations are handled first. For example:
#EVAL(#V6=(2*(3.14159*#ARAD^2)))
SmartCAM performs the calculations in the following order:
- Raises the arc radius (#ARAD) to the second power
- Multiplies the resulting value by pi (3.14159)
- Multiplies the resulting value by 2
- Sets #V6 to the resulting value