hydraulicToIsothermalLiquid

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

Описание

пример

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

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

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

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

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

пример

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

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

пример

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

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

newfiles = hydraulicToIsothermalLiquid(___,oldcustomblocks,newcustomblocks) заменяет пользовательские блоки Гидравлики, перечисленные в oldcustomblocks с соответствующими изотермическими жидкими блоками, newcustomblocks. Для любой из комбинаций входных аргументов в предыдущих синтаксисах задайте два массива ячеек имен пользовательского блока после всех других входных параметров. Используйте этот синтаксис, чтобы преобразовать модели, содержащие настроенные блоки Гидравлики, такие как замаскированные библиотечные блоки или пользовательские блоки, написанные в языке Simscape.

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

  • Для пользовательских библиотечных блоков и подсистем, которые содержат блоки из библиотеки Foundation> Hydraulic или библиотеки Fluids> Hydraulics (Isothermal), запустите инструмент преобразования на этих пользовательских библиотеках.

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

Если во время преобразования инструмент сталкивается с блоком, перечисленным в oldcustomblocks, затем замены инструмента, которые блокируются с эквивалентным блоком, перечисленным в newcustomblocks. Эти два массива ячеек, oldcustomblocks и newcustomblocks, должен иметь то же число элементов, каждый элемент, соответствующий имени блока. Аналогичные блоки, перечисленные в каждом массиве, должны иметь то же количество портов, порядка соответствующего порта и тех же программируемых названий параметра.

Примеры

свернуть все

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

Откройте Гидравлический Привод с Аналоговым Контроллером Положения модель в качестве примера:

ssc_hydraulic_actuator_analog_control

Эта модель в качестве примера содержит блоки из библиотек Hydraulic.

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

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

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

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

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

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

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

свернуть все

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

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

Введенный в R2020a