|Re: [eigen] Documentation : it's a sprint!!|
[ Thread Index |
| More lists.tuxfamily.org/eigen Archives
- To: eigen@xxxxxxxxxxxxxxxxxxx
- Subject: Re: [eigen] Documentation : it's a sprint!!
- From: Carlos Becker <carlosbecker@xxxxxxxxx>
- Date: Thu, 8 Jul 2010 18:28:46 +0100
- Dkim-signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:mime-version:received:received:in-reply-to :references:date:message-id:subject:from:to:content-type; bh=o4zkOxAnfycSk8NbRpJCXQCvdJmg0hRbUxrxta/Ftxo=; b=mEh1/ctElRX2Oh7q8Tmc3tIYZ287M9C0AxlqVh90qeRmBrskzGez1MEaabdwyJcJN0 Nvj/V5RUe4gI3gdVje/w3vuB4NDZJt0jQzQo5Tb+s4nm2Tjo7nXAB5y7qVgKrdavD0Q9 c3qiJXCQ8zEsV08iGOA3f+PL1wxaFOs+0gIcU=
- Domainkey-signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :content-type; b=KbaZIlQCTaSIFfUT4H/jIR9Hj/sr9ULhmoPL5Chi44l7+Vl7TCHPPw4yQjyP2H90kx JxlkQSfQHhyeu/Anj+dFl9QAzJBay4MLW7uM/Hm3im9v0Z3Sngm5HTrpY9KT/cR+f/e1 D67i2z7bqiuQ3Ec36dbXbPLLN1NhgauOJeUx8=
Hi Jitse, I think those are good ideas. For each section (if possible/worth it) a subsection called 'Advanced examples' with things like those.. What do you thin Benoit? (I am asking him since he is the one taking care of the whole organization of the docs).
On Thu, Jul 8, 2010 at 6:22 PM, Jitse Niesen <jitse@xxxxxxxxxxxxxxxxx>
I think the examples on page 4 of the tutorial (on blocks) are perhaps a bit too basic. I would like to add more exciting stuff, like
m.row(i) += 3 * m.row(j); (*)
What do you (in particular, Carlos, who is doing great work on the tutorial) think? Obviously, many people reading the tutorial are beginners - that's what it is for - so we should be careful to keep it simple. Perhaps (*) is too hard ?
On page 3 (arrays), perhaps we should mention mat1.cwiseMul(mat2) as an alternative to mat1.array() * mat2.array() ?
And what about other coefficient-wise operations, like array.square() ?
Or would that make the tutorial too long?
There are some topics which we might consider adding to the tutorial:
* output, how to change precision (perhaps more obvious now but that used
to be a common question), .format() or whatever it's called
* special matrices (triangular, diagonal, etc)
Again, would these make the tutorial too long?
Of course, I realize that raising these issues may well mean I have to do it, but I'm not very certain of them so I thought I'd raise them first.