このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。
varfun
関数をテーブル変数または timetable 変数に適用
説明
は、1 つ以上の引数 B
= varfun(func
,A
,Name,Value
)Name,Value
で指定された追加のオプションを使用して、関数 func
を table または timetable A
の各変数に個別に適用します。
たとえば、名前と値の引数 "GroupingVariables"
を使用して、table 変数内のデータのグループに対して計算を実行できます。データのグループに対する計算の詳細については、データ グループに対する計算を参照してください。
例
要素単位関数の適用
要素単位関数を table の変数に適用します。
数値変数を含む table を作成します。
A = table([10.71;-2.05;-0.35;-0.82;1.57],[9.23;3.12;-1.18;0.23;16.41])
A=5×2 table
Var1 Var2
_____ _____
10.71 9.23
-2.05 3.12
-0.35 -1.18
-0.82 0.23
1.57 16.41
関数 round
を使用して、A
の数値を丸めます。varfun
への入力引数として関数を指定するには、@
記号を使用します。出力 table B
の変数には、関数と A
の変数名に基づいて名前が付けられます。
B = varfun(@round,A)
B=5×2 table
round_Var1 round_Var2
__________ __________
11 9
-2 3
0 -1
-1 0
2 16
table 変数を削減する関数の適用
最初の次元に沿って table 変数を削減する sum
や max
などの関数を適用できます。たとえば、varfun
を使用して table 内の各変数の平均を計算します。
数値変数を含む table を作成します。
A = table([0.71;-2.05;-0.35;-0.82;1.57],[0.23;0.12;-0.18;0.23;0.41])
A=5×2 table
Var1 Var2
_____ _____
0.71 0.23
-2.05 0.12
-0.35 -0.18
-0.82 0.23
1.57 0.41
func
を関数 mean
として指定します。func
を関数ハンドルとして指定するには、@
記号を使用します。
func = @mean
func = function_handle with value:
@mean
テーブル A
のすべての変数に関数を適用します。
B = varfun(func,A)
B=1×2 table
mean_Var1 mean_Var2
_________ _________
-0.188 0.162
B
は、各変数からの平均値を含む table です。
varfun
が table ではなく数値ベクトルを返すようにするには、"OutputFormat"
を "uniform"
として指定します。"uniform"
出力形式を使用するには、func
は常にスカラーを返す必要があります。
B = varfun(func,A,"OutputFormat","uniform")
B = 1×2
-0.1880 0.1620
変数内のグループへの関数の適用
データを含む数値変数、およびグループ化変数である非数値変数をもつ table を作成します。次に、数値変数内の各グループに対して計算を実行します。
関数 readtable
を使用して、CSV (コンマ区切り値) ファイル testScores.csv
から table へデータを読み取ります。このサンプル ファイルには、2 つの異なる学校に通う生徒 10 人のテストの得点が含まれています。出力 table には、数値データをもつ変数とテキスト データをもつ他の変数が含まれます。これらの変数の 1 つ School
は、固定されたセットの値、つまりカテゴリをもっています。これらのカテゴリは、この table 内の 2 つの生徒グループを表します。School
を categorical
変数に変換します。
scores = readtable("testScores.csv","TextType","string"); scores.School = categorical(scores.School)
scores=10×5 table
LastName School Test1 Test2 Test3
__________ __________ _____ _____ _____
"Jeong" XYZ School 90 87 93
"Collins" XYZ School 87 85 83
"Torres" XYZ School 86 85 88
"Phillips" ABC School 75 80 72
"Ling" ABC School 89 86 87
"Ramirez" ABC School 96 92 98
"Lee" XYZ School 78 75 77
"Walker" ABC School 91 94 92
"Garcia" ABC School 86 83 85
"Chang" XYZ School 79 76 82
各テストの平均点を学校別に計算します。変数 Test1
、Test2
、および Test3
は、データを含む数値変数です。変数 School
はグループ化変数です。グループ化変数を指定すると、その一意の値により、データ変数内の対応する値が属するグループが指定されます。
vars = ["Test1","Test2","Test3"]; meanScoresBySchool = varfun(@mean, ... scores, ... "InputVariables",vars, ... "GroupingVariables","School")
meanScoresBySchool=2×5 table
School GroupCount mean_Test1 mean_Test2 mean_Test3
__________ __________ __________ __________ __________
ABC School 5 87.4 87 86.8
XYZ School 5 84 81.6 84.6
出力 meanScoresBySchool
には、そのグループに含まれる入力 table scores
からのエントリ数を示す GroupCount
という変数も含まれています。
timetable 変数内のグループへの関数の適用
サンプル データを含む timetable を作成します。行時間は重複することがあるため、timetable の行時間でもグループを定義できます。
Timestamps = datetime(2023,1,1)+days([0 1 1 2 3 3])'; A = timetable(Timestamps, ... [0.71;-2.05;-0.35;-0.82;1.57;0.09], ... [0.23;0.12;-0.18;0.23;0.41;0.02], ... 'VariableNames',["x","y"])
A=6×2 timetable
Timestamps x y
___________ _____ _____
01-Jan-2023 0.71 0.23
02-Jan-2023 -2.05 0.12
02-Jan-2023 -0.35 -0.18
03-Jan-2023 -0.82 0.23
04-Jan-2023 1.57 0.41
04-Jan-2023 0.09 0.02
timetable 内の変数の平均値を計算します。行時間のベクトルをグループ化変数として指定します。入力 A
が timetable であるため、出力 B
は timetable です。行時間のベクトルをグループ化変数として指定すると、いずれの変数も別のグループ化変数として指定できません。
B = varfun(@mean,A,"GroupingVariables","Timestamps")
B=4×3 timetable
Timestamps GroupCount mean_x mean_y
___________ __________ ______ ______
01-Jan-2023 1 0.71 0.23
02-Jan-2023 2 -1.2 -0.03
03-Jan-2023 1 -0.82 0.23
04-Jan-2023 2 0.83 0.215
入力引数
func
— 関数
関数ハンドル
関数。関数ハンドルとして指定します。既存の関数のハンドルを指定するか、ファイルで関数を定義するか、無名関数として指定できます。func
が複数の関数ファイルに対応している場合 (つまり、func
がオーバーロードされた関数セットを表す場合)、MATLAB® は入力引数のクラスに基づいて呼び出す関数を決定します。
関数 func
が入力引数を 1 つ取り、この関数が呼び出されるたびに異なる行数の配列を返す場合、名前と値の引数 "OutputFormat","cell"
を使用します。それ以外の場合、func
は、同じ行数の配列を返さなければなりません。
例: func = @sum;
は、入力の和を計算します。
例: func = @(x) x.^2;
は、入力の各要素の二乗を計算します。
A
— 入力テーブル
table | timetable
入力テーブル。table または timetable として指定します。
名前と値の引数
引数のオプションのペアを Name1=Value1,...,NameN=ValueN
として指定します。ここで Name
は引数名で、Value
は対応する値です。名前と値の引数は他の引数の後になければなりませんが、ペアの順序は重要ではありません。
R2021a より前では、コンマを使用してそれぞれの名前と値を区切り、Name
を引用符で囲みます。
例: InputVariables=["Var2","Var3"]
は、A
の Var2
および Var3
という名前の変数のみを func
への入力として使用します。
InputVariables
— func
に渡す A
の変数を選択する指定子
正の整数 | 正の整数のベクトル | string 配列 | 文字ベクトル | 文字ベクトルの cell 配列 | pattern
スカラー | logical ベクトル | 関数ハンドル
func
に渡す A
の変数を選択する指定子。"InputVariables"
と、正の整数、正の整数のベクトル、string 配列、文字ベクトル、文字ベクトルの cell 配列、pattern
スカラー、logical ベクトル、または関数ハンドルとして指定します。
"InputVariables"
を関数ハンドルとして指定する場合、この関数ハンドルは logical スカラーを返さなければならず、varfun
は関数が 1
(true
) を返した A
内の変数のみを渡します。
GroupingVariables
— グループ化変数にする A
の変数を選択する指定子
正の整数 | 正の整数のベクトル | string 配列 | 文字ベクトル | 文字ベクトルの cell 配列 | pattern
スカラー | logical ベクトル
グループ化変数にする A
の変数を選択する指定子。"GroupingVariables"
と、正の整数、正の整数のベクトル、string 配列、文字ベクトル、文字ベクトルの cell 配列、pattern
スカラー、または logical ベクトルとして指定します。
グループ化変数の一意の値によってグループを指定します。A
内の行は、グループ化変数の値が同じであれば、同じグループに属します。varfun
は、変数全体ではなく、A
の残りの各変数内の行のグループごとに func
を適用します。グループ化変数を使用した計算の詳細については、データ グループに対する計算を参照してください。
グループ化変数は、表にリストされているデータ型のいずれかにすることができます。
グループを指定する値 | グループ化変数のデータ型 |
---|---|
数字 | 数値または logical ベクトル |
テキスト | string 配列または文字ベクトルの cell 配列 |
日付と時刻 |
|
カテゴリ |
|
ビン | ビン化された値のベクトル。数値、 |
いずれかのグループ化変数に NaN
または欠損値 (NaT
、未定義の categorical
値、欠損 string など) が含まれている場合、それに対応する行はどのグループにも属さず、出力から除外されます。
行ラベルはグループ化変数にすることができます。行ラベルのみ、A
内の 1 つ以上の変数、または行ラベルと変数を同じグループにすることができます。
A
が table の場合、ラベルは行名です。A
が timetable の場合、ラベルは行時間です。
出力 B
には、入力 A
の行のグループごとに 1 つの行があります。B
が table または timetable の場合、B
は以下をもちます。
func
が適用された入力 table 変数に対応する変数。グループ化変数に対応する変数。
新しい変数
GroupCount
。その値は、各グループ内の入力A
の行数です。
メモ: B
が timetable の場合、B
は以下ももちます。
行時間。
A
の各行グループの最初の行時間が、B
の対応する行時間です。B
を行時間のない table として返すには、"OutputFormat"
を"table"
として指定します。
OutputFormat
— B
の形式
"auto"
(既定値) | "table"
| "timetable"
| "uniform"
| "cell"
B
の形式。"OutputFormat"
と、"auto"
、"table"
、"timetable"
、"uniform"
、または "cell"
の値として指定します。
|
|
|
|
|
|
|
|
|
|
ErrorHandler
— func
が失敗した場合に呼び出す関数
関数ハンドル
func
が失敗した場合に呼び出す関数。"ErrorHandler"
と関数ハンドルとして指定します。この関数を定義して、エラーを再スローするか、関数 func
に対して有効な出力を返すようにします。
MATLAB は、以下の 2 つの入力引数を使用して、指定されたエラー処理関数を呼び出します。
構造体には以下のフィールドがあります。
identifier
エラー識別子。
message
エラー メッセージ テキスト。
index
エラーが発生した変数のインデックス。
name
エラーが発生した変数の名前。
エラー発生時の関数
func
への入力引数の集合。
以下に例を示します。
function [A, B] = errorFunc(S, varargin)
warning(S.identifier, S.message)
A = NaN; B = NaN;
出力引数
詳細
データ グループに対する計算
データ解析では、データ グループに対して計算を実行するのが一般的です。このような計算では、1 つ以上のデータ変数をデータ グループに分割し、各グループに対して計算を実行し、結果を 1 つ以上の出力変数に結合します。1 つ以上の "グループ化変数" を使用してグループを指定できます。グループ化変数の一意の値は、データ変数の対応する値が属するグループを定義します。
たとえばこの図は、6 行 1 列の数値ベクトルを 2 つのデータ グループに分け、各グループの平均を計算し、その出力を 2 行 1 列の数値ベクトルにまとめる単純なグループ化計算を示しています。6 行 1 列のグループ化変数には、AB
と XYZ
の 2 つの一意の値があります。
数値、テキスト、日時、カテゴリ、またはビンをもつグループ化変数を指定できます。
拡張機能
tall 配列
メモリの許容量を超えるような多数の行を含む配列を計算します。
この関数は tall 配列を制限付きでサポートしています。
func
入力は常に tall 配列を返さなければなりません。以下の名前と値のペアがサポートされます。
'InputVariables'
— 関数ハンドルまたはパターン式としては指定できません。'GroupingVariables'
— 値をパターン式にすることはできません。'OutputFormat'
— 値は'uniform'
、'table'
、'timetable'
または'cell'
のみです。
入力配列が tall timetable で
'OutputFormat'
が'timetable'
の場合、指定した関数は最初の次元のサイズが入力と同じである配列を返さなければなりません。入力関数がmean
などのリダクション関数の場合、'OutputFormat'
を'table'
として指定します。
詳細については、tall 配列を参照してください。
C/C++ コード生成
MATLAB® Coder™ を使用して C および C++ コードを生成します。
使用上の注意事項および制限事項:
関数ハンドル入力
func
は定数でなければなりません。関数ハンドルを
varfun
自体への入力にすることはできますが、エントリ ポイント関数への入力にすることはできません。コード生成用のコード内ではfunc
を指定してください。詳細については、コード生成における関数ハンドルの制限事項 (MATLAB Coder)を参照してください。すべての名前と値の引数について、値は定数でなければなりません。
名前と値の引数
"InputVariables"
および"GroupingVariables"
の値は、パターン式をサポートしません。名前と値の引数
"ErrorHandler"
はコード生成でサポートされていません。可変サイズの入力引数はサポートされていません。
グループ化変数に生成コードの重複する値を含めることはできません。
名前と値の引数
"GroupingVariables"
を指定し、関数から"InputVariables"
で指定した各変数について異なるデータ型が返される場合、"OutputFormat"
の値を"cell"
として指定することはできません。入力が timetable の場合に
"GroupingVariables"
を指定すると、出力は常に不規則な timetable になります。グループを指定した場合、コンパイル時にグループの数が不明で、その数がゼロになると、出力の空の double 変数が生成コードにおいて 1 行 0 列のサイズになることがあります。MATLAB では、そのような変数のサイズは 0 行 0 列になります。
スレッドベースの環境
MATLAB® の backgroundPool
を使用してバックグラウンドでコードを実行するか、Parallel Computing Toolbox™ の ThreadPool
を使用してコードを高速化します。
バージョン履歴
R2013b で導入R2023a: 名前と値の引数 "OutputFormat"
で値として "auto"
を受け取り可能
名前と値の引数 "OutputFormat"
で値として "auto"
を受け取ることができます。この値は既定値です。これにより、varfun
は、入力 A
のデータ型に一致するデータ型をもつ出力を返します。
MATLAB コマンド
次の MATLAB コマンドに対応するリンクがクリックされました。
コマンドを MATLAB コマンド ウィンドウに入力して実行してください。Web ブラウザーは MATLAB コマンドをサポートしていません。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)