La traduction de cette page n'est pas à jour. Cliquez ici pour voir la dernière version en anglais.
hydraulicToIsothermalLiquid
Mise à jour du système de schémas blocs hydrauliques pour utiliser des blocs Isothermal Liquid
Syntaxe
Description
newfile = hydraulicToIsothermalLiquid(oldfile,newpath)oldfile, par des blocs équivalents de la bibliothèque Isothermal Liquid, tout en tentant de conserver autant que possible les valeurs des paramètres et connexions qui relient les blocs. Si vous disposez d'une licence Simscape™ Fluids™, cet outil remplace également les blocs de la bibliothèque Fluids > Hydraulics (Isothermal) par des blocs équivalents des bibliothèques Fluids > Isothermal Liquid et Foundation > Isothermal Liquid. oldfile peut être un modèle, un sous-système ou une bibliothèque.
Les bibliothèques de blocs Isothermal Liquid présentent la même structure que les autres domaines de fluides, du type Thermal Liquid. En outre, bien souvent, il n’existe pas de correspondance directe entre les blocs des bibliothèques Isothermal Liquid et Hydraulic. L'outil de conversion répertorie tous les problèmes rencontrés lors de la conversion en rapport HTML, enregistre le rapport et le système de schémas blocs converti à l'emplacement spécifié par newpath, et renvoie le nom du système converti, newfile.
Les arguments newfile et newpath sont facultatifs. Si vous omettez l'argument newpath, vous devez disposer de droits en écriture sur votre dossier de travail actuel. En effet, l'outil enregistre alors le système converti et le rapport dans le dossier actuel.
Le nouveau fichier s’appuie sur la dernière version enregistrée de l'ancien fichier. Autrement dit, si vous modifiez le système de schémas blocs d'origine et que vous ne l'enregistrez pas avant d'utiliser l'outil de conversion, les modifications ne sont pas prises en compte dans le nouveau système. Il est recommandé également de veiller à ce que la compilation du système de schémas blocs d'origine s’effectue sans problème avant de recourir à l'outil de conversion.
Pour plus d’informations sur les questions et le processus de mise à jour, consultez Mettre à jour des modèles hydrauliques pour utiliser des blocs Isothermal Liquid.
newfiles = hydraulicToIsothermalLiquid(oldfiles)oldfiles, dans laquelle chaque fichier peut être un modèle, un sous-système ou une bibliothèque. Lorsque vous convertissez une liste de fichiers, l’outil de conversion conserve les liens qui unissent les fichiers convertis dans la liste. Utilisez cette syntaxe pour convertir des modèles contenant des références ou des liens vers d’autres bibliothèques, modèles ou sous-systèmes.
Si un fichier figurant dans oldfiles contient des blocs issus de la bibliothèque Foundation > Hydraulic ou Fluids > Hydraulics (Isothermal), l'outil les remplace par des blocs équivalents de la bibliothèque Isothermal Liquid, ajoute _converted au nom du fichier d'origine et enregistre chaque fichier converti dans le même dossier que le fichier d'origine. Si un fichier ne contient pas de blocs Hydraulic et ne fait pas référence à un fichier de oldfiles contenant lui-même ce type de blocs, l’outil n’apporte aucune modification à ce fichier. L’outil renvoie la liste des noms de fichiers convertis, newfiles, et enregistre le rapport de conversion à l’emplacement du premier fichier figurant dans oldfiles. Le rapport de conversion, intitulé HtoIL_report, répertorie tous les problèmes rencontrés au cours de la conversion de l’ensemble des fichiers de la liste oldfiles.
newfiles = hydraulicToIsothermalLiquid(toppath)toppath et de ses sous-dossiers, tout en conservant les liens qui existent entre les fichiers convertis dans la liste. Utilisez cette syntaxe pour convertir des bibliothèques personnalisées et autres modèles contenant des références ou des liens vers d’autres bibliothèques, modèles ou sous-systèmes.
toppath et ses sous-dossiers doivent se trouver dans le répertoire MATLAB®. Si un modèle, un sous-système ou une bibliothèque contiennent des blocs issus de la bibliothèque Foundation > Hydraulic ou Fluids > Hydraulics (Isothermal), l'outil les remplace par des blocs équivalents de la bibliothèque Isothermal Liquid, ajoute _converted au nom du fichier d'origine et enregistre chaque fichier converti dans le même dossier que le fichier d'origine. Si un fichier ne contient pas de blocs Hydraulic et ne fait pas référence à un fichier de la hiérarchie de dossiers toppath contenant ce type de blocs, l’outil n’apporte aucune modification à ce fichier. L’outil renvoie la liste des noms de fichiers convertis, newfiles, et enregistre le rapport de conversion, intitulé HtoIL_report, dans le dossier toppath.
newfiles = hydraulicToIsothermalLiquid(___,oldcustomblocks,newcustomblocks)oldcustomblocks par les blocs Isothermal Liquid correspondants, newcustomblocks. Pour toutes les combinaisons d'arguments d'entrée des syntaxes précédentes, spécifiez deux cell arrays de noms de blocs personnalisés après tous les autres arguments d'entrée. Utilisez cette syntaxe pour convertir des modèles contenant des blocs Hydraulic personnalisés, tels que des blocs de bibliothèque masqués ou des blocs personnalisés écrits en langage Simscape.
Avant de pouvoir utiliser cette syntaxe, préparez la version Isothermal Liquid équivalente des blocs personnalisés :
Dans le cas de blocs et de sous-systèmes de bibliothèques personnalisées qui contiennent des blocs issus de la bibliothèque Foundation > Hydraulic ou de la bibliothèque Fluids > Hydraulics (Isothermal), exécutez l'outil de conversion sur ces bibliothèques personnalisées.
Dans le cas de blocs Hydraulic personnalisés écrits en langage Simscape, créez manuellement des versions équivalentes de ces blocs qui utilisent le domaine Isothermal Liquid.
Si, au cours de la conversion, l'outil rencontre un bloc figurant dans oldcustomblocks, il remplace ce bloc par son équivalent dans newcustomblocks. Les deux cell arrays, oldcustomblocks et newcustomblocks, doivent comporter le même nombre d'éléments, chaque élément correspondant à un nom de bloc. Les blocs respectifs répertoriés dans chaque tableau doivent comporter le même nombre de ports, l'ordre des ports correspondants et les mêmes noms de paramètres programmatiques.
Exemples
Cet exemple indique comment utiliser l'outil de conversion sur un modèle contenant des blocs Hydraulic. L’outil génère un modèle converti et un rapport au format HTML. L'exemple suivant, Nettoyer un modèle après conversion, indique comment vous pouvez utiliser le rapport au format HTML pour passer en revue et résoudre les problèmes rencontrés par l'outil de conversion.
Ouvrez l’actionneur hydraulique avec un exemple de modèle de contrôleur de position analogique :
openExample('simscape/HydraulicActuatorWithAnalogControlHExample')
Cet exemple de modèle contient des blocs issus des bibliothèques Hydraulic.
Convertissez le modèle pour remplacer les blocs de la bibliothèque Hydraulic par les blocs équivalents de la bibliothèque Isothermal Liquid :
hydraulicToIsothermalLiquid(bdroot)
ans =
1×1 cell array
{'HydraulicActuatorWithAnalogControlH_converted'}
L’outil de conversion génère le nouveau nom de modèle en ajoutant _converted au nom du modèle d’origine. Étant donné que vous n'avez pas spécifié l'argument newpath, l'outil de conversion enregistre le modèle HydraulicActuatorWithAnalogControlH_converted dans le dossier actuel.
L’outil génère également un rapport au format HTML et l’enregistre dans le dossier actuel. Le rapport répertorie les éventuels problèmes rencontrés lors du processus de conversion.
Passez en revue le rapport HTML et résolvez manuellement les problèmes restants. Dans cet exemple, le modèle converti ne contient ni connexions rompues, ni blocs supprimés. Pour autant, l'outil de conversion a généré plusieurs avertissements relatifs aux paramètres qui requièrent votre attention. Pour plus d’informations, consultez la rubrique Nettoyer un modèle après conversion.
Dans l’exemple précédent, Convertir un modèle pour utiliser des blocs Isothermal Liquid, vous avez utilisé l’outil de conversion sur le modèle HydraulicActuatorWithAnalogControlH. L’outil a généré un modèle converti, HydraulicActuatorWithAnalogControlH_converted, ainsi qu’un rapport au format HTML. Dans cet exemple, vous allez utiliser le rapport au format HTML pour passer en revue et résoudre les problèmes rencontrés par l'outil de conversion.
Pour obtenir la liste des messages générés lors de la conversion, ainsi que des suggestions concernant la marche à suivre pour résoudre ces problèmes, consultez Conversion Messages After Converting Hydraulic to Isothermal Liquid Models. Pour chaque message, si vous cliquez sur un lien de la colonne Block du rapport HTML, le sous-système correspondant s’ouvre comme il se doit et le système met en surbrillance le bloc à l’origine du message.
Les deux premiers messages du rapport HTML font référence aux deux chambres du sous-système Hydraulic Actuator. Dans le modèle d’origine, chacune de ces chambres a été implémentée par un bloc Translational Hydro-Mechanical Converter. L’outil de conversion a remplacé chacun de ces blocs par un bloc Translational Mechanical Converter (IL).
Les blocs Translational Hydro-Mechanical Converter du modèle d’origine comportaient un paramètre Specific heat ratio. En revanche, dans le domaine Isothermal Liquid, toutes les propriétés du fluide sont définies dans le bloc Isothermal Liquid Properties (IL).
Pour vous faciliter la tâche, l’outil de conversion imprime la valeur du paramètre Specific heat ratio dans le bloc d’origine : Original block had Specific heat ratio of 1.4. Set Air polytropic index to this value in an Isothermal Liquid Properties (IL) block.
Ouvrez le bloc Isothermal Liquid Properties (IL) dans le modèle converti et définissez son paramètre Air polytropic index sur 1.4.
Après avoir traité les deux premiers messages générés lors de la conversion, cliquez sur le troisième lien dans la colonne Block du rapport HTML.
L'outil regarde sous le masque du bloc Spool Valve et met en surbrillance le sous-système Orifice PA.
Dans le modèle d’origine, HydraulicActuatorWithAnalogControlH, regardez sous le masque du bloc Spool Valve.
Orifice PA est l’un des quatre blocs Variable Area Hydraulic Orifice qui comprend la vanne. Chacun de ces blocs présente des messages de conversion similaires. Le processus de nettoyage manuel de chacun de ces blocs est lui aussi similaire.
Double-cliquez sur le bloc Orifice PA dans le modèle d’origine afin de pouvoir consulter ses paramètres.
L’outil de conversion a remplacé chaque bloc Variable Area Hydraulic Orifice par un bloc Local Restriction (IL). (Pour plus d’informations, consultez la rubrique Block Substitutions for Foundation Library Hydraulic Blocks.) Etant donné que les emplacements des ports de ces blocs sont différents, l’outil de conversion a placé chacun de ces blocs Local Restriction (IL) dans un sous-système afin de préserver l’agencement du diagramme.
Double-cliquez sur le sous-système Orifice PA dans le modèle converti, puis sur le bloc Orifice PA qu’il contient afin de pouvoir consulter ses paramètres.
Le premier message de conversion du bloc Orifice PA, Critical Reynolds number set to 150, est dû au fait que le bloc Variable Area Hydraulic Orifice d’origine comporte un paramètre Laminar transition specification défini sur Pressure ratio. Le bloc Local Restriction (IL) de remplacement peut spécifier la transition entre le régime laminaire et le régime turbulent uniquement par le nombre de Reynolds critique. L'outil de conversion définit le paramètre Critical Reynolds number sur sa valeur par défaut, à savoir 150. Étant donné que le bloc Variable Area Hydraulic Orifice du modèle d’origine a utilisé la valeur par défaut du paramètre Laminar flow pressure ratio, à savoir 0.999, aucune action n’est nécessaire.
Le deuxième message de conversion du bloc Orifice PA, Maximum restriction area set to 1e10 m^2, est dû au fait que le bloc Variable Area Hydraulic Orifice d’origine s’est appuyé sur le postulat d’une surface d'ouverture maximale infinie, tandis que le bloc Local Restriction (IL) de remplacement, dont le paramètre Restriction type est défini sur Variable, exige une valeur de paramètre Maximum restriction area inférieure à inf.
L’outil de conversion définit le paramètre Maximum restriction area du bloc Local Restriction (IL) de remplacement sur une valeur arbitraire, 1e10 m^2. Aucune action n’est nécessaire, mais vous pouvez ajuster cette valeur afin qu’elle corresponde à la fiche technique de votre modèle si vous le souhaitez.
Les autres messages de conversion font référence aux trois autres orifices et indiquent également que le changement de comportement n'est pas attendu. Vous pouvez inspecter ces trois blocs dans le modèle d’origine de la même manière afin de vérifier qu’aucune action n’est nécessaire.
Une fois que vous vous êtes occupé de tous les messages de conversion, le nettoyage du modèle qui était nécessaire est terminé. Vous pouvez comparer les résultats des simulations du modèle d’origine et du modèle converti afin de vérifier qu’ils sont identiques. Vous pouvez également procéder à un nettoyage cosmétique supplémentaire si vous le souhaitez. Par exemple, vous pouvez déplacer les blocs convertis dont l'emplacement des ports a été modifié en dehors des sous-systèmes et réacheminer manuellement les lignes de connexion.
Pour consulter un exemple de ce modèle après conversion et nettoyage, ouvrez l’actionneur hydraulique avec un exemple de modèle de contrôleur de position analogique dans le domaine Isothermal Liquid :
openExample('simscape/HydraulicActuatorWithAnalogControlExample')
Comparez ce modèle au modèle d’origine, HydraulicActuatorWithAnalogControlH, et au modèle converti généré par l’outil, HydraulicActuatorWithAnalogControlH_converted.
Cet exemple indique la manière dont vous pouvez convertir des modèles, ainsi que les modèles, sous-systèmes et bibliothèques liées auxquels ils font référence, tout en conservant les liens entre les fichiers convertis.
Pour les besoins de cet exemple, prenons un modèle, nommé modelWithLink, qui contient quelques blocs Hydraulic et un modèle référencé, referenceModel, qui contient lui aussi des blocs Hydraulic. referenceModel se trouve dans un dossier distinct, Reference Systems, lui même situé dans le répertoire MATLAB.
Convertissez le modèle modelWithLink avec le modèle auquel il fait référence en spécifiant leurs noms dans une liste de fichiers :
convertedFiles = hydraulicToIsothermalLiquid({'modelWithLink' 'referenceModel'})
convertedFiles =
2×1 cell array
{'modelWithLink_converted' }
{'referenceModel_converted'}
L’outil de conversion génère le nouveau nom de modèle en ajoutant _converted au nom du modèle d’origine. Il enregistre ensuite chaque modèle converti dans le même dossier que le modèle d’origine.
Remarque : le modèle converti, modelWithLink_converted, comporte désormais des blocs Isothermal Liquid et est lié au modèle de référence converti, referenceModel_converted, qui comporte lui aussi des blocs Isothermal Liquid.
L’outil génère également un rapport de conversion commun intitulé HtoIL_report, qu’il enregistre à l’emplacement du premier fichier figurant dans l’argument d’entrée oldfiles. Dans ce cas, le premier fichier est modelWithLink. Par conséquent, le rapport est enregistré dans le même dossier que ce fichier. Le rapport répertorie les problèmes de conversion de l’ensemble des fichiers de la liste oldfiles.
Passez en revue le rapport HTML et résolvez manuellement les problèmes restants.
Comparez les résultats de la simulation des modèles convertis avec les modèles d’origine afin de vérifier que les résultats répondent à vos attentes. Dans le rapport HTML, examinez les messages des sections Removed Blocks et Parameter Warnings. Les messages de ces sections indiquent si des changements de comportement sont attendus et suggèrent les actions à prendre.
Une fois que vous êtes satisfait du comportement attendu des systèmes convertis, vous pouvez utiliser la fonction hydraulicToIsothermalLiquidPostProcess pour restaurer les noms de fichier d’origine :
finalFiles = hydraulicToIsothermalLiquidPostProcess(convertedFiles)
Cette fonction écrase les fichiers d’origine en supprimant le suffixe _converted de leur nom et des liens entre les fichiers. Pour plus d’informations, consultez la rubrique hydraulicToIsothermalLiquidPostProcess.
Cet exemple indique la manière dont vous pouvez spécifier un chemin d'accès vers le dossier de niveau supérieur. Ainsi, l’outil de conversion traitera l’ensemble des fichiers de ce dossier et de ses sous-dossiers. L’outil convertit l’ensemble des fichiers qui contiennent des blocs Hydraulic, tout en conservant les liens qui les unissent. Il renvoie ensuite la liste des fichiers convertis. Si un fichier ne contient pas de blocs Hydraulic, l'outil ne lui apporte aucune modification.
Prenons un dossier, intitulé topFolder dans cet exemple pour plus de clarté. Ce dossier contient des sous-dossiers avec des bibliothèques Simulink® personnalisées, des modèles et sous-systèmes référencés, et des modèles, certains avec des blocs Hydraulic et d'autres sans.
Avant de convertir les fichiers, veillez à ce que topFolder et tous ses sous-dossiers se trouvent dans le répertoire MATLAB :
addpath(genpath('topFolder'))
Convertissez tous les fichiers du dossier topFolder et de ses sous-dossiers :
convertedFiles = hydraulicToIsothermalLiquid('topFolder')
convertedFiles =
5×1 cell array
{'model_converted' }
{'custom_Library1_converted' }
{'custom_Library2_converted' }
{'referenceModel_converted' }
{'referenceSubsystem_converted'}
L’outil de conversion génère le nouveau nom de modèle en ajoutant _converted au nom du modèle d’origine. Il enregistre ensuite chaque modèle converti dans le même dossier que le modèle d’origine.
Remarque : l’outil n’a pas généré de fichier _converted pour modelWithoutHydraulicBlocks et n’a pas renvoyé son nom dans le cell array convertedFiles car ce modèle ne contient pas de blocs Hydraulic.
L’outil génère également un rapport au format HTML, intitulé HtoIL_report.html, et l’enregistre dans le dossier topFolder. Pour chaque fichier converti, ce rapport répertorie les éventuels problèmes rencontrés lors du processus de conversion.
Passez en revue le rapport HTML et résolvez manuellement les problèmes restants.
Comparez les résultats de la simulation des modèles convertis avec les modèles d’origine afin de vérifier que les résultats répondent à vos attentes. Dans le rapport HTML, examinez les messages des sections Removed Blocks et Parameter Warnings. Les messages de ces sections indiquent si des changements de comportement sont attendus et suggèrent les actions à prendre.
Lorsque vous convertissez tous les fichiers d’un dossier et de ses sous-dossiers, l’outil de conversion met à jour l’ensemble des liens de bibliothèque, les références aux modèles et les références aux sous-systèmes qui figurent dans ces fichiers afin de pointer vers les versions _converted de ces fichiers. Une fois que vous êtes satisfait du comportement attendu des systèmes convertis, vous pouvez utiliser la fonction hydraulicToIsothermalLiquidPostProcess pour restaurer les noms de fichier d’origine :
finalFiles = hydraulicToIsothermalLiquidPostProcess('topFolder')
Cette fonction écrase les fichiers d’origine en supprimant le suffixe _converted de leur nom et des liens entre les fichiers. Pour plus d’informations, consultez la rubrique hydraulicToIsothermalLiquidPostProcess.
