On 9/11/12 4:56 PM, Andrew Gelman wrote:
> It might be a good idea in the manual to have an example like this, in which we format the same array in several
> different ways, so users can see the equivalencies.
There is already such a discussion. More than
one, in fact. Check out the section on vectorization
in the optimization chapter of the user's guide.
There should probably be a whole section in the user's
guide on vectors, row vectors, matrices and arrays.
One thing that's not adequately discussed with examples
is the return type for matrix operations. It's all
fully documented, but I think users coming from R who
are not used to reading function-signature doc may get
confused.
> We can then also explain why some parameterizations work more
> efficiently than others.
I can write up things like bernoulli vs. bernoulli_logit,
but I could use some help on the multivariate modeling side.
- Bob