DataMuseum.dk

top - download

    Length: 2233 (0x8b9)
    Types: TextFile
    Names: »trans.1«

└─⟦87ddcff64⟧ Bits:30001253 CPHDIST85 Tape, 1985 Autumn Conference Copenhagen
    └─ ⟦this⟧ »cph85dist/stat/doc/man/trans.1« 

TextFile

.TH TRANS 1 "March 5, 1985" "UNIX|STAT 5.0" "UNIX User's Manual"
.SH NAME
trans \- transform numerical input columns
.SH SYNOPSIS
.B trans
operations
.SH DESCRIPTION
.I Trans
allows a series of simple transformations
on numerical input columns.
Each command line option defines a simple transformation
with a single character operation
and a numerical operand.
The final value is printed by itself on a line,
thus, the output of
.I trans
is always a single column.
These output columns can be combined using
.I abut.
.SS Operations
.TP
.B =
value = operand.
The output value is set to the following operand.
This operation is usually the first on a line.
Without it, the output value defaults to the input line number.
.TP
.B +
value = value + operand.
.TP
.B -
value = value - operand.
.TP
.B *
value = value * operand.
.TP
.B /
value = value / operand.
.TP
.B ^
value = value ^ operand.
This is the power function, value to the operand exponent.
.TP
.B a
value = abs (value).
.TP
.B f
value = floor (value).
.TP
.B c
value = ceil (value).
.TP
.B s
value = sqrt (value).
.TP
.B l
value = log (value).
.TP
.B L
value = log10 (value).
.TP
.B e
value = exp (value).
.SS Operands
.TP
.B xN
The letter 'x' followed by an integer column number
is replaced by the input column value.
.TP
.B N
A number, integer or floating point, is used as the operand
to the operation.
.SH EXAMPLE
The following produces the product of the first two columns
added to the third column.
Note that the quotes are required because the * is a special
character in the shell.
.ce
trans =x1 "*x2" +x3
The following produces the logarithm of the square root of twice column 2.
.ce
trans =x2 "*2" sqrt log
Note that only the first character of the unary operations sqrt and log
are meaningful.
.SH DIAGNOSTICS
At most 100 columns are allowed.
At most 20 operations are allowed.
Illegal operations are caught before they are done.
.SH SEE\ ALSO
unixstat(1), abut(1), dm(1)
.SH AUTHOR
Gary Perlman
.SH BUGS
Fields longer than 20 characters are truncated without comment.
For numerical fields, this is not a problem.

.I Trans
is a primitive replacement for
systems that cannot compile
.I dm.
.SH KEYWORDS
statistics, data analysis, data manipulation/transformation