Настройки импорта возражают для текстовых файлов фиксированной ширины
Объект FixedWidthImportOptions позволяет вам задать, как MATLAB® импортирует табличные данные фиксированной ширины от текстовых файлов. Объект содержит свойства, которые управляют процессом импорта данных, включая обработку ошибок и недостающих данных.
Можно создать объект FixedWidthImportOptions с помощью любого функция fixedWidthImportOptions (описанный здесь) или функция detectImportOptions:
Используйте fixedWidthImportOptions, чтобы задать свойства импорта на основе ваших требований импорта.
Используйте detectImportOptions, чтобы обнаружить и заполнить свойства импорта на основе содержимого текстового файла фиксированной ширины, заданного в filename.
opts = detectImportOptions(filename)
opts = fixedWidthImportOptionsopts = fixedWidthImportOptions('NumVariables',numVars)opts = fixedWidthImportOptions(___,Name,Value)opts = fixedWidthImportOptions создает объект FixedWidthImportOptions с одной переменной.
opts = fixedWidthImportOptions('NumVariables',numVars)numVars.
Чтобы импортировать данные с помощью этого пользовательского объекта FixedWidthImportOptions, необходимо сначала настроить эти свойства: VariableNames, VariableWidths, VariableTypes и DataLine.
opts = fixedWidthImportOptions(___,Name,Value) задает дополнительные свойства для объекта FixedWidthImportOptions с помощью одного или нескольких аргументов в виде пар "имя-значение".
getvaropts | Получите переменные настройки импорта |
setvaropts | Установите переменные настройки импорта |
setvartype | Установите переменные типы данных |
предварительный просмотр | Предварительный просмотр восемь строк из файла с помощью настроек импорта |
Исследуйте файл форматированного текста фиксированной ширины, инициализируйте объект настроек импорта и используйте объект импортировать таблицу из текстового файла.
Загрузка и текстовый файл Фиксированной Ширины предварительного просмотра
Загрузите файл fixed_width_patients_subset_perfect.txt и предварительно просмотрите его содержимое в текстовом редакторе. Снимок экрана показывает, что файл содержит отформатированные данные фиксированной ширины.
filename = fullfile(matlabroot,'examples','matlab','fixed_width_patients_subset_perfect.txt');
Examine and Extract Properties файла Фиксированной Ширины
Текстовому файлу фиксированной ширины организовали табличные данные стартовое местоположение, количество переменных, имен переменных и переменных ширин. Получите эти свойства и желаемый тип данных для переменных.
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 = fullfile(matlabroot,'examples','matlab','fixed_width_patients_subset_messy.txt');
Examine and Capture Properties файла Фиксированной Ширины
Текстовому файлу фиксированной ширины организовали табличные данные пристальное местоположение, количество переменных, имен переменных и переменных ширин. Получите эти свойства и тип данных, который вы хотите использовать для переменных.
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'};
Initialize FixedWidthImportOptions Object and Set Up Variable Properties
Инициализируйте объект FixedWidthImportOptions и сконфигурируйте его свойства совпадать со свойствами данных.
opts = fixedWidthImportOptions('NumVariables',NumVariables,... 'DataLines',DataStartLine,... 'VariableNames',VariableNames,... 'VariableWidths',VariableWidths,... 'VariableTypes',DataType);
Настройте EmptyLinesRule, Missing Rule и ExtraColumnsRule
Считайте пустые строки в данных путем установки EmptyLineRule на 'read'. Затем, заполните недостающие экземпляры с предопределенными значениями путем установки MissingRule на 'fill'. Finally, чтобы проигнорировать дополнительный столбец во время импорта, установить ExtraColumnsRule на 'ignore'. Для получения дополнительной информации о свойствах и их значениях, см. документацию для FixedWidthImportOptions.
opts.EmptyLineRule = 'read'; opts.MissingRule = 'fill'; opts.ExtraColumnsRule ='ignore';
Настройте PartialFieldRule
Частичные поля происходят, когда функция импорта достигает символа конца строки, прежде чем полная переменная ширина будет пересечена. Например, в этом предварительном просмотре, последних трех строках из файла fixed_width_patients_subset_messy.txt 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
'' <undefined> NaN '' 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
'' <undefined> NaN '' NaN NaN false
'' <undefined> NaN '' 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