このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

ones

すべての要素が 1 の配列の作成

構文

X = ones

X = ones(n)

X = ones(sz1,...,szN)

X = ones(sz)

X = ones(___,typename)

X = ones(___,'like',p)

説明

X = ones はスカラー 1 を返します。

X = ones(n) は、n 行 n 列の 1 の行列を返します。

X = ones(sz1,...,szN) は、sz1×...×szN の 1 の配列を返します。ここで sz1,...,szN はそれぞれの次元のサイズを示します。たとえば、ones(2,3) は 2 行 3 列の 1 の配列を返します。

X = ones(sz) は 1 の配列を返し、サイズ ベクトル sz が size(X) を定義します。たとえば、ones([2,3]) は 2 行 3 列の 1 の配列を返します。

X = ones(___,typename) は、上記の任意の構文で、X のデータ型 (クラス) も指定します。たとえば、ones(5,'int8') は 8 ビット整数の 5 行 5 列の行列を返します。

X = ones(___,'like',p) は、X が数値変数 p と同じデータ型、スパース性、実数/複素数をもつように指定します。

例

1 の正方配列

4 行 4 列の 1 の配列を作成します。

X = ones(4)

X = 4×4

     1     1     1     1
     1     1     1     1
     1     1     1     1
     1     1     1     1

3 次元の 1 の配列

2×3×4の 1 の配列を作成します。

X = ones(2,3,4);

size(X)

ans = 1×3

     2     3     4

既存の配列によるサイズの定義

3 行 2 列の配列 A を定義します。

A = [1 4 ; 2 5 ; 3 6];

sz = size(A)

sz = 1×2

     3     2

A と同じサイズの 1 の配列を作成します。

X = ones(sz)

X = 3×2

     1     1
     1     1
     1     1

既定以外の数値データ型

要素が 16 ビット符号なしの整数である 1 行 3 列の 1 のベクトルを作成します。

X = ones(1,3,'uint16'),

X = 1x3 uint16 row vector

   1   1   1

class(X)

ans = 
'uint16'

複素数の 1

既存の配列のような、実数値ではなく複素数のスカラー 1 を作成します。

複素数ベクトルを定義します。

p = [1+2i 3i];

p のような複素数であるスカラー 1 を作成します。

X = ones('like',p)

X = 
1.0000 + 0.0000i

既存の配列で定義されるサイズと数値データ型

8 ビット符号なしの整数の 2 行 3 列の配列を定義します。

p = uint8([1 3 5 ; 2 4 6]);

p とサイズおよびデータ型が同じである 1 の配列を作成します。

X = ones(size(p),'like',p),

X = 2x3 uint8 matrix

   1   1   1
   1   1   1

class(X)

ans = 
'uint8'

入力引数

n — 正方行列のサイズ

整数値

正方行列のサイズ。整数値として指定し、出力を n 行 n 列の 1 の行列として定義します。

• n が 0 の場合、X は空の行列です。

• n が負の場合、0 として扱われます。

データ型: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

sz1,...,szN — 各次元のサイズ

2 つ以上の整数値

各次元のサイズ。2 つ以上の整数値として指定し、X を sz1×...×szN の配列として定義します。

• いずれかの次元のサイズが 0 の場合、X は空の配列です。

• いずれかの次元のサイズが負の場合、そのサイズは 0 として扱われます。

• 2 より大きな後続の次元のサイズが 1 の場合、出力 X にこれらの次元は含まれません。

データ型: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

sz — 出力サイズ

整数値の行ベクトル

出力サイズ。整数値の行ベクトルとして指定します。このベクトルの各要素は対応する次元のサイズを示します。

• いずれかの次元のサイズが 0 の場合、X は空の配列です。

• いずれかの次元のサイズが負の場合、そのサイズは 0 として扱われます。

• 2 より大きな後続の次元のサイズが 1 の場合、出力 X にこれらの次元は含まれません。

例: sz = [2 3 4] は、X を 2×3×4 の配列として定義します。

データ型: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

typename — 出力クラス

'double' (既定値) | 'single' | 'logical' | 'int8' | 'uint8' | ...

出力クラス。'double'、'single'、'logical'、'int8'、'uint8'、'int16'、'uint16'、'int32'、'uint32'、'int64' または 'uint64' として指定します。

p — プロトタイプ

変数

プロトタイプ。変数として指定します。

データ型: double | single | logical | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64
複素数のサポート: あり

拡張機能

C/C++ コード生成

MATLAB® Coder™ を使用して C および C++ コードを生成します。

使用上の注意および制限:

• 次元は実数で非負の整数でなければなりません。空の次元はサポートされていません。

GPU コード生成

GPU Coder™ を使用して NVIDIA® GPU のための CUDA® コードを生成します。

使用上の注意および制限:

使用上の注意事項および制限事項については、「C/C++ コード生成」セクションを参照してください。GPU コード生成にも同じ制限が適用されます。

HDL コード生成

HDL Coder™ を使用して FPGA 設計および ASIC 設計のための VHDL、Verilog および SystemVerilog のコードを生成します。

次元は実数で非負の整数でなければなりません。

スレッドベースの環境

MATLAB® の backgroundPool を使用してバックグラウンドでコードを実行するか、Parallel Computing Toolbox™ の ThreadPool を使用してコードを高速化します。

この関数はスレッドベースの環境を完全にサポートしています。詳細については、スレッドベースの環境での MATLAB 関数の実行を参照してください。

GPU 配列

Parallel Computing Toolbox™ を使用してグラフィックス処理装置 (GPU) 上で実行することにより、コードを高速化します。

ones 関数は GPU 配列入力をサポートしますが、次の使用上の注意および制限があります。

• typename を 'gpuArray' として指定できます。typename を 'gpuArray' として指定する場合、配列の基となる型は既定では double になります。

  基となる型が datatype の GPU 配列を作成するには、typename の前に追加の引数として基となる型を指定します。たとえば、X = ones(3,datatype,'gpuArray') は、基となる型が datatype の 1 から成る 3 行 3 列の GPU 配列を作成します。

  基となる型 datatype は次のオプションのいずれかとして指定できます。

  • 'double'

  • 'single'

  • 'logical'

  • 'int8'

  • 'uint8'

  • 'int16'

  • 'uint16'

  • 'int32'

  • 'uint32'

  • 'int64'

  • 'uint64'

• 数値変数 p についても、gpuArray として指定できます。

  p を gpuArray として指定する場合、返される配列の基となる型は p と同じになります。

詳細については、GPU での MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

分散配列

Parallel Computing Toolbox™ を使用して、クラスターの結合メモリ上で大きなアレイを分割します。

使用上の注意および制限:

• typename を 'codistributed' または 'distributed' として指定できます。typename を 'codistributed' または 'distributed' として指定する場合、返される配列の基となる型は既定では double になります。

  基となる型が datatype の分散配列または対話型分散配列を作成するには、typename の前に追加の引数として基となる型を指定します。たとえば、X = ones(3,datatype,'distributed') は、基となる型が datatype の 1 から成る 3 行 3 列の分散行列を作成します。

  基となる型 datatype は次のオプションのいずれかとして指定できます。

  • 'double'

  • 'single'

  • 'logical'

  • 'int8'

  • 'uint8'

  • 'int16'

  • 'uint16'

  • 'int32'

  • 'uint32'

  • 'int64'

  • 'uint64'

• p についても、codistributed または distributed の配列として指定できます。

  p を codistributed または distributed の配列として指定する場合、返される配列の基となる型は p と同じになります。

• codistributed の追加の構文の詳細については、ones (codistributed) (Parallel Computing Toolbox) を参照してください。

詳細については、分散配列を使用した MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

バージョン履歴

R2006a より前に導入

参考

eye | zeros | rand | randn | complex | false | size

トピック

• 配列作成関数に対するクラス サポート
• 事前割り当て