--- ray/doc/man/man1/rcalc.1 2013/09/05 17:53:22 1.10 +++ ray/doc/man/man1/rcalc.1 2017/10/10 16:10:14 1.13 @@ -1,4 +1,4 @@ -.\" RCSid "$Id: rcalc.1,v 1.10 2013/09/05 17:53:22 greg Exp $" +.\" RCSid "$Id: rcalc.1,v 1.13 2017/10/10 16:10:14 greg Exp $" .TH RCALC 1 4/6/99 RADIANCE .SH NAME rcalc - record calculator @@ -23,6 +23,10 @@ rcalc - record calculator ][ .B "\-o format" ][ +.B "\-in M" +][ +.B "\-on M" +][ .B "\-f source" ][ .B "\-e expr" @@ -92,9 +96,25 @@ With both input and output formats, the passive mode c effectively substitute information in the middle of a file or stream without affecting the rest of the data. .PP +If a +.I \-in +option is given with a positive integer argument, +.I rcalc +will stop processing input once it has loaded this number of records. +Similarly, if a +.I \-on +option is present, +.I rcalc +will stop after producing this many records, which may be a smaller +number if the +.I cond +variable is used. +If multiple input files are given, these counts are continuous over +the input and do not reset on each file. +.PP The variable and function definitions in each .I \-f source -file are read and compiled. +file are read and compiled from the RADIANCE library where it is found. The .I \-e expr option can be used to define variables on the command line. @@ -235,7 +255,7 @@ are evaluated. This provides a convenient method for avoiding inappropriate calculations. The following library of pre-defined functions and variables is provided: .TP 10n -.BR \$N +.BR $N Return the value for input column .I N. If an input format is given, using a channel number generates an error. @@ -305,6 +325,8 @@ To print the square root of column two in column one, and column one times column three in column two: .IP "" .2i rcalc \-e '$1=sqrt($2);$2=$1*$3' inputfile > outputfile +.SH ENVIRONMENT +RAYPATH the directories to check for auxiliary files. .SH AUTHOR Greg Ward .SH BUGS