hydraulicToIsothermalLiquid
Aktualisieren des Hydraulikblock-Diagrammsystems, sodass dieses „Isothermal Liquid“-Blöcke verwenden kann
Syntax
Beschreibung
newfile = hydraulicToIsothermalLiquid(oldfile,newpath)oldfile, durch entsprechende Blöcke aus der Bibliothek „Isothermal Liquid“. Dabei wird versucht, die Parameterwerte und Verbindungen zwischen den Blöcken nach Möglichkeit beizubehalten. Wenn Sie über eine Simscape™ Fluids™-Lizenz verfügen, ersetzt dieses Tool auch Blöcke aus der Bibliothek „Fluids > Hydraulics (Isothermal)“ durch entsprechende Blöcke aus den Bibliotheken „Fluids > Isothermal Liquid“ und „Foundation > Isothermal Liquid“. oldfile kann ein Modell, ein Subsystem oder eine Bibliothek sein.
Die Bibliotheken für „Isothermal Liquid“-Blöcke sind ähnlich strukturiert wie andere fluidbezogene Domänen, z. B. „Thermal Liquid“, und häufig gibt es keine direkte Entsprechung zwischen den Blöcken der Bibliotheken „Isothermal Liquid“ und „Hydraulic“. Das Konvertierungstool führt alle während der Konvertierung aufgetretenen Probleme in einem HTML-Bericht auf, speichert sowohl den Bericht als auch das konvertierte Blockdiagrammsystem an dem von newpath festgelegten Speicherort und gibt den Namen des konvertierten Systems, newfile, zurück.
Die Argumente newfile und newpath sind optional. Wenn Sie das Argument newpath weglassen, müssen Sie über Schreibberechtigungen für Ihren aktuellen Arbeitsordner verfügen, da das Tool dann das konvertierte System und den Bericht im aktuellen Ordner speichert.
Die neue Datei basiert auf der zuletzt gespeicherten Version der alten Datei. Wenn Sie also das ursprüngliche Blockdiagrammsystem ändern und es vor Verwendung des Konvertierungstools nicht speichern, werden die Änderungen im neuen System nicht übernommen. Vor Verwendung des Konvertierungstools sollte außerdem sichergestellt werden, dass sich das ursprüngliche Blockdiagrammsystem problemlos kompilieren lässt.
Weitere Informationen dazu, was bei Aktualisierungen zu beachten ist und wie Sie diese durchführen, finden Sie unter Aktualisieren von Hydraulikmodellen, sodass diese „Isothermal Liquid“-Blöcke verwenden können.
newfiles = hydraulicToIsothermalLiquid(oldfiles)oldfiles, in der jede Datei ein Modell, ein Subsystem oder eine Bibliothek sein kann. Wenn Sie eine Dateiliste konvertieren, behält das Konvertierungstool die Verknüpfungen zwischen den konvertierten Dateien in der Liste bei. Verwenden Sie diese Syntax, um Modelle zu konvertieren, die Verweise auf oder Links zu anderen Bibliotheken, Modellen oder Subsystemen enthalten.
Wenn eine in der Liste oldfiles aufgeführte Datei Blöcke aus der Bibliothek „Foundation > Hydraulic“ oder „Fluids > Hydraulics (Isothermal)“ enthält, ersetzt das Tool diese durch entsprechende Blöcke aus der Bibliothek „Isothermal Liquid“, hängt _converted an den Namen der Originaldatei an und speichert jede konvertierte Datei im selben Ordner wie die Originaldatei. Wenn eine Datei keine Hydraulikblöcke enthält und nicht auf eine in der Liste oldfiles aufgeführte Datei verweist, die Hydraulikblöcke enthält, lässt das Tool diese Datei unverändert. Das Tool gibt die Liste der konvertierten Dateinamen, newfiles, zurück und speichert den Konvertierungsbericht am Speicherort der ersten Datei, die in der Liste oldfiles aufgeführt ist. Im Konvertierungsbericht mit dem Namen HtoIL_report werden alle Probleme aufgeführt, die bei der Konvertierung aller Dateien in der Liste oldfiles aufgetreten sind.
newfiles = hydraulicToIsothermalLiquid(toppath)toppath und in dessen Unterordnern, wobei die Verknüpfungen zwischen den konvertierten Dateien in der Liste erhalten bleiben. Verwenden Sie diese Syntax, um benutzerdefinierte Bibliotheken und andere Modelle zu konvertieren, die Verweise auf oder Links zu anderen Bibliotheken, Modellen oder Subsystemen enthalten.
Sowohl der Ordner toppath als auch dessen Unterordner müssen sich im MATLAB®-Pfad befinden. Wenn ein Modell, ein Subsystem oder eine Bibliothek Blöcke aus der Bibliothek „Foundation > Hydraulic“ oder „Fluids > Hydraulics (Isothermal)“ enthält, ersetzt das Tool diese durch entsprechende Blöcke aus der Bibliothek „Isothermal Liquid“, hängt _converted an den Namen der Originaldatei an und speichert jede konvertierte Datei im selben Ordner wie die Originaldatei. Wenn eine Datei keine Hydraulikblöcke enthält und nicht auf eine in der Hierarchie des Ordners toppath enthaltene Datei verweist, die Hydraulikblöcke enthält, lässt das Tool diese Datei unverändert. Das Tool gibt die Liste der konvertierten Dateinamen, newfiles, zurück und speichert den Konvertierungsbericht mit dem Namen HtoIL_report im Ordner toppath.
newfiles = hydraulicToIsothermalLiquid(___,oldcustomblocks,newcustomblocks)oldcustomblocks aufgeführt sind, durch entsprechende „Isothermal Liquid“-Blöcke, newcustomblocks. Legen Sie für alle Kombinationen von Eingabeargumenten in den vorherigen Syntaxen nach allen anderen Eingabeargumenten zwei Zellenarrays mit benutzerdefinierten Blocknamen fest. Verwenden Sie diese Syntax, um Modelle zu konvertieren, die benutzerdefinierte Hydraulikblöcke wie z. B. maskierte Bibliotheksblöcke oder in der Simscape-Sprache geschriebene benutzerdefinierte Blöcke enthalten.
Bevor Sie diese Syntax verwenden können, müssen Sie die entsprechende Version der benutzerdefinierten Blöcke für isotherme Flüssigkeiten vorbereiten:
Für benutzerdefinierte Bibliotheksblöcke und Subsysteme, die Blöcke aus der Bibliothek „Foundation > Hydraulic“ oder „Fluids > Hydraulics (Isothermal)“ enthalten, führen Sie das Konvertierungstool für diese benutzerdefinierten Bibliotheken aus.
Für benutzerdefinierte Hydraulikblöcke, die in der Simscape-Sprache geschrieben sind, erstellen Sie manuell entsprechende Versionen dieser Blöcke, die die auf isotherme Flüssigkeiten bezogene Domäne verwenden.
Wenn das Tool während der Konvertierung einen in oldcustomblocks aufgeführten Block erkennt, ersetzt das Tool diesen Block durch den entsprechenden Block in newcustomblocks. Die beiden Zellenarrays oldcustomblocks und newcustomblocks müssen die gleiche Anzahl von Elementen aufweisen, wobei jedes Element einem Blocknamen entspricht. Die jeweiligen Blöcke, die in jedem Array aufgeführt sind, müssen die gleiche Anzahl von Anschlüssen, eine übereinstimmende Anschlussreihenfolge und die gleichen programmgesteuerten Parameternamen aufweisen.
Beispiele
Dieses Beispiel zeigt, wie das Konvertierungstool auf ein Modell mit Hydraulikblöcken angewendet wird. Das Tool generiert ein konvertiertes Modell und einen HTML-Bericht. Das nächste Beispiel, Bereinigen eines Modells nach der Konvertierung, zeigt, wie Sie mithilfe des HTML-Berichts die vom Konvertierungstool festgestellten Probleme überprüfen und beheben können.
Öffnen Sie das Beispielmodell „Hydraulic Actuator with Analog Position Controller“ (Hydraulikantrieb mit analogem Positionsregelungssystem):
openExample('simscape/HydraulicActuatorWithAnalogControlHExample')
Dieses Beispielmodell enthält Blöcke aus Hydraulikbibliotheken.
Konvertieren Sie das Modell, um die Blöcke der Bibliothek „Hydraulic“ durch die entsprechenden Blöcke aus der Bibliothek „Isothermal Liquid“ zu ersetzen:
hydraulicToIsothermalLiquid(bdroot)
ans =
1×1 cell array
{'HydraulicActuatorWithAnalogControlH_converted'}
Das Konvertierungstool bildet den neuen Modellnamen, indem es _converted an den Namen des ursprünglichen Modells anhängt. Da Sie das Argument newpath nicht angegeben haben, speichert das Konvertierungstool das Modell HydraulicActuatorWithAnalogControlH_converted im aktuellen Ordner.
Das Tool generiert außerdem einen HTML-Bericht und speichert diesen im aktuellen Ordner. Im Bericht werden alle Probleme aufgeführt, die während der Konvertierung aufgetreten sind.
Überprüfen Sie den HTML-Bericht und beheben Sie die verbleibenden Probleme manuell. In diesem Beispiel enthält das konvertierte Modell keine beschädigten Verbindungen oder entfernten Blöcke, aber das Konvertierungstool hat mehrere Warnhinweise zu Parametern generiert, die Ihre Aufmerksamkeit erfordern. Weitere Informationen finden Sie unter Bereinigen eines Modells nach der Konvertierung.
Im vorherigen Beispiel, Konvertieren eines Modells, sodass dieses „Isothermal Liquid“-Blöcke verwenden kann, haben Sie das Konvertierungstool für das Modell HydraulicActuatorWithAnalogControlH verwendet. Das Tool hat ein konvertiertes Modell, HydraulicActuatorWithAnalogControlH_converted, und einen HTML-Bericht generiert. In diesem Beispiel werden Sie mithilfe des HTML-Berichts die vom Konvertierungstool festgestellten Probleme überprüfen und beheben.
Eine Liste der Konvertierungsmeldungen und Vorschläge zu deren Behebung finden Sie unter Conversion Messages After Converting Hydraulic to Isothermal Liquid Models. Bei jeder Meldung wird durch Klicken auf einen Link in der Spalte Block des HTML-Berichts das entsprechende Subsystem geöffnet, falls erforderlich, wobei der Block, der die Meldung generiert hat, hervorgehoben wird.
Die ersten beiden Meldungen im HTML-Bericht beziehen sich auf die beiden Kammern des Subsystems Hydraulic Actuator. Im ursprünglichen Modell wurde jede dieser Kammern durch einen Translational Hydro-Mechanical Converter-Block implementiert. Das Konvertierungstool hat jeden dieser Blöcke durch einen Translational Mechanical Converter (IL)-Block ersetzt.
In den Translational Hydro-Mechanical Converter-Blöcken des ursprünglichen Modells war der Parameter Specific heat ratio enthalten, wohingegen in der auf isotherme Flüssigkeiten bezogenen Domäne alle Fluideigenschaften im Block Isothermal Liquid Properties (IL) definiert sind.
Das Konvertierungstool gibt den Wert des Parameters Specific heat ratio im ursprünglichen Block aus, um Ihnen die Arbeit zu erleichtern: Original block had Specific heat ratio of 1.4. Set Air polytropic index to this value in an Isothermal Liquid Properties (IL) block.
Öffnen Sie den Block Isothermal Liquid Properties (IL) im konvertierten Modell und setzen Sie den Parameter Air polytropic index dieses Modells auf den Wert 1.4.
Nachdem Sie die ersten beiden Konvertierungsmeldungen bearbeitet haben, klicken Sie auf den dritten Link in der Spalte Block des HTML-Berichts.
Das Tool blickt hinter die Maske des Blocks Spool Valve und hebt das Subsystem Orifice PA hervor.
Blicken Sie im ursprünglichen Modell, HydraulicActuatorWithAnalogControlH, hinter die Maske des Blocks Spool Valve.
Orifice PA ist einer von vier Variable Area Hydraulic Orifice-Blöcken, aus denen das Ventil besteht, und für jeden dieser Blöcke gibt es ähnliche Konvertierungsmeldungen. Auch der manuelle Bereinigungsprozess ist für jeden dieser Blöcke ähnlich.
Doppelklicken Sie im ursprünglichen Modell auf den Block Orifice PA, um seine Parameter anzuzeigen.
Das Konvertierungstool hat jeden Variable Area Hydraulic Orifice-Block durch einen Local Restriction (IL)-Block ersetzt. (Weitere Informationen finden Sie unter Block Substitutions for Foundation Library Hydraulic Blocks.) Da die Anschlusspositionen für diese Blöcke unterschiedlich sind, hat das Konvertierungstool die einzelnen Local Restriction (IL)-Blöcke in ein Subsystem eingefügt, um das Diagrammlayout beizubehalten.
Doppelklicken Sie im konvertierten Modell auf das Subsystem Orifice PA und anschließend auf den darin enthaltenen Block Orifice PA, um dessen Parameter anzuzeigen.
Die erste Konvertierungsmeldung für den Block Orifice PA, Critical Reynolds number set to 150, wird generiert, weil im ursprünglichen Block Variable Area Hydraulic Orifice der Parameter Laminar transition specification auf Pressure ratio gesetzt war. Der Ersatzblock Local Restriction (IL) kann den Übergang zwischen der laminaren und der turbulenten Strömung nur durch die kritische Reynolds-Zahl angeben. Das Konvertierungstool setzt den Parameter Critical Reynolds number auf den Standardwert „150“. Da der Block Variable Area Hydraulic Orifice im ursprünglichen Modell den Standardwert des Parameters Laminar flow pressure ratio, 0.999, verwendet hat, ist keine Maßnahme erforderlich.
Die zweite Konvertierungsmeldung für den Block Orifice PA, Maximum restriction area set to 1e10 m^2, wird generiert, weil der ursprüngliche Block Variable Area Hydraulic Orifice von einem unendlich großen maximalen Öffnungsbereich ausging, während der Ersatzblock, Local Restriction (IL), in dem Restriction type auf Variable gesetzt ist, für den Parameter Maximum restriction area einen Wert kleiner als inf erfordert.
Das Konvertierungstool setzt den Parameter Maximum restriction area im Ersatzblock Local Restriction (IL) auf einen beliebig großen Wert, 1e10 m^2. Es ist kein Eingreifen erforderlich, aber Sie können diesen Wert bei Bedarf auf das Datenblatt für Ihr Modell abstimmen.
Die übrigen Konvertierungsmeldungen beziehen sich auf die drei anderen Öffnungen und weisen ebenfalls darauf hin, dass keine Verhaltensänderung zu erwarten ist. Sie können diese drei Blöcke im ursprünglichen Modell auf ähnliche Weise untersuchen, um sicherzustellen, dass keine Maßnahmen erforderlich sind.
Nachdem Sie nun alle Konvertierungsmeldungen bearbeitet haben, ist die erforderliche Modellbereinigung abgeschlossen. Sie können die Simulationsergebnisse des ursprünglichen und des konvertierten Modells vergleichen, um sicherzustellen, dass sie identisch sind. Sie können bei Bedarf auch eine weitere kosmetische Bereinigung vornehmen. Beispielsweise können Sie die konvertierten Blöcke, bei denen Änderungen an der Anschlusspositionierung vorgenommen wurden, aus den Subsystemen verschieben und die Verbindungslinien manuell anpassen.
Um ein Beispiel für dieses Modell nach der Konvertierung und Bereinigung anzuzeigen, öffnen Sie das Beispielmodell „Hydraulic Actuator with Analog Position Controller“ (Hydraulikantrieb mit analogem Positionsregelungssystem) in der auf isotherme Flüssigkeiten bezogenen Domäne:
openExample('simscape/HydraulicActuatorWithAnalogControlExample')
Vergleichen Sie dieses Modell mit dem ursprünglichen Modell, HydraulicActuatorWithAnalogControlH, und dem vom Tool generierten konvertierten Modell, HydraulicActuatorWithAnalogControlH_converted.
Dieses Beispiel veranschaulicht, wie Sie Modelle zusammen mit den referenzierten Modellen, Subsystemen und verknüpften Bibliotheken konvertieren und die Verknüpfungen zwischen den konvertierten Dateien beibehalten können.
Gehen Sie von einem Modell aus, in diesem Beispiel hat es den Namen modelWithLink, das einige Hydraulikblöcke und ein referenziertes Modell referenceModel enthält, welches ebenfalls Hydraulikblöcke enthält. referenceModel befindet sich in einem separaten Ordner, Reference Systems, der sich im MATLAB-Pfad befindet.
Konvertieren Sie das Modell modelWithLink zusammen mit dem referenzierten Modell, indem Sie die Namen der Modelle in einer Dateiliste festlegen:
convertedFiles = hydraulicToIsothermalLiquid({'modelWithLink' 'referenceModel'})
convertedFiles =
2×1 cell array
{'modelWithLink_converted' }
{'referenceModel_converted'}
Das Konvertierungstool bildet den neuen Modellnamen, indem es _converted an den Namen des ursprünglichen Modells anhängt, und speichert jedes konvertierte Modell im gleichen Ordner wie die ursprünglichen Modelle.
Beachten Sie, dass das konvertierte Modell, modelWithLink_converted, jetzt über „Isothermal Liquid“-Blöcke verfügt und dass es jetzt mit dem konvertierten Referenzmodell, referenceModel_converted, verknüpft ist, das ebenfalls „Isothermal Liquid“-Blöcke aufweist.
Das Tool generiert einen allgemeinen Konvertierungsbericht mit dem Namen HtoIL_report und speichert diesen am Speicherort der ersten Datei, die im Eingabeargument oldfiles aufgeführt ist. In diesem Fall ist die erste Datei modelWithLink, weshalb der Bericht im selben Ordner gespeichert wird wie diese Datei. Im Bericht sind die Konvertierungsprobleme für alle Dateien in der Liste oldfiles aufgeführt.
Überprüfen Sie den HTML-Bericht und beheben Sie die verbleibenden Probleme manuell.
Vergleichen Sie die Simulationsergebnisse der konvertierten Modelle mit den ursprünglichen Modellen, um sicherzustellen, dass sie wie erwartet sind. Überprüfen Sie im HTML-Bericht die Meldungen in den Abschnitten Removed Blocks und Parameter Warnings. Die Meldungen in diesen Abschnitten geben an, ob Verhaltensänderungen erwartet werden, und umfassen Empfehlungen für entsprechende Maßnahmen.
Sobald Sie sicher sind, dass sich die konvertierten Systeme wie erwartet verhalten, können Sie die ursprünglichen Dateinamen mithilfe der Funktion hydraulicToIsothermalLiquidPostProcess wiederherstellen:
finalFiles = hydraulicToIsothermalLiquidPostProcess(convertedFiles)
Diese Funktion überschreibt die ursprünglichen Dateien, indem sie das Suffix _converted aus den Dateinamen und aus den Verknüpfungen zwischen den Dateien entfernt. Weitere Informationen finden Sie unter hydraulicToIsothermalLiquidPostProcess.
Dieses Beispiel zeigt, wie Sie einen Pfad zum obersten Ordner festlegen können, damit das Konvertierungstool alle Dateien in diesem obersten Ordner und in dessen Unterordnern verarbeiten kann. Das Tool konvertiert alle Dateien, die Hydraulikblöcke enthalten, wobei die Verknüpfungen zwischen ihnen erhalten bleiben, und gibt die Liste der konvertierten Dateien zurück. Wenn eine Datei keine Hydraulikblöcke enthält, lässt das Tool diese Datei unverändert.
Stellen Sie sich einen Ordner vor, in diesem Beispiel zur Verdeutlichung topFolder genannt, der Unterordner mit benutzerdefinierten Simulink®-Bibliotheken, referenzierten Modellen und Subsystemen sowie Modellen enthält, von denen einige Hydraulikblöcke aufweisen und andere nicht.
Stellen Sie vor dem Konvertieren der Dateien sicher, dass sich topFolder mit allen seinen Unterordnern im MATLAB-Pfad befindet:
addpath(genpath('topFolder'))
Konvertieren aller Dateien im Ordner topFolder und in dessen Unterordnern:
convertedFiles = hydraulicToIsothermalLiquid('topFolder')
convertedFiles =
5×1 cell array
{'model_converted' }
{'custom_Library1_converted' }
{'custom_Library2_converted' }
{'referenceModel_converted' }
{'referenceSubsystem_converted'}
Das Konvertierungstool bildet den neuen Modellnamen, indem es _converted an den Namen des ursprünglichen Modells anhängt, und speichert jedes konvertierte Modell im gleichen Ordner wie die ursprünglichen Modelle.
Beachten Sie, dass das Tool keine Datei mit der Endung _converted für modelWithoutHydraulicBlocks generiert und den Namen nicht im Zellenarray convertedFiles zurückgegeben hat, da dieses Modell keine Hydraulikblöcke enthält.
Das Tool generiert außerdem einen HTML-Bericht mit dem Namen HtoIL_report.html und speichert diesen im Ordner topFolder. Im Bericht werden für jede konvertierte Datei alle Probleme aufgeführt, die während der Konvertierung aufgetreten sind.
Überprüfen Sie den HTML-Bericht und beheben Sie die verbleibenden Probleme manuell.
Vergleichen Sie die Simulationsergebnisse der konvertierten Modelle mit den ursprünglichen Modellen, um sicherzustellen, dass sie wie erwartet sind. Überprüfen Sie im HTML-Bericht die Meldungen in den Abschnitten Removed Blocks und Parameter Warnings. Die Meldungen in diesen Abschnitten geben an, ob Verhaltensänderungen erwartet werden, und umfassen Empfehlungen für entsprechende Maßnahmen.
Wenn Sie alle Dateien in einem Ordner und in dessen Unterordnern konvertieren, aktualisiert das Konvertierungstool alle Bibliotheksverknüpfungen, Modellreferenzen und Subsystemreferenzen in diesen Dateien, sodass sie auf die Versionen dieser Dateien mit der Endung _converted verweisen. Sobald Sie sicher sind, dass sich die konvertierten Systeme wie erwartet verhalten, können Sie die ursprünglichen Dateinamen mithilfe der Funktion hydraulicToIsothermalLiquidPostProcess wiederherstellen:
finalFiles = hydraulicToIsothermalLiquidPostProcess('topFolder')
Diese Funktion überschreibt die ursprünglichen Dateien, indem sie das Suffix _converted aus den Dateinamen und aus den Verknüpfungen zwischen den Dateien entfernt. Weitere Informationen finden Sie unter hydraulicToIsothermalLiquidPostProcess.
