hydraulicToIsothermalLiquid

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

Описание

пример

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

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

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

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

Для получения дополнительной информации о факторах обновления и процессе, смотрите Обновление Гидравлических Моделей Для Использования Изотермических Жидких Блоков.

пример

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

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

пример

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

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

Примеры

свернуть все

В этом примере показано, как использовать инструмент преобразования для модели, содержащей Блоки Гидравлики. Инструмент генерирует преобразованную модель и HTML. В следующем примере, Clean Up Model After Conversion, показано, как можно использовать 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 используется для просмотра и устранения проблем, с которыми сталкивается инструмент преобразования.

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

Первые два сообщения в отчете HTML относятся к двум ёмкостям подсистемы Hydraulic Actuator. В исходной модели каждая из этих ёмкостей была реализована блоком Translational Hydro-Mechanical Converter. Инструмент преобразования заменил каждый из этих блоков на Translational Mechanical Converter (IL) блок.

Блоки Translational Hydro-Mechanical Converter в исходной модели имели параметр Specific heat ratio, но в изотермической области жидкости все свойства жидкости заданы в блоке Isothermal Liquid Properties (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.

Откройте блок Isothermal Liquid Properties (IL) в преобразованной модели и установите его параметр Air polytropic index равным 1.4.

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

Инструмент смотрит под маской блока Spool Valve и подсвечивает Orifice PA подсистему.

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

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

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

Инструмент преобразования заменил каждый Variable Area Hydraulic Orifice блок на Local Restriction (IL) блок. (Для получения дополнительной информации см. «Обновление моделей».) Поскольку местоположения портов для этих блоков различны, инструмент преобразования поместил каждый из блоков Local Restriction (IL) в подсистему, чтобы сохранить размещение схемы.

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

Первое сообщение преобразования для блока Orifice PA, Critical Reynolds number set to 150, вытекает из того, что исходный блок Variable Area Hydraulic Orifice имел параметр Laminar transition specification, установленный на Pressure ratio. Блок Local Restriction (IL) замены может задать переход между ламинарным и турбулентным режимами только по критическому числу Рейнольдса, и инструмент преобразования устанавливает параметр Critical Reynolds number на его значение по умолчанию 150. Потому что блок Variable Area Hydraulic Orifice в исходной модели использовал значение параметров Laminar flow pressure ratio по умолчанию 0.999, никакое действие не требуется.

Второе сообщение преобразования для блока Orifice PA, Maximum restriction area set to 1e10 m^2, вытекает из того факта, что исходный Variable Area Hydraulic Orifice блок принял бесконечно большую максимальную площадь открытия, в то время как замена Local Restriction (IL) блоком, с Restriction type установленной на 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 исследуйте сообщения в разделах Removed Blocks и Parameter Warnings. Сообщения в этих разделах указывают, ожидаются ли изменения поведения, и предлагают соответствующие действия.

Убедившись, что преобразованные системы ведут себя должным образом, можно использовать 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 исследуйте сообщения в разделах Removed Blocks и Parameter Warnings. Сообщения в этих разделах указывают, ожидаются ли изменения поведения, и предлагают соответствующие действия.

При преобразовании всех файлов в папке и ее подпапках инструмент преобразования обновляет все библиотечные ссылки, модели-ссылки и ссылки подсистемы в этих файлах, чтобы указать на _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