Документация

edfinfo

Получение информации о файле EDF/EDF +

развернуть все на странице

Описание

Создание edfinfo объект для получения информации о файле европейского формата данных (EDF) или EDF + .edfinfo объекты содержат такую информацию, как размер файла, количество записей данных, количество сигналов и количество выборок.

Создание

Синтаксис

info = edfinfo (имя файла)

Описание

info = edfinfo(filename) возвращает edfinfo для файла EDF или EDF +, указанного filename.

Входные аргументы

развернуть все

`filename` - Имя файла EDF или EDF +
вектор символов | строковый скаляр

Имя файла EDF или EDF +, заданного как вектор символа или скаляр строки.

В зависимости от расположения файла, filename может принимать одну из этих форм.

Местоположение

Форма

Текущая папка или папка на пути MATLAB ®

Укажите имя файла в filename.

Пример: 'data.edf'

Файл в папке

Если файл находится не в текущей папке или в папке на пути MATLAB, укажите полный или относительный путь.

Пример: 'C:\myFolder\data.edf'

Пример: 'myDir\myFile.ext'

Примечание

edfinfo не поддерживает файлы EyeLink ® EDF.

Типы данных: char | string

Свойства

развернуть все

Свойства файла

`Filename` - Имя файла
строковый скаляр

Это свойство доступно только для чтения.

Имя файла, возвращаемое как строковый скаляр.

Пример: "ecg_20200411_120.edf"

Типы данных: string

`FileModDate` - Дата последнего изменения
строковый скаляр

Это свойство доступно только для чтения.

Дата последнего изменения, возвращенная в виде строкового скаляра с датой и временем последнего изменения файла.

Пример: "11-Apr-2020 15:38:37"

`FileSize` - Размер файла в байтах
целочисленный скаляр

Это свойство доступно только для чтения.

Размер файла в байтах, возвращаемый как целочисленный скаляр.

Пример: 4040992

Типы данных: double

Свойства заголовка

`Version` - Версия формата данных
`"0"`

Это свойство доступно только для чтения.

Версия формата данных, возвращенная как "0".

Типы данных: string

`Patient` - Реквизиты идентификации пациента
строковый скаляр

Это свойство доступно только для чтения.

Детали идентификации пациента, возвращенные как строковый скаляр. Реквизиты идентификации пациента могут включать идентификатор пациента, пол или пол, дату рождения в 'dd-MMM-yyyy' формат и имя.

Пример: "X F X 120 04-JUL-1982"

Типы данных: string

`Recording` - Регистрация идентификационных данных
строковый скаляр

Это свойство доступно только для чтения.

Запись идентификационных данных, возвращаемых в виде строкового скаляра. Идентификационные данные записи могут включать в себя дату и время ее начала, идентификатор техника, сделавшего запись, и идентификатор оборудования, сделавшего запись.

Пример: "Startdate 04-JUL-1982 X X X"

Типы данных: string

`StartDate` - Дата начала записи
строковый скаляр

Это свойство доступно только для чтения.

Дата начала записи, возвращенная как строковый скаляр в 'dd.MM.yy' формат.

Пример: "04.07.82"

Типы данных: string

`StartTime` - Время начала записи
строковый скаляр

Это свойство доступно только для чтения.

Время начала записи, возвращенное как скаляр строки в 'HH.mm.ss' формат.

Пример: "17.16.37"

Типы данных: string

`HeaderBytes` - Размер заголовка в байтах
целочисленный скаляр

Это свойство доступно только для чтения.

Размер заголовка в байтах, возвращаемый как целочисленный скаляр. HeaderBytes задается значением (256 + NumSignals × 256) байт. Первые 256 байт соответствуют статическому заголовку и требуются для всех файлов EDF и EDF +. Другие байты зависят от количества сигналов, присутствующих в записях данных.

Пример: 2048

Типы данных: double

`Reserved` - информация о прерываниях EDF +
`"EDF+C"` | `"EDF+D"` | `""`

Это свойство доступно только для чтения.

Информация о прерывании EDF +, возвращенная как"EDF+C" или "EDF+D" для файлов, совместимых с EDF +.

"EDF+C" - Запись является непрерывной: Нет прерываний и все записи данных являются непрерывными, так что время начала каждой записи данных совпадает с временем начала предыдущей записи плюс ее продолжительность.
"EDF+D" - Запись прерывается с перерывами между последовательными записями данных.

Для файлов, не совместимых с EDF +, это свойство является пустой строкой ("").

Типы данных: string

`NumDataRecords` - Количество записей данных в файле
целочисленный скаляр

Это свойство доступно только для чтения.

Количество записей данных в файле, возвращаемое в виде целочисленного скаляра.

Примечание

Если filename не соответствует EDF, NumDataRecords может иметь значение -1 когда число записей данных неизвестно. Если filename соответствует EDF, NumDataRecords должно быть задано положительное целое число. Если filename имеет Reserved установлено в непустую строку и NumDataRecords установить в значение -1, edfinfo выдает ошибку.

Типы данных: double

`DataRecordDuration` - Продолжительность каждой записи данных
скаляр длительности

Это свойство доступно только для чтения.

Длительность каждой записи данных, возвращаемая как скаляр длительности.

Типы данных: duration

`NumSignals` - Количество сигналов в файле
целочисленный скаляр

Это свойство доступно только для чтения.

Количество сигналов в файле, возвращаемое в виде целочисленного скаляра.

Типы данных: double

Свойства записи сигнала

`SignalLabels` - Названия сигналов
строковый вектор

Это свойство доступно только для чтения.

Имена сигналов, возвращаемые как строковый вектор длины NumSignals.

["Thorax 1";"Abdomen 3"]

Типы данных: string

`TransducerTypes` - Сведения о преобразователе
строковый вектор

Это свойство доступно только для чтения.

Сведения о преобразователе, возвращаемые как строковый вектор длины NumSignals. Каждый элемент TransducerTypes содержит сведения о преобразователе, используемом для получения соответствующего сигнала в SignalLabels.

Пример: ["AgAgCl electrodes";"thermistor"]

Типы данных: string

`PhysicalDimensions` - Блоки данных сигналов
строковый вектор

Это свойство доступно только для чтения.

Единицы данных сигнала, возвращаемые как строковый вектор длины NumSignals. Каждый элемент 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` - Блоки данных сигналов
строковый вектор

Это свойство доступно только для чтения.

Единицы данных сигнала, возвращаемые как строковый вектор длины NumSignals. Каждый элемент Prefilter содержит подробную информацию о фильтрах, если таковые имеются, используемых для предварительной обработки соответствующего сигнала в SignalLabels.

Пример: ["HP:10Hz LP:80Hz N:60Hz";"HP:0.1Hz LP:90Hz N:60Hz"]

Типы данных: string

`SignalReserved` - Дополнительная сигнальная информация
строковый вектор

Это свойство доступно только для чтения.

Дополнительная информация о сигнале, возвращаемая в виде строкового вектора длины NumSignals. Каждый элемент SignalReserved содержит дополнительную информацию, если она имеется, о соответствующем сигнале в SignalLabels.

Типы данных: string

`Annotations` - Аннотации, присутствующие в записях сигналов
расписание

Это свойство доступно только для чтения.

Аннотации, присутствующие в записях сигналов, возвращаемые в виде расписания, содержащего следующие переменные:

Onset - время, в которое произошла аннотация, выраженное в виде длительности, указывающей количество секунд, прошедших с момента начала файла.
Annotations - строка, содержащая текст аннотации.
Duration - скаляр длительности, указывающий длительность события, описанного аннотацией. Если в файле не указана продолжительность аннотации, эта переменная возвращается как NaN.

Типы данных: table

Примеры

свернуть все

Получение информации о файле EDF

Открыть сценарий в реальном времени

Используйте edfinfo для создания функции edfinfo объект, содержащий информацию о файле example.edf.

info = edfinfo('example.edf')

info = 
  edfinfo with properties:

              Filename: "example.edf"
           FileModDate: "14-Nov-2020 18:40:18"
              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]

Отобразите следующую информацию о втором сигнале в файле:

Его название
Физические единицы, в которых выражены данные
Минимальное и максимальное физические значения данных
Количество образцов, содержащихся в нем

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"

Совет

Можно преобразовать edfinfo объект к структуре MATLAB с использованием get функция. Например:

info = edf('example.edf');
strc = get(info)

Ссылки

[1] Кемп, Боб, Алпо Вярри, Агостиньо К. Роза, Ким Д. Нильсен и Джон Гейд. «Простой формат обмена оцифрованными полиграфическими записями». Электроэнцефалография и клиническая нейрофизиология 82, № 5 (май 1992): 391-93. https://doi.org/10.1016/0013-4694 (92) 90009-7.

[2] Кемп, Боб и Иисус Оливан. «Европейский формат данных» плюс «(EDF +), аналогичный EDF стандартный формат для обмена физиологическими данными». Клиническая нейрофизиологическая 114, № 9 (2003): 1755-1761. https://doi.org/10.1016/S1388-2457 (03) 00123-8.

См. также

datetime | duration | edfread | get | timetable

Внешние веб-сайты

Европейский формат данных

Представлен в R2020b

Документация по инструментам обработки сигналов

Поддержка