hydraulicToIsothermalLiquid

打开示例模型“带模拟位置控制器的液压执行器”：

openExample('simscape/HydraulicActuatorWithAnalogControlHExample')

此示例模型包含来自 Hydraulic 库的模块。

转换模型以将 Hydraulic 库模块替换为 Isothermal Liquid 库中的等效模块：

hydraulicToIsothermalLiquid(bdroot)

ans =

  1×1 cell array

    {'HydraulicActuatorWithAnalogControlH_converted'}

转换工具通过在原始模型的名称之后附加 _converted 来形成新的模型名称。由于您未指定 newpath 参量，因此转换工具将 HydraulicActuatorWithAnalogControlH_converted 模型保存在当前文件夹中。

该工具还生成 HTML 报告并将其保存在当前文件夹中。该报告列出转换过程中遇到的任何问题。

查看 HTML 报告并手动修复其余问题。在此示例中，转换后的模型不包含断开的连接或删除的模块，但转换工具生成了多个需要注意的参数警告。有关详细信息，请参阅转换后清理模型。

HTML 报告中的前两条消息指向 Hydraulic Actuator 子系统的两个腔室。在原始模型中，这两个腔室中的每一个都是通过 Translational Hydro-Mechanical Converter 模块实现的。转换工具将每个模块替换为了 Translational Mechanical Converter (IL) 模块。

在原始模型中，Translational Hydro-Mechanical Converter 模块具有比热比参数，但在等温液体域中，所有流体属性都在 Isothermal Liquid Properties (IL) 模块中定义。

为方便起见，转换工具输出原始模块中比热比参数的值：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) 模块，并将其空气多变指数参数设置为 1.4。

处理完前两条转换消息后，点击 HTML 报告的模块列中的第三个链接。

工具在 Spool Valve 模块的封装下查找并突出显示 Orifice PA 子系统。

在原始模型 HydraulicActuatorWithAnalogControlH 中 Spool Valve 模块的封装下查找。

Orifice PA 是构成阀门的四个 Variable Area Hydraulic Orifice 模块之一，每个模块都具有相似的转换消息。每个模块的手动清理过程也相似。

双击原始模型中的 Orifice PA 模块以查看其参数。

转换工具将每个 Variable Area Hydraulic Orifice 模块替换为了一个 Local Restriction (IL) 模块。（有关详细信息，请参阅Block Substitutions for Foundation Library Hydraulic Blocks。）由于这些模块的端口位置不同，因此转换工具将每个 Local Restriction (IL) 模块放在了一个子系统中，以保留图布局。

双击转换后的模型中的 Orifice PA 子系统，然后双击其中的 Orifice PA 模块，以查看其参数。

Orifice PA 模块的第一条转换消息 Critical Reynolds number set to 150 出现的原因在于，原始 Variable Area Hydraulic Orifice 模块的层流转变设定参数设置为了压力比。Local Restriction (IL) 替换模块只能通过临界雷诺数来指定层流和湍流状态之间的转变，并且转换工具将临界雷诺数参数设置为其默认值 150。由于原始模型中的 Variable Area Hydraulic Orifice 模块使用默认的层流压力比参数值 0.999，因此无需执行任何操作。

Orifice PA 模块的第二条转换消息 Maximum restriction area set to 1e10 m^2 出现的原因在于，原始 Variable Area Hydraulic Orifice 模块假定最大开口面积无限大，而节流类型设置为变量的 Local Restriction (IL) 替换模块要求最大节流面积参数值小于 inf。

转换工具将 Local Restriction (IL) 替换模块中的最大节流面积参数设置为任意大值 1e10 m^2。您无需执行任何操作，但可以根据需要调整此值，使其与模型的数据表一致。

其余的转换消息指向的是其他三个孔口，并且还指示它们预期不会发生行为变化。您可以通过类似的方式检查原始模型中的这三个模块，以验证不需要执行任何操作。

此时，在您处理完所有转换消息后，所需的模型清理就完成了。您可以将原始模型的仿真结果与转换后的模型的仿真结果进行比较，以确保它们相同。您还可以根据需要进行进一步的外观清理。例如，您可以将端口位置已更改的转换后的模块移出子系统，并手动重新布置连接线。

要查看转换和清理后的此模型的示例，请打开 Isothermal Liquid 域中的示例模型“带模拟位置控制器的液压执行器”：

openExample('simscape/HydraulicActuatorWithAnalogControlExample')

将此模型与原始模型 HydraulicActuatorWithAnalogControlH 以及工具生成的转换后的模型 HydraulicActuatorWithAnalogControlH_converted 进行比较。

对于此示例，我们以名为 modelWithLink 的模型为例，该模型包含一些液压模块和一个引用模型 referenceModel，该引用模型也包含液压模块。referenceModel 位于 MATLAB 路径上的单独文件夹 Reference Systems 中。

通过在文件列表中指定模型名称，将 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 来形成新的模型名称，并将每个转换后的模型保存在与原始模型相同的文件夹中。

请注意，该工具未为 modelWithoutHydraulicBlocks 生成 _converted 文件，并且未在 convertedFiles 元胞数组中返回其名称，因为该模型不包含液压模块。

该工具还生成一个名为 HtoIL_report.html 的 HTML 报告，并将其保存在 topFolder 中。该报告针对每个转换后的文件列出转换过程中遇到的任何问题。

查看 HTML 报告并手动修复其余问题。

将转换后的模型的仿真结果与原始模型的仿真结果进行比较，以确保结果符合预期。在 HTML 报告中，调查删除的模块和参数警告部分中的消息。这两部分中的消息指示是否预期会发生行为变化，并建议适当的操作。

转换文件夹及其子文件夹中的所有文件时，转换工具会将这些文件中的所有库链接、模型引用和子系统引用更新为指向这些文件的 _converted 版本。如果满意于转换后的系统按预期运行，就可以使用 hydraulicToIsothermalLiquidPostProcess 函数来恢复原始文件名：

finalFiles = hydraulicToIsothermalLiquidPostProcess('topFolder')

该函数通过从文件名中和文件之间的链接中删除 _converted 后缀来覆盖原始文件。有关详细信息，请参阅 hydraulicToIsothermalLiquidPostProcess。