hydraulicToIsothermalLiquidPostProcess

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

Описание

пример

finalfiles = hydraulicToIsothermalLiquidPostProcess(convertedfiles) принимает список преобразованных файлов, convertedfiles, и удаляет _converted суффикс от имен файлов и от ссылок между файлами. Связи между файлами могут включать ссылки на пользовательский Simulink® библиотеки, модели-ссылки и ссылки подсистем. Используйте эту функцию после преобразования списка файлов или всех файлов в папке с помощью hydraulicToIsothermalLiquid инструмент преобразования, чтобы восстановить исходные имена файлов с сохранением ссылок между файлами.

hydraulicToIsothermalLiquidPostProcess функция перезаписывает исходные файлы, содержащие блоки Гидравлики из библиотек Foundation и Fluids, после выдачи предупреждения. Перед запуском рекомендуется проверить результаты преобразования и сохранить резервную копию исходных файлов hydraulicToIsothermalLiquidPostProcess.

После просмотра списка файлов в Командном окне и готовности к продолжению нажмите кнопку OK в диалоговом окне Предупреждение. Если закрыть диалоговое окно без нажатия кнопки OK, hydraulicToIsothermalLiquidPostProcess не обрабатывает файлы и возвращает пустой массив ячеек.

пример

finalfiles = hydraulicToIsothermalLiquidPostProcess(toppath) удаляет _converted суффикс от всех имен файлов в toppath папка и ее подпапки, находящиеся в MATLAB® путь, а также от ссылок между этими файлами. Используйте этот синтаксис после преобразования всех файлов в папку с помощью hydraulicToIsothermalLiquid инструмент преобразования, чтобы восстановить исходные имена файлов с сохранением ссылок между файлами.

Примеры

свернуть все

При преобразовании списка файлов или всех файлов с блоками Гидравлики в папке инструмент преобразования обновляет все пользовательские ссылки библиотеки Simulink, моделей-ссылок и ссылки подсистемы в этих файлах, чтобы указать на _converted версии этих файлов и возвраты список преобразованных файлов. Убедившись, что преобразованные системы ведут себя должным образом, можно использовать этот список в качестве входного параметра в hydraulicToIsothermalLiquidPostProcess функция для восстановления исходных имен файлов.

Рассмотрим модель, для целей этого примера с именем modelWithLink, который содержит некоторые блоки Гидравлики и ссылочную модель, referenceModel, который также содержит блоки Гидравлики. Чтобы сохранить ссылку, преобразуйте modelWithLink модель вместе со ссылочной моделью путем определения их имен в списке файлов:

convertedFiles = hydraulicToIsothermalLiquid({'modelWithLink' 'referenceModel'})
convertedFiles =

  2×1 cell array

    {'modelWithLink_converted' }
    {'referenceModel_converted'}

Для получения дополнительной информации о процессе преобразования смотрите Преобразование списка файлов.

Просмотрите отчет HTML и сравните результаты симуляции преобразованных моделей с исходными моделями, чтобы убедиться, что результаты соответствуют ожиданиям. Также рекомендуется, чтобы вы сохраняли резервные копии ваших исходных гидравлических моделей перед восстановлением исходных имен файлов, потому что функция постобработки перезаписывает исходные файлы.

Восстановите имена исходных файлов:

finalFiles = hydraulicToIsothermalLiquidPostProcess(convertedFiles)

Функция выдает предупреждение:

Warning: Existing files will be overwritten. Press OK in dialog box to proceed:
C:\Work\HtoIL\modelWithLink.slx
C:\Work\HtoIL\Reference Systems\referenceModel.slx 
> In hydraulicToIsothermalLiquidPostProcess_private
In hydraulicToIsothermalLiquidPostProcess (line 30) 

Проверьте список файлов, убедитесь в наличии резервных копий и нажмите кнопку OK.

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

finalFiles =

  2×1 cell array

    {'C:\Work\HtoIL\modelWithLink.slx'                   }
    {'C:\Work\HtoIL\Reference Systems\referenceModel.slx'} 

Эти файлы теперь имеют свои первоначальные имена, но они содержат изотермические жидкие блоки вместо блоков Гидравлики.

При преобразовании всех файлов в папке и ее подпапках инструмент преобразования обновляет все библиотечные ссылки, модели-ссылки и ссылки подсистемы в этих файлах, чтобы указать на _converted версии этих файлов. Убедившись, что преобразованные системы ведут себя должным образом, можно восстановить исходные имена файлов, предоставив имя и путь к верхней папке, используемой во время преобразования в качестве входного параметра в hydraulicToIsothermalLiquidPostProcess функция.

Рассмотрим папку, названную в этом примере topFolder для ясности, который содержит подпапки с пользовательскими библиотеками Simulink, ссылочными моделями и подсистемами, и модели, некоторые с блоками Гидравлики и некоторые без.

Перед преобразованием файлов убедитесь, что topFolder и все его подпапки находятся в пути MATLAB:

addpath(genpath('topFolder'))

Преобразуйте все файлы в topFolder и его подпапки:

convertedFiles = hydraulicToIsothermalLiquid('topFolder')
convertedFiles =

  5×1 cell array

    {'model_converted'             }
    {'custom_Library1_converted'   }
    {'custom_Library2_converted'   }
    {'referenceModel_converted'    }
    {'referenceSubsystem_converted'}

Инструмент преобразования формирует новое имя модели путем добавления _converted в имя исходной модели и сохраняет каждую преобразованную модель в той же папке, что и исходную.

Обратите внимание, что инструмент не сгенерировал _converted файл для modelWithoutHydraulicBlocks и не возвращал свое имя в convertedFiles массив ячеек, поскольку эта модель не содержит блоков Гидравлики.

Просмотрите отчет HTML и сравните результаты симуляции преобразованных моделей с исходными моделями, чтобы убедиться, что результаты соответствуют ожиданиям. Также рекомендуется, чтобы вы сохраняли резервные копии ваших исходных гидравлических моделей перед восстановлением исходных имен файлов, потому что функция постобработки перезаписывает исходные файлы.

Восстановите имена исходных файлов:

finalFiles = hydraulicToIsothermalLiquidPostProcess('topFolder')

Функция выдает предупреждение:

Warning: Existing files will be overwritten. Press OK in dialog box to proceed:
C:\Work\HtoIL\topFolder\model.slx
C:\Work\HtoIL\topFolder\Libraries\custom_Library1.slx
C:\Work\HtoIL\topFolder\Libraries\custom_Library2.slx
C:\Work\HtoIL\topFolder\Reference Systems\referenceModel.slx
C:\Work\HtoIL\topFolder\Reference Systems\referenceSubsystem.slx 
> In hydraulicToIsothermalLiquidPostProcess_private
In hydraulicToIsothermalLiquidPostProcess (line 30)

Проверьте список файлов, убедитесь в наличии резервных копий и нажмите кнопку OK.

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

finalFiles =

  5×1 cell array

    {'C:\Work\HtoIL\topFolder\model.slx'                               }
    {'C:\Work\HtoIL\topFolder\Libraries\custom_Library1.slx'           }
    {'C:\Work\HtoIL\topFolder\Libraries\custom_Library2.slx'           }
    {'C:\Work\HtoIL\topFolder\Reference Systems\referenceModel.slx'    }
    {'C:\Work\HtoIL\topFolder\Reference Systems\referenceSubsystem.slx'} 

Вот как структура файла в topFolder следит за постобработкой:

Все пользовательские библиотеки Simulink, модели-ссылки и подсистемы, а также модели, которые были изменены во время преобразования, теперь имеют свои первоначальные имена, но они содержат изотермические жидкие блоки вместо блоков Гидравлики.

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

свернуть все

Имена преобразованных моделей, подсистем или библиотек, заданные как одномерный массив ячеек столбцов с именами файлов. Имена файлов могут включать абсолютные или относительные имена путей. В большинстве случаев этот входной параметр является списком преобразованных файлов, возвращенных hydraulicToIsothermalLiquid функция. Инструмент преобразования добавляет _converted на имя исходного файла. hydraulicToIsothermalLiquidPostProcess удаляет _converted суффикс из имен файлов и из библиотечных ссылок, моделей-ссылок и ссылок на подсистемы в преобразуемых файлах, которые указывают на другие преобразованные файлы в списке.

Пример: {'HydraulicActuatorLibrary_converted';'PumpLibrary_converted'}

Пример: {'PumpLibrary_converted';'C:\Work\MyPump_converted.slx'}

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

Пример: 'C:\Work\MyLibraries'

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

свернуть все

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

Введенный в R2021a