help diplot
-------------------------------------------------------------------------------

Title

    diplot -- double interval plot


Syntax

        diplot shape yvar evar xvar uvar [if] [in] [, options]

        diplot shape y1var y2var x1var x2var [if] [in] , limits [options]

        where shape is one of

        rectangle          rectangle with sides parallel to axes
        plus               intersecting horizontal and vertical lines
        capplus            as above, but line ends capped
        diamond            diamond, with diagonals parallel to axes
        barrow             bidirectional arrow

    options                        Description
    -------------------------------------------------------------------------
    Interpretation of variables
      limits                       variables are to be interpreted as
                                     vertical and horizontal limits

    Main plot
      shape()                      affect rendering of shape
      twoway_options               affect other features of graph

    Add plot
      addplot(plot)                add other plots to the generated graph

    -------------------------------------------------------------------------


Description

    diplot produces double interval plots using various specified shapes
    whose vertical and horizontal extents are specified by variables.

    With the first syntax diplot produces symbols extending vertically from
    yvar - evar to yvar + evar and horizontally from xvar - uvar to xvar +
    uvar. evar and uvar must contain non-negative values.

    With the second syntax, flagged by the limits option, diplot produces
    symbols extending vertically from yvar1 to yvar2 and horizontally from
    xvar1 to xvar2. Each symbol will have centres at (x1var + x2var)/2,
    (y1var + y2var)/2.


Options

        +-----------------------------+
    ----+ Interpretation of variables +--------------------------------------

    limits specifies that the four variables specified are to be interpreted
        as lower and upper vertical and horizontal limits.

        +-----------+
    ----+ Main plot +--------------------------------------------------------

    shape() specifies options that affect rendering of the shapes defining
        the double intervals.  Know that shapes rectangle, plus and diamond
        entail calls to twoway pcspike and that shapes capplus and barrow
        entail calls to twoway pcbarrow. Thus their options may be specified
        as appropriate.

    twoway_options() are options of graph twoway controlling other features
        of the graph.

        +----------+
    ----+ Add plot +---------------------------------------------------------

    addplot(plot) provides a way to add other plots to the generated graph.
        See addplot_option.


Examples

    . diplot capplus y yerror x xerror, shape(lcolor(blue) mcolor(blue))
        addplot(scatter y x, color(blue))

    . diplot rectangle y1 y2 x1 x2, limits title(y versus x)


Acknowledgments

    Vince Wiggins made encouraging noises. Nick Winter helpfully pointed out
    a silly bug.


Author

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


Also see

    Manual:  [G] twoway

    Online:  twoway