R 2. 11.

1 f or Wi ndows
===================
Thi s di st r i but i on cont ai ns a bi nar y di st r i but i on of R- 2. 11. 1 t o r un on
Wi ndows 2000 and l at er ( i ncl udi ng 64- bi t ver si ons of Wi ndows) on i x86
and x86_64 chi ps. I t i s desi gned t o be as cl ose as possi bl e t o t he
i mpl ement at i on on Uni x, but see t he l i st of di f f er ences bel ow. The
por t was by Gui do Masar ot t o, Br i an Ri pl ey and Duncan Mur doch.
See t he f i l e `CHANGES' f or t he new f eat ur es of t hi s ver si on.
I nst al l at i on
============
The di st r i but i on i s di st r i but ed as a 30Mb i nst al l er R- 2. 11. 1- wi n32. exe.
J ust r un t hi s f or a Wi ndows- XP st yl e i nst al l er . I t cont ai ns al l t he R
component s, and you can sel ect what want i nst al l ed.
For mor e det ai l s, i ncl udi ng command- l i ne opt i ons f or t he i nst al l er
and how t o uni nst al l , see t he r w- FAQ. I f you ar e r eadi ng t hi s as par t of
an i nst al l ed ver si on of R, t hat ' s bot h f i l e r w- FAQ i n t hi s di r ect or y
and f i l e doc\ ht ml \ r w- FAQ. ht ml .
Usage
=====
Ther e ar e t wo ver si ons of t he R execut abl e i n R- 2. 11. 1\ bi n:
GUI :
Rgui . exe r uns as a st andar d Wi ndows GUI execut abl e and pr ovi des an R
consol e i n i t s own wi ndow. I t t akes t he st andar d R command- l i ne
ar gument s; t hese ar e most easi l y set by maki ng a shor t cut t o
. . . \ R- 2. 11. 1\ bi n\ Rgui . exe and addi ng t he ar gument s i n t he Tar get f i el d.
Set t he `St ar t i n' f i el d of t he shor t cut t o t he di r ect or y you want t o
use as t he wor ki ng di r ect or y ( wher e wor kspaces and f i l es ar e saved t o
and l oaded f r om) . The i nst al l er cr eat es a shor t cut on t he deskt op f or
you ( by def aul t ) .
You have a choi ce of i nt er f ace: SDI ( separ at e wi ndows) or MDI
( mul t i pl e chi l d wi ndows i n one l ar ge wi ndow) . MDI i s t he def aul t :
sel ect SDI by addi ng - - sdi i n t he Tar get f i el d: t hi s can al so be
sel ect ed f r omt he i nst al l er .
Command- l i ne edi t i ng i s avai l abl e: see Hel p | Consol e f or det ai l s.
The menus pr ovi de shor t cut s t o some R commands such as hel p, hel p. st ar t ,
apr opos, l s, l oad, save. i mage, sear ch.
The ' l oad' menu i t ems ( Sour ce R code, Di spl ay f i l e, Load Wor kspace)
keep t r ack of t he di r ect or y t hat was l ast used, and st ar t t hei r di al og
boxes f r omt hat di r ect or y t he next t i me t hey ar e used. That di r ect or y
can be made t he wor ki ng di r ect or y by t he Fi l e | Change di r menu i t em.
Al l t he `save' menu i t ems st ar t di al og boxes at t he cur r ent wor ki ng
di r ect or y: t hi s i ncl udes `Save Wor kspace' and t he var i ous ways t o save
gr aphi cs, as wel l as savi ng t he wor kspace at t he end of t he sessi on.
Not e t hat t he t ext hel p f i l es use t he l at i n1 encodi ng. To see al l t he
char act er s you must use an appr opr i at e f ont ( Eur opean- l anguage Tr ue
Type f ont s shoul d be OK) . To check i f your pr ef er r ed f ont has l at i n1
capabi l i t y, t r y " hel p( t ext ) " and l ook at t he exampl es. [ Not e: onl y a
http://cran.r-project.org/bin/windows/base/README.R-2.11.1
1 of 4 07/12/2010 10:46 AM
f ew hel p f i l es make use of l at i n1 char act er s not cont ai ned i n t he
st andar d ASCI I set so i f you l i ke a f ont wi t hout l at i n1 capabi l i t y,
use i t . ]
TERMI NAL/ BATCH:
Rt er m. exe wi l l r un f r oma command l i ne such as an MS- DOS or Commands
Wi ndow r unni ng t he st andar d shel l , cmd. exe, as wel l as t he por t s of
bash and t csh t hat we use. I t s pr i mar y pur pose i s t o al l ow bat ch
oper at i on, but i t does pr ovi de al l t he f aci l i t i es needed f or
i nt er act i ve use, i ncl udi ng command- l i ne edi t i ng ( see t he f i l e
README. Rt er m) .
Bat ch use: At i t s si mpl est , Rt er m. exe can be used i n a bat ch mode by
commands l i ke
Rt er m. exe - - no- r est or e - - no- save < i nf i l e > out f i l e 2>&1
al t hough user s wi l l pr obabl y want t o set up si mpl e . bat or . cmd f i l es
t o r un bat ch j obs. You can al so use i t vi a R CMD BATCH: see ?BATCH or
R CMD BATCH - - hel p.
Use wi t h ESS: You can use Rt er m. exe t o pr ovi de i nf er i or R- mode i n ESS
under NTEmacs, f or exampl e wi t h ess- 5. 3. x. The pager i s
aut omat i cal l y set t o " consol e" so t ext hel p wi l l be di spl ayed i n emacs
buf f er s.
GRAPHI CS:
The scr een devi ce i s cal l ed wi ndows( ) . Thi s i s l aunched aut omat i cal l y,
and can al so be l aunched expl i ci t l y by wi ndows( ) or wi n. gr aph( ) ( or
x11( ) ) f r ombot h Rgui . exe and Rt er m. exe. A pr i nt er devi ce can be
opened usi ng wi n. pr i nt ( ) , and gr aphs dr awn as met af i l es by
wi n. met af i l e( ) .
The gr aphi cs devi ce pops up a separ at e wi ndow whi ch has t wo menus. The
devi ce' s Fi l e menu al l ows savi ng or pr i nt i ng or t o r un dev. of f ( ) .
The Hi st or y menu al l ows t he r ecor di ng of pl ot s. When pl ot s have been
r ecor ded t hey can be r evi ewed by PgUp and PgDn, saved and r epl aced.
Recor di ng can be t ur ned on aut omat i cal l y ( t he Recor di ng i t emon t he
l i st ) or i ndi vi dual pl ot s can be added ( Add or t he I NS key) .
The whol e pl ot hi st or y can be saved t o or r et r i eved f r oman R var i abl e
i n t he gl obal envi r onment .
The f or mat of r ecor ded pl ot s may change bet ween R ver si ons.
Recor ded pl ot s shoul d NOT be used as a per manent
st or age f or mat f or R pl ot s.
Ther e i s onl y one gr aphi cs hi st or y shar ed by al l t he wi ndows devi ces.
Cust omi zat i on
=============
Envi r onment var i abl es can be set as NAME=val ue at t he end of t he
command l i ne, i ncl udi ng i n a shor t cut . They can al so be set ( as
NAME=val ue l i nes) i n t he f i l e . Renvi r on i n t he wor ki ng di r ect or y, or
i f t hat does not exi st HOME\ . Renvi r on.
Many aspect s of t he consol e ( si ze, appear ance, f ont , f ont si ze,
col our s) can be cust omi zed by edi t i ng t he f i l e et c\ Rconsol e, and a
copy wi t h a user ' s set t i ngs can be put i n her HOME di r ect or y or i n t he
http://cran.r-project.org/bin/windows/base/README.R-2.11.1
2 of 4 07/12/2010 10:46 AM
wor ki ng di r ect or y. ( The exact sequence i s t o sear ch t he di r ect or y
poi nt ed t o by t he f i r st f ound of t he envi r onment var i abl es R_USER t hen
HOME, t hen t he Wi ndows " per sonal " di r ect or y ( t ypi cal l y `C: \ Document s
and Set t i ngs\ user name\ My Document s' i n Wi ndows XP)
t hen {HOMEDRI VE}{HOMEPATH} t hen t he wor ki ng di r ect or y, f i nal l y
R_HOME\ et c. Thi s al so appl i es t o . Renvi r on and ot her uses of `HOME'
i n our document at i on. ) The f i l e cont ai ns a descr i pt i on of t he
set t i ngs t hat can be al t er ed. See al so ?Rconsol e.
An al t er nat i ve way t o edi t t he Rconsol e f i l e i s t o use t he GUI
pr ef er ences i t emon t he Edi t menu i n Rgui . exe. Thi s can change some
of t he set t i ngs ( f or exampl e col our s, f ont and wi ndow si zes) on t he
cur r ent r unni ng consol e.
The mappi ng bet ween Wi ndows f ont s and t he f ont number used i n R' s
gr aphi cs can be set by edi t i ng t he f i l e et c\ Rdevga, and a copy wi t h a
user ' s set t i ngs can be put i n t he HOME or wor ki ng di r ect or y ( see t he
descr i pt i on of Rconsol e) . Thi s mappi ng appl i es t o bot h t he scr een
devi ce and t he pr i nt er devi ce.
Many R def aul t s can be set i n t he f i l e R_HOME\ et c\ Rpr of i l e or a user ' s
f i l e . Rpr of i l e. I n par t i cul ar :
- The pager i s set by opt i ons( pager =) . The def aul t i s " i nt er nal " whi ch
br i ngs up a separ at e consol e- l i ke wi ndow. The i nt er nal pager can use
a si ngl e wi ndow or a di f f er ent wi ndow f or each t opi c shown
( conf i gur abl e i n Rconsol e) . Ot her possi bi l i t i es we have
used ar e " not epad" and " pf e32 / v" , and " consol e" t o l i st t he f i l es i n
t he consol e ( Rgui . exe) or t er mi nal wi ndow ( Rt er m. exe) .
Addi ng packages
===============
Bi nar i es f or many packages ar e avai l abl e under
CRAN/ bi n/ wi ndows/ cont r i b. These ar e zi p f i l es whi ch shoul d be
unpacked i n R- 2. 11. 1\ l i br ar y. The si mpl est opt i on i s use t he i t ems on
t he Packages menu t o i nst al l f r oma zi p f i l e or t o downl oad f r omCRAN.
The l i st of packages and f unct i ons gi ven by HTML hel p and used by t he
sear ch engi ne can be updat ed f r oma r unni ng R pr ocess by t he command
l i nk. ht ml . hel p( )
pr ovi ded t he owner of t he pr ocess has wr i t e per mi ssi on on
R- 2. 11. 1\ doc\ ht ml .
Pr i vat e l i br ar i es of packages can be used and can be speci f i ed by t he
envi r onment var i abl e R_LI BS. ( Separ at e di r ect or i es by " ; " i n t hi s
ver si on. ) They wi l l not be l i nked t o HTML hel p. I n mor e det ai l , t o
use packages i nst al l ed i n di r ect or y R: \ l i br ar i es\ gm, set
R_LI BS=R: \ l i br ar i es\ gm
i n t he envi r onment or your . Renvi r on f i l e or on t he command l i ne, or
add t he l i ne
. l i bPat hs( " R: / l i br ar i es/ gm" )
t o your . Rpr of i l e or at t he end of R_HOME\ et c\ Rpr of i l e.
To i nst al l a package f r omsour ce code you need t he sour ce- package
di st r i but i on i nst al l ed f r omR- 2. 11. 1- wi n32. exe ( but not t he R sour ces) .
The `R I nst al l at i on and Admi ni st r at i on' manual cont ai ns det ai l ed
i nst r uct i ons.
http://cran.r-project.org/bin/windows/base/README.R-2.11.1
3 of 4 07/12/2010 10:46 AM
Di f f er ences f r omUni x ver si ons of R
===================================
- R can be i nt er r upt ed by Esc i n Rgui and by Ct r l - C or Ct r l - Br eak i n Rt er m:
Ct r l - C i s used f or copyi ng i n t he GUI ver si on. C- c C- c wor ks
under NTemacs.
- Command- l i ne edi t i ng i s al ways avai l abl e, but i s si mpl er t han
under r eadl i ne- based i nput on Uni x. For Rgui . exe, see t he menu i t em
`Hel p | Consol e' , f or Rt er m. exe t he f i l e README. Rt er m.
- Pat hs t o f i l es can be speci f i ed wi t h " / " or " \ \ " .
- syst em( ) i s enhanced her e and does not aut omat i cal l y use a shel l .
See i t s hel p page and t hat of shel l ( ) .
- gr aphi cs devi ce bmp( ) i s avai l abl e i n t hi s ver si on.
Usi ng package t cl t k
===================
The package t cl t k suppor t s bui l di ng gr aphi cal i nt er f aces wi t h Tcl / Tk.
" Suppor t Fi l es f or Package t cl t k" needs t o be sel ect ed f r omt he
i nst al l er f or t hi s t o wor k; al t er nat i vel y you can use an exi st i ng
i nst al l at i on of Tcl / Tk 8. 5. x by f ol l owi ng t he i nst r uct i ons i n t he
r w- FAQ.
Bui l di ng Fr omSour ce
====================
See t he `R I nst al l at i on and Admi nst r at i on' Manual
( doc\ manual \ R- admi n. ht ml ) and t he r w- FAQ.
Feedback
========
Pl ease send comment s and bug r epor t s t o
R- wi ndows@r - pr oj ect . or g
http://cran.r-project.org/bin/windows/base/README.R-2.11.1
4 of 4 07/12/2010 10:46 AM