[ruby-list:30842] Matrix の仕様

まつもと ゆきひろです

Matrixクラスに関する英語の文書を書いているのですが、ドキュメ
ントが理解できないところがあります。というか行列を理解してな
いからなんですが。

分からないのは

#	Matrix.diagonal(*values)
#	    creates a matrix where `columns' indicates columns. 
#	Matrix.scalar(n, value)
#	    creates a diagonal matrix such that the diagal compornents is
#	    given by `values'.
#	Matrix.scalar(n, value)
#	    creates an n-by-n scalar matrix such that the diagal compornent is 
#	    given by `value'.

です。diagonalはなんか違うメソッドの説明みたいだし(引数の名
前が合ってない)。scalarは説明が重複してるし(しかも似てるよう
けどちょっと違う)。

で、推論(というか想像力)を駆使して以下のような説明を作ってみました。

Matrix::diagonal(value...)

  Creates a matrix of which diagonal components are specified by <value>.

    Matrix.diagonal(11, 22, 33)	# => Matrix[[11, 0, 0], [0, 22, 0], [0, 0, 33]]

Matrix::scalar(n, value)

  creates a n-by-n diagonal matrix such that the diagonal compornents are
  given by `value'.

でも合ってる自信が全然ありません。

                                まつもと ゆきひろ /:|)