home *** CD-ROM | disk | FTP | other *** search
/ Big Green CD 8 / BGCD_8_Dev.iso / NEXTSTEP / UNIX / Educational / R-0.49-MI / R-0.49-I / README < prev    next >
Encoding:
Text File  |  1997-04-14  |  3.3 KB  |  92 lines
  1.  
  2.             THE BASIC R README
  3.  
  4.        (See "RESOURCES" for additional resources)
  5.  
  6.  
  7.  
  8. 1. INTRODUCTION
  9.  
  10. This directory contains the Unix source code tree for R, which is
  11. a language which is not entirely unlike the S language developed
  12. at AT&T Bell Laboratories by Rick Becker, John Chambers and Allan
  13. Wilks.  Indeed in the (present) absence of an R manual, you can
  14. (mostly) get along by using the S manual.
  15.  
  16. R is free software distributed under a GNU-style copyleft.
  17.  
  18. Currently the software is in a beta test state and we are seeking
  19. comments and bug reports.  Please send comments and reports to
  20.  
  21.     R@stat.auckland.ac.nz
  22.  
  23. In the case of bugs it would be very helpful to have code which
  24. reliably reproduces the problem.  Some bugs can be very hard to
  25. fix without this.
  26.  
  27.  
  28. 2. PRESENT STATUS
  29.  
  30. We have implemented most of the functionality in the first S book
  31. (the "Blue Book") and many of the applications.  In addition, we
  32. have implemented a certain amount of functionality from the second
  33. S book (the "White Book").  In particular we have a functioning
  34. versions of "lm" and "glm" and their associated "summary" and
  35. "anova" methods (it would be nice to have "drop1", "add1" and
  36. "step", but there hasn't been time to complete these yet).
  37.  
  38. What we have in the way of manual is in the directory in an
  39. "output independent" form which can be used to create versions
  40. for HTML, LaTeX, troff etc.
  41.  
  42.  
  43. 3. GOALS
  44.  
  45. Our aim at the start of this project was to demonstrate that it was
  46. possible to produce an S-like environment which did not suffer from
  47. the memory-demands and performance problems which S has.  It is only
  48. recently that we have started trying to turn R into a "real" system.
  49. In the short term we hope to create a small portable free system
  50. which will provide most of the functionality of S and perhaps some
  51. extensions.
  52.  
  53. Our present plan of attack is as follows:
  54.  
  55. 1.  Re-implement parts of the system to make things more modular
  56.     so that data sets can be saved and restored on an individual
  57.     basis and so that we have a real library facility.
  58.     (Mostly done).
  59.  
  60. 2.  Move the user interface to an event driven basis.  This will
  61.     enable users to interact with the system in a much more
  62.     graphical way.  It also raises the possibility that we can
  63.     borrow the graphics technology in LispStat.
  64.     (Design phase).
  65.  
  66. 3.  Add functionality in the form of new functions.
  67.     (Ongoing).
  68.  
  69. 4.  The present documentation is written using our own format into 
  70.     files which can be processed by a combination of sed and m4 into
  71.     a variety of formats (nroff, latex, html).  We should use a real
  72.     SGML description of our format and develop techniques for more
  73.     generally translating into other formats.
  74.  
  75. Longer-term we are hoping to move to a compiled evironment which
  76. will give substantial performance gains.  A separate compiler
  77. "skunk works" is engaged in this.
  78.  
  79.  
  80. 4. DIFFERENCES BETWEEN R AND S
  81.  
  82. 1. In R, "factor" and "ordered factor" are primitive vector types.
  83.    This means in particular that they can be shaped as arrays.
  84.  
  85. 2. In R a list is a Lisp-style list composed of dotted pairs, rather
  86.    than a vector of generic elements as in S.  This means that list
  87.    subscripting can be rather inefficient.  However, lists are rarely
  88.    large and so we have not (yet) bothered to implement a matching
  89.    "generic vector" type, even though this could be quite useful.
  90.  
  91. Robert Gentleman + Ross Ihaka
  92.