libPaths                package:base                R Documentation

_S_e_a_r_c_h _P_a_t_h_s _f_o_r _P_a_c_k_a_g_e_s

_D_e_s_c_r_i_p_t_i_o_n:

     '.libPaths' gets/sets the library trees within which packages are
     looked for.

_U_s_a_g_e:

     .libPaths(new)

     .Library
     .Library.site

_A_r_g_u_m_e_n_t_s:

     new: a character vector with the locations of R library trees. 
          Tilde expansion ('path.expand') is done, and if any element
          contains one of '*?[', globbing is done where supported by
          the platform: see 'Sys.glob'.

_D_e_t_a_i_l_s:

     '.Library' is a character string giving the location of the
     default library, the 'library' subdirectory of 'R_HOME'.

     '.Library.site' is a (possibly empty) character vector giving the
     locations of the site libraries, by default the 'site-library'
     subdirectory of 'R_HOME' (which may not exist).

     '.libPaths' is used for getting or setting the library trees that
     R knows about (and hence uses when looking for packages).  If
     called with argument 'new', the library search path is set to the
     existing directories in 'unique(c(new, .Library.site, .Library))'
     and this is returned.  If given no argument, a character vector
     with the currently active library trees is returned.

     The library search path is initialized at startup from the
     environment variable 'R_LIBS' (which should be a colon-separated
     list of directories at which R library trees are rooted) followed
     by those in environment variable 'R_LIBS_USER'.  Only directories
     which exist at the time will be included.

     By default 'R_LIBS' is unset, and 'R_LIBS_USER' is set to
     directory 'R/R.version$platform-library/x.y' of the home directory
     (or 'Library/R/x.y/library' for Mac OS X AQUA builds), for R
     x.y.z.

     '.Library.site' can be set via the environment variable 
     'R_LIBS_SITE' (as a colon-separated list of library trees).

     Both 'R_LIBS_USER' and 'R_LIBS_SITE' feature possible expansion of
     specifiers for R version specific information as part of the
     startup process.  The possible conversion specifiers all start
     with a '%' and are followed by a single letter (use '%%' to obtain
     '%'), with currently available conversion specifications as
     follows:

     '%_V' R version number including the patchlevel (e.g., '2.5.0').

     '%_v' R version number excluding the patchlevel (e.g., '2.5').

     '%_p' the platform for which R was built, the value of
          'R.version$platform'.

     '%_o' the underlying operating system, the value of 'R.version$os'.

     '%_a' the architecture (CPU) R was built on/for, the value of
          'R.version$arch'.

     (See 'version' for details on R version information.)

     Function '.libPaths' always uses the values of '.Library' and
     '.Library.site' in the base name space.  '.Library.site' can be
     set by the site in 'Rprofile.site', which should be followed by a
     call to '.libPaths(.libPaths())' to make use of the updated value.

_V_a_l_u_e:

     A character vector of file paths.

_R_e_f_e_r_e_n_c_e_s:

     Becker, R. A., Chambers, J. M. and Wilks, A. R. (1988) _The New S
     Language_. Wadsworth & Brooks/Cole.

_S_e_e _A_l_s_o:

     'library'

_E_x_a_m_p_l_e_s:

     .libPaths()                 # all library trees R knows about