.-
help for ^cihplot^
.-

Horizontally labelled plots showing confidence intervals
--------------------------------------------------------

    ^cihplot^ varlist [^if^ exp] [^in^ range] [weight]
    [ ^, lev^el^(^#^) p^oisson^ bin^omial ^e^xposure^(^varname^)^
    ^two^tier ^shown^ hplot_options ]
    
    ^cihplot^ varname [^if^ exp] [^in^ range] [weight] [ ^, by(^byvar^)^
    ^lev^el^(^#^) p^oisson^ bin^omial ^e^xposure^(^varname^)^
    ^t^otal ^two^tier ^shown^  hplot_options ]

Description
-----------

^cihplot^ produces a display of means and confidence intervals for 
different variables, or for different groups of a single variable 
defined by the ^by^ option. 

^ci^ is used for the calculations. ^hplot^ is used for the graphical
display. 


Options
-------

^by(^byvar^)^ defines a grouping variable. It is only allowed when a 
    single variable is specified. 

^level(^#^)^, ^poisson^, ^binomial^ and ^exposure(^varname^)^ are all
    options of ^ci^. See help on @ci@.

^total^ adds a final line showing the mean and confidence interval for
    all groups specified. It is only allowed in conjunction with ^by( )^. 

^twotier^ adds a 50% confidence interval to the default interval 
    determined by ^level( )^. Typically, but not necessarily, this 50%
    interval will be inside the default interval.    
    
^shown^ specifies that the number of values should be shown in the 
    ^rlegend( )^. By default this is right-justified with a horizontal 
    position ^rlpos(31500)^. 

hplot_options are any options of ^hplot^. See help on @hplot@. 

    ^range^ and ^line^ are wired in. 

    ^symbol^ defaults to ^"|O|"^ (vertical bars for the limits and a 
    circle for the mean) or, if ^twotier^ is specified, to ^"|,O,|"^ (that 
    and shorter vertical bars for the 50% limits). 


Example
-------

    . ^cihplot length, by(grade) xla(0(200)1200)^
      ^t2(means and 95% confidence intervals) 


Author
------

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


Also see
--------

On-line: help for @hplot@, @ci@

