.TH STILTS-CALC 1 "Mar 2017" "" "Stilts commands"
.SH NAME
stilts-calc \- Evaluates expressions
.SH SYNOPSIS
.ad l
.HP 12
.hy 0
\fBstilts calc\fR [expression=\fI<expr>\fR] [table=\fI<table>\fR]
.hy
.ad
.SH DESCRIPTION
.PP
\fIcalc\fR is a very simple utility for evaluating expressions. It uses the same expression evaluator as is used in \fItpipe\fR and the other generic table tasks for things like creating new columns, so it can be used as a quick test to see what expressions work, or in order to evaluate expressions using the various algebraic functions documented in SUN/256. Since usually no table is involved, you can't refer to column names in the expressions. It has one mandatory parameter, the expression to evaluate, and writes the result to the screen. 

.SH OPTIONS
.TP
\fBexpression=\fI<expr>\fR
.RS
An expression to evaluate. The functions in SUN/256 can be used. 

.RE
.TP
\fBtable=\fI<table>\fR
.RS
A table which provides the context within which \fIexpression\fR is evaluated. This parameter is optional, and will usually not be required; its only purpose is to allow use of constant expressions (table parameters) associated with the table. These can be referenced using identifiers of the form \fIparam$*\fR, \fIucd$*\fR or \fIutype$*\fR - see SUN/256 for more detail. 

.RE
.SH SEE ALSO
\fBstilts\fR(1)
.PP
If the package stilts-doc is installed,
the full documentation \fBSUN/256\fR is available in HTML format:
.br
\%file:///usr/share/doc/stilts/sun256/index.html
.SH VERSION
STILTS version 3.4.7-debian
.PP
This is the Debian version of Stilts, which lack the support
of some file formats and network protocols. For differences see
.br
\%file:///usr/share/doc/stilts/README.Debian
.SH AUTHOR
Mark Taylor (Bristol University)