setvaropts
変数のインポート オプションの設定
説明
opts = setvaropts(opts,Name,Value)Name,Value 引数の指定に基づいて opts オブジェクトのすべての変数を更新し、opts オブジェクトを返します。
opts = setvaropts(opts,selection,Name,Value)Name,Value 引数の指定に基づいて selection 引数で指定された変数の opts を更新して返します。
例
選択した変数のオプションの設定
インポート オプション オブジェクトを作成して、選択した変数にオプションを設定し、調整したオプションと関数 readtable を使用してデータをインポートします。
スプレッドシート patients.xls のオプション オブジェクトを作成します。
opts = detectImportOptions('patients.xls');変数 Smoker、Diastolic および Systolic の FillValue プロパティを設定します。
opts = setvaropts(opts,'Smoker','FillValue',false); opts = setvaropts(opts,{'Diastolic','Systolic'},'FillValue',0);
インポートする変数を選択します。
opts.SelectedVariableNames = {'Smoker','Diastolic','Systolic'};変数をインポートして概要を表示します。
T = readtable('patients.xls',opts);
summary(T) Variables:
Smoker: 100x1 logical
Values:
True 34
False 66
Diastolic: 100x1 double
Values:
Min 68
Median 81.5
Max 99
Systolic: 100x1 double
Values:
Min 109
Median 122
Max 138
欠損レコードまたは不完全なレコードを含む数値データのオプションの設定
欠損フィールドまたは不完全なフィールドを含むデータをインポートするには、欠損インスタンスを認識し、欠損インスタンスをインポートする方法を決定する必要があります。importOptions にこれら両方の決定をもたせ、readtable を使用してデータを取得します。
ファイルのインポート オプション オブジェクトを作成して、欠損データのインポートを制御するプロパティを更新し、readtable を使用してデータをインポートします。データセット airlinesmall.csv には、NA によって示される欠損データを含む 2 つの数値変数 ArrDelay と DepDelay がある点に注意してください。
ファイルからインポート オプション オブジェクトを作成します。
opts = detectImportOptions('airlinesmall.csv');TreatAsMissing プロパティを使用して、欠損インスタンスのプレース ホルダーとなるデータ内の文字を指定します。この例では、2 つの数値変数 ArrDelay と DepDelay にテキスト NA を含む欠損フィールドが含まれています。
opts = setvaropts(opts,{'ArrDelay','DepDelay'},'TreatAsMissing','NA');欠損インスタンスのインポート時に実行する、インポート関数のアクションを指定します。その他のオプションについては、ImportOptions プロパティのページを参照してください。
opts.MissingRule = 'fill';インポート関数が欠損インスタンスを見つけたときに使用する値を指定します。ここでは、変数 ArrDelay と変数 DepDelay 内の欠損インスタンスを 0 で置き換えます。
opts = setvaropts(opts,{'ArrDelay','DepDelay'},'FillValue',0);操作する変数を選択し、readtable を使用してそれらをインポートします。
opts.SelectedVariableNames = {'ArrDelay','DepDelay'};
T = readtable('airlinesmall.csv',opts);ArrDelay と DepDelay 内の値を調べます。インポート関数が NA によって示された欠損値を置き換えたことを確認します。
T(166:180,:)
ans=15×2 table
ArrDelay DepDelay
________ ________
-1 0
102 105
-11 0
0 0
-1 0
0 0
1 0
1 0
14 0
-14 0
5 0
25 38
0 -5
0 0
6 0
16 進数および 2 進数のオプションの設定
関数 readtable は接頭辞 0x および 0b の付いた 16 進数と 2 進数を自動的に検出します。接頭辞が付いていないときにこうした数値をインポートするには、インポート オプション オブジェクトを使用します。
ファイル hexAndBinary.txt のインポート オプション オブジェクトを作成します。その 3 列目には接頭辞 0x のない 16 進数が含まれます。
opts = detectImportOptions('hexAndBinary.txt')opts =
DelimitedTextImportOptions with properties:
Format Properties:
Delimiter: {','}
Whitespace: '\b\t '
LineEnding: {'\n' '\r' '\r\n'}
CommentStyle: {}
ConsecutiveDelimitersRule: 'split'
LeadingDelimitersRule: 'keep'
TrailingDelimitersRule: 'ignore'
EmptyLineRule: 'skip'
Encoding: 'UTF-8'
Replacement Properties:
MissingRule: 'fill'
ImportErrorRule: 'fill'
ExtraColumnsRule: 'addvars'
Variable Import Properties: Set types by name using setvartype
VariableNames: {'Var1', 'Var2', 'Var3' ... and 1 more}
VariableTypes: {'auto', 'auto', 'char' ... and 1 more}
SelectedVariableNames: {'Var1', 'Var2', 'Var3' ... and 1 more}
VariableOptions: Show all 4 VariableOptions
Access VariableOptions sub-properties using setvaropts/getvaropts
VariableNamingRule: 'modify'
Location Properties:
DataLines: [1 Inf]
VariableNamesLine: 0
RowNamesColumn: 0
VariableUnitsLine: 0
VariableDescriptionsLine: 0
To display a preview of the table, use preview
3 列目を 16 進数値としてインポートしなければならないことを指定するには、接頭辞がなくても関数 setvaropts を使用します。3 番目の変数の変数型を int32 に設定します。3 列目を hex にインポートするための記数法を設定します。
opts = setvaropts(opts,3,'NumberSystem','hex','Type','int32')
opts =
DelimitedTextImportOptions with properties:
Format Properties:
Delimiter: {','}
Whitespace: '\b\t '
LineEnding: {'\n' '\r' '\r\n'}
CommentStyle: {}
ConsecutiveDelimitersRule: 'split'
LeadingDelimitersRule: 'keep'
TrailingDelimitersRule: 'ignore'
EmptyLineRule: 'skip'
Encoding: 'UTF-8'
Replacement Properties:
MissingRule: 'fill'
ImportErrorRule: 'fill'
ExtraColumnsRule: 'addvars'
Variable Import Properties: Set types by name using setvartype
VariableNames: {'Var1', 'Var2', 'Var3' ... and 1 more}
VariableTypes: {'auto', 'auto', 'int32' ... and 1 more}
SelectedVariableNames: {'Var1', 'Var2', 'Var3' ... and 1 more}
VariableOptions: Show all 4 VariableOptions
Access VariableOptions sub-properties using setvaropts/getvaropts
VariableNamingRule: 'modify'
Location Properties:
DataLines: [1 Inf]
VariableNamesLine: 0
RowNamesColumn: 0
VariableUnitsLine: 0
VariableDescriptionsLine: 0
To display a preview of the table, use preview
ファイルを読み取り、最初の 3 列を数値としてインポートします。関数 readtable は、1 列目と 2 列目に 16 進数値と 2 進数値が含まれていることを自動的に検出します。インポート オプション オブジェクトは、3 列目にも 16 進数値が含まれることを指定します。
T = readtable('hexAndBinary.txt',opts)T=3×4 table
Var1 Var2 Var3 Var4
_____ ____ _____ ___________
255 255 51193 {'Device1'}
256 4 1471 {'Device2'}
43981 129 61455 {'Device3'}
テキスト データのインポート時のオプションの設定
関数 setvaropts を使用して、テキスト データのインポートを制御するプロパティを更新します。最初に、ファイルのインポート オプション オブジェクトを取得します。次に、テキスト変数のオプションを調べて更新します。最後に、関数 readtable を使用して、変数をインポートします。
patients.xls 内のデータをプレビューします。列 LastName のテキスト データに注目してください。ここでは、最初の 10 行のプレビューのみを示します。
インポート オプション オブジェクトを取得します。
opts = detectImportOptions('patients.xls');変数 LastName の VariableImportOptions を取得して調べます。
getvaropts(opts,'LastName')ans =
TextVariableImportOptions with properties:
Variable Properties:
Name: 'LastName'
Type: 'char'
FillValue: ''
TreatAsMissing: {}
QuoteRule: 'remove'
Prefixes: {}
Suffixes: {}
EmptyFieldRule: 'missing'
String Options:
WhitespaceRule: 'trim'
変数のデータ型を string に設定します。
opts = setvartype(opts,'LastName','string');
変数の FillValue プロパティを設定して、欠損値を 'NoName' で置き換えます。
opts = setvaropts(opts,'LastName','FillValue','NoName');
変数の最初の 10 行を選択して読み取り、プレビューします。
opts.SelectedVariableNames = 'LastName'; T = readtable('patients.xls',opts); T.LastName(1:10)
ans = 10x1 string
"Smith"
"Johnson"
"Williams"
"Jones"
"Brown"
"Davis"
"Miller"
"Wilson"
"Moore"
"Taylor"
論理データのインポート時のオプションの設定
関数 setvaropts を使用して、logical データのインポートを制御するプロパティを更新します。最初に、ファイルのインポート オプション オブジェクトを取得します。次に、論理変数のオプションを調べて更新します。最後に、関数 readtable を使用して、変数をインポートします。
airlinesmall_subset.xlsx 内のデータをプレビューします。列 Cancelled の論理データに注目してください。以下は、行 30 ～ 40 のプレビューのみを示しています。
インポート オプション オブジェクトを取得します。
opts = detectImportOptions('airlinesmall_subset.xlsx');変数 Cancelled の VariableImportOptions を取得して調べます。
getvaropts(opts,'Cancelled')ans =
NumericVariableImportOptions with properties:
Variable Properties:
Name: 'Cancelled'
Type: 'double'
FillValue: NaN
TreatAsMissing: {}
QuoteRule: 'remove'
Prefixes: {}
Suffixes: {}
EmptyFieldRule: 'missing'
Numeric Options:
ExponentCharacter: 'eEdD'
DecimalSeparator: '.'
ThousandsSeparator: ''
TrimNonNumeric: 0
NumberSystem: 'decimal'
変数のデータ型を logical に設定します。
opts = setvartype(opts,'Cancelled','logical');
変数の FillValue プロパティを設定して、欠損値を true で置き換えます。
opts = setvaropts(opts,'Cancelled','FillValue',true);
変数の概要を選択して読み取り、表示します。
opts.SelectedVariableNames = 'Cancelled'; T = readtable('airlinesmall_subset.xlsx',opts); summary(T)
Variables:
Cancelled: 1338x1 logical
Values:
True 29
False 1309
日付と時刻のデータのインポート
DatetimeVariableImportOptions プロパティを使用して、datetime データのインポートを制御します。最初に、ファイルの ImportOptions オブジェクトを取得します。次に、datetime 変数の VariableImportOptions を調べて更新します。最後に、readtable を使用して変数をインポートします。
outages.csv 内のデータをプレビューします。列 OutageTime と列 RestorationTime の日付と時刻のデータに注目してください。以下は、最初の 10 行のみを示しています。
インポート オプション オブジェクトを取得します。
opts = detectImportOptions('outages.csv');datetime 変数の OutageTime および RestorationTime の VariableImportOptions を取得して調べます。
varOpts = getvaropts(opts,{'OutageTime','RestorationTime'})varOpts =
1x2 DatetimeVariableImportOptions array with properties:
Name
Type
FillValue
TreatAsMissing
QuoteRule
Prefixes
Suffixes
EmptyFieldRule
DatetimeFormat
DatetimeLocale
TimeZone
InputFormat
欠損値を現在の日付と時刻で置き換えるように、変数の FillValue プロパティを設定します。
opts = setvaropts(opts,{'OutageTime','RestorationTime'},...
'FillValue','now');2 つの変数を選択して読み取り、プレビューします。RestorationTime の 2 番目の行の欠損値が現在の日付と時刻で埋められている点に注目してください。
opts.SelectedVariableNames = {'OutageTime','RestorationTime'};
T = readtable('outages.csv',opts);
T(1:10,:)ans=10×2 table
OutageTime RestorationTime
________________ ________________
2002-02-01 12:18 2002-02-07 16:50
2003-01-23 00:49 2022-08-12 20:14
2003-02-07 21:15 2003-02-17 08:14
2004-04-06 05:44 2004-04-06 06:10
2002-03-16 06:18 2002-03-18 23:23
2003-06-18 02:49 2003-06-18 10:54
2004-06-20 14:39 2004-06-20 19:16
2002-06-06 19:28 2002-06-07 00:51
2003-07-16 16:23 2003-07-17 01:12
2004-09-27 11:09 2004-09-27 16:37
カテゴリカル データのインポート時のオプションの設定
関数 setvaropts を使用して、categorical データのインポートを制御するプロパティを更新します。最初に、ファイルのインポート オプション オブジェクトを取得します。次に、categorical 変数のオプションを調べて更新します。最後に、関数 readtable を使用して、変数をインポートします。
outages.csv 内のデータをプレビューします。列 Region と列 Cause 内のカテゴリカル データに注目してください。この表は最初の 10 行のみを示しています。
インポート オプション オブジェクトを取得します。
opts = detectImportOptions('outages.csv');変数 Region と Cause のオプションを取得して調べます。
getvaropts(opts,{'Region','Cause'})ans =
1x2 TextVariableImportOptions array with properties:
Name
Type
FillValue
TreatAsMissing
QuoteRule
Prefixes
Suffixes
EmptyFieldRule
WhitespaceRule
変数のデータ型を categorical に設定します。
opts = setvartype(opts,{'Region','Cause'},'categorical');変数の FillValue プロパティを設定して、欠損値をカテゴリ名 'Miscellaneous' で置き換えます。TreatAsMissing プロパティを 'unknown' に設定します。
opts = setvaropts(opts,{'Region','Cause'},...
'FillValue','Miscellaneous',...
'TreatAsMissing','unknown');2 つの変数の概要を選択して読み取り、表示します。
opts.SelectedVariableNames = {'Region','Cause'};
T = readtable('outages.csv',opts);
summary(T)Variables:
Region: 1468x1 categorical
Values:
MidWest 142
NorthEast 557
SouthEast 389
SouthWest 26
West 354
Cause: 1468x1 categorical
Values:
Miscellaneous 24
attack 294
earthquake 2
energy emergency 188
equipment fault 156
fire 25
severe storm 338
thunder storm 201
wind 95
winter storm 145
変数からの接頭辞文字または接尾辞文字の削除
不要な接頭辞文字または接尾辞文字をもつ変数を含む表形式データをインポートします。最初に、インポート オプション オブジェクトを作成し、データをプレビューします。次に、対象の変数を選択し、その変数の型およびプロパティを設定して、不要な文字を削除します。最終的に、対象のデータをインポートします。
ファイルのインポート オプションを作成し、テーブルをプレビューします。
filename = 'pref_suff_trim.csv';
opts = detectImportOptions(filename);
preview(filename,opts)Warning: Column headers from the file were modified to make them valid MATLAB identifiers before creating variable names for the table. The original column headers are saved in the VariableDescriptions property. Set 'VariableNamingRule' to 'preserve' to use the original column headers as table variable names.
ans=8×5 table
Time DayOfWeek Power Total_Fees Temperature
_________________________ _________________ ______________ ___________ _____________
{'Timestamp:1/1/06 0:00'} {'& Sun %20'} {'54.5448 MW'} {'$1.23' } {'-7.2222 C'}
{'Timestamp:1/2/06 1:00'} {'& Thu %20'} {'.3898 MW' } {'$300.00'} {'-7.3056 C'}
{'Timestamp:1/3/06 2:00'} {'& Sun %20'} {'51.6344 MW'} {'£2.50' } {'-7.8528 C'}
{'Timestamp:1/4/06 3:00'} {'& Sun %20'} {'51.5597 MW'} {'$0.00' } {'-8.1778 C'}
{'Timestamp:1/5/06 4:00'} {'& Wed %20'} {'51.7148 MW'} {'¥4.00' } {'-8.9343 C'}
{'Timestamp:1/6/06 5:00'} {'& Sun %20'} {'52.6898 MW'} {'$0.00' } {'-8.7556 C'}
{'Timestamp:1/7/06 6:00'} {'& Mon %20'} {'55.341 MW' } {'$50.70' } {'-8.0417 C'}
{'Timestamp:1/8/06 7:00'} {'& Sat %20'} {'57.9512 MW'} {'$0.00' } {'-8.2028 C'}
対象の変数を選択し、その型を指定し、それらの変数のインポート オプションの値を調べます。
opts.SelectedVariableNames = {'Time','Total_Fees','Temperature'};
opts = setvartype(opts,'Time','datetime');
opts = setvaropts(opts,'Time','InputFormat','MM/dd/uu HH:mm'); % Specify datetime format
opts = setvartype(opts,{'Total_Fees','Temperature'},'double');
getvaropts(opts,{'Time','Total_Fees','Temperature'})ans =
1×3 VariableImportOptions array with properties:
Variable Options:
(1) | (2) | (3)
Name: 'Time' | 'Total_Fees' | 'Temperature'
Type: 'datetime' | 'double' | 'double'
FillValue: NaT | NaN | NaN
TreatAsMissing: {} | {} | {}
EmptyFieldRule: 'missing' | 'missing' | 'missing'
QuoteRule: 'remove' | 'remove' | 'remove'
Prefixes: {} | {} | {}
Suffixes: {} | {} | {}
To access sub-properties of each variable, use getvaropts
変数のインポート オプション Prefixes、Suffixes、および TrimNonNumeric プロパティを設定して、変数 Time から 'Timestamp:' を削除し、変数 Temperature から接尾辞 'C' を削除し、変数 Total_Fees からすべての非数値文字を削除します。新しいインポート オプションでテーブルをプレビューします。
opts = setvaropts(opts,'Time','Prefixes','Timestamp:'); opts = setvaropts(opts,'Temperature','Suffixes','C'); opts = setvaropts(opts,'Total_Fees','TrimNonNumeric',true); preview(filename,opts)
ans=8×3 table
Time Total_Fees Temperature
______________ __________ ___________
01/01/06 00:00 1.23 -7.2222
01/02/06 01:00 300 -7.3056
01/03/06 02:00 2.5 -7.8528
01/04/06 03:00 0 -8.1778
01/05/06 04:00 4 -8.9343
01/06/06 05:00 0 -8.7556
01/07/06 06:00 50.7 -8.0417
01/08/06 07:00 0 -8.2028
readtable を使用してデータをインポートします。
T = readtable(filename,opts);
空のフィールドのインポートの管理
空のフィールドを含むファイルのインポート オプション オブジェクトを作成します。EmptyFieldRule パラメーターを使用して、データ内にある空のフィールドのインポートを管理します。最初に、データをプレビューし、特定の変数に対して EmptyFieldRule パラメーターを設定します。最後に、すべての変数に対して EmptyFieldRule を設定し、データをインポートします。
空のフィールドを含むファイルのインポート オプション オブジェクトを作成します。関数 preview を使用して、table の最初の 8 行を取得します。EmptyFieldRule の既定値は 'missing' です。そのため、インポート関数は空のフィールドを欠損として扱い、それらをその変数の FillValue 値に置き換えます。3 番目の VariableOptions を使用して、データをプレビューします。ここで、関数 preview は 3 番目の変数の空のフィールドを NaN としてインポートします。
filename = 'DataWithEmptyFields.csv'; opts = detectImportOptions(filename); opts.VariableOptions(3) % Display the Variable Options for the 3rd Variable
ans =
NumericVariableImportOptions with properties:
Variable Properties:
Name: 'Double'
Type: 'double'
FillValue: NaN
TreatAsMissing: {}
QuoteRule: 'remove'
Prefixes: {}
Suffixes: {}
EmptyFieldRule: 'missing'
Numeric Options:
ExponentCharacter: 'eEdD'
DecimalSeparator: '.'
ThousandsSeparator: ''
TrimNonNumeric: 0
NumberSystem: 'decimal'
preview(filename,opts)
ans=8×7 table
Text Categorical Double Datetime Logical Duration String
__________ ___________ ______ __________ __________ ________ __________
{'abc' } {'a' } 1 01/14/0018 {'TRUE' } 00:00:01 {'abc' }
{0x0 char} {'b' } 2 01/21/0018 {'FALSE' } 09:00:01 {'def' }
{'ghi' } {0x0 char} 3 01/31/0018 {'TRUE' } 02:00:01 {'ghi' }
{'jkl' } {'a' } NaN 02/23/2018 {'FALSE' } 03:00:01 {'jkl' }
{'mno' } {'a' } 4 NaT {'FALSE' } 04:00:01 {'mno' }
{'pqr' } {'b' } 5 01/23/0018 {0x0 char} 05:00:01 {'pqr' }
{'stu' } {'b' } 5 03/23/0018 {'FALSE' } NaN {'stu' }
{0x0 char} {'a' } 6 03/24/2018 {'TRUE' } 07:00:01 {0x0 char}
table の 2 番目の変数の EmptyFieldRule を設定します。最初に、変数を選択し、EmptyFieldRule を 'auto' に設定します。ここで、関数 readtable は変数 categorical の空のフィールドを <undefined> としてインポートします。
opts.SelectedVariableNames = 'Categorical'; opts = setvartype(opts,'Categorical','categorical'); opts = setvaropts(opts,'Categorical','EmptyFieldRule','auto'); T = readtable(filename,opts)
T=10×1 table
Categorical
___________
a
b
<undefined>
a
a
b
b
a
a
<undefined>
次に、table 内にあるすべての変数に対し、EmptyFieldRule パラメーターを設定します。最初に、変数のデータ型を適切に更新します。この例では、5 番目と 7 番目の変数のデータ型をそれぞれ logical と string に設定します。次に、すべての変数について、EmptyFieldRule を 'auto' に設定します。インポート関数は、変数のデータ型に基づいて空のフィールドをインポートします。ここで、関数 readtable は logical 変数の空のフィールドを 0 としてインポートし、categorical 変数の空のフィールドを <undefined> としてインポートします。
VariableNames = opts.VariableNames; opts.SelectedVariableNames = VariableNames; % select all variables opts = setvartype(opts,{'Logical','String'},{'logical','string'}); opts = setvaropts(opts,VariableNames,'EmptyFieldRule','auto'); T = readtable(filename,opts)
T=10×7 table
Text Categorical Double Datetime Logical Duration String
__________ ___________ ______ __________ _______ ________ _________
{'abc' } a 1 01/14/0018 true 00:00:01 "abc"
{0x0 char} b 2 01/21/0018 false 09:00:01 "def"
{'ghi' } <undefined> 3 01/31/0018 true 02:00:01 "ghi"
{'jkl' } a NaN 02/23/2018 false 03:00:01 "jkl"
{'mno' } a 4 NaT false 04:00:01 "mno"
{'pqr' } b 5 01/23/0018 false 05:00:01 "pqr"
{'stu' } b 5 03/23/0018 false NaN "stu"
{0x0 char} a 6 03/24/2018 true 07:00:01 ""
{0x0 char} a 7 03/25/2018 true 08:00:01 <missing>
{'xyz' } <undefined> NaN NaT true 06:00:01 "xyz"
EmptyFieldRule パラメーターは、'missing' と 'auto' の他に 'error' に設定することもできます。'error' に設定した場合、関数 readtable は ImportErrorRule パラメーターで指定された手順に従って空のフィールドをインポートします。
入力引数
バージョン履歴
R2016b で導入
You can also select a web site from the following list:
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)