R Installation and Administration Version 4.2.0 Under Development (2021-09-29)
Total Page:16
File Type:pdf, Size:1020Kb
R Installation and Administration Version 4.2.0 Under development (2021-09-29) R Core Team This manual is for R, version 4.2.0 Under development (2021-09-29). Copyright c 2001{2021 R Core Team Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies. Permission is granted to copy and distribute modified versions of this manual under the conditions for verbatim copying, provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one. Permission is granted to copy and distribute translations of this manual into an- other language, under the above conditions for modified versions, except that this permission notice may be stated in a translation approved by the R Core Team. i Table of Contents 1 Obtaining R :::::::::::::::::::::::::::::::::::::::::::::::::::: 1 1.1 Getting and unpacking the sources ::::::::::::::::::::::::::::::::::::::::::::::::: 1 1.2 Getting patched and development versions ::::::::::::::::::::::::::::::::::::::::: 1 1.2.1 Using Subversion and rsync ::::::::::::::::::::::::::::::::::::::::::::::::::: 1 2 Installing R under Unix-alikes :::::::::::::::::::::::::::::::: 3 2.1 Simple compilation :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 3 2.2 Help options ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 4 2.3 Making the manuals ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 5 2.4 Installation :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 6 2.5 Uninstallation ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 8 2.6 Sub-architectures :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 8 2.6.1 Multilib::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 9 2.7 Other Options :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 10 2.7.1 Debugging Symbols :::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 10 2.7.2 OpenMP Support :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 11 2.7.3 C++ Support:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 11 2.7.4 Link-Time Optimization ::::::::::::::::::::::::::::::::::::::::::::::::::::: 12 2.7.4.1 LTO with GCC ::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 13 2.7.4.2 LTO with LLVM :::::::::::::::::::::::::::::::::::::::::::::::::::::::: 13 2.7.4.3 LTO for package checking ::::::::::::::::::::::::::::::::::::::::::::::: 14 2.8 Testing an Installation :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 14 3 Installing R under Windows ::::::::::::::::::::::::::::::::: 16 3.1 Building from source:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 16 3.1.1 The Windows toolset :::::::::::::::::::::::::::::::::::::::::::::::::::::::: 16 3.1.2 LATEX:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 16 3.2 Checking the build:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 17 3.3 Testing an Installation :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 17 4 Installing R under macOS:::::::::::::::::::::::::::::::::::: 18 4.1 Running R under macOS ::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 19 4.2 Uninstalling under macOS :::::::::::::::::::::::::::::::::::::::::::::::::::::::: 19 4.3 Multiple versions ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 20 5 Running R::::::::::::::::::::::::::::::::::::::::::::::::::::: 21 6 Add-on packages :::::::::::::::::::::::::::::::::::::::::::::: 22 6.1 Default packages:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 22 6.2 Managing libraries :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 22 6.3 Installing packages :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 22 6.3.1 Windows :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 24 6.3.2 macOS :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 24 6.3.3 Customizing package compilation::::::::::::::::::::::::::::::::::::::::::::: 26 6.3.4 Multiple sub-architectures:::::::::::::::::::::::::::::::::::::::::::::::::::: 27 6.3.5 Byte-compilation::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 28 ii 6.3.6 External software :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 28 6.4 Updating packages :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 28 6.5 Removing packages ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 29 6.6 Setting up a package repository ::::::::::::::::::::::::::::::::::::::::::::::::::: 29 6.7 Checking installed source packages :::::::::::::::::::::::::::::::::::::::::::::::: 30 7 Internationalization and Localization:::::::::::::::::::::::: 31 7.1 Locales ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 31 7.1.1 Locales under Unix-alikes :::::::::::::::::::::::::::::::::::::::::::::::::::: 31 7.1.2 Locales under Windows :::::::::::::::::::::::::::::::::::::::::::::::::::::: 31 7.1.3 Locales under macOS :::::::::::::::::::::::::::::::::::::::::::::::::::::::: 32 7.2 Localization of messages :::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 32 8 Choosing between 32- and 64-bit builds :::::::::::::::::::: 34 9 The standalone Rmath library ::::::::::::::::::::::::::::::: 35 9.1 Unix-alikes ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 35 9.2 Windows ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 36 Appendix A Essential and useful other programs under a Unix-alike :::::::::::::::::::::::::::::::::: 38 A.1 Essential programs and libraries :::::::::::::::::::::::::::::::::::::::::::::::::: 38 A.2 Useful libraries and programs::::::::::::::::::::::::::::::::::::::::::::::::::::: 40 A.2.1 Tcl/Tk:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 41 A.2.2 Java support :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 42 A.2.3 Other compiled languages ::::::::::::::::::::::::::::::::::::::::::::::::::: 43 A.3 Linear algebra:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 43 A.3.1 BLAS ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 43 A.3.1.1 ATLAS::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 44 A.3.1.2 OpenBLAS ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 45 A.3.1.3 Intel MKL:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 46 A.3.1.4 Shared BLAS::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 47 A.3.2 LAPACK ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 47 A.3.3 Caveats ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 48 Appendix B Configuration on a Unix-alike ::::::::::::::::::: 50 B.1 Configuration options :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 50 B.2 Internationalization support :::::::::::::::::::::::::::::::::::::::::::::::::::::: 51 B.3 Configuration variables ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 51 B.3.1 Setting paper size ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 51 B.3.2 Setting the browsers ::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 51 B.3.3 Compilation flags:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 52 B.3.4 Making manuals ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 52 B.4 Setting the shell :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 52 B.5 Using make :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 52 B.6 Using Fortran :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 52 B.7 Compile and load flags ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 53 B.8 Maintainer mode ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 54 iii Appendix C Platform notes :::::::::::::::::::::::::::::::::::: 55 C.1 X11 issues:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 55 C.2 Linux :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 56 C.2.1 Clang ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 58 C.2.2 Intel compilers :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 58 C.3 macOS ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 59 C.3.1 Prerequisites :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 59 C.3.1.1 Note for Catalina and later users:::::::::::::::::::::::::::::::::::::::: 61 C.3.2 Cairo graphics::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 61 C.3.3 Other C/C++ compilers::::::::::::::::::::::::::::::::::::::::::::::::::::: 62 C.3.4 Other libraries::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 63 C.3.5 Tcl/Tk headers and libraries::::::::::::::::::::::::::::::::::::::::::::::::: 64 C.3.6 Java::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 64 C.3.7 Frameworks ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 65 C.3.8 Building R.app :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 66 C.3.9 Building binary packages :::::::::::::::::::::::::::::::::::::::::::::::::::: 66 C.3.10 `arm64' aka `Apple Silicon':::::::::::::::::::::::::::::::::::::::::::::::::: 67 C.3.10.1 Native builds :::::::::::::::::::::::::::::::::::::::::::::::::::::::::: 67 C.4 Solaris :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::