テキスト ファイルのコレクションまたはシーケンスの読み取り

ライブ スクリプトを開く

データが複数のテキスト ファイルに格納されている場合は、tabularTextDatastore を使用してデータの管理とインポートを行うことができます。この例では、tabularTextDatastore を使用してテキスト ファイルのコレクションからデータをまとめてすべて読み取るか、またはファイルを 1 つずつ読み取る方法を説明します。

データ

この例では、フォルダー C:\DataTxt にテキスト ファイルのコレクションが含まれています。この位置を変数 location に取得します。データには 10 個のテキスト ファイルが含まれ、各ファイルには 10 行のデータが含まれています。結果は、ファイルとデータによって異なります。

location = 'C:\DataTxt';
dir(location)
.           File01.csv  File03.csv  File05.csv  File07.csv  File09.csv  
..          File02.csv  File04.csv  File06.csv  File08.csv  File10.csv

データストアの作成

ファイルの場所を使用してデータストアを作成します。

ds = tabularTextDatastore(location)
ds = 
  TabularTextDatastore with properties:

                      Files: {
                             'C:\DataTxt\File01.csv';
                             'C:\DataTxt\File02.csv';
                             'C:\DataTxt\File03.csv'
                              ... and 7 more
                             }
               FileEncoding: 'UTF-8'
   AlternateFileSystemRoots: {}
          ReadVariableNames: true
              VariableNames: {'LastName', 'Gender', 'Age' ... and 7 more}
             DatetimeLocale: en_US

  Text Format Properties:
             NumHeaderLines: 0
                  Delimiter: ','
               RowDelimiter: '\r\n'
             TreatAsMissing: ''
               MissingValue: NaN

  Advanced Text Format Properties:
            TextscanFormats: {'%q', '%q', '%f' ... and 7 more}
                   TextType: 'char'
         ExponentCharacters: 'eEdD'
               CommentStyle: ''
                 Whitespace: ' \b\t'
    MultipleDelimitersAsOne: false

  Properties that control the table returned by preview, read, readall:
      SelectedVariableNames: {'LastName', 'Gender', 'Age' ... and 7 more}
            SelectedFormats: {'%q', '%q', '%f' ... and 7 more}
                   ReadSize: 20000 rows

データストアからのデータの読み取り

関数 read または readall を使用して、データストアからデータをインポートします。コレクションのデータがメモリに収まる場合は、関数 readall を使用してすべて一度にインポートできます。

allData = readall(ds);
size(allData)

あるいは、関数 read を使用してファイルごとにデータをインポートします。インポートするデータ量を制御するには、read を呼び出す前にデータストアの ReadSize プロパティを調整します。ReadSize を 'file' または正の整数に設定します。

  • ReadSize が 'file' の場合、read の各呼び出しで一度に 1 ファイルのすべてのデータを読み取ります。

  • ReadSize が正の整数の場合は、read の各呼び出しで、ReadSize で指定される行数 (あるいは、データの最後に到達する場合はそれ未満) を読み取ります。

ds.ReadSize = 'file';
firstFile = read(ds) % reads first file
firstFile=10×10 table
       'Smith'      'Male'    38      'County General Hospital'    71    176     'TRUE'    124    93    'Excellent'
     'Johnson'      'Male'    43                  'VA Hospital'    69    163    'FALSE'    109    77         'Fair'
    'Williams'    'Female'    38    'St. Mary's Medical Center'    64    131    'FALSE'    125    83         'Good'
       'Jones'    'Female'    40                  'VA Hospital'    67    133    'FALSE'    117    75         'Fair'
       'Brown'    'Female'    49      'County General Hospital'    64    119    'FALSE'    122    80         'Good'
       'Davis'    'Female'    46    'St. Mary's Medical Center'    68    142    'FALSE'    121    70         'Good'
      'Miller'    'Female'    33                  'VA Hospital'    64    142     'TRUE'    130    88         'Good'
      'Wilson'      'Male'    40                  'VA Hospital'    68    180    'FALSE'    115    82         'Good'
       'Moore'      'Male'    28    'St. Mary's Medical Center'    68    183    'FALSE'    115    78    'Excellent'
      'Taylor'    'Female'    31      'County General Hospital'    66    132    'FALSE'    118    86    'Excellent'


secondFile = read(ds) % reads second file
secondFile=10×10 table
    'Anderson'    'Female'    45      'County General Hospital'    68    128    'FALSE'    114    77    'Excellent'
      'Thomas'    'Female'    42    'St. Mary's Medical Center'    66    137    'FALSE'    115    68         'Poor'
     'Jackson'      'Male'    25                  'VA Hospital'    71    174    'FALSE'    127    74         'Poor'
       'White'      'Male'    39                  'VA Hospital'    72    202     'TRUE'    130    95    'Excellent'
      'Harris'    'Female'    36    'St. Mary's Medical Center'    65    129    'FALSE'    114    79         'Good'
      'Martin'      'Male'    48                  'VA Hospital'    71    181     'TRUE'    130    92         'Good'
    'Thompson'      'Male'    32    'St. Mary's Medical Center'    69    191     'TRUE'    124    95    'Excellent'
      'Garcia'    'Female'    27                  'VA Hospital'    69    131     'TRUE'    123    79         'Fair'
    'Martinez'      'Male'    37      'County General Hospital'    70    179    'FALSE'    119    77         'Good'
    'Robinson'      'Male'    50      'County General Hospital'    68    172    'FALSE'    125    76         'Good'

参考

| | | | |

トピック