Next Previous Up Contents
Next: addpixsample
Up: Processing Filters
Previous: Processing Filters

#### 6.1.1 `addcol`

Usage:

       addcol [-after <col-id> | -before <col-id>]
              [-units <units>] [-ucd <ucd>] [-utype <utype>] [-xtype <xtype>]
              [-desc <descrip>] [-shape <n>[,<n>...][,*]] [-elsize <n>]
              <col-name> <expr>

Add a new column called `<col-name>` defined by the algebraic expression `<expr>`. By default the new column appears after the last column of the table, but you can position it either before or after a specified column using the `-before` or `-after` flags respectively.

The `-units`, `-ucd`, `-utype`, `-xtype` and `-desc` flags can be used to define textual metadata values for the new column.

The `-shape` flag can also be used, but is intended only for array-valued columns, e.g. `-shape 3,3` to declare a 3x3 array. The final entry only in the shape list may be a "`*`" character to indicate unknown extent. Array values with no specified shape effectively have a shape of "`*`". The `-elsize` flag may be used to specify the length of fixed length strings; use with non-string columns is not recommended.

Syntax for the `<expr>` and `<col-id>` arguments is described in the manual.

Next Previous Up Contents
Next: addpixsample
Up: Processing Filters
Previous: Processing Filters

STILTS - Starlink Tables Infrastructure Library Tool Set
Starlink User Note256
STILTS web page: http://www.starlink.ac.uk/stilts/
Author email: m.b.taylor@bristol.ac.uk
Mailing list: topcat-user@jiscmail.ac.uk