importFromFile

Класс: Simulink.data.dictionary.Section
Пакет: Simulink.data.dictionary

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

Синтаксис

importedVars = importFromFile(sectionObj,fileName)
importedVars = importFromFile(sectionObj,fileName,'existingVarsAction',existAction)
[importedVars,existingVars] = importFromFile(___)

Описание

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

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

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

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

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

Целевой словарь данных разделяет в виде 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 импорт только переменные, которые уже не находятся в целевом словаре данных.

Примеры

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

Представляйте раздел 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 потому что это уже находится в целевом словаре данных.

Советы

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

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

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

Представленный в R2015a