plotAddBarH

Purpose

Adds horizontal bars to an existing graph.

Format

plotAddBarH([myPlot, ]val, ht)
Parameters:
  • myPlot (struct) – Optional argument. A plotControl structure

  • val (Nx1 numeric vector or Nx1 string array) –

    bar labels.

    Scalar 0

    The new bars will be added consecutively to the existing labels. See the example below.

    Numeric

    val represents the label indices.

    String array

    val represents labels and the bar is added to the existing matching label. If the label in val is not found on the existing graph, the label and associated bar is added to the end of the plot window.

  • ht (NxK numeric vector) –

    bar heights.

    K overlapping or side-by-side sets of N bars will be graphed.

Examples

Example 1: Add bars to existing labels

// Assign labels and bar heights
label = "alpha" $| "beta" $| "gamma";
ht = { 20, 40, 10 };

// Draw initial horizontal bar plot
plotBarH(label, ht);

// Add horizontal bars to the first two labels
ht2 = { 30, 50 };

// When the first input is 0, the new
// bars will be added to the existing bars
// consecutively.
plotAddBarH(0, ht2);
_images/plotaddbarh-cr-1.png

We could also create the same graph shown above, if we changed the zero passed to plotAddBarH() to a vector of indices like this:

indx = { 1, 2 };
plotAddBarH(indx, ht2);

Example 2: Add bars to existing and new labels

// Assign labels and bar heights
label = "alpha" $| "beta" $| "gamma";
ht = { 20, 40, 10 };

// Draw initial horizontal bar plot
plotBarH(label, ht);

// Add horizontal bars to the first label (alpha)
// and add two new labels (delta and epsilon)
ht2 = { 10, 30, 50 };
label_2 = "alpha" $| "delta" $| "epsilon";
plotAddBarH(label_2, ht2);
_images/plotaddbarh-cr-2.png

Remarks

plotAddBarH() may only add bars to 2-D graphs.

This function will not change any of the current graph’s settings other than to resize the view as necessary to display the new curve.