fixedWidthImportOptions
Объект настроек импорта для текстовых файлов фиксированной ширины
Описание
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
Импорт данных Messy из форматированного текстового файла фиксированной ширины
Задайте объект настроек импорта, чтобы импортировать грязные данные из форматированного текстового файла фиксированной ширины. Сконфигурируйте объект, чтобы обработать грязные данные и использовать его для импорта таблицы.
Загрузка и предварительный просмотр текстового файла фиксированной ширины
Загрузите файл 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функция