importFromFile

Импортируйте переменные из MAT-файла или файла MATLAB в раздел словаря данных

Описание

пример

importedVars = importFromFile(sectionObj,fileName) импортирует переменные, определенные в MAT-файл или ФАЙЛ MATLAB fileName в раздел словаря данных sectionObj без перезаписи переменных, которые уже находятся в целевом разделе. Если какие-либо переменные уже находятся в целевом разделе, функция отображает предупреждение и список в Командном Окне MATLAB. Этот синтаксис возвращает список переменных, которые были успешно импортированы. Переменная считается успешно импортированной, только если importFromFile присваивает значение переменной соответствующей записи в целевом словаре данных.

пример

importedVars = importFromFile(sectionObj,fileName,'existingVarsAction',existAction) импортирует переменные, которые уже находятся в целевом разделе, выполнив указанное действие existAction. Для примера можно выбрать использование значений переменных в целевом файле, чтобы перезаписать соответствующие значения в целевом разделе.

пример

[importedVars,existingVars] = importFromFile(___) возвращает список переменных в целевом разделе, которые не были перезаписаны. Используйте этот синтаксис, если existingVarsAction установлено в 'none', значение по умолчанию, которое препятствует перезаписи существующих словарных статей.

Примеры

свернуть все

Представление раздела Design Data словаря данных myDictionary_ex_API.sldd с Simulink.data.dictionary.Section объект с именем dDataSectObj.

myDictionaryObj = Simulink.data.dictionary.open('myDictionary_ex_API.sldd');
dDataSectObj = getSection(myDictionaryObj,'Design Data');

Импортируйте все переменные, содержащиеся в файле myData_ex_API.m в словарь данных и возврат списка успешно импортированных переменных. Если какие-либо переменные уже в myDictionary_ex_API.sldd, importFromFile возвращает предупреждение и список затронутых переменных.

importFromFile(dDataSectObj,'myData_ex_API.m')
Warning: The following variables were not imported because
they already exist in the dictionary:
   fuelFlow 

ans = 

    'myFirstEntry'
    'mySecondEntry'
    'myThirdEntry'

Представление раздела Design Data словаря данных myDictionary_ex_API.sldd с Simulink.data.dictionary.Section объект с именем dDataSectObj.

myDictionaryObj = Simulink.data.dictionary.open('myDictionary_ex_API.sldd');
dDataSectObj = getSection(myDictionaryObj,'Design Data');

Импортируйте все переменные, содержащиеся в файле myData_ex_API.m в словарь данных перезаписать все переменные, которые уже находятся в словаре, и вернуть список успешно импортированных переменных.

importFromFile(dDataSectObj,'myData_ex_API.m','existingVarsAction','overwrite')
ans = 

    'fuelFlow'
    'myFirstEntry'
    'mySecondEntry'
    'myThirdEntry'

Возвращает список переменных, которые не импортируются из файла, поскольку они уже находятся в целевом словаре данных

Представление раздела Design Data словаря данных myDictionary_ex_API.sldd с Simulink.data.dictionary.Section объект с именем dDataSectObj.

myDictionaryObj = Simulink.data.dictionary.open('myDictionary_ex_API.sldd');
dDataSectObj = getSection(myDictionaryObj,'Design Data');

Импортируйте все переменные, содержащиеся в файле myData_ex_API.m в словарь данных. Задайте имена для выходных аргументов importFromFile для возврата имен успешно и неудачно импортированных переменных.

[importedVars,existingVars] = importFromFile(dDataSectObj,'myData_ex_API.m')
importedVars = 

    'myFirstEntry'
    'mySecondEntry'
    'myThirdEntry'


existingVars = 

    'fuelFlow'

importFromFile не импортирует переменную fuelflow поскольку он уже находится в целевом словаре данных.

Входные параметры

свернуть все

Раздел словаря целевых данных, заданный как Simulink.data.dictionary.Section объект. Прежде чем вы используете эту функцию, представьте целевое сечение с Simulink.data.dictionary.Section объект при помощи, для примера, getSection функция.

Имя целевого MAT или ФАЙЛА MATLAB, заданное как вектор символов. importFromFile автоматически подает расширение файла .mat если расширение не задано.

Пример: 'myFile.mat'

Пример: 'myFile.m'

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

Действие, которое требуется для существующих переменных словаря, заданное как 'none', 'overwrite', или 'error'.

Если вы задаете 'none', importFromFile пытается импортировать целевые переменные, но не импортирует и не вносит изменений в переменные, которые уже находятся в разделе словаря данных.

Если вы задаете 'overwrite', importFromFile импортирует все целевые переменные и перезаписывает все переменные, которые уже находятся в разделе словаря данных.

Если вы задаете 'error', importFromFile возвращает ошибку, без импорта каких-либо переменных, если какие-либо целевые переменные уже находятся в разделе словаря данных.

Пример: 'overwrite'

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

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

свернуть все

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

Имена целевых переменных, которые не были импортированы из-за их существования в целевом словаре данных, возвращаются как массив ячеек из векторов символов. existingVars имеет содержимое только в том случае, если existAction установлено в 'none', что также является значением по умолчанию. В этом случае importFromFile импортирует только переменные, которые еще не находятся в целевом словаре данных.

Совет

  • importFromFile может импортировать переменный MATLAB, созданные из перечисленных типов данных, но не может импортировать определения перечисленных типов. Используйте importEnumTypes функция для импорта определений перечисленных типов данных в словарь данных. Если вы импортируете переменные перечисленных типов данных в словарь данных, но не импортируете определения перечисленных типов, словарь является менее портативным и может функционировать неправильно, если используется кем-то другим.

Альтернативы

Можно использовать Model Explorer, чтобы импортировать переменные в словарь данных из файла. Дополнительные сведения см. в разделе Импорт данных в словарь из файла.

Введенный в R2015a
Для просмотра документации необходимо авторизоваться на сайте