GINO Graphics Suite - GINOGRAF v9.5  

ggAddHistogramOutline

Syntax

[C/C++:]
void ggAddHistogramOutline(int ncols, float *yarray, float frac);
[F90:]
subroutine ggAddHistogramOutline(ncols, yarray, frac)

integer, intent(in) :: ncols
real, intent(in) :: yarray(*), frac

Arguments

ncols
The number of columns to be plotted

yarray
Array, of dimension ncols, giving the heights of the columns to be plotted on the Histogram

frac
Fraction of an interval to be occupied by each column

Description

The routine ggAddHistogramOutline() draws a Histogram of ncols columns, with heights defined in array yarray, with respect to the current axes, as set up by the last axis definition calls. The columns in the Histogram have the width:

((length of X axis)/ncols) * frac

If frac = 1.0, only the necessary verticals are drawn, ie, lines common to two columns are omitted. If frac = 0.0, two coincident vertical lines are drawn centred on the tick mark. If frac < 0.0, the default value is 0.0 and if frac > 1.0, the default value is 1.0.

The columns are centred on the tick marks on the discrete axis. If a discrete axis has not been defined using ggSetAxesScaling() (ie, scale = GDISCRETE), or both axes have been defined as discrete axes, the discrete axis is assumed to be the X axis. Linear scaling is assumed as the default for the Y axis.

If a height defined in array yarray is negative, the column is drawn on the negative side of the discrete axis.

See Also

ggAddHistogramOutline Usage
ggPlotHistogram
ggFillHistogram
ggAddHistogramValues