dataset
(非推奨) 統計データの配列
dataset
データ型は推奨されません。異種混合データを処理するには、代わりに MATLAB® table
データ型を使用します。詳細は、MATLAB table
ドキュメンテーションを参照してください。
説明
データセット配列は、変数名や観測名などを含む異種混合データやメタデータを集めて 1 つのコンテナー変数にまとめるときに使用します。データセット配列は、一般にテキスト ファイルやスプレッドシートに列として格納される列方向データや表形式データの格納に適しており、型、サイズ、単位などが異なる変数を扱うことができます。
データセット配列には、数値、logical、文字、string、categorical、cell などのさまざまな種類の変数を含めることができます。ただし、データセット配列のクラスは、含んでいる変数のクラスとは異なります。たとえば、double 配列の変数のみを含むデータセット配列でも、それ自体を double 配列であるかのように処理することはできません。ただし、ドット添字を使うと、データセット配列内の変数をワークスペース変数のように処理できます。
データセット配列の添字表現には、通常の数値配列の場合と同様に、かっこを使用できますが、数値型と論理型のインデックスに加えて変数名と観測名もインデックスとして使用できます。
作成
構文
説明
は、ワークスペース変数入力方法 A
= dataset(varspec
,Name=Value
)varspec
と 1 つ以上の名前と値の引数を使用してデータセット配列 A
を作成します。
は、A
= dataset(File=filename
,Name=Value
)filename
で指定されたテキスト ファイル内の列方向データからデータセット配列 A
を作成します。A
内の変数のデータ型は、ファイルの対応する列にあるデータが列見出し以外はすべて数値である場合、double
になります。それ以外の場合、A
内の変数は文字ベクトルの cell 配列になります。dataset
は、空のフィールドを NaN
(数値変数の場合) または空の文字ベクトル (文字値変数の場合) に変換します。dataset
は、ファイル内の意味のない空白を無視します。ファイルとワークスペース変数の両方を入力として指定することはできません。
は、A
= dataset(XLSFile=filename
,Name=Value
)Name=Value
で指定された Excel® スプレッドシート内の列方向データからデータセット配列 A
を作成します。A
内の変数のデータ型は、スプレッドシートの対応する列にあるデータが列見出し以外はすべて数値である場合、double
になります。それ以外の場合、A
内の変数は文字ベクトルの cell 配列になります。
は、SAS® XPORT 形式ファイルからデータセット配列を作成します。XPORT 形式ファイルからの変数名は維持されます。XPORT 形式ファイル内の数値データ型は維持されますが、その他のデータ型はすべて文字ベクトルの cell 配列に変換されます。XPORT 形式では、28 個の欠損データ型が許容されます。A
= dataset(XPTFile=filename
,Name=Value
)dataset
では、これらはファイル内で大文字、'.'
、または '_'
で表されます。dataset
は、A
内のすべての欠損データを NaN
値に変換します。
入力引数
プロパティ
オブジェクト関数
cat | (非推奨) データセット配列の連結 |
cellstr | (非推奨) データセット配列から文字ベクトルの cell 配列を作成 |
dataset2cell | (非推奨) データセット配列の cell 配列への変換 |
dataset2struct | (非推奨) データセット配列の構造体への変換 |
disp | (非推奨) データセット配列の表示 |
double | (非推奨) データセット変数を double 配列に変換 |
end | (非推奨) データセット配列のインデックス式における最後のインデックス |
export | (非推奨) データセット配列のファイルへの書き込み |
get | (非推奨) データセット配列プロパティにアクセス |
horzcat | (非推奨) データセット配列の水平連結 |
intersect | (非推奨) データセット配列の観測の共通集合 |
isempty | (非推奨) 空のデータセット配列の場合 true |
ismember | (非推奨) 集合内のメンバーであるデータセット配列要素 |
ismissing | (非推奨) 欠損値のあるデータセット配列要素の検出 |
join | (非推奨) データ セット配列の観測値のマージ |
length | (非推奨) データセット配列の長さ |
ndims | (非推奨) データセット配列の次元数 |
numel | (非推奨) データセット配列の要素数 |
replaceWithMissing | (非推奨) データセット配列への欠損データのインジケーターの挿入 |
replacedata | (非推奨) データセット変数の置き換え |
set | (非推奨) データ セット配列のプロパティの設定と表示 |
setdiff | (非推奨) データセット配列の観測の差集合 |
setxor | (非推奨) データセット配列の観測の排他的論理和集合 |
single | (非推奨) データセット変数を single 配列に変換 |
size | (非推奨) データセット配列のサイズ |
sortrows | (非推奨) データセット配列の行の並べ替え |
stack | (非推奨) 複数変数のデータ セット配列を単一変数に連結 |
subsasgn | (非推奨) データセット配列への添字付き代入 |
subsref | (非推奨) データセット配列の添字付き参照 |
summary | (非推奨) データセット配列のまとめの表示 |
union | (非推奨) データセット配列の観測の和集合 |
unique | (非推奨) データセット配列の一意の観測値 |
unstack | (非推奨) 単一変数からデータ セット配列を取り出して複数変数に入れる |
vertcat | (非推奨) データセット配列の垂直連結 |
例
ヒント
数値配列、cell 配列、構造体配列、または table をデータセット配列に変換するには、それぞれ次の関数も使用できます。
データセット配列には、組み込み型や配列オブジェクトを変数として含めることができます。配列オブジェクトは以下のそれぞれを実装していなければなりません。
MATLAB 標準の小かっこのインデックス。形式は
var(i,...)
で、i
は変数の行に対応する数値または logical ベクトルです。引数
dim
をもつsize
メソッドvertcat
メソッド
バージョン履歴
R2006b で導入
参考
cell2dataset
| mat2dataset
| struct2dataset
| tdfread
| textscan
| xlsread