exponenta event banner

hydraulicToIsothermalLiquidPostProcess

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

Описание

пример

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

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

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

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

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

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)

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

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

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