help bubblecoord (2011-04-26)

Title

bubblecoord Create coordinates and plot options
for bubble plot

Syntax

bubblecoord
,
options

gen(coord-variable) Specify variable to hold the
coordinates for plotting.

Item or country options

itemstrvar(varname) String variable with names of item or
country.

xcoord Compute only x-coordinates. By default y-coordinates
and plot options are returned by bubblecoord.

Options for types

typestrleft(varname) String variable with type labels to be
located on left; used to create text() options.

typestrright(varname) String variable with type labels to be
located on right; used to create text() options.

Options for adding gaps

gapvar(varname) After sorting the values in this variable
are examined from row 1 to the last row. If the value of this variable
changes, a gap is inserted in the coordinate values to allow space for
labels.

gapvalue(integer) Size of gap to add when value of gapvar
changes. Default is 1 for no extra gap.

gapevery(integer) Add a gap every fixed number of values. Note:
this is not implemented till we decide what we want.

Options for sorting

itemnumvar(varname) Numeric variable used to sort items or
countries.

itemorder(sort-options) By default, do not sort.
ascend for ascending sort. descend for descending sort.
numeric-list will eventually arrange items/countries in order indicated
by list of integers.

typenumvar(varname) Numeric variable used to sort by type.

typeorder(sort-options) How to sort by type; same options
as for itemorder.

Options for plot options

ylineoffset(value) Offset for locating
ylines in graph; default .75.

yscaleoffset(value) Offset of yscale from the minimum and
maximum values of the coordinates; default .25.

textleftoffset(value) X-offset for the left label for type;
default -10.

textrightoffset(value) X-offset for the left label for type;
default .1.

textupoffset(value) Vertical offset for text used to
label types; default .2.

textleftoptions(value) Options for text string for the
left label for the type; default "place(e) just(left) margin(zero)".

textrightoptions(value) ; default "place(w) just(right) margin(zero)".

Saved returns

bubblecoord saves the following information in r():

Strings

r(ylabel) Graph options for ylabel(). For example,
local ylabstr = r(ylabel)

r(yline) Graph options for ylabel(). For example,
local ylinestr = r(yline)

r(yrangestr) Graph options for ylabel(). For example,
local yrangestr = r(yrange)

r(text) Graph options for ylabel(). For example,
textlbl `r(text)'

Description

bubblecoord ...

References

Authors

bubblecoord is not an official Stata command.

If you use these commands, please cite: J. Scott Long and Tait R. Medina
(2011) Creating bubbleplots. For futher information (eventually...),
Bubbleplots.