XStringViews-constructors     package:Biostrings     R Documentation

_B_a_s_i_c _f_u_n_c_t_i_o_n_s _f_o_r _c_r_e_a_t_i_n_g _o_r _m_o_d_i_f_y_i_n_g _X_S_t_r_i_n_g_V_i_e_w_s _o_b_j_e_c_t_s

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

     A set of basic functions for creating or modifying XStringViews
     objects.

_U_s_a_g_e:

       adjacentViews(subject, width, gapwidth=0)
       XStringViews(x, subjectClass, collapse="")

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

 subject: An XString object or a single string. 

   width: An integer vector containing the widths of the views. 

gapwidth: An integer vector containing the widths of the gaps between
          the views. 

       x: An XString object or a character vector for 'XStringViews'. 

subjectClass: The class to be given to the subject of the XStringViews
          object created and returned by the function. Must be the name
          of one of the direct XString subclasses i.e. '"BString"',
          '"DNAString"', '"RNAString"' or '"AAString"'. 

collapse: An optional character string to be inserted between the views
          of the XStringViews object created and returned by the
          function. 

_D_e_t_a_i_l_s:

     The 'adjacentViews' function returns an XStringViews object
     containing views on 'subject' with widths given in the 'width'
     vector and separated by gaps of width 'gapwidth'. The first view
     starts at position 1.

     The 'XStringViews' constructor will try to create an XStringViews
     object from the value passed to its 'x' argument. If 'x' itself is
     an XStringViews object, the returned object is obtained by
     coercing its subject to the class specified by 'subjectClass'. If
     'x' is an XString object, the returned object is made of a single
     view that starts at the first letter and ends at the last letter
     of 'x' (in addition 'x' itself is coerced to the class specified
     by 'subjectClass' when specified). If 'x' is a character vector,
     the returned object has one view per character string in 'x' (and
     its subject is an instance of the class specified by
     'subjectClass').

_V_a_l_u_e:

     These functions return an XStringViews object 'y'. 'length(y)'
     (the number of views in 'y') is 'length(width)' for the
     'adjacentViews' function. For the 'XStringViews' constructor,
     'length(y)' is '1' when 'x' is an XString object and 'length(x)'
     otherwise.

_S_e_e _A_l_s_o:

     XStringViews-class, XString-class

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

       adjacentViews("abcdefghij", 4:2, gapwidth=1)

       v12 <- Views(DNAString("TAATAATG"), start=-2:9, end=0:11)
       XStringViews(v12, subjectClass="RNAString")
       XStringViews(AAString("MARKSLEMSIR*"))
       XStringViews("abcdefghij", subjectClass="BString")

