このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

randperm

整数のランダム置換

構文

p = randperm(n)

p = randperm(n,k)

p = randperm(s,___)

説明

p = randperm(n) は、要素の重複しない 1 から n までの整数のランダム置換を含む行ベクトルを返します。

p = randperm(n,k) は、1 から n までの範囲で無作為に選択した k 個の一意の整数を含む行ベクトルを返します。

p = randperm(s,___) は、既定のグローバル ストリームの代わりに、乱数ストリーム s から、整数のランダム置換を生成します。ストリームを作成するには、RandStreamを使用します。s の後に、上記の構文にある任意の引数の組み合わせを指定します。

例

整数のランダム置換

1 から 6 までの整数のランダム置換を生成します。randperm の入力はサンプリング区間の最大の整数を示します (区間の最小の整数は 1)。

r = randperm(6)

r = 1×6

     6     3     5     1     2     4

選択された整数の置換

1 から 8 までの整数から 4 つの一意の整数を無作為に選択し、そのランダム置換を生成します (要素の重複なし)。

r1 = randperm(8,4)

r1 = 1×4

     6     4     7     3

4 つの一意の整数のランダム置換をもう 1 つ生成します。

r2 = randperm(8,4)

r2 = 1×4

     8     7     5     4

乱数発生の制御

乱数発生器の現在の状態を保存し、1 から 8 までの整数のランダム置換を作成します。

s = rng;
r = randperm(8)

r = 1×8

     6     3     7     8     5     1     2     4

乱数発生器を s の状態に戻し、1 から 8 までの整数のランダム置換を新たに作成します。置換は前と同じになります。

rng(s)
r1 = randperm(8)

r1 = 1×8

     6     3     7     8     5     1     2     4

関数rngを使用して、乱数発生器の設定を指定できます。

入力引数

n — サンプリング区間内の整数の数

正の整数

サンプリング区間内の整数の数。正の整数として指定します。randperm は、1 から n までの整数値を並べ替えます。

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

k — 選択される整数の数

正の整数

選択される整数の数。正の整数として指定します。また、k は n 以下でなければなりません。

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

s — 乱数ストリーム

RandStream オブジェクト

乱数ストリーム。RandStream オブジェクトとして指定します。

例: s = RandStream('dsfmt19937'); randperm(s,10)

ヒント

• randperm で生成される数列は、rand、randi、randn および randperm で使用される一様疑似乱数発生器の内部設定値によって定義されます。その共有の乱数発生器を制御するには、関数 rng を使用します。

• randperm によって返される配列には、整数の置換が含まれます (整数値の重複なし)。この動作は、非復元抽出と呼ばれることがあります。重複する値が必要な場合は、関数 randi を使用します。

• randperm(n) と randperm(n,n) は、いずれも 1 から n までの整数の置換を生成しますが、置換内で異なるランダムな順序を与えることができます。n の値が大きい場合は、randperm(n,n) の方が randperm(n) よりも高速です。

拡張機能

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

GPU 配列

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

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

• この関数を GPU で実行するには、構文 p = gpuArray.randperm(n) を使用します。

• 2 入力の構文はサポートされていません。

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

参考

permute | nchoosek | randi | perms | rng

R2006a より前に導入

×

例を開く

この例の変更されたバージョンがあります。編集された方の例を開きますか?

いいえ、変更されたバージョンを上書きします。 はい