edfinfo
説明
edfinfo
オブジェクトを作成して、European Data Format (EDF) または EDF+ ファイルに関する情報を取得します。edfinfo
オブジェクトには、ファイル サイズ、データ レコードの数、信号の数、サンプルの数などの情報が含まれています。
作成
入力引数
filename
— EDF または EDF+ ファイルの名前
文字ベクトル | string スカラー
EDF または EDF+ ファイルの名前。文字ベクトルまたは string スカラーとして指定します。
ファイルの場所に応じて、filename
は次の形式のいずれかを取ります。
位置 | 形式 |
---|---|
現在のフォルダーまたは MATLAB® パス上のフォルダー |
例: |
フォルダー内のファイル | ファイルが現在のフォルダーまたは MATLAB パス上のフォルダーにない場合は、絶対パス名または相対パス名を指定します。 例: 例: |
メモ
edfinfo
は EyeLink® EDF ファイルをサポートしていません。
データ型: char
| string
プロパティ
ファイルのプロパティ
Filename
— ファイル名
string スカラー
この プロパティ は読み取り専用です。
ファイル名。string スカラーとして返されます。
例: "ecg_20200411_120.edf"
データ型: string
FileModDate
— 最終更新日
string スカラー
この プロパティ は読み取り専用です。
最終変更日。ファイルが最後に変更された日時を含む string スカラーとして返されます。
例: "11-Apr-2020 15:38:37"
FileSize
— ファイルサイズ (バイト単位)
整数値スカラー
この プロパティ は読み取り専用です。
ファイル サイズ (バイト単位)。整数値スカラーとして返されます。
例: 4040992
データ型: double
ヘッダーのプロパティ
Version
— データ形式のバージョン
"0"
この プロパティ は読み取り専用です。
データ形式のバージョン。"0"
として返されます。
データ型: string
Patient
— 患者識別の詳細
string スカラー
この プロパティ は読み取り専用です。
患者識別の詳細。string スカラーとして返されます。患者識別の詳細には、患者 ID、性別またはジェンダー、'dd-MMM-yyyy'
形式の生年月日、および名前が含まれます。
例: "X F X 120 04-JUL-1982"
データ型: string
Recording
— 識別の詳細の記録
string スカラー
この プロパティ は読み取り専用です。
識別の詳細の記録。string スカラーとして返されます。識別の詳細の記録には、開始日時、記録を行った技術者の ID、および記録に使った装置の ID が含まれる場合があります。
例: "Startdate 04-JUL-1982 X X X"
データ型: string
StartDate
— 記録開始日
string スカラー
この プロパティ は読み取り専用です。
記録開始日。'dd.MM.yy'
形式の string スカラーとして返されます。
例: "04.07.82"
データ型: string
StartTime
— 記録開始時間
string スカラー
この プロパティ は読み取り専用です。
記録開始時間。'HH.mm.ss'
形式の string スカラーとして返されます。
例: "17.16.37"
データ型: string
HeaderBytes
— ヘッダー サイズ (バイト単位)
整数値スカラー
この プロパティ は読み取り専用です。
ヘッダー サイズ (バイト単位)。整数値スカラーとして返されます。HeaderBytes
は (256 + NumSignals
× 256) バイトで指定されます。最初の 256 バイトは静的ヘッダーに対応し、すべての EDF および EDF+ ファイルに必要です。その他のバイトは、データ レコードに存在する信号の数によって異なります。
例: 2048
データ型: double
Reserved
— EDF+ の中断情報
"EDF+C"
| "EDF+D"
| ""
この プロパティ は読み取り専用です。
EDF+ の中断情報。EDF+ 準拠ファイルに対して "EDF+C"
または "EDF+D"
として返されます。
"EDF+C"
— 記録は連続しています。中断はなく、すべてのデータ レコードは連続しているため、各データ レコードの開始時間は、前のレコードの開始時間に記録時間を加えたものと一致します。"EDF+D"
— 記録は不連続であり、連続するデータ レコード間に中断があります。
EDF+ に準拠していないファイルの場合、このプロパティは空の文字列 (""
) になります。
データ型: string
NumDataRecords
— ファイル内のデータ レコードの数
整数値スカラー
この プロパティ は読み取り専用です。
ファイル内のデータ レコードの数。整数値スカラーとして返されます。
メモ
filename
が EDF に準拠していない場合、データ レコードの数が不明なときには NumDataRecords
を -1
に設定できます。filename
が EDF に準拠している場合、NumDataRecords
を正の整数に設定しなければなりません。filename
の Reserved
が空以外の文字列に設定されていて、NumDataRecords
が -1
に設定されている場合、edfinfo
はエラーをスローします。
データ型: double
DataRecordDuration
— 各データ レコードの持続時間
duration スカラー
この プロパティ は読み取り専用です。
各データ レコードの持続時間。duration スカラーとして返されます。
データ型: duration
NumSignals
— ファイル内の信号の数
整数値スカラー
この プロパティ は読み取り専用です。
ファイル内の信号の数。整数値スカラーとして返されます。
データ型: double
信号レコードのプロパティ
SignalLabels
— 信号名
string ベクトル
TransducerTypes
— 変換器の詳細
string ベクトル
この プロパティ は読み取り専用です。
変換器の詳細。長さ NumSignals
の string ベクトルとして返されます。TransducerTypes
の各要素には、SignalLabels
の対応する信号を取得するために使用される変換器に関する詳細が含まれます。
例: ["AgAgCl electrodes";"thermistor"]
データ型: string
PhysicalDimensions
— 信号のデータ単位
string ベクトル
この プロパティ は読み取り専用です。
信号のデータ単位。長さ NumSignals
の string ベクトルとして返されます。PhysicalDimensions
の各要素には、SignalLabels
の対応する信号の値を表すために使用される測定単位が含まれます。
例: ["uV";"mV"]
データ型: string
PhysicalMin
— 信号の最小物理値
数値ベクトル
この プロパティ は読み取り専用です。
信号の最小物理値。長さ NumSignals
の数値ベクトルとして返されます。PhysicalMin
の各要素には、SignalLabels
の対応する信号の最小物理値が含まれています。
データ型: double
PhysicalMax
— 信号の最大物理値
数値ベクトル
この プロパティ は読み取り専用です。
信号の最大物理値。長さ NumSignals
の数値ベクトルとして返されます。PhysicalMax
の各要素には、SignalLabels
の対応する信号の最大物理値が含まれます。
データ型: double
DigitalMin
— 信号の最小デジタル値
数値ベクトル
この プロパティ は読み取り専用です。
信号の最小デジタル値。長さ NumSignals
の数値ベクトルとして返されます。DigitalMin
の各要素には、SignalLabels
の対応する信号の最小デジタル値が含まれます。
データ型: double
DigitalMax
— 信号の最大デジタル値
数値ベクトル
この プロパティ は読み取り専用です。
信号の最大デジタル値。長さ NumSignals
の数値ベクトルとして返されます。DigitalMax
の各要素には、SignalLabels
の対応する信号の最大デジタル値が含まれます。
データ型: double
NumSamples
— 信号のサンプル数
数値ベクトル
この プロパティ は読み取り専用です。
信号のサンプル数。長さ NumSignals
の数値ベクトルとして返されます。NumSamples
の各要素には、SignalLabels
の対応する信号のサンプル数が含まれます。
データ型: double
Prefilter
— 信号のデータ単位
string ベクトル
この プロパティ は読み取り専用です。
信号のデータ単位。長さ NumSignals
の string ベクトルとして返されます。Prefilter
の各要素には、SignalLabels
の対応する信号を前処理するために使用されるフィルターに関する詳細 (該当する場合) が含まれます。
例: ["HP:10Hz LP:80Hz N:60Hz";"HP:0.1Hz LP:90Hz N:60Hz"]
データ型: string
SignalReserved
— 追加の信号情報
string ベクトル
この プロパティ は読み取り専用です。
追加の信号情報。長さ NumSignals
の string ベクトルとして返されます。SignalReserved
の各要素には、SignalLabels
の対応する信号に関する追加情報 (該当する場合) が含まれます。
データ型: string
Annotations
— 信号レコードに存在する注釈
timetable
この プロパティ は読み取り専用です。
信号レコードに存在する注釈。次の変数を含む timetable として返されます。
Onset
— 注釈が発生した時間。ファイルの開始時間から経過した秒数を示す持続時間として表されます。Annotations
— 注釈テキストを含む文字列。Duration
— 注釈によって記述されたイベントの持続時間を示す duration スカラー。ファイルで注釈の持続時間が指定されていない場合、この変数はNaN
として返されます。
データ型: table
例
EDF ファイルに関する情報の取得
関数 edfinfo
を使用して、example.edf
ファイルに関する情報を含む edfinfo
オブジェクトを作成します。
info = edfinfo('example.edf')
info = edfinfo with properties: Filename: "example.edf" FileModDate: "30-Oct-2020 12:27:26" FileSize: 31488 Version: "0" Patient: "Patient 7" Recording: "Startdate not recorded" StartDate: "10.10.20" StartTime: "12.02.18" HeaderBytes: 768 Reserved: "" NumDataRecords: 6 DataRecordDuration: 10 sec NumSignals: 2 SignalLabels: [2x1 string] TransducerTypes: [2x1 string] PhysicalDimensions: [2x1 string] PhysicalMin: [2x1 double] PhysicalMax: [2x1 double] DigitalMin: [2x1 double] DigitalMax: [2x1 double] Prefilter: [2x1 string] NumSamples: [2x1 double] SignalReserved: [2x1 string] Annotations: [0x2 timetable]
ファイルの 2 番目の信号に関する次の情報を表示します。
名前
データが表現される物理単位
データの最小および最大物理値
含まれているサンプル数
nsig = 2;
disp([info.SignalLabels(nsig) info.PhysicalDimensions(nsig) ...
info.PhysicalMin(nsig) info.PhysicalMax(nsig) info.NumSamples(nsig)])
"ECG2" "mV" "-229.048" "229.041" "1280"
ヒント
関数 get
を使用して、edfinfo
オブジェクトを MATLAB 構造体に変換できます。次に例を示します。
info = edfinfo('example.edf');
strc = get(info)
参照
[1] Kemp, Bob, Alpo Värri, Agostinho C. Rosa, Kim D. Nielsen, and John Gade. “A Simple Format for Exchange of Digitized Polygraphic Recordings.” Electroencephalography and Clinical Neurophysiology 82, no. 5 (May 1992): 391–93. https://doi.org/10.1016/0013-4694(92)90009-7.
[2] Kemp, Bob, and Jesus Olivan. "European Data Format 'plus' (EDF+), an EDF Alike Standard Format for the Exchange of Physiological Data." Clinical Neurophysiology 114, no. 9 (2003): 1755–1761. https://doi.org/10.1016/S1388-2457(03)00123-8.
バージョン履歴
R2020b で導入
MATLAB コマンド
次の MATLAB コマンドに対応するリンクがクリックされました。
コマンドを MATLAB コマンド ウィンドウに入力して実行してください。Web ブラウザーは MATLAB コマンドをサポートしていません。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)