boot2fuzzy              package:hopach              R Documentation

_f_u_n_c_t_i_o_n _t_o _w_r_i_t_e _M_a_p_l_e_T_r_e_e _f_i_l_e_s _f_o_r _v_i_e_w_i_n_g _b_o_o_t_s_t_r_a_p _e_s_t_i_m_a_t_e_d _c_l_u_s_t_e_r _m_e_m_b_e_r_s_h_i_p _p_r_o_b_a_b_i_l_i_t_i_e_s _b_a_s_e_d _o_n _h_o_p_a_c_h _c_l_u_s_t_e_r_i_n_g _r_e_s_u_l_t_s

_D_e_s_c_r_i_p_t_i_o_n:

     The MapleTree software (http://mapletree.sourceforge.net/) is an
     open source, cross-platform, visualization tool to graphically
     browse results of cluster analyses. The 'boot2fuzzy' function
     takes a data matrix, plus corresponding 'hopach' clustering output
     and bootstrap resampling output, and writes the (.cdt, .fct, and
     .mb) files needed to view these "fuzzy clustering" results in
     MapleTree.

_U_s_a_g_e:

     boot2fuzzy(data, bootobj, hopach.genes, hopach.arrays = NULL, 
     file="hopach", clust.wts = NULL, gene.wts = NULL, array.wts = NULL, 
     gene.names = NULL)

_A_r_g_u_m_e_n_t_s:

    data: data matrix, data frame or exprSet of gene expression
          measurements. Each column corresponds to an array, and each
          row corresponds to a gene. All values must be numeric.
          Missing values are ignored.

 bootobj: output of 'boothopach' or 'bootmedoids' applied to the genes
          - a matrix of bootstrap estimated cluster membership
          probabilities, with a row for each row in 'data' and a column
          for each cluster.

hopach.genes: output of the 'hopach' function applied to genes (rows of
          'data'.

hopach.arrays: optional output of the 'hopach' function applied to
          arrays (columns of 'data'.

    file: name for the output files (the extensions .cdt, .mb and .fct
          will be added).

clust.wts: an optional vector of numeric weights for the clusters.

gene.wts: an optional vector of numeric weights for the genes.

array.wts: an optional vector of numeric weights for the arrays.

gene.names: optional vector of names or annotations for the genes,
          which can be different from the row names of 'data'

_V_a_l_u_e:

     The function 'boot2fuzzy' has no value. It writes three text files
     to the current working directory.

_N_o_t_e:

     Thank you to Lisa Simirenko <lsimirenko@lbl.gov> for providing
     HOPACH views in MapleTree, and to Karen Vranizan
     <vranizan@uclink.berkeley.edu> for her input. The MapleTree
     software can be downloaded from:
     http://sourceforge.net/projects/mapletree/

_A_u_t_h_o_r(_s):

     Katherine S. Pollard <kpollard@gladstone.ucsf.edu>

_R_e_f_e_r_e_n_c_e_s:

     van der Laan, M.J. and Pollard, K.S. A new algorithm for hybrid
     hierarchical clustering with visualization and the bootstrap.
     Journal of Statistical Planning and Inference, 2003, 117, pp.
     275-303.

     <URL:
     http://www.stat.berkeley.edu/~laan/Research/Research_subpages/Papers/hopach.pdf>

_S_e_e _A_l_s_o:

     'hopach', 'boothopach', 'bootmedoids', 'hopach2tree'

_E_x_a_m_p_l_e_s:

     #25 variables from two groups with 3 observations per variable
     mydata<-rbind(cbind(rnorm(10,0,0.5),rnorm(10,0,0.5),rnorm(10,0,0.5)),cbind(rnorm(15,5,0.5),rnorm(15,5,0.5),rnorm(15,5,0.5)))
     dimnames(mydata)<-list(paste("Var",1:25,sep=""),paste("Exp",1:3,sep=""))
     mydist<-distancematrix(mydata,d="cosangle") #compute the distance matrix.

     #clusters and final tree
     clustresult<-hopach(mydata,dmat=mydist)

     #bootstrap resampling
     myobj<-boothopach(mydata,clustresult)

     #write MapleTree files
     boot2fuzzy(mydata,myobj,clustresult)

