The SDL Component Suite is an industry leading collection of components supporting scientific and engineering computing. Please visit the SDL Web site for more information....



SetEqualRange


Unit:SDL_rchart
Class:TRChart
Declaration:procedure SetEqualRange (Layers: TLayerSet);

The method SetEqualRange sets the extents of all layers specified by the parameter Layers in a way that all layers use the same scale. The new common scale is derived from the minimum and maximum ranges of the individual scales.

Hint: Please note the subtle difference between SetEqualRange and AutoRange. While AutoRange actually adjusts the scales to cover the entire data range, SetEqualRange compares only the current scale settings to find the maximum common range of all scales of the specified layers.

Example: This method is primarily used to ensure comparable scales for a set of layers. Let us assume that we have three layers, 2, 3, and 6, with the following ranges of their respective axes:
  Layer 2: x-axis ..... -3 to +20
           y-axis ..... 0 to +100
  Layer 3: x-axis ..... 0 to +1
           y-axis ..... -20 to -1
  Layer 6: x-axis ..... -5 to +10
           y-axis ..... +10 to +20
Executing the statement SetEqualRange ([2,3,6]); changes the ranges of these three layers as follows:
  all three x-axis: .... -5 to +20
  all three y-axis: .... -20 to +100
Thus all the data is now displayed using the common, comparable scale.



Last Update: 2023-Dec-13