head

table、timetable、tall 配列の上部の行を取得

構文

B = head(A)

B = head(A,k)

説明

B = head(A) は table または timetable A の最初の 8 行を返します。

B = head(A,k) は A の最初の k 行を返します。

例

table のプレビュー

100 行と 5 つの変数を含む table を作成します。

load patients
T = table(LastName,Gender,Age,Height,Weight);
size(T)

ans = 1×2

   100     5

最初の 8 行をプレビューします。

T2 = head(T)

T2=8×5 table
      LastName        Gender      Age    Height    Weight
    ____________    __________    ___    ______    ______

    {'Smith'   }    {'Male'  }    38       71       176  
    {'Johnson' }    {'Male'  }    43       69       163  
    {'Williams'}    {'Female'}    38       64       131  
    {'Jones'   }    {'Female'}    40       67       133  
    {'Brown'   }    {'Female'}    49       64       119  
    {'Davis'   }    {'Female'}    46       68       142  
    {'Miller'  }    {'Female'}    33       64       142  
    {'Wilson'  }    {'Male'  }    40       68       180  

tall table の内容のプレビュー

tall table を作成して最初の数行のデータをプレビューします。

airlinesmall.csv データセットの tall table を作成します。使用する変数のサブセットを選択します。head を使用して最初の数行のデータを抽出します。

varnames = {'Year','Month','ArrDelay','DepDelay','UniqueCarrier'};
ds = tabularTextDatastore('airlinesmall.csv','TreatAsMissing','NA',...
    'SelectedVariableNames',varnames);
T = tall(ds)

T =

  Mx5 tall table

    Year    Month    ArrDelay    DepDelay    UniqueCarrier
    ____    _____    ________    ________    _____________

    1987     10          8          12          {'PS'}    
    1987     10          8           1          {'PS'}    
    1987     10         21          20          {'PS'}    
    1987     10         13          12          {'PS'}    
    1987     10          4          -1          {'PS'}    
    1987     10         59          63          {'PS'}    
    1987     10          3          -2          {'PS'}    
    1987     10         11          -1          {'PS'}    
     :        :         :           :              :
     :        :         :           :              :

tt = head(T)

tt =

  8x5 tall table

    Year    Month    ArrDelay    DepDelay    UniqueCarrier
    ____    _____    ________    ________    _____________

    1987     10          8          12          {'PS'}    
    1987     10          8           1          {'PS'}    
    1987     10         21          20          {'PS'}    
    1987     10         13          12          {'PS'}    
    1987     10          4          -1          {'PS'}    
    1987     10         59          63          {'PS'}    
    1987     10          3          -2          {'PS'}    
    1987     10         11          -1          {'PS'}    

結果をメモリに収集してデータを表示します。

t8 = gather(tt)

t8=8×5 table
    Year    Month    ArrDelay    DepDelay    UniqueCarrier
    ____    _____    ________    ________    _____________

    1987     10          8          12          {'PS'}    
    1987     10          8           1          {'PS'}    
    1987     10         21          20          {'PS'}    
    1987     10         13          12          {'PS'}    
    1987     10          4          -1          {'PS'}    
    1987     10         59          63          {'PS'}    
    1987     10          3          -2          {'PS'}    
    1987     10         11          -1          {'PS'}    

tall 配列の指定行数の取得

tall table の最初の 20 行のデータをプレビューします。

airlinesmall.csv データセットの tall table を作成します。使用する変数のサブセットを選択し、'NA' 値を欠損データとして扱って、datastore で NaN 値に置き換えられるようにします。head を使用して最初の 20 行のデータを表示します。

varnames = {'Year','Month','ArrDelay','DepDelay','UniqueCarrier'};
ds = tabularTextDatastore('airlinesmall.csv','TreatAsMissing','NA',...
    'SelectedVariableNames',varnames);
T = tall(ds)

T =

  Mx5 tall table

    Year    Month    ArrDelay    DepDelay    UniqueCarrier
    ____    _____    ________    ________    _____________

    1987     10          8          12          {'PS'}    
    1987     10          8           1          {'PS'}    
    1987     10         21          20          {'PS'}    
    1987     10         13          12          {'PS'}    
    1987     10          4          -1          {'PS'}    
    1987     10         59          63          {'PS'}    
    1987     10          3          -2          {'PS'}    
    1987     10         11          -1          {'PS'}    
     :        :         :           :              :
     :        :         :           :              :

tt = head(T,20)

tt =

  20x5 tall table

    Year    Month    ArrDelay    DepDelay    UniqueCarrier
    ____    _____    ________    ________    _____________

    1987     10          8          12          {'PS'}    
    1987     10          8           1          {'PS'}    
    1987     10         21          20          {'PS'}    
    1987     10         13          12          {'PS'}    
    1987     10          4          -1          {'PS'}    
    1987     10         59          63          {'PS'}    
    1987     10          3          -2          {'PS'}    
    1987     10         11          -1          {'PS'}    
     :        :         :           :              :
     :        :         :           :              :

結果をメモリに収集してデータを表示します。

t20 = gather(tt)

t20=20×5 table
    Year    Month    ArrDelay    DepDelay    UniqueCarrier
    ____    _____    ________    ________    _____________

    1987     10          8          12          {'PS'}    
    1987     10          8           1          {'PS'}    
    1987     10         21          20          {'PS'}    
    1987     10         13          12          {'PS'}    
    1987     10          4          -1          {'PS'}    
    1987     10         59          63          {'PS'}    
    1987     10          3          -2          {'PS'}    
    1987     10         11          -1          {'PS'}    
    1987     10          3           3          {'PS'}    
    1987     10          2           1          {'PS'}    
    1987     10         16          15          {'PS'}    
    1987     10          3           9          {'PS'}    
    1987     10         39          15          {'PS'}    
    1987     10         57          32          {'TW'}    
    1987     10          0          -3          {'TW'}    
    1987     10        -14           0          {'TW'}    
      ⋮

入力引数

A — 入力配列

table | timetable

入力配列。table または timetable として指定します。

データ型: table | timetable

k — 抽出する行数

スカラー

抽出する行数。正のスカラー整数として指定します。A の行数が k より少ない場合、head は A をすべて返します。

出力引数

B — 要求した行

table | timetable

要求した行。table または timetable として返されます。B のデータ型は A と同じです。

拡張機能

tall 配列

メモリの許容量を超えるような多数の行を含む配列を計算します。

この関数は tall 配列を完全にサポートしています。詳細については、tall 配列を参照してください。

head および tail は、任意の有効な基となるデータ型 (single、double、int8、datetime、table など) の tall 配列で使用できます。

gather(A) から返される結果がメモリに収まるかどうか不明な場合は、gather(head(A)) または gather(tail(A)) を使用します。これらのコマンドは tall 配列 A を完全に評価しますが、結果のごく一部のサブセットのみをメモリに返します。

GPU 配列

Parallel Computing Toolbox™ を使用してグラフィックス処理装置 (GPU) 上で実行することにより、コードを高速化します。

この関数は GPU 配列を完全にサポートしています。詳細については、GPU での MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

分散配列

Parallel Computing Toolbox™ を使用して、クラスターの結合メモリ上で大きなアレイを分割します。

この関数は分散配列を完全にサポートしています。詳細については、分散配列を使用した MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

バージョン履歴

R2016b で導入

参考

tall | gather | tail | topkrows | table | timetable | summary

トピック

• tall 配列要素のインデックス付けと表示

×

例を開く

この例の変更されたバージョンがあります。編集された方の例を開きますか?

いいえ、変更されたバージョンを上書きします。 はい