help bubblecoord (2011-04-27)

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

itemlabel(varname) String variable with names of item or
country; used to create value labels for the coordinate variable.

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

Options for types

typeLlabel(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; default
of 1 is standard gap; increasing gapevery increases gap.

Options for arranging

itemvar(varname) Numeric variable used to sort items.

itemsort(sort-options) By default, do not sort.
ascend for ascending sort. descend for descending sort.

itemlist(numeric-list) Arrange in this order; cannot be
used with itemsort().

typevar(varname) Variable used to sort types.

typesort(sort-options) By default, do not sort.
ascend for ascending sort. descend for descending sort.

typelist(numeric-list) Arrange in this order; cannot be
used with typesort().

Options for plot options

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

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

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

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

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

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

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

Saved returns

bubblecoord saves the following information in r():

Strings

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

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

r(rangestr) Graph options for yrange() or xrange().
For example, local yrangestr = r(yrange)

r(textL) Graph options for left text labels used by
text(). For example, local textLlbl `r(textL)'

r(textR) Graph options for right text labels used by
text(). For example, local textRlbl `r(textR)'

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.