Search Locate Previous Next Contents

chNewCell – advance to next cell in trellis

When you have defined the chart area as a rectangular array of cells (trellis) with chSet 'Trellis' you move to the next cell with:

chNewCell

Most of the chart settings are left as they were by this call. For a full reset, call chReset or set the trellis style to ‘reset’.

A typical use of this function would be to plot data from a series of planes of a high-dimensional array:

chSet 'trellis' (1†½mat)
:for plane :in ¼1†½mat
  chNewCell
  chPlot mat[plane;;]
:endfor

You might like to set the Y-axis range outside the loop to ensure comparability between the plots as Rain will auto-range each plot individually by default. Note that for the simple case (as shown above) when you only plot one chart in each cell, you can set the trellis style to ‘skip’ to have RainPro move on to the next cell automatically. See the tutorial on trellis plots for more examples.

See also ...
TrellisStyle – trellis style


Continue to: chNewPage – request a new page
© Copyright Causeway Graphical Systems Ltd 2003