class Vector (Ruby 4.1 リファレンスマニュアル)

要約

数ベクトルを表すクラスです。要素は Numeric オブジェクトで表します。

複素ベクトルも表せます。

ベクトルの要素のインデックスは 0 から始まることに注意してください。

全ての要素がゼロのベクトルを零ベクトルといいます。

Vector オブジェクトは Matrix オブジェクトとの演算においては列ベクトルとして扱われます。行ベクトルとして演算を行いたいときは、1行の行列に変換してから行います。

継承しているメソッド

Enumerableから継承しているメソッド

特異メソッド

self[*a] -> Vector[permalink][rdoc][edit]

可変個引数を要素とするベクトルを生成します。

Vector[a1, a2, a3, ... ] としたとき、引数 a1, a2, a3, ... を要素とするベクトルを生成します。

[PARAM] a:: ベクトルの要素

例

require 'matrix'

p Vector[1, 3, 4.0] # => Vector[1, 3, 4.0]

basis(size:, index:) -> VectorRuby 2.2.0 から[permalink][rdoc][edit]

size 次元ベクトル空間の index 番目の標準基底を返します。

例

require 'matrix'

p Vector.basis(size: 3, index: 1) # => Vector[0, 1, 0]

[PARAM] size:: ベクトルの次元
[PARAM] index:: 標準基底の何番目か。0 origin

elements(a, copy = true) -> Vector[permalink][rdoc][edit]

配列 a を要素とするベクトルを生成します。ただし、オプション引数 copy が偽 (false) ならば、複製を行いません。

[PARAM] a:: Vectorを生成する際の要素の配列
[PARAM] copy:: 引数の配列 a のコピーをするかどうかのフラグ

例

require 'matrix'

a = [1, 2, 3]
v1 = Vector.elements(a, true)
v2 = Vector.elements(a, false)
p v1        # => Vector[1, 2, 3]
p v2        # => Vector[1, 2, 3]
a[0] = -1
p v1        # => Vector[1, 2, 3]
p v2        # => Vector[-1, 2, 3]

independent?(*vectors) -> boolRuby 2.2.0 から[permalink][rdoc][edit]

ベクトルの列 vectors が線形独立であれば true を返し、そうでなければ false を返します。

[PARAM] vectors:: 線形独立性を判定するベクトル列

zero(size) -> VectorRuby 2.5.0 から[permalink][rdoc][edit]

零ベクトルを返します。

例

require 'matrix'

p Vector.zero(3) # => Vector[0, 0, 0]

[PARAM] size:: ベクトルの次元

インスタンスメソッド

self * other -> Vector[permalink][rdoc][edit]

self の各要素に数 other を乗じたベクトルを返します。

[PARAM] other:: self の各要素に掛ける Numeric オブジェクトを指定します。

例

require 'matrix'

v1 = Vector[1, 2, 3.5, 100]
p v1.*(2)     # => Vector[2, 4, 7.0, 200]
p v1.*(-1.5)  # => Vector[-1.5, -3.0, -5.25, -150.0]

self * m -> Matrix[permalink][rdoc][edit]

self を列ベクトル(行列)に変換して (実際には Matrix.column_vector(self) を適用) から、行列 m を右から乗じた行列 (Matrix クラス) を返します。

[PARAM] m:: 右から乗算を行う行列
[EXCEPTION] ExceptionForMatrix::ErrDimensionMismatch:: 次元が合わない場合に発生します

注意

引数の行列 m は self を列ベクトルとした場合に乗算が定義できる行列である必要があります。

例

require 'matrix'

v = Vector[1, 2]
a = [4, 5, 6]
m = Matrix[a]

p v * m # => Matrix[[4, 5, 6], [8, 10, 12]]

[SEE_ALSO] Matrix.column_vector

self + v -> Vector | Matrix[permalink][rdoc][edit]

self にベクトル v を加えたベクトルを返します。

v には column_size が 1 の Matrix オブジェクトも指定できます。その場合は返り値も Matrix オブジェクトになります。

[PARAM] v:: 加算するベクトル。加算可能な行列やベクトルを指定します。
[EXCEPTION] ExceptionForMatrix::ErrDimensionMismatch:: self と引数のベクトルの要素の数(次元)が異なっていたときに発生します。

+ self -> selfRuby 2.2.0 から[permalink][rdoc][edit]

単項演算子の + です。 self を返します。

self - v -> Vector | Matrix[permalink][rdoc][edit]

self からベクトル v を減じたベクトルを返します。

v には column_size が 1 の Matrix オブジェクトも指定できます。その場合は返り値も Matrix オブジェクトになります。

[PARAM] v:: 減算するベクトル。減算可能な行列やベクトルを指定します。
[EXCEPTION] ExceptionForMatrix::ErrDimensionMismatch:: self と引数のベクトルの要素の数(次元)が異なっていたときに発生します。

- self -> selfRuby 2.2.0 から[permalink][rdoc][edit]

単項演算子の - です。self の逆ベクトル（各要素に -1 を乗じたベクトル）を返します。

self / other -> VectorRuby 1.9.3 から[permalink][rdoc][edit]

self の各要素を数 other で割ったベクトルを返します。

[PARAM] other:: self の各要素を割る Numeric オブジェクトを指定します。
[EXCEPTION] ExceptionForMatrix::ErrOperationNotDefined:: other が Vector や Matrix の場合に発生します

self == v -> bool[permalink][rdoc][edit]

eql?(v) -> bool

self と引数 v を比較し、true/false を返します。

[PARAM] v:: 比較対象ベクトル

self[i] -> object | nil[permalink][rdoc][edit]

element(i) -> object | nilRuby 1.9.3 から

component(i) -> object | nilRuby 1.9.3 から

i 番目の要素を返します。インデックスは 0 から開始します。要素が存在しないインデックスを指定した時には nil を返します。

[PARAM] i:: 取得する要素のインデックスを整数値で指定します。インデックスは 0 から始めます。

self[index] = valueRuby 2.6.0 から[permalink][rdoc][edit]

index 番目の要素を value に変更します。

[PARAM] index:: インデックスを整数で指定します。
[PARAM] value:: 設定したい要素の値を指定します。
[EXCEPTION] IndexError:: ベクトルの範囲外にある整数を指定したときに、発生します。

require 'matrix'

v = Vector[0, 0, 0, 0, 0]

v[1] = 2
p v #=> Vector[0, 2, 0, 0, 0]

v[-1] = 3
p v #=> Vector[0, 2, 0, 0, 3]

v[99] = 100
# IndexError: given index 99 is outside of -5...5

self[range] = vRuby 2.6.0 から[permalink][rdoc][edit]

Range オブジェクト range の範囲にある要素を v の内容に置換します。

[PARAM] range:: 設定したい配列の範囲を Range オブジェクトで指定します。
[PARAM] v:: range の範囲に設定したい要素を指定します。 Vector や 1行の Matrix での指定もできます。
[EXCEPTION] IndexError:: ベクトルの範囲外にある range を指定したときに、発生します。
[EXCEPTION] ArgumentError:: 引数の個数が異なるときの他に、 v に Vector を指定し、range と v のサイズが一致しないときに発生します。
[EXCEPTION] ExceptionForMatrix::ErrDimensionMismatch:: v に Matrix を指定し、次元が合わないときに発生します。

require 'matrix'

v = Vector[0, 0, 0, 0, 0]

v[1..2] = 5
p v #=> Vector[0, 5, 5, 0, 0]

v[1..3] = Vector[2, 4, 8]
p v #=> Vector[0, 2, 4, 8, 0]

v[1..-2] = Matrix[[3, 6, 9]]
p v #=> Vector[0, 3, 6, 9, 0]

angle_with(v) -> FloatRuby 2.2.0 から[permalink][rdoc][edit]

v と self がなす角度を返します。

例

require 'matrix'

p Vector[1, 0].angle_with(Vector[0, 1]) # => Math::PI/2

[PARAM] v:: このベクトルと self とがなす角度を計算します
[EXCEPTION] Vector::ZeroVectorError:: self もしくは v のどちらかが零ベクトルである場合に発生します
[EXCEPTION] ExceptionForMatrix::ErrDimensionMismatch:: v と self のベクトルの次元が異なる場合に発生します。

collect {|x| ... } -> Vector[permalink][rdoc][edit]

map {|x| ... } -> Vector

collect -> Enumerator

map -> Enumerator

ベクトルの各要素に対してブロックを評価した結果を、要素として持つベクトルを生成します。

ブロックを省略した場合は Enumerator を返します。

例

require 'matrix'

v = Vector[1, 2, 3.5]
p v.map{ |x| x * -1 }
# => Vector[-1, -2, -3.5]

collect! {|element| ... } -> selfRuby 2.6.0 から[permalink][rdoc][edit]

map! {|element| ... } -> self

collect! -> Enumerator

map! -> Enumerator

ベクトルの各要素を順番にブロックに渡して評価し、その結果で要素を置き換えます。

ブロックのない場合は、self と map! から生成した Enumerator オブジェクトを返します。

例

require 'matrix'

v = Vector[1, 2, 3]
v.map!{ |el| el * 2 }
p v # => Vector[2, 4, 6]

collect2(v) {|x, y| ... } -> Array[permalink][rdoc][edit]

collect2(v) -> Enumerator

ベクトルの各要素と引数 v の要素との組に対してブロックを評価し、その結果を要素として持つ配列を返します。

ベクトルの各要素と、それに対応するインデックスを持つ引数 v (ベクトル or 配列)の要素との組に対して (2引数の) ブロックを評価し、その結果を要素として持つ配列を返します。

ブロックを省略した場合は Enumerator を返します。

[PARAM] v:: ブロック内で評価される(ベクトル or 配列)
[EXCEPTION] ExceptionForMatrix::ErrDimensionMismatch:: self と引数のベクトルの要素の数(次元)が異なっていたときに発生します。

[SEE_ALSO] Vector#map2

次の例は、2つのベクトルの要素毎の積を要素とする配列を生成します。

例

require 'matrix'

v1 = Vector[2, 3, 5]
v2 = Vector[7, 9, 11]
a = Array[7, 9, 11]

z = v1.collect2(v2){ |x, y| x * y }
p z # => [14, 27, 55]

z = v1.collect2(a) { |x, y| x * y } # Array でも OK
p z # => [14, 27, 55]

covector -> Matrix[permalink][rdoc][edit]

Matrix オブジェクトへ変換します。

行ベクトル (行列)、すなわち、(1, n) 型の行列に変換します。実際には Matrix.row_vector(self) を適用します。

例

require 'matrix'

v = Vector[2, 3, 5]

p v.covector
# => Matrix[[2, 3, 5]]

[SEE_ALSO] Matrix.row_vector

cross_product(*vs) -> VectorRuby 2.1.0 から[permalink][rdoc][edit]

cross(*vs) -> VectorRuby 2.2.0 から

self とベクトル vs とのクロス積を返します。

self が3次元ベクトル空間のときは普通のクロス積です。それ以外の場合は拡張されたクロス積で n-1個のn次元ベクトルが張る空間と直交するベクトルを返します。

self の次元が n であるとき、 vs は n-2 個の n次元ベクトルでなければなりません。

[PARAM] vs:: クロス積を取るベクトルの集合
[EXCEPTION] ExceptionForMatrix::ErrOperationNotDefined:: self の次元が1以下であるときに発生します。
[EXCEPTION] ArgumentError:: vs のベクトルの個数が n-2 以外である場合に発生します。

inner_product(v) -> Float[permalink][rdoc][edit]

dot(v) -> FloatRuby 2.2.0 から

ベクトル v との内積を返します。

[PARAM] v:: 内積を求めるベクトル
[EXCEPTION] ExceptionForMatrix::ErrDimensionMismatch:: self と引数のベクトルの要素の数(次元)が異なっていたときに発生します。

each {|e| ... } -> selfRuby 1.9.3 から[permalink][rdoc][edit]

each -> Enumerator

ベクトルの各要素をブロックの引数として順にブロックを呼び出します。

このクラスは Enumerable を include しているため、このメソッドを経由して Enumerable の各メソッドを使うことができます。

ブロックを省略した場合は Enumerator を返します。

each2(v) {|x, y| ... } -> self[permalink][rdoc][edit]

each2(v) -> Enumerator

ベクトルの各要素と、それに対応するインデックスを持つ引数 v の要素との組に対して (2引数の) ブロックを繰返し評価します。

v は配列互換(size メソッドと [] メソッドを持つ)オブジェクトです。 Vector も使えます。

ブロックを省略した場合は Enumerator を返します。

[PARAM] v:: 各要素と組を取るためのオブジェクト
[EXCEPTION] ExceptionForMatrix::ErrDimensionMismatch:: self と引数のベクトルの要素の数(次元)が異なっていたときに発生します。

[SEE_ALSO] Array#zip

elements_to_f -> VectorRuby 1.9.3 から[permalink][rdoc][edit]

ベクトルの各成分をFloatに変換したベクトルを返します。

このメソッドは deprecated です。map(&:to_f) を使ってください。

例

require 'matrix'

p Vector[2, 3, 5].elements_to_f
# => Vector[2.0, 3.0, 5.0]

elements_to_i -> VectorRuby 1.9.3 から[permalink][rdoc][edit]

ベクトルの各成分をIntegerに変換したベクトルを返します。

このメソッドは deprecated です。map(&:to_i) を使ってください。

例

require 'matrix'

p Vector[2.5, 3.0, 5.01].elements_to_i
# => Vector[2, 3, 5]

elements_to_r -> VectorRuby 1.9.3 から[permalink][rdoc][edit]

ベクトルの各成分をRationalに変換したベクトルを返します。

このメソッドは deprecated です。map(&:to_r) を使ってください。

例

require 'matrix'

p Vector[2.5, 3.0, 5.75].elements_to_r
# => Vector[(5/2), (3/1), (23/4)]

hash -> Integer[permalink][rdoc][edit]

self のハッシュ値を返します。

independent?(*vectors) -> boolRuby 2.2.0 から[permalink][rdoc][edit]

self とベクトルの列 vectors が線形独立であれば true を返し、そうでなければ false を返します。

Vector.independent?(self, *vectors) と同じです。

[PARAM] vectors:: 線形独立性を判定するベクトル列

inspect -> String[permalink][rdoc][edit]

オブジェクトの内容を文字列化します。

r -> Float[permalink][rdoc][edit]

magnitude -> FloatRuby 1.9.3 から

norm -> FloatRuby 1.9.3 から

ベクトルの大きさ（ノルム）を返します。

例

require 'matrix'

p Vector[3, 4].norm # => 5.0
p Vector[1i, 0].norm # => 1.0

[SEE_ALSO] Vector#normalize

map2(v) {|x, y| ... } -> Vector[permalink][rdoc][edit]

ベクトルの各要素と引数 v の要素との組に対してブロックを評価し、その結果を要素として持つベクトルを返します。

ベクトルの各要素と、それに対応するインデックスを持つ引数 (ベクトル or 配列) の要素との組に対して (2引数の) ブロックを評価した結果を、要素として持つベクトルを返します。

ブロックを省略した場合は Enumerator を返します。

[PARAM] v:: ブロック内で評価される(ベクトル or 配列)
[EXCEPTION] ExceptionForMatrix::ErrDimensionMismatch:: self と引数のベクトルの要素の数(次元)が異なっていたときに発生します。

[SEE_ALSO] Vector#collect2

次の例は、2つのベクトルの要素毎の積を要素として持つベクトルを生成します。

例

require 'matrix'

v1 = Vector[2, 3, 5]
v2 = Vector[7, 9, 11]
a = Array[7, 9, 11]

z = v1.map2(v2) { |x, y| x * y }
p z # => Vector[14, 27, 55]

z = v1.map2(a) { |x, y| x * y } # Array でも OK
p z # => Vector[14, 27, 55]

normalize -> VectorRuby 1.9.3 から[permalink][rdoc][edit]

self を Vector#norm で正規化したベクトルを返します。

[EXCEPTION] Vector::ZeroVectorError:: ベクトルが0である場合に発生します。

例

require 'matrix'

v = Vector[2, 6, 9].normalize
# => Vector[0.18181818181818182, 0.5454545454545454, 0.8181818181818182]
p v.norm # => 1.0

[SEE_ALSO] Vector#norm

size -> Integer[permalink][rdoc][edit]

ベクトルの要素数(次元)を返します。

to_a -> Array[permalink][rdoc][edit]

ベクトル(Vector)から配列 (Array) に変換します。

例

require 'matrix'

p Vector[2, 3, 5].to_a
# => [2, 3, 5]

to_s -> String[permalink][rdoc][edit]

ベクトル(Vector)から文字列 (String) に変換します。

例

require 'matrix'

p Vector[2, 3, 5].to_s
# => "Vector[2, 3, 5]"

zero? -> boolRuby 2.5.0 から[permalink][rdoc][edit]

self が零ベクトルであれば true を返し、そうでなければ false を返します。

要約

目次

継承しているメソッド

特異メソッド

インスタンスメソッド

注意