主要内容

このペ,ジの翻訳は最新ではありません。ここをクリックして,英語の最新版を参照してください。

tabularTextDatastore

表形式テキストファ▪▪ルのデ▪▪タストア

説明

列方向のデータや表形式データを含むテキストファイルの大規模な集合(必ずしもメモリに収まるとは限らない)を管理するには,TabularTextDatastoreオブジェクトを使用します。表形式デタとは,各行に同数のエントリをも四角形の表として配置されたデタです。関数tabularTextDatastoreを使用してTabularTextDatastoreオブジェクトを作成し,そのプロパティを指定すると,オブジェクト関数を使用してデータのインポートおよび処理ができます。

作成

説明

运输大亨= tabularTextDatastore (位置は,位置で指定されたデ,タの集合からデ,タストアを作成します。

运输大亨= tabularTextDatastore (位置名称,值は,1以上の名前と値のペアの引数を使用して,运输大亨の追加パラメ,タ,とプロパティを指定します。たとえば,tabularTextDatastore(位置、“FileExtensions”{' . txt ', ' . csv '})は,拡張子が. txt. csvである位置内のファ▪▪ルのみからデ▪▪タストアを作成します。

入力引数

すべて展開する

デタストアに含めるファルまたはフォルダ。パスまたはDsFileSetオブジェクトとして指定します。

  • パス——ローカルやリモートのファイルまたはフォルダーの場所を含む文字ベクトル,文字ベクトルの细胞配列,字符串スカラー,または字符串配列としてパスを指定します。

    • ロカルのファルまたはフォルダ-ファルまたはフォルダのロカルパスとして位置を指定します。ファイルが現在のフォルダーに存在しない場合,ローカルパスは絶対パスまたは相対パスを指定しなければなりません。指定したフォルダのサブフォルダ内にあるファルは,自動ではデタストアに含まれません。ロカルパスを指定するときにワルドカド文字(*)を使用できます。この文字は,一致するフォルダー内にある,すべてのファイルまたは一致するすべてのファイルをデータストアに含めることを指定します。

    • リモトのファルまたはフォルダ-位置hdfs: / / / path_to_fileの形式の统一资源定位符(URL)として,ファイルまたはフォルダーの絶対パスに指定します。詳細にいては,リモ,トデ,タの操作を参照してください。

  • DsFileSetオブジェクト-位置DsFileSetオブジェクトとして指定することもできます。詳細にいては,matlab.io.datastore.DsFileSetを参照してください。

位置がフォルダーを表す場合,データストアにはサポートされているファイル形式のみが含まれ,その他の形式は無視されます。デタストアに含めるファル拡張子のカスタムリストを指定するには,FileExtensionsプロパティを参照してください。

関数tabularTextDatastoreでサポ,トされる拡張子は,. txt. csv.dat.dlm.asc。textまたは拡張子なしです。

例:“file1.csv”

例:“. . / dir /数据/ file1”

例:{“C: \ dir \ data \ file1.csv”,“C: \ dir \ data \ file2.dat”}

例:“C: \ dir \ data \ *。text”

名前と値のペアの引数

オプションの名称,值の引数ペアをコンマ区切りで指定します。的名字は引数名で,价值は対応する値です。的名字は引用符で囲まなければなりません。Name1, Value1,…,的家のように,複数の名前と値のペアの引数を任意の順序で指定できます。

例:ttds = tabularTextDatastore('C:\dir\textdata','FileExtensions',{'.csv','.txt'})

テキストファ@ @ルの拡張子。“FileExtensions”と,文字ベクトル,文字ベクトルの细胞配列,字符串スカラーまたは字符串配列で構成されるコンマ区切りのペアとして指定します。指定する拡張子は,サポ,トされる形式でなくても構いません。サポトされていない拡張子を含める場合は、すべての拡張子を指定してください。空の引用符を使用して,拡張子なしでファ。

例:' FileExtensions ', ' . txt”

例:FileExtensions,{'。text ', ' . csv '}

デ,タ型:字符|细胞|字符串

サブフォルダ,を含めるかどうかのフラグ。“IncludeSubfolders”と,真正的, 0, 1のいずれかで構成されるコンマ区切りのペアとして指定します。各フォルダ内のすべてのファルとサブフォルダを含めるには真正的を指定し,各フォルダ,内のファ,ルのみを含めるにはを指定します。

“IncludeSubfolders”を指定しない場合,既定値はです。

例:“IncludeSubfolders”,真的

デ,タ型:逻辑|

出力のデ,タ型。“OutputType”と次の値のいずれかで構成されるコンマ区切りのペアとして指定します。

  • “汽车”- - - - - -“RowTimes”の名前と値のペアを指定するかどうかに基づいて,データストアからの出力を表または时间表のいずれにすべきかを検出します。出力は,“RowTimes”を指定する場合は时间表,指定しない場合は表格になります。

  • “表”- - - - - -表格を返します。

  • “时间表”- - - - - -时间表を返します。

OutputTypeの値により,関数预览およびreadallで返されるデ,タ型が決まります。このオプションを“RowTimes”の名前と値のペアと組み合わせて使用すると,TabularTextDatastoreから时间表が返されます。

例:“OutputType”、“时间表”

デ,タ型:字符|字符串

代替ファ▪▪ルシステムのル▪▪トパス。“AlternateFileSystemRoots”と字符串ベクトルまたは单元格配列で構成されるコンマ区切りのペアとして指定します。ローカルマシン上にデータストアを作成するが,別のマシン(異なるオペレーティングシステムの可能性がある)上でデータにアクセスして処理する必要がある場合は,“AlternateFileSystemRoots”を使用します。また,并行计算工具箱™とMATLAB®并行服务器™を使用してデータを処理し,そのデータがローカルマシンに保存され,そのデータのコピーが異なるプラットフォームのクラウドやクラスターマシンにある場合,“AlternateFileSystemRoots”を使用してル,トパスを関連付けなければなりません。

  • 相互に対応する1組のル,トパスを関連付けるには,“AlternateFileSystemRoots”を字符串ベクトルとして指定します。以下に例を示します。

    [" Z: \数据集”、“/ mynetwork /数据集”)

  • デ,タストアに対応する複数の組のル,トパスを関連付けるには,複数行を含むcell配列として“AlternateFileSystemRoots”を指定します。各行は対応するル,トパスの組を表します。细胞配列内の各行を string ベクトル、または文字ベクトルの cell 配列のいずれかとして指定します。以下に例を示します。

    • “AlternateFileSystemRoots”を字符串ベクトルの单元格配列として指定します。

      {[Z: \“数据集”、“/ mynetwork /数据集”);…[" Y: \数据集”、“/ mynetwork2 /数据集”、“年代:\数据集”)}

    • あるいは,“AlternateFileSystemRoots”を文字ベクトルのcell配列からなるcell配列として指定します。

      {{“Z: \数据集”、“mynetwork /数据集”},…{“Y: \数据集”,“mynetwork2 /数据集”,年代:\数据集的}}

“AlternateFileSystemRoots”の値は,次の条件を満たさなければなりません。

  • 1 .行以上の行を含み,各行は1 .組の対応するル,トパスを指定する。

  • 各行は複数のル,トパスを指定し,各ル,トパスは2文字以上を含まなければならない。

  • ル,トパスは一意で,他のル,トパスのサブフォルダ,ではない。

  • ファ▪▪ルの場所を指す1▪▪以上のル▪トパスエントリを含む。

詳細にいては,異なるマシンまたはクラスタ,で処理するためのデ,タストアの設定を参照してください。

例:[" Z: \数据集”、“/ mynetwork /数据集”)

デ,タ型:字符串|细胞

テキスト変数の出力デ,タ型。“TextType”“字符”または“字符串”のいずれかで構成されるコンマ区切りのペアとして指定します。関数readallまたは预览の出力表にテキスト変数が含まれる場合,“TextType”TabularTextDatastoreでのそれらの変数のデ,タ型を指定します。“TextType”“字符”の場合,出力は文字ベクトルの单元格配列です。“TextType”“字符串”の場合,出力の型は字符串です。

デ,タ型:字符|字符串

“DatetimeType”と,“datetime”または“文本”のいずれかの値で構成されるコンマ区切りのペアとして指定します。

インポートされる日付と時刻のデータの型
“datetime”

MATLABのdatetimeデタ型

詳細にいては,datetimeを参照してください。

“文本”

“DatetimeType”“文本”として指定した場合,“TextType”プロパティで指定された値によって決まります。

  • “TextType”“字符”の場合,tabularTextdatastoreは,文字ベクトルのcell配列として日付をンポトします。

  • “TextType”“字符串”の場合,tabularTextdatastoreは,字符串の配列として日付を。

指定したTextscanFormatsプロパティに% Dが含まれる場合,tabularTextdatastoreDatetimeTypeで指定された値を無視します。

例:“DatetimeType”、“日期时间的

デ,タ型:字符|字符串

持续时间デ,タの出力デ,タ型。“DurationType”“持续时间”または“文本”のいずれかで構成されるコンマ区切りのペアとして指定します。

インポートされる时间データの型
“持续时间”

MATLABの持续时间デタ型

詳細にいては,持续时间を参照してください。

“文本”

“DurationType”“文本”として指定した場合,“TextType”パラメ,タ,で指定された値によって決まります。

  • “TextType”“字符”の場合,ンポト関数はdurationタを文字ベクトルのcell配列として返します。

  • “TextType”“字符串”の場合,ンポト関数はdurationタをstringの配列として返します。

デ,タ型:字符|字符串

日付を解釈するためのロケ,ル。文字ベクトルまたは字符串スカラとして指定します。DatetimeLocale値は,。

DatetimeLocaleを指定する場合,xx_YYの形式を使用します。ここでxxはiso 639-1で定義された小文字2文字の言語コドで,YYはISO 3166-1 alpha-2で定義された大文字の国コ,ドです。

次の表に一般的なロケ,ルの値を示します。

ロケル 言語
“de_DE” ドere語
“en_GB” 英語 英国
“en_US” 英語 米国
“es_ES” スペ@ @ン語 スペereplicationン
“fr_FR” フランス語 フランス
“it_IT” タリア語 タリア
“ja_JP” 日本語 日本
“ko_KR” 韓国語 韓国
“设置nl_NL” オランダ語 オランダ
“zh_CN” 簡体字中国語 中国

メモ

语言环境値により,入力値の解釈方法が決まります。表示形式と言語は,[基本設定]ウィンドウの[日付と時刻の形式]セクションの[ロケ,ル]オプションによって指定されます。既定の日付と時刻のロケルを変更する方法にいては,コマンドウィンドウ基本設定の設定を参照してください。

デ,タ型:字符|字符串

これらの名前と値のペアに加えて,このペ,ジのプロパティも名前と値のペアとして指定できます。ただし,文件プロパティを除きます。

プロパティ

すべて展開する

TabularTextDatastoreプロパティは,TabularTextDatastoreオブジェクトに関連付けられているファ@ @ルを記述します。具体的には,プロパティはファイル内のデータの形式を記述し,データストアからデータを読み取る方法を制御します。TabularTextDatastoreオブジェクトの作成時に,デ,タストア関数は文件プロパティ内の最初のファesc escルを使用して,そのプロパティの値を決定します。文件プロパティを除いて,数据存储オブジェクトの作成時に,名前と値のペアの引数を使用してTabularTextDatastoreプロパティの値を指定できます。オブジェクトの作成後にプロパティの表示または変更を行うには、ドット表記を使用します。

ds = tabularTextDatastore(“airlinesmall.csv”);ds。TreatAsMissing =“NA”;ds。MissingValue = 0;

ファ@ @ルプロパティ

デタストアに含まれるファル。文字ベクトルのcell配列または字符串配列として解決されます。各文字ベクトルまたは string はファイルへの絶対パスです。関数tabularTextDatastoreおよび関数数据存储位置引数がこれらのファ@ @ルを定義します。

文件プロパティで最初に指定するファイルは,データストアのすべてのファイルに対する変数名と形式の情報を決定します。

このプロパティ値を変更すると,デ,タストア関数はTabularTextDatastoreのプロパティ値を再評価します。

例:{“C: \ dir \ data \ mydata1.csv”;“C: \ dir \ data \ mydata2.csv”}

デ,タ型:细胞|字符串

ファ▪▪ルのエンコ▪▪ド。次の値のいずれかのような文字ベクトルまたは字符串スカラ,として指定します。

“IBM866”

“iso - 8859 - 1”

“windows - 847”

“KOI8-R”

“iso - 8859 - 2”

“windows - 1250”

“KOI8-U”

“iso - 8859 - 3”

“windows - 1251”

“麦金塔”

“iso - 8859 - 4”

“windows - 1252”

“us - ascii”

“iso - 8859 - 5”

“windows - 1253”

“utf - 8”

“iso - 8859 - 6”

“windows - 1254”

“iso - 8859 - 7”

“windows - 1255”

“iso - 8859 - 8”

“windows - 1256”

“iso - 8859 - 9”

“windows - 1257”

“iso - 8859 - 11”

“windows - 1258”

“iso - 8859 - 13”

“iso - 8859 - 15”

デタストア内の各ファルがメモリに収まる場合,FileEncodingは次の値のいずれかにすることもできます。

“繁体”

“EUC-KR”

“GB18030”

“Shift_JIS”

“Big5-HKSCS”

“EUC-JP”

“GB2312”

“windows - 949”

“CP949”

“EUC-TW”

“GBK”

このプロパティ値を変更すると,デ,タストア関数はTabularTextDatastoreのプロパティ値を再評価します。

デ,タ型:字符|字符串

変数名の読み取り。逻辑真正的または逻辑として指定します。

  • 指定しない場合,関数tabularTextDatastoreは変数名の有無を自動的に検出します。

  • 真正的の場合,最初のファルの最初の非ヘッダ行がそのデタの変数名を決定します。

  • の場合,最初のファルの最初の非ヘッダ行にそのデタの1行目が含まれます。デ,タには既定の変数名がVar1Var2などと順に割り当てられます。

このプロパティ値を変更すると,デ,タストア関数はTabularTextDatastoreのプロパティ値を再評価します。

デ,タ型:逻辑

変数名を保持するかどうかのフラグ。VariableNamingRuleと,“修改”または“保存”のいずれかで構成されるコンマ区切りのペアとして指定します。

  • “修改”-無効な変数名(関数isvarnameで判定)を,有効なmatlab識別子に変換。

  • “保存”——スペースや非ASCII文字を含む変数名など,有効なMATLAB識別子ではない変数名を保持。

R2019b以降,変数名と行名には,スペースや非ASCII文字など任意の文字を含めることができます。また,英字だけでなく任意の文字で始めることができます。変数名と行名は,有効なmatlab識別子(関数isvarnameで判定)である必要はありません。これらの変数名と行名を保持するには,VariableNamingRuleの値を“保存”に設定します。

デ,タ型:字符|字符串

デ,タストア内の変数名。文字ベクトルの细胞配列または字符串配列として指定します。ファ@ @ルに表示される順序で変数名を指定します。変数名を指定しない場合は、データ ストアの最初のファイルの最初の非ヘッダー行から検出されます。VariableNamesプロパティを変更する場合,新しい変数名の数は,元の変数名の数と一致しなければなりません。

スペースおよび非ASCII文字を含む変数名など,無効なMATLAB識別子を変数名としてサポートするには,VariableNamingRuleパラメ,タ,の値を“保存”に設定します。

ReadVariableNamesの場合,VariableNamesは既定値の{‘Var1’,‘Var2’,…}になります。

例:{“时间”、“名称”,“数量”}

デ,タ型:细胞|字符串

テキスト形式のプロパティ

ファ@ @ルの先頭からスキップする行数。非負の整数として指定します。指定しない場合,関数tabularTextDatastoreはスキップする行数を自動的に検出します。

関数tabularTextDatastoreは,指定したヘッダ,の行数を無視してから,変数名またはデ,タを読み取ります。

このプロパティ値を変更すると,デ,タストア関数はTabularTextDatastoreのプロパティ値を再評価します。

デ,タ型:

フィ,ルドの区切り記号。文字ベクトル、文字ベクトルのcell配列、字符串スカラまたは字符串配列として指定します。複数の区切り記号は,文字ベクトルの单元格配列または字符串配列で指定します。指定しない場合,関数tabularTextDatastoreは区切り記号を自動的に検出します。

例:“|”

例:{‘;’,‘*’}

ファイル内で連続する区切り文字を,それらの間に空のフィールドをもつ個別の区切り記号として解釈します。指定しない場合,既定で読み取り関数が自動的に区切り記号を検出します。

次のエスケープシーケンスの1つを区切り記号として指定した場合,そのシーケンスを対応する制御文字に変換します。

\ b バックスペ,ス
\ n 改行
r \ キャリッジリタ,ン
\ t タブ
\ \ バックスラッシュ(

このプロパティ値を変更すると,デ,タストア関数はTabularTextDatastoreのプロパティ値を再評価します。

デ,タ型:字符|细胞|字符串

行区切り記号文字。文字ベクトルまたは字符串スカラとして指定します。これは単一の文字か,' \ r '' \ n 'または“\ r \ n”のいずれかでなければなりません。

このプロパティ値を変更すると,デ,タストア関数はTabularTextDatastoreのプロパティ値を再評価します。

例:“:”

デ,タ型:字符|字符串

欠損値として処理するテキスト。単一の文字ベクトル,文字ベクトルの细胞配列,字符串スカラーまたは字符串配列として指定します。TreatAsMissingとして指定された値には,MissingValueプロパティで定義された値が代入されます。たとえば,MissingValueとして定義され,TreatAsMissing“NA”として定義されたとします。その場合,“NA”に置き換えられます。

このオプションは数値フィ,ルドのみに適用されます。また,このプロパティは,関数textscanの名前と値のペア引数TreatAsEmptyと等価です。

このプロパティ値を変更すると,デ,タストア関数はTabularTextDatastoreのプロパティ値を再評価します。

例:“NA”

例:{‘-’,”}

デ,タ型:字符|细胞|字符串

区切りテキストファ▪▪ル内の欠損値フィ▪▪ルドの値。スカラ,として指定します。このプロパティは,関数textscanの名前と値のペア引数EmptyValueと等価です。

デ,タ型:

高度なテキスト形式のプロパティ

デ,タフィ,ルドの形式。文字ベクトルの细胞配列または字符串配列として指定します。各文字ベクトルまたは字符串は1の変換指定子を含みます。

TextscanFormatsプロパティを指定または変更する場合,関数textscanformatSpec引数に対して受け入れるものと同じ変換指定子を使用できます。TextscanFormatsの有効値には,アスタリスク(*)文字を使用してフィールドをスキップする変換指定子と,リテラルテキストをスキップする変換指定子が含まれます。変換指定子の数は,VariableNamesプロパティ内の変数の数と一致しなければなりません。

  • TextscanFormatsの値にアスタリスク文字(*)を使用してフィルドをスキップする変換指定子が含まれる場合,SelectedVariableNamesプロパティの値は自動的に更新されます。MATLABは% *问変換指定子を使用してSelectedVariableNamesプロパティで省略されたフィールドをスキップし,フィールドの内容をリテラル文字ベクトルとして処理します。固定幅のファイルについては,適切な変換指定子をフィールド幅と共に使用してスキップするフィールドを指定します。たとえば,% * 52 cは52文字を含むフィ,ルドをスキップします。

  • TextscanFormatsに値を指定しない場合,数据存储は,データストアにある最初のファイルの最初の非ヘッダー行からテキストをスキャンすることにより,データフィールドの形式を決定します。

  • R2020b以降,数据存储は,接頭辞付きリテラルを16進数およびバ。以前は,数据存储は接頭辞付きリテラルをテキストデ,タとして検出していました。

例:{' % s ', ' % s ', ' % f '}

デ,タ型:细胞|字符串

指数文字。文字ベクトルまたは字符串スカラ,として指定します。既定の指数文字はeEdおよびDです。

デ,タ型:字符|字符串

ファ@ @ル内のコメントを識別するために使用されるコメント文字。文字ベクトル、字符串スカラ、2 要素 string または cell 配列として指定します。

  • 文字ベクトルまたは字符串スカラーを指定すると,同じ行の以降のテキストはすべてコメントと解釈されます。たとえば,“CommentStyle”、“/ *”では,同じ行の/*の後のすべてのテキストがコメントとして解釈されます。

  • 文字ベクトルを含む2要素弦ベクトルまたは2要素细胞配列を指定すると,2つの文字の間にあるすべてのテキストがコメントとして解釈されます。たとえば,“CommentStyle ',{'/*', '*/'}では,“/ *”から“* /”までのすべてのテキストがコメントとして解釈されます。

TabularTextDatastoreから読み取る場合,関数は,各フィールドの先頭のみコメントをチェックします(フィールド内はコメントチェック対象外です)。

このプロパティ値を変更すると,関数数据存储TabularTextDatastoreのプロパティ値を再評価します。

例:“CommentStyle ',{'/*', '*/'}

デ,タ型:字符|细胞|字符串

空白文字。1文字以上の文字ベクトルまたは字符串スカラ,として指定します。

次のエスケプシケンスの1を空白文字として指定した場合,関数数据存储は,シ,ケンスを対応する制御文字に変換します。

\ b バックスペ,ス
\ n 改行
r \ キャリッジリタ,ン
\ t タブ
\ \ バックスラッシュ(

このプロパティ値を変更すると,デ,タストア関数はTabularTextDatastoreのプロパティ値を再評価します。

例:“\ b \ t”

デ,タ型:字符|字符串

複数の区切り記号の取り扱い。真正的またはのいずれかとして指定します。真正的の場合,数据存储は連続した区切り記号を1の区切り記号として扱います。区切り記号が空白で分けられて繰り返された場合も,1の区切り記号として扱われます。

このプロパティ値を変更すると,デ,タストア関数はTabularTextDatastoreのプロパティ値を再評価します。

预览readallテ,ブルのプロパティ

ファ@ @ルから読み取る変数。文字ベクトルの细胞配列または字符串配列として指定します。各文字ベクトルまたは字符串は1の変数の名前を含みます。変数名は任意の順序で指定できます。

スペースおよび非ASCII文字を含む変数名など,無効なMATLAB識別子を変数名としてサポートするには,VariableNamingRuleパラメ,タ,の値を“保存”に設定します。

例:{‘Var3’,‘Var7’,‘Var4}

デ,タ型:细胞|字符串

選択した読み取り対象の変数の形式。文字ベクトルのcell配列または字符串配列として指定します。各文字ベクトルまたは字符串は1の変換指定子を含みます。読み取り対象の変数は,SelectedVariableNamesプロパティで指定されます。SelectedFormats内の文字ベクトルまたは字符串の数は,読み取り対象の変数の数と一致しなければなりません。

関数textscanが受け入れた変換指定子と同じ指定子を使用できます。これにはリテラルテキストをスキップする指定子が含まれます。ただし,フィ,ルドをスキップする変換指定子は使用できません。まり,変換指定子にアスタリスク文字(*)を含めることはできません。

例:{' % d ', ' % d '}

デ,タ型:细胞|字符串

関数の1回の呼び出しで読み取るデ,タの量。正のスカラ,または“文件”として指定します。

  • ReadSizeが正の整数の場合,へのそれぞれの呼び出しは最大でReadSizeの行数を読み取ります。

  • ReadSize“文件”の場合,を呼び出すたびに,1のファ。

ReadSizeを数値スカラ,から“文件”に変更したり,その逆の変更を行うと,MATLABはデータストアをデータの読み取り前の状態にリセットします。

デ,タ型:|字符|字符串

テキスト変数の出力デ,タ型。“字符”または“字符串”として指定します。TextTypeは,% s%问または[…]で書式設定されたテキスト変数のデ,タ型を指定します。

  • TextType“字符”の場合,出力は文字ベクトルの单元格配列です。

  • TextType“字符串”の場合,出力の型は字符串です。

デ,タ型:字符|字符串

行時間変数の名前。“RowTimes”および変数名(“日期”など)または変数龋ンデックス(3.など)で構成されるコンマ区切りのペアとして指定します。

RowTimesは时间表に関連するパラメ,タ,です。时间表の各行は、timetable の時間ベクトルに記録されている時間に関連付けられます。RowTimes内に指定される変数は,datetimeベクトルまたは持续时间ベクトルを含まなければなりません。

“OutputType”の値が“时间表”だが“RowTimes”を指定しない場合,TabularTextDatastoreは,最初のdatetime変数または持续时间変数を时间表の行時間として使用します。

writeallで使用するプロパティ

このプロパティは読み取り専用です。

デタストアの作成に使用するフォルダ。文字ベクトルのcell配列として返されます。cell 配列は列ベクトルとして方向付けされます。各文字ベクトルは、データ ファイルを含むフォルダーへのパスです。関数tabularTextDatastoreおよび関数数据存储位置引数は,デ,タストアの作成時に文件夹を定義します。

TabularTextDatastoreオブジェクトの文件プロパティを変更すると,文件夹プロパティがリセットされます。

デ,タ型:细胞

このプロパティは読み取り専用です。

書き込みでサポ,トされる形式のリスト。字符串の行ベクトルとして返されます。このプロパティは、writeallを使用してデタストアから出力ファルを書き込む際に使用可能な出力形式を指定します。

デ,タ型:字符串

このプロパティは読み取り専用です。

既定の出力形式。字符串スカラとして返されます。このプロパティは、writeallを使用してデタストアから出力ファルを書き込む際の既定の形式を指定します。

デ,タ型:字符串

オブジェクト関数

hasdata デ,タが読み取り可能かどうかを判別
numpartitions デ,タストアの区画数
分区 デ,タストアを分割する
预览 デタストア内のデタのサブセットをプレビュ
デ,タストアのデ,タの読み取り
readall デ,タストアのすべてのデ,タの読み取り
writeall ファ▪▪ルへのデ▪▪タストアの書き込み
重置 デ,タストアの初期状態へのリセット
变换 デ,タストアの変換
结合 複数のデ,タストアのデ,タを統合
isPartitionable デ,タストアが分割可能かどうかを判別
isShuffleable デ,タストアがシャッフル可能かどうかを判別

すべて折りたたむ

表形式デタが格納されたサンプルファルairlinesmall.csvからデ,タストアを作成します。

ds = tabularTextDatastore(“airlinesmall.csv”“TreatAsMissing”“NA”...“MissingValue”, 0);

デ,タストア内の変数を表示します。

ds。VariableNames
ans =1 x29单元格第1至5列{'年'}{'月'}{'月日'}{'周日'}{'DepTime'}第6至9列{'CRSDepTime'} {'ArrTime'} {'CRSArrTime'} {'UniqueCarrier'}第10至13列{'FlightNum'} {'TailNum'} {'ActualElapsedTime'} {'CRSElapsedTime'} 14至18列{'AirTime'} {'ArrDelay'} {'DepDelay'} {'Origin'} {'Dest'}第19至22列{'Distance'} {'TaxiIn'} {'TaxiOut'} {'Cancelled'}第23至25列{'CancellationCode'} {' '} {'CarrierDelay'}}第26至28列{'WeatherDelay'} {'NASDelay'} {'SecurityDelay'}第29列{'LateAircraftDelay'}

SelectedVariableNamesプロパティを変更して対象の変数を指定します。

ds。SelectedVariableNames = {“年”“月”“取消”};

対象の変数はデ,タストアの作成時に指定することもできます。

ds = tabularTextDatastore(“airlinesmall.csv”“TreatAsMissing”“NA”...“MissingValue”0,“SelectedVariableNames”,{“年”“月”“取消”});

表形式デタが格納されたサンプルファルairlinesmall.csvからデ,タストアを作成します。

ds = tabularTextDatastore(“airlinesmall.csv”“TreatAsMissing”“NA”...“MissingValue”, 0);

対象の変数を指定します。

ds。SelectedVariableNames = {“年”“月”“UniqueCarrier”};

SelectedFormatsプロパティを表示します。

ds。SelectedFormats
ans =1 x3单元格{'%f'} {'%f'} {'%q'}

SelectedFormatsプロパティは,関数tabularTextDatastoreによる変数の形式の解釈方法を指定します。変数一年およびは浮動小数点値の列として読み取られ,変数UniqueCarrierはテキストの列として読み取られます。

SelectedFormatsプロパティを変更して,最初の2つの変数を符号付き整数として読み取り,3番目の変数を直言値として読み取ります。

ds。SelectedFormats = {' % d '' % d '“% C”};

デ,タをプレビュ,します。

T =预览(ds)
T =8×3表年月唯一承运人_________ _____________ 1987 10 PS 1987 10 PS 1987 10 PS 1987 10 PS 1987 10 PS 1987 10 PS 1987 10 PS 1987 10 PS 1987 10 PS 1987 10 PS 1987 10 PS 1987 10 PS 1987 10 PS

OutputTypeおよびRowTimesの名前と値のペアを使用して,tabulartextDatastoreから表ではなく时间表が返されるようにします。

outages.csvのデ,タストアを作成します。名前と値のペア“OutputType”“时间表”として指定します。

ttds = tabularTextDatastore(“outages.csv”“OutputType”“时间表”);预览(运输大亨)
ans =8×5时间表OutageTime地区客户RestorationTime造成损失  ________________ _____________ ______ __________ ________________ ___________________ 2002-02-01 12:18{“西南”}458.98 - 1.8202 e + 06 2002-02-07 16:50{“暴风雪”}2003-01-23 00:49{“东南”}530.14 - 2.1204 e + 05 NaT{“暴风雪”}2003-02-07)21:15{“东南”}289.4 - 1.4294 e + 05 2003-02-17 08:14{“暴风雪”}2004-04-06 05:44{‘西方’}434.81 - 3.4037 e + 05 2004-04-06 06:10{“设备故障”}2002-03-16 06:18 186.44{“中西部”}2.1275e+05 2002-03-18 23:23{'严重风暴'}2003-06-18 02:49{'西'}00 2003-06-18 10:54{'攻击'}2004-06-20 14:39{'西'}231.29 NaN 2004-06-20 19:16{'设备故障'}2002-06-06 19:28{'西'}311.86 NaN 2002-06-07 00:51{'设备故障'}

“RowTimes”を併せて指定しない場合,tabularTextDatastoreは,最初のdatetime変数またはduration変数を行時間として使用します。この場合は,変数OutageTimeが行時間に使用されます。

“RowTimes”オプションを指定して,停電時刻ではなく復旧時刻(変数RestorationTime)を行時間として使用します。

ttds = tabularTextDatastore(“outages.csv”“OutputType”“时间表”“RowTimes”“RestorationTime”);预览(运输大亨)
ans =8×5时间表RestorationTime地区OutageTime客户造成损失  ________________ _____________ ________________ ______ __________ ___________________ 2002-02-07 16:50{“西南”}2002-02-01 12:18 458.98 - 1.8202 e + 06{“暴风雪”}NaT{“东南”}2003-01-23 00:49 530.14 - 2.1204 e + 05{“暴风雪”}2003-02-17 08:14{“东南”}2003-02-07)21:15 289.4 - 1.4294 e + 05{“暴风雪”}2004-04-06 06:10{‘西方’}2004-04-06 05:44 434.81 - 3.4037 e + 05{“设备故障”}2002-03-18 23:23{“中西部”}2002-03-16 06:18 186.44 2.1275e+05{'严重风暴'}2003-06-18 10:54{'西'}2003-06-18 02:49 00{'攻击'}2004-06-20 19:16{'西'}2004-06-20 14:39 231.29 NaN{'设备故障'}2002-06-07 00:51{'西'}2002-06-06 19:28 311.86 NaN{'设备故障'}

制限

  • en_USロケール以外の言語で日,月,またはタイムゾーンの名前を含むdatetimeデータはサポートされません。認識されないdatetime形式の場合は,TextscanFormatsパラメ,タ,を使用して形式を指定します。

R2014bで導入