Next Previous Up Contents

`tcube`

: Calculates N-dimensional histograms
`tcube`

constructs an N-dimensional histogram, or density map,
from N columns of an input table, and writes it out as an
N-dimensional data cube. The parameters you supply define which N
numeric columns of the input table you want to use and the dimensions
(bounds and pixel sizes) of the output grid.
Each table row then defines a point in N-dimensional space.
The program goes through each row, and if the point that row
defines falls within the bounds of the output grid you have defined,
increments the value associated with the corresponding pixel.
The resulting N-dimensional array, whose pixel values represent a
count of the rows associated with that region of the N-dimensional space,
is then written out as a FITS file.
In one dimension, this gives you a normal histogram of a given variable.
In two dimensions it might typically be used to plot the density on
the sky of objects from a catalogue.

As with some of the other generic table commands,
you can perform extensive pre-processing on the input table by
use of the `icmd`

parameter before the actual cube
counts are calculated.

Next Previous Up Contents

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