-------------------------------------------------------------------------------
help for circhistogram
-------------------------------------------------------------------------------

Histogram for circular data with wrapping round of bins

circhistogram varname [weight] [if exp] [in range] [ , pad(#) histogram_options ]

fweights are allowed; see help weights.

The abbreviation circhist (only) is allowed.

Description

circhistogram produces a histogram for varname with some wrapping round of bins. varname should be a circular variable taking on values between 0 and 360 degrees.

Options

pad() places a pad of # degrees at each end. Data less than or equal to # degrees are copied at the right end of the axis for a horizontal interval of 360 to 360 + # degrees. Data more than 360 - # degrees are copied at the left end of the axis for a horizontal interval of -# to 0 degrees. The default is 180, so that a full two cycles are shown.

histogram_options are any of the options allowed with histogram, except that at present only the display of frequencies is supported.

Examples

. circhistogram wallasp, start(-180) width(30)

. circhistogram wallasp, pad(90) start(-90) width(30)

Author

Nicholas J. Cox, University of Durham, U.K. n.j.cox@durham.ac.uk

Also see

On-line: help for histogram, circkdensity