[ruby-list:30849] Re: Matrix の仕様

> Matrix::diagonal(value...)

>  creates a square diagonal matrix with [<value>, ...]
>  on the main diagonal.

Matrix::diagonal(v1, ..., vn)

  creates a diagonal matrix whose diagonal elements are
  `v1', ..., `vn', respectively

のほうが、より正確じゃないでしょうか。

> Matrix::scalar(n, value)

>  creates a n-by-n scalar matrix whose main diagonal elements
>  are all <value>s.

僕の好みでは n times n matrix ですが、全体で統一すべきでしょう。
n by n とは書かないと思うので。 - の見た目の問題です。
Matrix::scalar(n, value) は対角でない成分は 0 ですから、
その説明を加えた方がいいと思います。

Matrix::scalar(n, value)

  creates a `n'-by-`n' diagonal matrix whose all diagonal elements
  are `value'.

もしも、diagonal matrix と書くことにより、
非対角成分が 0 だということを読みとってもらう、のがいやなら、
all off-diagonal elements are zero
を付けくわえてもいいかもしれません。
--
池上 大介
Daisuke IKEGAMI <[e-mail]>
奈良先端科学技術大学院大学 情報科学研究科
情報処理学専攻 情報基礎学講座 関研究室