Exponenta Banner
exponenta event banner

importFromFile

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

свернуть все на странице

Синтаксис

importedVars = importFromFile (sectionObj, имя файла)
importedVars = importFromFile (sectionObj, имя файла, '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', значение по умолчанию, которое предотвращает перезапись существующих словарных статей.

Примеры

свернуть все

Представление раздела «Конструкторские данные» словаря данных 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'

Представление раздела «Конструкторские данные» словаря данных 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'

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

Представление раздела «Конструкторские данные» словаря данных 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 для импорта определений перечисляемых типов данных в словарь данных. Если импортировать переменные перечисляемых типов данных в словарь данных, но не импортировать определения перечисляемых типов, словарь будет менее переносимым и может работать неправильно при использовании другим пользователем.

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

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

См. также

| |

Темы

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

Документация Simulink

Поддержка