

   XXGGoobbii::  AA DDyynnaammiicc GGrraapphhiiccss PPrrooggrraamm ffoorr DDaattaa AAnnaallyyssiiss

        xgobi(matrx, collab = NULL, rowlab = NULL,
              colors = NULL, glyphs = NULL, erase = NULL, lines = NULL,
              linecolors = NULL, resources = NULL, title = NULL,
              vgroups = NULL, std = this-is-escaped-codenormal-bracket3bracket-normal, dev = 2.0, nlinkable = 0,
              display = NULL, name = NULL, mach = NULL)

   AArrgguummeennttss::

      matrx: Any numeric matrix

     collab: Optional character vector of column labels; the
             default is `dimnames(matrx)[[2]]'.  If no default
             exists, xgobi constructs its own defaults.

     rowlab: Optional character vector of row labels; the
             default is `dimnames(matrx)[[1]]'.  If no default
             exists, xgobi constructs its own defaults.

     colors: Optional character vector, used to supply colors
             to be used on startup; the default is that all
             points are the same color.

     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.

      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.

      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).

   linecolors: Optional integer vector, of length n where n is
             the number of lines specified by the 'lines' argu
             ment.  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.

   resources: Optional character vector created by clicking on
             the "Save Resources" button in XGobi (if this
             XGobi was initiated during an R session).

      title: Optional character string which defines the
             `-title' argument used by X. The default is the
             name of the current matrix `matrx'.  See documen
             tation for xgobi, or for X.

    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
             `1:(ncol(matrx))'.

        std: Optional string; which standardization of view to
             use.  Default is `"mmx"', minimum-maximum scaling,
             in which the view is centered at the midpoint of
             the data, and all the data fits inside the plot
             ting window.  Alternatives are `"msd"', in which
             the plot is centered at the mean of the data and
             `dev' standard deviations fit inside the plotting
             region, or `"mmd"', in which the plot is centered
             at the median and `dev' median absolute deviations
             are shown inside the plotting window.

        dev: Optional numeric scalar; the number of standard
             deviations (if `"msd"' is chosen) or median abso
             lute deviations (if `"mmd"' is chosen) that will
             be plotted inside the plotting window.  Default is
             2.

   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 fea
             ture can be used to link ordinary scatterplots
             with plots that have some decorations requiring
             additional points, such as clustering trees.

    display: Optional character string, identifying the monitor
             on which to display the xgobi window.  The default
             is `"machine:0.0"' where `machine' is the name of
             the user's workstation.  See documentation for
             xgobi or for X.

       name: Optional character string which defines the
             `-name' argument used by X. The default is the
             name of the current matrix matrx.  See documenta
             tion for xgobi, or for X.

       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
             `"sun4"' or `"dec3100"'.  XGobi attempts to deter
             mine the correct architecture by looking for cer
             tain system files.

   VVaalluuee::

        The xgobi function executes a call to the C program of
        the same name, an interactive statistical graphics pro
        gram which runs under the X Window System, and returns
        control to the user.

        XGobi can be used to create vectors of brushing infor
        mation and rotation coefficients; see the documentation
        for XGobi for details.

   RReeffeerreenncceess::

        ``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.

   EExxaammpplleess::

        xgobi(x)
        xgobi(cbind(x, y, z), name = "laser")
        xgobi(x, collabels, rowlabels)

