[R] Surprise when mapping matrix to image

[Peter Dalgaard]

Patrick Burns <pburns at pburns.seanet.com> writes:

> Peter Dalgaard wrote:
> 
> >"Richard A. O'Keefe" <ok at cs.otago.ac.nz> writes:
> >
> [snip]
> 
> >  Good idea, but perhaps not phrased sharply enough to catch the
> > user's
> >eye. How about something like this:
> >
> >"Notice that image() interprets a matrix as a table of f(x_i, y_j), so
> >the x axis corresponds to row number and the y axis to column number
> >(bottom to top)."
> >
> >and then use Brian's one-liner in the examples section?
> >
> 
> Though I think the added text is a good idea, the addition of the example
> is probably 102.58 times more useful than any text that could be inserted.
> 
> The examples in help files are probably the main reason that people think
> of R having better documentation than other programs.  Like Unix man
> pages, for example, which would be wonderful if only they had examples
> so that you could figure out what the sentences mean when you understand
> every word.

There are limits, I think. If you put too many variations into the
example section, it tends to become a grey blob of code. Anyways, I'm
going to add both.

-- 
   O__  ---- Peter Dalgaard             Blegdamsvej 3  
  c/ /'_ --- Dept. of Biostatistics     2200 Cph. N   
 (*) \(*) -- University of Copenhagen   Denmark      Ph: (+45) 35327918
~~~~~~~~~~ - (p.dalgaard at biostat.ku.dk)             FAX: (+45) 35327907