Difference between revisions of "R tutorial"
m (→User interface) |
|||
Line 24: | Line 24: | ||
# Launch '''R'''. | # Launch '''R'''. | ||
− | The program should open | + | The program should open a window–the "R console"–and greet you with its ''input prompt'', awaiting your input: |
> | > | ||
+ | |||
+ | |||
+ | The samples here sometimes copy input/output from the console, and sometimes shows the actual commands only. The <code><<code> character at the beginning of the line is always just '''R''''s ''input prompt''; It is shown here only to illustrate the interactive use of the program and you do not need to type it. If a line starts with <code>[1]</code> or similar, this is '''R''''s ''output'' on the console. Often, I type a <code>#</code>-character into a command line: this marks the following text as a comment which is not executed by '''R'''. In principle, commands can be copied by you and pasted into the console, or into a script. In addition, these pages use [http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi syntax highlighting] to color language keywords, numbers, strings, etc. different from other text. This improves readability but keep in mind that the colours you see on your computer will be different. One more thing about the console: use your keyboard's ''up-arrow'' keys to retrieve previous commands, then enter the line with ''left-arrow'' to edit it; hit ''enter'' to execute the modified line. | ||
+ | |||
===User interface=== | ===User interface=== | ||
Line 37: | Line 41: | ||
<source lang="R"> | <source lang="R"> | ||
− | a | + | > help(rnorm) # "help" is a function, arguments to a function are passed in parentheses "()" |
+ | > ?rnorm # shorthand for the same thing | ||
+ | > ?binom # what was the name of that again ... ? | ||
+ | No documentation for 'binom' in specified packages and libraries: | ||
+ | you could try '??binom' | ||
+ | > ??binom # this finds all help-articles containing that string | ||
+ | > ?Binomial # ... found it in the list of keywords | ||
+ | > | ||
</source> | </source> | ||
;Working directory | ;Working directory | ||
+ | getwd() | ||
+ | |||
+ | setwd() | ||
;Workspace | ;Workspace | ||
− | |||
===Packages=== | ===Packages=== | ||
Line 51: | Line 64: | ||
Standard packages included, data available | Standard packages included, data available | ||
− | === | + | ===Files=== |
... Loading and running scripts | ... Loading and running scripts |
Revision as of 14:35, 11 February 2012
R tutorial
This is a tutorial introduction to R for users with no previous background in the platform or the language.
Contents
The environment
In this section we discuss how to download and install the software, how to configure an R session and what work with the R environment includes.
Installation
- Navigate to http://probability.ca/cran/ [1] and follow the link to your computer's operating system.
- Download a precompiled binary (or "build") of the R "framework" to your computer and follow the instructions for installing it. You don't need tools, or GUI versions for now, but do make sure that the program is the correct one for your version of your operating system.
- Launch R.
The program should open a window–the "R console"–and greet you with its input prompt, awaiting your input:
>
The samples here sometimes copy input/output from the console, and sometimes shows the actual commands only. The <
character at the beginning of the line is always just R's input prompt; It is shown here only to illustrate the interactive use of the program and you do not need to type it. If a line starts with
[1]
or similar, this is R's output on the console. Often, I type a #
-character into a command line: this marks the following text as a comment which is not executed by R. In principle, commands can be copied by you and pasted into the console, or into a script. In addition, these pages use syntax highlighting to color language keywords, numbers, strings, etc. different from other text. This improves readability but keep in mind that the colours you see on your computer will be different. One more thing about the console: use your keyboard's up-arrow keys to retrieve previous commands, then enter the line with left-arrow to edit it; hit enter to execute the modified line.
User interface
R comes with a GUI[2] to lay out common tasks. For example, there are a number of menu items, many of which are similar to other programs you will have worked with ("File", "Edit", "Format", "Window", "Help" ...). All of these tasks can also be accessed through the command line. In general, GUIs are useful when you are not sure what you want to do or how to go about it; the command line is much more powerful when you have more experience and know your way around in principle. R gives you both options.
Let's begin with a glossary of some terms that R uses and how they relate to your work:
- Help
- Help is available for all commands and for the R command line syntax. As well, help is available to find the names of commands when you are not sure of them.
> help(rnorm) # "help" is a function, arguments to a function are passed in parentheses "()"
> ?rnorm # shorthand for the same thing
> ?binom # what was the name of that again ... ?
No documentation for 'binom' in specified packages and libraries:
you could try '??binom'
> ??binom # this finds all help-articles containing that string
> ?Binomial # ... found it in the list of keywords
>
- Working directory
getwd()
setwd()
- Workspace
Packages
Standard packages included, data available
Files
... Loading and running scripts
Simple commands
Including functions
Scalar datatypes
Definition, change, operations with, functions to work on...
Vectors
Matrices, tables, frames
Subsetting,mselecting and filtering
Data manipulations
Transformation
Search
Writing functions
Installing new functions
Numeric output
Graphic output
Notes
- ↑ This is the CRAN mirror site at the University of Toronto, any other mirror site will do. You may access a choice of mirror sites from the R-project homepage.
- ↑ Graphical User Interface
Further reading and resources