exponenta event banner

hydraulicToIsothermalLiquid

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

Описание

пример

newfile = hydraulicToIsothermalLiquid(oldfile,newpath) заменяет блоки из библиотеки «Фундамент > Гидравлика» в указанной системе блок-схем, oldfile, с эквивалентными блоками библиотеки Isothermal Liquid при попытке сохранить значения параметров и соединения между блоками, где это возможно. При наличии лицензии Simscape™ Fluids™ этот инструмент также заменяет блоки из библиотеки Fluids > Гидравлика (изотермическая) эквивалентными блоками из библиотек Fluids > Isothermal Liquid and Foundation > Isothermal Liquid. oldfile может быть моделью, подсистемой или библиотекой.

Библиотеки блоков изотермической жидкости структурированы аналогично другим областям жидкости, таким как термическая жидкость, и часто между блоками библиотек изотермической жидкости и гидравлической жидкости нет однозначного соответствия. Инструмент преобразования перечисляет все проблемы, возникшие при преобразовании в HTML-отчете, сохраняет отчет и преобразованную систему блок-схем в местоположении, указанном в newpathи возвращает имя преобразованной системы, newfile.

Оба newfile и newpath аргументы необязательны. Если опустить newpath аргумент, необходимо иметь разрешения на запись для текущей рабочей папки, так как инструмент сохраняет преобразованную систему и отчет в текущей папке.

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

Дополнительные сведения об особенностях модернизации и процессе см. в разделе Модернизация гидравлических моделей для использования изотермических жидких блоков.

пример

newfiles = hydraulicToIsothermalLiquid(oldfiles) преобразует список файлов, oldfiles, где каждый из файлов может быть моделью, подсистемой или библиотекой. При преобразовании списка файлов инструмент преобразования сохраняет связи между преобразованными файлами в списке. Этот синтаксис используется для преобразования моделей, содержащих ссылки или связи с другими библиотеками, моделями или подсистемами.

Если файл указан в oldfiles содержит блоки из библиотеки Foundation > Гидравлическая библиотека или Fluids > Гидравлическая библиотека (изотермическая), инструмент заменяет их эквивалентными блоками библиотеки Isothermal Liquid, добавляет _converted имя исходного файла и сохраняет каждый преобразованный файл в той же папке, что и исходный файл. Если файл не содержит гидравлических блоков и не ссылается на файл, указанный в oldfiles который содержит гидравлические блоки, инструмент оставляет этот файл без изменений. Инструмент возвращает список преобразованных имен файлов, newfilesи сохраняет отчет о преобразовании в расположении первого файла, указанного в oldfiles. Отчет о преобразовании, с именем HtoIL_report, перечисляет все проблемы, возникшие при преобразовании всех файлов в oldfiles список.

пример

newfiles = hydraulicToIsothermalLiquid(toppath) преобразует все модели, подсистемы и библиотеки в папке toppath и его подпапки, сохраняя при этом связи между преобразованными файлами в списке. Этот синтаксис используется для преобразования пользовательских библиотек и других моделей, содержащих ссылки или ссылки на другие библиотеки, модели или подсистемы.

Оба toppath и его подпапки должны находиться в пути MATLAB ®. Если модель, подсистема или библиотека содержат блоки из библиотеки Foundation > Гидравлическая библиотека или Fluids > Гидравлика (изотермическая), инструмент заменяет их эквивалентными блоками библиотеки Isothermal Liquid. _converted имя исходного файла и сохраняет каждый преобразованный файл в той же папке, что и исходный файл. Если файл не содержит гидравлических блоков и не ссылается на файл в toppath иерархия папок, содержащая гидравлические блоки, инструмент оставляет этот файл без изменений. Инструмент возвращает список преобразованных имен файлов, newfilesи сохраняет отчет о преобразовании с именем HtoIL_report, в toppath папка.

Примеры

свернуть все

В этом примере показано, как использовать инструмент преобразования в модели, содержащей гидравлические блоки. Инструмент создает преобразованную модель и отчет HTML. В следующем примере, «Очистить модель после преобразования», показано, как можно использовать HTML-отчет для просмотра и устранения проблем, возникающих при преобразовании.

Откройте пример модели гидравлического привода с аналоговым регулятором положения:

ssc_hydraulic_actuator_analog_control

В данном примере модель содержит блоки из гидравлических библиотек.

Преобразуйте модель, чтобы заменить блоки библиотеки гидравлики эквивалентными блоками из библиотеки изотермической жидкости:

hydraulicToIsothermalLiquid(bdroot)
ans =

  1×1 cell array

    {'ssc_hydraulic_actuator_analog_control_converted'}

Инструмент преобразования формирует новое имя модели путем добавления _converted до имени исходной модели. Потому что вы не указали newpath аргумент, инструмент преобразования сохраняет ssc_hydraulic_actuator_analog_control_converted модель в текущей папке.

Инструмент также создает HTML-отчет и сохраняет его в текущей папке. В отчете перечислены все проблемы, возникшие в процессе преобразования.

Просмотрите HTML-отчет и исправьте оставшиеся проблемы вручную. В этом примере преобразованная модель не содержит разорванных соединений или удаленных блоков, но инструмент преобразования создал несколько предупреждений о параметрах, требующих внимания пользователя. Дополнительные сведения см. в разделе Очистка модели после преобразования.

В предыдущем примере, «Преобразовать модель в использование изотермических жидких блоков», использовался инструмент преобразования на ssc_hydraulic_actuator_analog_control модель. Инструмент создал преобразованную модель, ssc_hydraulic_actuator_analog_control_convertedи HTML-отчет. В этом примере HTML-отчет используется для просмотра и устранения проблем, возникающих при преобразовании.

Список сообщений о преобразовании и рекомендуемые действия для их обработки см. в разделе Сообщения о преобразовании. Для каждого сообщения щелкните ссылку в столбце «Блок» отчета HTML, чтобы открыть соответствующую подсистему и выделить блок, который создал сообщение.

Первые два сообщения в отчете HTML относятся к двум камерам подсистемы гидравлического привода. В оригинальной модели каждая из этих камер была реализована блоком поступательного гидромеханического преобразователя. Инструмент преобразования заменил каждый из этих блоков блоком поступательного механического преобразователя (IL).

Блоки поступательного гидромеханического преобразователя в исходной модели имели параметр удельного теплового отношения, но в области изотермической жидкости все свойства жидкости определены в блоке изотермических свойств жидкости (IL).

Инструмент преобразования печатает значение параметра Specific heat ratio в исходном блоке для удобства: Original block had Specific heat ratio of 1.4. Set Air polytropic index to this value in an Isothermal Liquid Properties (IL) block.

Откройте блок «Свойства изотермической жидкости» (IL) в преобразованной модели и задайте для параметра «Политропический индекс воздуха» значение 1.4.

После обращения к первым двум сообщениям преобразования щелкните третью ссылку в столбце Block отчета HTML.

Инструмент выглядит под маской блока золотникового клапана и выделяет подсистему диафрагмы PA.

В исходной модели ssc_hydraulic_actuator_analog_control, посмотрите под маской блока золотникового клапана.

Диафрагма PA является одним из четырех блоков гидравлических диафрагм переменной площади, которые содержат клапан, и каждый из этих блоков имеет аналогичные сообщения преобразования. Процесс ручной очистки для каждого из этих блоков также аналогичен.

Дважды щелкните блок PA диафрагмы в исходной модели, чтобы увидеть его параметры.

Инструмент преобразования заменил каждый блок гидравлических диафрагм переменной площади блоком локального ограничения (IL). (Дополнительные сведения см. в разделе Обновление моделей.) Поскольку расположения портов для этих блоков различны, инструмент преобразования поместил каждый из блоков локального ограничения (IL) в подсистему для сохранения компоновки диаграммы.

Дважды щелкните подсистему диафрагмы PA в преобразованной модели, а затем блок диафрагмы PA внутри нее, чтобы увидеть ее параметры.

Первое сообщение преобразования для блока измерительной диафрагмы PA, Critical Reynolds number set to 150, проистекает из того факта, что исходный блок гидравлических диафрагм переменной площади имел параметр спецификации перехода Ламинара, установленный в Pressure ratio. Блок Local Restriction (IL) замены может задавать переход между ламинарным и турбулентным режимом только по критическому числу Рейнольдса, и инструмент преобразования устанавливает для параметра Critical Reynolds number значение по умолчанию, равное 150. Поскольку блок гидравлических диафрагм переменной площади в исходной модели использовал значение параметра отношения ламинарного расхода по умолчанию, равное 0.999, никаких действий не требуется.

Второе сообщение преобразования для блока измерительной диафрагмы PA, Maximum restriction area set to 1e10 m^2, проистекает из того факта, что исходный блок гидравлической диафрагмы с переменной площадью предполагал бесконечно большую максимальную площадь открытия, в то время как заменяющий блок локального ограничения (IL) с типом ограничения установлен в Variable, требуется значение параметра Maximum restriction area меньше inf.

Инструмент преобразования устанавливает для параметра Maximum restriction area в заменяющем блоке Local Restriction (IL) произвольное большое значение. 1e10 m^2. Никаких действий не требуется, но при необходимости можно скорректировать это значение в соответствии со спецификацией для модели.

Остальные сообщения преобразования относятся к трем другим отверстиям и также говорят, что изменение поведения не ожидается. Можно проверить эти три блока в исходной модели аналогичным образом, чтобы убедиться в отсутствии необходимости в каких-либо действиях.

На этом этапе после обращения ко всем сообщениям преобразования выполняется требуемая очистка модели. Можно сравнить результаты моделирования исходной и преобразованной модели, чтобы убедиться, что они совпадают. При необходимости можно также выполнить дальнейшую косметическую очистку. Например, можно переместить преобразованные блоки, для которых были внесены изменения в размещение портов, из подсистем и вручную перенаправить линии соединения.

Чтобы увидеть пример этой модели после преобразования и очистки, откройте пример модели гидравлического привода с аналоговым регулятором положения в области изотермической жидкости:

ssc_il_actuator_analog_control

Сравните эту модель с исходной, ssc_hydraulic_actuator_analog_controlи преобразованную модель, созданную инструментом, ssc_hydraulic_actuator_analog_control_converted.

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

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

Преобразовать modelWithLink модель вместе со ссылочной моделью путем указания их имен в списке файлов:

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

  2×1 cell array

    {'modelWithLink_converted' }
    {'referenceModel_converted'}

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

Обратите внимание, что преобразованная модель, modelWithLink_converted, теперь имеет изотермические жидкие блоки и что теперь он связан с преобразованной эталонной моделью, referenceModel_converted, которая также имеет изотермические жидкие блоки.

Инструмент также создает общий отчет о преобразовании с именем HtoIL_report и сохраняет его в расположении первого файла, указанного в oldfiles входной аргумент. В этом случае первым файлом является modelWithLinkпоэтому отчет сохраняется в той же папке, что и этот файл. В отчете перечислены проблемы преобразования для всех файлов в oldfiles список.

Просмотрите HTML-отчет и исправьте оставшиеся проблемы вручную.

Сравните результаты моделирования преобразованных моделей с исходными моделями, чтобы убедиться, что результаты соответствуют ожидаемым. В HTML-отчете изучите сообщения в разделах Удаленные блоки и Предупреждения параметров. Сообщения в этих разделах показывают, ожидаются ли изменения поведения, и предлагают соответствующие действия.

Убедившись, что преобразованные системы ведут себя так, как ожидалось, можно использовать hydraulicToIsothermalLiquidPostProcess для восстановления исходных имен файлов:

finalFiles = hydraulicToIsothermalLiquidPostProcess(convertedFiles)

Эта функция перезаписывает исходные файлы, удаляя _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-отчет с именем HtoIL_report.htmlи сохраняет его в topFolder. В отчете для каждого преобразованного файла перечисляются все проблемы, возникшие в процессе преобразования.

Просмотрите HTML-отчет и исправьте оставшиеся проблемы вручную.

Сравните результаты моделирования преобразованных моделей с исходными моделями, чтобы убедиться, что результаты соответствуют ожидаемым. В HTML-отчете изучите сообщения в разделах Удаленные блоки и Предупреждения параметров. Сообщения в этих разделах показывают, ожидаются ли изменения поведения, и предлагают соответствующие действия.

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

finalFiles = hydraulicToIsothermalLiquidPostProcess('topFolder')

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

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

свернуть все

Имя преобразуемой системы блок-схем, указанное как символьный вектор, строковый скаляр или дескриптор. oldfile может быть моделью, подсистемой или библиотекой. Он должен быть либо на пути MATLAB, либо загружен перед использованием инструмента преобразования. Имя файла может содержать абсолютное или относительное имя пути. Дополнительные сведения см. в разделе Указание имен файлов.

Пример: 'HydraulicActuator'

Пример: 'C:\Work\HydraulicActuator.slx'

Пример: 'subfolder\HydraulicActuator'

Расположение, в котором инструмент сохраняет преобразованную систему блок-схем и отчет, указанные как абсолютное или относительное имя пути.

Этот аргумент необязателен. Если опустить newpath , инструмент сохраняет преобразованную систему и отчет в текущей рабочей папке.

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

Список систем блок-схем для преобразования, заданных как одномерный массив ячеек имен файлов, с каждым именем файла, указанным как вектор символов или скаляр строки. Одномерный массив ячеек может быть горизонтальным или вертикальным. Имена файлов могут включать абсолютные или относительные имена путей. Каждый из этих файлов может быть моделью, подсистемой или библиотекой и должен быть либо на пути MATLAB, либо загружен до использования инструмента преобразования. При преобразовании списка файлов инструмент преобразования сохраняет связи между преобразованными файлами в списке. Инструмент сохраняет каждый преобразованный файл в той же папке, что и исходный, создает общий отчет о преобразовании, называет его HtoIL_reportи сохраняет его в расположении первого файла, указанного в oldfiles.

Пример: {'HydraulicActuatorLibrary' 'PumpLibrary'}

Пример: {'PumpLibrary';'C:\Work\MyPump.slx'}

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

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

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

свернуть все

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

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

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