files2dc


目次

メニュー情報

データ：複数ファイルに接続

概要

複数ファイルとの接続を作成

追加の情報

必要なOriginのバージョン: 2020b以降

コマンドラインでの使用法

1. string fname$="C:\examples\Gasoline 1.mat%(CRLF)C:\examples\Gasoline 2.mat%(CRLF)C:\examples\Gasoline 3.mat"; files2dc dc:=MATLAB;

2. files2dc dc:=CSV fname:="%Ytest2.csv%(CRLF)%Ytest1.csv" samebk:=1 dlg:=1;

3. files2dc dc:=CSV src:=1 path:=%YData samebk:=1;

4. files2dc dc:="Import Filter" fname:="%YS32-014-04.dat%(CRLF)%YS21-235-07.dat%(CRLF)%YS15-125-03.dat" samebk:=1;

変数

表示
名 		変数
名 		I/O
と
データ型 		デフォルト
値 		説明
データコネクタ dc

入力

string

データコネクタのファイルタイプを指定します。Biologic、TDMS、XML、MATLAB、HDF、CSV、Excelなど、複数のタイプがサポートされています。指定したフィルタでファイルをインポートすることもできます。
ソース src

入力

int

0
 インポートするファイルのソースを指定します。2つのオプションを利用できます。
  • 0:指定したファイル：下のファイル名でインポートするファイルを指定します。
  • 1:指定したフォルダ内のファイル：フォルダ内（下記参照）を検索し、データコネクタで指定されたデータ型のすべてのファイルをインポートします。
ファイル名 fname

入力

string

fname$
 ソースが指定したファイルの場合に利用できます。インポートするファイルを指定します。ファイルのパス全体を含める必要があります。
フォルダ path

入力

string

ソースが指定したフォルダ内のファイルの場合に利用できます。フォルダパスを指定します。
同一ブック samebk

入力

int

0
 このチェックボックスは、CSVコネクタのように同じワークブック内に複数ファイルをインポート可能なコネクタを選択した場合に利用できます。このチェックを入れると、ワークブックには第一ファイルの名前が付けられます。別々のワークブックにインポートした場合、各ワークブックには各ファイルの名前が付けられます。
同一シートに追加 samesheet

入力

int

0
 データコネクタがCSVおよび同一ブックの場合に利用できます。複数のファイルを同じワークシートにインポートするかどうか、およびインポートする場合はファイルの追加方法を指定します。次の3つのオプションを使用できます。
  • 0：なし：各ファイルを別々のシートにインポートします。
  • 1：新規行：全てのファイルを同じワークシートの行方向に追加します。
  • 2：新規列：各ファイルを同じワークシートの列方向に追加します。
ファイル名を挿入 addfn

入力

int

0
 同一シートに追加が新規行の場合に利用できます。このチェックボックスをオンにすると、ファイル名情報を格納する最初の列が挿入されます。
ファイル名オプション filename

入力

int

0
 同一シートに追加が新規行または新規列の場合に利用できます。ファイル名から抽出する情報を指定します。次の3つのオプションを使用できます。
  • 0:ファイル名のみ：ファイル名のみ抽出、ファイル拡張子なし
  • 1:名前と拡張子：ファイル名と拡張子の両方を抽出
  • 2:ファイル名の一部：ファイル名の一部を抽出します。下記のファイル名の一部を抽出編集ボックスを使用します。
ファイル名の一部を抽出 parts

入力

String

ファイル名オプションがファイル名の一部の場合に、ファイル名のどの部分を最初の列に抽出するかを指定します。文字範囲を開始位置:終了位置または開始位置+文字数の形式で入力します。1は最初の文字を表し、0は最後の文字を表します。

例えば、インポートファイル名（拡張子付き）がT325K.csvであるとします。温度（単位を含む）、つまり325Kを抽出するには、2:0 または2+4 と入力します。

部分ファイル名ラベル label

入力

String

同一シートに追加が新規行の場合はファイル名列ロングネームを、同一シートに追加が新規列の場合はラベル行ヘッダを指定します。
第一ファイルでダイアログを開く dlg

入力

int

0
 このチェックボックスをオンにすると、最初のファイルをインポートする前にインポートオプションダイアログを開きます。残りのすべてのファイルは、この設定に従ってインポートされます。
列属性の設定 cols

入力

String

インポート時に列属性を指定します。ここで使用されている指定記号については、このページを参照してください。繰り返しパターン(括弧で囲まれたパターンが繰り返される)と、先頭と末尾の指定記号を含むパターンがサポートされています。

例えば、
XYは第1列をX、第2列をYに設定します。これ以降の列属性はすべてYになります。
3(XY)は最初の6列をXYXYXYに設定します。ワークシートに6つ以上の列がある場合、残りはすべてYとなります。
N(XY)は第1列を無属性、残りの列はXYの組に設定します。
NL(XY)Zは第1列を無属性、第2列をラベル、最後の列をZ、その間の列はXYの組に設定します。

説明

このXファンクションは同時に複数のファイルに接続するのに使用します。現在は一部のコネクタでサポートされており、たとえば、ワークブックの場合はCSV、Excel、MATLAB、HDF、NetCDFコネクタ+インポートフィルタで、行列の場合はMATLAB、HDF、NetCDFコネクタです。

このダイアログは、指定されたファイルまたは指定されたフォルダ内のすべてのファイルの選択が可能です。CSVコネクタなどいくつかのコネクタは、同じワークブック内に複数ファイルをインポート可能です。第一ファイルでダイアログを開くチェックボックスをオンにすると、インポートオプションダイアログが開き、インポート設定を指定できます。残りのすべてのファイルは、この設定に従ってインポートされます。

詳細はこのドキュメントを参照してください。