GINO Graphics Suite - GINOGRAF v9.5  

ggPlotHistogram

Syntax

[C/C++:]
void ggPlotHistogram(int ncols, float *yarray, float frac, int scy, float vbeg, float vend);
[F90:]
subroutine ggPlotHistogram(ncols, yarray, frac, scy, vbeg, vend)

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

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

scy
The type of scaling used on the Y axis

= GLINEAR Linear scale on Y axis
= GLOG10 Log10 scale on Y axis

vbeg
Value specifying the centre value of the first column on the X axis

vend
Value specifying the centre value of the last column on the X axis

Description

The routine ggPlotHistogram() draws a frame to fit the available drawing area or current window and plots a Histogram within it. The columns on 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. Each column has the height defined in array yarray.

The Histogram is automatically scaled and annotated to make maximum use of the drawing area. If vbeg = vend, no numeric annotation is written on the X axis. The type of scaling on the continuous axis is defined by the value given in scy. The default axes annotation may be changed using the routines ggSetAxesAnnotation() and/or ggSetAxesAttribs().

See Also

ggPlotHistogram Usage
ggSetAxesAnnotation
ggSetAxesAttribs
ggSetPlotFrame
ggFillHistogram
ggAddHistogramValues