PASS         <data_combine_method>      FIELD            SHARE? N
      PASS         <bar_color_style>          FIELD            SHARE? N
      PASS         <auto_link>                FIELD            SHARE? N
      GOSUB    0CD .XY ADD BAR LAYER

* Opt PASS         <data_combine_method>      FIELD            SHARE? N
* Opt PASS         <bar_color_style>                           SHARE? N
* Opt PASS         <auto_link>                                 SHARE? N
*     GOSUB    0CD .XY ADD BAR LAYER

This subroutine is used to add one or more bar layers to your chart. An XY chart must have at least one Layer.

If you have created your data set before calling this subroutine, then a default data group will be created and linked to this layer automatically.

.XY ADD BAR LAYER

This subroutine adds a Bar layer to the "current" chart spec.

Usage:

      PASS         <data_combine_method>          FIELD            SHARE? N
      PASS         <bar_color_style>              FIELD            SHARE? N
      GOSUB    0CD .XY ADD BAR LAYER
      *        Check for error
      IF       0CD .XY ADD BAR LAYER        NE

Description:

This subroutine adds a Bar layer to the "current" chart spec. You must have intialized the chart as an XY Chart via .CHART INITIALIZE for this to have any effect. This subroutine is typically used to add multiple data sets to a single bar layer. A Bar layer is simply a group of data points you want to plot. An XY chart can have one or more Bar layers. For example, if we wanted to plot sales by month for the current year, that would be one layer. If we wanted to show last years sales as well, that would be a second layer, and so on. Normally, multiple layers are shown separately on XY charts, however, if we want to show everything in one layer, we can use this subroutine to create the layer, then add data using fill me in.

This routine receives two optional values, a <data_combine_method> and a <bar_color_style>.

If we are only going to have one set of data points on our chart, then the <data_combine_method> does not really apply. If we have multiple sets of data points, then the <data_combine_method> will determine how they will be shown. Valid values are:

side - The data sets are combined by plotting the bars side by side.

stack - The data sets are combined by stacking up the bar segments.

overlay - The data sets are combined similar to stacked bars. However, in overlay, one data set is assumed to already include the other data set. For example, if the data sets are "average" and "peak", the "peak" cannot be stacked on top of "average", because the "peak" already contains "average". In the Overlay style, only "peak - average" is stacked on top of "average", and so the total bar length will be "peak".

percentage - The data sets are combined similar to stacked bars, except that the data in a bar are scaled so that they summed to 100. In other words, all stacked bars will be of the same length. A bar segment within a bar represents the percentage of the data item relative to sum of all the data items in the stacked bar.

The default is to plot each data set in it's own layer.

<bar_color_style> must be either blank or 'multiple'. Blank means that every bar in the layer will be the same color. 'Multiple' means that you will set the color of each bar via fill me in.

Comments:

Read what other users have said about this page or add your own comments.

<--/commentPlugin-->

-- JeanNeron - 2011-10-12