最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。
setvaropts
変数のインポート オプションの設定
構文
opts = setvaropts(opts,Name,Value)opts = setvaropts(opts,selection,Name,Value)説明
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
テキスト データのインポート時のオプションの設定
関数 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 array
"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
変数のデータ型を 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:
DatetimeFormat
DatetimeLocale
InputFormat
Type
FillValue
TimeZone
Name
QuoteRule
TreatAsMissing
Prefixes
Suffixes
EmptyFieldRule
欠損値を現在の日付と時刻で置き換えるように、変数の 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
____________________ ____________________
01-Feb-2002 12:18:00 07-Feb-2002 16:50:00
23-Jan-2003 00:49:00 02-Aug-2018 18:21:47
07-Feb-2003 21:15:00 17-Feb-2003 08:14:00
06-Apr-2004 05:44:00 06-Apr-2004 06:10:00
16-Mar-2002 06:18:00 18-Mar-2002 23:23:00
18-Jun-2003 02:49:00 18-Jun-2003 10:54:00
20-Jun-2004 14:39:00 20-Jun-2004 19:16:00
06-Jun-2002 19:28:00 07-Jun-2002 00:51:00
16-Jul-2003 16:23:00 17-Jul-2003 01:12:00
27-Sep-2004 11:09:00 27-Sep-2004 16:37:00
カテゴリカル データのインポート時のオプションの設定
関数 setvaropts を使用して、categorical データのインポートを制御するプロパティを更新します。最初に、ファイルのインポート オプション オブジェクトを取得します。次に、カテゴリカル変数のオプションを調べて更新します。最後に、関数 readtable を使用して、変数をインポートします。
outages.csv 内のデータをプレビューします。列 Region と列 Cause 内のカテゴリカル データに注目してください。この表は最初の 10 行のみを示しています。
インポート オプション オブジェクトを取得します。
opts = detectImportOptions('outages.csv');変数 Region と Cause のオプションを取得して調べます。
getvaropts(opts,{'Region','Cause'})ans =
1x2 TextVariableImportOptions array with properties:
WhitespaceRule
Type
FillValue
Name
QuoteRule
TreatAsMissing
Prefixes
Suffixes
EmptyFieldRule
変数のデータ型を 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)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 =
1x3 VariableImportOptions array with properties:
Variable Options:
(1) | (2) | (3)
Name: 'Time' | 'Total_Fees' | 'Temperature'
Type: 'datetime' | 'double' | 'double'
FillValue: [NaT] | [NaN] | [NaN]
TreatAsMissing: {} | {} | {}
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
preview(filename,opts)
ans=8×7 table
Text Categorical Double Datetime Logical Duration String
_____ ___________ ______ ____________________ _______ ________ ______
'abc' 'a' 1 14-Jan-0018 00:00:00 'TRUE' 00:00:01 'abc'
'' 'b' 2 21-Jan-0018 00:00:00 'FALSE' 09:00:01 'def'
'ghi' '' 3 31-Jan-0018 00:00:00 'TRUE' 02:00:01 'ghi'
'jkl' 'a' NaN 23-Feb-2018 00:00:00 'FALSE' 03:00:01 'jkl'
'mno' 'a' 4 NaT 'FALSE' 04:00:01 'mno'
'pqr' 'b' 5 23-Jan-0018 00:00:00 '' 05:00:01 'pqr'
'stu' 'b' 5 23-Mar-0018 00:00:00 'FALSE' NaN 'stu'
'' 'a' 6 24-Mar-2018 00:00:00 'TRUE' 07:00:01 ''
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=11×1 table
Categorical
___________
a
b
<undefined>
a
a
b
b
a
a
<undefined>
<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=11×7 table
Text Categorical Double Datetime Logical Duration String
_____ ___________ ______ ____________________ _______ ________ _________
'abc' a 1 14-Jan-0018 00:00:00 true 00:00:01 "abc"
'' b 2 21-Jan-0018 00:00:00 false 09:00:01 "def"
'ghi' <undefined> 3 31-Jan-0018 00:00:00 true 02:00:01 "ghi"
'jkl' a NaN 23-Feb-2018 00:00:00 false 03:00:01 "jkl"
'mno' a 4 NaT false 04:00:01 "mno"
'pqr' b 5 23-Jan-0018 00:00:00 false 05:00:01 "pqr"
'stu' b 5 23-Mar-0018 00:00:00 false NaN "stu"
'' a 6 24-Mar-2018 00:00:00 true 07:00:01 ""
'' a 7 25-Mar-2018 00:00:00 true 08:00:01 ""
'xyz' <undefined> NaN NaT true 06:00:01 "xyz"
'' <undefined> NaN NaT false NaN <missing>
EmptyFieldRule パラメーターは、'missing' と 'auto' の他に 'error' に設定することもできます。'error' に設定した場合、関数 readtable は ImportErrorRule パラメーターで指定された手順に従って空のフィールドをインポートします。
入力引数
R2016b で導入
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: .
Select web siteYou 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)
