preview

インポートオプションを使用してファイルから 8 行をプレビュー

ページ内をすべて折りたたむ

構文

T = preview(filename,opts)

説明

例

T= preview(filename,opts)はインポートオプションoptsを使用してfilename内のデータのうち、最初の 8 行を含む table を返します。

インポートオプションオブジェクトoptsのSelectedVariableNamesプロパティの値は、tableTに表示される変数を選択します。
関数 preview は、関数readtableがインポートオプションオブジェクトoptsで返すデータのサブセットを返します。
通常、関数previewの出力にはデータの 8 行が含まれています。ただし、一部のインスタンスでは、インポートオプションオブジェクトoptsで定義されたプロパティ値に応じて行数が異なります。詳細については、ヒントを参照してください。

例

すべて折りたたむ

完全な table をインポートする前にデータをプレビュー

ライブスクリプトを開く

最初に、インポートオプションオブジェクトを作成します。次に、インポートオプションを使用して table の最初の 8 行を取得してから、対象とする変数のみが表示されるプレビューを生成します。

ファイルのインポートオプションオブジェクトを作成します。

文件名='outages.csv'; opts = detectImportOptions(filename);

table をプレビューします。

preview(filename,opts)

ans=8×6 table区域R OutageTime损失客户estorationTime Cause ___________ ____________________ ______ __________ ____________________ _________________ 'SouthWest' 01-Feb-2002 12:18:00 458.98 1.8202e+06 07-Feb-2002 16:50:00 'winter storm' 'SouthEast' 23-Jan-2003 00:49:00 530.14 2.1204e+05 NaT 'winter storm' 'SouthEast' 07-Feb-2003 21:15:00 289.4 1.4294e+05 17-Feb-2003 08:14:00 'winter storm' 'West' 06-Apr-2004 05:44:00 434.81 3.4037e+05 06-Apr-2004 06:10:00 'equipment fault' 'MidWest' 16-Mar-2002 06:18:00 186.44 2.1275e+05 18-Mar-2002 23:23:00 'severe storm' 'West' 18-Jun-2003 02:49:00 0 0 18-Jun-2003 10:54:00 'attack' 'West' 20-Jun-2004 14:39:00 231.29 NaN 20-Jun-2004 19:16:00 'equipment fault' 'West' 06-Jun-2002 19:28:00 311.86 NaN 07-Jun-2002 00:51:00 'equipment fault'

プレビューに含める変数と読み取り操作を選択します。

opts.SelectedVariableNames = {'Region','OutageTime'};

最初の 8 行と選択した変数をプレビューします。

preview(filename,opts)

ans=8×2 tableRegion OutageTime ___________ ____________________ 'SouthWest' 01-Feb-2002 12:18:00 'SouthEast' 23-Jan-2003 00:49:00 'SouthEast' 07-Feb-2003 21:15:00 'West' 06-Apr-2004 05:44:00 'MidWest' 16-Mar-2002 06:18:00 'West' 18-Jun-2003 02:49:00 'West' 20-Jun-2004 14:39:00 'West' 06-Jun-2002 19:28:00

入力引数

すべて折りたたむ

`filename`—読み取るファイルの名前
文字ベクトル|string スカラー

読み取るファイルの名前。文字ベクトルまたは string スカラーとして指定します。

例:'myFile.xlsx'

データ型:char|string

`opts`—ファイルインポートオプション
`SpreadsheetImportOptions`|`DelimitedtextImportOptions`|`FixedWidthImportOptions`

ファイルインポートオプション。関数detectImportOptionsによって作成されたSpreadsheetImportOptionsオブジェクト、DelimitedTextImportOptionsオブジェクトまたはFixedWidthImportOptionsオブジェクトとして指定します。optsオブジェクトにはデータインポートのプロセスを制御するプロパティが含まれています。各オブジェクトのプロパティの詳細については、該当するオブジェクトのページを参照してください。

ファイルの種類	出力
スプレッドシートファイル	`SpreadsheetImportOptions`オブジェクト
テキストファイル	`DelimitedTextImportOptions`オブジェクト
固定幅テキストファイル	`FixedWidthImportOptions`オブジェクト

アルゴリズム

関数previewは、次の場合に 8 行未満を返します。
- ファイルに 8 行未満のデータが含まれる場合。
- optsオブジェクトのDataLinesプロパティまたはDataRangeプロパティで 8 行未満を指定した場合。
- optsオブジェクトのプロパティを組み合わせた結果データが 8 行未満になった場合。たとえば、optsオブジェクトのEmptyLineRule、ImportErrorRuleまたはMissingRuleの値によってインポート関数がデータを省略する場合、previewは 8 行未満を返します。