1 |
.\" RCSid "$Id$" |
2 |
.TH TABFUNC 1 10/8/97 RADIANCE |
3 |
.SH NAME |
4 |
tabfunc - convert table to functions for rcalc, etc. |
5 |
.SH SYNOPSIS |
6 |
.B tabfunc |
7 |
[ |
8 |
.B \-i |
9 |
] |
10 |
func1 [func2 ..] |
11 |
.SH DESCRIPTION |
12 |
.I Tabfunc |
13 |
reads a table of numbers from the standard input and converts it to |
14 |
an expression suitable for |
15 |
.I calc(1), |
16 |
.I rcalc(1) |
17 |
and their cousins. |
18 |
The input must consist of a M x N matrix of real numbers, with exactly |
19 |
one row per line. |
20 |
The number of columns must always be the same in each line, |
21 |
separated by whitespace and/or commas, with no missing values. |
22 |
The first column is always the independent variable, whose value |
23 |
indexes all of the other elements. |
24 |
This value does not need to be evenly spaced, but it must be either |
25 |
monotonically increasing or monotonically decreasing. |
26 |
(I.e. it cannot go up and then down, or down and then up.)\0 |
27 |
Maximum input line width is 4096 characters and the maximum number of |
28 |
data rows is 1024. |
29 |
Input lines not beginning with a numerical value will be silently ignored. |
30 |
.PP |
31 |
The command-line arguments given to |
32 |
.I tabfunc |
33 |
are the names to be assigned to each column. |
34 |
.I Tabfunc |
35 |
then produces a single function for each column given. |
36 |
If there are some columns which should be skipped, the dummy name |
37 |
"0" may be given instead of a valid identifier. |
38 |
(It is not necessary to specify a dummy name for extra columns at |
39 |
the end of the matrix.)\0 |
40 |
.PP |
41 |
The |
42 |
.I \-i |
43 |
option causes |
44 |
.I tabfunc |
45 |
to produce a description that will interpolate values in between |
46 |
those given for the independent variable on the input. |
47 |
.SH EXAMPLE |
48 |
To convert a small data table and feed it to rcalc for some |
49 |
calculation: |
50 |
.IP "" .2i |
51 |
rcalc -e `tabfunc f1 f2 < table.dat` -f com.cal |
52 |
.SH AUTHOR |
53 |
Greg Ward |
54 |
.SH "SEE ALSO" |
55 |
cnt(1), lam(1), neat(1), rcalc(1), total(1) |