| 23 |
|
][ |
| 24 |
|
.B "\-o format" |
| 25 |
|
][ |
| 26 |
+ |
.B "\-in M" |
| 27 |
+ |
][ |
| 28 |
+ |
.B "\-on M" |
| 29 |
+ |
][ |
| 30 |
|
.B "\-f source" |
| 31 |
|
][ |
| 32 |
|
.B "\-e expr" |
| 96 |
|
effectively substitute information in the middle of a file |
| 97 |
|
or stream without affecting the rest of the data. |
| 98 |
|
.PP |
| 99 |
+ |
If a |
| 100 |
+ |
.I \-in |
| 101 |
+ |
option is given with a positive integer argument, |
| 102 |
+ |
.I rcalc |
| 103 |
+ |
will stop processing input once it has loaded this number of records. |
| 104 |
+ |
Similarly, if a |
| 105 |
+ |
.I \-on |
| 106 |
+ |
option is present, |
| 107 |
+ |
.I rcalc |
| 108 |
+ |
will stop after producing this many records, which may be a smaller |
| 109 |
+ |
number if the |
| 110 |
+ |
.I cond |
| 111 |
+ |
variable is used. |
| 112 |
+ |
If multiple input files are given, these counts are continuous over |
| 113 |
+ |
the input and do not reset on each file. |
| 114 |
+ |
.PP |
| 115 |
|
The variable and function definitions in each |
| 116 |
|
.I \-f source |
| 117 |
< |
file are read and compiled. |
| 117 |
> |
file are read and compiled from the RADIANCE library where it is found. |
| 118 |
|
The |
| 119 |
|
.I \-e expr |
| 120 |
|
option can be used to define variables on the command line. |
| 222 |
|
.PP |
| 223 |
|
+ - * / ^ |
| 224 |
|
.PP |
| 225 |
< |
Operators are evaluated left to right. |
| 225 |
> |
Operators are evaluated left to right, except '^', |
| 226 |
> |
which is right associative. |
| 227 |
|
Powers have the highest precedence; multiplication and |
| 228 |
|
division are evaluated before addition and subtraction. |
| 229 |
|
Expressions can be grouped with parentheses. |
| 255 |
|
This provides a convenient method for avoiding inappropriate calculations. |
| 256 |
|
The following library of pre-defined functions and variables is provided: |
| 257 |
|
.TP 10n |
| 258 |
+ |
.BR $N |
| 259 |
+ |
Return the value for input column |
| 260 |
+ |
.I N. |
| 261 |
+ |
If an input format is given, using a channel number generates an error. |
| 262 |
+ |
.TP |
| 263 |
|
.BR "in(n)" |
| 264 |
|
Return the value for input column |
| 265 |
|
.I n, |
| 319 |
|
inverse trigonometric functions. |
| 320 |
|
.TP |
| 321 |
|
.BR "atan2(y, x)" |
| 322 |
< |
inverse tangent of y/x (range -pi to pi). |
| 322 |
> |
inverse tangent of y/x (range \-pi to pi). |
| 323 |
|
.SH EXAMPLE |
| 324 |
|
To print the square root of column two in column one, |
| 325 |
|
and column one times column three in column two: |
| 326 |
|
.IP "" .2i |
| 327 |
< |
rcalc -e '$1=sqrt($2);$2=$1*$3' inputfile > outputfile |
| 327 |
> |
rcalc \-e '$1=sqrt($2);$2=$1*$3' inputfile > outputfile |
| 328 |
> |
.SH ENVIRONMENT |
| 329 |
> |
RAYPATH the directories to check for auxiliary files. |
| 330 |
|
.SH AUTHOR |
| 331 |
|
Greg Ward |
| 332 |
|
.SH BUGS |
| 336 |
|
.PP |
| 337 |
|
Tabs count as single spaces inside fields. |
| 338 |
|
.SH "SEE ALSO" |
| 339 |
< |
cnt(1), ev(1), getinfo(1), icalc(1), rlam(1), tabfunc(1), total(1) |
| 339 |
> |
cnt(1), ev(1), getinfo(1), icalc(1), rcollate(1), rlam(1), tabfunc(1), total(1) |
