readtimetable
ファイルからの timetable の作成
説明
TT = readtimetable(filename)
readtimetable は、ファイル拡張子からファイル形式を判定します。
区切りテキスト ファイルの場合、
.txt、.datまたは.csvスプレッドシート ファイルの場合、
.xls、.xlsb、.xlsm、.xlsx、.xltm,.xltxまたは.ods拡張マークアップ言語 (XML) の場合、
.xml圧縮ファイルおよびアーカイブ ファイルの場合、
.zip、.gz、または.tar
テキスト ファイルおよびスプレッドシート ファイルの場合、readtimetable は、ファイルの列ごとに 1 つの変数を TT に作成し、ファイルの最初の行から変数名を読み取ります。XML ファイルの場合、readtimetable は、timetable 変数として検出された要素ノードまたは属性ノードごとに 1 つの変数を T に作成します。変数の名前は要素および属性の名前に対応します。
readtimetable は、表形式データの型が datetime または duration の最初の列を timetable の行時間に設定します。残りの列は timetable の変数になります。
TT = readtimetable(___,Name,Value)
データ特有のインポート オプションを設定するには、opts オブジェクトを使用するか、名前と値のペアを指定できます。opts に加えて名前と値のペアを指定する場合、readtimetable がサポートするのは次の名前と値のペアのみです。
テキストおよびスプレッドシートのパラメーター —
ReadVariableNames、RowTimes、SampleRate、TimeStep、StartTimeテキストのみのパラメーター —
DateLocale、Encodingスプレッドシートのみのパラメーター —
Sheet、UseExcel
例
コンマ区切りのテキスト ファイルからテーブルを作成します。
TT = readtimetable('outages.csv');テーブルの概要を表示します。timetable の作成時に行時間のパラメーターを設定しない場合、関数 readtimetable はデータ OutageTime 内の最初の datetime 変数または duration 変数を検出し、行時間の変数として指定します。残りの変数は timetable の変数になります。
summary(TT)
TT: 1468×5 timetable
Row Times:
OutageTime: datetime
Variables:
Region: cell array of character vectors
Loss: double
Customers: double
RestorationTime: datetime
Cause: cell array of character vectors
Statistics for applicable variables and row times:
NumMissing Min Median Max Mean Std
OutageTime 0 2002-02-01 12:18 2010-03-18 21:05 2014-01-15 02:41 2009-07-03 12:49 27450:31:25
Region 0
Loss 604 0 180.2583 2.3418e+04 563.8885 1.8793e+03
Customers 328 0 7.5765e+04 5.9689e+06 1.6693e+05 3.6873e+05
RestorationTime 29 2002-02-07 16:50 2010-03-31 10:54 2042-09-18 23:31 2009-07-27 15:47 28592:30:37
Cause 0
テキスト ファイルのインポート オプションを検出し、変数の型を指定して、データから timetable を作成します。
ファイルからインポート オプション オブジェクトを作成し、変数オプションを調べます。
opts = detectImportOptions('outages.csv');
opts.VariableOptionsans =
1×6 heterogeneous VariableImportOptions (TextVariableImportOptions, DatetimeVariableImportOptions, NumericVariableImportOptions) array with properties:
Name
Type
FillValue
TreatAsMissing
QuoteRule
Prefixes
Suffixes
EmptyFieldRule
オプション オブジェクトを変更してデータ内の変数の目的のデータ型を指定します。変数 Region および Cause のデータ型を categorical に変更します。
opts = setvartype(opts,{'Region','Cause'},{'categorical','categorical'});readtimetable をオプション オブジェクトと共に使用して、timetable をインポートします。次に、timetable の概要を表示します。
TT = readtimetable('outages.csv',opts);
summary(TT)TT: 1468×5 timetable
Row Times:
OutageTime: datetime
Variables:
Region: categorical (5 categories)
Loss: double
Customers: double
RestorationTime: datetime
Cause: categorical (10 categories)
Statistics for applicable variables and row times:
NumMissing Min Median Max Mean Std
OutageTime 0 2002-02-01 12:18 2010-03-18 21:05 2014-01-15 02:41 2009-07-03 12:49 27450:31:25
Region 0
Loss 604 0 180.2583 2.3418e+04 563.8885 1.8793e+03
Customers 328 0 7.5765e+04 5.9689e+06 1.6693e+05 3.6873e+05
RestorationTime 29 2002-02-07 16:50 2010-03-31 10:54 2042-09-18 23:31 2009-07-27 15:47 28592:30:37
Cause 0
コンマ区切りのテキスト ファイルから table を読み取り、任意の行時間変数である timetable を作成します。
インポート オプション オブジェクトを作成し、表形式データをプレビューします。
opts = detectImportOptions('outages.csv'); preview('outages.csv',opts)
ans=8×6 table
Region OutageTime Loss Customers RestorationTime Cause
_____________ ________________ ______ __________ ________________ ___________________
{'SouthWest'} 2002-02-01 12:18 458.98 1.8202e+06 2002-02-07 16:50 {'winter storm' }
{'SouthEast'} 2003-01-23 00:49 530.14 2.1204e+05 NaT {'winter storm' }
{'SouthEast'} 2003-02-07 21:15 289.4 1.4294e+05 2003-02-17 08:14 {'winter storm' }
{'West' } 2004-04-06 05:44 434.81 3.4037e+05 2004-04-06 06:10 {'equipment fault'}
{'MidWest' } 2002-03-16 06:18 186.44 2.1275e+05 2002-03-18 23:23 {'severe storm' }
{'West' } 2003-06-18 02:49 0 0 2003-06-18 10:54 {'attack' }
{'West' } 2004-06-20 14:39 231.29 NaN 2004-06-20 19:16 {'equipment fault'}
{'West' } 2002-06-06 19:28 311.86 NaN 2002-06-07 00:51 {'equipment fault'}
変数 RestorationTime を timetable の行時間変数に指定して、timetable を作成します。次に、timetable の概要を表示します。
TT = readtimetable('outages.csv','RowTimes','RestorationTime'); summary(TT)
TT: 1468×5 timetable
Row Times:
RestorationTime: datetime
Variables:
Region: cell array of character vectors
OutageTime: datetime
Loss: double
Customers: double
Cause: cell array of character vectors
Statistics for applicable variables and row times:
NumMissing Min Median Max Mean Std
RestorationTime 29 2002-02-07 16:50 2010-03-31 10:54 2042-09-18 23:31 2009-07-27 15:47 28592:30:37
Region 0
OutageTime 0 2002-02-01 12:18 2010-03-18 21:05 2014-01-15 02:41 2009-07-03 12:49 27450:31:25
Loss 604 0 180.2583 2.3418e+04 563.8885 1.8793e+03
Customers 328 0 7.5765e+04 5.9689e+06 1.6693e+05 3.6873e+05
Cause 0
スプレッドシート ファイルから timetable を作成し、入力データを書式設定します。たとえば、ファイル quarterlyFinances1999To2019.csv から timetable を作成し、タイム スタンプの開始日と、各タイム スタンプ間の時間を指定し、データから "$" 記号を削除します。
ファイル quarterlyFinances1999To2019.csv のデータを timetable として読み取ります。連続する行時間の間の時間の長さを、1999 年 1 月 1 日から始まる 1 カレンダー四半期として指定します。'VariableNamingRule' を preserve に設定し、変数名に含まれる空白をそのまま残します。'TrimNonNumeric' を true に設定し、データの数値の前にある "$" 記号を削除します。
TT = readtimetable("quarterlyFinances1999To2019.csv","TimeStep", calquarters(1),"StartTime", datetime(1999, 1, 1),... "VariableNamingRule", "preserve", "TrimNonNumeric", true);
データの概要を表示します。
summary(TT)
TT: 80×9 timetable
Row Times:
Time: datetime
Variables:
Net Sales: double
Cost of Sales: double
Gross Margin: double
Research and Development Expenses: double
Administrative Expenses: double
Total Operating Expenses: double
Net Income: double
Total Shares: double
Earnings per Share: double
Statistics for applicable variables and row times:
NumMissing Min Median Max Mean Std
Time 0 01-Jan-1999 16-Nov-2008 01-Oct-2018 15-Nov-2008 04:30:00 50925:56:30
NetSales 0 3.5066e+04 1.0407e+05 1.7684e+05 1.0377e+05 3.8034e+04
CostOfSales 0 1.8106e+04 4.8624e+04 7.7742e+04 4.8410e+04 1.7219e+04
GrossMargin 0 1.4563e+04 5.6719e+04 9.9097e+04 5.5361e+04 2.1060e+04
ResearchAndDevelopmentExpenses 0 4.9049e+03 2.4637e+04 4.5234e+04 2.4761e+04 1.1524e+04
AdministrativeExpenses 0 1.0474e+03 2.0153e+03 2.8115e+03 1.9745e+03 497.5852
TotalOperatingExpenses 0 5.9925e+03 2.6518e+04 4.8045e+04 2.6736e+04 1.1987e+04
NetIncome 0 7.6343e+03 2.8586e+04 5.1051e+04 2.8625e+04 9.8181e+03
TotalShares 0 822 1.8205e+03 2710 1.8013e+03 496.7446
EarningsPerShare 0 6.5200 15.5150 24.6200 15.7921 3.2653
入力引数
名前と値の引数
出力引数
ヒント
インポートする XML 入力文書の要素を指定するには、XPath セレクターを使用します。たとえば、次の構造の XML ファイル
myFile.xmlをインポートするとします。次の表に、<data> <table category="ones"> <var>1</var> <var>2</var> </table> <table category="tens"> <var>10</var> <var>20</var> </table> </data>VariableSelectorsやTableSelectorなどの XPath セレクターの名前と値の引数でサポートされる XPath 構文を示します。選択操作 構文 例 結果 文書内の場所に関係なく、選択するノードに名前が一致するすべてのノードを選択する。 名前の前にスラッシュを 2 つ ( //) 付ける。data = readtable('myFile.xml', 'VariableSelectors', '//var')
data = 4×1 table var ___ 1 2 10 20要素ノードに属する属性の値を読み取る。 属性の前にアット マーク ( @) を付ける。data = readtable('myFile.xml', 'VariableSelectors', '//table/@category')
data = 2×1 table categoryAttribute _________________ "ones" "tens"一連のノードから特定のノードを選択する。 選択するノードのインデックスを大かっこ ( []) で囲んで指定する。data = readtable('myFile.xml', 'TableSelector', '//table[1]')
data = 2×1 table var ___ 1 2演算の優先順位を指定する。 最初に評価する式を小かっこで囲む。 data = readtable('myFile.xml', 'VariableSelectors', '//table/var[1]')
data = 2×1 table var ___ 1 10data = readtable('myFile.xml', 'VariableSelectors', '(//table/var)[1]')
data = table var ___ 1
