Объект параметров импорта для текстовых файлов фиксированной ширины
A FixedWidthImportOptions позволяет указать, как MATLAB ® импортирует табличные данные фиксированной ширины из текстовых файлов. Объект содержит свойства, управляющие процессом импорта данных, включая обработку ошибок и отсутствующих данных.
Можно создать FixedWidthImportOptions с использованием либо fixedWidthImportOptions функция (описана здесь) или detectImportOptions функция:
Использовать fixedWidthImportOptions для определения свойств импорта на основе требований импорта.
Использовать detectImportOptions для обнаружения и заполнения свойств импорта на основе содержимого текстового файла фиксированной ширины, указанного в filename.
opts = detectImportOptions(filename)
opts = fixedWidthImportOptions создает FixedWidthImportOptions объект с одной переменной.
opts = fixedWidthImportOptions('NumVariables', создает объект с числом переменных, указанным в numVars)numVars.
getvaropts | Получение параметров импорта переменных |
setvaropts | Задать параметры импорта переменных |
setvartype | Задать типы переменных данных |
preview | Просмотр восьми строк из файла с помощью параметров импорта |
Проверьте текстовый файл в формате фиксированной ширины, инициализируйте объект параметров импорта и используйте объект для импорта таблицы из текстового файла.
Загрузка и просмотр текстового файла фиксированной ширины
Загрузить файл fixed_width_patients_subset_perfect.txt и предварительный просмотр его содержимого в текстовом редакторе. Снимок экрана показывает, что файл содержит данные в формате фиксированной ширины.
filename = 'fixed_width_patients_subset_perfect.txt';
Проверка и извлечение свойств файла фиксированной ширины
Текстовый файл фиксированной ширины содержит табличные данные, упорядоченные по начальному местоположению, количеству переменных, именам переменных и ширине переменных. Зафиксируйте эти свойства и требуемый тип данных для переменных.
DataStartLine = 2;
NumVariables = 7;
VariableNames = {'LastName','Gender','Age','Location','Height',...
'Weight','Smoker'};
VariableWidths = [ 10, 7, 4, 26, 7, ...
7, 7 ] ;
DataType = {'char','categorical','double','char','double',...
'double','logical'};
Инициализация и настройка FixedWidthImportOptions Объект
Инициализация FixedWidthImportOptions и настроить его свойства так, чтобы они соответствовали свойствам данных в fixed_width_patients_subset_perfect.txt.
opts = fixedWidthImportOptions('NumVariables',NumVariables,... 'DataLines',DataStartLine,... 'VariableNames',VariableNames,... 'VariableWidths',VariableWidths,... 'VariableTypes',DataType);
Таблица импорта
Использовать readtable с FixedWidthImportOptions объект для импорта таблицы.
T = readtable(filename,opts)
T=10×7 table
LastName Gender Age Location Height Weight Smoker
____________ ______ ___ _____________________________ ______ ______ ______
{'Smith' } Male 38 {'County General Hospital' } 71 176 true
{'Johnson' } Male 43 {'VA Hospital' } 69 163 false
{'Williams'} Female 38 {'St. Mary's Medical Center'} 64 131 false
{'Brown' } Female 49 {'County General Hospital' } 64 119 false
{'Miller' } Female 33 {'VA Hospital' } 64 142 true
{'Wilson' } Male 40 {'VA Hospital' } 68 180 false
{'Taylor' } Female 31 {'County General Hospital' } 66 132 false
{'Thomas' } Female 42 {'St. Mary's Medical Center'} 66 137 false
{'Jackson' } Male 25 {'VA Hospital' } 71 174 false
{'Clark' } Female 48 {'VA Hospital' } 65 133 false
Определите объект параметров импорта для импорта грязных данных из форматированного текстового файла фиксированной ширины. Настройте объект для обработки грязных данных и используйте его для импорта таблицы.
Загрузка и просмотр текстового файла фиксированной ширины
Загрузить файл fixed_width_patients_subset_messy.txt и предварительный просмотр его содержимого в текстовом редакторе. Ниже показан снимок экрана. Снимок экрана показывает, что файл содержит:
Пустые строки - строки 7, 12 и 13
Дополнительный столбец - столбец 8
Недостающие данные - строки 1, 4, 9 и 11
Частичные поля - последние 3 строки
filename = 'fixed_width_patients_subset_messy.txt';
Проверка и захват свойств файла фиксированной ширины
Текстовый файл фиксированной ширины содержит табличные данные, упорядоченные по расположению начала, количеству переменных, именам переменных и ширине переменных. Зафиксируйте эти свойства и тип данных, которые необходимо использовать для переменных.
DataStartLine = 2;
NumVariables = 7;
VariableNames = {'LastName','Gender','Age','Location','Height',...
'Weight','Smoker'};
VariableWidths = [ 10, 7, 4, 26, 7, ...
7, 7 ] ;
DataType = {'char','categorical','double','char','double',...
'double','logical'};Инициализировать FixedWidthImportOptions Объект и настройка свойств переменных
Инициализация FixedWidthImportOptions и настройте его свойства в соответствии со свойствами данных.
opts = fixedWidthImportOptions('NumVariables',NumVariables,... 'DataLines',DataStartLine,... 'VariableNames',VariableNames,... 'VariableWidths',VariableWidths,... 'VariableTypes',DataType);
Настроить EmptyLinesRule, Missing Rule, и ExtraColumnsRule
Прочтите пустые строки в данных, установив EmptyLineRule кому 'read'. Затем заполните отсутствующие экземпляры предопределенными значениями, установив значение MissingRule кому 'fill'. Наконец, чтобы игнорировать дополнительный столбец во время импорта, установите значение ExtraColumnsRule кому 'ignore'. Дополнительные сведения о свойствах и их значениях см. в документации для FixedWidthImportOptions.
opts.EmptyLineRule = 'read'; opts.MissingRule = 'fill'; opts.ExtraColumnsRule ='ignore';
Настроить PartialFieldRule
Частичные поля возникают, когда функция импорта достигает символа конца строки, прежде чем будет пройдена полная переменная ширина. Например, в этом предварительном просмотре последние три строки из файла fixed_width_patients_subset_messy.txt. Здесь в последней строке последнего столбца символ конца строки появляется через два места от начала поля, до достижения полной переменной ширины три.
Это вхождение частичного поля иногда может указывать на ошибку. Поэтому используйте PartialFieldRule чтобы решить, как обрабатывать эти данные. Чтобы сохранить данные частичного поля и преобразовать их в соответствующий тип данных, установите значение PartialFieldRule кому 'keep'. Для получения дополнительной информации о PartialFieldRule, см. документацию для FixedWidthImportOptions.
opts.PartialFieldRule = 'keep';Таблица импорта
Импорт таблицы с помощью readtable функции и FixedWidthImportOptions и предварительный просмотр данных.
T = readtable(filename,opts)
T=15×7 table
LastName Gender Age Location Height Weight Smoker
____________ ___________ ___ _____________________________ ______ ______ ______
{'Smith' } Male 38 {'County General Hospital' } 71 176 true
{'Johnson' } Male 43 {'VA Hospital' } 69 163 false
{'Williams'} Female 38 {'St. Mary's Medical Center'} NaN NaN false
{'Jones' } Female 40 {'VA Hospital' } 67 133 false
{'Brown' } Female 49 {'County General Hospital' } 64 119 false
{0×0 char } <undefined> NaN {0×0 char } NaN NaN false
{'Wilson' } Male 40 {'VA Hospital' } 68 180 false
{'Moore' } Male 28 {'St. Mary's Medical Center'} NaN 183 false
{'Taylor' } Female 31 {'County General Hospital' } 66 132 false
{'Anderson'} Female 45 {'County General Hospital' } 68 NaN false
{0×0 char } <undefined> NaN {0×0 char } NaN NaN false
{0×0 char } <undefined> NaN {0×0 char } NaN NaN false
{'White' } Male 39 {'VA Hospital' } 72 2 false
{'Harris' } Female 36 {'St. Mary's Medical Center'} 65 12 false
{'Martin' } Male 48 {'VA Hospital' } 71 181 true
Представлен в:
R2017a — FixedWidthImportOptions объект
R2018b — fixedWidthImportOptions функция