

xgobi(xgobi)                                 R Documentation

_X_G_o_b_i_: _D_y_n_a_m_i_c _G_r_a_p_h_i_c_s _f_o_r _D_a_t_a _A_n_a_l_y_s_i_s

_D_e_s_c_r_i_p_t_i_o_n_:

     Dynamic graphics, including  brushing, rotation, grand
     tour, projection pursuit, slicing. Most effectively
     used when called more than once on same data, which
     then allows linked plots.  Brushing with several glyphs
     and colors is supported.  (On monochrome displays, only
     glyphs can be used.)

_U_s_a_g_e_:

     xgobi(matrx,
     collab=NULL, rowlab=NULL,
     colors=NULL, glyphs=NULL, erase=NULL,
     lines=NULL, linecolors=NULL,
     resources=NULL, title=NULL,
     vgroups=NULL, std="mmx", dev=2.0,
     nlinkable=0, subset=NULL,
     display=NULL)

_A_r_g_u_m_e_n_t_s_:

   matrx: Any numeric matrix or data.frame.

  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 initial
          point colors to be used; 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 S session).

   title: Optional character string which defines the
          `-title' argument used by X. The default is the
          name of the current matrix matrx.  See documenta-
          tion 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.

  subset: Optional integer scalar, the number of rows to be
          included in the initial display.  That is, all
          data will be read in, but an initial random sample
          will be drawn for display.  Use the Subset panel
          on the Tools Menu to select a new subset during
          the session.

 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.

_V_a_l_u_e_:

     The UNIX `status' upon completion, i.e. `0' if ok.

_S_i_d_e _E_f_f_e_c_t_s_:

     The xgobi S 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 of the S shell to the user.

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

_C_O_N_T_A_C_T_:

     D. F. Swayne dfs@research.att.com

_R_e_f_e_r_e_n_c_e_s_:

     http://www.research.att.com/areas/stat/xgobi/
     http://www.public.iastate.edu/~dicook/

_E_x_a_m_p_l_e_s_:

     data(laser)
     xgobi(laser)

