TITLE(xgobi @@ XGobi:  A Dynamic Graphics Program for Data Analysis)
USAGE(
xgobi(matrx, collab = NULL, rowlab = NULL,
      colors = NULL, glyphs = NULL, erase = NULL, lines = NULL,
      linecolors = NULL, resources = NULL, title = NULL,
      vgroups = NULL, std = LANG("mmx"), dev = 2.0, nlinkable = 0,
      display = NULL, name = NULL, mach = NULL)
)
ARGUMENTS(
ARG(matrx @@ Any numeric matrix)
ARG(collab @@ 
Optional character vector of column labels; the default is
LANG(dimnames(matrx)[[2]]).  If no default exists, xgobi constructs its
own defaults.)
ARG(rowlab @@
Optional character vector of row labels; the default is
LANG(dimnames(matrx)[[1]]).  If no default exists, xgobi constructs its
own defaults.)
ARG(colors @@
Optional character vector, used to supply colors to be used on startup;
the default is that all points are the same color.)
ARG(glyphs @@
Optional integer vector, used to supply glyphs to be used on startup;
the default is that all points are drawn with the same glyph.)
ARG(erase @@
Optional integer vector of length equal to the number of rows in the
data and composed of 1s and 0s.  A 1 in position i specifies that 
point i should be erased.  The default is a vector of 0s.)
ARG(lines @@
Optional integer matrix, n by 2, which specifies by row number pairs of
points to be connected by line segments.  The default connecting line
matrix connects each point to the one that follows it in the data; that
is, (1 2), (2 3), (3 4), ..., (n-1, n).)
ARG(linecolors @@
Optional integer vector, of length n where n is the number of lines
specified by the 'lines' argument.  It is used to supply line colors to
be used on startup; the default is for all the lines to be drawn in the
standard foreground color.)
ARG(resources @@
Optional character vector created by clicking on the "Save Resources"
button in XGobi (if this XGobi was initiated during an R session).)
ARG(title @@
Optional character string which defines the LANG(-title) argument used
by X. The default is the name of the current matrix LANG(matrx).  See
documentation for xgobi, or for X.)
ARG(vgroups @@ 
Optional integer vector, used to assign columns to groups for
transformation and axis scaling.  This vector must contain one integer 
for each variable.  Columns to be grouped together should share the
same integer.  Default is the vector LANG(1:(ncol(matrx))).)
ARG(std @@
Optional string; which standardization of view to use.  Default is
LANG("mmx"), minimum-maximum scaling, in which the view is centered at
the midpoint of the data, and all the data fits inside the plotting
window.  Alternatives are LANG("msd"), in which the plot is centered at
the mean of the data and LANG(dev) standard deviations fit inside the
plotting region, or LANG("mmd"), in which the plot is centered at the
median and LANG(dev) median absolute deviations are shown inside the
plotting window.)
ARG(dev @@
Optional numeric scalar; the number of standard deviations (if
LANG("msd") is chosen) or median absolute deviations (if LANG("mmd") is
chosen) that will be plotted inside the plotting window.  Default is 2.)
ARG(nlinkable @@
Optional integer scalar, the number of rows to be used in linking of
brushing and identification;  the default is for all rows to be used.
This feature can be used to link ordinary scatterplots with plots that
have some decorations requiring additional points, such as clustering
trees.)
ARG(display @@
Optional character string, identifying the monitor on which to display
the xgobi window.  The default is LANG("machine:0.0") where `machine' is
the name of the user's workstation.  See documentation for xgobi or for
X.)
ARG(name @@
Optional character string which defines the LANG(-name) argument used by
X. The default is the name of the current matrix matrx.  See
documentation for xgobi, or for X.)
ARG(mach @@
Optional characracter string identifying the machine architecture
in use.  This is useful on networked file systems as a way to indicate
where to find the xgobi executable.  Examples are LANG("sun4") or
LANG("dec3100").  XGobi attempts to determine the correct architecture
by looking for certain system files.)
)
VALUE(
The xgobi function executes a call to the C program of the same name, an
interactive statistical graphics program which runs under the X Window
System, and returns control to the user. 

XGobi can be used to create vectors of brushing information and rotation
coefficients; see the documentation for XGobi for details.
)
REFERENCES(
``User's Manual for XGobi, a Dynamic Graphics Program for Data Analysis
Implemented in the X Window System (Release 2),''  Swayne, D. F., Cook,
D., and Buja, A., Bellcore Technical Memorandum, 1992.
)
EXAMPLES(
xgobi(x) 
xgobi(cbind(x, y, z), name = "laser")
xgobi(x, collabels, rowlabels)
)
