Main Content

nominal

(非推奨) ノミナル データの配列

nominal 配列データ型および ordinal 配列データ型は推奨されません。順序付きおよび順序付けのない離散非数値データを表すには、代わりにcategorical 配列データ型を使用します。

説明

ノミナル データは離散型の非数値データであり、自然な順列ではありません。nominal 配列オブジェクトは、このようなデータを効率的に保存して操作するのに適しています。また、意味のわかりやすいラベルを値に維持することもできます。

nominal 配列は、添字付け、連結、形状の変更によって、通常の数値配列のように操作できます。観測値が属するグループを要素が示す場合、グループ化変数として nominal 配列を使用します。

作成

説明

B = nominal(X) は、配列 X からノミナル配列 B を作成します。nominal は、X 内の並べ替えられた一意な値から B のレベルを作成し、このレベルに対して既定のラベルを作成します。

B = nominal(X,labels) は、labels に従って B にレベルをラベル付けします。

B = nominal(X,labels,levels) は、levels が定義する可能なレベルでノミナル配列を作成します。

B = nominal(X,labels,[],edges) は、数値ベクトル edges で指定されたビンのエッジを使用して数値配列 X をビンにまとめることにより、ノミナル配列を作成します。

入力引数

すべて展開する

nominal に変換する入力配列。数値配列、logical 配列、文字配列、string 配列、categorical 配列、または文字ベクトルの cell 配列を指定します。結果の配列 nominal のレベルは X の並べ替えられた一意の値に対応します。

離散レベルのラベル。文字配列、string 配列、または文字ベクトルの cell 配列を指定します。既定では、nominal は、X 内の並べ替えられた一意な値の順序で B 内のレベルにラベルを割り当てます。

重複するラベルを labels に含めると、X の複数の値を B の 1 つのレベルにマージできます。

データ型: char | string | cell

出力 nominal 配列の可能なレベル nominal。ベクトルとして指定します。ベクトルの値は等号演算子を使用して X 内の値と比較できます。nominal は、labels の対応する要素から各レベルにラベルを割り当てます。X に、levels に存在しない値が含まれている場合は、B の対応する要素のレベルは定義されません。

数値配列をビンにまとめて nominal 配列を作成するために使用するビンのエッジ。数値ベクトルを指定します。最上位のビンには右端のエッジと等しい値が含まれます。nominal は、対応する labels の要素から生成される nominal 配列内の各レベルにラベルを割り当てます。入力引数 edges を指定する場合、labels より要素が 1 つ多くなければなりません。

出力引数

すべて展開する

ノミナル配列。nominal 配列オブジェクトとして返します。

既定では、X の対応する要素が NaN (X が数値)、空の文字ベクトル (X が文字)、空の string または欠損 string (X が string)、または未定義 (X が categorical) である場合、B の要素は定義されません。nominal は、このような要素を未定義または欠損として扱い、これらに対するエントリを可能なレベルに含めません。未定義として扱うのではなく、このような要素に対する明示的なレベルを作成するには、入力引数 levels を使用して、NaN、空の文字ベクトル、空の string、欠損 string または未定義の要素を含めなければなりません。

オブジェクト関数

addlevels(非推奨) ノミナル配列または順序配列へのレベルの追加
droplevels(非推奨) ノミナルまたは順序配列からのレベルの削除
getlabels(非推奨) ノミナル配列または順序配列のラベルにアクセス
getlevels(非推奨) ノミナル配列または順序配列のレベルにアクセス
islevel(非推奨) レベルが、ノミナル配列であるか順序配列であるかを決定
levelcounts(非推奨) ノミナル配列または順序配列のレベルごとの要素カウント
mergelevels(非推奨) ノミナル配列または順序配列のレベルのマージ
reorderlevels(非推奨) ノミナル配列または順序配列のレベルの並べ替え
setlabels(非推奨) ノミナル配列または順序配列のレベルにラベルを割り当て

次の一覧は、ノミナル配列を使用できる MATLAB® 配列関数の一部です。

double倍精度配列
histogramヒストグラム プロット
isequal配列の等価性を判別
isundefinedcategorical 配列の未定義の要素を検索
pieレガシ円グラフ
summarytable、timetable または categorical 配列の概要の表示
times乗算

すべて折りたたむ

文字ベクトルの cell 配列および整数データからノミナル配列を作成します。明示的なラベルを指定します。

'r''g' および 'b' が含まれている文字ベクトルの cell 配列からノミナル配列を作成します。これらのレベルに、それぞれ 'red''green''blue' というラベルを付けます。nominal は、X 内の (アルファベット順で) 並べ替えられた要素の順序に従ってラベルを割り当てます。

X = {'r' 'b' 'g';'g' 'r' 'b';'b' 'r' 'g'}
X = 3x3 cell
    {'r'}    {'b'}    {'g'}
    {'g'}    {'r'}    {'b'}
    {'b'}    {'r'}    {'g'}

labels = {'blue','green','red'};
B = nominal(X,labels)
B = 3x3 nominal
     red        blue      green 
     green      red       blue  
     blue       red       green 

値が 1 ~ 4 の整数データからノミナル配列を作成して、'odd' および 'even' というラベルをもつ 2 つのノミナル レベルに奇数と整数の値をマージします。ラベルを複製することにより値をマージします。

X = randi([1 4],5,2)
X = 5×2

     4     1
     4     2
     1     3
     4     4
     3     4

labels = {'odd','even','odd','even'};
B = nominal(X,labels)
B = 5x2 nominal
     even      odd  
     even      even 
     odd       odd  
     even      even 
     odd       even 

cell 配列のデータからノミナル配列を作成します。

X = {'r','b','g';'g','r','b';'b','r','g'};
labels = {'blue','green','red'};
colors = nominal(X,labels)
colors = 3x3 nominal
     red        blue      green 
     green      red       blue  
     blue       red       green 

レベル 'red' のメンバーである colors の要素を特定します。結果の配列の値 1 は、colors の対応する要素が 'red' のメンバーであることを示します。

colors == 'red'
ans = 3x3 logical array

   1   0   0
   0   1   0
   0   1   0

レベル 'red' または 'blue' のいずれかのメンバーである colors の要素を特定します。

ismember(colors,{'red','blue'})
ans = 3x3 logical array

   1   1   0
   0   1   1
   1   1   0

'red' および'blue' レベルの要素を 'purple' とラベル付けされる新規ラベルにマージします。

colors = mergelevels(colors,{'red','blue'},'purple')
colors = 3x3 nominal
     purple      purple      green  
     green       purple      purple 
     purple      purple      green  

colors のレベルを表示します。

getlevels(colors)
ans = 1x2 nominal
     purple      green 

各レベルの要素数をまとめます。既定では、summary は、入力配列の各列のカウントを返します。

summary(colors)
     purple      2      3      1 
     green       1      0      2 

colors のデータの円グラフを作成します。

pie(colors)

バージョン履歴

R2007a で導入