R devel - Sep 2016 - row names of 'rowsum()'

'rowsum()' seems to add row names to the resulting matrix, corresponding
to
the respective 'group' values.  This is very handy, but it is not
documented.  Should the documentation mention it so it could be relied upon
as part of API?

Cheers,
Ott

-- 
Ott Toomet

Visiting Researcher
School of Information
Mary Gates Hall, Suite 310
University of Washington
Seattle, WA 98195

	[[alternative HTML version deleted]]

> 'rowsum()' seems to add row names to the resulting matrix,
corresponding to
> the respective 'group' values.  This is very handy, but it is not
documented.
> Should the documentation mention it so it could be relied upon as part of
API?
If you're referring to base::rowSums, the 'value' section of the
help page says
" A numeric or complex array of suitable size, or a vector if the
  result is one-dimensional.  For the first four functions the
  'dimnames' (or 'names' for a vector result) are taken from the
  original array. "

S Ellison


*******************************************************************
This email and any attachments are confidential. Any use...{{dropped:8}}

I am referring to base::rowsum(), not rowSums().  For some reason I cannot
access it's help on my computer but the online documentation (R-devel
version) states:

Value
A matrix or data frame containing the sums. There will be one row per
unique value of group

Period.  Above, the argument 'reorder' is mentioned which orders rows to
'agree with tapply'.

Cheers,
Ott

On Mon, Sep 19, 2016 at 8:41 AM, S Ellison <S.Ellison at lgcgroup.com>
wrote:
> > 'rowsum()' seems to add row names to the resulting matrix,
corresponding
> to
> > the respective 'group' values.  This is very handy, but it is
not
> documented.
> > Should the documentation mention it so it could be relied upon as part
> of API?
>
> If you're referring to base::rowSums, the 'value' section of
the help page
> says
> " A numeric or complex array of suitable size, or a vector if the
>   result is one-dimensional.  For the first four functions the
>   'dimnames' (or 'names' for a vector result) are taken
from the
>   original array. "
>
> S Ellison
>
>
> *******************************************************************
> This email and any attachments are confidential. Any u...{{dropped:23}}